diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/ClassClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/ClassClass.md index 516b88ef8f1386..513d2fdda8fdee 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/ClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/ClassClass.md @@ -160,8 +160,8 @@ Puede pasar uno o más parámetros opcionales *param*, que se pasarán a la [fun :::note Notas - - Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. - - Si se llama a `.new()` en una clase inexistente, se devuelve un error. +- Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. +- Si se llama a `.new()` en una clase inexistente, se devuelve un error. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/Document.md b/i18n/es/docusaurus-plugin-content-docs/current/API/Document.md index 944900df8642e6..8372233057679f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/Document.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/Document.md @@ -320,8 +320,8 @@ Esta propiedad es de **solo lectura**. La propiedad `.original` devuelveel elemento de destino para un alias, un acceso directo o un archivo de enlace simbólico. El elemento objetivo puede ser: - - un objeto File - - un objeto de la carpeta +- un objeto File +- un objeto de la carpeta Para los archivos sin alias, la propiedad devuelve el mismo objeto File que el archivo. @@ -585,8 +585,8 @@ La función `.getText()` devuelve el con Opcionalmente, puede designar el conjunto de caracteres que se utilizará para leer el contenido. Puede pasar: - - en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), - - o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. +- en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), +- o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. > Para conocer la lista de los conjuntos de caracteres que soporta 4D, consulte la descripción del comando `CONVERT FROM TEXT`. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md index df89aac1cb3bd5..00a40a1fb3a6b2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md @@ -3,9 +3,9 @@ id: IncomingMessageClass title: IncomingMessage --- -La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). HTTP requests and their properties are automatically received as an instance of the `4D.IncomingMessage` class. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). +La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). Las peticiones HTTP y sus propiedades se reciben automáticamente como una instancia de la clase `4D.IncomingMessage`. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). -El gestor de peticiones HTTP puede devolver cualquier valor (o nada). It usually returns an instance of the [`4D.OutgoingMessage`](OutgoingMessageClass.md) class. +El gestor de peticiones HTTP puede devolver cualquier valor (o nada). Normalmente devuelve una instancia de la clase [`4D.OutgoingMessage`](OutgoingMessageClass.md). Todas las propiedades de esta clase son de sólo lectura. Son automáticamente llenados por el gestor de peticiones. @@ -19,7 +19,7 @@ Todas las propiedades de esta clase son de sólo lectura. Son automáticamente l ### Ejemplo -The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) has been defined: +El siguiente [archivo **HTTPHandlers.json**](../WebServer/http-request-handler.md) ha sido definido: ```json [ @@ -32,7 +32,7 @@ The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) ] ``` -The `http://127.0.0.1/start/example?param=demo&name=4D` request is run with a `GET` verb in a browser. It is handled by the *gettingStarted* function of the following *GeneralHandling* singleton class: +La petición `http://127.0.0.1/start/example?param=demo&name=4D` se ejecuta con un verbo `GET` en un navegador. Se gestiona mediante la función *gettingStarted* de la siguiente clase singleton *GeneralHandling*: ```4d shared singleton Class constructor() @@ -59,7 +59,7 @@ Function gettingStarted($request : 4D.IncomingMessage) : 4D.OutgoingMessage ``` -The request is received on the server as *$request*, an object instance of the `4D.IncomingMessage` class. +La petición se recibe en el servidor como *$request*, una instancia de objeto de la clase `4D.IncomingMessage`. Esta es la respuesta: @@ -76,7 +76,7 @@ There are 2 url parts - Url parts are: start - example ### Objeto IncomingMessage -4D.IncomingMessage objects provide the following properties and functions: +Los objetos 4D.IncomingMessage ofrecen las siguientes propiedades y funciones: | | | ----------------------------------------------------------------------------------------------------------------------------------------- | @@ -115,7 +115,7 @@ Un objeto 4D.IncomingMessage es un objeto [no compartible](../Concepts/shared.md La función `.getBlob()` devuelve el cuerpo de la petición como un Blob. -If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como contenido binario, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -172,7 +172,7 @@ $value := $request.getHeader("content-type") La función `.getJSON()` devuelve el cuerpo de la solicitud como una resolución JSON. -If the body has not been given as JSON valid content, an error is raised. +Si el cuerpo no se ha dado como contenido JSON válido, se produce un error. @@ -194,7 +194,7 @@ If the body has not been given as JSON valid content, an error is raised. La función `.getPicture()` devuelve el cuerpo de la petición como una imagen (en caso de que un cuerpo enviado como una imagen). -The content-type must be given in the headers to indicate that the body is a picture. +El tipo de contenido debe indicarse en los encabezados para indicar que el cuerpo es una imagen. :::note @@ -202,7 +202,7 @@ Si la solicitud se crea utilizando la [clase `HTTPRequest`](HTTPRequestClass.md) ::: -If the body is not received as a valid picture, the function returns null. +Si el cuerpo no se recibe como una imagen válida, la función devuelve null. @@ -224,7 +224,7 @@ If the body is not received as a valid picture, the function returns null. La función `.getText()` devuelve el cuerpo de la solicitud como un valor de texto. -If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como cadena, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -254,7 +254,7 @@ Los nombres de los encabezados (llaves) se escriben en minúsculas. Tenga en cue La propiedad `.url` contiene la URL de la petición sin la parte *IP:port* y como cadena. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.url` es "/docs/invoices/today". La propiedad `.url` es de sólo lectura. @@ -276,7 +276,7 @@ La parte "host" de la petición (*IP:port*) es suministrada por el [encabezado ` La propiedad `.urlPath` contiene la URL de la solicitud sin la parte *IP:port* y como una colección de cadenas. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.urlPath` es ["docs", "invoices" , "today"]. La propiedad `.urlPath` es de sólo lectura. @@ -294,19 +294,19 @@ La propiedad `.urlQuery` contiene el verbo usado por la petición. -HTTP and HTTPS request verbs include for example "get", "post", "put", etc. +Los verbos de solicitud HTTP y HTTPS incluyen, por ejemplo, "get", "post", "put", etc. La propiedad `.verb` es de sólo lectura. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index 3bf887380f503c..dde9a19a921c31 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objeto 4D.OutgoingMessage es un objeto [no compartible](../Concepts/shared.md La propiedad `.body` contiene el cuerpo del mensaje saliente. Los siguientes tipos de datos están soportados en la propiedad `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image La propiedad `.body` es de lectura-escritura. @@ -108,17 +108,17 @@ La función `.setBody()` def Los siguientes tipos de datos están soportados en el *body*: - - Text - - Blob - - Object - - Imagen +- Text +- Blob +- Object +- Imagen Cuando se utiliza esta función, el encabezado content-type se define automáticamente en función del tipo *body*: - - Content-Type:text/plain si el cuerpo es un Texto - - Content-Type:application/octet-stream si el body es un Blob - - Content-Type:application/json si el body es un objeto - - Content-Type:image/jpeg, image/gif... si el body es una imagen +- Content-Type:text/plain si el cuerpo es un Texto +- Content-Type:application/octet-stream si el body es un Blob +- Content-Type:application/json si el body es un objeto +- Content-Type:image/jpeg, image/gif... si el body es una imagen Si *body* no es de un tipo de valor soportado, se devuelve un error. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md index c2aac8d8067a35..9b93abeaf870fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propiedad `.keepAlive` contiene diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md index ee34091e8e1278..97f9980982773d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Los objetos de sesión son devueltos por el comando [`Session`](../commands/session.md). Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar [privilegios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sesiones Los siguientes tipos de sesiones están soportados por esta clase: @@ -38,11 +47,6 @@ La disponibilidad de las propiedades y funciones del objeto `Session` depende de | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() @@ -268,7 +272,7 @@ $privileges := Session.getPrivileges() #### Ver también [.setPrivileges()](#setprivileges)
-[Permisos - Inspeccionar los privilegios en la sesión para una fácil depuración (entrada de blog)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) +[*Permisos - Inspeccionar los privilegios en la sesión para una fácil depuración* (entrada de blog)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/WebFormClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/WebFormClass.md index c6b433cd74a1d7..b22060e96f189f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/WebFormClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/WebFormClass.md @@ -55,8 +55,8 @@ La función `.disableState()` d Esta función no hace nada si: - - el *estado* no está habilitado actualmente en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* no está habilitado actualmente en el formulario web, +- el *estado* no existe para el formulario web. Si [activa](#enablestate) o desactiva varios estados en la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez finalizada la función. @@ -80,8 +80,8 @@ La función `.enableState()` act Esta función no hace nada si: - - el *estado* ya ha sido activado en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* ya ha sido activado en el formulario web, +- el *estado* no existe para el formulario web. Si activa o [desactiva](#disablestate) varios estados dentro de la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez que la función termina. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketClass.md index e89f0eed941e0f..54894c3af956cc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketClass.md @@ -86,8 +86,8 @@ La función `4D.WebSocket.new()` crea y En *url*, pase la URL a la que responderá el servidor WebSocket. Se pueden utilizar los siguientes patrones de URL: - - `ws://host[:port]path[?query]` para conexiones estándar - - `wss://host[:port]path[?query]` para conexiones seguras TLS +- `ws://host[:port]path[?query]` para conexiones estándar +- `wss://host[:port]path[?query]` para conexiones seguras TLS Si la conexión no es posible, se devuelve un objeto `null` y se genera un error (que puede interceptar utilizando un método instalado con `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la conexión no es posible, se devuelve un objeto `null` y se genera un error En *connectionHandler*, puede pasar un objeto que contenga funciones de retrollamada a ser llamadas según los eventos de conexión, así como el tipo de datos y encabezados a manejar. - - Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. - - El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. +- Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. +- El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. | Propiedad | Tipo | Descripción | | ----------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La función `.terminate()` cierr En *code*, puede pasar un código de estado que explique por qué se está cerrando la conexión (ver también [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. - - Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. +- Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. +- Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. En *reason*, puede pasar una cadena que describa por qué se está cerrando la conexión. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md index 7a39dc1916d619..dd24f32e2a209e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Ver también [esta entrada de blog](https://blog.4d.com/new-built-in-websocket-s Para crear y manejar su Servidor WebSocket en 4D, tendrá que utilizar dos clases 4D integradas: - - esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, - - la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. +- esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, +- la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. Además, tendrá que crear dos clases de usuario que contendrán funciones de retrollamada: - - una clase usuario para gestionar las conexiones al servidor, - - una clase usuario para gestionar mensajes. +- una clase usuario para gestionar las conexiones al servidor, +- una clase usuario para gestionar mensajes. Debe [crear el servidor WebSocket](#4dwebsocketservernew) dentro de un [worker](../Develop/processes.md#worker-processes) para mantener viva la conexión. @@ -387,8 +387,8 @@ De forma predeterminada, si no se establece un valor *timeout*, la función inic Si se establece un valor de *timeout*: - - cuando se alcanza el tiempo de espera, destruye forzosamente el socket. - - si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. +- cuando se alcanza el tiempo de espera, destruye forzosamente el socket. +- si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Admin/webAdmin.md b/i18n/es/docusaurus-plugin-content-docs/current/Admin/webAdmin.md index 7108ada0d3da2f..c5f9761b457de6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Admin/webAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Es necesario configurar el lanzamiento al i Puede configurar el servidor web `WebAdmin` para que se lance al inicio de la aplicación 4D o 4D Server (antes de que se cargue cualquier proyecto). - - Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. +- Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Seleccione la opción **Iniciar servidor WebAdmin al inicio** en la caja de diá ![alt-text](../assets/en/Admin/waSettings.png) - - Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: +- Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Cuando esta opción está seleccionada, podrá conectarse al servidor web `WebAd **Notas:** - - Nunca se aceptan conexiones con HTTP que no sean localhost. - - Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. +- Nunca se aceptan conexiones con HTTP que no sean localhost. +- Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. #### Puerto HTTP @@ -95,11 +95,11 @@ Ruta de la carpeta donde se encuentran los archivos del certificado TLS. Por def Estado o formato del archivo de registro de peticiones HTTP (HTTPDebugLog_*nn*.txt, almacenado en la carpeta "Logs" de la aplicación -- *nn* es el número de archivo). Las siguientes opciones están disponibles: - - **Desactivado** (por defecto) - - **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición - - \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) - - **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones - - **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas +- **Desactivado** (por defecto) +- **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición +- \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) +- **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones +- **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas #### Llave de acceso @@ -109,10 +109,10 @@ La configuración de una llave de acceso es obligatoria para desbloquear el acce Una llave de acceso es similar a una contraseña pero no está asociada a un inicio de sesión. - - Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del +- Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. - - Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. +- Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. +- Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. #### Activar el acceso a Qodly Studio @@ -148,9 +148,9 @@ Ejemplo: ## Autenticación y sesión - - Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. +- Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. - - Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. +- Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. Una vez concedido el acceso, se crea una [sesión web](WebServer/sessions.md) con el privilegio "WebAdmin" en la aplicación 4D. Mientras la sesión actual tenga el privilegio "WebAdmin", el componente `WebAdmin` entrega las páginas solicitadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Backup/restore.md b/i18n/es/docusaurus-plugin-content-docs/current/Backup/restore.md index 1fb388c12979ef..44c863fc5fe3dc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Backup/restore.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar 4D le permite restaurar conjuntos enteros de datos de una aplicación en caso de que se presente un incidente, independientemente de sus causas. Pueden producirse dos categorías principales de incidentes: - - La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: +- La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: - Si la caché estaba vacía, la aplicación se abre normalmente. Se registraron todos los cambios realizados en la aplicación. Este caso no requiere ninguna operación particular. - Si la caché contiene operaciones, el archivo de datos está intacto pero requiere integrar el archivo de historial actual. - Si la caché estaba en proceso de escritura, es probable que el archivo de datos esté dañado. Hay que restaurar la última copia de seguridad e integrar el archivo de historial actual. - - La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. +- La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. > 4D puede lanzar procedimientos automáticamente de recuperación de las aplicaciones tras los incidentes. Estos mecanismos se gestionan mediante dos opciones disponibles en la página **Backup/Backup y Restauración** de las Propiedades. Para más información, consulte el párrafo [Restauración automática](settings.md#automatic-restore-and-log-integration).\ > Si la incidencia es el resultado de una operación inadecuada realizada sobre los datos (eliminación de un registro, por ejemplo), puede intentar reparar el archivo de datos utilizando la función "rollback" en el archivo de historial. Esta función está disponible en la página [Retroceder](MSC/rollback.md) del CSM. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Backup/settings.md b/i18n/es/docusaurus-plugin-content-docs/current/Backup/settings.md index 9d6b3f2706ff8c..a14ab4754a986e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Backup/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Backup/settings.md @@ -5,9 +5,9 @@ title: Parámetros de la copia de seguridad Los parámetros de copia de seguridad se definen a través de tres páginas en el [cuadro de diálogo de los parámetros](../settings/overview.md). Puede definir: - - la periodicidad de las copias de seguridad automáticas - - los archivos a incluir en cada copia de seguridad - - las funcionalidades avanzadas permiten ejecutar tareas automáticas +- la periodicidad de las copias de seguridad automáticas +- los archivos a incluir en cada copia de seguridad +- las funcionalidades avanzadas permiten ejecutar tareas automáticas > Las propiedades definidas en esta caja de diálogo se escriben en el archivo *Backup.4DSettings*, guardado en la carpeta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Los parámetros de copia de seguridad periódicos se definen en la página **Bac Las opciones que se encuentran en esta pestaña le permiten establecer y configurar las copias de seguridad periódicas automáticas de la aplicación. Puede elegir una configuración rápida estándar o puede personalizarla completamente. Aparecen varias opciones en función de la elección realizada en el menú **Copia de seguridad automática**: - - **Nunca**: la función de copia de seguridad programada está inactiva. - - **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. - - Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. - - **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. - - **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: +- **Nunca**: la función de copia de seguridad programada está inactiva. +- **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. +- Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. +- **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. +- **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: - **Cada X hora(s)**: permite programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24. * **Cada X día(s) a las x**: permite programar las copias de seguridad con una base diaria. Por ejemplo, introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe introducir la hora a la que debe comenzar la copia de seguridad. * **Cada X semana(s) a las x**: permite programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Cuando esta opción está marcada, debe introducir el día(s) de la semana y la hora que debe comenzar la copia de seguridad. Si lo desea, puede seleccionar varios días de la semana. Por ejemplo, puede utilizar esta opción para definir dos copias de seguridad semanales: una el miércoles y otra el viernes. @@ -48,12 +48,12 @@ La página Copia de seguridad/Configuración de las Propiedades permite designar Esta área le permite determinar qué archivos y/o carpetas deben copiarse durante la siguiente copia de seguridad. - - **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: +- **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: - el archivo de historial actual de la aplicación (si existe), - la carpeta `Settings` completa situada [junto al archivo de datos](../Project/architecture.md#settings-user-data) (si existe), es decir, *los parámetros usuario para los datos*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. - - **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* - - **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". +- **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. +- **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* +- **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". - **Eliminar**: retira el archivo seleccionado de la lista de archivos adjuntos. - Gestión del archivo de historial En el caso de una restitución, la carpeta se recuperará con su estructura interna. Puede seleccionar toda carpeta o volumen conectado a la máquina, a excepción de la carpeta que contiene los archivos de la aplicación. - **Añadir archivo...**: muestra una caja de diálogo que permite seleccionar un archivo para añadirlo a la copia de seguridad. @@ -82,19 +82,19 @@ La modificación de las opciones de copia de seguridad y restauración es opcion ### Parámetros generales - - **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). +- **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). Si, por ejemplo, el número de conjuntos se define en 3, las tres primeras copias de seguridad crean los archivos MyBase-0001, MyBase-0002 y MyBase-0003 respectivamente. Durante la cuarta copia de seguridad, se crea el archivo MyBase-0004 y se elimina MyBase-0001. Por defecto, el mecanismo de eliminación de conjuntos está activado y 4D guarda 3 conjuntos de copia de seguridad. Para desactivar el mecanismo, basta con deseleccionar la opción. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. +- **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. +- **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. - - **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. +- **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. - **Reintentar en la siguiente fecha y hora programada**: esta opción sólo tiene sentido cuando se trabaja con copias de seguridad automáticas programadas. Equivale a anular la copia de seguridad fallida. Se genera un error. - **Reintentar después de X segundo(s), minuto(s) u hora(s)**: cuando se marca esta opción, se ejecuta un nuevo intento de copia de seguridad después del periodo de espera. Este mecanismo permite anticipar ciertas circunstancias que pueden bloquear la copia de seguridad. Puede establecer un periodo de espera en segundos, minutos u horas utilizando el menú correspondiente. Si el nuevo intento también falla, se genera un error y se anota el fallo en el área de estado de la última copia de seguridad y en el archivo del diario de copias de seguridad. - **Cancelar la operación después de X intentos**: este parámetro se utiliza para definir el número máximo de intentos de copia de seguridad fallidos. Si la copia de seguridad no se ha realizado con éxito una vez alcanzado el número máximo de intentos establecido, se cancela y se genera el error 1401 ("Se ha alcanzado el número máximo de intentos de copia de seguridad; la copia de seguridad automática está temporalmente desactivada"). En este caso, no se intentará realizar una nueva copia de seguridad automática mientras no se haya reiniciado la aplicación o se haya realizado con éxito una copia de seguridad manual. @@ -106,15 +106,15 @@ La modificación de las opciones de copia de seguridad y restauración es opcion Estas opciones se aplican a los archivos de copia de seguridad principales y a los archivos de copia de seguridad del historial. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. El menú **Tamaño del segmento** es un combo box que permite establecer el tamaño en MB de cada segmento de la copia de seguridad. Puede elegir uno de los tamaños preestablecidos o introducir un tamaño específico entre 0 y 2048. Si se pasa 0, no se produce ninguna segmentación (esto equivale a pasar **Ninguna**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: +- **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: - **Ninguna:** no se aplica ninguna compresión de archivos. La copia de seguridad es más rápida, pero los archivos son considerablemente más grandes. - **Rápido** (por defecto): esta opción es un compromiso entre la velocidad de la copia de seguridad y el tamaño del archivo. - **Compactado**: la tasa de compresión máxima se aplica a los archivos. Los ficheros de archivos ocupan el menor espacio posible en el disco, pero la copia de seguridad se ralentiza notablemente. - - **Tasa de entrelazamiento y tasa de redundancia** +- **Tasa de entrelazamiento y tasa de redundancia** 4D genera archivos utilizando algoritmos específicos que se basan en mecanismos de optimización (entrelazamiento) y seguridad (redundancia). Puedes configurar estos mecanismos en función de sus necesidades. Los menús asociados a estas opciones contienen índices de **Bajo**, **Medio**, **Alto** y **Ninguno** (por defecto). - **Tasa de entrelazamiento**: el entrelazamiento consiste en almacenar los datos en sectores no adyacentes para limitar los riesgos en caso de daño de los sectores. Cuanto mayor sea la tasa, mayor será la seguridad; sin embargo, el procesamiento de datos utilizará más memoria. - **Tasa de redundancia**: la redundancia permite asegurar los datos presentes en un fichero repitiendo varias veces la misma información. Cuanto mayor sea la tasa de redundancia, mayor será la seguridad de los archivos; sin embargo, el almacenamiento será más lento y el tamaño de los archivos aumentará en consecuencia. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/operators.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/operators.md index 7c378f6c26d239..111a7c8b4391b2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/operators.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/operators.md @@ -11,8 +11,8 @@ El lenguaje 4D es compatible con los operadores que ya conoce de otros lenguajes El lenguaje 4D soporta los operadores **binarios** y **ternarios**: - - los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. - - los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). +- los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. +- los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). Los valores que los operadores afectan son los operandos. En la expresión `1 + 2`, el símbolo + es un operador binario y sus dos operandos son los valores 1 y 2. @@ -33,18 +33,18 @@ $col:=New collection //$col se inicializa con una colección vacía Los resultados del operador dependen de los **tipos de datos** a los que se aplican. 4D soporta diferentes operadores en tipos de datos escalares. Se describen con los tipos de datos, en las siguientes secciones: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) - - [**Operadores de fechas**](dt_date.md#operadores-de-fechas) - - [**Operadores de tiempo**](dt_time.md#time-operators) - - [**Operadores de números**](dt_number.md#number-operators) - - [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) - - [**Operadores de imágenes**](dt_picture.md#picture-operators) - - [**Operadores de punteros**](dt_pointer.md#pointer-operators) - - [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) - - [**Operadores en las referencias de objetos**](dt_object.md#object-operators) - - [**Operadores de referencia de colección**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) +- [**Operadores de fechas**](dt_date.md#operadores-de-fechas) +- [**Operadores de tiempo**](dt_time.md#time-operators) +- [**Operadores de números**](dt_number.md#number-operators) +- [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) +- [**Operadores de imágenes**](dt_picture.md#picture-operators) +- [**Operadores de punteros**](dt_pointer.md#pointer-operators) +- [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) +- [**Operadores en las referencias de objetos**](dt_object.md#object-operators) +- [**Operadores de referencia de colección**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) ## Operadores de asignación compuestos @@ -272,9 +272,9 @@ El operador condicional ternario permite escribir expresiones condicionales de u Se necesitan tres operandos en el siguiente orden: - - una condición seguida de un signo de interrogación (?) - - una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) - - una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) +- una condición seguida de un signo de interrogación (?) +- una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) +- una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) ### Sintaxis @@ -325,21 +325,21 @@ Además de un tipo, cada valor también tiene un valor booleano inherente, conoc Los siguientes valores son **falsy**: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Cadenas vacías - - [] - Colecciones vacías - - {} - Objetos vacios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Cadenas vacías +- [] - Colecciones vacías +- {} - Objetos vacios Todos los demás valores se consideran **truthy**, incluyendo: - - 0 - cero numérico (Entero u otro) +- 0 - cero numérico (Entero u otro) En 4D, la evaluación **truthy** y **falsy** refleja la **usabilidad** de un valor, lo que significa que un valor truthy existe y puede ser procesado por el código sin generar errores o resultados inesperados. La razón de ser de esto es ofrecer una forma conveniente de manejar valores *undefined* y *null* en objetos y colecciones, de modo que un número reducido de instrucciones [If…Else](flow-control.md#ifelseend-if) sean necesarias para evitar errores de ejecu diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md index 6a6f75713e39cc..a1cc173febeb9b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -53,8 +53,8 @@ Esta sintaxis solo soporta declaraciones de [variables locales y de proceso](#lo `varType` puede ser: - - un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, - - una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. +- un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, +- una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. Si se omite `varType`, se crea una variable de tipo **variant**. @@ -86,7 +86,7 @@ La sintaxis heredada utilizando los comandos `C_XX` es obsoleta a partir de 4D 2 ### Ejemplos - - Para declarar variables básicas locales y de proceso: +- Para declarar variables básicas locales y de proceso: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //también equivalente a C_OBJECT($o) ``` - - Para declarar las variables objeto de la clase 4D: +- Para declarar las variables objeto de la clase 4D: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Para declarar las variables objeto de la clase usuario: +- Para declarar las variables objeto de la clase usuario: ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Una variable local, como su nombre indica, es local a un método, accesible sól Es posible que desee utilizar una variable local para: - - Evitar conflictos con los nombres de otras variables - - Utilizar los datos temporalmente - - Reducir el número de variables proceso +- Evitar conflictos con los nombres de otras variables +- Utilizar los datos temporalmente +- Reducir el número de variables proceso El nombre de una variable local siempre comienza por el signo dólar ($) y puede contener hasta 31 caracteres adicionales. Si introduce un nombre más largo, 4D lo trunca a la longitud adecuada. @@ -224,9 +224,9 @@ En modo interpretado, las variables se mantienen dinámicamente; se crean y se b Un proceso puede leer y escribir las variables proceso de otro proceso utilizando los comandos `GET PROCESS VARIABLE` y `SET PROCESS VARIABLE`. Es una buena práctica de programación restringir el uso de estos comandos a la situación para la que fueron creados en 4D: - - Comunicación interprocesos en lugares específicos de su código - - Gestión de arrastrar y soltar interproceso - - En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras +- Comunicación interprocesos en lugares específicos de su código +- Gestión de arrastrar y soltar interproceso +- En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras Para más información, consulte el capítulo **Procesos** y la descripción de estos comandos. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/basics.md b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/basics.md index 9ae01abea102b2..b87074b4252a19 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/basics.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, puede que no haya suficiente memoria para crear un BLOB. O, cuan Estos son generalmente los tipos de errores más difíciles de encontrar. A excepción de los errores de digitación, todos los tipos de errores listados arriba están cubiertos hasta cierto punto por la expresión "error de diseño o de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por ejemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Los errores de diseño o de lógica también incluyen situaciones como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. A veces el código que muestra el error puede ser diferente al código que en realidad es el origen del problema. @@ -55,8 +55,8 @@ Para encontrar rápidamente el origen del problema, vuelva a abrir la versión i La ventana de error de sintaxis aparece automáticamente cuando se interrumpe la ejecución de un método. Esto puede ocurrir cuando: - - un error impide que el código siga ejecutándose - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- un error impide que el código siga ejecutándose +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ El área de texto superior muestra un mensaje describiendo el error. El área de La ventana de error de sintaxis propone varias opciones: - - **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. +- **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **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. +- **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. :::tip @@ -76,14 +76,14 @@ Para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede c ::: - - **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: +- **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: - 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. +- **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. - - **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. +- **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. ## Depurador diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md index 99fd7295b126a7..36a92919469a8b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento se puede utilizar para filtrar la entrada de datos en los objetos ed Cuando se utiliza, este evento se genera después de cada cambio realizado en el contenido de un objeto editable, independientemente de la acción que haya provocado la modificación, *es decir*: - - Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; - - Soltar un valor (acción similar a pegar); - - Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. - - Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). +- Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; +- Soltar un valor (acción similar a pegar); +- Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. +- Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). Dentro del evento `On After Edit`, los datos de texto que se ingresan son devueltos por el comando [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md index 6600c9ead2a047..fa93861d722f2b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ El evento de formulario `On Begin Drag Over` puede ser seleccionado para todos l El evento `On Begin Drag Over` es útil para preparar la acción de arrastrar. Puede utilizarse para: - - Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). - - Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). - - Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. +- Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). +- Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). +- Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. - Para indicar que las acciones de arrastre son aceptadas, el método del objeto fuente debe devolver 0 (cero). - Para indicar que se rechazan las acciones de arrastrar, el método del objeto fuente debe devolver -1 (menos uno). - Si no se devuelve ningún resultado, 4D considera que las acciones de arrastre son aceptadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onClicked.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onClicked.md index 21c7b1ccab37e5..40ba861bc720a5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onClicked.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. Sin embargo, hay varias excepciones: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md index da0b5c023d90fb..7b623c81af91d8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un registro está a punto de ser visualizado en un formulario de lista que se mu En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada registro: +- Para cada registro: - Para cada objeto en el área detallada: - Método objeto con el evento `On Display Detail` - Método formulario con el evento `On Display Detail` diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onDragOver.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onDragOver.md index 6b828dc261f3b0..5b1c5186896b9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over El evento `On Drag Over` se envía repetidamente al objeto de destino cuando el puntero del ratón se mueve sobre el objeto. Normalmente, en respuesta a este evento: - - Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). - - Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. +- Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). +- Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. Para **aceptar** el arrastrar, el método del objeto de destino debe devolver 0 (cero). Para **rechazar** el arrastrar, el método de objeto debe retornar -1 (menos uno). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeader.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeader.md index 22491caa86174f..07196347369ba7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeader.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada objeto en el área del encabezado: +- Para cada objeto en el área del encabezado: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md index 4193db89f0ecc0..c09175fbd2a07b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Este evento se genera cuando se hace clic en el encabezado de una columna de lis Si se seleccionó la propiedad [Sortable](FormObjects/properties_Action.md#sortable) para el list box, se puede decidir si se autoriza o no una ordenación estándar de la columna pasando el valor 0 o -1 en la variable `$0`: - - Si `$0` es igual a 0, se realiza una ordenación estándar. - - Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. +- Si `$0` es igual a 0, se realiza una ordenación estándar. +- Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. Si la propiedad [Sortable](FormObjects/properties_Action.md#sortable) no está seleccionada para el list box, la variable `$0` no se utiliza. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Extensions/develop-components.md b/i18n/es/docusaurus-plugin-content-docs/current/Extensions/develop-components.md index 30598e12c84a99..e5fbfb4c734150 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Extensions/develop-components.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Extensions/develop-components.md @@ -179,14 +179,18 @@ Select **Edit...** item is available when you right-click on the component name ![edit-component](../assets/en/Project/Edit-component.png) -When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the component code is editable in the following pages: +When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the following standard pages are available and give access to the component contents: ![tab-component](../assets/en/Project/tab-component.png) +- Home, including folders, methods, classes and (preview only) forms - Métodos proyecto - Database Methods ([On Web Connection](../commands-legacy/on-web-connection-database-method.md), [On Web Authentication](../commands-legacy/on-web-authentication-database-method.md), [On Host Database Event](../commands-legacy/on-host-database-event-database-method.md)) - Clases - Métodos formulario proyecto +- Comandos y constantes +- Plug-ins +- Trash ![tab-component](../assets/en/Project/tab-component.gif) @@ -194,7 +198,8 @@ Standard 4D IDE features are available for the component. Puede ejecutar las sig - añadir, duplicar, borrar, editar/guardar [métodos y clases](../Project/code-overview.md) - previsualizar código, mostrar/editar [documentación](../Project/documentation.md), mostrar/editar [propiedades de método](../Project/code-overview.md#project-method-properties), -- ejecutar métodos. +- ejecutar métodos, +- restore from trash or empty trash. ## Completar el código de los componentes compilados diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md index a12a7f4383b866..f780ef9be2a24d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -9,16 +9,16 @@ Los formularios ofrecen la interfaz a través de la cual se introduce, modifica Los formularios también pueden contener otros formularios a través de las siguientes funcionalidades: - - [objetos de subformulario](FormObjects/subform_overview.md) - - [formularios heredados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulario](FormObjects/subform_overview.md) +- [formularios heredados](./properties_FormProperties.md#inherited-form-name) ## Creación de formularios Puede añadir o modificar formularios 4D utilizando los siguientes elementos: - - **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. - - **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. - - **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: +- **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. +- **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. +- **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: ``` { @@ -70,9 +70,9 @@ Puede añadir o modificar formularios 4D utilizando los siguientes elementos: Hay dos categorías de formularios: - - **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. +- **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. - - **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. +- **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. Normalmente, se selecciona la categoría del formulario al crearlo, pero se puede cambiar después. @@ -80,15 +80,15 @@ Normalmente, se selecciona la categoría del formulario al crearlo, pero se pued Cada formulario consta de al menos dos páginas: - - una página 1: una página principal, mostrada por defecto - - una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. +- una página 1: una página principal, mostrada por defecto +- una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. Puede crear varias páginas para un formulario de entrada. Si tiene más campos o variables de los que caben en una pantalla, puede crear páginas adicionales para mostrarlos. Las páginas múltiples le permiten hacer lo siguiente: - - Coloque la información más importante en la primera página y la menos importante en otras. - - Organice cada tema en su propia página. - - Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). - - Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. +- Coloque la información más importante en la primera página y la menos importante en otras. +- Organice cada tema en su propia página. +- Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). +- Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. Las páginas múltiples son útiles sólo para los formularios de entrada. No son para imprimir. Cuando se imprime un formulario de varias páginas, sólo se imprime la primera. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/macros.md b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/macros.md index a549dcc06d28ca..b56b453cb2a0a2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/macros.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/macros.md @@ -7,11 +7,11 @@ El editor de formularios 4D soporta macros. Una macro es un conjunto de instrucc Por ejemplo, si tiene un informe recurrente con un formato específico (por ejemplo, cierto texto debe aparecer en rojo y cierto texto debe aparecer en verde), puede crear una macro para definir automáticamente el color. Puede crear macros para el editor de formularios 4D que pueden: - - Crear y ejecutar código 4D - - Mostrar las cajas de diálogo - - Seleccione los objetos de formulario - - Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades - - Modificar los archivos del proyecto (actualizar, eliminar) +- Crear y ejecutar código 4D +- Mostrar las cajas de diálogo +- Seleccione los objetos de formulario +- Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades +- Modificar los archivos del proyecto (actualizar, eliminar) El código de las macros soporta [funciones de clase](Concepts/classes.md) y las [propiedades de objeto de formulario en JSON](FormObjects/properties_Reference.md) para permitir definir toda funcionalidad personalizada en el editor de formularios. @@ -238,9 +238,9 @@ Por ejemplo, si los objetos de la página actual y de los grupos han sido modifi Cuando se maneja el atributo `method` de los objetos de formulario, se puede definir el valor del atributo de dos maneras en las macros: - - Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). +- Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). - - Utilizando un objeto con la siguiente estructura: +- Utilizando un objeto con la siguiente estructura: | Propiedad | Tipo | Descripción | | --------- | ---- | ----------------- | @@ -252,9 +252,9 @@ Cuando se maneja el atributo `method` de los objetos de formulario, se puede def La propiedad `$4dId` define un ID único para cada objeto de la página actual. Esta clave es utilizada por el procesador de macros para controlar los cambios en `$result.currentPage`: - - si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. - - si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. - - si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. +- si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. +- si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. +- si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. #### Ejemplo @@ -297,8 +297,8 @@ La función `onError` se ejecuta cuando el procesador de macros encuentra un err Cuando se ejecuta una macro, si 4D encuentra un error que impide la cancelación de la macro, no la ejecuta. Es el caso, por ejemplo, de que la ejecución de una macro resulte en: - - borrar o modificar un script cuyo archivo es de sólo lectura. - - crear dos objetos con el mismo ID interno. +- borrar o modificar un script cuyo archivo es de sólo lectura. +- crear dos objetos con el mismo ID interno. #### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md index 09f69812c3b672..bea03bd3c7bafa 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Puede utilizar librerías de objetos en sus formularios. Una librería de objeto 4D propone dos tipos de librerías de objetos: - - una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. - - librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. +- una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. +- librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. ## Utilización de la librería de objetos estándar @@ -21,10 +21,10 @@ La librería se muestra en una ventana aparte: La ventana tiene las siguientes características principales: - - Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. - - Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: +- Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. +- Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar un objeto de la librería en su formulario, puede: +- Para utilizar un objeto de la librería en su formulario, puede: - hacer clic derecho en un objeto y seleccionar **Copiar** en el menú contextual - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Una determinada librería de objetos sólo puede ser abierta por un proyecto a l Para abrir una librería de objetos personalizada, seleccione el comando **Abrir>Librería de objetos...** en el menú **Archivo** o en la barra de herramientas de 4D. Aparece una caja de diálogo estándar para abrir archivos, que le permite seleccionar la librería de objetos que desea abrir. Puede seleccionar los siguientes tipos de archivos: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** De hecho, las librerías de objetos personalizadas son proyectos 4D clásicos. Sólo se exponen las siguientes partes de un proyecto cuando se abre como librería: - - formularios proyecto - - páginas formulario 1 +- formularios proyecto +- páginas formulario 1 ### Crear una librería de objetos @@ -74,10 +74,10 @@ Las principales operaciones están disponibles en el menú contextual o en el me ![](../assets/en/FormEditor/library5.png) - - **Cortar** o **Copiar** al portapapeles - - **Pegar** un objeto del tablero portapapeles - - **Borrar** - elimina el objeto de la librería - - **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. +- **Cortar** o **Copiar** al portapapeles +- **Pegar** un objeto del tablero portapapeles +- **Borrar** - elimina el objeto de la librería +- **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. Puede colocar objetos individuales (incluidos los subformularios) o conjuntos de objetos en una librería de objetos. Cada objeto o conjunto se agrupa en un solo elemento: @@ -93,9 +93,9 @@ El uso de copiar y pegar o arrastrar y soltar con ciertos objetos de librería t A continuación se muestra una lista de objetos dependientes que se pegarán en la librería al mismo tiempo que el objeto principal que los utiliza (cuando corresponda): - - Listas - - Formatos/Filtros - - Imágenes - - Mensajes de ayuda (asociados a un campo) - - Métodos objeto +- Listas +- Formatos/Filtros +- Imágenes +- Mensajes de ayuda (asociados a un campo) +- Métodos objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md index d1186f42277c5b..364e7ce2ee9c52 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Las opciones de tamaño dependen del valor de la opción **Tamaño basado en**. ## Tamaño basado en - - **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). +- **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). Puede elegir esta opción cuando desee utilizar objetos activos situados en un área fuera de la pantalla (*es decir*, fuera del rectángulo delimitador de la ventana) con una ventana de tamaño automático. Gracias a esta opción, la presencia de estos objetos no modificará el tamaño de la ventana. - - **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). +- **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). - - ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. +- ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. > Para los formularios de salida, sólo están disponibles los campos [**Margen horizontal**](#hor-margin) o [**Ancho**](#width). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md index 1391eda981bb2a..fba2d1eb026abc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Usted crea y personaliza los formularios de su aplicación manipulando los objet Los formularios 4D soportan una gran cantidad de objetos **activos** y **estáticos** integrados: - - **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. - - **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. +- **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. +- **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. ## Gestión de objetos de formulario Puede añadir o modificar objetos formulario 4D de las siguientes maneras: - - **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. +- **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. - - Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. +- Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. - - **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). +- **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). Ejemplo para un objeto botón: ```json diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md index 56e6394b61fd1d..209a1daf6f52d8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md @@ -15,7 +15,7 @@ Puede gestionar los datos con los [métodos](Concepts/methods.md) objeto o formu :::note -Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Text.md#multi-style), cuando se pegan fórmulas desde una aplicación 4D diferente o un entorno externo, solo se pegan los *valores calculados* (texto o imágenes) disponibles en el momento de la copia. If no value was available (e.g., the formula was never computed), 4D pastes the formula source as plain text. +Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Text.md#multi-style), cuando se pegan fórmulas desde una aplicación 4D diferente o un entorno externo, solo se pegan los *valores calculados* (texto o imágenes) disponibles en el momento de la copia. Si no hay ningún valor disponible (por ejemplo, la fórmula nunca se calculó), 4D pega la fuente de la fórmula como texto sin formato. ::: @@ -50,6 +50,6 @@ Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Te También puede representar expresiones de campos y de variables en sus formularios utilizando objetos alternativos, más concretamente: - - Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). - - Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). - - Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). +- Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). +- Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). +- Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index bdcdb932db5ef1..fc2a7f771d3939 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Cuando corresponda, el icono desplegar/contraer se mostrará automáticamente a El contenido de un objeto formulario lista jerárquica se puede inicializar de una de las siguientes maneras: - - Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. - - Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. +- Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. +- Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. En ambos casos, se gestiona una lista jerárquica en tiempo de ejecución a través de su referencia *ListRef*, utilizando los comandos [lista jerárquica](../commands/theme/Hierarchical_Lists.md) del lenguaje 4D. @@ -34,9 +34,9 @@ mylist:=New list Cada representación de la lista tiene sus propias características específicas y comparte características comunes con todas las demás representaciones. Las siguientes características son específicas de cada representación de la lista: - - La selección, - - El estado desplegado/colapsado de sus elementos, - - La posición del cursor de desplazamiento. +- La selección, +- El estado desplegado/colapsado de sus elementos, +- La posición del cursor de desplazamiento. Las otras características (fuente, tamaño de fuente, estilo, control de entrada, color, contenido de la lista, iconos, etc.) son comunes a todas las representaciones y no se pueden modificar por separado. Por consiguiente, cuando se utilizan comandos basados en la configuración expandida/colapsada o en el elemento actual, por ejemplo `Count list items` (cuando no se pasa el parámetro final `*`), es importante poder especificar la representación que se utilizará sin ninguna ambigüedad. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Al igual que con otros comandos de gestión de propiedades de objetos, es posible utilizar el carácter "@" en el parámetro `NomLista`. Por regla general, esta sintaxis se utiliza para designar un conjunto de objetos del formulario. Sin embargo, en el contexto de los comandos de listas jerárquicas, esto no se aplica en todos los casos. Esta sintaxis tendrá dos efectos diferentes según el tipo de comando: - - Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." +- Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: +- Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl Es posible modificar la apariencia de una lista jerárquica en un formulario utilizando varios comandos 4D genéricos. Puede pasar a estos comandos el nombre del objeto de la lista jerárquica (utilizando el parámetro \*), o su nombre de variable (que contiene el valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Recordatorio: excepto `OBJECT SET SCROLL POSITION`, estos comandos modifican todas las representaciones de una misma lista, aunque sólo se especifique una lista a través de su nombre de objeto. @@ -107,8 +107,8 @@ Este principio se aplica independientemente del orden de llamada de los comandos Normalmente se puede trabajar de dos maneras con el contenido de las listas jerárquicas: por posición o por referencia. - - Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. - - Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. +- Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. +- Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. ### Utilizar los números de referencia de los artículos (itemRef) @@ -141,9 +141,9 @@ Básicamente, es necesario tratar con los números de referencia de los elemento Puede controlar si los elementos de la lista jerárquica pueden ser modificados por el usuario utilizando el atajo de teclado **Alt+clic**(Windows) / **Opción+clic** (macOS), o realizando una pulsación larga sobre el texto del elemento. - - Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). +- Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). - - Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md index eaf106e685f22c..527dc13b0f6c41 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ Especifica si el usuario puede eliminar subregistros en un subformulario listado Esta propiedad se utiliza para declarar el formulario detallado que se utilizará en el subformulario. Puede ser: - - un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ +- un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ Puede seleccionar un nombre de formulario de componente cuando se publica en el componente. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. #### Gramática JSON @@ -52,8 +52,8 @@ Esta propiedad se utiliza para declarar el formulario detallado que se utilizar Acción a realizar en caso de doble clic en una línea vacía de un subformulario listado. Las siguientes opciones están disponibles: - - No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -77,9 +77,9 @@ Acción a realizar en caso de doble clic en una línea vacía de un subformulari Define la acción a realizar cuando un usuario haga doble clic en una línea en un subformulario lista. Las opciones disponibles son: - - **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. - - **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. +- **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. +- **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. Independientemente de la acción seleccionada/elegida, se genera el evento de formulario `On Double clicked`. @@ -161,10 +161,10 @@ Especifica la tabla a la que pertenece el subformulario Lista (si la hay). Designa la opción para permitir a los usuarios seleccionar líneas: - - **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. - - **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ +- **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. +- **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que se cambia la línea actual. - - **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. +- **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Al hacer clic en el registro se selecciona, pero no se modifica el registro actual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md index cc8d6b7e0fd9cc..c6822aab4fdc97 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Las formas son [objetos estáticos](formObjects_overview.md#active-and-static-ob Se ofrecen las siguientes formas básicas: - - rectángulos - - líneas - - óvalos +- rectángulos +- líneas +- óvalos ## Rectángulo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/splitters.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/splitters.md index 8d9dc854e98bd2..44dd6b6649dcfd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/splitters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/splitters.md @@ -11,10 +11,10 @@ Los separadores se utilizan, por ejemplo, en los formularios de salida para pode Algunas de las características generales del separador: - - Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. - - Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. - - Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. +- Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. +- Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. +- Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. Una vez insertado, el separador aparece como una línea. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variable se puede utilizar en su objeto y/o métodos de formulario. Su valor indica la posición actual del separador, en píxeles, en relación con su posición inicial. - - Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, - - Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, - - Si el valor es 0: el separador se ha movido a su posición original. +- Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, +- Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, +- Si el valor es 0: el separador se ha movido a su posición original. También puede mover el separador por programación: sólo tiene que definir el valor de la variable asociada. Por ejemplo, si un separador vertical está asociado a una variable llamada `split1`, y si se ejecuta la siguiente sentencia:`split1:=-10`, el separador se moverá 10 píxeles a la izquierda - como si el usuario lo hiciera manualmente. El movimiento se realiza realmente al final de la ejecución del método del formulario u objeto que contiene la instrucción. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/stepper.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/stepper.md index abeae293a04be7..eba6d2a41dabd2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/stepper.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/stepper.md @@ -13,11 +13,11 @@ Puede asignar la variable asociada al objeto a un área introducible (campo o va Se puede asociar un stepper directamente a una variable numérica, hora o fecha. - - Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: +- Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [máximo](properties_Scale.md#máximo) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. +- Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. > Para que el stepper funcione con una variable de hora o fecha, es imprescindible definir su tipo en el formulario Y para [declararla explícitamente](../Concepts/variables.md#declaring-variables) como `Time` o `Date`. @@ -29,8 +29,8 @@ Para más información, consulte [Uso de indicadores](progressIndicator.md#using ## Ver también - - [indicadores de progreso](progressIndicator.md) - - [rulers](ruler.md) +- [indicadores de progreso](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md index e57f6f3248c56a..c06a9428ab317f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un subformulario es un formulario incluido en otro formulario. Con el fin de definir claramente los conceptos implementados con los subformularios, aquí hay algunas definiciones para ciertos términos utilizados: - - **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. - - **Formulario padre**: un formulario que contiene uno o más subformularios. - - **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. - - **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. - - **Formulario listado**: instancia de subformulario mostrada como una lista. - - **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. +- **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. +- **Formulario padre**: un formulario que contiene uno o más subformularios. +- **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. +- **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. +- **Formulario listado**: instancia de subformulario mostrada como una lista. +- **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. ## Sub-formularios en lista @@ -43,8 +43,8 @@ Puede vincular [una variable o una expresión](properties_Object.md#variable-or- Por defecto, 4D crea una variable o expresión de [tipo objeto](properties_Object.md#expression-type) para un contenedor de subformulario, lo cual le permite compartir valores en el contexto del subformulario utilizando el comando `Form`. Sin embargo, puede utilizar una variable o expresión de cualquier tipo escalar (tiempo, entero, etc.) especialmente si sólo necesita compartir un único valor: - - Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. +- Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. ### Sincronizando formulario padre y subformulario (valor único) @@ -58,8 +58,8 @@ En el formulario padre, ambos objetos (área de entrada y contenedor subformular Para mostrar una hora estática, debe utilizar el [tipo de datos](properties_DataSource.md#data-type-expression-type) apropiado para la [variable o la expresión](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. El valor del texto debe tener el formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor - - si el subformulario pertenece a la página formulario actual o a la página 0. +- en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor +- si el subformulario pertenece a la página formulario actual o a la página 0. Tenga en cuenta que, como en el ejemplo anterior, es preferible utilizar el comando `OBJECT Get subform container value` que devuelve el valor de la expresión en el contenedor del subformulario en lugar de la propia expresión, ya que es posible insertar varios subformularios en el mismo formulario padre (por ejemplo, una ventana que muestra diferentes zonas horarias contiene varios relojes). La modificación de la variable o expresión asociada desencadena eventos de formulario que permiten sincronizar los valores del formulario padre y del subformulario: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Actualizar el contenido de un formulario padre @@ -170,8 +170,8 @@ La comunicación entre el formulario padre y las instancias del subformulario pu 4D ha implementado los siguientes mecanismos para satisfacer estas necesidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md index 15cc1db6001b65..bc49bec408f392 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md @@ -42,9 +42,9 @@ En macOS, además de la posición estándar (arriba), los controles de las pesta Para suministrar las etiquetas de un control de pestañas, puede utilizar: - - un objeto - - una lista de selección - - un array +- un objeto +- una lista de selección +- un array ### Utilizar un objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/text.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/text.md index 2a64dd60b222cf..ee918a3624a6ab 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/text.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/text.md @@ -33,9 +33,9 @@ Una vez que un texto está rotado, puede seguir cambiando su tamaño o posición ![](../assets/en/FormObjects/staticText2.png) - - Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); - - Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); - - Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). +- Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); +- Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); +- Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/current/MSC/analysis.md b/i18n/es/docusaurus-plugin-content-docs/current/MSC/analysis.md index 506e5e8302c911..4e2875e55b870d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/MSC/analysis.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operación registrada en el archivo de registro aparece como una línea. La Esta información permite identificar la fuente y el contexto de cada operación: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: +- **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: - Apertura del archivo de datos: apertura de un archivo de datos. - Cierre del archivo de datos: cierre de un archivo de datos abierto. - Creación de un contexto: creación de un proceso que especifica un contexto de ejecución. @@ -30,24 +30,24 @@ Esta información permite identificar la fuente y el contexto de cada operación - Cancelación de transacción: transacción cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ ***Nota:** si la base de datos está encriptada y no se ha proporcionado una llave de datos válida correspondiente al archivo de historial abierto, los valores encriptados no se muestran en esta columna.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). El botón Navegar puede utilizarse para seleccionar y abrir otro archivo de historial para la aplicación. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/MSC/repair.md b/i18n/es/docusaurus-plugin-content-docs/current/MSC/repair.md index a14e13e028dc92..8ffaf959dad8a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/MSC/repair.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del El área "Registros encontrados en el archivo de datos" incluye dos tablas que resumen la información del análisis del archivo de datos. - - La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: +- La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Los nombres de las tablas asignadas automáticamente aparecen en verde. Los grupos no asignados, es decir, las tablas a las que no se ha podido asociar ningún registro, aparecen en rojo. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por defecto, esta opción está marcada para todos los grupos con registros que pueden asociarse a una tabla. - - La segunda tabla lista las tablas del archivo del proyecto. +- La segunda tabla lista las tablas del archivo del proyecto. ### Asignación manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Una vez finalizada la reparación, 4D genera un archivo de registro en la carpeta Logs del proyecto. Este archivo permite ver todas las operaciones realizadas. Se crea en formato XML y se llama: *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" donde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Menus/properties.md b/i18n/es/docusaurus-plugin-content-docs/current/Menus/properties.md index 8d9156ae2168c7..9f4d67cf863b7f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Menus/properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal En el editor de menús, puede introducir directamente la etiqueta como "fijo". También puede introducir una referencia para una variable o un elemento XLIFF, lo que facilitará el mantenimiento y la traducción de las aplicaciones. Puede utilizar los siguientes tipos de referencias: - - Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. Si se cambia el contenido de esta variable, se modificará la etiqueta del menú cuando se muestre. En este caso, la etiqueta llamará a un recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ La elección entre asociar una acción estándar o un método proyecto a un coma Puede asignar un método proyecto y/o una acción estándar a un comando de menú seleccionado en el editor de menú: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Puede añadir atajos de teclado a todo comando de menú. Si un comando de menú También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Esto multiplica el número de accesos directos que se pueden utilizar. Por lo tanto, se pueden definir los siguientes tipos de atajos de teclado: - - En Windows: +- En Windows: - Ctrl+caracter - Ctrl+Mayús+letra - Ctrl+Alt+caracter - Ctrl+Mayús+Alt+letra - - En macOS: +- En macOS: - Comando+letra - Comando+Mayús+letra - Comando+Opción+letra diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md index fb1cf269d6cbbf..57fc817f6e79f7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -9,17 +9,17 @@ Lea [**Novedades en 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), la ent #### Lo más destacado - - The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. - - Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. - - Lenguaje 4D: +- The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. +- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. +- Lenguaje 4D: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - Los comandos [`Num`](../commands/num.md) y [`String`](../commands/string.md) han sido actualizados para soportar conversiones en diferentes bases (radix). #### Cambios de comportamiento - - Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. - - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). +- Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. +- Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. +- Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). ## 4D 20 R10 @@ -27,27 +27,27 @@ Lea las [**Novedades en 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d-20-R #### Lo más destacado - - Gestión de [eventos ORDA en datos](../ORDA/orda-events.md). - - Nueva opción `connectionTimeout` en el parámetro [`options`](../API/TCPConnectionClass.md#options-parameter) de la función [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - Nueva clase [`4D.Vector`](../API/VectorClass.md) para procesar y comparar vectores, normalmente calculados por IAs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - Nuevas clases [`UDPSocket`](../API/UDPSocketClass.md) y [`UDPEvent`](../API/UDPEventClass.md) para enviar datos utilizando sockets UDP. Soporte de registro detallado para eventos UDP en el archivo de registro [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) (renombrado de `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Seguridad mejorada para copiar/pegar fórmulas en [4D Write Pro](../WritePro/managing-formulas.md) y [áreas de texto con estilo](../FormObjects/input_overview.md): las fórmulas copiadas desde fuera de la aplicación 4D actual se pegan ahora siempre sólo como valores. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Lenguaje 4D: +- Gestión de [eventos ORDA en datos](../ORDA/orda-events.md). +- Nueva opción `connectionTimeout` en el parámetro [`options`](../API/TCPConnectionClass.md#options-parameter) de la función [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- Nueva clase [`4D.Vector`](../API/VectorClass.md) para procesar y comparar vectores, normalmente calculados por IAs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- Nuevas clases [`UDPSocket`](../API/UDPSocketClass.md) y [`UDPEvent`](../API/UDPEventClass.md) para enviar datos utilizando sockets UDP. Soporte de registro detallado para eventos UDP en el archivo de registro [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) (renombrado de `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Seguridad mejorada para copiar/pegar fórmulas en [4D Write Pro](../WritePro/managing-formulas.md) y [áreas de texto con estilo](../FormObjects/input_overview.md): las fórmulas copiadas desde fuera de la aplicación 4D actual se pegan ahora siempre sólo como valores. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Lenguaje 4D: - Por coherencia, los comandos [`Create entity selection`](../commands/create-entity-selection.md) y [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) han sido movidos del tema ["4D Environment"](../commands/theme/4D_Environment.md) al ["Selection"](../commands/theme/Selection.md). - Nuevos comandos [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) y [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) para asignar y leer los objetos `Formula` como fuentes de datos para los objetos de formulario. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) y [`LISTBOX Get property`](../commands/listbox-get-property.md) soportan tres nuevas constantes: `lk current item`, `lk current item position` y `lk selected items expression`. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R10): lista de todos los bugs que se han corregido en 4D 20 R10. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R10): lista de todos los bugs que se han corregido en 4D 20 R10. #### Cambios de comportamiento - - En Windows, las fuentes de impresora actuales destinadas únicamente a la impresión (es decir, no se pueden utilizar en pantalla) ya no son cargadas al inicio por 4D. - - Se ha eliminado la biblioteca *MeCab*. Este cambio sólo afecta al tratamiento del texto en japonés. - - Cuando una variable o parámetro objeto se declara con un tipo ["cs" class](../Concepts/classes.md#cs), asignarlo con una instancia de objeto de una clase diferente genera ahora un error de sintaxis. +- En Windows, las fuentes de impresora actuales destinadas únicamente a la impresión (es decir, no se pueden utilizar en pantalla) ya no son cargadas al inicio por 4D. +- Se ha eliminado la biblioteca *MeCab*. Este cambio sólo afecta al tratamiento del texto en japonés. +- Cuando una variable o parámetro objeto se declara con un tipo ["cs" class](../Concepts/classes.md#cs), asignarlo con una instancia de objeto de una clase diferente genera ahora un error de sintaxis. ## 4D 20 R9 @@ -55,20 +55,20 @@ Lea [**Novedades en 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-20-R9/), #### Lo más destacado - - La biblioteca [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) está obsoleta y se eliminará en la próxima versión. - - Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). - - El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Comandos y constantes obsoletos ahora generan advertencias específicas en el [Live checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). - - Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. - - Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. - - Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. - - Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. - - Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. - - Interfaz 4D Write Pro: Nueva [IA integrada](../WritePro/writeprointerface.md#integrated-ai) para interactuar con **chatGTP** desde sus documentos 4D Write Pro. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. +- La biblioteca [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) está obsoleta y se eliminará en la próxima versión. +- Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). +- El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Comandos y constantes obsoletos ahora generan advertencias específicas en el [Live checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). +- Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. +- Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. +- Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. +- Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. +- Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. +- Interfaz 4D Write Pro: Nueva [IA integrada](../WritePro/writeprointerface.md#integrated-ai) para interactuar con **chatGTP** desde sus documentos 4D Write Pro. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. ## 4D 20 R8 @@ -76,29 +76,29 @@ Lea [**Novedades en 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-20-R8/), #### Lo más destacado - - Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). - - Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). - - Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. - - [Nueva arquitectura de componentes construidos](../Desktop/building.md#build-component) para un mejor cumplimiento de las pautas de notarización de Apple. - - Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#evaluation-application) en el cuadro de diálogo de Build App. - - Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. - - Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para un registro detallado de eventos TCP. - - Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. - - 4D Write Pro: +- Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). +- Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). +- Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. +- [Nueva arquitectura de componentes construidos](../Desktop/building.md#build-component) para un mejor cumplimiento de las pautas de notarización de Apple. +- Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#evaluation-application) en el cuadro de diálogo de Build App. +- Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. +- Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para un registro detallado de eventos TCP. +- Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. +- 4D Write Pro: - Los siguientes comandos permiten ahora parámetros como objetos o colecciones: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), y [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), y [WP Insert break](../WritePro/commands/wp-insert-break.md), son ahora funciones que devuelven rangos. - New expressions related to document attributes: [This.sectionIndex](../WritePro/managing-formulas.md), [his.sectionName](../WritePro/managing-formulas.md) and [This.pageIndex](../WritePro/managing-formulas.md). - - Lenguaje 4D: +- Lenguaje 4D: - Comandos modificados: [`FORM EDIT`](../commands/form-edit.md) - Las funciones [`.sign()`](../API/CryptoKeyClass.md#sign) y [`.verify()`](../API/CryptoKeyClass.md#verify) de la clase [4D.CryptoKey](../API/CryptoKeyClass.md) soportan Blob en el parámetro *message*. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. #### Cambios de comportamiento - - Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). - - Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. +- Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). +- Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. ## 4D 20 R7 @@ -106,30 +106,30 @@ Lea [**Novedades en 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d-20-R7/), #### Lo más destacado - - Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). - - Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. - - Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. - - Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). - - Lenguaje 4D: +- Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). +- Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. +- Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. +- Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). +- Lenguaje 4D: - Nuevos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*o\*". - - 4D Write Pro: +- 4D Write Pro: - Nuevo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) y [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. #### Cambios de comportamiento - - La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. - - El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. - - La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. +- La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. +- El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. +- La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -137,25 +137,25 @@ Lea [**Novedades en 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d-20-R6/), #### Lo más destacado - - Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). - - Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). - - Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). - - Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. - - Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. - - Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. - - Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. - - Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. - - Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). - - Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). - - Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. - - Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. +- Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). +- Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). +- Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). +- Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. +- Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. +- Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. +- Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. +- Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. +- Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). +- Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). +- Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. +- Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. #### Cambios de comportamiento - - Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). - - La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). +- Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). +- La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). ## 4D 20 R5 @@ -163,21 +163,21 @@ Lea [**Novedades en 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d-20-R5/), #### Lo más destacado - - Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. - - Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). - - Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nuevo parámetro REST [$format](../REST/$format.md). - - El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. +- Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. +- Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). +- Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nuevo parámetro REST [$format](../REST/$format.md). +- El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. #### Cambios de comportamiento - - Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). - - Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. +- Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). +- Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. ## 4D 20 R4 @@ -185,24 +185,24 @@ Lea [**Novedades en 4D 20 R4**](https://blog.4d.com/en-whats-new-in-4d-v20-R4/), #### Lo más destacado - - Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. - - Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). - - Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. - - Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). - - Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) - - Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. - - Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). - - Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. +- Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. +- Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). +- Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. +- Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). +- Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) +- Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. +- Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). +- Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. #### Cambios de comportamiento - - El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. - - 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/)). - - En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. - - Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). +- El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. +- 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/)). +- En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. +- Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -210,21 +210,21 @@ Lea [**Novedades en 4D 20 R3**](https://blog.4d.com/en-whats-new-in-4d-20-vR3/), #### Lo más destacado - - Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). - - Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) - - Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. +- Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). +- Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) +- Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. #### Cambios de comportamiento - - Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). - - 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. +- Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). +- 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. ## 4D 20 R2 @@ -238,15 +238,15 @@ Si sus aplicaciones 4D utilizan conexiones TLS, se recomienda actualizar a 4D 20 #### Lo más destacado - - Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. - - Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). - - 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. - - Interfaz Write Pro 4D: nuevo [Asistente de tablas](../WritePro/writeprointerface.md). - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. +- Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. +- Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). +- 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. +- Interfaz Write Pro 4D: nuevo [Asistente de tablas](../WritePro/writeprointerface.md). +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. #### Cambios de comportamiento - - **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. +- **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. ## 4D 20.x LTS diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md index d4c00814f4df3c..bd014a9a40fc59 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci Además, para garantizar el correcto funcionamiento de la funcionalidad, se requieren las siguientes condiciones: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descripción | | ------------------------------------------------------- | -------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Para activar el seguimiento de cambios en los datos: 4D realiza entonces los siguientes cambios: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desactivar el seguimiento de cambios de datos: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index a631cb2ae59ee4..0107bb305e4d86 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - el usuario define un valor en un formulario 4D, - el código 4D realiza una asignación con el operador `:=`. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t Este evento también se activa: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md index d03d3dca1c7412..fb06b21af0f510 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La sesión web creada en el almacén de datos remoto se identifica utilizando un El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estos principios se ilustran en los gráficos siguientes: @@ -29,9 +29,9 @@ Estos principios se ilustran en los gráficos siguientes: Los procesos que gestionan las sesiones de acceso al datastore se muestran en la ventana de administración de 4D Server: - - nombre: "REST Handler: \" - - tipo: tipo Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- tipo: tipo Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. En el siguiente ejemplo, se están ejecutando dos procesos para la misma sesión: @@ -47,11 +47,11 @@ Si se envía una solicitud al almacén de datos remoto después de haber cerrado Las funcionalidades ORDA relacionadas con el bloqueo de entidades y transacciones se gestionan a nivel del proceso en los datastores remotos, igual que en el modo cliente/servidor ORDA: - - 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. - - 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()`. No afectan a otros almacenes de datos. - - Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). +- 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. +- 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()`. No afectan a otros almacenes de datos. +- Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). Si una entidad de un datastore remoto es retenida por una transacción en un proceso, los otros procesos no pueden actualizarla, incluso si estos procesos comparten la misma sesión. - - Los bloqueos en las entidades son eliminados y las transacciones son anuladas: +- Los bloqueos en las entidades son eliminados y las transacciones son anuladas: - cuando el proceso es eliminado. - cuando la sesión se cierra en el servidor - cuando la sesión es terminada desde la ventana de administración del servidor. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md index ad2b739bcee511..410c532096b05f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contiene varias opciones para configurar el funcionamiento general Esta opción permite configurar la visualización por defecto de 4D al inicio, cuando el usuario lanza únicamente la aplicación. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forzar la visualización de la caja de diálogo de apertura cuando se selecciona esta opción, mantenga presionada la tecla **Alt** (Windows) u **Option** (macOS) mientras lanza el proyecto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir de macOS Sierra, las aplicaciones Mac pueden beneficiarse de la funció Puede beneficiarse de esta funcionalidad en los siguientes entornos (sólo con las versiones 4D de 64 bits): - - Ventanas del editor de código - - Ventanas del editor de formularios +- Ventanas del editor de código +- Ventanas del editor de formularios Todas las ventanas de estos editores se pueden poner en forma de pestaña: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Hay tres opciones disponibles: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Apariencia (sólo para macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Hay tres opciones disponibles: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferencia sólo es compatible en macOS. En Windows, se utiliza siempre el esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de datos...** - - **Base de datos a partir de una definición de estructura...** +- **Base de datos...** +- **Base de datos a partir de una definición de estructura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Al crear un nuevo archivo de datos, 4D utiliza el idioma previamente configurado Esta área configura el acceso a la documentación HTML de 4D mostrada en su navegador actual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Lenguaje de la documentación @@ -151,8 +151,8 @@ Lenguaje de la documentación HTML a mostrar. Puede seleccionar una documentaci Define dónde buscará 4D las páginas de documentación. - - Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. - - Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. +- Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. +- Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. ### Carpeta local diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/methods.md b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/methods.md index d099b6a053a938..535d7a3f295489 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite seleccionar, crear o configurar los temas del Editor de Có En esta lista, se selecciona el tema que se aplicará al editor de código. Se muestran todos los temas disponibles, incluidos los temas personalizados (si los hay). 4D ofrece dos temas por defecto: - - **Tema Light por defecto** - - **Tema oscuro por defecto** +- **Tema Light por defecto** +- **Tema oscuro por defecto** > Los temas por defecto no pueden ser modificados ni eliminados. @@ -38,8 +38,8 @@ Si los valores de las teclas no se definen en un tema personalizado, se ajustan Definir un tema significa: - - definir una fuente y un tamaño de fuente para todo el editor de código, - - asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. +- definir una fuente y un tamaño de fuente para todo el editor de código, +- asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. La combinación de colores y de estilos diferentes es especialmente útil para el mantenimiento del código. @@ -83,8 +83,8 @@ Esta página configura las opciones de visualización del Editor de Código. Permite desactivar/activar los parámetros del código "internacional" para la aplicación 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Si modifica esta opción, deberá reiniciar la aplicación 4D para que se tenga en cuenta el cambio. @@ -138,9 +138,9 @@ Permite ocultar todos los iconos expandir/desplegar por defecto al mostrar el c Activa la inserción automática de () y de llaves de cierre mientras se escribe el código. Esta opción controla dos funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Activa la inserción automática de () y de llaves de cierre mientras se escribe Define la señalización gráfica de las llaves correspondientes en el código. Esta señalización aparece siempre que se selecciona un corchete, un paréntesis o una llave. Las siguientes opciones están disponibles: - - **Ninguno**: sin señales - - **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ +- **Ninguno**: sin señales +- **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Resaltado de las variables y campos @@ -162,9 +162,9 @@ Permite resaltar todas las ocurrencias de la misma variable o campo en una venta ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Project/architecture.md b/i18n/es/docusaurus-plugin-content-docs/current/Project/architecture.md index 188712c0ba8aab..0f0bc09902602d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Project/architecture.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitectura de un proyecto Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de una carpeta raíz del proyecto (carpeta paquete). Por ejemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de u La carpeta Project suele contener la siguiente jerarquía: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Clases` - `DatabaseMethods` - `Métodos` - `Formularios` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` El archivo de desarrollo de proyecto, utilizado para designar y lanzar el proyecto. Este archivo puede ser abierto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > En los proyectos 4D, el desarrollo se realiza con 4D y el desarrollo multiusuarios se gestiona a través de las herramientas de control de versión. 4D Server puede abrir archivos .4DProject para realizar pruebas. @@ -120,9 +120,9 @@ Este archivo de texto también puede contener llaves de configuración, en parti La carpeta Trash contiene los métodos y formularios que se han eliminado del proyecto (si los hay). Puede contener las siguientes carpetas: - - `Métodos` - - `Formularios` - - `TableForms` +- `Métodos` +- `Formularios` +- `TableForms` Dentro de estas carpetas, los nombres de los elementos eliminados van entre paréntesis, por ejemplo "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Esta carpeta contiene [**parámetros usuario para datos**](../Desktop/user-setti La carpeta Logs contiene todos los archivos de registro utilizados por el proyecto. Los archivos de registro incluyen, en particular: - - conversión de base de datos, - - peticiones del servidor web, - - registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) - - depuración de comandos, - - Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). +- conversión de base de datos, +- peticiones del servidor web, +- registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) +- depuración de comandos, +- Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). > Una carpeta Logs adicional está disponible en la carpeta de preferencias del usuario del sistema (carpeta 4D activa, ver el comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para los archivos de registro de mantenimiento y e diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/es/docusaurus-plugin-content-docs/current/Project/components.md index d78b8ae0802fd2..30ff39ad49a15b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Project/components.md @@ -13,15 +13,15 @@ Al desarrollar en 4D, los archivos de los componentes pueden almacenarse de form Los componentes pueden ser interpretados o [compilados](../Desktop/building.md). - - Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. - - Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. +- Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. +- Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. ### Carpeta Package La carpeta del paquete de un componente puede contener: - - para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). +- para **componentes compilados**: - una carpeta "Contents" que contenga un archivo .4DZ, una carpeta *Resources*, un archivo *Info.plist* (arquitectura recomendada) - o directamente un archivo .4DZ con otras carpetas como *Resources*. @@ -37,8 +37,8 @@ La arquitectura de carpetas "Contents" se recomienda para los componentes si des Esta página describe cómo trabajar con componentes en los entornos **4D** y **4D Server**. En otros entornos, los componentes se gestionan de manera diferente: - - en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. - - en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). +- en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. +- en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página describe cómo trabajar con componentes en los entornos **4D** y ** Para cargar un componente en su proyecto 4D, usted puede: - - copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), - - o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). +- copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), +- o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). Los componentes declarados en el archivo **dependencies.json** pueden almacenarse en diferentes ubicaciones: - - al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, - - en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** - - en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. +- al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, +- en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** +- en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. Si se instala el mismo componente en distintos lugares, se aplica un [orden de prioridad](#priority). @@ -69,8 +69,8 @@ El archivo **dependencies.json** hace referencia a todos los componentes requeri Puede contener: - - nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), - - nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). +- nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), +- nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ El archivo **environment4d.json** es opcional. Permite definir **rutas personali Los principales beneficios de esta arquitectura son los siguientes: - - puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. - - si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. +- puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. +- si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. ### Prioridad @@ -187,9 +187,9 @@ En cuanto a los componentes almacenados en GitHub, tanto los archivos [**depende Los componentes 4D disponibles en GitHub pueden ser referenciados y cargados automáticamente en sus proyectos 4D. - - Comprima los archivos componentes en formato ZIP. - - Nombre este archivo con el mismo nombre que el repositorio GitHub. - - Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. +- Comprima los archivos componentes en formato ZIP. +- Nombre este archivo con el mismo nombre que el repositorio GitHub. +- Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. Estos pasos pueden automatizarse fácilmente, con código 4D o utilizando GitHub Actions, por ejemplo. @@ -232,7 +232,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g ::: - - **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: +- **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: ```json { @@ -245,7 +245,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g } ``` - - Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: +- Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: ```json { @@ -262,17 +262,17 @@ Un rango se define mediante dos versiones semánticas, un mínimo y un máximo, Estos son algunos ejemplos: - - "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. - - "\*": la última versión lanzada. - - "1.\*": todas las versiones de la versión principal 1. - - "1.2.\*": todos los parches de la versión menor 1.2. - - ">=1.2.3": la última versión, a partir de la versión 1.2.3. - - ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. - - "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. - - "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. - - "<=1.2.3": la última versión hasta la 1.2.3. - - "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. - - "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. +- "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. +- "\*": la última versión lanzada. +- "1.\*": todas las versiones de la versión principal 1. +- "1.2.\*": todos los parches de la versión menor 1.2. +- ">=1.2.3": la última versión, a partir de la versión 1.2.3. +- ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. +- "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. +- "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. +- "<=1.2.3": la última versión hasta la 1.2.3. +- "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. +- "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. Si no especifica una etiqueta o una versión, 4D recupera automáticamente la "última" versión. @@ -282,9 +282,9 @@ El gestor de dependencias comprueba periódicamente si hay actualizaciones de co Si quiere usar la regla de dependencia [**Seguir la versión 4D**](#defining-a-github-dependency-version-range), las etiquetas para las versiones de componentes en el repositorio de Github deben cumplir con convenciones específicas. - - **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". +- **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". - - **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". +- **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". :::note @@ -310,8 +310,8 @@ A continuación, deberá [suministrar su token de conexión](#providing-your-git Los componentes GitHub a los que se hace referencia se descargan en una carpeta de caché local y, a continuación, se cargan en su entorno. La carpeta de caché local se guarda en la siguiente ubicación: - - en macOs: `$HOME/Library/Caches//Dependencies` - - en Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- en Windows: `C:\Users\\AppData\Local\\Dependencies` ...donde `` puede ser "4D", "4D Server" o "tool4D". @@ -319,12 +319,12 @@ Los componentes GitHub a los que se hace referencia se descargan en una carpeta When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Esto incluye: - - **Dependencias primarias**: componentes que declara explícitamente en su archivo `dependencies.json` - - **Dependencias secundarias**: componentes requeridos por dependencias primarias u otras dependencias secundarias, que se resuelven e instalan automáticamente +- **Dependencias primarias**: componentes que declara explícitamente en su archivo `dependencies.json` +- **Dependencias secundarias**: componentes requeridos por dependencias primarias u otras dependencias secundarias, que se resuelven e instalan automáticamente The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ En un proyecto abierto, puede añadir, eliminar, actualizar y obtener informaci Para mostrar el panel Dependencias: - - con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
+- con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - con 4D Server, seleccione el ítem de menú **Ventana/Dependencias del Proyecto**.
+- con 4D Server, seleccione el ítem de menú **Ventana/Dependencias del Proyecto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) A continuación, se muestra el panel Dependencias. Las dependencias se ordenan por nombre en orden alfabético: @@ -362,11 +362,11 @@ Por defecto, se listan todas las dependencias identificadas por el gestor de dep ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. - - **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. +- **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. ### Dependencias secundarias @@ -384,16 +384,16 @@ Las dependencias que requieren la atención del desarrollador se indican mediant Las siguientes etiquetas de estado están disponibles: - - **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). - - **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). - - **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. - - **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). - - **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). - - **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. - - **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. - - **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). - - **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. - - **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. +- **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). +- **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). +- **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. +- **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). +- **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). +- **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. +- **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. +- **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). +- **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. +- **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. Al pasar el ratón por encima de la línea de dependencia, se muestra un mensaje que ofrece información adicional sobre el estado: @@ -427,8 +427,8 @@ Este elemento no se muestra si la relación está inactiva porque no se encuentr El icono del componente y el logotipo de ubicación ofrecen información adicional: - - El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. - - Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. +- El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. +- Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Si el elemento seleccionado no es válido, se mostrará un mensaje de error. Haga clic en **Añadir** para añadir la dependencia al proyecto. - - Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). - - Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). +- Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). +- Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Puede definir la opción [etiqueta o versión](#tags-and-versions) para una depe ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). - - **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. - - **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. - - **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. - - **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. +- **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). +- **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. +- **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. +- **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. +- **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. La versión actual de la dependencia de GitHub se muestra a la derecha del elemento de la dependencia: @@ -509,8 +509,8 @@ Modificar el rango de versiones es útil, por ejemplo, si utiliza la función de El gestor de dependencias ofrece una gestión integrada de las actualizaciones en GitHub. Se soportan las siguientes funcionalidades: - - Verificación automática y manual de las versiones disponibles - - Actualización automática y manual de los componentes +- Verificación automática y manual de las versiones disponibles +- Actualización automática y manual de los componentes Las operaciones manuales pueden realizarse **por dependencia** o **para todas las dependencias**. @@ -526,11 +526,11 @@ Si suministra un [token de acceso](#providing-your-github-access-token), las ver Además, puede buscar actualizaciones en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. +- Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. ![componente de verificación](../assets/en/Project/check-component-one.png) - - Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. +- Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. ![componentes de verificación](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Si no desea utilizar una actualización de componentes (por ejemplo, desea perma Puede actualizar las dependencias en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: +- Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: ![componente de verificación](../assets/en/Project/update-component-one.png) - - Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: +- Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: ![componentes de verificación](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ En cualquier caso, sea cual sea el estado actual de la dependencia, se realiza u Al seleccionar un comando de actualización: - - se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. - - si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. +- se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. +- si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. #### Actualización automática @@ -575,13 +575,13 @@ Cuando esta opción no está marcada, una nueva versión del componente que coin Registrar su token de acceso personal en el gestor de dependencias es: - - obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), - - recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. +- obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), +- recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. Para proporcionar su token de acceso a GitHub, también puede: - - haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. - - o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. +- haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. +- o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Project/documentation.md b/i18n/es/docusaurus-plugin-content-docs/current/Project/documentation.md index dd5d2bb8fab21b..56d2bc618d04fd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Project/documentation.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Project/documentation.md @@ -7,10 +7,10 @@ En los proyectos aplicación, puede documentar sus métodos así como sus clases Los siguientes elementos del proyecto aceptan la documentación: - - Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) - - Clases - - Formularios - - Tablas y campos +- Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) +- Clases +- Formularios +- Tablas y campos Sus archivos de documentación se escriben en la sintaxis Markdown (archivos .md) utilizando cualquier editor que soporte el Markdown. Se almacenan como archivos independientes dentro de la carpeta Proyecto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Clases` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. - - Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. > Renombrar o eliminar un elemento documentado en su proyecto también renombrará o eliminará el archivo Markdown asociado al elemento. @@ -73,9 +73,9 @@ Para ver la documentación en la ventana del Explorador: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. +- De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. ### Modificar el archivo de documentación @@ -83,8 +83,8 @@ Puede crear y/o editar un archivo de documentación Markdown desde la ventana de Si no existe un archivo de documentación para el elemento seleccionado, puede: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ El editor de código 4D muestra una parte de la documentación de un método en Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ +- O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ En este caso, la primera línea contiene el **prototipo** del método, generado automáticamente por el analizador de código de 4D. :::note @@ -130,7 +130,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Markdown soportado - - La etiqueta del título es soportada: +- La etiqueta del título es soportada: ```md # Title 1 @@ -138,7 +138,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Title 3 ``` - - Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: +- Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: ```md _italic_ @@ -147,7 +147,7 @@ _italic_ ~~strikethrough~~ ``` - - La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: +- La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: ````md ```4d @@ -156,7 +156,7 @@ _italic_ ``` ```` - - La etiqueta de la tabla es soportada: +- La etiqueta de la tabla es soportada: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La etiqueta del enlace es soportada: +- La etiqueta del enlace es soportada: ```md // Caso 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Las etiquetas de imagen son soportadas: +- Las etiquetas de imagen son soportadas: ```md ![image info](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - Vista del explorador: +- Vista del explorador: ![](../assets/en/Project/explorer_Doc.png) - - Vista del editor de código: +- Vista del editor de código: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/$attributes.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/$attributes.md index 275ccf33d10908..2e1fa51b509978 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/$attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/$attributes.md @@ -11,18 +11,18 @@ Si tiene atributos relacionales en una dataclass, utilice `$attributes` para def Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Si se especifica `$attributes` para los atributos **storage**: +- Si se especifica `$attributes` para los atributos **storage**: - `$attributes=attribute1, attribute2, ...`: solo son devueltos aquellos atributos de las entidades. ## Ejemplo con varias entidades relacionadas diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/$lock.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/$lock.md index 7d332d71a27938..55410971e14d95 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/$lock.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - otras sesiones REST - - los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. +- otras sesiones REST +- los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. Una entidad bloqueada por la API REST sólo puede ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Respuesta diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/$method.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/$method.md index f69e07af2020a7..ec63e8eb56445e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/$method.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/$method.md @@ -194,9 +194,9 @@ Si surge un problema al añadir o modificar una entidad, se le devolverá un err :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). - - **Booleanos** son true o false. - - Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). +- **Booleanos** son true o false. +- Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: ### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md index 50dca9d1af3f1b..8fae210e340e57 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Puede llamar a [funciones clase modelo de datos](ORDA/ordaClasses.md) definidas Las funciones pueden llamarse de dos maneras: - - utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. - - usando **GET requests**, con parámetros directamente pasados en la URL. +- utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. +- usando **GET requests**, con parámetros directamente pasados en la URL. Las peticiones POST ofrecen un mejor nivel de seguridad porque evitan la ejecución de código sensible a través de una acción tan simple como hacer clic en un enlace. Sin embargo, las peticiones GET pueden ser más compatibles con la experiencia del usuario, permitiendo llamar a las funciones introduciendo una URL en un navegador (nota: el desarrollador debe asegurarse de que no se hace ninguna acción sensible en dichas funciones). @@ -96,11 +96,11 @@ Puede enviar parámetros a funciones definidas en clases de usuario ORDA o singl Se aplican las siguientes reglas: - - En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. - - En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. - - Los parámetros deben estar incluidos en una colección (formato JSON). - - Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. - - La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. +- En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. +- Los parámetros deben estar incluidos en una colección (formato JSON). +- Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. +- La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Ver [este ejemplo](#usando-una-entidad-que-se-creará-en-el-servidor) y [este ejemplo](#recibiendo-una-selección-de-entidades-como-parámetro). @@ -134,8 +134,8 @@ También puede pasar valores para todos los atributos de la entidad. Estos valor | __ENTITY | Boolean | Obligatorio - True para indicar al servidor que el parámetro es una entidad | | __KEY | mixto (mismo tipo que la llave primaria) | Opcional - llave primaria de la entidad | - - Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. - - Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados +- Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. +- Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados Vea ejemplos a continuación para crear o actualizar entidades con peticiones POST. Vea un ejemplo de descarga de contenidos utilizando una entidad con una petición GET. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/authUsers.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/authUsers.md index c3c4ed71c409a9..d0e2bbfcbd0b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/authUsers.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/authUsers.md @@ -45,9 +45,9 @@ Todas las demás peticiones REST (manejando datos o ejecutando una función) só Las peticiones REST descriptivas pueden procesarse en sesiones de usuario web que no requieren licencias (sesiones "invitado"). Estas peticiones son: - - peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - la renderización de una página Qodly +- peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - la renderización de una página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -74,8 +74,8 @@ La función puede recibir cualquier información de autenticación o contextual Esta función debe contener dos partes: - - algún código para identificar y autenticar al remitente de la petición REST, - - si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. +- algún código para identificar y autenticar al remitente de la petición REST, +- si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. Si la función no llama a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), no se asignan privilegios, no se consume ninguna licencia y las solicitudes REST no descriptivas posteriores son rechazadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/gettingStarted.md index 46b9ed831ac9e9..12f01887dc5591 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta sección pretende ayudar a familiarizarse con la funcionalidad de REST mediante un ejemplo sencillo. Vamos a: - - crear y configurar un proyecto de aplicación 4D básico - - acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. +- crear y configurar un proyecto de aplicación 4D básico +- acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. Para simplificar el ejemplo, vamos a utilizar 4D y un navegador que se ejecutan en la misma máquina. Por supuesto, también puede utilizar una arquitectura remota. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/processes.md b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/processes.md index 8a4e226d14542e..a74d6094bb15d1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/processes.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/processes.md @@ -17,15 +17,15 @@ También hay tres botones de acceso directo que se pueden utilizar para filtrar ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Cuando seleccione esta opción: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), - - se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), +- se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. La área inferior de la ventana se utiliza para mostrar la representación gráfica de la actividad del proceso(s) seleccionados. @@ -33,16 +33,16 @@ La área inferior de la ventana se utiliza para mostrar la representación gráf La actividad del proceso es el porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). La ventana ofrece la siguiente información para cada proceso: - - Tipo de proceso (ver abajo), - - Sesión/Información: +- Tipo de proceso (ver abajo), +- Sesión/Información: - Proceso 4D - en blanco, - Proceso usuario - Nombre del usuario 4D, - Proceso web - ruta URL, - - Nombre del proceso, - - Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. - - Estado actual del proceso, - - Tiempo de ejecución (en segundos) del proceso desde su creación, - - Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). +- Nombre del proceso, +- Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. +- Estado actual del proceso, +- Tiempo de ejecución (en segundos) del proceso desde su creación, +- Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). ## Tipo del proceso @@ -83,15 +83,15 @@ La página también tiene cinco botones de control que actúan sobre el proceso ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. > También puede abortar directamente el proceso o procesos seleccionados sin que aparezca la caja de diálogo de confirmación, manteniendo pulsada la tecla **Alt** mientras hace clic en este botón, o utilizando el comando [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md). - - **Pausar proceso**: permite pausar los procesos seleccionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). +- **Pausar proceso**: permite pausar los procesos seleccionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md index b5f68a49fd85a1..b8e58da5e0ebd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Se añade una línea para cada operación larga realizada en los datos. Esta lí La siguiente información se ofrece para cada línea: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ La siguiente información se ofrece para cada línea: La página está activa y se actualiza permanentemente en cuanto se muestra. Cabe señalar que su funcionamiento puede ralentizar considerablemente la ejecución de la aplicación. Es posible suspender la actualización de esta página de una de las siguientes maneras: - - haciendo clic en el botón **Pausa**, - - haciendo clic en la lista, - - presionando la barra espaciadora. +- haciendo clic en el botón **Pausa**, +- haciendo clic en la lista, +- presionando la barra espaciadora. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Puede reanudar el seguimiento de las operaciones realizando la misma acción que para la pausa. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Users/overview.md b/i18n/es/docusaurus-plugin-content-docs/current/Users/overview.md index 1a6a770fa85ec1..e4be7309079c9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Users/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Users/overview.md @@ -7,8 +7,8 @@ Si diferentes personas utilizan una aplicación, lo que suele ocurrir en la arqu La estrategia de control de acceso 4D depende de la configuración de su despliegue: - - en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, - - en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). +- en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, +- en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md index df220ec536d74a..af0dc26c7caf25 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ En *filePath*, pase la ruta de destino y el nombre del documento a exportar. Si Puede especificar el formato del archivo exportado incluyendo una extensión después del nombre del documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", o ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", o ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si no se incluye la extensión, pero se especifica el formato en *paramObj*, el archivo exportado tendrá la extensión que corresponda al formato, excepto para el formato CSV (en este caso no se añade ninguna extensión). @@ -88,25 +88,25 @@ El parámetro opcional *paramObj* le permite definir múltiples propiedades para **Notas sobre el formato Excel**: - - Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. - - Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. +- Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. **Notas sobre el formato PDF**: - - Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato CSV**: - - Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. - - Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. +- Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato de archivo SpreadJS**: - - Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. Una vez finalizada la operación de exportación, `VP EXPORT DOCUMENT` activa automáticamente la ejecución del método definido en la propiedad *formula* del *paramObj*, si se usa. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md index 4e1ca7ad5d3faf..3cffc70a02a70e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ En *vpAreaName*, pase el nombre de la propiedad del área 4D View Pro. Si pasa u Puede definir dónde obtener las hojas de estilo en el parámetro opcional *sheet* utilizando el índice de la hoja (la numeración comienza en 0) o con las siguientes constantes: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md index a132f4e4e78712..ddf88d1521f080 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ El objeto devuelto contendrá la propiedad `value` y, en caso de un valor fecha Si el objeto devuelto incluye una fecha u hora, se trata como una fecha-hora y se completa de la siguiente manera: - - valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) - - valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) +- valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) +- valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) Si *rangeObj* contiene varias celdas o varios rangos, se devuelve el valor de la primera celda. El comando devuelve un objeto null si la celda está vacía. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md index ca195bc81d2546..da43df81de44db 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ En *vpAreaName*, pase el nombre del área 4D View Pro. Si pasa un nombre que no En *filePath*, pase la ruta y el nombre del documento a importar. Se soportan los siguientes formatos: - - Los documentos 4D View Pro (extensión ".4vp") - - Microsoft Excel (extensión ".xlsx") - - documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) - - [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Los documentos 4D View Pro (extensión ".4vp") +- Microsoft Excel (extensión ".xlsx") +- documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) +- [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si la extensión del documento no es una extensión reconocida, como `.4vp` o `.xlsx`, el documento se considera un documento texto. Debe pasar una ruta completa, a menos que el documento se encuentre en el mismo nivel que la carpeta Project, en cuyo caso puede pasar sólo su nombre. @@ -73,11 +73,11 @@ El parámetro opcional *paramObj* permite definir las propiedades del documento :::note Notas - - La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. - - Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. +- Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md index 4746c96876092d..9d54bc19ff1a48 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ El comando `VP RESIZE TABLE` cambi Se aplican las siguientes reglas: - - Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. - - Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. - - Si la tabla se expande en las celdas que contienen datos: +- Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. +- Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. +- Si la tabla se expande en las celdas que contienen datos: - si se añaden líneas, se eliminan datos, - si se añaden columnas, los datos se mantienen y se muestran en nuevas columnas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md index c5583c5ef7e576..bf7a7c5e68dbd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Las hojas de cálculo se componen de líneas y columnas. A cada línea se le aso ### Selección de celdas, columnas y líneas - - Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. +- Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. - - Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. +- Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. - - Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: +- Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. +- Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. - - Para seleccionar una línea, haga clic en el número correspondiente. +- Para seleccionar una línea, haga clic en el número correspondiente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. +- Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. ### Entrada de datos @@ -76,8 +76,8 @@ Las áreas 4D View Pro se benefician de un menú contextual automático que ofre Dependiendo del área seleccionada, también están disponibles las siguientes opciones: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - haga clic en una celda o en un rango de celdas: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- haga clic en una celda o en un rango de celdas: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. Cuando se ha introducido un comentario para un área, la celda superior izquierda del área muestra un pequeño triángulo rojo:\ @@ -128,8 +128,8 @@ Luego, puede pasar `$myRange` a otro método 4D View Pro para modificar estas ce Los objetos rango 4D View Pro se componen de varias propiedades: - - area - El nombre del área 4D View Pro - - rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- area - El nombre del área 4D View Pro +- rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propiedad | | Tipo | Descripción | Disponible para | | --------- | ------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Los objetos rango 4D View Pro se componen de varias propiedades: 4D View Pro soporta la importación y exportación de varios formatos de documentos: - - .4vp - - .xlsx - - .txt y .csv - - .sjs - - .pdf (sólo para exportación) +- .4vp +- .xlsx +- .txt y .csv +- .sjs +- .pdf (sólo para exportación) Para más detalles, consulte la descripción de [VP IMPORT DOCUMENT](commands/vp-import-document.md) y [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md index 5872ab721ceeae..e63a91059426ad 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Algunos otros elementos tienen una capitalización diferente (por ejemplo: `this Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y sin espacios. Además, los nombres de las constantes de QodlyScript comienzan con la letra `k`. Puede que necesite adaptar estos elementos de QodlyScript al lenguaje 4D. - - Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. - - Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. +- Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. +- Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. ### Ejemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y end ``` - - Código 4D equivalente: +- Código 4D equivalente: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md index 7f1958b3caa0e6..666a14a5e8f1fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ En las secciones anteriores, obtenemos acceso libre a la aplicación desde las p La forma más sencilla y segura de registrar un usuario en el servidor web de 4D se basa en el siguiente escenario: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Cree una tabla con algunos campos, por ejemplo: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index c7c8d1f1f9b64c..c9312623050565 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ Cuando un manejador de peticiones HTTP personalizado intercepta una solicitud, s Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - gestionar una autenticación a través de oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- gestionar una autenticación a través de oAuth 2.0. ## Requisitos Se soportan gestores de solicitudes HTTP personalizados: - - cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,20 +72,20 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ Ej: `"pattern": "docs"` o `"pattern": "docs/invoices"` - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. Ej: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). #### Concordancia de modelos -URL patterns are triggered in the given order: +Los modelos de URL se activan en el orden indicado: - - se ejecuta el primer modelo coincidente - - the following patterns are not executed even if they match the URL +- se ejecuta el primer modelo coincidente +- los siguientes patrones no se ejecutan aunque coincidan con la URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Clase y método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Ver abajo](#request-handler-code) para obtener información sobre el código del gestor de peticiones. @@ -208,11 +208,11 @@ He aquí un ejemplo detallado de un archivo HTTPHandlers.json: En este ejemplo, debe implementar las siguientes funciones: - - *funciónhandle* en la clase \*GeneralHandling - - *manageAccount* en la clase *UsersHandling* - - *handleInvoices* en la clase *FinancialHandling* - - *handleDocs* en la clase *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* +- *funciónhandle* en la clase \*GeneralHandling +- *manageAccount* en la clase *UsersHandling* +- *handleInvoices* en la clase *FinancialHandling* +- *handleDocs* en la clase *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* Examples of URLs triggering the handlers: @@ -278,7 +278,7 @@ El archivo **HTTPHandlers.json**: ] ``` -The called URL is: http://127.0.0.1:8044/putFile?fileName=testFile +La URL llamada es: http://127.0.0.1:8044/putFile?fileName=testFile The binary content of the file is put in the body of the request and a POST verb is used. El nombre del archivo se da como parámetro (*fileName*) en la URL. Se recibe en el objeto [`urlQuery`](../API/IncomingMessageClass.md#urlquery) en la petición. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md index 23ef4ba8fb93cf..c71390506d2053 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, | Servidor Web | cooperativo | *configuración web* | | Servidor Web Services | cooperativo | *configuración web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de servicios web: gestiona las peticiones SOAP - - ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de servicios web: gestiona las peticiones SOAP +- ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: - if scalable sessions are enabled, the preemptive mode is automatically used for web and web service processes. - if scalable sessions are not enabled: - for web processes, the [**Use preemptive processes**](webServerConfig.md#use-preemptive-processes) option is taken into account. @@ -36,21 +36,21 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, Todo el código 4D ejecutado por el servidor web debe ser hilo seguro si quiere que sus procesos web se ejecuten en modo apropiativo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos los métodos base relacionados con la web: +- Todos los métodos base relacionados con la web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) and [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml +- Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para tablas con el atributo "Exponer como recurso REST" +- Triggers para tablas con el atributo "Exponer como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST For each of these methods and code parts, the compiler will check if the [thread-safety rules are respected](../Develop/preemptive.md#writing-a-thread-safe-method), and will return errors in case of issues. @@ -62,8 +62,8 @@ La mayoría de los comandos y funciones 4D relacionados con la web, los métodos Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -73,15 +73,15 @@ Por supuesto, el código ejecutado por estos métodos también debe ser hilo seg Las siguientes URLs 4D Web Server son hilo seguro y pueden ser utilizadas en modo apropiativo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Icono de proceso web apropiativo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md index 27a1612435010b..590d79e5690534 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio también puede utilizarse en la [**plataforma Qodly Cloud**](https: Qodly Studio propone una interfaz web completa, que le permite: - - create Qodly pages by placing components on a canvas - - mapear componentes a Qodly Sources - - activar código 4D configurando eventos - - y mucho más. +- create Qodly pages by placing components on a canvas +- mapear componentes a Qodly Sources +- activar código 4D configurando eventos +- y mucho más. ## Configuración @@ -24,19 +24,19 @@ Qodly Studio propone una interfaz web completa, que le permite: Qodly Studio soporta los siguientes navegadores web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La resolución recomendada es 1920x1080. #### Aplicación 4D - - Desarrollo: 4D v20 R2 o superior - - Despliegue: 4D Server v20 R2 o superior - - Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). - - Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). - - El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). +- Desarrollo: 4D v20 R2 o superior +- Despliegue: 4D Server v20 R2 o superior +- Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). +- Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). +- El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). ### Acceso a Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio es servido por el [servidor web WebAdmin](../Admin/webAdmin.md) y m Para permitir el acceso a Qodly Studio, debe permitirlo explícitamente en dos niveles: - - a nivel de la aplicación 4D - - a nivel del proyecto +- a nivel de la aplicación 4D +- a nivel del proyecto Si uno de los dos niveles (o ambos) no están habilitados, se niega el acceso a Qodly Studio (se devuelve una página 403). @@ -79,8 +79,8 @@ La autenticación en el servidor web WebAdmin se realiza utilizando una llave de De acuerdo con la gestión de proyectos 4D, sólo se admiten los siguientes usos: - - el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La página Qodly Studio está disponible cuando el [servidor web WebAdmin está Hay dos formas de acceder a Qodly Studio: - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si el servidor web WebAdmin ya está en funcionamiento, dependiendo de su configuración, su navegador por defecto se abre en `IPaddress:HTTPPort/studio` o `IPaddress:HTTPSPort/studio`. De lo contrario, se le preguntará si desea iniciar primero el servidor web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` o: @@ -145,24 +145,24 @@ Note that in 4D single-user, if you open some 4D code with the Qodly Studio code Los siguientes comandos y clases están dedicados a la gestión del lado del servidor de las páginas Qodly: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. - - Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. - - Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. - - clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. +- Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. +- Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. +- clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. ### Uso métodos proyecto Recomendamos utilizar funciones clase en lugar de métodos proyecto. Sólo las funciones de clase pueden ser llamadas desde los componentes. Sin embargo, puede seguir utilizando sus métodos de proyecto en Qodly Studio de dos maneras: - - Puede llamar a sus métodos desde funciones clase. - - Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. +- Puede llamar a sus métodos desde funciones clase. +- Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. ### Uso sin conexión Puede desarrollar con Qodly Studio mientras su ordenador no esté conectado a Internet. En este caso, sin embargo, las siguientes funciones no están disponibles: - - [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía - - Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). +- [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía +- Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). ## Despliegue @@ -178,8 +178,8 @@ Mira [esta página](https://developer.qodly.com/docs/studio/rendering) para obte Para habilitar el renderizado de las páginas Qodly, se deben configurar las siguientes opciones. - - La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. - - El [servidor web 4D](webServer.md) debe estar ejecutándose. +- La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. +- El [servidor web 4D](webServer.md) debe estar ejecutándose. :::note @@ -309,9 +309,9 @@ Para cerrar la sesión del usuario, solo necesita ejecutar la acción estándar Al desencadenar la acción de cierre de sesión de una sesión de usuario web, se producen los siguientes efectos: - - la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), - - se libera la licencia asociada de 4D, - - el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. +- la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), +- se libera la licencia asociada de 4D, +- el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. ## Acerca del uso de licencias para renderización @@ -363,7 +363,7 @@ Para más información sobre el atributo `SameSite`, consulte [esta entrada de b Para evitar utilizar más licencias de las necesarias, recomendamos hacer una de las siguientes cosas: - - Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. - - Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. +- Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. +- Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/templates.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/templates.md index 9f07c189b3543c..fe6a075457925b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/templates.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Las siguientes etiquetas 4D están disponibles: - - 4DTEXT, para insertar variables y expresiones 4D como texto, - - 4DHTML, para insertar el código HTML, - - 4DEVAL, para evaluar toda expresión 4D, - - 4DSCRIPT, para ejecutar un método 4D, - - 4DINCLUDE, para incluir una página dentro de otra, - - 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, - - 4DCODE, para insertar el código 4D, - - 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, - - 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, - - 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. +- 4DTEXT, para insertar variables y expresiones 4D como texto, +- 4DHTML, para insertar el código HTML, +- 4DEVAL, para evaluar toda expresión 4D, +- 4DSCRIPT, para ejecutar un método 4D, +- 4DINCLUDE, para incluir una página dentro de otra, +- 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, +- 4DCODE, para insertar el código 4D, +- 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, +- 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, +- 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md index 2426aba0213929..3a3ad6511e0fe4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un proyecto 4D puede iniciar y monitorizar un servidor web para la aplicación p El servidor web principal de 4D puede iniciarse de diferentes maneras: - - Utilizando un botón o comando de menú. +- Utilizando un botón o comando de menú. - 4D: **Ejecutar\>Iniciar el servidor Web** menú
![](../assets/en/WebServer/start1.png) - 4D Server: botón **Iniciar servidor HTTP** de la página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) +- Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) - - Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. +- Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. El servidor web de todo componente puede ser lanzado llamando a la función [`webServer.start()`](API/WebServerClass.md#start) en el objeto servidor web del componente. @@ -29,9 +29,9 @@ El servidor web de todo componente puede ser lanzado llamando a la función [`we El servidor web principal de 4D puede detenerse de diferentes maneras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. +- Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ En cualquier momento, puede vacíar la caché de las páginas y de las imágenes Para ello, puede: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. La caché se borra inmediatamente. @@ -64,11 +64,11 @@ La caché se borra inmediatamente. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. ## URL para la administración @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Cuando se llam 4D le permite generar dos historiales de peticiones web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md index 24de898df0677a..3a5757f2bf5bfe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts y métodos permitidos para el servicio CORS. Nombre de dominio o dirección IP desde donde las páginas externas pueden enviar solicitudes de datos al Servidor a través de CORS. Se pueden añadir múltiples atributos de dominio para crear una lista blanca. Se soportan varias sintaxis: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propiedad methods) Métodos HTTP aceptados para el host CORS correspondiente. Se soportan los siguientes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separe cada método con un ";" (por ejemplo: "post;get"). Si methods está vacío, null o indefinido, todos los métodos están activos. @@ -145,9 +145,9 @@ Por defecto, cuando el servidor web se lanza por primera vez, 4D crea una págin Puede designar otra página de inicio por defecto introduciendo su nombre de ruta. - - La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - La ruta no debe comenzar ni terminar con una barra. +- La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- La ruta no debe comenzar ni terminar con una barra. Por ejemplo, si quiere que la página de inicio por defecto sea "MyHome.htm", y se encuentra en la carpeta "Web" (situada a su vez en la carpeta raíz HTML por defecto), utilice "Web/MyHome.htm". @@ -318,13 +318,13 @@ Valores posibles: cadena de direcciones IP. Los formatos IPv6 (por ejemplo "2001 #### Acerca de la compatibilidad con IPv6 - - **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. +- **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. Si su servidor 4D no parece responder en el puerto definido, puede probar la dirección [::1] en la máquina del servidor (equivalente a 127.0.0.1 para IPv6, añada [:portNum] para probar otro número de puerto). Si 4D responde, es probable que otra aplicación esté utilizando el puerto en IPv4. - - **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. +- **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. - - **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: +- **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: ```code4d 2001:0DB8::85a3:0:ac1f:8001 // Dirección IPv6 @@ -417,10 +417,10 @@ Versión mínima de TLS aceptada para las conexiones. Se rechazarán los intento Valores posibles: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (por defecto) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (por defecto) +- 4 = TLSv1_3 Valores posibles: @@ -486,10 +486,10 @@ Por ejemplo: Disallow: /GIFS/ ``` - - “User-Agent: \*” - todos los robots son afectados. - - “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. - - “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. - - “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. +- “User-Agent: \*” - todos los robots son afectados. +- “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. +- “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. +- “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. Otro ejemplo: @@ -514,15 +514,15 @@ Además, la carpeta raíz HTML define, en el disco duro del servidor web, el niv Por defecto, 4D define una carpeta raíz HTML llamada **WebFolder**. Si no existe, la carpeta raíz HTML se crea físicamente en el disco en el momento en que se lanza el servidor web por primera vez. Se crea la carpeta raíz: - - con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). - - con 4D en modo remoto, en la carpeta de recursos locales. +- con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). +- con 4D en modo remoto, en la carpeta de recursos locales. Puede designar otra página carpeta HTML raíz por defecto introduciendo su ruta de acceso. - - La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta - - La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). +- La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta +- La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). Por ejemplo, si quiere que la carpeta raíz HTML sea la subcarpeta "Web" de la carpeta "MyWebApp", introduzca "MyWebApp/Web". @@ -577,9 +577,9 @@ Valor del atributo `SameSite` de la cookie de sesión. Este atributo le permite Hay tres valores disponibles: - - "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. - - "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). - - "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. +- "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). +- "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). El valor del atributo `Secure` de la cookie de sesión se define automáticamente en "True" si la conexión es HTTPS (sea cual sea el valor del atributo `SameSite`). @@ -619,9 +619,9 @@ En algunos casos, se pueden invocar otras funciones internas optimizadas. Las co Dos opciones le permiten definir cómo funcionan las conexiones persistentes: - - **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limitar el número de peticiones por conexión le permite evitar la inundación del servidor debido a un gran número de peticiones entrantes (una técnica utilizada por los hackers).

+- **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limitar el número de peticiones por conexión le permite evitar la inundación del servidor debido a un gran número de peticiones entrantes (una técnica utilizada por los hackers).

El valor por defecto (100) puede aumentarse o disminuirse en función de los recursos de la máquina que aloja el Servidor Web 4D.

- - **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Una vez transcurrido este periodo, el servidor cierra la conexión.

+- **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Una vez transcurrido este periodo, el servidor cierra la conexión.

Si el navegador envía una solicitud después de que se haya cerrado la conexión, se crea automáticamente una nueva conexión TCP. Esta operación no es visible para el usuario.

diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md index 4eee0fff8607b1..2215d57311fd1f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un proyecto 4D puede iniciar y monitorear un servidor web para la aplicación pr Por ejemplo, si ha instalado dos componentes en su aplicación principal, puede iniciar y supervisar hasta tres servidores web independientes desde su aplicación: - - un servidor web para la aplicación local, - - un servidor web para el componente #1, - - un servidor web para el componente #2. +- un servidor web para la aplicación local, +- un servidor web para el componente #1, +- un servidor web para el componente #2. Aparte de la memoria, no hay límite en el número de componentes y por lo tanto, de servidores web, que se pueden adjuntar a un solo proyecto de aplicación 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicación local o componente) puede ser utilizado en su propio contexto independiente, incluyendo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - el procesamiento de las etiquetas 4D y las llamadas de métodos, - - sesiones web y gestión del protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- el procesamiento de las etiquetas 4D y las llamadas de métodos, +- sesiones web y gestión del protocolo TLS. Esto le permite desarrollar componentes independientes y funcionalidades que vienen con sus propias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si la aplicación utiliza componentes y quiere llamar a: - - el servidor web de la aplicación local a partir de un componente o - - el servidor que ha recibido la solicitud (sin importar el servidor), +- el servidor web de la aplicación local a partir de un componente o +- el servidor que ha recibido la solicitud (sin importar el servidor), también se puede utilizar: @@ -94,8 +94,8 @@ Estas propiedades son definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. si no se utiliza, en los parámetros de la aplicación local o del componente. - - Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. - - Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). +- Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. +- Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion*, y *perfectForwardSecrecy* son propiedades de sólo lectura que no pueden predefinirse en el parámetro del objeto `settings` para la función [`start()`](API/WebServerClass.md#start). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md index 775755c86b19a5..aaf5a0ae4cbc51 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ El comando **WP Insert break** inse En *targetObj*, pase: - - un rango, o - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - un documento 4D Write Pro +- un rango, o +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- un documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insertar el contenido al principio del objetivo | | wk replace | Integer | 0 | Sustituir contenido de destino | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Constante | Tipo | Valor | Comentario | | --------------------- | ------- | ----- | ------------------------------------------------------------------------------------- | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Si *targetObj* no es un rango, *rangeUpdate* se ignora. +- Si *targetObj* no es un rango, *rangeUpdate* se ignora. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md index 90b584c29f6f92..9b4b9d5dd56d7d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ El comando **WP Insert document body**The **Form** command returns the object associated with the current form (instantiated from the *formData* parameter or the user class assigned in the Form editor).El comando **Form** devuelve el objeto asociado al formulario actual (instanciado a partir del parámetro *formData* o de la clase de usuario asignada en el editor de formularios). 4D asocia automáticamente un objeto al formulario actual en los siguientes casos: - - el formulario actual ha sido cargado por uno de los comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), - - el formulario actual es un subformulario, - - un formulario de tabla se muestra actualmente en la pantalla. +- el formulario actual ha sido cargado por uno de los comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), +- el formulario actual es un subformulario, +- un formulario de tabla se muestra actualmente en la pantalla. ### Comandos (DIALOG...) Si el formulario actual se está mostrando o cargando mediante una llamada a los comandos [DIALOG](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), **Form** devuelve cualquiera de los dos: - - el objeto *formData* pasado como parámetro a este comando, si existe, - - o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, - - o, un objeto vacío. +- el objeto *formData* pasado como parámetro a este comando, si existe, +- o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, +- o, un objeto vacío. ### Subformulario Si el formulario actual es un subformulario, el objeto devuelto depende de la variable contenedor padre: - - Si la variable asociada al contenedor padre ha sido tipificada como objeto, **Form** devuelve el valor de esta variable.\ +- Si la variable asociada al contenedor padre ha sido tipificada como objeto, **Form** devuelve el valor de esta variable.\ En este caso, el objeto devuelto por **Form** es el mismo que el devuelto por la siguiente expresión: ```4d (OBJECT Get pointer(Object subform container))-> ``` - - Si la variable asociada al contenedor padre no ha sido tipificada como objeto, **Form** devuelve un objeto vacío, mantenido por 4D en el contexto del subformulario. +- Si la variable asociada al contenedor padre no ha sido tipificada como objeto, **Form** devuelve un objeto vacío, mantenido por 4D en el contexto del subformulario. Para más información, consulte la sección *Subformularios de página*. @@ -69,7 +69,7 @@ En un formulario que muestra el registro de una persona, un botón "Check childr **Nota:** el campo objeto "Children" se representa sólo para mostrar su estructura en este ejemplo. -En el formulario de verificación, ha asignado algunas propiedades del objeto Formulario a las entradas: +En el formulario de verificación, ha asignado algunas propiedades del objeto Form a las entradas: ![](../assets/en/commands/pict3541682.en.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/generate-uuid.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/generate-uuid.md new file mode 100644 index 00000000000000..be4b8814606634 --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| Resultado | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
Historia + +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## Descripción + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form. + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## Ejemplo + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## Propiedades + +| | | +| ----------------- | --------------------------- | +| Número de comando | 1066 | +| Hilo seguro | ✓ | + + diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md index 6154cc3aea3326..5d6d8d4c2581f6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Si el nuevo índice del elemento está más allá del último elemento existente Puede pasar cualquier número de valores de los siguientes tipos soportados: - - number (real, longint...). Los valores numéricos se almacenan siempre como reales. - - text - - boolean - - date - - time (almacenado como número de milisegundos - real) - - null - - objeto compartido - - colección compartida +- number (real, longint...). Los valores numéricos se almacenan siempre como reales. +- text +- boolean +- date +- time (almacenado como número de milisegundos - real) +- null +- objeto compartido +- colección compartida :::note diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/print-form.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/print-form.md index 2048b233e917a3..1358e18b92a2e4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/print-form.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs En el parámetro *form*, puede pasar: - - el nombre de un formulario, o - - la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o - - un objeto que contiene la descripción del formulario. +- el nombre de un formulario, o +- la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o +- un objeto que contiene la descripción del formulario. Como **Print form** no genera un salto de página después de imprimir el formulario, es fácil combinar diferentes formularios en la misma página. Así, **Print form** es perfecto para tareas de impresión complejas que implican diferentes tablas y diferentes formularios. Para forzar un salto de página entre formularios, utilice el comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir la impresión a la página siguiente de un formulario cuya altura es superior al espacio disponible, invoque el comando [CANCEL](../commands-legacy/cancel.md) antes del comando [PAGE BREAK](../commands-legacy/page-break.md). Se pueden utilizar tres sintaxis diferentes: - - **Impresión de área de detalle** +- **Impresión de área de detalle** Sintaxis: @@ -43,7 +43,7 @@ Sintaxis: En este caso, **Print form** sólo imprime el área de detalle del formulario (el área entre la línea de encabezado y la línea de detalle). - - **Impresión de área de formulario** +- **Impresión de área de formulario** Sintaxis: @@ -79,7 +79,7 @@ En este caso, el comando imprimirá la sección designada por el *marker*. Pase | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impresión de sección** +- **Impresión de sección** Sintaxis: @@ -101,8 +101,8 @@ El valor devuelto por **Print form** indica la altura del área de impresión. E Las cajas de diálogo de la impresora no aparecen cuando se utiliza **Print form**. El informe no utiliza la configuración de impresión definida en el modo Diseño para el formulario. Hay dos formas de especificar los parámetros de impresión antes de realizar una serie de llamadas a **Print form**: - - Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. - - Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. +- Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. +- Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. **Print form** crea cada página impresa en la memoria. Cada página se imprime cuando la página en memoria está llena o cuando se llama a [PAGE BREAK](../commands-legacy/page-break.md). Para asegurar la impresión de la última página después de cualquier uso de **Print form**, debe concluir con el comando [PAGE BREAK](../commands-legacy/page-break.md) (excepto en el contexto de un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). En caso contrario, si la última página no está llena, permanece en memoria y no se imprime. @@ -116,8 +116,8 @@ Este comando imprime áreas y objetos externos (por ejemplo, áreas 4D Write o 4 **4D Server:** este comando puede ejecutarse en 4D Server en el marco de un procedimiento almacenado. En este contexto: - - Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). - - En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. +- Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). +- En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/process-info.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/process-info.md index b4751f2dfdaa35..d4a6922bde6cc9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/process-info.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/process-info.md @@ -44,7 +44,7 @@ El objeto devuelto contiene las siguientes propiedades: | type | Integer | Tipo de proceso en ejecución. Valores posibles: ver abajo | | visible | Boolean | True si es visible, false en caso contrario | - - Valores posibles para "state": +- Valores posibles para "state": | Constante | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ El objeto devuelto contiene las siguientes propiedades: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores posibles para "type": +- Valores posibles para "type": | Constante | Valor | | ----------------------------- | ----- | diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/session.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/session.md index b7f7e51f07b0c6..2da30fc83dedf0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/session.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Ver también +## Ver también [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/string.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/string.md index d7e576558f0478..814287ac7b37e2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/string.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/string.md @@ -31,7 +31,7 @@ displayed_sidebar: docs El comando **String** devuelve en forma de cadena alfanumérica la expresión numérica, fecha, hora, cadena o booleana que se pasa en *expression*. -Si no pasa ningún parámetro, la cadena se devuelve con el formato apropiado por defecto. Si pasa *format*, puede forzar que la cadena resultante tenga un formato específico. +If you do not pass any other parameter, the string is returned with the appropriate default format. Si pasa *format*, puede forzar que la cadena resultante tenga un formato específico. El parámetro opcional *addTime* añade una hora a una fecha en un formato combinado. Sólo puede utilizarse cuando el parámetro *expression* es una fecha (ver abajo). @@ -90,7 +90,7 @@ Si pasa 0 en *base*, el comando determina la base dependiendo del valor de *expr :::info - Esta sintaxis sigue estrictamente la especificación [`toString` EcmaScript sobre el manejo del radix](https://tc39.es/ecma262/multipage/numbers-and-dates.html#sec-number.prototype.tostring). -- Utilizar esta sintaxis con *base*=10 no dará exactamente los mismos resultados que utilizar la sintaxis sin el parámetro *base*. Por ejemplo, si el valor numérico especificado no es un número, se devuelve la cadena "Nan". +- Utilizar esta sintaxis con *base*=10 no dará exactamente los mismos resultados que utilizar la sintaxis sin el parámetro *base*. For example, if the specified number value is not a number, the "NaN" string is returned. ::: @@ -257,11 +257,11 @@ Si *expression* se evalúa como Null, el comando devuelve la cadena "null". Esto ## Ver también -[Bool](bool.md)\ -[Date](date.md)\ +[Bool](../commands-legacy/bool.md)\ +[Date](../commands-legacy/date.md)\ [Num](num.md)\ -[Time string](time-string.md)\ -[Timestamp](timestamp.md) +[Time string](../commands-legacy/time-string.md)\ +[Timestamp](../commands-legacy/timestamp.md) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/client-server.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/client-server.md index e3802249a306f6..2682c1471d6107 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/client-server.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/client-server.md @@ -13,8 +13,8 @@ Las páginas Cliente-Servidor agrupan los parámetros relacionados con el uso de Esta opción le permite indicar si la base de datos 4D Server aparecerá o no en la lista de bases de datos publicadas. - - Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). - - Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. +- Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). +- Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. :::note @@ -49,11 +49,11 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con 4D Server utiliza tres puertos TCP para las comunicaciones entre los servidores internos y los clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). - - **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). +- **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ Tenga en cuenta que en caso de acceso a través de un enrutador o un cortafuegos, los tres puertos TCP deben abrirse explícitamente. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. #### Autenticación del usuario con el servidor de dominio @@ -67,9 +67,9 @@ Cuando la autenticación única (SSO) está activa (ver arriba), debe llenar est Esta caja desplegable contiene 3 opciones de capa de red a elegir entre: **legacy**, **ServerNet** y **QUIC** (sólo en modo proyecto), que se utilizan para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). - - **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -109,9 +109,9 @@ Esta opción permite activar el modo seguro para las comunicaciones entre la má Este parámetro puede utilizarse para definir globalmente el modo de actualización de la instancia local de la carpeta **Resources** en los equipos 4D conectados cuando se modifica la carpeta **Resources** de la base de datos durante la sesión (la carpeta **Resources** se sincroniza automáticamente en el equipo remoto cada vez que se abre una sesión). Hay tres parámetros disponibles: - - **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. - - **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ +- **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. +- **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ La carpeta **Resources** centraliza los archivos personalizados necesarios para la interfaz de la base (archivos de traducción, imágenes, etc.). Se pueden utilizar mecanismos automáticos o manuales para notificar a cada cliente cuándo se ha modificado el contenido de esta carpeta. Para más información, consulte la sección [Gestión de la carpeta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuración IP @@ -124,10 +124,10 @@ Esta tabla permite definir las reglas de control de acceso a la base en función El funcionamiento de la tabla de configuración es el siguiente: - - La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. - - La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. - - La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. - - Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: +- La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. +- La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. +- La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. +- Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: - Denegar 192.168.\* (denegar todas las direcciones que empiecen por 192.168) - Autorizar \* (y permitir todas las demás direcciones) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md index 486f1c14d151de..9865cbdbab0102 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -8,10 +8,10 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien > El número de opciones mostradas depende de la versión de 4D con la que se creó la base de datos/proyecto original, así como de los ajustes modificados en esta base de datos/proyecto.\ > Esta página enumera las opciones de compatibilidad disponibles para las bases de datos/proyectos convertidos a partir de 4D v18. Para las opciones de compatibilidad más antiguas, consulte la [página Compatibilidad](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) en **doc.4d.com**. - - **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. +- **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. **Nota**: esta opción también puede gestionarse por programación utilizando el comando `SET DATABASE PARAMETER`. - - **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: +- **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: - el caracter inicial "/" no es sólo el nodo raíz - la utilización del caracter / como primer caracter en una expresión XPath no declara una ruta absoluta desde el nodo raíz - no hay nodo actual implícito - el nodo actual debe incluirse en la expresión XPath @@ -19,12 +19,12 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien Aunque no es estándar, es posible que desee seguir utilizando estas funcionalidades para que su código siga funcionando como antes -- en este caso, basta con establecer la opción *desmarcarcada*. Por otra parte, si su código no se basa en la implementación no estándar y si desea beneficiarse de las funcionalidades extendidas de XPath en sus bases de datos (como se describe en el comando [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md)), asegúrese de que la opción \**Utilizar XPath estándar* esté *marcada*. - - **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). +- **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). - - **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). +- **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). - - **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md index 7045cfae00c4c2..e4bd23accd32a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md @@ -45,9 +45,9 @@ La ubicación actual de esta carpeta se muestra en el área "Actual:". Puede hac Se ofrecen tres opciones de ubicación: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. > Esta opción se almacena en las "propiedades adicionales" de la estructura, accesibles durante la exportación XML de la definición de estructura (ver [Exportar e importar las definiciones de estructura](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -55,7 +55,7 @@ Se ofrecen tres opciones de ubicación: > Si cambia una de estas opciones, tiene que salir y volver a abrir la base para que el cambio surta efecto. Una vez reabierta la base, se vuelven a indexar automáticamente todos sus índices. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Cuando la opción está marcada, la arroba se considera un caracter simple si se encuentra dentro de una palabra. Esta posibilidad es especialmente útil cuando se buscan direcciones de correo electrónico, donde el signo @ se utiliza internamente. Esta opción influye en las búsquedas, ordenaciones, comparaciones de cadenas de caracteres, así como en los datos almacenados en las tablas y los que se encuentran en memoria, como los arrays. Los campos y variables de tipo alfa (indexados o no) y texto se ven afectados por como se interpreta el caracter @ en las búsquedas y ordenaciones. @@ -66,19 +66,19 @@ Se ofrecen tres opciones de ubicación: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razones de seguridad, sólo el Administrador o Diseñador de la base de datos puede modificar este parámetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. Así, un proyecto 4D puede funcionar en un lenguaje distinto del del sistema. Cuando se abre un proyecto, el motor de 4D detecta el lenguaje utilizado por el archivo de datos y lo pasa al lenguaje (modo intérpretado o compilado). Las comparaciones de texto, independientemente de si las efectúa el motor del proyecto o el lenguaje, se hacen en el mismo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). En este caso, la configuración se aplica a todas las nuevas bases creadas por 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. Este algoritmo es similar al que utilizan los programas de tratamiento de textos para determinar los límites al seleccionar una palabra sobre la que se hace doble clic. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Cuando esta opción está marcada, 4D utiliza un algoritmo simplificado. En esta configuración, todo caracter no alfanumérico (es decir, que no sea una letra o un número) se considera un separador de palabras claves. Esta configuración cumple requisitos específicos asociados a determinados idiomas, como el japonés. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. #### Soporte de Mecab (versión japonesa) @@ -96,7 +96,7 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ### Parámetros de la caché para la base - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Este valor aumenta para la optimización cuando otras aplicaciones se ejecutan en la misma máquina que 4D. - **Porcentaje de memoria disponible utilizada para la caché**: porcentaje de la memoria restante asignada por defecto a la caché.\ @@ -112,11 +112,11 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). El tamaño de la memoria caché que introduzca se reservará para la base 4D, independientemente del estado de los recursos de la máquina. Esta configuración puede utilizarse en determinadas configuraciones específicas, o cuando la base está diseñada para utilizarse en sistemas disímiles en cuanto a memoria. En la mayoría de los casos, la caché adaptativa ofrece un mejor rendimiento. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D guarda los datos colocados en la caché a intervalos regulares. Puede especificar todo intervalo de tiempo entre 1 segundo y 500 minutos. Por defecto, 4D guarda sus datos cada 20 segundos. La aplicación también guarda sus datos en el disco cada vez que cambia a otro entorno o sale de la aplicación. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Cuando prevea una entrada de muchos datos, considere la posibilidad de establecer un intervalo de tiempo breve entre guardados. En caso de corte del suministro eléctrico, sólo perderá los datos introducidos desde el último almacenamiento (si la base de datos funciona sin archivo de historial). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/interface.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/interface.md index 7d47ee3b1c3e32..b35956d2815b04 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/interface.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/interface.md @@ -23,9 +23,9 @@ La fuente y el tamaño de la fuente por defecto dependen de la plataforma de eje Otras opciones permiten configurar la visualización de varias ventanas del modo Aplicación. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Este menú permite seleccionar la paleta de colores que se utilizará en la apli Los siguientes esquemas están disponibles: - - **Claro**: la aplicación usará el Tema Claro Predeterminado +- **Claro**: la aplicación usará el Tema Claro Predeterminado ![](../assets/en/settings/light-appearance.png) - - **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado +- **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Los temas por defecto pueden ser manejados utilizando CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). El esquema de aplicación principal se aplicará a los formularios por defecto. Sin embargo, se puede remplazar: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atajos @@ -72,9 +72,9 @@ El área de Atajos directos sirve para ver y modificar los atajos por defecto pa Los accesos directos por defecto son los siguientes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece la siguiente caja de diálogo: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/security.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/security.md index 898eec6f0369de..6a18b242beb789 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/security.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/security.md @@ -11,7 +11,7 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l > Estos parámetros no se aplican a las bases proyecto abiertas en modo monopuesto. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - El Diseñador y el Administrador siempre tienen acceso al entorno de diseño y al Explorador de ejecución, incluso si no son parte explícitamente del grupo de acceso específico. Para más información sobre usuarios y grupos de usuarios, consulta el capítulo [Usuarios y grupos](../Users/handling_users_groups.md). - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. Esta opción simplifica el acceso a la base de datos a la vez que mantiene un sistema completo de control de datos. - Si ha asociado una contraseña al usuario predeterminado, al abrir la base aparece una caja de diálogo en el que los usuarios deben introducir una contraseña. - Si no ha asociado una contraseña al Usuario Predeterminado, la caja de diálogo de Identificación de Usuario no aparecerá.**Nota:** puede "forzar" la visualización de la caja de diálogo Identificación de usuario cuando el modo "Usuario por defecto" está activo, por ejemplo para conectarse como Administrador o Diseñador. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. ## Opciones - - **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: +- **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: por razones de seguridad, por defecto 4D restringe el acceso a los comandos, funciones y métodos proyecto en el [Editor de fórmulas](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) en el modo Aplicación o añadido a áreas multiestilo (usando [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), Documentos 4D Write Pro y 4D View Pro: sólo ciertas funciones 4D y métodos proyecto que han sido declarados explícitamente utilizando el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) pueden ser utilizados. Puede eliminar total o parcialmente este filtrado mediante las siguientes opciones. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Permite definir un modo de acceso ilimitado a los comandos y métodos sin perder el control de las operaciones efectuadas. Durante la fase de desarrollo, este modo puede utilizarse para probar libremente todas las fórmulas, informes, etc. Durante el funcionamiento, puede utilizarse para definir soluciones seguras que permitan el acceso temporal a comandos y métodos. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Cuando esta opción está marcada, los usuarios tienen acceso a todos los comandos 4D, plug-ins y métodos proyecto (excepto los invisibles). **Nota:** esta opción tiene prioridad sobre el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Cuando se selecciona, este comando no hace nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). - - **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. +- **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. Cuando esta opción está seleccionada: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/web.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/web.md index 5bb6986e1698d2..47dbfedecd0e87 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/web.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/web.md @@ -78,9 +78,9 @@ Cuando se selecciona esta opción, el servidor web no ofrece ningún soporte esp En este modo, puede configurar los parámetros del servidor web adicionales: - - [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) - - [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) - - [Usar procesos apropiativos](#use-preemptive-processes) +- [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) +- [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) +- [Usar procesos apropiativos](#use-preemptive-processes) #### Sesiones antiguas (sesiones procesos únicos) @@ -160,9 +160,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D El menú de formato de registro ofrece las siguientes opciones: - - **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. +- **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. - - **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ +- **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ host rfc931 user [DD/MMM/AAAA:HH:MM:SS] "request" state length\ Cada campo está separado por un espacio y cada línea termina con la secuencia CR/LF (character 13, character 10). @@ -173,9 +173,9 @@ El menú de formato de registro ofrece las siguientes opciones: > La fecha y hora son locales al servidor. - - petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) - - estado: respuesta dada por el servidor. - - longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. +- petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) +- estado: respuesta dada por el servidor. +- longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. > **Nota:** por razones de rendimiento, las operaciones se guardan en una memoria búfer por paquetes de 1Kb antes de ser escritas en el disco. Las operaciones también se escriben en disco si no se ha enviado ninguna petición cada 5 segundos. > Los posibles valores de estado son los siguientes @@ -189,16 +189,16 @@ El menú de formato de registro ofrece las siguientes opciones: > 500: Internal error > El formato CLF no puede personalizarse. - - **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. +- **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. - Referer: contiene la URL de la página que apunta al documento solicitado. - User-agent: contiene el nombre y la versión del navegador o del software cliente en el origen de la petición. > El formato DLF no se puede personalizar. - - **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. +- **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. - - **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. +- **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. **Configuring the fields** When you choose the ELF (Extended Log Format) or WLF (WebStar Log Format) format, the "Weg Log Token Selection" area displays the fields available for the chosen format. Deberá seleccionar cada campo para incluirlo en el registro. You will need to select each field to be included in the log. @@ -237,14 +237,14 @@ La siguiente tabla enumera los campos disponibles para cada formato (en orden al Configure los parámetros de copia de seguridad automática para el registro de las peticiones. Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. > En el caso de las copias de seguridad programadas, si el servidor web no fue lanzado cuando se programó la copia de seguridad, en el siguiente lanzamiento 4D considera que la copia de seguridad ha fallado y aplica los parámetros adecuados, definidos en las Propiedades de la base. @@ -258,9 +258,9 @@ Para más información sobre el soporte de los servicios web en 4D, consulte el Esta área contiene varias opciones relativas con el uso de 4D como un "servidor" de Servicios Web, es decir la publicación de los métodos proyecto en forma de Servicios Web. - - **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. - - **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. - - **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. +- **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. +- **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. > Conforme al estándar XML para los nombres de etiquetas, las cadenas de caracteres utilizadas no deben contener espacios ni comenzar con un número. Además, para evitar cualquier riesgo de incompatibilidad, recomendamos que no utilice ningún caracter extendido (como los caracteres acentuados). @@ -268,7 +268,7 @@ Esta área contiene varias opciones relativas con el uso de 4D como un "servidor Esta área contiene varias opciones relacionadas con el uso de 4D como un "cliente" de Servicios Web, es decir, suscribirse a los servicios publicados en la red. - - **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". +- **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". ## Funcionalidades Web @@ -302,9 +302,9 @@ Este botón solo está disponible en los proyectos abiertos con la aplicación 4 El botón activa la siguiente secuencia de actualización: - - Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. - - Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). - - Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. +- Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. +- Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). +- Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. Recuerde reiniciar su proyecto después de realizar esta actualización. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md index 516b88ef8f1386..513d2fdda8fdee 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md @@ -160,8 +160,8 @@ Puede pasar uno o más parámetros opcionales *param*, que se pasarán a la [fun :::note Notas - - Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. - - Si se llama a `.new()` en una clase inexistente, se devuelve un error. +- Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. +- Si se llama a `.new()` en una clase inexistente, se devuelve un error. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/Document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/Document.md index 944900df8642e6..8372233057679f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/Document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/Document.md @@ -320,8 +320,8 @@ Esta propiedad es de **solo lectura**. La propiedad `.original` devuelveel elemento de destino para un alias, un acceso directo o un archivo de enlace simbólico. El elemento objetivo puede ser: - - un objeto File - - un objeto de la carpeta +- un objeto File +- un objeto de la carpeta Para los archivos sin alias, la propiedad devuelve el mismo objeto File que el archivo. @@ -585,8 +585,8 @@ La función `.getText()` devuelve el con Opcionalmente, puede designar el conjunto de caracteres que se utilizará para leer el contenido. Puede pasar: - - en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), - - o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. +- en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), +- o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. > Para conocer la lista de los conjuntos de caracteres que soporta 4D, consulte la descripción del comando `CONVERT FROM TEXT`. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/IncomingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/IncomingMessageClass.md index aa1f9df7f9d15f..0ae9ec207f1c61 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/IncomingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/IncomingMessageClass.md @@ -3,9 +3,9 @@ id: IncomingMessageClass title: IncomingMessage --- -La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). HTTP requests and their properties are automatically received as an instance of the `4D.IncomingMessage` class. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). +La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). Las peticiones HTTP y sus propiedades se reciben automáticamente como una instancia de la clase `4D.IncomingMessage`. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). -El gestor de peticiones HTTP puede devolver cualquier valor (o nada). It usually returns an instance of the [`4D.OutgoingMessage`](OutgoingMessageClass.md) class. +El gestor de peticiones HTTP puede devolver cualquier valor (o nada). Normalmente devuelve una instancia de la clase [`4D.OutgoingMessage`](OutgoingMessageClass.md). Todas las propiedades de esta clase son de sólo lectura. Son automáticamente llenados por el gestor de peticiones. @@ -19,7 +19,7 @@ Todas las propiedades de esta clase son de sólo lectura. Son automáticamente l ### Ejemplo -The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) has been defined: +El siguiente [archivo **HTTPHandlers.json**](../WebServer/http-request-handler.md) ha sido definido: ```json [ @@ -32,7 +32,7 @@ The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) ] ``` -The `http://127.0.0.1/start/example?param=demo&name=4D` request is run with a `GET` verb in a browser. It is handled by the *gettingStarted* function of the following *GeneralHandling* singleton class: +La petición `http://127.0.0.1/start/example?param=demo&name=4D` se ejecuta con un verbo `GET` en un navegador. Se gestiona mediante la función *gettingStarted* de la siguiente clase singleton *GeneralHandling*: ```4d shared singleton Class constructor() @@ -59,7 +59,7 @@ Function gettingStarted($request : 4D.IncomingMessage) : 4D.OutgoingMessage ``` -The request is received on the server as *$request*, an object instance of the `4D.IncomingMessage` class. +La petición se recibe en el servidor como *$request*, una instancia de objeto de la clase `4D.IncomingMessage`. Esta es la respuesta: @@ -76,7 +76,7 @@ There are 2 url parts - Url parts are: start - example ### Objeto IncomingMessage -4D.IncomingMessage objects provide the following properties and functions: +Los objetos 4D.IncomingMessage ofrecen las siguientes propiedades y funciones: | | | ----------------------------------------------------------------------------------------------------------------------------------------- | @@ -115,7 +115,7 @@ Un objeto 4D.IncomingMessage es un objeto [no compartible](../Concepts/shared.md La función `.getBlob()` devuelve el cuerpo de la petición como un Blob. -If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como contenido binario, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -172,7 +172,7 @@ $value := $request.getHeader("content-type") La función `.getJSON()` devuelve el cuerpo de la solicitud como una resolución JSON. -If the body has not been given as JSON valid content, an error is raised. +Si el cuerpo no se ha dado como contenido JSON válido, se produce un error. @@ -194,7 +194,7 @@ If the body has not been given as JSON valid content, an error is raised. La función `.getPicture()` devuelve el cuerpo de la petición como una imagen (en caso de que un cuerpo enviado como una imagen). -The content-type must be given in the headers to indicate that the body is a picture. +El tipo de contenido debe indicarse en los encabezados para indicar que el cuerpo es una imagen. :::note @@ -202,7 +202,7 @@ Si la solicitud se crea utilizando la [clase `HTTPRequest`](HTTPRequestClass.md) ::: -If the body is not received as a valid picture, the function returns null. +Si el cuerpo no se recibe como una imagen válida, la función devuelve null. @@ -224,7 +224,7 @@ If the body is not received as a valid picture, the function returns null. La función `.getText()` devuelve el cuerpo de la solicitud como un valor de texto. -If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como cadena, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -254,7 +254,7 @@ Los nombres de los encabezados (llaves) se escriben en minúsculas. Tenga en cue La propiedad `.url` contiene la URL de la petición sin la parte *IP:port* y como cadena. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.url` es "/docs/invoices/today". La propiedad `.url` es de sólo lectura. @@ -276,7 +276,7 @@ La parte "host" de la petición (*IP:port*) es suministrada por el [encabezado ` La propiedad `.urlPath` contiene la URL de la solicitud sin la parte *IP:port* y como una colección de cadenas. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.urlPath` es ["docs", "invoices" , "today"]. La propiedad `.urlPath` es de sólo lectura. @@ -294,19 +294,19 @@ La propiedad `.urlQuery` contiene el verbo usado por la petición. -HTTP and HTTPS request verbs include for example "get", "post", "put", etc. +Los verbos de solicitud HTTP y HTTPS incluyen, por ejemplo, "get", "post", "put", etc. La propiedad `.verb` es de sólo lectura. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md index 3bf887380f503c..dde9a19a921c31 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objeto 4D.OutgoingMessage es un objeto [no compartible](../Concepts/shared.md La propiedad `.body` contiene el cuerpo del mensaje saliente. Los siguientes tipos de datos están soportados en la propiedad `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image La propiedad `.body` es de lectura-escritura. @@ -108,17 +108,17 @@ La función `.setBody()` def Los siguientes tipos de datos están soportados en el *body*: - - Text - - Blob - - Object - - Imagen +- Text +- Blob +- Object +- Imagen Cuando se utiliza esta función, el encabezado content-type se define automáticamente en función del tipo *body*: - - Content-Type:text/plain si el cuerpo es un Texto - - Content-Type:application/octet-stream si el body es un Blob - - Content-Type:application/json si el body es un objeto - - Content-Type:image/jpeg, image/gif... si el body es una imagen +- Content-Type:text/plain si el cuerpo es un Texto +- Content-Type:application/octet-stream si el body es un Blob +- Content-Type:application/json si el body es un objeto +- Content-Type:image/jpeg, image/gif... si el body es una imagen Si *body* no es de un tipo de valor soportado, se devuelve un error. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md index c2aac8d8067a35..9b93abeaf870fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propiedad `.keepAlive` contiene diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md index ee34091e8e1278..472d3e0bb36ed7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Los objetos de sesión son devueltos por el comando [`Session`](../commands/session.md). Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar [privilegios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sesiones Los siguientes tipos de sesiones están soportados por esta clase: @@ -38,11 +47,6 @@ La disponibilidad de las propiedades y funciones del objeto `Session` depende de | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md index c6b433cd74a1d7..b22060e96f189f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md @@ -55,8 +55,8 @@ La función `.disableState()` d Esta función no hace nada si: - - el *estado* no está habilitado actualmente en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* no está habilitado actualmente en el formulario web, +- el *estado* no existe para el formulario web. Si [activa](#enablestate) o desactiva varios estados en la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez finalizada la función. @@ -80,8 +80,8 @@ La función `.enableState()` act Esta función no hace nada si: - - el *estado* ya ha sido activado en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* ya ha sido activado en el formulario web, +- el *estado* no existe para el formulario web. Si activa o [desactiva](#disablestate) varios estados dentro de la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez que la función termina. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md index 35dc1e027ddfeb..f4215154de6605 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md @@ -86,8 +86,8 @@ La función `4D.WebSocket.new()` crea y En *url*, pase la URL a la que responderá el servidor WebSocket. Se pueden utilizar los siguientes patrones de URL: - - `ws://host[:port]path[?query]` para conexiones estándar - - `wss://host[:port]path[?query]` para conexiones seguras TLS +- `ws://host[:port]path[?query]` para conexiones estándar +- `wss://host[:port]path[?query]` para conexiones seguras TLS Si la conexión no es posible, se devuelve un objeto `null` y se genera un error (que puede interceptar utilizando un método instalado con `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la conexión no es posible, se devuelve un objeto `null` y se genera un error En *connectionHandler*, puede pasar un objeto que contenga funciones de retrollamada a ser llamadas según los eventos de conexión, así como el tipo de datos y encabezados a manejar. - - Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. - - El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. +- Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. +- El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. | Propiedad | Tipo | Descripción | | ----------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La función `.terminate()` cierr En *code*, puede pasar un código de estado que explique por qué se está cerrando la conexión (ver también [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. - - Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. +- Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. +- Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. En *reason*, puede pasar una cadena que describa por qué se está cerrando la conexión. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md index 7a39dc1916d619..dd24f32e2a209e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Ver también [esta entrada de blog](https://blog.4d.com/new-built-in-websocket-s Para crear y manejar su Servidor WebSocket en 4D, tendrá que utilizar dos clases 4D integradas: - - esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, - - la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. +- esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, +- la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. Además, tendrá que crear dos clases de usuario que contendrán funciones de retrollamada: - - una clase usuario para gestionar las conexiones al servidor, - - una clase usuario para gestionar mensajes. +- una clase usuario para gestionar las conexiones al servidor, +- una clase usuario para gestionar mensajes. Debe [crear el servidor WebSocket](#4dwebsocketservernew) dentro de un [worker](../Develop/processes.md#worker-processes) para mantener viva la conexión. @@ -387,8 +387,8 @@ De forma predeterminada, si no se establece un valor *timeout*, la función inic Si se establece un valor de *timeout*: - - cuando se alcanza el tiempo de espera, destruye forzosamente el socket. - - si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. +- cuando se alcanza el tiempo de espera, destruye forzosamente el socket. +- si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md index 7108ada0d3da2f..c5f9761b457de6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Es necesario configurar el lanzamiento al i Puede configurar el servidor web `WebAdmin` para que se lance al inicio de la aplicación 4D o 4D Server (antes de que se cargue cualquier proyecto). - - Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. +- Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Seleccione la opción **Iniciar servidor WebAdmin al inicio** en la caja de diá ![alt-text](../assets/en/Admin/waSettings.png) - - Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: +- Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Cuando esta opción está seleccionada, podrá conectarse al servidor web `WebAd **Notas:** - - Nunca se aceptan conexiones con HTTP que no sean localhost. - - Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. +- Nunca se aceptan conexiones con HTTP que no sean localhost. +- Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. #### Puerto HTTP @@ -95,11 +95,11 @@ Ruta de la carpeta donde se encuentran los archivos del certificado TLS. Por def Estado o formato del archivo de registro de peticiones HTTP (HTTPDebugLog_*nn*.txt, almacenado en la carpeta "Logs" de la aplicación -- *nn* es el número de archivo). Las siguientes opciones están disponibles: - - **Desactivado** (por defecto) - - **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición - - \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) - - **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones - - **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas +- **Desactivado** (por defecto) +- **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición +- \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) +- **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones +- **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas #### Llave de acceso @@ -109,10 +109,10 @@ La configuración de una llave de acceso es obligatoria para desbloquear el acce Una llave de acceso es similar a una contraseña pero no está asociada a un inicio de sesión. - - Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del +- Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. - - Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. +- Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. +- Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. #### Activar el acceso a Qodly Studio @@ -148,9 +148,9 @@ Ejemplo: ## Autenticación y sesión - - Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. +- Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. - - Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. +- Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. Una vez concedido el acceso, se crea una [sesión web](WebServer/sessions.md) con el privilegio "WebAdmin" en la aplicación 4D. Mientras la sesión actual tenga el privilegio "WebAdmin", el componente `WebAdmin` entrega las páginas solicitadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md index 1fb388c12979ef..44c863fc5fe3dc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar 4D le permite restaurar conjuntos enteros de datos de una aplicación en caso de que se presente un incidente, independientemente de sus causas. Pueden producirse dos categorías principales de incidentes: - - La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: +- La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: - Si la caché estaba vacía, la aplicación se abre normalmente. Se registraron todos los cambios realizados en la aplicación. Este caso no requiere ninguna operación particular. - Si la caché contiene operaciones, el archivo de datos está intacto pero requiere integrar el archivo de historial actual. - Si la caché estaba en proceso de escritura, es probable que el archivo de datos esté dañado. Hay que restaurar la última copia de seguridad e integrar el archivo de historial actual. - - La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. +- La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. > 4D puede lanzar procedimientos automáticamente de recuperación de las aplicaciones tras los incidentes. Estos mecanismos se gestionan mediante dos opciones disponibles en la página **Backup/Backup y Restauración** de las Propiedades. Para más información, consulte el párrafo [Restauración automática](settings.md#automatic-restore-and-log-integration).\ > Si la incidencia es el resultado de una operación inadecuada realizada sobre los datos (eliminación de un registro, por ejemplo), puede intentar reparar el archivo de datos utilizando la función "rollback" en el archivo de historial. Esta función está disponible en la página [Retroceder](MSC/rollback.md) del CSM. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md index 9d6b3f2706ff8c..a14ab4754a986e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md @@ -5,9 +5,9 @@ title: Parámetros de la copia de seguridad Los parámetros de copia de seguridad se definen a través de tres páginas en el [cuadro de diálogo de los parámetros](../settings/overview.md). Puede definir: - - la periodicidad de las copias de seguridad automáticas - - los archivos a incluir en cada copia de seguridad - - las funcionalidades avanzadas permiten ejecutar tareas automáticas +- la periodicidad de las copias de seguridad automáticas +- los archivos a incluir en cada copia de seguridad +- las funcionalidades avanzadas permiten ejecutar tareas automáticas > Las propiedades definidas en esta caja de diálogo se escriben en el archivo *Backup.4DSettings*, guardado en la carpeta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Los parámetros de copia de seguridad periódicos se definen en la página **Bac Las opciones que se encuentran en esta pestaña le permiten establecer y configurar las copias de seguridad periódicas automáticas de la aplicación. Puede elegir una configuración rápida estándar o puede personalizarla completamente. Aparecen varias opciones en función de la elección realizada en el menú **Copia de seguridad automática**: - - **Nunca**: la función de copia de seguridad programada está inactiva. - - **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. - - Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. - - **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. - - **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: +- **Nunca**: la función de copia de seguridad programada está inactiva. +- **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. +- Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. +- **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. +- **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: - **Cada X hora(s)**: permite programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24. * **Cada X día(s) a las x**: permite programar las copias de seguridad con una base diaria. Por ejemplo, introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe introducir la hora a la que debe comenzar la copia de seguridad. * **Cada X semana(s) a las x**: permite programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Cuando esta opción está marcada, debe introducir el día(s) de la semana y la hora que debe comenzar la copia de seguridad. Si lo desea, puede seleccionar varios días de la semana. Por ejemplo, puede utilizar esta opción para definir dos copias de seguridad semanales: una el miércoles y otra el viernes. @@ -48,12 +48,12 @@ La página Copia de seguridad/Configuración de las Propiedades permite designar Esta área le permite determinar qué archivos y/o carpetas deben copiarse durante la siguiente copia de seguridad. - - **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: +- **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: - el archivo de historial actual de la aplicación (si existe), - la carpeta `Settings` completa situada [junto al archivo de datos](../Project/architecture.md#settings-user-data) (si existe), es decir, *los parámetros usuario para los datos*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. - - **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* - - **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". +- **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. +- **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* +- **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". - **Eliminar**: retira el archivo seleccionado de la lista de archivos adjuntos. - Gestión del archivo de historial En el caso de una restitución, la carpeta se recuperará con su estructura interna. Puede seleccionar toda carpeta o volumen conectado a la máquina, a excepción de la carpeta que contiene los archivos de la aplicación. - **Añadir archivo...**: muestra una caja de diálogo que permite seleccionar un archivo para añadirlo a la copia de seguridad. @@ -82,19 +82,19 @@ La modificación de las opciones de copia de seguridad y restauración es opcion ### Parámetros generales - - **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). +- **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). Si, por ejemplo, el número de conjuntos se define en 3, las tres primeras copias de seguridad crean los archivos MyBase-0001, MyBase-0002 y MyBase-0003 respectivamente. Durante la cuarta copia de seguridad, se crea el archivo MyBase-0004 y se elimina MyBase-0001. Por defecto, el mecanismo de eliminación de conjuntos está activado y 4D guarda 3 conjuntos de copia de seguridad. Para desactivar el mecanismo, basta con deseleccionar la opción. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. +- **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. +- **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. - - **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. +- **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. - **Reintentar en la siguiente fecha y hora programada**: esta opción sólo tiene sentido cuando se trabaja con copias de seguridad automáticas programadas. Equivale a anular la copia de seguridad fallida. Se genera un error. - **Reintentar después de X segundo(s), minuto(s) u hora(s)**: cuando se marca esta opción, se ejecuta un nuevo intento de copia de seguridad después del periodo de espera. Este mecanismo permite anticipar ciertas circunstancias que pueden bloquear la copia de seguridad. Puede establecer un periodo de espera en segundos, minutos u horas utilizando el menú correspondiente. Si el nuevo intento también falla, se genera un error y se anota el fallo en el área de estado de la última copia de seguridad y en el archivo del diario de copias de seguridad. - **Cancelar la operación después de X intentos**: este parámetro se utiliza para definir el número máximo de intentos de copia de seguridad fallidos. Si la copia de seguridad no se ha realizado con éxito una vez alcanzado el número máximo de intentos establecido, se cancela y se genera el error 1401 ("Se ha alcanzado el número máximo de intentos de copia de seguridad; la copia de seguridad automática está temporalmente desactivada"). En este caso, no se intentará realizar una nueva copia de seguridad automática mientras no se haya reiniciado la aplicación o se haya realizado con éxito una copia de seguridad manual. @@ -106,15 +106,15 @@ La modificación de las opciones de copia de seguridad y restauración es opcion Estas opciones se aplican a los archivos de copia de seguridad principales y a los archivos de copia de seguridad del historial. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. El menú **Tamaño del segmento** es un combo box que permite establecer el tamaño en MB de cada segmento de la copia de seguridad. Puede elegir uno de los tamaños preestablecidos o introducir un tamaño específico entre 0 y 2048. Si se pasa 0, no se produce ninguna segmentación (esto equivale a pasar **Ninguna**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: +- **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: - **Ninguna:** no se aplica ninguna compresión de archivos. La copia de seguridad es más rápida, pero los archivos son considerablemente más grandes. - **Rápido** (por defecto): esta opción es un compromiso entre la velocidad de la copia de seguridad y el tamaño del archivo. - **Compactado**: la tasa de compresión máxima se aplica a los archivos. Los ficheros de archivos ocupan el menor espacio posible en el disco, pero la copia de seguridad se ralentiza notablemente. - - **Tasa de entrelazamiento y tasa de redundancia** +- **Tasa de entrelazamiento y tasa de redundancia** 4D genera archivos utilizando algoritmos específicos que se basan en mecanismos de optimización (entrelazamiento) y seguridad (redundancia). Puedes configurar estos mecanismos en función de sus necesidades. Los menús asociados a estas opciones contienen índices de **Bajo**, **Medio**, **Alto** y **Ninguno** (por defecto). - **Tasa de entrelazamiento**: el entrelazamiento consiste en almacenar los datos en sectores no adyacentes para limitar los riesgos en caso de daño de los sectores. Cuanto mayor sea la tasa, mayor será la seguridad; sin embargo, el procesamiento de datos utilizará más memoria. - **Tasa de redundancia**: la redundancia permite asegurar los datos presentes en un fichero repitiendo varias veces la misma información. Cuanto mayor sea la tasa de redundancia, mayor será la seguridad de los archivos; sin embargo, el almacenamiento será más lento y el tamaño de los archivos aumentará en consecuencia. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md index 7c378f6c26d239..111a7c8b4391b2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md @@ -11,8 +11,8 @@ El lenguaje 4D es compatible con los operadores que ya conoce de otros lenguajes El lenguaje 4D soporta los operadores **binarios** y **ternarios**: - - los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. - - los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). +- los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. +- los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). Los valores que los operadores afectan son los operandos. En la expresión `1 + 2`, el símbolo + es un operador binario y sus dos operandos son los valores 1 y 2. @@ -33,18 +33,18 @@ $col:=New collection //$col se inicializa con una colección vacía Los resultados del operador dependen de los **tipos de datos** a los que se aplican. 4D soporta diferentes operadores en tipos de datos escalares. Se describen con los tipos de datos, en las siguientes secciones: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) - - [**Operadores de fechas**](dt_date.md#operadores-de-fechas) - - [**Operadores de tiempo**](dt_time.md#time-operators) - - [**Operadores de números**](dt_number.md#number-operators) - - [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) - - [**Operadores de imágenes**](dt_picture.md#picture-operators) - - [**Operadores de punteros**](dt_pointer.md#pointer-operators) - - [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) - - [**Operadores en las referencias de objetos**](dt_object.md#object-operators) - - [**Operadores de referencia de colección**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) +- [**Operadores de fechas**](dt_date.md#operadores-de-fechas) +- [**Operadores de tiempo**](dt_time.md#time-operators) +- [**Operadores de números**](dt_number.md#number-operators) +- [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) +- [**Operadores de imágenes**](dt_picture.md#picture-operators) +- [**Operadores de punteros**](dt_pointer.md#pointer-operators) +- [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) +- [**Operadores en las referencias de objetos**](dt_object.md#object-operators) +- [**Operadores de referencia de colección**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) ## Operadores de asignación compuestos @@ -272,9 +272,9 @@ El operador condicional ternario permite escribir expresiones condicionales de u Se necesitan tres operandos en el siguiente orden: - - una condición seguida de un signo de interrogación (?) - - una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) - - una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) +- una condición seguida de un signo de interrogación (?) +- una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) +- una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) ### Sintaxis @@ -325,21 +325,21 @@ Además de un tipo, cada valor también tiene un valor booleano inherente, conoc Los siguientes valores son **falsy**: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Cadenas vacías - - [] - Colecciones vacías - - {} - Objetos vacios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Cadenas vacías +- [] - Colecciones vacías +- {} - Objetos vacios Todos los demás valores se consideran **truthy**, incluyendo: - - 0 - cero numérico (Entero u otro) +- 0 - cero numérico (Entero u otro) En 4D, la evaluación **truthy** y **falsy** refleja la **usabilidad** de un valor, lo que significa que un valor truthy existe y puede ser procesado por el código sin generar errores o resultados inesperados. La razón de ser de esto es ofrecer una forma conveniente de manejar valores *undefined* y *null* en objetos y colecciones, de modo que un número reducido de instrucciones [If…Else](flow-control.md#ifelseend-if) sean necesarias para evitar errores de ejecu diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md index 6a6f75713e39cc..a1cc173febeb9b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md @@ -53,8 +53,8 @@ Esta sintaxis solo soporta declaraciones de [variables locales y de proceso](#lo `varType` puede ser: - - un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, - - una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. +- un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, +- una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. Si se omite `varType`, se crea una variable de tipo **variant**. @@ -86,7 +86,7 @@ La sintaxis heredada utilizando los comandos `C_XX` es obsoleta a partir de 4D 2 ### Ejemplos - - Para declarar variables básicas locales y de proceso: +- Para declarar variables básicas locales y de proceso: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //también equivalente a C_OBJECT($o) ``` - - Para declarar las variables objeto de la clase 4D: +- Para declarar las variables objeto de la clase 4D: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Para declarar las variables objeto de la clase usuario: +- Para declarar las variables objeto de la clase usuario: ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Una variable local, como su nombre indica, es local a un método, accesible sól Es posible que desee utilizar una variable local para: - - Evitar conflictos con los nombres de otras variables - - Utilizar los datos temporalmente - - Reducir el número de variables proceso +- Evitar conflictos con los nombres de otras variables +- Utilizar los datos temporalmente +- Reducir el número de variables proceso El nombre de una variable local siempre comienza por el signo dólar ($) y puede contener hasta 31 caracteres adicionales. Si introduce un nombre más largo, 4D lo trunca a la longitud adecuada. @@ -224,9 +224,9 @@ En modo interpretado, las variables se mantienen dinámicamente; se crean y se b Un proceso puede leer y escribir las variables proceso de otro proceso utilizando los comandos `GET PROCESS VARIABLE` y `SET PROCESS VARIABLE`. Es una buena práctica de programación restringir el uso de estos comandos a la situación para la que fueron creados en 4D: - - Comunicación interprocesos en lugares específicos de su código - - Gestión de arrastrar y soltar interproceso - - En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras +- Comunicación interprocesos en lugares específicos de su código +- Gestión de arrastrar y soltar interproceso +- En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras Para más información, consulte el capítulo **Procesos** y la descripción de estos comandos. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md index 9ae01abea102b2..b87074b4252a19 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, puede que no haya suficiente memoria para crear un BLOB. O, cuan Estos son generalmente los tipos de errores más difíciles de encontrar. A excepción de los errores de digitación, todos los tipos de errores listados arriba están cubiertos hasta cierto punto por la expresión "error de diseño o de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por ejemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Los errores de diseño o de lógica también incluyen situaciones como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. A veces el código que muestra el error puede ser diferente al código que en realidad es el origen del problema. @@ -55,8 +55,8 @@ Para encontrar rápidamente el origen del problema, vuelva a abrir la versión i La ventana de error de sintaxis aparece automáticamente cuando se interrumpe la ejecución de un método. Esto puede ocurrir cuando: - - un error impide que el código siga ejecutándose - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- un error impide que el código siga ejecutándose +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ El área de texto superior muestra un mensaje describiendo el error. El área de La ventana de error de sintaxis propone varias opciones: - - **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. +- **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **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. +- **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. :::tip @@ -76,14 +76,14 @@ Para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede c ::: - - **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: +- **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: - 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. +- **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. - - **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. +- **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. ## Depurador diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md index 0aa7c3050737e9..122a0395c08180 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento se puede utilizar para filtrar la entrada de datos en los objetos ed Cuando se utiliza, este evento se genera después de cada cambio realizado en el contenido de un objeto editable, independientemente de la acción que haya provocado la modificación, *es decir*: - - Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; - - Soltar un valor (acción similar a pegar); - - Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. - - Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). +- Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; +- Soltar un valor (acción similar a pegar); +- Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. +- Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). Dentro del evento `On After Edit`, los datos de texto que se ingresan son devueltos por el comando [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md index 6600c9ead2a047..fa93861d722f2b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ El evento de formulario `On Begin Drag Over` puede ser seleccionado para todos l El evento `On Begin Drag Over` es útil para preparar la acción de arrastrar. Puede utilizarse para: - - Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). - - Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). - - Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. +- Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). +- Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). +- Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. - Para indicar que las acciones de arrastre son aceptadas, el método del objeto fuente debe devolver 0 (cero). - Para indicar que se rechazan las acciones de arrastrar, el método del objeto fuente debe devolver -1 (menos uno). - Si no se devuelve ningún resultado, 4D considera que las acciones de arrastre son aceptadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md index 21c7b1ccab37e5..40ba861bc720a5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. Sin embargo, hay varias excepciones: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md index da0b5c023d90fb..7b623c81af91d8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un registro está a punto de ser visualizado en un formulario de lista que se mu En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada registro: +- Para cada registro: - Para cada objeto en el área detallada: - Método objeto con el evento `On Display Detail` - Método formulario con el evento `On Display Detail` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md index 6b828dc261f3b0..5b1c5186896b9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over El evento `On Drag Over` se envía repetidamente al objeto de destino cuando el puntero del ratón se mueve sobre el objeto. Normalmente, en respuesta a este evento: - - Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). - - Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. +- Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). +- Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. Para **aceptar** el arrastrar, el método del objeto de destino debe devolver 0 (cero). Para **rechazar** el arrastrar, el método de objeto debe retornar -1 (menos uno). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md index 22491caa86174f..07196347369ba7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada objeto en el área del encabezado: +- Para cada objeto en el área del encabezado: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md index 4193db89f0ecc0..c09175fbd2a07b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Este evento se genera cuando se hace clic en el encabezado de una columna de lis Si se seleccionó la propiedad [Sortable](FormObjects/properties_Action.md#sortable) para el list box, se puede decidir si se autoriza o no una ordenación estándar de la columna pasando el valor 0 o -1 en la variable `$0`: - - Si `$0` es igual a 0, se realiza una ordenación estándar. - - Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. +- Si `$0` es igual a 0, se realiza una ordenación estándar. +- Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. Si la propiedad [Sortable](FormObjects/properties_Action.md#sortable) no está seleccionada para el list box, la variable `$0` no se utiliza. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md index a12a7f4383b866..f780ef9be2a24d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md @@ -9,16 +9,16 @@ Los formularios ofrecen la interfaz a través de la cual se introduce, modifica Los formularios también pueden contener otros formularios a través de las siguientes funcionalidades: - - [objetos de subformulario](FormObjects/subform_overview.md) - - [formularios heredados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulario](FormObjects/subform_overview.md) +- [formularios heredados](./properties_FormProperties.md#inherited-form-name) ## Creación de formularios Puede añadir o modificar formularios 4D utilizando los siguientes elementos: - - **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. - - **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. - - **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: +- **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. +- **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. +- **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: ``` { @@ -70,9 +70,9 @@ Puede añadir o modificar formularios 4D utilizando los siguientes elementos: Hay dos categorías de formularios: - - **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. +- **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. - - **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. +- **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. Normalmente, se selecciona la categoría del formulario al crearlo, pero se puede cambiar después. @@ -80,15 +80,15 @@ Normalmente, se selecciona la categoría del formulario al crearlo, pero se pued Cada formulario consta de al menos dos páginas: - - una página 1: una página principal, mostrada por defecto - - una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. +- una página 1: una página principal, mostrada por defecto +- una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. Puede crear varias páginas para un formulario de entrada. Si tiene más campos o variables de los que caben en una pantalla, puede crear páginas adicionales para mostrarlos. Las páginas múltiples le permiten hacer lo siguiente: - - Coloque la información más importante en la primera página y la menos importante en otras. - - Organice cada tema en su propia página. - - Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). - - Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. +- Coloque la información más importante en la primera página y la menos importante en otras. +- Organice cada tema en su propia página. +- Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). +- Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. Las páginas múltiples son útiles sólo para los formularios de entrada. No son para imprimir. Cuando se imprime un formulario de varias páginas, sólo se imprime la primera. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md index a549dcc06d28ca..b56b453cb2a0a2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md @@ -7,11 +7,11 @@ El editor de formularios 4D soporta macros. Una macro es un conjunto de instrucc Por ejemplo, si tiene un informe recurrente con un formato específico (por ejemplo, cierto texto debe aparecer en rojo y cierto texto debe aparecer en verde), puede crear una macro para definir automáticamente el color. Puede crear macros para el editor de formularios 4D que pueden: - - Crear y ejecutar código 4D - - Mostrar las cajas de diálogo - - Seleccione los objetos de formulario - - Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades - - Modificar los archivos del proyecto (actualizar, eliminar) +- Crear y ejecutar código 4D +- Mostrar las cajas de diálogo +- Seleccione los objetos de formulario +- Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades +- Modificar los archivos del proyecto (actualizar, eliminar) El código de las macros soporta [funciones de clase](Concepts/classes.md) y las [propiedades de objeto de formulario en JSON](FormObjects/properties_Reference.md) para permitir definir toda funcionalidad personalizada en el editor de formularios. @@ -238,9 +238,9 @@ Por ejemplo, si los objetos de la página actual y de los grupos han sido modifi Cuando se maneja el atributo `method` de los objetos de formulario, se puede definir el valor del atributo de dos maneras en las macros: - - Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). +- Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). - - Utilizando un objeto con la siguiente estructura: +- Utilizando un objeto con la siguiente estructura: | Propiedad | Tipo | Descripción | | --------- | ---- | ----------------- | @@ -252,9 +252,9 @@ Cuando se maneja el atributo `method` de los objetos de formulario, se puede def La propiedad `$4dId` define un ID único para cada objeto de la página actual. Esta clave es utilizada por el procesador de macros para controlar los cambios en `$result.currentPage`: - - si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. - - si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. - - si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. +- si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. +- si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. +- si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. #### Ejemplo @@ -297,8 +297,8 @@ La función `onError` se ejecuta cuando el procesador de macros encuentra un err Cuando se ejecuta una macro, si 4D encuentra un error que impide la cancelación de la macro, no la ejecuta. Es el caso, por ejemplo, de que la ejecución de una macro resulte en: - - borrar o modificar un script cuyo archivo es de sólo lectura. - - crear dos objetos con el mismo ID interno. +- borrar o modificar un script cuyo archivo es de sólo lectura. +- crear dos objetos con el mismo ID interno. #### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md index 09f69812c3b672..bea03bd3c7bafa 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Puede utilizar librerías de objetos en sus formularios. Una librería de objeto 4D propone dos tipos de librerías de objetos: - - una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. - - librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. +- una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. +- librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. ## Utilización de la librería de objetos estándar @@ -21,10 +21,10 @@ La librería se muestra en una ventana aparte: La ventana tiene las siguientes características principales: - - Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. - - Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: +- Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. +- Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar un objeto de la librería en su formulario, puede: +- Para utilizar un objeto de la librería en su formulario, puede: - hacer clic derecho en un objeto y seleccionar **Copiar** en el menú contextual - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Una determinada librería de objetos sólo puede ser abierta por un proyecto a l Para abrir una librería de objetos personalizada, seleccione el comando **Abrir>Librería de objetos...** en el menú **Archivo** o en la barra de herramientas de 4D. Aparece una caja de diálogo estándar para abrir archivos, que le permite seleccionar la librería de objetos que desea abrir. Puede seleccionar los siguientes tipos de archivos: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** De hecho, las librerías de objetos personalizadas son proyectos 4D clásicos. Sólo se exponen las siguientes partes de un proyecto cuando se abre como librería: - - formularios proyecto - - páginas formulario 1 +- formularios proyecto +- páginas formulario 1 ### Crear una librería de objetos @@ -74,10 +74,10 @@ Las principales operaciones están disponibles en el menú contextual o en el me ![](../assets/en/FormEditor/library5.png) - - **Cortar** o **Copiar** al portapapeles - - **Pegar** un objeto del tablero portapapeles - - **Borrar** - elimina el objeto de la librería - - **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. +- **Cortar** o **Copiar** al portapapeles +- **Pegar** un objeto del tablero portapapeles +- **Borrar** - elimina el objeto de la librería +- **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. Puede colocar objetos individuales (incluidos los subformularios) o conjuntos de objetos en una librería de objetos. Cada objeto o conjunto se agrupa en un solo elemento: @@ -93,9 +93,9 @@ El uso de copiar y pegar o arrastrar y soltar con ciertos objetos de librería t A continuación se muestra una lista de objetos dependientes que se pegarán en la librería al mismo tiempo que el objeto principal que los utiliza (cuando corresponda): - - Listas - - Formatos/Filtros - - Imágenes - - Mensajes de ayuda (asociados a un campo) - - Métodos objeto +- Listas +- Formatos/Filtros +- Imágenes +- Mensajes de ayuda (asociados a un campo) +- Métodos objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md index d1186f42277c5b..364e7ce2ee9c52 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Las opciones de tamaño dependen del valor de la opción **Tamaño basado en**. ## Tamaño basado en - - **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). +- **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). Puede elegir esta opción cuando desee utilizar objetos activos situados en un área fuera de la pantalla (*es decir*, fuera del rectángulo delimitador de la ventana) con una ventana de tamaño automático. Gracias a esta opción, la presencia de estos objetos no modificará el tamaño de la ventana. - - **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). +- **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). - - ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. +- ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. > Para los formularios de salida, sólo están disponibles los campos [**Margen horizontal**](#hor-margin) o [**Ancho**](#width). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md index 1391eda981bb2a..fba2d1eb026abc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Usted crea y personaliza los formularios de su aplicación manipulando los objet Los formularios 4D soportan una gran cantidad de objetos **activos** y **estáticos** integrados: - - **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. - - **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. +- **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. +- **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. ## Gestión de objetos de formulario Puede añadir o modificar objetos formulario 4D de las siguientes maneras: - - **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. +- **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. - - Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. +- Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. - - **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). +- **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). Ejemplo para un objeto botón: ```json diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md index 56e6394b61fd1d..209a1daf6f52d8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md @@ -15,7 +15,7 @@ Puede gestionar los datos con los [métodos](Concepts/methods.md) objeto o formu :::note -Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Text.md#multi-style), cuando se pegan fórmulas desde una aplicación 4D diferente o un entorno externo, solo se pegan los *valores calculados* (texto o imágenes) disponibles en el momento de la copia. If no value was available (e.g., the formula was never computed), 4D pastes the formula source as plain text. +Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Text.md#multi-style), cuando se pegan fórmulas desde una aplicación 4D diferente o un entorno externo, solo se pegan los *valores calculados* (texto o imágenes) disponibles en el momento de la copia. Si no hay ningún valor disponible (por ejemplo, la fórmula nunca se calculó), 4D pega la fuente de la fórmula como texto sin formato. ::: @@ -50,6 +50,6 @@ Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Te También puede representar expresiones de campos y de variables en sus formularios utilizando objetos alternativos, más concretamente: - - Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). - - Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). - - Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). +- Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). +- Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). +- Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md index bdcdb932db5ef1..fc2a7f771d3939 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Cuando corresponda, el icono desplegar/contraer se mostrará automáticamente a El contenido de un objeto formulario lista jerárquica se puede inicializar de una de las siguientes maneras: - - Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. - - Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. +- Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. +- Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. En ambos casos, se gestiona una lista jerárquica en tiempo de ejecución a través de su referencia *ListRef*, utilizando los comandos [lista jerárquica](../commands/theme/Hierarchical_Lists.md) del lenguaje 4D. @@ -34,9 +34,9 @@ mylist:=New list Cada representación de la lista tiene sus propias características específicas y comparte características comunes con todas las demás representaciones. Las siguientes características son específicas de cada representación de la lista: - - La selección, - - El estado desplegado/colapsado de sus elementos, - - La posición del cursor de desplazamiento. +- La selección, +- El estado desplegado/colapsado de sus elementos, +- La posición del cursor de desplazamiento. Las otras características (fuente, tamaño de fuente, estilo, control de entrada, color, contenido de la lista, iconos, etc.) son comunes a todas las representaciones y no se pueden modificar por separado. Por consiguiente, cuando se utilizan comandos basados en la configuración expandida/colapsada o en el elemento actual, por ejemplo `Count list items` (cuando no se pasa el parámetro final `*`), es importante poder especificar la representación que se utilizará sin ninguna ambigüedad. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Al igual que con otros comandos de gestión de propiedades de objetos, es posible utilizar el carácter "@" en el parámetro `NomLista`. Por regla general, esta sintaxis se utiliza para designar un conjunto de objetos del formulario. Sin embargo, en el contexto de los comandos de listas jerárquicas, esto no se aplica en todos los casos. Esta sintaxis tendrá dos efectos diferentes según el tipo de comando: - - Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." +- Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: +- Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl Es posible modificar la apariencia de una lista jerárquica en un formulario utilizando varios comandos 4D genéricos. Puede pasar a estos comandos el nombre del objeto de la lista jerárquica (utilizando el parámetro \*), o su nombre de variable (que contiene el valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Recordatorio: excepto `OBJECT SET SCROLL POSITION`, estos comandos modifican todas las representaciones de una misma lista, aunque sólo se especifique una lista a través de su nombre de objeto. @@ -107,8 +107,8 @@ Este principio se aplica independientemente del orden de llamada de los comandos Normalmente se puede trabajar de dos maneras con el contenido de las listas jerárquicas: por posición o por referencia. - - Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. - - Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. +- Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. +- Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. ### Utilizar los números de referencia de los artículos (itemRef) @@ -141,9 +141,9 @@ Básicamente, es necesario tratar con los números de referencia de los elemento Puede controlar si los elementos de la lista jerárquica pueden ser modificados por el usuario utilizando el atajo de teclado **Alt+clic**(Windows) / **Opción+clic** (macOS), o realizando una pulsación larga sobre el texto del elemento. - - Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). +- Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). - - Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md index 034511204b47ad..5883f90891be86 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ Especifica si el usuario puede eliminar subregistros en un subformulario listado Esta propiedad se utiliza para declarar el formulario detallado que se utilizará en el subformulario. Puede ser: - - un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ +- un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ Puede seleccionar un nombre de formulario de componente cuando se publica en el componente. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. #### Gramática JSON @@ -48,8 +48,8 @@ Esta propiedad se utiliza para declarar el formulario detallado que se utilizar Acción a realizar en caso de doble clic en una línea vacía de un subformulario listado. Las siguientes opciones están disponibles: - - No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -73,9 +73,9 @@ Acción a realizar en caso de doble clic en una línea vacía de un subformulari Define la acción a realizar cuando un usuario haga doble clic en una línea en un subformulario lista. Las opciones disponibles son: - - **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. - - **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. +- **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. +- **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. Independientemente de la acción seleccionada/elegida, se genera el evento de formulario `On Double clicked`. @@ -153,10 +153,10 @@ Especifica la tabla a la que pertenece el subformulario Lista (si la hay). Designa la opción para permitir a los usuarios seleccionar líneas: - - **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. - - **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ +- **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. +- **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que se cambia la línea actual. - - **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. +- **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Al hacer clic en el registro se selecciona, pero no se modifica el registro actual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md index cc8d6b7e0fd9cc..c6822aab4fdc97 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Las formas son [objetos estáticos](formObjects_overview.md#active-and-static-ob Se ofrecen las siguientes formas básicas: - - rectángulos - - líneas - - óvalos +- rectángulos +- líneas +- óvalos ## Rectángulo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md index 8d9dc854e98bd2..44dd6b6649dcfd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md @@ -11,10 +11,10 @@ Los separadores se utilizan, por ejemplo, en los formularios de salida para pode Algunas de las características generales del separador: - - Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. - - Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. - - Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. +- Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. +- Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. +- Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. Una vez insertado, el separador aparece como una línea. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variable se puede utilizar en su objeto y/o métodos de formulario. Su valor indica la posición actual del separador, en píxeles, en relación con su posición inicial. - - Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, - - Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, - - Si el valor es 0: el separador se ha movido a su posición original. +- Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, +- Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, +- Si el valor es 0: el separador se ha movido a su posición original. También puede mover el separador por programación: sólo tiene que definir el valor de la variable asociada. Por ejemplo, si un separador vertical está asociado a una variable llamada `split1`, y si se ejecuta la siguiente sentencia:`split1:=-10`, el separador se moverá 10 píxeles a la izquierda - como si el usuario lo hiciera manualmente. El movimiento se realiza realmente al final de la ejecución del método del formulario u objeto que contiene la instrucción. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md index abeae293a04be7..eba6d2a41dabd2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md @@ -13,11 +13,11 @@ Puede asignar la variable asociada al objeto a un área introducible (campo o va Se puede asociar un stepper directamente a una variable numérica, hora o fecha. - - Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: +- Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [máximo](properties_Scale.md#máximo) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. +- Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. > Para que el stepper funcione con una variable de hora o fecha, es imprescindible definir su tipo en el formulario Y para [declararla explícitamente](../Concepts/variables.md#declaring-variables) como `Time` o `Date`. @@ -29,8 +29,8 @@ Para más información, consulte [Uso de indicadores](progressIndicator.md#using ## Ver también - - [indicadores de progreso](progressIndicator.md) - - [rulers](ruler.md) +- [indicadores de progreso](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md index e57f6f3248c56a..c06a9428ab317f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un subformulario es un formulario incluido en otro formulario. Con el fin de definir claramente los conceptos implementados con los subformularios, aquí hay algunas definiciones para ciertos términos utilizados: - - **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. - - **Formulario padre**: un formulario que contiene uno o más subformularios. - - **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. - - **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. - - **Formulario listado**: instancia de subformulario mostrada como una lista. - - **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. +- **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. +- **Formulario padre**: un formulario que contiene uno o más subformularios. +- **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. +- **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. +- **Formulario listado**: instancia de subformulario mostrada como una lista. +- **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. ## Sub-formularios en lista @@ -43,8 +43,8 @@ Puede vincular [una variable o una expresión](properties_Object.md#variable-or- Por defecto, 4D crea una variable o expresión de [tipo objeto](properties_Object.md#expression-type) para un contenedor de subformulario, lo cual le permite compartir valores en el contexto del subformulario utilizando el comando `Form`. Sin embargo, puede utilizar una variable o expresión de cualquier tipo escalar (tiempo, entero, etc.) especialmente si sólo necesita compartir un único valor: - - Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. +- Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. ### Sincronizando formulario padre y subformulario (valor único) @@ -58,8 +58,8 @@ En el formulario padre, ambos objetos (área de entrada y contenedor subformular Para mostrar una hora estática, debe utilizar el [tipo de datos](properties_DataSource.md#data-type-expression-type) apropiado para la [variable o la expresión](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. El valor del texto debe tener el formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor - - si el subformulario pertenece a la página formulario actual o a la página 0. +- en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor +- si el subformulario pertenece a la página formulario actual o a la página 0. Tenga en cuenta que, como en el ejemplo anterior, es preferible utilizar el comando `OBJECT Get subform container value` que devuelve el valor de la expresión en el contenedor del subformulario en lugar de la propia expresión, ya que es posible insertar varios subformularios en el mismo formulario padre (por ejemplo, una ventana que muestra diferentes zonas horarias contiene varios relojes). La modificación de la variable o expresión asociada desencadena eventos de formulario que permiten sincronizar los valores del formulario padre y del subformulario: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Actualizar el contenido de un formulario padre @@ -170,8 +170,8 @@ La comunicación entre el formulario padre y las instancias del subformulario pu 4D ha implementado los siguientes mecanismos para satisfacer estas necesidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md index 15cc1db6001b65..bc49bec408f392 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md @@ -42,9 +42,9 @@ En macOS, además de la posición estándar (arriba), los controles de las pesta Para suministrar las etiquetas de un control de pestañas, puede utilizar: - - un objeto - - una lista de selección - - un array +- un objeto +- una lista de selección +- un array ### Utilizar un objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md index 2a64dd60b222cf..ee918a3624a6ab 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md @@ -33,9 +33,9 @@ Una vez que un texto está rotado, puede seguir cambiando su tamaño o posición ![](../assets/en/FormObjects/staticText2.png) - - Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); - - Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); - - Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). +- Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); +- Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); +- Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md index 506e5e8302c911..4e2875e55b870d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operación registrada en el archivo de registro aparece como una línea. La Esta información permite identificar la fuente y el contexto de cada operación: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: +- **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: - Apertura del archivo de datos: apertura de un archivo de datos. - Cierre del archivo de datos: cierre de un archivo de datos abierto. - Creación de un contexto: creación de un proceso que especifica un contexto de ejecución. @@ -30,24 +30,24 @@ Esta información permite identificar la fuente y el contexto de cada operación - Cancelación de transacción: transacción cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ ***Nota:** si la base de datos está encriptada y no se ha proporcionado una llave de datos válida correspondiente al archivo de historial abierto, los valores encriptados no se muestran en esta columna.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). El botón Navegar puede utilizarse para seleccionar y abrir otro archivo de historial para la aplicación. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md index a14e13e028dc92..8ffaf959dad8a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del El área "Registros encontrados en el archivo de datos" incluye dos tablas que resumen la información del análisis del archivo de datos. - - La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: +- La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Los nombres de las tablas asignadas automáticamente aparecen en verde. Los grupos no asignados, es decir, las tablas a las que no se ha podido asociar ningún registro, aparecen en rojo. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por defecto, esta opción está marcada para todos los grupos con registros que pueden asociarse a una tabla. - - La segunda tabla lista las tablas del archivo del proyecto. +- La segunda tabla lista las tablas del archivo del proyecto. ### Asignación manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Una vez finalizada la reparación, 4D genera un archivo de registro en la carpeta Logs del proyecto. Este archivo permite ver todas las operaciones realizadas. Se crea en formato XML y se llama: *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" donde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md index 8d9156ae2168c7..9f4d67cf863b7f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal En el editor de menús, puede introducir directamente la etiqueta como "fijo". También puede introducir una referencia para una variable o un elemento XLIFF, lo que facilitará el mantenimiento y la traducción de las aplicaciones. Puede utilizar los siguientes tipos de referencias: - - Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. Si se cambia el contenido de esta variable, se modificará la etiqueta del menú cuando se muestre. En este caso, la etiqueta llamará a un recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ La elección entre asociar una acción estándar o un método proyecto a un coma Puede asignar un método proyecto y/o una acción estándar a un comando de menú seleccionado en el editor de menú: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Puede añadir atajos de teclado a todo comando de menú. Si un comando de menú También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Esto multiplica el número de accesos directos que se pueden utilizar. Por lo tanto, se pueden definir los siguientes tipos de atajos de teclado: - - En Windows: +- En Windows: - Ctrl+caracter - Ctrl+Mayús+letra - Ctrl+Alt+caracter - Ctrl+Mayús+Alt+letra - - En macOS: +- En macOS: - Comando+letra - Comando+Mayús+letra - Comando+Opción+letra diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md index ddf48b3e709fa7..a207e6212a53f4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md @@ -9,27 +9,27 @@ Lea las [**Novedades en 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d-20-R #### Lo más destacado - - Gestión de [eventos ORDA en datos](../ORDA/orda-events.md). - - Nueva opción `connectionTimeout` en el parámetro [`options`](../API/TCPConnectionClass.md#options-parameter) de la función [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - Nueva clase [`4D.Vector`](../API/VectorClass.md) para procesar y comparar vectores, normalmente calculados por IAs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - Nuevas clases [`UDPSocket`](../API/UDPSocketClass.md) y [`UDPEvent`](../API/UDPEventClass.md) para enviar datos utilizando sockets UDP. Soporte de registro detallado para eventos UDP en el archivo de registro [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) (renombrado de `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Seguridad mejorada para copiar/pegar fórmulas en [4D Write Pro](../WritePro/managing-formulas.md) y [áreas de texto con estilo](../FormObjects/input_overview.md): las fórmulas copiadas desde fuera de la aplicación 4D actual se pegan ahora siempre sólo como valores. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Lenguaje 4D: +- Gestión de [eventos ORDA en datos](../ORDA/orda-events.md). +- Nueva opción `connectionTimeout` en el parámetro [`options`](../API/TCPConnectionClass.md#options-parameter) de la función [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- Nueva clase [`4D.Vector`](../API/VectorClass.md) para procesar y comparar vectores, normalmente calculados por IAs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- Nuevas clases [`UDPSocket`](../API/UDPSocketClass.md) y [`UDPEvent`](../API/UDPEventClass.md) para enviar datos utilizando sockets UDP. Soporte de registro detallado para eventos UDP en el archivo de registro [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) (renombrado de `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Seguridad mejorada para copiar/pegar fórmulas en [4D Write Pro](../WritePro/managing-formulas.md) y [áreas de texto con estilo](../FormObjects/input_overview.md): las fórmulas copiadas desde fuera de la aplicación 4D actual se pegan ahora siempre sólo como valores. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Lenguaje 4D: - Por coherencia, los comandos [`Create entity selection`](../commands/create-entity-selection.md) y [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) han sido movidos del tema ["4D Environment"](../commands/theme/4D_Environment.md) al ["Selection"](../commands/theme/Selection.md). - Nuevos comandos [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) y [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) para asignar y leer los objetos `Formula` como fuentes de datos para los objetos de formulario. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) y [`LISTBOX Get property`](../commands/listbox-get-property.md) soportan tres nuevas constantes: `lk current item`, `lk current item position` y `lk selected items expression`. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R10): lista de todos los bugs que se han corregido en 4D 20 R10. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R10): lista de todos los bugs que se han corregido en 4D 20 R10. #### Cambios de comportamiento - - En Windows, las fuentes de impresora actuales destinadas únicamente a la impresión (es decir, no se pueden utilizar en pantalla) ya no son cargadas al inicio por 4D. - - Se ha eliminado la biblioteca *MeCab*. Este cambio sólo afecta al tratamiento del texto en japonés. - - Cuando una variable o parámetro objeto se declara con un tipo ["cs" class](../Concepts/classes.md#cs), asignarlo con una instancia de objeto de una clase diferente genera ahora un error de sintaxis. +- En Windows, las fuentes de impresora actuales destinadas únicamente a la impresión (es decir, no se pueden utilizar en pantalla) ya no son cargadas al inicio por 4D. +- Se ha eliminado la biblioteca *MeCab*. Este cambio sólo afecta al tratamiento del texto en japonés. +- Cuando una variable o parámetro objeto se declara con un tipo ["cs" class](../Concepts/classes.md#cs), asignarlo con una instancia de objeto de una clase diferente genera ahora un error de sintaxis. ## 4D 20 R9 @@ -37,20 +37,20 @@ Lea [**Novedades en 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-20-R9/), #### Lo más destacado - - La biblioteca [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) está obsoleta y se eliminará en la próxima versión. - - Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). - - El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Comandos y constantes obsoletos ahora generan advertencias específicas en el [Live checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). - - Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. - - Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. - - Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. - - Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. - - Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. - - Interfaz 4D Write Pro: Nueva [IA integrada](../WritePro/writeprointerface.md#integrated-ai) para interactuar con **chatGTP** desde sus documentos 4D Write Pro. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. +- La biblioteca [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) está obsoleta y se eliminará en la próxima versión. +- Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). +- El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Comandos y constantes obsoletos ahora generan advertencias específicas en el [Live checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). +- Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. +- Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. +- Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. +- Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. +- Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. +- Interfaz 4D Write Pro: Nueva [IA integrada](../WritePro/writeprointerface.md#integrated-ai) para interactuar con **chatGTP** desde sus documentos 4D Write Pro. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. ## 4D 20 R8 @@ -58,29 +58,29 @@ Lea [**Novedades en 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-20-R8/), #### Lo más destacado - - Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). - - Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). - - Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. - - [Nueva arquitectura de componentes construidos](../Desktop/building.md#build-component) para un mejor cumplimiento de las pautas de notarización de Apple. - - Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#evaluation-application) en el cuadro de diálogo de Build App. - - Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. - - Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para un registro detallado de eventos TCP. - - Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. - - 4D Write Pro: +- Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). +- Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). +- Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. +- [Nueva arquitectura de componentes construidos](../Desktop/building.md#build-component) para un mejor cumplimiento de las pautas de notarización de Apple. +- Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#evaluation-application) en el cuadro de diálogo de Build App. +- Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. +- Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para un registro detallado de eventos TCP. +- Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. +- 4D Write Pro: - Los siguientes comandos permiten ahora parámetros como objetos o colecciones: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), y [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), y [WP Insert break](../WritePro/commands/wp-insert-break.md), son ahora funciones que devuelven rangos. - New expressions related to document attributes: [This.sectionIndex](../WritePro/managing-formulas.md), [his.sectionName](../WritePro/managing-formulas.md) and [This.pageIndex](../WritePro/managing-formulas.md). - - Lenguaje 4D: +- Lenguaje 4D: - Comandos modificados: [`FORM EDIT`](../commands/form-edit.md) - Las funciones [`.sign()`](../API/CryptoKeyClass.md#sign) y [`.verify()`](../API/CryptoKeyClass.md#verify) de la clase [4D.CryptoKey](../API/CryptoKeyClass.md) soportan Blob en el parámetro *message*. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. #### Cambios de comportamiento - - Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). - - Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. +- Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). +- Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. ## 4D 20 R7 @@ -88,30 +88,30 @@ Lea [**Novedades en 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d-20-R7/), #### Lo más destacado - - Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). - - Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. - - Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. - - Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). - - Lenguaje 4D: +- Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). +- Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. +- Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. +- Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). +- Lenguaje 4D: - Nuevos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - Nuevo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) y [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. #### Cambios de comportamiento - - La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. - - El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. - - La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. +- La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. +- El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. +- La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -119,25 +119,25 @@ Lea [**Novedades en 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d-20-R6/), #### Lo más destacado - - Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). - - Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). - - Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). - - Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. - - Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. - - Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. - - Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. - - Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. - - Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). - - Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). - - Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. - - Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. +- Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). +- Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). +- Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). +- Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. +- Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. +- Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. +- Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. +- Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. +- Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). +- Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). +- Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. +- Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. #### Cambios de comportamiento - - Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). - - La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). +- Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). +- La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). ## 4D 20 R5 @@ -145,21 +145,21 @@ Lea [**Novedades en 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d-20-R5/), #### Lo más destacado - - Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. - - Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). - - Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nuevo parámetro REST [$format](../REST/$format.md). - - El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. +- Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. +- Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). +- Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nuevo parámetro REST [$format](../REST/$format.md). +- El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. #### Cambios de comportamiento - - Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). - - Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. +- Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). +- Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. ## 4D 20 R4 @@ -167,24 +167,24 @@ Lea [**Novedades en 4D 20 R4**](https://blog.4d.com/en-whats-new-in-4d-v20-R4/), #### Lo más destacado - - Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. - - Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). - - Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. - - Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). - - Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) - - Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. - - Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). - - Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. +- Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. +- Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). +- Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. +- Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). +- Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) +- Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. +- Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). +- Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. #### Cambios de comportamiento - - El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. - - 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/)). - - En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. - - Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). +- El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. +- 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/)). +- En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. +- Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -192,21 +192,21 @@ Lea [**Novedades en 4D 20 R3**](https://blog.4d.com/en-whats-new-in-4d-20-vR3/), #### Lo más destacado - - Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). - - Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) - - Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. +- Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). +- Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) +- Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. #### Cambios de comportamiento - - Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). - - 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. +- Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). +- 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. ## 4D 20 R2 @@ -220,15 +220,15 @@ Si sus aplicaciones 4D utilizan conexiones TLS, se recomienda actualizar a 4D 20 #### Lo más destacado - - Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. - - Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). - - 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. - - Interfaz Write Pro 4D: nuevo [Asistente de tablas](../WritePro/writeprointerface.md). - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. +- Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. +- Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). +- 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. +- Interfaz Write Pro 4D: nuevo [Asistente de tablas](../WritePro/writeprointerface.md). +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. #### Cambios de comportamiento - - **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. +- **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. ## 4D 20.x LTS diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md index d4c00814f4df3c..bd014a9a40fc59 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci Además, para garantizar el correcto funcionamiento de la funcionalidad, se requieren las siguientes condiciones: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descripción | | ------------------------------------------------------- | -------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Para activar el seguimiento de cambios en los datos: 4D realiza entonces los siguientes cambios: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desactivar el seguimiento de cambios de datos: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md index a631cb2ae59ee4..0107bb305e4d86 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - el usuario define un valor en un formulario 4D, - el código 4D realiza una asignación con el operador `:=`. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t Este evento también se activa: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md index d03d3dca1c7412..fb06b21af0f510 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La sesión web creada en el almacén de datos remoto se identifica utilizando un El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estos principios se ilustran en los gráficos siguientes: @@ -29,9 +29,9 @@ Estos principios se ilustran en los gráficos siguientes: Los procesos que gestionan las sesiones de acceso al datastore se muestran en la ventana de administración de 4D Server: - - nombre: "REST Handler: \" - - tipo: tipo Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- tipo: tipo Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. En el siguiente ejemplo, se están ejecutando dos procesos para la misma sesión: @@ -47,11 +47,11 @@ Si se envía una solicitud al almacén de datos remoto después de haber cerrado Las funcionalidades ORDA relacionadas con el bloqueo de entidades y transacciones se gestionan a nivel del proceso en los datastores remotos, igual que en el modo cliente/servidor ORDA: - - 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. - - 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()`. No afectan a otros almacenes de datos. - - Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). +- 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. +- 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()`. No afectan a otros almacenes de datos. +- Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). Si una entidad de un datastore remoto es retenida por una transacción en un proceso, los otros procesos no pueden actualizarla, incluso si estos procesos comparten la misma sesión. - - Los bloqueos en las entidades son eliminados y las transacciones son anuladas: +- Los bloqueos en las entidades son eliminados y las transacciones son anuladas: - cuando el proceso es eliminado. - cuando la sesión se cierra en el servidor - cuando la sesión es terminada desde la ventana de administración del servidor. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md index ad2b739bcee511..410c532096b05f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contiene varias opciones para configurar el funcionamiento general Esta opción permite configurar la visualización por defecto de 4D al inicio, cuando el usuario lanza únicamente la aplicación. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forzar la visualización de la caja de diálogo de apertura cuando se selecciona esta opción, mantenga presionada la tecla **Alt** (Windows) u **Option** (macOS) mientras lanza el proyecto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir de macOS Sierra, las aplicaciones Mac pueden beneficiarse de la funció Puede beneficiarse de esta funcionalidad en los siguientes entornos (sólo con las versiones 4D de 64 bits): - - Ventanas del editor de código - - Ventanas del editor de formularios +- Ventanas del editor de código +- Ventanas del editor de formularios Todas las ventanas de estos editores se pueden poner en forma de pestaña: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Hay tres opciones disponibles: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Apariencia (sólo para macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Hay tres opciones disponibles: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferencia sólo es compatible en macOS. En Windows, se utiliza siempre el esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de datos...** - - **Base de datos a partir de una definición de estructura...** +- **Base de datos...** +- **Base de datos a partir de una definición de estructura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Al crear un nuevo archivo de datos, 4D utiliza el idioma previamente configurado Esta área configura el acceso a la documentación HTML de 4D mostrada en su navegador actual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Lenguaje de la documentación @@ -151,8 +151,8 @@ Lenguaje de la documentación HTML a mostrar. Puede seleccionar una documentaci Define dónde buscará 4D las páginas de documentación. - - Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. - - Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. +- Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. +- Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. ### Carpeta local diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md index 5bc50cf2441b91..e5fa1d11caeeef 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite seleccionar, crear o configurar los temas del Editor de Có En esta lista, se selecciona el tema que se aplicará al editor de código. Se muestran todos los temas disponibles, incluidos los temas personalizados (si los hay). 4D ofrece dos temas por defecto: - - **Tema Light por defecto** - - **Tema oscuro por defecto** +- **Tema Light por defecto** +- **Tema oscuro por defecto** > Los temas por defecto no pueden ser modificados ni eliminados. @@ -38,8 +38,8 @@ Si los valores de las teclas no se definen en un tema personalizado, se ajustan Definir un tema significa: - - definir una fuente y un tamaño de fuente para todo el editor de código, - - asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. +- definir una fuente y un tamaño de fuente para todo el editor de código, +- asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. La combinación de colores y de estilos diferentes es especialmente útil para el mantenimiento del código. @@ -83,8 +83,8 @@ Esta página configura las opciones de visualización del Editor de Código. Permite desactivar/activar los parámetros del código "internacional" para la aplicación 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Si modifica esta opción, deberá reiniciar la aplicación 4D para que se tenga en cuenta el cambio. @@ -138,9 +138,9 @@ Permite ocultar todos los iconos expandir/desplegar por defecto al mostrar el c Activa la inserción automática de () y de llaves de cierre mientras se escribe el código. Esta opción controla dos funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Activa la inserción automática de () y de llaves de cierre mientras se escribe Define la señalización gráfica de las llaves correspondientes en el código. Esta señalización aparece siempre que se selecciona un corchete, un paréntesis o una llave. Las siguientes opciones están disponibles: - - **Ninguno**: sin señales - - **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ +- **Ninguno**: sin señales +- **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Resaltado de las variables y campos @@ -162,9 +162,9 @@ Permite resaltar todas las ocurrencias de la misma variable o campo en una venta ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md index 188712c0ba8aab..0f0bc09902602d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitectura de un proyecto Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de una carpeta raíz del proyecto (carpeta paquete). Por ejemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de u La carpeta Project suele contener la siguiente jerarquía: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Clases` - `DatabaseMethods` - `Métodos` - `Formularios` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` El archivo de desarrollo de proyecto, utilizado para designar y lanzar el proyecto. Este archivo puede ser abierto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > En los proyectos 4D, el desarrollo se realiza con 4D y el desarrollo multiusuarios se gestiona a través de las herramientas de control de versión. 4D Server puede abrir archivos .4DProject para realizar pruebas. @@ -120,9 +120,9 @@ Este archivo de texto también puede contener llaves de configuración, en parti La carpeta Trash contiene los métodos y formularios que se han eliminado del proyecto (si los hay). Puede contener las siguientes carpetas: - - `Métodos` - - `Formularios` - - `TableForms` +- `Métodos` +- `Formularios` +- `TableForms` Dentro de estas carpetas, los nombres de los elementos eliminados van entre paréntesis, por ejemplo "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Esta carpeta contiene [**parámetros usuario para datos**](../Desktop/user-setti La carpeta Logs contiene todos los archivos de registro utilizados por el proyecto. Los archivos de registro incluyen, en particular: - - conversión de base de datos, - - peticiones del servidor web, - - registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) - - depuración de comandos, - - Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). +- conversión de base de datos, +- peticiones del servidor web, +- registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) +- depuración de comandos, +- Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). > Una carpeta Logs adicional está disponible en la carpeta de preferencias del usuario del sistema (carpeta 4D activa, ver el comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para los archivos de registro de mantenimiento y e diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/components.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/components.md index 44f1264b41da68..6932f13399f658 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/components.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/components.md @@ -13,15 +13,15 @@ Al desarrollar en 4D, los archivos de los componentes pueden almacenarse de form Los componentes pueden ser interpretados o [compilados](../Desktop/building.md). - - Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. - - Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. +- Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. +- Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. ### Carpeta Package La carpeta del paquete de un componente puede contener: - - para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). +- para **componentes compilados**: - una carpeta "Contents" que contenga un archivo .4DZ, una carpeta *Resources*, un archivo *Info.plist* (arquitectura recomendada) - o directamente un archivo .4DZ con otras carpetas como *Resources*. @@ -37,8 +37,8 @@ La arquitectura de carpetas "Contents" se recomienda para los componentes si des Esta página describe cómo trabajar con componentes en los entornos **4D** y **4D Server**. En otros entornos, los componentes se gestionan de manera diferente: - - en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. - - en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). +- en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. +- en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página describe cómo trabajar con componentes en los entornos **4D** y ** Para cargar un componente en su proyecto 4D, usted puede: - - copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), - - o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). +- copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), +- o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). Los componentes declarados en el archivo **dependencies.json** pueden almacenarse en diferentes ubicaciones: - - al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, - - en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** - - en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. +- al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, +- en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** +- en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. Si se instala el mismo componente en distintos lugares, se aplica un [orden de prioridad](#priority). @@ -69,8 +69,8 @@ El archivo **dependencies.json** hace referencia a todos los componentes requeri Puede contener: - - nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), - - nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). +- nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), +- nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ El archivo **environment4d.json** es opcional. Permite definir **rutas personali Los principales beneficios de esta arquitectura son los siguientes: - - puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. - - si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. +- puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. +- si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. ### Prioridad @@ -187,9 +187,9 @@ En cuanto a los componentes almacenados en GitHub, tanto los archivos [**depende Los componentes 4D disponibles en GitHub pueden ser referenciados y cargados automáticamente en sus proyectos 4D. - - Comprima los archivos componentes en formato ZIP. - - Nombre este archivo con el mismo nombre que el repositorio GitHub. - - Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. +- Comprima los archivos componentes en formato ZIP. +- Nombre este archivo con el mismo nombre que el repositorio GitHub. +- Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. Estos pasos pueden automatizarse fácilmente, con código 4D o utilizando GitHub Actions, por ejemplo. @@ -232,7 +232,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g ::: - - **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: +- **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: ```json { @@ -245,7 +245,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g } ``` - - Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: +- Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: ```json { @@ -262,17 +262,17 @@ Un rango se define mediante dos versiones semánticas, un mínimo y un máximo, Estos son algunos ejemplos: - - "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. - - "\*": la última versión lanzada. - - "1.\*": todas las versiones de la versión principal 1. - - "1.2.\*": todos los parches de la versión menor 1.2. - - ">=1.2.3": la última versión, a partir de la versión 1.2.3. - - ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. - - "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. - - "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. - - "<=1.2.3": la última versión hasta la 1.2.3. - - "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. - - "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. +- "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. +- "\*": la última versión lanzada. +- "1.\*": todas las versiones de la versión principal 1. +- "1.2.\*": todos los parches de la versión menor 1.2. +- ">=1.2.3": la última versión, a partir de la versión 1.2.3. +- ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. +- "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. +- "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. +- "<=1.2.3": la última versión hasta la 1.2.3. +- "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. +- "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. Si no especifica una etiqueta o una versión, 4D recupera automáticamente la "última" versión. @@ -282,9 +282,9 @@ El gestor de dependencias comprueba periódicamente si hay actualizaciones de co Si quiere usar la regla de dependencia [**Seguir la versión 4D**](#defining-a-github-dependency-version-range), las etiquetas para las versiones de componentes en el repositorio de Github deben cumplir con convenciones específicas. - - **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". +- **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". - - **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". +- **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". :::note @@ -310,8 +310,8 @@ A continuación, deberá [suministrar su token de conexión](#providing-your-git Los componentes GitHub a los que se hace referencia se descargan en una carpeta de caché local y, a continuación, se cargan en su entorno. La carpeta de caché local se guarda en la siguiente ubicación: - - en macOs: `$HOME/Library/Caches//Dependencies` - - en Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- en Windows: `C:\Users\\AppData\Local\\Dependencies` ...donde `` puede ser "4D", "4D Server" o "tool4D". @@ -319,12 +319,12 @@ Los componentes GitHub a los que se hace referencia se descargan en una carpeta When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Esto incluye: - - **Dependencias primarias**: componentes que declara explícitamente en su archivo `dependencies.json` - - **Dependencias secundarias**: componentes requeridos por dependencias primarias u otras dependencias secundarias, que se resuelven e instalan automáticamente +- **Dependencias primarias**: componentes que declara explícitamente en su archivo `dependencies.json` +- **Dependencias secundarias**: componentes requeridos por dependencias primarias u otras dependencias secundarias, que se resuelven e instalan automáticamente The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ En un proyecto abierto, puede añadir, eliminar, actualizar y obtener informaci Para mostrar el panel Dependencias: - - con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
+- con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - con el servidor 4D, seleccione el elemento de menú **Ventana/Dependencias del proyecto**.
+- con el servidor 4D, seleccione el elemento de menú **Ventana/Dependencias del proyecto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) A continuación, se muestra el panel Dependencias. Las dependencias se ordenan por nombre en orden alfabético: @@ -362,11 +362,11 @@ Por defecto, se listan todas las dependencias identificadas por el gestor de dep ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. - - **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. +- **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. ### Dependencias secundarias @@ -384,16 +384,16 @@ Las dependencias que requieren la atención del desarrollador se indican mediant Las siguientes etiquetas de estado están disponibles: - - **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). - - **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). - - **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. - - **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). - - **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). - - **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. - - **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. - - **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). - - **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. - - **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. +- **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). +- **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). +- **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. +- **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). +- **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). +- **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. +- **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. +- **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). +- **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. +- **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. Al pasar el ratón por encima de la línea de dependencia, se muestra un mensaje que ofrece información adicional sobre el estado: @@ -427,8 +427,8 @@ Este elemento no se muestra si la relación está inactiva porque no se encuentr El icono del componente y el logotipo de ubicación ofrecen información adicional: - - El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. - - Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. +- El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. +- Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Si el elemento seleccionado no es válido, se mostrará un mensaje de error. Haga clic en **Añadir** para añadir la dependencia al proyecto. - - Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). - - Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). +- Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). +- Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Puede definir la opción [etiqueta o versión](#tags-and-versions) para una depe ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). - - **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. - - **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. - - **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. - - **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. +- **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). +- **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. +- **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. +- **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. +- **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. La versión actual de la dependencia de GitHub se muestra a la derecha del elemento de la dependencia: @@ -509,8 +509,8 @@ Modificar el rango de versiones es útil, por ejemplo, si utiliza la función de El gestor de dependencias ofrece una gestión integrada de las actualizaciones en GitHub. Se soportan las siguientes funcionalidades: - - Verificación automática y manual de las versiones disponibles - - Actualización automática y manual de los componentes +- Verificación automática y manual de las versiones disponibles +- Actualización automática y manual de los componentes Las operaciones manuales pueden realizarse **por dependencia** o **para todas las dependencias**. @@ -526,11 +526,11 @@ Si suministra un [token de acceso](#providing-your-github-access-token), las ver Además, puede buscar actualizaciones en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. +- Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. ![componente de verificación](../assets/en/Project/check-component-one.png) - - Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. +- Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. ![componentes de verificación](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Si no desea utilizar una actualización de componentes (por ejemplo, desea perma Puede actualizar las dependencias en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: +- Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: ![componente de verificación](../assets/en/Project/update-component-one.png) - - Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: +- Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: ![componentes de verificación](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ En cualquier caso, sea cual sea el estado actual de la dependencia, se realiza u Al seleccionar un comando de actualización: - - se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. - - si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. +- se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. +- si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. #### Actualización automática @@ -575,13 +575,13 @@ Cuando esta opción no está marcada, una nueva versión del componente que coin Registrar su token de acceso personal en el gestor de dependencias es: - - obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), - - recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. +- obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), +- recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. Para proporcionar su token de acceso a GitHub, también puede: - - haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. - - o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. +- haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. +- o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md index dd5d2bb8fab21b..56d2bc618d04fd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md @@ -7,10 +7,10 @@ En los proyectos aplicación, puede documentar sus métodos así como sus clases Los siguientes elementos del proyecto aceptan la documentación: - - Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) - - Clases - - Formularios - - Tablas y campos +- Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) +- Clases +- Formularios +- Tablas y campos Sus archivos de documentación se escriben en la sintaxis Markdown (archivos .md) utilizando cualquier editor que soporte el Markdown. Se almacenan como archivos independientes dentro de la carpeta Proyecto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Clases` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. - - Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. > Renombrar o eliminar un elemento documentado en su proyecto también renombrará o eliminará el archivo Markdown asociado al elemento. @@ -73,9 +73,9 @@ Para ver la documentación en la ventana del Explorador: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. +- De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. ### Modificar el archivo de documentación @@ -83,8 +83,8 @@ Puede crear y/o editar un archivo de documentación Markdown desde la ventana de Si no existe un archivo de documentación para el elemento seleccionado, puede: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ El editor de código 4D muestra una parte de la documentación de un método en Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ +- O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ En este caso, la primera línea contiene el **prototipo** del método, generado automáticamente por el analizador de código de 4D. :::note @@ -130,7 +130,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Markdown soportado - - La etiqueta del título es soportada: +- La etiqueta del título es soportada: ```md # Title 1 @@ -138,7 +138,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Title 3 ``` - - Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: +- Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: ```md _italic_ @@ -147,7 +147,7 @@ _italic_ ~~strikethrough~~ ``` - - La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: +- La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: ````md ```4d @@ -156,7 +156,7 @@ _italic_ ``` ```` - - La etiqueta de la tabla es soportada: +- La etiqueta de la tabla es soportada: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La etiqueta del enlace es soportada: +- La etiqueta del enlace es soportada: ```md // Caso 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Las etiquetas de imagen son soportadas: +- Las etiquetas de imagen son soportadas: ```md ![image info](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - Vista del explorador: +- Vista del explorador: ![](../assets/en/Project/explorer_Doc.png) - - Vista del editor de código: +- Vista del editor de código: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md index 275ccf33d10908..2e1fa51b509978 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md @@ -11,18 +11,18 @@ Si tiene atributos relacionales en una dataclass, utilice `$attributes` para def Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Si se especifica `$attributes` para los atributos **storage**: +- Si se especifica `$attributes` para los atributos **storage**: - `$attributes=attribute1, attribute2, ...`: solo son devueltos aquellos atributos de las entidades. ## Ejemplo con varias entidades relacionadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md index 7d332d71a27938..55410971e14d95 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - otras sesiones REST - - los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. +- otras sesiones REST +- los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. Una entidad bloqueada por la API REST sólo puede ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Respuesta diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md index 7df9e0a557f078..f5dc55074e13ee 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md @@ -194,9 +194,9 @@ Si surge un problema al añadir o modificar una entidad, se le devolverá un err :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). - - **Booleanos** son true o false. - - Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). +- **Booleanos** son true o false. +- Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md index 50dca9d1af3f1b..8fae210e340e57 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Puede llamar a [funciones clase modelo de datos](ORDA/ordaClasses.md) definidas Las funciones pueden llamarse de dos maneras: - - utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. - - usando **GET requests**, con parámetros directamente pasados en la URL. +- utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. +- usando **GET requests**, con parámetros directamente pasados en la URL. Las peticiones POST ofrecen un mejor nivel de seguridad porque evitan la ejecución de código sensible a través de una acción tan simple como hacer clic en un enlace. Sin embargo, las peticiones GET pueden ser más compatibles con la experiencia del usuario, permitiendo llamar a las funciones introduciendo una URL en un navegador (nota: el desarrollador debe asegurarse de que no se hace ninguna acción sensible en dichas funciones). @@ -96,11 +96,11 @@ Puede enviar parámetros a funciones definidas en clases de usuario ORDA o singl Se aplican las siguientes reglas: - - En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. - - En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. - - Los parámetros deben estar incluidos en una colección (formato JSON). - - Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. - - La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. +- En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. +- Los parámetros deben estar incluidos en una colección (formato JSON). +- Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. +- La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Ver [este ejemplo](#usando-una-entidad-que-se-creará-en-el-servidor) y [este ejemplo](#recibiendo-una-selección-de-entidades-como-parámetro). @@ -134,8 +134,8 @@ También puede pasar valores para todos los atributos de la entidad. Estos valor | __ENTITY | Boolean | Obligatorio - True para indicar al servidor que el parámetro es una entidad | | __KEY | mixto (mismo tipo que la llave primaria) | Opcional - llave primaria de la entidad | - - Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. - - Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados +- Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. +- Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados Vea ejemplos a continuación para crear o actualizar entidades con peticiones POST. Vea un ejemplo de descarga de contenidos utilizando una entidad con una petición GET. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md index c3c4ed71c409a9..d0e2bbfcbd0b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md @@ -45,9 +45,9 @@ Todas las demás peticiones REST (manejando datos o ejecutando una función) só Las peticiones REST descriptivas pueden procesarse en sesiones de usuario web que no requieren licencias (sesiones "invitado"). Estas peticiones son: - - peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - la renderización de una página Qodly +- peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - la renderización de una página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -74,8 +74,8 @@ La función puede recibir cualquier información de autenticación o contextual Esta función debe contener dos partes: - - algún código para identificar y autenticar al remitente de la petición REST, - - si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. +- algún código para identificar y autenticar al remitente de la petición REST, +- si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. Si la función no llama a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), no se asignan privilegios, no se consume ninguna licencia y las solicitudes REST no descriptivas posteriores son rechazadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md index 46b9ed831ac9e9..12f01887dc5591 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta sección pretende ayudar a familiarizarse con la funcionalidad de REST mediante un ejemplo sencillo. Vamos a: - - crear y configurar un proyecto de aplicación 4D básico - - acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. +- crear y configurar un proyecto de aplicación 4D básico +- acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. Para simplificar el ejemplo, vamos a utilizar 4D y un navegador que se ejecutan en la misma máquina. Por supuesto, también puede utilizar una arquitectura remota. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md index 8a4e226d14542e..a74d6094bb15d1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md @@ -17,15 +17,15 @@ También hay tres botones de acceso directo que se pueden utilizar para filtrar ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Cuando seleccione esta opción: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), - - se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), +- se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. La área inferior de la ventana se utiliza para mostrar la representación gráfica de la actividad del proceso(s) seleccionados. @@ -33,16 +33,16 @@ La área inferior de la ventana se utiliza para mostrar la representación gráf La actividad del proceso es el porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). La ventana ofrece la siguiente información para cada proceso: - - Tipo de proceso (ver abajo), - - Sesión/Información: +- Tipo de proceso (ver abajo), +- Sesión/Información: - Proceso 4D - en blanco, - Proceso usuario - Nombre del usuario 4D, - Proceso web - ruta URL, - - Nombre del proceso, - - Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. - - Estado actual del proceso, - - Tiempo de ejecución (en segundos) del proceso desde su creación, - - Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). +- Nombre del proceso, +- Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. +- Estado actual del proceso, +- Tiempo de ejecución (en segundos) del proceso desde su creación, +- Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). ## Tipo del proceso @@ -83,15 +83,15 @@ La página también tiene cinco botones de control que actúan sobre el proceso ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. > También puede abortar directamente el proceso o procesos seleccionados sin que aparezca la caja de diálogo de confirmación, manteniendo pulsada la tecla **Alt** mientras hace clic en este botón, o utilizando el comando [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md). - - **Pausar proceso**: permite pausar los procesos seleccionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). +- **Pausar proceso**: permite pausar los procesos seleccionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md index b5f68a49fd85a1..b8e58da5e0ebd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Se añade una línea para cada operación larga realizada en los datos. Esta lí La siguiente información se ofrece para cada línea: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ La siguiente información se ofrece para cada línea: La página está activa y se actualiza permanentemente en cuanto se muestra. Cabe señalar que su funcionamiento puede ralentizar considerablemente la ejecución de la aplicación. Es posible suspender la actualización de esta página de una de las siguientes maneras: - - haciendo clic en el botón **Pausa**, - - haciendo clic en la lista, - - presionando la barra espaciadora. +- haciendo clic en el botón **Pausa**, +- haciendo clic en la lista, +- presionando la barra espaciadora. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Puede reanudar el seguimiento de las operaciones realizando la misma acción que para la pausa. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md index 1a6a770fa85ec1..e4be7309079c9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md @@ -7,8 +7,8 @@ Si diferentes personas utilizan una aplicación, lo que suele ocurrir en la arqu La estrategia de control de acceso 4D depende de la configuración de su despliegue: - - en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, - - en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). +- en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, +- en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md index df220ec536d74a..af0dc26c7caf25 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ En *filePath*, pase la ruta de destino y el nombre del documento a exportar. Si Puede especificar el formato del archivo exportado incluyendo una extensión después del nombre del documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", o ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", o ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si no se incluye la extensión, pero se especifica el formato en *paramObj*, el archivo exportado tendrá la extensión que corresponda al formato, excepto para el formato CSV (en este caso no se añade ninguna extensión). @@ -88,25 +88,25 @@ El parámetro opcional *paramObj* le permite definir múltiples propiedades para **Notas sobre el formato Excel**: - - Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. - - Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. +- Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. **Notas sobre el formato PDF**: - - Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato CSV**: - - Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. - - Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. +- Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato de archivo SpreadJS**: - - Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. Una vez finalizada la operación de exportación, `VP EXPORT DOCUMENT` activa automáticamente la ejecución del método definido en la propiedad *formula* del *paramObj*, si se usa. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md index 4e1ca7ad5d3faf..3cffc70a02a70e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ En *vpAreaName*, pase el nombre de la propiedad del área 4D View Pro. Si pasa u Puede definir dónde obtener las hojas de estilo en el parámetro opcional *sheet* utilizando el índice de la hoja (la numeración comienza en 0) o con las siguientes constantes: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md index a132f4e4e78712..ddf88d1521f080 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ El objeto devuelto contendrá la propiedad `value` y, en caso de un valor fecha Si el objeto devuelto incluye una fecha u hora, se trata como una fecha-hora y se completa de la siguiente manera: - - valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) - - valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) +- valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) +- valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) Si *rangeObj* contiene varias celdas o varios rangos, se devuelve el valor de la primera celda. El comando devuelve un objeto null si la celda está vacía. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md index 2fdb903a5556a8..38627598820d41 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ En *vpAreaName*, pase el nombre del área 4D View Pro. Si pasa un nombre que no En *filePath*, pase la ruta y el nombre del documento a importar. Se soportan los siguientes formatos: - - Los documentos 4D View Pro (extensión ".4vp") - - Microsoft Excel (extensión ".xlsx") - - documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) - - [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Los documentos 4D View Pro (extensión ".4vp") +- Microsoft Excel (extensión ".xlsx") +- documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) +- [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si la extensión del documento no es una extensión reconocida, como `.4vp` o `.xlsx`, el documento se considera un documento texto. Debe pasar una ruta completa, a menos que el documento se encuentre en el mismo nivel que la carpeta Project, en cuyo caso puede pasar sólo su nombre. @@ -73,11 +73,11 @@ El parámetro opcional *paramObj* permite definir las propiedades del documento :::note Notas - - La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. - - Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. +- Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md index 4746c96876092d..9d54bc19ff1a48 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ El comando `VP RESIZE TABLE` cambi Se aplican las siguientes reglas: - - Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. - - Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. - - Si la tabla se expande en las celdas que contienen datos: +- Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. +- Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. +- Si la tabla se expande en las celdas que contienen datos: - si se añaden líneas, se eliminan datos, - si se añaden columnas, los datos se mantienen y se muestran en nuevas columnas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md index c5583c5ef7e576..bf7a7c5e68dbd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Las hojas de cálculo se componen de líneas y columnas. A cada línea se le aso ### Selección de celdas, columnas y líneas - - Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. +- Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. - - Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. +- Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. - - Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: +- Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. +- Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. - - Para seleccionar una línea, haga clic en el número correspondiente. +- Para seleccionar una línea, haga clic en el número correspondiente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. +- Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. ### Entrada de datos @@ -76,8 +76,8 @@ Las áreas 4D View Pro se benefician de un menú contextual automático que ofre Dependiendo del área seleccionada, también están disponibles las siguientes opciones: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - haga clic en una celda o en un rango de celdas: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- haga clic en una celda o en un rango de celdas: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. Cuando se ha introducido un comentario para un área, la celda superior izquierda del área muestra un pequeño triángulo rojo:\ @@ -128,8 +128,8 @@ Luego, puede pasar `$myRange` a otro método 4D View Pro para modificar estas ce Los objetos rango 4D View Pro se componen de varias propiedades: - - area - El nombre del área 4D View Pro - - rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- area - El nombre del área 4D View Pro +- rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propiedad | | Tipo | Descripción | Disponible para | | --------- | ------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Los objetos rango 4D View Pro se componen de varias propiedades: 4D View Pro soporta la importación y exportación de varios formatos de documentos: - - .4vp - - .xlsx - - .txt y .csv - - .sjs - - .pdf (sólo para exportación) +- .4vp +- .xlsx +- .txt y .csv +- .sjs +- .pdf (sólo para exportación) Para más detalles, consulte la descripción de [VP IMPORT DOCUMENT](commands/vp-import-document.md) y [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md index 5872ab721ceeae..e63a91059426ad 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Algunos otros elementos tienen una capitalización diferente (por ejemplo: `this Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y sin espacios. Además, los nombres de las constantes de QodlyScript comienzan con la letra `k`. Puede que necesite adaptar estos elementos de QodlyScript al lenguaje 4D. - - Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. - - Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. +- Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. +- Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. ### Ejemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y end ``` - - Código 4D equivalente: +- Código 4D equivalente: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md index 7f1958b3caa0e6..666a14a5e8f1fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ En las secciones anteriores, obtenemos acceso libre a la aplicación desde las p La forma más sencilla y segura de registrar un usuario en el servidor web de 4D se basa en el siguiente escenario: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Cree una tabla con algunos campos, por ejemplo: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md index c7c8d1f1f9b64c..c9312623050565 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ Cuando un manejador de peticiones HTTP personalizado intercepta una solicitud, s Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - gestionar una autenticación a través de oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- gestionar una autenticación a través de oAuth 2.0. ## Requisitos Se soportan gestores de solicitudes HTTP personalizados: - - cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,20 +72,20 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ Ej: `"pattern": "docs"` o `"pattern": "docs/invoices"` - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. Ej: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). #### Concordancia de modelos -URL patterns are triggered in the given order: +Los modelos de URL se activan en el orden indicado: - - se ejecuta el primer modelo coincidente - - the following patterns are not executed even if they match the URL +- se ejecuta el primer modelo coincidente +- los siguientes patrones no se ejecutan aunque coincidan con la URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Clase y método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Ver abajo](#request-handler-code) para obtener información sobre el código del gestor de peticiones. @@ -208,11 +208,11 @@ He aquí un ejemplo detallado de un archivo HTTPHandlers.json: En este ejemplo, debe implementar las siguientes funciones: - - *funciónhandle* en la clase \*GeneralHandling - - *manageAccount* en la clase *UsersHandling* - - *handleInvoices* en la clase *FinancialHandling* - - *handleDocs* en la clase *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* +- *funciónhandle* en la clase \*GeneralHandling +- *manageAccount* en la clase *UsersHandling* +- *handleInvoices* en la clase *FinancialHandling* +- *handleDocs* en la clase *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* Examples of URLs triggering the handlers: @@ -278,7 +278,7 @@ El archivo **HTTPHandlers.json**: ] ``` -The called URL is: http://127.0.0.1:8044/putFile?fileName=testFile +La URL llamada es: http://127.0.0.1:8044/putFile?fileName=testFile The binary content of the file is put in the body of the request and a POST verb is used. El nombre del archivo se da como parámetro (*fileName*) en la URL. Se recibe en el objeto [`urlQuery`](../API/IncomingMessageClass.md#urlquery) en la petición. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md index e550be9f53ecce..f5e2388c072a60 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, | Servidor Web | cooperativo | *configuración web* | | Servidor Web Services | cooperativo | *configuración web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de servicios web: gestiona las peticiones SOAP - - ***web setting*** significa que el modo apropiativo depende de un valor de configuración: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de servicios web: gestiona las peticiones SOAP +- ***web setting*** significa que el modo apropiativo depende de un valor de configuración: - cuando se selecciona la opción de [**sesiones escalables**](sessions.md#enabling-web-sessions), el modo apropiativo se utiliza automáticamente para los procesos web. - en caso contrario, se tendrá en cuenta la opción [**Utilizar procesos apropiativos**](webServerConfig.md#use-preemptive-processes). - en lo que respecta a los procesos de servicios web (servidor o cliente), se soporta el modo apropiativo a nivel del método. Sólo tiene que seleccionar la propiedad "Puede ejecutarse en procesos apropiativos" para los métodos del servidor SOAP publicados (ver [Publicación de un servicio web con 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) o los métodos del cliente proxy (ver [Suscripción a un servicio web en 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) y asegurarse de que el compilador confirme que son hilo seguro. @@ -35,21 +35,21 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, Todo el código 4D ejecutado por el servidor web debe ser hilo seguro si quiere que sus procesos web se ejecuten en modo apropiativo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos los métodos base relacionados con la web: +- Todos los métodos base relacionados con la web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) and [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml +- Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para tablas con el atributo "Exponer como recurso REST" +- Triggers para tablas con el atributo "Exponer como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST Para cada uno de estos métodos y partes de código, el compilador comprobará si se respetan las reglas de seguridad de hilos, y devolverá errores en caso de que haya problemas. Para más información sobre las reglas hilo seguro, consulte el párrafo *Escribir un método hilo seguro* en el capítulo *Procesos* del manual de [Lenguaje 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ La mayoría de los comandos y funciones 4D relacionados con la web, los métodos Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Por supuesto, el código ejecutado por estos métodos también debe ser hilo seg Las siguientes URLs 4D Web Server son hilo seguro y pueden ser utilizadas en modo apropiativo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dcgi/* (los métodos base llamados también deben ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dcgi/* (los métodos base llamados también deben ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Icono de proceso web apropiativo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md index 68ca1d789a33e9..d9109179cd08e4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio también puede utilizarse en la [**plataforma Qodly Cloud**](https: Qodly Studio propone una interfaz web completa, que le permite: - - create Qodly pages by placing components on a canvas - - mapear componentes a Qodly Sources - - activar código 4D configurando eventos - - y mucho más. +- create Qodly pages by placing components on a canvas +- mapear componentes a Qodly Sources +- activar código 4D configurando eventos +- y mucho más. ## Configuración @@ -24,19 +24,19 @@ Qodly Studio propone una interfaz web completa, que le permite: Qodly Studio soporta los siguientes navegadores web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La resolución recomendada es 1920x1080. #### Aplicación 4D - - Desarrollo: 4D v20 R2 o superior - - Despliegue: 4D Server v20 R2 o superior - - Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). - - Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). - - El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). +- Desarrollo: 4D v20 R2 o superior +- Despliegue: 4D Server v20 R2 o superior +- Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). +- Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). +- El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). ### Acceso a Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio es servido por el [servidor web WebAdmin](../Admin/webAdmin.md) y m Para permitir el acceso a Qodly Studio, debe permitirlo explícitamente en dos niveles: - - a nivel de la aplicación 4D - - a nivel del proyecto +- a nivel de la aplicación 4D +- a nivel del proyecto Si uno de los dos niveles (o ambos) no están habilitados, se niega el acceso a Qodly Studio (se devuelve una página 403). @@ -79,8 +79,8 @@ La autenticación en el servidor web WebAdmin se realiza utilizando una llave de De acuerdo con la gestión de proyectos 4D, sólo se admiten los siguientes usos: - - el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La página Qodly Studio está disponible cuando el [servidor web WebAdmin está Hay dos formas de acceder a Qodly Studio: - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si el servidor web WebAdmin ya está en funcionamiento, dependiendo de su configuración, su navegador por defecto se abre en `IPaddress:HTTPPort/studio` o `IPaddress:HTTPSPort/studio`. De lo contrario, se le preguntará si desea iniciar primero el servidor web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` o: @@ -146,24 +146,24 @@ No existe compatibilidad directa entre las aplicaciones implementadas con 4D y l Los siguientes comandos y clases están dedicados a la gestión del lado del servidor de las páginas Qodly: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. - - Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. - - Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. - - clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. +- Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. +- Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. +- clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. ### Uso métodos proyecto Recomendamos utilizar funciones clase en lugar de métodos proyecto. Sólo las funciones de clase pueden ser llamadas desde los componentes. Sin embargo, puede seguir utilizando sus métodos de proyecto en Qodly Studio de dos maneras: - - Puede llamar a sus métodos desde funciones clase. - - Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. +- Puede llamar a sus métodos desde funciones clase. +- Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. ### Uso sin conexión Puede desarrollar con Qodly Studio mientras su ordenador no esté conectado a Internet. En este caso, sin embargo, las siguientes funciones no están disponibles: - - [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía - - Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). +- [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía +- Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). ## Despliegue @@ -179,8 +179,8 @@ Mira [esta página](https://developer.qodly.com/docs/studio/rendering) para obte Para habilitar el renderizado de las páginas Qodly, se deben configurar las siguientes opciones. - - La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. - - El [servidor web 4D](webServer.md) debe estar ejecutándose. +- La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. +- El [servidor web 4D](webServer.md) debe estar ejecutándose. :::note @@ -310,9 +310,9 @@ Para cerrar la sesión del usuario, solo necesita ejecutar la acción estándar Al desencadenar la acción de cierre de sesión de una sesión de usuario web, se producen los siguientes efectos: - - la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), - - se libera la licencia asociada de 4D, - - el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. +- la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), +- se libera la licencia asociada de 4D, +- el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. ## Acerca del uso de licencias para renderización @@ -364,7 +364,7 @@ Para más información sobre el atributo `SameSite`, consulte [esta entrada de b Para evitar utilizar más licencias de las necesarias, recomendamos hacer una de las siguientes cosas: - - Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. - - Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. +- Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. +- Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md index 9f07c189b3543c..fe6a075457925b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Las siguientes etiquetas 4D están disponibles: - - 4DTEXT, para insertar variables y expresiones 4D como texto, - - 4DHTML, para insertar el código HTML, - - 4DEVAL, para evaluar toda expresión 4D, - - 4DSCRIPT, para ejecutar un método 4D, - - 4DINCLUDE, para incluir una página dentro de otra, - - 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, - - 4DCODE, para insertar el código 4D, - - 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, - - 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, - - 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. +- 4DTEXT, para insertar variables y expresiones 4D como texto, +- 4DHTML, para insertar el código HTML, +- 4DEVAL, para evaluar toda expresión 4D, +- 4DSCRIPT, para ejecutar un método 4D, +- 4DINCLUDE, para incluir una página dentro de otra, +- 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, +- 4DCODE, para insertar el código 4D, +- 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, +- 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, +- 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md index 2426aba0213929..3a3ad6511e0fe4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un proyecto 4D puede iniciar y monitorizar un servidor web para la aplicación p El servidor web principal de 4D puede iniciarse de diferentes maneras: - - Utilizando un botón o comando de menú. +- Utilizando un botón o comando de menú. - 4D: **Ejecutar\>Iniciar el servidor Web** menú
![](../assets/en/WebServer/start1.png) - 4D Server: botón **Iniciar servidor HTTP** de la página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) +- Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) - - Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. +- Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. El servidor web de todo componente puede ser lanzado llamando a la función [`webServer.start()`](API/WebServerClass.md#start) en el objeto servidor web del componente. @@ -29,9 +29,9 @@ El servidor web de todo componente puede ser lanzado llamando a la función [`we El servidor web principal de 4D puede detenerse de diferentes maneras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. +- Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ En cualquier momento, puede vacíar la caché de las páginas y de las imágenes Para ello, puede: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. La caché se borra inmediatamente. @@ -64,11 +64,11 @@ La caché se borra inmediatamente. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. ## URL para la administración @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Cuando se llam 4D le permite generar dos historiales de peticiones web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md index 244df1ec2bc429..82af1b6f04e9a6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts y métodos permitidos para el servicio CORS. Nombre de dominio o dirección IP desde donde las páginas externas pueden enviar solicitudes de datos al Servidor a través de CORS. Se pueden añadir múltiples atributos de dominio para crear una lista blanca. Se soportan varias sintaxis: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propiedad methods) Métodos HTTP aceptados para el host CORS correspondiente. Se soportan los siguientes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separe cada método con un ";" (por ejemplo: "post;get"). Si methods está vacío, null o indefinido, todos los métodos están activos. @@ -145,9 +145,9 @@ Por defecto, cuando el servidor web se lanza por primera vez, 4D crea una págin Puede designar otra página de inicio por defecto introduciendo su nombre de ruta. - - La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - La ruta no debe comenzar ni terminar con una barra. +- La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- La ruta no debe comenzar ni terminar con una barra. Por ejemplo, si quiere que la página de inicio por defecto sea "MyHome.htm", y se encuentra en la carpeta "Web" (situada a su vez en la carpeta raíz HTML por defecto), utilice "Web/MyHome.htm". @@ -318,13 +318,13 @@ Valores posibles: cadena de direcciones IP. Los formatos IPv6 (por ejemplo "2001 #### Acerca de la compatibilidad con IPv6 - - **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. +- **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. Si su servidor 4D no parece responder en el puerto definido, puede probar la dirección [::1] en la máquina del servidor (equivalente a 127.0.0.1 para IPv6, añada [:portNum] para probar otro número de puerto). Si 4D responde, es probable que otra aplicación esté utilizando el puerto en IPv4. - - **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. +- **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. - - **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: +- **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: ```code4d 2001:0DB8::85a3:0:ac1f:8001 // Dirección IPv6 @@ -417,10 +417,10 @@ Versión mínima de TLS aceptada para las conexiones. Se rechazarán los intento Valores posibles: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (por defecto) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (por defecto) +- 4 = TLSv1_3 Valores posibles: @@ -486,10 +486,10 @@ Por ejemplo: Disallow: /GIFS/ ``` - - “User-Agent: \*” - todos los robots son afectados. - - “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. - - “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. - - “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. +- “User-Agent: \*” - todos los robots son afectados. +- “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. +- “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. +- “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. Otro ejemplo: @@ -514,15 +514,15 @@ Además, la carpeta raíz HTML define, en el disco duro del servidor web, el niv Por defecto, 4D define una carpeta raíz HTML llamada **WebFolder**. Si no existe, la carpeta raíz HTML se crea físicamente en el disco en el momento en que se lanza el servidor web por primera vez. Se crea la carpeta raíz: - - con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). - - con 4D en modo remoto, en la carpeta de recursos locales. +- con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). +- con 4D en modo remoto, en la carpeta de recursos locales. Puede designar otra página carpeta HTML raíz por defecto introduciendo su ruta de acceso. - - La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta - - La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). +- La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta +- La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). Por ejemplo, si quiere que la carpeta raíz HTML sea la subcarpeta "Web" de la carpeta "MyWebApp", introduzca "MyWebApp/Web". @@ -577,9 +577,9 @@ Valor del atributo `SameSite` de la cookie de sesión. Este atributo le permite Hay tres valores disponibles: - - "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. - - "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). - - "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. +- "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). +- "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). El valor del atributo `Secure` de la cookie de sesión se define automáticamente en "True" si la conexión es HTTPS (sea cual sea el valor del atributo `SameSite`). @@ -623,9 +623,9 @@ En algunos casos, se pueden invocar otras funciones internas optimizadas. Las co Dos opciones le permiten definir cómo funcionan las conexiones persistentes: - - **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

+- **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Once this period is over, the server closes the connection.

+- **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Once this period is over, the server closes the connection.

Si el navegador web envía una solicitud después de cerrar la conexión, se crea automáticamente una nueva conexión TCP. Esta operación no es visible para el usuario.

diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md index 4eee0fff8607b1..2215d57311fd1f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un proyecto 4D puede iniciar y monitorear un servidor web para la aplicación pr Por ejemplo, si ha instalado dos componentes en su aplicación principal, puede iniciar y supervisar hasta tres servidores web independientes desde su aplicación: - - un servidor web para la aplicación local, - - un servidor web para el componente #1, - - un servidor web para el componente #2. +- un servidor web para la aplicación local, +- un servidor web para el componente #1, +- un servidor web para el componente #2. Aparte de la memoria, no hay límite en el número de componentes y por lo tanto, de servidores web, que se pueden adjuntar a un solo proyecto de aplicación 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicación local o componente) puede ser utilizado en su propio contexto independiente, incluyendo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - el procesamiento de las etiquetas 4D y las llamadas de métodos, - - sesiones web y gestión del protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- el procesamiento de las etiquetas 4D y las llamadas de métodos, +- sesiones web y gestión del protocolo TLS. Esto le permite desarrollar componentes independientes y funcionalidades que vienen con sus propias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si la aplicación utiliza componentes y quiere llamar a: - - el servidor web de la aplicación local a partir de un componente o - - el servidor que ha recibido la solicitud (sin importar el servidor), +- el servidor web de la aplicación local a partir de un componente o +- el servidor que ha recibido la solicitud (sin importar el servidor), también se puede utilizar: @@ -94,8 +94,8 @@ Estas propiedades son definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. si no se utiliza, en los parámetros de la aplicación local o del componente. - - Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. - - Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). +- Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. +- Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion*, y *perfectForwardSecrecy* son propiedades de sólo lectura que no pueden predefinirse en el parámetro del objeto `settings` para la función [`start()`](API/WebServerClass.md#start). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md index 775755c86b19a5..aaf5a0ae4cbc51 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ El comando **WP Insert break** inse En *targetObj*, pase: - - un rango, o - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - un documento 4D Write Pro +- un rango, o +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- un documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insertar el contenido al principio del objetivo | | wk replace | Integer | 0 | Sustituir contenido de destino | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Constante | Tipo | Valor | Comentario | | --------------------- | ------- | ----- | ------------------------------------------------------------------------------------- | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Si *targetObj* no es un rango, *rangeUpdate* se ignora. +- Si *targetObj* no es un rango, *rangeUpdate* se ignora. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md index 90b584c29f6f92..9b4b9d5dd56d7d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ El comando **WP Insert document body**El comando **Create deployment license** crea un archivo de licencia integrado en la carpeta Licenses de la aplicación generada *mergedApp*. If the Licenses folder does not exist in the *mergedApp* folder, it is created by the command. +El comando **Create deployment license** crea un archivo de licencia integrado en la carpeta Licenses de la aplicación generada *mergedApp*. Si la carpeta Licenses no existe en la carpeta *mergedApp*, será creada por el comando. -In *mergedApp*, pass a [4D.Folder](../API/FolderClass.md) object containing a reference to the folder containing the built application in which you want to embed a license. +En *mergedApp*, pase un objeto [4D.Folder](../API/FolderClass.md) que contenga una referencia a la carpeta que contiene la aplicación generada en la que desea integrar una licencia. -Depending on the second parameter, you [let 4D select automatically the license to use](#automatic-license-selection) for the target or [designate the license(s) to use](#designating-the-licenses-to-use). +En función del segundo parámetro, usted [deja que 4D seleccione automáticamente la licencia a utilizar](#automatic-license-selection) para el objetivo o [designa la(s) licencia(s) a utilizar](#designating-the-licenses-to-use). ### Selección automática de licencia -If you pass the *autoLicenseTarget* parameter, you let 4D find and use the most appropriate license for the specified target. For more information on the automatic license selection, please refer to the [Build application](../Desktop/building.md#application-automatically-embedding-available-licenses) section. +Si pasa el parámetro *autoLicenseTarget*, deja que 4D encuentre y utilice la licencia más apropiada para el objetivo especificado. Para más información sobre la selección automática de licencias, consulte la sección [Crear aplicación](../Desktop/building.md#application-automatically-embedding-available-licenses). -The following constants are supported in the *autoLicenseTarget* parameter: +Se soportan las siguientes constantes en el parámetro *autoLicenseTarget*: -| Constante | Valor | Descripción | -| ----------------- | ----- | --------------------------------------------------------------- | -| 4D Volume Desktop | 1 | Create automatically a license for a 4D single-user application | -| 4D Server | 5 | Create automatically a license for a 4D Server application | +| Constante | Valor | Descripción | +| ----------------- | ----- | ---------------------------------------------------------------------- | +| 4D Volume Desktop | 1 | Crear automáticamente una licencia para una aplicación 4D mono usuario | +| 4D Server | 5 | Crear automáticamente una licencia para una aplicación 4D Server | Si no se encuentra una licencia válida, se genera un error. ### Designación de la(s) licencia(s) a utilizar -In *license*, pass a [4D.File](../API/FileClass.md) object containing a reference to the license file used to generate the embedded license. +En *license*, pase un objeto [4D.File](../API/FileClass.md) que contenga una referencia al archivo de licencia utilizado para generar la licencia integrada. -In the non-automatic mode, if the build requires a specific OEM license (*4D OEM XML Keys*) and if no such license is already installed in the Licenses folder of the building machine, you need to pass it using the *oemLicense* parameter. This parameter is useful if you dedicate a machine to build your applications. +En el modo no automático, si la compilación requiere una licencia OEM específica (*4D OEM XML Keys*) y si dicha licencia no está ya instalada en la carpeta Licenses de la máquina de compilación, deberá pasarla utilizando el parámetro *oemLicense*. Este parámetro es útil si dedica una máquina a la generación de sus aplicaciones. ### Resultado -The command returns a *status* object containing the following properties: +El comando devuelve un objeto *status* que contiene las siguientes propiedades: -| **Propiedad** | **Tipo** | **Description** | -| ---------------------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| success | Boolean | True si se ha generado el archivo de licencia | -| file | [4D.File](../API/FileClass.md) | El archivo de licencia generado | -| statusText | Text | Descripción del error si lo hay | -| errors | Collection | Colección de objetos de error | -| \[\].message | Text | Mensaje de error | -| \[\].errCode | Number | Número de error | -| standalone | Object | (only in [automatic mode](#automatic-license-selection) Description attributes for `4D Volume Desktop` license | -| oemServer | Object | (only in [automatic mode](#automatic-license-selection) Description attributes for `4D Server` OEM license | -| oemXMLKey | Object | (only in [automatic mode](#automatic-license-selection) Description attributes for `4D Server` XML Key license | +| **Propiedad** | **Tipo** | **Description** | +| ---------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| success | Boolean | True si se ha generado el archivo de licencia | +| file | [4D.File](../API/FileClass.md) | El archivo de licencia generado | +| statusText | Text | Descripción del error si lo hay | +| errors | Collection | Colección de objetos de error | +| \[\].message | Text | Mensaje de error | +| \[\].errCode | Number | Número de error | +| standalone | Object | (solo en [modo automático](#automatic-license-selection) Atributos de descripción para licencia `Volumen 4D Desktop` | +| oemServer | Object | (solo en [modo automático](#automatic-license-selection) Atributos de descripción para licencia OEM `4D Server` | +| oemXMLKey | Object | (solo en [modo automático](#automatic-license-selection) Atributos de descripción para la licencia de la llave XML `4D Server` | *Los atributos Description* son: -| **Propiedad** | **Tipo** | **Description** | -| -------------------- | -------- | ------------------------------------------ | -| absolutePlatformPath | Text | Path to the original license file retained | -| offerName | Text | Nombre comercial de la licencia retenida | -| productNumber | Number | Serial number of the license retained | +| **Propiedad** | **Tipo** | **Description** | +| -------------------- | -------- | -------------------------------------------- | +| absolutePlatformPath | Text | Ruta al archivo de licencia original elegido | +| offerName | Text | Nombre comercial de la licencia retenida | +| productNumber | Number | Número de serie de la licencia elegida | :::note Notas -- The generated license must be used only with the application referenced by *mergedApp*. -- It is necessary to regenerate the license each time the application is rebuilt. +- La licencia generada debe utilizarse únicamente con la aplicación referenciada por *mergedApp*. +- Es necesario regenerar la licencia cada vez que se regenera la aplicación. ::: ## Ejemplo 1 -Use the automatic syntax to create a single-user 4D application: +Usar la sintaxis automática para crear una aplicación 4D mono usuario: ```4d  var $status : Object @@ -112,7 +112,7 @@ Designar una licencia de uso: ## Ver también -[Blog post - Finalize an application with 4D commands](https://blog.4d.com/finalize-an-application-with-4d-commands) +[Post de blog - Finalizar una aplicación con los comandos 4D](https://blog.4d.com/finalize-an-application-with-4d-commands) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event-code.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event-code.md index 81fa2aadfd2d03..093b3cb0c7014d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event-code.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event-code.md @@ -17,28 +17,28 @@ displayed_sidebar: docs ## Descripción -**Form event code** returns a numeric value identifying the type of form event that has just occurred. Usually, you will use **Form event code** from within a form or object method. +**Form event code** devuelve un valor numérico que identifica el tipo de evento formulario que acaba de ocurrir. Por lo general, utilizará **Form event code** en un método formulario u objeto. -4D provides predefined constants (found in the *Form Events* theme) in order to compare the values returned by the **Form event code** command. Certain events are generic (generated for any type of object) and others are specific to a particular type of object. +4D ofrece constantes predefinidas (que se encuentran en el tema *Form Events*) para comparar los valores devueltos por el comando **Form event code**. Algunos eventos son genéricos (se generan para cualquier tipo de objeto) y otros son específicos de un tipo de objeto particular. -For a description of events, please refer to the [**Form Events**](../Events/overview.md) section. +Para una descripción de los eventos, consulte la sección [**Form Events**](../Events/overview.md). ## Ejemplo 1 -This example shows the On Validate event being used to automatically assign (to a field) the date that the record is modified: +Este ejemplo muestra cómo se utiliza el evento On Validate para asignar automáticamente (a un campo) la fecha de modificación del registro: ```4d -  //Method of a form - Case of -  // ... -    :(Form event code=On Validate) -       [aTable]Last Modified On:=Current date - End case + //Método formulario + Case of + // ... + :(Form event code=On Validate) + [aTable]Last Modified On:=Current date + End case ``` ## Ejemplo 2 -In this example, the complete handling of a drop-down list (initialization, user clicks, and object release) is encapsulated in the method of the object: +En este ejemplo, la gestión completa de una lista desplegable (inicialización, clics del usuario y liberación del objeto) se encapsula en el método del objeto: ```4d   //Método Objeto lista desplegable asBurgerSize @@ -100,10 +100,10 @@ Este ejemplo es un método formulario genérico. Muestra cada uno de los posible ## Ejemplo 4 -Este ejemplo muestra la plantilla de un método de formulario que maneja los eventos que pueden ocurrir para un formulario mostrado usando los comandos [DISPLAY SELECTION](../commands-legacy/display-selection.md) o [MODIFY SELECTION](../commands-legacy/modify-selection.md). For didactic purposes, it displays the nature of the event in the title bar of the form window. +Este ejemplo muestra la plantilla de un método de formulario que maneja los eventos que pueden ocurrir para un formulario mostrado usando los comandos [DISPLAY SELECTION](../commands-legacy/display-selection.md) o [MODIFY SELECTION](../commands-legacy/modify-selection.md). Con fines didácticos, muestra la naturaleza del evento en la barra de título de la ventana del formulario. ```4d -  ////Método formulario +//Un método formulario  Case of     :(Form event code=On Load)        $vsTheEvent:="The form is about to be displayed" @@ -139,11 +139,11 @@ Este ejemplo muestra la plantilla de un método de formulario que maneja los eve ## Ejemplo 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. +Para ejemplos sobre cómo manejar los eventos [`On Before Keystroke`](../Events/onBeforeKeystroke.md) y [`On After Keystroke`](../Events/onAfterKeystroke.md), vea los ejemplos de los comandos [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) y [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md). ## Ejemplo 6 -This example shows how to treat clicks and double clicks in the same way in a scrollable area: +Este ejemplo muestra cómo tratar de la misma manera los clics y los dobles clics en un área desplazable: ```4d   //Método objeto para el área de desplazamiento asChoices @@ -163,7 +163,7 @@ This example shows how to treat clicks and double clicks in the same way in a sc ## Ejemplo 7 -This example shows how to treat clicks and double clicks using a different response. Note the use of the element zero for keeping track of the selected element: +Este ejemplo muestra cómo tratar los clics y los dobles clics utilizando una respuesta diferente. Tenga en cuenta el uso del elemento cero para realizar un seguimiento del elemento seleccionado: ```4d //Método objeto área de desplazamiento asChoices @@ -194,7 +194,7 @@ Sif(asChoices#0) ## Ejemplo 8 -This example shows how to maintain a status text information area from within a form method, using the [`On Getting Focus`](../Events/onGettingFocus.md) and [`On Losing Focus`](../Events/onLosingFocus.md) events: +Este ejemplo muestra cómo mantener un área de información de texto de estado desde dentro de un método de formulario, utilizando los eventos [`On Getting Focus`](../Events/onGettingFocus.md) y [`On Losing Focus`](../Events/onLosingFocus.md): ```4d //Método formulario [Contacts];"Data Entry" @@ -225,115 +225,115 @@ This example shows how to maintain a status text information area from within a Este ejemplo muestra cómo responder a un evento de cierre de ventana con un formulario utilizado para la entrada de datos de registro: ```4d -  //Method for an input form - $vpFormTable:=Current form table - Case of -  //... -    :(Form event code=On Close Box) -       If(Modified record($vpFormTable->)) -          CONFIRM("This record has been modified. Save Changes?") -          If(OK=1) -             ACCEPT -          Else -             CANCEL -          End if -       Else -          CANCEL -       End if -  //... - End case +//Método para un formulario de entrada + $vpFormTable:=Current form table + Case of + //... + :(Form event code=On Close Box) + If(Modified record($vpFormTable->)) + CONFIRM("This record has been modified. Save Changes?") + If(OK=1) + ACCEPT + Else + CANCEL + End if + Else + CANCEL + End if + //... + End case ``` ## Ejemplo 10 -This example shows how to capitalize a text or alphanumeric field each time its data source value is modified: +Este ejemplo muestra cómo poner en mayúsculas un campo de texto o alfanumérico cada vez que se modifica su valor: ```4d -  //[Contacts]First Name Object method - Case of -  //... -    :(Form event code=On Data Change) -       [Contacts]First Name:=Uppercase(Substring([Contacts]First Name;1;1))+Lowercase(Substring([Contacts]First Name;2)) -  //... - End case +//Método objeto de [Contacts]First Name + Case of + //... + :(Form event code=On Data Change) + [Contacts]First Name:=Uppercase(Substring([Contacts]First Name;1;1))+Lowercase(Substring([Contacts]First Name;2)) + //... + End case ``` ## Ejemplo 11 -The following example illustrates how to manage a deletion action in a hierarchical list: +El siguiente ejemplo ilustra cómo gestionar una acción de borrado en una lista jerárquica: ```4d - ... //method of hierarchical list +... //método de lista jerárquica :(Form event code=On Delete Action) - ARRAY LONGINT($itemsArray;0) - $Ref:=Selected list items(<>HL;$itemsArray;*) - $n:=Size of array($itemsArray) -  - Case of -    :($n=0) -       ALERT("No item selected") -       OK:=0 -    :($n=1) -       CONFIRM("Do you want to delete this item?") -    :($n>1) -       CONFIRM("Do you want to delete these items?") - End case -  - If(OK=1) -    For($i;1;$n) -       DELETE FROM LIST(<>HL;$itemsArray{$i};*) -    End for - End if + ARRAY LONGINT($itemsArray;0) + $Ref:=Selected list items(<>HL;$itemsArray;*) + $n:=Size of array($itemsArray) + + Case of + :($n=0) + ALERT("No item selected") + OK:=0 + :($n=1) + CONFIRM("Do you want to delete this item?") + :($n>1) + CONFIRM("Do you want to delete these items?") + End case + + If(OK=1) + For($i;1;$n) + DELETE FROM LIST(<>HL;$itemsArray{$i};*) + End for + End if ``` ## Ejemplo 12 -En este ejemplo, el evento formulario [`On Scroll`](../Events/onScroll.md) nos permite sincronizar la visualización de dos imágenes en un formulario. The following code is added in the "satellite" object method (picture field or variable): +En este ejemplo, el evento formulario [`On Scroll`](../Events/onScroll.md) nos permite sincronizar la visualización de dos imágenes en un formulario. El siguiente código se añade en el método del objeto "satellite" (campo o variable imagen): ```4d - Case of -    :(Form event code=On Scroll) -  // we take the position of the left picture -       OBJECT GET SCROLL POSITION(*;"satellite";vPos;hPos) -  // and we apply it to the right picture -       OBJECT SET SCROLL POSITION(*;"plan";vPos;hPos;*) - End case + Case of + :(Form event code=On Scroll) +// tomamos la posición de la imagen izquierda + OBJECT GET SCROLL POSITION(*;"satellite";vPos;hPos) +// y la aplicamos a la imagen derecha +OBJECT SET SCROLL POSITION(*; "plan";vPos;hPos;*) +End case ``` Resultado: https://www.youtube.com/watch?v=YIRfsW1BmHE ## Ejemplo 13 -You want to draw a red rectangle around the selected cell of a list box, and you want the rectangle to move along with the list box if it is scrolled vertically by the user. En el método objeto del list box, puedes escribir: +Desea dibujar un rectángulo rojo alrededor de la celda seleccionada de un list box, y desea que el rectángulo se mueva junto con el list box si el usuario lo desplaza verticalmente. En el método objeto del list box, puedes escribir: ```4d - Case of -  -    :(Form event code=On Clicked) -       LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) -       LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) -       OBJECT SET VISIBLE(*;"RedRect";True) //initialize a red rectangle -       OBJECT SET COORDINATES(*;"RedRect";$x1;$y1;$x2;$y2) -  -    :(Form event code=On Scroll) -       LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) -       LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) -       OBJECT GET COORDINATES(*;"LB1";$xlb1;$ylb1;$xlb2;$ylb2) -       $toAdd:=LISTBOX Get headers height(*;"LB1") //height of the header so as not to overlap it -       If($ylb1+$toAdd<$y1)&($ylb2>$y2) //if we are inside the list box -  //to keep it simple, we only handle headers -  //but we should handle horizontal clipping -  //as well as scroll bars -          OBJECT SET VISIBLE(*;"RedRect";True) -          OBJECT SET COORDINATES(*;"RedRect";$x1;$y1;$x2;$y2) -       Else -          OBJECT SET VISIBLE(*;"RedRect";False) -       End if -  - End case + Case of + + :(Form event code=On Clicked) + LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) + LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) + OBJECT SET VISIBLE(*;"RedRect";True) //inicializar un rectángulo rojo + OBJECT SET COORDINATES(*;"RedRect";$x1;$y1;$x2;$y2) + + :(Form event code=On Scroll) + LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) + LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) + OBJECT GET COORDINATES(*;"LB1";$xlb1;$ylb1;$xlb2;$ylb2) + $toAdd:=LISTBOX Get headers height(*;"LB1") //altura del encabezado para no solaparla +If($ylb1+$toAdd<$y1)&($ylb2>$y2) //si estamos dentro del list box +//para simplificar, sólo manejamos los encabezados +//pero deberíamos manejar el recorte horizontal +//así como las barras de desplazamiento +OBJECT SET VISIBLE(*;"RedRect";True) +OBJECT SET COORDINATES(*; "RedRect";$x1;$y1;$x2;$y2) +Else +OBJECT SET VISIBLE(*; "RedRect";False) +End if + +End case ``` -As a result, the red rectangle follows the scrolling of the list box: +Como resultado, el rectángulo rojo sigue el desplazamiento del list box: ![](../assets/en/commands/pict1900395.en.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md index 39bc7be2b0c004..de710cd9d2102d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md @@ -37,8 +37,8 @@ Por ejemplo, en el caso de un clic en un botón, el objeto contiene las siguient El objeto evento puede contener propiedades adicionales, dependiendo del objeto para el que se produzca el evento. Para objetos *eventObj* generados en: - - los objetos list box o columna de list box, ver [esta sección](../FormObjects/listbox_overview.md#additional-properties). - - áreas 4D View Pro, ver [On VP Ready form event](../Events/onVpReady.md). +- los objetos list box o columna de list box, ver [esta sección](../FormObjects/listbox_overview.md#additional-properties). +- áreas 4D View Pro, ver [On VP Ready form event](../Events/onVpReady.md). **Nota:** si no hay ningún evento actual, **FORM Event** devuelve un objeto null. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-load.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-load.md index b2246711fa01db..d4254f6891c5b6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-load.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form-load.md @@ -24,10 +24,10 @@ displayed_sidebar: docs En el parámetro *form*, puede pasar: - el nombre de un formulario, o -- the path (in POSIX syntax) to a valid .json file containing a description of the form to use, or +- la ruta (en sintaxis POSIX) a un archivo .json válido que contenga una descripción del formulario a utilizar, o - un objeto que contiene la descripción del formulario. -When the command is executed from a component, it loads the component forms by default. If you pass the *\** parameter, the method loads the host database forms. +Cuando el comando se ejecuta desde un componente, carga los formularios del componente por defecto. Si pasa el parámetro *\**, el método carga los formularios de la base de datos local. ### formData @@ -38,23 +38,23 @@ Para obtener información detallada sobre el objeto de datos del formulario, con ### Impresión de datos -Para poder ejecutar este comando, debe abrirse previamente un trabajo de impresión utilizando el comando [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md). El comando [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md) hace una llamada implícita al comando [FORM UNLOAD](../commands-legacy/form-unload.md), por lo que en este contexto es necesario ejecutar **FORM LOAD**. Once loaded, this *form* becomes the current printing form. All the object management commands, and in particular the [Print object](../commands-legacy/print-object.md) command, work with this form. +Para poder ejecutar este comando, debe abrirse previamente un trabajo de impresión utilizando el comando [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md). El comando [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md) hace una llamada implícita al comando [FORM UNLOAD](../commands-legacy/form-unload.md), por lo que en este contexto es necesario ejecutar **FORM LOAD**. Una vez cargado, este *form* se convierte en el formulario de impresión actual. Todos los comandos de gestión de objetos, y en particular el comando [Print object](../commands-legacy/print-object.md), funcionan con este formulario. -If a printing form has already been loaded beforehand (via a previous call to the **FORM LOAD** command), it is closed and replaced by *form*. You can open and close several project forms in the same print session. Changing the printing form via the **FORM LOAD** command does not generate page breaks. Corresponde al desarrollador gestionar los saltos de página. +Si ya se ha cargado previamente un formulario de impresión (mediante una llamada previa al comando **FORM LOAD**), éste se cierra y se sustituye por *form*. Puede abrir y cerrar varios formularios proyecto en la misma sesión de impresión. El cambio del formulario de impresión mediante el comando **FORM LOAD** no genera saltos de página. Corresponde al desarrollador gestionar los saltos de página. -Only the [`On Load` form event](../Events/onLoad.md) is executed during the opening of the project form, as well as any object methods of the form. Otros eventos de formulario son ignorados. The [`On Unload` form event](../Events/onUnload.md) is executed at the end of printing. +Solo se ejecuta el [evento formulario `On Load`](../Events/onLoad.md) durante la apertura del formulario proyecto, así como todos los métodos objeto del formulario. Otros eventos de formulario son ignorados. El [evento formulario `On Unload`](../Events/onUnload.md) se ejecuta al final de la impresión. -To preserve the graphic consistency of forms, it is recommended to apply the "Printing" appearance property regardless of the platform. +Para preservar la coherencia gráfica de los formularios, se recomienda aplicar la propiedad de apariencia "Impresión" independientemente de la plataforma. -The current printing form is automatically closed when the [CLOSE PRINTING JOB](../commands-legacy/close-printing-job.md) command is called. +El formulario de impresión actual se cierra automáticamente cuando el comando [CLOSE PRINTING JOB](../commands-legacy/close-printing-job.md) es llamado. ### Análisis del contenido del formulario -This consists in loading an off-screen form for parsing purposes. Para ello, basta con llamar a **FORM LOAD** fuera del contexto de un trabajo de impresión. En este caso, los eventos de formulario no se ejecutan. +Esto consiste en cargar un formulario fuera de pantalla con fines de análisis. Para ello, basta con llamar a **FORM LOAD** fuera del contexto de un trabajo de impresión. En este caso, los eventos de formulario no se ejecutan. **FORM LOAD** puede utilizarse con los comandos [FORM GET OBJECTS](../commands-legacy/form-get-objects.md) y [OBJECT Get type](../commands-legacy/object-get-type.md) para realizar cualquier tipo de procesamiento sobre el contenido del formulario. A continuación, debe llamar al comando [FORM UNLOAD](../commands-legacy/form-unload.md) para liberar el formulario de la memoria. -Note that in all cases, the form on screen remains loaded (it is not affected by the **FORM LOAD** command) so it is not necessary to reload it after calling [FORM UNLOAD](../commands-legacy/form-unload.md). +Tenga en cuenta que en todos los casos, el formulario en pantalla permanece cargado (no le afecta el comando **FORM LOAD**) por lo que no es necesario volver a cargarlo después de llamar a [FORM UNLOAD](../commands-legacy/form-unload.md). **Recordatorio:** en el contexto fuera de pantalla, no olvide llamar a [FORM UNLOAD](../commands-legacy/form-unload.md) para evitar cualquier riesgo de saturación de memoria. @@ -80,33 +80,33 @@ OPEN PRINTING JOB ## Ejemplo 3 -Parsing of form contents to carry out processing on text input areas: +Análisis del contenido de los formularios para efectuar el tratamiento de las áreas de introducción de texto: ```4d  FORM LOAD([People];"my_form") -  // selection of form without execution of events or methods +  // selección de formulario sin ejecución de eventos o métodos  FORM GET OBJECTS(arrObjNames;arrObjPtrs;arrPages;*)  For($i;1;Size of array(arrObjNames))     If(OBJECT Get type(*;arrObjNames{$i})=Object type text input) -  //… processing +  //… procesamiento     End if  End for - FORM UNLOAD //do not forget to unload the form + FORM UNLOAD //no olvide descargar el formulario ``` ## Ejemplo 4 -The following example returns the number of objects on a JSON form: +El siguiente ejemplo devuelve el número de objetos de un formulario JSON: ```4d - ARRAY TEXT(objectsArray;0) //sort form items into arrays + ARRAY TEXT(objectsArray;0) //ordenar los elementos del formulario en arrays  ARRAY POINTER(variablesArray;0)  ARRAY INTEGER(pagesArray;0)   - FORM LOAD("/RESOURCES/OutputForm.json") //load the form + FORM LOAD("/RESOURCES/OutputForm.json") //cargar el formulario  FORM GET OBJECTS(objectsArray;variablesArray;pagesArray;Form all pages+Form inherited)   - ALERT("The form contains "+String(size of array(objectsArray))+" objects") //return the object count + ALERT("The form contains "+String(size of array(objectsArray))+" objects") //devuelve el recuento de objetos ``` el resultado mostrado es: @@ -115,7 +115,7 @@ el resultado mostrado es: ## Ejemplo 5 -Desea imprimir un formulario que contiene un list box. During the *on load* event, you want the contents of the list box to be modified. +Desea imprimir un formulario que contiene un list box. Durante el evento *on load*, desea que se modifique el contenido del list box. 1\. En el método de impresión, usted escribe: @@ -127,12 +127,12 @@ Desea imprimir un formulario que contiene un list box. During the *on load* even  OPEN PRINTING JOB  $formData:=New object  $formData.LBcollection:=New collection() - ... //fill the collection with data + ... //llenar la colección con datos   - FORM LOAD("GlobalForm";$formData) //store the collection in $formData + FORM LOAD("GlobalForm";$formData) //almacenar la colección en $formData  $over:=False  Repeat -    $full:=Print object(*;"LB") // the datasource of this "LB" listbox is Form.LBcollection +    $full:=Print object(*;"LB") // la fuente de datos de este listbox "LB" es Form.LBcollection     LISTBOX GET PRINT INFORMATION(*;"LB";lk printing is over;$over)     If(Not($over))        PAGE BREAK @@ -148,7 +148,7 @@ Desea imprimir un formulario que contiene un list box. During the *on load* even  var $o : Object  Case of     :(Form event code=On Load) -       For each($o;Form.LBcollection) //LBcollection is available +       For each($o;Form.LBcollection) //LBcollection está disponible           $o.reference:=Uppercase($o.reference)        End for each  End case diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form.md index e9c07e8381e1de..24e0c24bca35fa 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/form.md @@ -26,40 +26,36 @@ displayed_sidebar: docs El comando **Form** devuelve el objeto asociado al formulario actual (instanciado a partir del parámetro *formData* o de la clase de usuario asignada en el editor de formularios). 4D automatically associates an object to the current form in the following cases: - - the current form has been loaded by one of the [`DIALOG`](dialog.md), [`Print form`](print-form.md), or [`FORM LOAD`](form-load.md) commands, - - el formulario actual es un subformulario, - - un formulario de tabla se muestra actualmente en la pantalla. +- el formulario actual ha sido cargado por uno de los comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), +- el formulario actual es un subformulario, +- un formulario de tabla se muestra actualmente en la pantalla. -### Commands (DIALOG...) +### Comandos (DIALOG...) -If the current form is being displayed or loaded by a call to the [DIALOG](dialog.md), [`Print form`](print-form.md), or [`FORM LOAD`](form-load.md) commands, **Form** returns either: +Si el formulario actual se está mostrando o cargando mediante una llamada a los comandos [DIALOG](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), **Form** devuelve cualquiera de los dos: - - el objeto *formData* pasado como parámetro a este comando, si existe, - - o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, - - o, un objeto vacío. +- el objeto *formData* pasado como parámetro a este comando, si existe, +- o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, +- o, un objeto vacío. ### Subformulario -If the current form is a subform, the returned object depends on the parent container variable: +Si el formulario actual es un subformulario, el objeto devuelto depende de la variable contenedor padre: - - **Form** returns the object associated with the table form displayed on screen.\ - **Form** returns the object associated with the table form displayed on screen.\ - In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: +- Si la variable asociada al contenedor padre ha sido tipificada como objeto, **Form** devuelve el valor de esta variable.\ + En este caso, el objeto devuelto por **Form** es el mismo que el devuelto por la siguiente expresión: ```4d (OBJECT Get pointer(Object subform container))-> ``` - - If the variable associated to the parent container has not been typed as an object, **Form** returns an empty object, maintained by 4D in the subform context. +- Si la variable asociada al contenedor padre no ha sido tipificada como objeto, **Form** devuelve un objeto vacío, mantenido por 4D en el contexto del subformulario. Para más información, consulte la sección *Subformularios de página*. ### Formulario tabla -**Form** returns the object associated with the table form displayed on screen.\ -**Form** returns the object associated with the table form displayed on screen.\ -In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: **Form** returns the object associated with the table form displayed on screen.\ -In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: +**Form** devuelve el objeto asociado al formulario tabla que se muestra en pantalla. En el contexto de un formulario de entrada visualizado desde un formulario de salida (es decir, después de hacer doble clic en un registro), el objeto devuelto contiene la siguiente propiedad: | **Propiedad** | **Tipo** | **Description** | | ------------- | -------- | ---------------------------------------------- | @@ -73,7 +69,7 @@ En un formulario que muestra el registro de una persona, un botón "Check childr **Nota:** el campo objeto "Children" se representa sólo para mostrar su estructura en este ejemplo. -In the verification form, you have assigned some Form object properties to inputs: +En el formulario de verificación, ha asignado algunas propiedades del objeto Form a las entradas: ![](../assets/en/commands/pict3541682.en.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md new file mode 100644 index 00000000000000..be4b8814606634 --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| Resultado | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
Historia + +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## Descripción + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form. + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## Ejemplo + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## Propiedades + +| | | +| ----------------- | --------------------------- | +| Número de comando | 1066 | +| Hilo seguro | ✓ | + + diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/license-info.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/license-info.md index ec0ed06069e7c8..0831a61bd841cc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/license-info.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/license-info.md @@ -18,7 +18,7 @@ displayed_sidebar: docs El comando **Licencia info** devuelve un objeto que suministra información detallada sobre la licencia activa. -If the command is executed on a 4D application that does not use locally a license (e.g. 4D remote), the command returns a Null object. +Si el comando se ejecuta en una aplicación 4D que no utiliza localmente una licencia (por ejemplo, 4D remote), el comando devuelve un objeto Null. El objeto devuelto contiene las siguientes propiedades: @@ -56,36 +56,36 @@ El objeto devuelto contiene las siguientes propiedades: } ``` -| **Propiedad** | **Tipo** | **Description** | **Ejemplo** | -| ------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | -| name | string | Nombre comercial | "4D Developer Professional vXX" | -| key | number | ID del producto instalado. A unique number is associated to a 4D application (such as 4D Server, 4D in local mode, 4D Desktop, etc.) instalado en una máquina. Este número está encriptado. | 12356789 | -| licenseNumber | string | Número de licencia | "4DDP16XXXXX1123456789" | -| version | string | Número de versión del producto | "16", "16R2" | -| attributes | colección de cadenas | Tipo(s) de licencia si aplica (opcional) | \["application","OEM"], ["evaluation"\] | -| userName | string | Nombre de la cuenta de la tienda 4D | "John Smith" | -| userMail | string | Correo de la cuenta de la tienda 4D | "john.smith@gmail.com" | -| companyName | string | Nombre de la empresa 4D store | "Alpha Cie" | -| platforms | colección de cadenas | Plataforma(s) de licencia | \["macOS", "windows"\] | -| expirationDate | object | Fecha de expiración (opcional) | {"day":2, "month":6, "year":2026} | -| renewalFailureCount | number | Number of unsuccessful automatic renewal attempts for at least one of the product licenses (optional) | 3 | -| products | collection of objects | Descripción de la licencia producto (un elemento por licencia producto). Ver abajo. | | - -Each object of the `products` collection can have the following properties: - -| **Propiedad** | | **Tipo** | **Description** | **Ejemplo** | -| ------------- | ------------------------------------------------------------------------------------------ | --------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -| id | | number | Número de licencia | Para conocer los valores disponibles, consulte el comando [Is license available](../commands-legacy/is-license-available.md) | -| name | | string | Nombre de la licencia | "4D Write - 4D Write Pro" | -| usedCount | | number | Número de conexiones consumidas | 8 | -| allowedCount | | number | Total connections allowed for the product against the expiry dates | 15 | -| rights | | collection of objects | Derechos del producto (un elemento por fecha de caducidad) | | -| | \[ \].count | number | Número de conexiones permitidas | 15 (32767 significa ilimitado) | -| | \[ \].expirationDate | object | Fecha de caducidad (opcional, el mismo formato que anterior) | {"day":1, "month":11, "year":2017} | +| **Propiedad** | **Tipo** | **Description** | **Ejemplo** | +| ------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| name | string | Nombre comercial | "4D Developer Professional vXX" | +| key | number | ID del producto instalado. Un número único está asociado a una aplicación 4D (como 4D Server, 4D en modo local, 4D Desktop, etc.) instalado en una máquina. Este número está encriptado. | 12356789 | +| licenseNumber | string | Número de licencia | "4DDP16XXXXX1123456789" | +| version | string | Número de versión del producto | "16", "16R2" | +| attributes | colección de cadenas | Tipo(s) de licencia si aplica (opcional) | \["application","OEM"], ["evaluation"\] | +| userName | string | Nombre de la cuenta de la tienda 4D | "John Smith" | +| userMail | string | Correo de la cuenta de la tienda 4D | "john.smith@gmail.com" | +| companyName | string | Nombre de la empresa 4D store | "Alpha Cie" | +| platforms | colección de cadenas | Plataforma(s) de licencia | \["macOS", "windows"\] | +| expirationDate | object | Fecha de expiración (opcional) | {"day":2, "month":6, "year":2026} | +| renewalFailureCount | number | Número de intentos fallidos de renovación automática de al menos una de las licencias de producto (opcional) | 3 | +| products | collection of objects | Descripción de la licencia producto (un elemento por licencia producto). Ver abajo. | | + +Cada objeto de la colección `products` puede tener las siguientes propiedades: + +| **Propiedad** | | **Tipo** | **Description** | **Ejemplo** | +| ------------- | ------------------------------------------------------------------------------------------ | --------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | +| id | | number | Número de licencia | Para conocer los valores disponibles, consulte el comando [Is license available](../commands-legacy/is-license-available.md) | +| name | | string | Nombre de la licencia | "4D Write - 4D Write Pro" | +| usedCount | | number | Número de conexiones consumidas | 8 | +| allowedCount | | number | Conexiones totales permitidas para el producto con respecto a las fechas de expiración | 15 | +| rights | | collection of objects | Derechos del producto (un elemento por fecha de caducidad) | | +| | \[ \].count | number | Número de conexiones permitidas | 15 (32767 significa ilimitado) | +| | \[ \].expirationDate | object | Fecha de caducidad (opcional, el mismo formato que anterior) | {"day":1, "month":11, "year":2017} | ## Ejemplo -You want to get information on your current 4D Server license: +Desea obtener información sobre su licencia actual de 4D Server: ```4d  var $obj : Object diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-collection.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-collection.md index 03e7fe4ffcc949..a185e5dda8b962 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-collection.md @@ -23,7 +23,7 @@ Si no se pasa ningún parámetro, `New collection` crea una colección vacía y Debe asignar la referencia devuelta a una variable 4D del tipo Collection. -> Keep in mind that `var : Collection` statement declares a variable of the `Collection` type but does not create any collection. +> Tenga en cuenta que la instrucción `var : Collection` declara una variable de tipo `Collection` pero no crea ninguna colección. Opcionalmente, puede prellenar la nueva colección pasando uno o varios *valores* como parámetro(s). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md index eccf225df7df86..5d6d8d4c2581f6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md @@ -31,7 +31,7 @@ Si no se pasa ningún parámetro, `New shared collection` crea una colección co Debe asignar la referencia devuelta a una variable 4D del tipo Collection. -> Keep in mind that `var : Collection` statement declares a variable of the `Collection` type but does not create any collection. +> Tenga en cuenta que la instrucción `var : Collection` declara una variable de tipo `Collection` pero no crea ninguna colección. Opcionalmente, puedes precargar la nueva colección compartida pasando uno o varios *valor(es)* como parámetro(s). De lo contrario, puede añadir o modificar elementos posteriormente por asignación notación objeto (ver ejemplo). @@ -39,14 +39,14 @@ Si el nuevo índice del elemento está más allá del último elemento existente Puede pasar cualquier número de valores de los siguientes tipos soportados: - - number (real, longint...). Los valores numéricos se almacenan siempre como reales. - - text - - boolean - - date - - time (almacenado como número de milisegundos - real) - - null - - objeto compartido - - colección compartida +- number (real, longint...). Los valores numéricos se almacenan siempre como reales. +- text +- boolean +- date +- time (almacenado como número de milisegundos - real) +- null +- objeto compartido +- colección compartida :::note diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md index d4450f98092e22..b1777d0a1ecce1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs En el parámetro *form*, puede pasar: - - el nombre de un formulario, o - - la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o - - un objeto que contiene la descripción del formulario. +- el nombre de un formulario, o +- la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o +- un objeto que contiene la descripción del formulario. Como **Print form** no genera un salto de página después de imprimir el formulario, es fácil combinar diferentes formularios en la misma página. Así, **Print form** es perfecto para tareas de impresión complejas que implican diferentes tablas y diferentes formularios. Para forzar un salto de página entre formularios, utilice el comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir la impresión a la página siguiente de un formulario cuya altura es superior al espacio disponible, invoque el comando [CANCEL](../commands-legacy/cancel.md) antes del comando [PAGE BREAK](../commands-legacy/page-break.md). Se pueden utilizar tres sintaxis diferentes: - - **Impresión de área de detalle** +- **Impresión de área de detalle** Sintaxis: @@ -43,7 +43,7 @@ Sintaxis: En este caso, **Print form** sólo imprime el área de detalle del formulario (el área entre la línea de encabezado y la línea de detalle). - - **Impresión de área de formulario** +- **Impresión de área de formulario** Sintaxis: @@ -79,7 +79,7 @@ En este caso, el comando imprimirá la sección designada por el *marker*. Pase | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impresión de sección** +- **Impresión de sección** Sintaxis: @@ -101,8 +101,8 @@ El valor devuelto por **Print form** indica la altura del área de impresión. E Las cajas de diálogo de la impresora no aparecen cuando se utiliza **Print form**. El informe no utiliza la configuración de impresión definida en el modo Diseño para el formulario. Hay dos formas de especificar los parámetros de impresión antes de realizar una serie de llamadas a **Print form**: - - Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. - - Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. +- Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. +- Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. **Print form** crea cada página impresa en la memoria. Cada página se imprime cuando la página en memoria está llena o cuando se llama a [PAGE BREAK](../commands-legacy/page-break.md). Para asegurar la impresión de la última página después de cualquier uso de **Print form**, debe concluir con el comando [PAGE BREAK](../commands-legacy/page-break.md) (excepto en el contexto de un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). En caso contrario, si la última página no está llena, permanece en memoria y no se imprime. @@ -116,8 +116,8 @@ Este comando imprime áreas y objetos externos (por ejemplo, áreas 4D Write o 4 **4D Server:** este comando puede ejecutarse en 4D Server en el marco de un procedimiento almacenado. En este contexto: - - Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). - - En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. +- Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). +- En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md index b4751f2dfdaa35..d4a6922bde6cc9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md @@ -44,7 +44,7 @@ El objeto devuelto contiene las siguientes propiedades: | type | Integer | Tipo de proceso en ejecución. Valores posibles: ver abajo | | visible | Boolean | True si es visible, false en caso contrario | - - Valores posibles para "state": +- Valores posibles para "state": | Constante | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ El objeto devuelto contiene las siguientes propiedades: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores posibles para "type": +- Valores posibles para "type": | Constante | Valor | | ----------------------------- | ----- | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session-storage.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session-storage.md index e8a593cd44ee34..8a9e20ca384796 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session-storage.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session-storage.md @@ -28,34 +28,34 @@ displayed_sidebar: docs The **Session storage** command returns the storage object of the session whose unique identifier you passed in the *id* parameter. -In *id*, pass the UUID of the session for which you want to get the storage. Se asigna automáticamente por 4D (4D Server o, para sesiones independientes, 4D mono-usuario) y se almacena en [**.id**](../API/SessionClass.md#id) propiedad del [objeto de sesión](../API/SessionClass.md). Si la sesión no existe, el comando devuelve **Null**. +En *id*, indique la UUID de la sesión para la que desea obtener el almacenamiento. Se asigna automáticamente por 4D (4D Server o, para sesiones independientes, 4D mono-usuario) y se almacena en [**.id**](../API/SessionClass.md#id) propiedad del [objeto de sesión](../API/SessionClass.md). Si la sesión no existe, el comando devuelve **Null**. **Nota:** puede obtener los identificadores de sesión usando el comando [Process activity](process-activity.md). -El objeto devuelto es la propiedad [**.storage**](../API/SessionClass.md#storage) de la sesión. It is a shared object used to store information available to all processes of the session. +El objeto devuelto es la propiedad [**.storage**](../API/SessionClass.md#storage) de la sesión. Es un objeto compartido utilizado para almacenar información disponible para todos los procesos de la sesión. ## Ejemplo -This method modifies the value of a "settings" property stored in the storage object of a specific session: +Este método modifica el valor de una propiedad "settings" almacenada en el objeto de almacenamiento de una sesión específica: ```4d -  //Set storage for a session -  //The "Execute On Server" method property is set -  - #DECLARE($id : Text; $text : Text) - var $obj : Object -  - $obj:=Session storage($id) -  - If($obj.settings=Null) -    Use($obj) -       $obj.settings:=New shared object("text";$text) -    End use - Else -    Use($obj.settings) -       $obj.settings.text:=$text -    End use - End if +//Configuración del almacenamiento de una sesión +//Configuración de la propiedad del método "Ejecutar en el servidor" + + #DECLARE($id : Text; $text : Text) + var $obj : Object + + $obj:=Session storage($id) + + If($obj.settings=Null) + Use($obj) + $obj.settings:=New shared object("text";$text) + End use + Else + Use($obj.settings) + $obj.settings.text:=$text + End use + End if ``` ## Ver también diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session.md index b7f7e51f07b0c6..2da30fc83dedf0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Ver también +## Ver también [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/set-allowed-methods.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/set-allowed-methods.md index 049452c35bbb41..dba743039ab392 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/set-allowed-methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/set-allowed-methods.md @@ -17,34 +17,34 @@ displayed_sidebar: docs ## Descripción -The **SET ALLOWED METHODS** command designates the project methods that can be entered via the application. +El comando **SET ALLOWED METHODS** designa los métodos proyecto que se pueden llamar a través de la aplicación. -4D includes a security mechanism that filters enterable project methods from the following contexts: +4D incluye un mecanismo de seguridad que filtra los métodos proyecto que se pueden introducir desde los siguientes contextos: -- The formula editor - allowed methods appear at the end of the list of default commands and can be used in formulas (see section *Description of formula editor*). -- The label editor - the allowed methods are listed in the **Apply** menu if they are also shared with the component (see section *Description of label editor*). -- Formulas inserted in styled text areas or 4D Write Pro documents through the [ST INSERT EXPRESSION](../commands-legacy/st-insert-expression.md) command - disallowed methods are automatically rejected. +- El editor de fórmulas: los métodos autorizados aparecen al final de la lista de comandos por defecto y pueden utilizarse en las fórmulas (ver la sección *Descripción del editor de fórmulas*). +- El editor de etiquetas: los métodos permitidos aparecen en el menú **Aplicar** si también se comparten con el componente (ver la sección *Descripción del editor de etiquetas*). +- Fórmulas insertadas en áreas de texto con estilo o documentos 4D Write Pro a través del comando [ST INSERT EXPRESSION](../commands-legacy/st-insert-expression.md) - los métodos no permitidos se rechazan automáticamente. - Documentos 4D View Pro - por defecto, si el comando [`VP SET ALLOWED METHODS`](../ViewPro/commands/vp-set-allowed-methods.md) nunca ha sido llamado durante la sesión, las fórmulas de 4D View Pro sólo aceptan métodos definidos por **SET ALLOWED METHODS**. Sin embargo, se recomienda utilizar [`VP SET ALLOWED METHODS`](../ViewPro/commands/vp-set-allowed-methods.md). Ver [Declarando el método permitido](../ViewPro/formulas.md#declaring-allowed-methods). -By default, if you do not use the **SET ALLOWED METHODS** command, no method is enterable (using an unauthorized method in an expression causes an error). +Por defecto, si no se utiliza el comando **SET ALLOWED METHODS**, no se puede introducir ningún método (utilizar un método no autorizado en una expresión provoca un error). -In the *methodsArray* parameter, pass the name of an array containing the list of methods to allow. El array debe haber sido configurado previamente. +En el parámetro *methodsArray*, pase el nombre de un array que contenga la lista de métodos a permitir. El array debe haber sido configurado previamente. -You can use the wildcard character (@) in method names to define one or more authorized method groups. +Puede utilizar el caracter comodín (@) en los nombres de métodos para definir uno o varios grupos de métodos autorizados. -If you would like the user to be able to call 4D commands that are unauthorized by default or plug-in commands, you must use specific methods that handle these commands. +Si desea que el usuario pueda llamar a comandos 4D que no están autorizados por defecto o a comandos plug-in, debe utilizar métodos específicos que manejen estos comandos. -**Nota:** el filtrado de fórmula puede ser deshabilitado para todos los usuarios o para el Diseñador y Administrador a través de [una opción en la página "Seguridad" de los Parámetros](../settings/security.md#options). If the "Disabled for all" option is checked, the **SET ALLOWED METHODS** command will have no effect. +**Nota:** el filtrado de fórmula puede ser deshabilitado para todos los usuarios o para el Diseñador y Administrador a través de [una opción en la página "Seguridad" de los Parámetros](../settings/security.md#options). Si la opción "Deshabilitado para todos" está seleccionada, el comando **SET ALLOWED METHODS** no tendrá efecto. :::warning -This command only filters the **input** of methods, not their **execution**. It does not control the execution of formulas created outside the application. +Este comando sólo filtra la **entrada** de los métodos, no su **ejecución**. No controla la ejecución de las fórmulas creadas fuera de la aplicación. ::: ## Ejemplo -This example authorizes all methods starting with “formula” and the “Total\_general” method to be entered by the user in protected contexts: +Este ejemplo autoriza a todos los métodos que empiezan por "formula" y al método "Total_general" a ser introducidos por el usuario en contextos protegidos: ```4d  ARRAY TEXT(methodsArray;2) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/super.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/super.md index ed43f56d9cddcf..1d525e7caedff0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/super.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/super.md @@ -44,7 +44,7 @@ Super.doSomething(42) //llama a la función "doSomething" Este ejemplo ilustra el uso de `Super` en un class constructor. El comando es llamado para evitar duplicar las partes del constructor que son comunes entre las clases `Rectangle` y `Square`. ```4d -// Class: Rectangle +// Clase: Rectángulo Class constructor($width : Integer; $height : Integer) This.name:="Rectangle" This.height:=$height @@ -54,7 +54,7 @@ Class constructor($width : Integer; $height : Integer) Function sayName() ALERT("Hi, I am a "+This.name+".") -// Function definition +// Definición de la función Function getArea() : Integer return (This.height)*(This.width) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md index b6568846d62995..7636c84eae028d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md @@ -12,7 +12,7 @@ slug: /commands/theme/Tools | [](../../commands-legacy/choose.md)
| | [](../../commands-legacy/generate-digest.md)
| | [](../../commands-legacy/generate-password-hash.md)
| -| [](../../commands-legacy/generate-uuid.md)
| +| [](../generate-uuid.md)
| | [](../../commands-legacy/get-macro-parameter.md)
| | [](../../commands-legacy/launch-external-process.md)
| | [](../../commands-legacy/load-4d-view-document.md)
| diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md index e3802249a306f6..2682c1471d6107 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md @@ -13,8 +13,8 @@ Las páginas Cliente-Servidor agrupan los parámetros relacionados con el uso de Esta opción le permite indicar si la base de datos 4D Server aparecerá o no en la lista de bases de datos publicadas. - - Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). - - Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. +- Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). +- Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. :::note @@ -49,11 +49,11 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con 4D Server utiliza tres puertos TCP para las comunicaciones entre los servidores internos y los clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). - - **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). +- **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ Tenga en cuenta que en caso de acceso a través de un enrutador o un cortafuegos, los tres puertos TCP deben abrirse explícitamente. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. #### Autenticación del usuario con el servidor de dominio @@ -67,9 +67,9 @@ Cuando la autenticación única (SSO) está activa (ver arriba), debe llenar est Esta caja desplegable contiene 3 opciones de capa de red a elegir entre: **legacy**, **ServerNet** y **QUIC** (sólo en modo proyecto), que se utilizan para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). - - **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -109,9 +109,9 @@ Esta opción permite activar el modo seguro para las comunicaciones entre la má Este parámetro puede utilizarse para definir globalmente el modo de actualización de la instancia local de la carpeta **Resources** en los equipos 4D conectados cuando se modifica la carpeta **Resources** de la base de datos durante la sesión (la carpeta **Resources** se sincroniza automáticamente en el equipo remoto cada vez que se abre una sesión). Hay tres parámetros disponibles: - - **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. - - **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ +- **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. +- **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ La carpeta **Resources** centraliza los archivos personalizados necesarios para la interfaz de la base (archivos de traducción, imágenes, etc.). Se pueden utilizar mecanismos automáticos o manuales para notificar a cada cliente cuándo se ha modificado el contenido de esta carpeta. Para más información, consulte la sección [Gestión de la carpeta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuración IP @@ -124,10 +124,10 @@ Esta tabla permite definir las reglas de control de acceso a la base en función El funcionamiento de la tabla de configuración es el siguiente: - - La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. - - La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. - - La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. - - Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: +- La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. +- La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. +- La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. +- Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: - Denegar 192.168.\* (denegar todas las direcciones que empiecen por 192.168) - Autorizar \* (y permitir todas las demás direcciones) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md index 486f1c14d151de..9865cbdbab0102 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md @@ -8,10 +8,10 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien > El número de opciones mostradas depende de la versión de 4D con la que se creó la base de datos/proyecto original, así como de los ajustes modificados en esta base de datos/proyecto.\ > Esta página enumera las opciones de compatibilidad disponibles para las bases de datos/proyectos convertidos a partir de 4D v18. Para las opciones de compatibilidad más antiguas, consulte la [página Compatibilidad](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) en **doc.4d.com**. - - **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. +- **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. **Nota**: esta opción también puede gestionarse por programación utilizando el comando `SET DATABASE PARAMETER`. - - **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: +- **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: - el caracter inicial "/" no es sólo el nodo raíz - la utilización del caracter / como primer caracter en una expresión XPath no declara una ruta absoluta desde el nodo raíz - no hay nodo actual implícito - el nodo actual debe incluirse en la expresión XPath @@ -19,12 +19,12 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien Aunque no es estándar, es posible que desee seguir utilizando estas funcionalidades para que su código siga funcionando como antes -- en este caso, basta con establecer la opción *desmarcarcada*. Por otra parte, si su código no se basa en la implementación no estándar y si desea beneficiarse de las funcionalidades extendidas de XPath en sus bases de datos (como se describe en el comando [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md)), asegúrese de que la opción \**Utilizar XPath estándar* esté *marcada*. - - **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). +- **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). - - **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). +- **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). - - **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/database.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/database.md index 07a07d9635560d..e4bd23accd32a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/database.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/database.md @@ -17,10 +17,24 @@ Esta opción permite configurar el funcionamiento de la aplicación al abrir un A menos que se marque esta opción, no es posible abrir una base cuando su archivo de datos está bloqueado (funcionamiento por defecto para las bases 4D). -#### Sobre el bloqueo de archivos +:::info Sobre el bloqueo de archivos Los archivos bloqueados pueden ser leídos pero su contenido no puede ser modificado. Por ejemplo, los archivos se bloquean cuando se almacenan en un soporte no regrabable (tipo DVD) o cuando se copian desde este tipo de soporte. 4D puede trabajar de forma transparente con archivos de datos bloqueados, lo que permite, en particular, la utilización de proyectos guardados en DVD. Sin embargo, con esta operación se corre el riesgo de utilizar inadvertidamente un fichero de datos bloqueado en el que no se guardarán las modificaciones. Esta es la razón por la que, por defecto, 4D no permite abrir bases de datos con un archivo de datos bloqueado. +::: + +#### Auto UUID version + +[UUID version](https://en.wikipedia.org/wiki/Universally_unique_identifier) to use for 4D fields with [automatic UUID generation option](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106195). Available values are **4** (default) and **7**. + +This setting only applies to UUIDs generated afterwards. Already saved auto UUIDs fields are not recomputed. + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + ### Ubicación de carpeta temporal Esta área le permite cambiar la ubicación de los archivos temporales creados mientras 4D está funcionando. La carpeta de archivos temporales es utilizada por la aplicación, cuando es necesario, para guardar temporalmente en disco los datos en memoria. @@ -31,9 +45,9 @@ La ubicación actual de esta carpeta se muestra en el área "Actual:". Puede hac Se ofrecen tres opciones de ubicación: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. > Esta opción se almacena en las "propiedades adicionales" de la estructura, accesibles durante la exportación XML de la definición de estructura (ver [Exportar e importar las definiciones de estructura](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +55,7 @@ Se ofrecen tres opciones de ubicación: > Si cambia una de estas opciones, tiene que salir y volver a abrir la base para que el cambio surta efecto. Una vez reabierta la base, se vuelven a indexar automáticamente todos sus índices. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Cuando la opción está marcada, la arroba se considera un caracter simple si se encuentra dentro de una palabra. Esta posibilidad es especialmente útil cuando se buscan direcciones de correo electrónico, donde el signo @ se utiliza internamente. Esta opción influye en las búsquedas, ordenaciones, comparaciones de cadenas de caracteres, así como en los datos almacenados en las tablas y los que se encuentran en memoria, como los arrays. Los campos y variables de tipo alfa (indexados o no) y texto se ven afectados por como se interpreta el caracter @ en las búsquedas y ordenaciones. @@ -52,19 +66,19 @@ Se ofrecen tres opciones de ubicación: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razones de seguridad, sólo el Administrador o Diseñador de la base de datos puede modificar este parámetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. Así, un proyecto 4D puede funcionar en un lenguaje distinto del del sistema. Cuando se abre un proyecto, el motor de 4D detecta el lenguaje utilizado por el archivo de datos y lo pasa al lenguaje (modo intérpretado o compilado). Las comparaciones de texto, independientemente de si las efectúa el motor del proyecto o el lenguaje, se hacen en el mismo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). En este caso, la configuración se aplica a todas las nuevas bases creadas por 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. Este algoritmo es similar al que utilizan los programas de tratamiento de textos para determinar los límites al seleccionar una palabra sobre la que se hace doble clic. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Cuando esta opción está marcada, 4D utiliza un algoritmo simplificado. En esta configuración, todo caracter no alfanumérico (es decir, que no sea una letra o un número) se considera un separador de palabras claves. Esta configuración cumple requisitos específicos asociados a determinados idiomas, como el japonés. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. #### Soporte de Mecab (versión japonesa) @@ -82,7 +96,7 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ### Parámetros de la caché para la base - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Este valor aumenta para la optimización cuando otras aplicaciones se ejecutan en la misma máquina que 4D. - **Porcentaje de memoria disponible utilizada para la caché**: porcentaje de la memoria restante asignada por defecto a la caché.\ @@ -98,11 +112,11 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). El tamaño de la memoria caché que introduzca se reservará para la base 4D, independientemente del estado de los recursos de la máquina. Esta configuración puede utilizarse en determinadas configuraciones específicas, o cuando la base está diseñada para utilizarse en sistemas disímiles en cuanto a memoria. En la mayoría de los casos, la caché adaptativa ofrece un mejor rendimiento. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D guarda los datos colocados en la caché a intervalos regulares. Puede especificar todo intervalo de tiempo entre 1 segundo y 500 minutos. Por defecto, 4D guarda sus datos cada 20 segundos. La aplicación también guarda sus datos en el disco cada vez que cambia a otro entorno o sale de la aplicación. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Cuando prevea una entrada de muchos datos, considere la posibilidad de establecer un intervalo de tiempo breve entre guardados. En caso de corte del suministro eléctrico, sólo perderá los datos introducidos desde el último almacenamiento (si la base de datos funciona sin archivo de historial). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md index 7d47ee3b1c3e32..b35956d2815b04 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md @@ -23,9 +23,9 @@ La fuente y el tamaño de la fuente por defecto dependen de la plataforma de eje Otras opciones permiten configurar la visualización de varias ventanas del modo Aplicación. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Este menú permite seleccionar la paleta de colores que se utilizará en la apli Los siguientes esquemas están disponibles: - - **Claro**: la aplicación usará el Tema Claro Predeterminado +- **Claro**: la aplicación usará el Tema Claro Predeterminado ![](../assets/en/settings/light-appearance.png) - - **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado +- **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Los temas por defecto pueden ser manejados utilizando CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). El esquema de aplicación principal se aplicará a los formularios por defecto. Sin embargo, se puede remplazar: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atajos @@ -72,9 +72,9 @@ El área de Atajos directos sirve para ver y modificar los atajos por defecto pa Los accesos directos por defecto son los siguientes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece la siguiente caja de diálogo: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/security.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/security.md index 898eec6f0369de..6a18b242beb789 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/security.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/security.md @@ -11,7 +11,7 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l > Estos parámetros no se aplican a las bases proyecto abiertas en modo monopuesto. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - El Diseñador y el Administrador siempre tienen acceso al entorno de diseño y al Explorador de ejecución, incluso si no son parte explícitamente del grupo de acceso específico. Para más información sobre usuarios y grupos de usuarios, consulta el capítulo [Usuarios y grupos](../Users/handling_users_groups.md). - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. Esta opción simplifica el acceso a la base de datos a la vez que mantiene un sistema completo de control de datos. - Si ha asociado una contraseña al usuario predeterminado, al abrir la base aparece una caja de diálogo en el que los usuarios deben introducir una contraseña. - Si no ha asociado una contraseña al Usuario Predeterminado, la caja de diálogo de Identificación de Usuario no aparecerá.**Nota:** puede "forzar" la visualización de la caja de diálogo Identificación de usuario cuando el modo "Usuario por defecto" está activo, por ejemplo para conectarse como Administrador o Diseñador. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. ## Opciones - - **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: +- **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: por razones de seguridad, por defecto 4D restringe el acceso a los comandos, funciones y métodos proyecto en el [Editor de fórmulas](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) en el modo Aplicación o añadido a áreas multiestilo (usando [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), Documentos 4D Write Pro y 4D View Pro: sólo ciertas funciones 4D y métodos proyecto que han sido declarados explícitamente utilizando el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) pueden ser utilizados. Puede eliminar total o parcialmente este filtrado mediante las siguientes opciones. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Permite definir un modo de acceso ilimitado a los comandos y métodos sin perder el control de las operaciones efectuadas. Durante la fase de desarrollo, este modo puede utilizarse para probar libremente todas las fórmulas, informes, etc. Durante el funcionamiento, puede utilizarse para definir soluciones seguras que permitan el acceso temporal a comandos y métodos. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Cuando esta opción está marcada, los usuarios tienen acceso a todos los comandos 4D, plug-ins y métodos proyecto (excepto los invisibles). **Nota:** esta opción tiene prioridad sobre el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Cuando se selecciona, este comando no hace nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). - - **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. +- **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. Cuando esta opción está seleccionada: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/web.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/web.md index 0b5750d313b529..68bacf5927c493 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/web.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/settings/web.md @@ -82,9 +82,9 @@ Cuando se selecciona esta opción, el servidor web no ofrece ningún soporte esp En este modo, puede configurar los parámetros del servidor web adicionales: - - [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) - - [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) - - [Usar procesos apropiativos](#use-preemptive-processes) +- [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) +- [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) +- [Usar procesos apropiativos](#use-preemptive-processes) #### Sesiones antiguas (sesiones procesos únicos) @@ -164,9 +164,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D El menú de formato de registro ofrece las siguientes opciones: - - **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. +- **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. - - **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ +- **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ host rfc931 user [DD/MMM/AAAA:HH:MM:SS] "request" state length\ Cada campo está separado por un espacio y cada línea termina con la secuencia CR/LF (character 13, character 10). @@ -177,9 +177,9 @@ El menú de formato de registro ofrece las siguientes opciones: > La fecha y hora son locales al servidor. - - petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) - - estado: respuesta dada por el servidor. - - longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. +- petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) +- estado: respuesta dada por el servidor. +- longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. > **Nota:** por razones de rendimiento, las operaciones se guardan en una memoria búfer por paquetes de 1Kb antes de ser escritas en el disco. Las operaciones también se escriben en disco si no se ha enviado ninguna petición cada 5 segundos. > Los posibles valores de estado son los siguientes @@ -193,16 +193,16 @@ El menú de formato de registro ofrece las siguientes opciones: > 500: Internal error > El formato CLF no puede personalizarse. - - **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. +- **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. - Referer: contiene la URL de la página que apunta al documento solicitado. - User-agent: contiene el nombre y la versión del navegador o del software cliente en el origen de la petición. > El formato DLF no se puede personalizar. - - **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. +- **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. - - **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. +- **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. **Configuring the fields** When you choose the ELF (Extended Log Format) or WLF (WebStar Log Format) format, the "Weg Log Token Selection" area displays the fields available for the chosen format. Deberá seleccionar cada campo para incluirlo en el registro. You will need to select each field to be included in the log. @@ -241,14 +241,14 @@ La siguiente tabla enumera los campos disponibles para cada formato (en orden al Configure los parámetros de copia de seguridad automática para el registro de las peticiones. Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. > En el caso de las copias de seguridad programadas, si el servidor web no fue lanzado cuando se programó la copia de seguridad, en el siguiente lanzamiento 4D considera que la copia de seguridad ha fallado y aplica los parámetros adecuados, definidos en las Propiedades de la base. @@ -262,9 +262,9 @@ Para más información sobre el soporte de los servicios web en 4D, consulte el Esta área contiene varias opciones relativas con el uso de 4D como un "servidor" de Servicios Web, es decir la publicación de los métodos proyecto en forma de Servicios Web. - - **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. - - **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. - - **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. +- **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. +- **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. > Conforme al estándar XML para los nombres de etiquetas, las cadenas de caracteres utilizadas no deben contener espacios ni comenzar con un número. Además, para evitar cualquier riesgo de incompatibilidad, recomendamos que no utilice ningún caracter extendido (como los caracteres acentuados). @@ -272,7 +272,7 @@ Esta área contiene varias opciones relativas con el uso de 4D como un "servidor Esta área contiene varias opciones relacionadas con el uso de 4D como un "cliente" de Servicios Web, es decir, suscribirse a los servicios publicados en la red. - - **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". +- **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". ## Funcionalidades Web @@ -306,9 +306,9 @@ Este botón solo está disponible en los proyectos abiertos con la aplicación 4 El botón activa la siguiente secuencia de actualización: - - Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. - - Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). - - Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. +- Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. +- Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). +- Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. Recuerde reiniciar su proyecto después de realizar esta actualización. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md index 516b88ef8f1386..513d2fdda8fdee 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md @@ -160,8 +160,8 @@ Puede pasar uno o más parámetros opcionales *param*, que se pasarán a la [fun :::note Notas - - Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. - - Si se llama a `.new()` en una clase inexistente, se devuelve un error. +- Si se llama a `.new()` en una [clase singleton](../Concepts/classes.md#singleton-classes) que ya ha sido instanciada, se devuelve la instancia singleton, no una nueva instancia. +- Si se llama a `.new()` en una clase inexistente, se devuelve un error. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/Document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/Document.md index 944900df8642e6..8372233057679f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/Document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/Document.md @@ -320,8 +320,8 @@ Esta propiedad es de **solo lectura**. La propiedad `.original` devuelveel elemento de destino para un alias, un acceso directo o un archivo de enlace simbólico. El elemento objetivo puede ser: - - un objeto File - - un objeto de la carpeta +- un objeto File +- un objeto de la carpeta Para los archivos sin alias, la propiedad devuelve el mismo objeto File que el archivo. @@ -585,8 +585,8 @@ La función `.getText()` devuelve el con Opcionalmente, puede designar el conjunto de caracteres que se utilizará para leer el contenido. Puede pasar: - - en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), - - o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. +- en *charSetName*, una cadena que contiene el nombre del conjunto estándar (por ejemplo "ISO-8859-1" o "UTF-8"), +- o en *charSetNum*, el ID MIBEnum (número) del nombre del conjunto estándar. > Para conocer la lista de los conjuntos de caracteres que soporta 4D, consulte la descripción del comando `CONVERT FROM TEXT`. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/IncomingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/IncomingMessageClass.md index aa1f9df7f9d15f..0ae9ec207f1c61 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/IncomingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/IncomingMessageClass.md @@ -3,9 +3,9 @@ id: IncomingMessageClass title: IncomingMessage --- -La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). HTTP requests and their properties are automatically received as an instance of the `4D.IncomingMessage` class. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). +La clase `4D.IncomingMessage` le permite manejar el objeto recibido por un [**HTTP request handler**](../WebServer/http-request-handler.md). Las peticiones HTTP y sus propiedades se reciben automáticamente como una instancia de la clase `4D.IncomingMessage`. Los parámetros dados directamente en la petición con el verbo GET son manejados por la propiedad [`.urlQuery`](#urlquery), mientras que los parámetros pasados en el cuerpo de la solicitud están disponibles a través de funciones como [`.getBlob()`](#getblob) o [`getText()`](#gettext). -El gestor de peticiones HTTP puede devolver cualquier valor (o nada). It usually returns an instance of the [`4D.OutgoingMessage`](OutgoingMessageClass.md) class. +El gestor de peticiones HTTP puede devolver cualquier valor (o nada). Normalmente devuelve una instancia de la clase [`4D.OutgoingMessage`](OutgoingMessageClass.md). Todas las propiedades de esta clase son de sólo lectura. Son automáticamente llenados por el gestor de peticiones. @@ -19,7 +19,7 @@ Todas las propiedades de esta clase son de sólo lectura. Son automáticamente l ### Ejemplo -The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) has been defined: +El siguiente [archivo **HTTPHandlers.json**](../WebServer/http-request-handler.md) ha sido definido: ```json [ @@ -32,7 +32,7 @@ The following [**HTTPHandlers.json** file](../WebServer/http-request-handler.md) ] ``` -The `http://127.0.0.1/start/example?param=demo&name=4D` request is run with a `GET` verb in a browser. It is handled by the *gettingStarted* function of the following *GeneralHandling* singleton class: +La petición `http://127.0.0.1/start/example?param=demo&name=4D` se ejecuta con un verbo `GET` en un navegador. Se gestiona mediante la función *gettingStarted* de la siguiente clase singleton *GeneralHandling*: ```4d shared singleton Class constructor() @@ -59,7 +59,7 @@ Function gettingStarted($request : 4D.IncomingMessage) : 4D.OutgoingMessage ``` -The request is received on the server as *$request*, an object instance of the `4D.IncomingMessage` class. +La petición se recibe en el servidor como *$request*, una instancia de objeto de la clase `4D.IncomingMessage`. Esta es la respuesta: @@ -76,7 +76,7 @@ There are 2 url parts - Url parts are: start - example ### Objeto IncomingMessage -4D.IncomingMessage objects provide the following properties and functions: +Los objetos 4D.IncomingMessage ofrecen las siguientes propiedades y funciones: | | | ----------------------------------------------------------------------------------------------------------------------------------------- | @@ -115,7 +115,7 @@ Un objeto 4D.IncomingMessage es un objeto [no compartible](../Concepts/shared.md La función `.getBlob()` devuelve el cuerpo de la petición como un Blob. -If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como contenido binario, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -172,7 +172,7 @@ $value := $request.getHeader("content-type") La función `.getJSON()` devuelve el cuerpo de la solicitud como una resolución JSON. -If the body has not been given as JSON valid content, an error is raised. +Si el cuerpo no se ha dado como contenido JSON válido, se produce un error. @@ -194,7 +194,7 @@ If the body has not been given as JSON valid content, an error is raised. La función `.getPicture()` devuelve el cuerpo de la petición como una imagen (en caso de que un cuerpo enviado como una imagen). -The content-type must be given in the headers to indicate that the body is a picture. +El tipo de contenido debe indicarse en los encabezados para indicar que el cuerpo es una imagen. :::note @@ -202,7 +202,7 @@ Si la solicitud se crea utilizando la [clase `HTTPRequest`](HTTPRequestClass.md) ::: -If the body is not received as a valid picture, the function returns null. +Si el cuerpo no se recibe como una imagen válida, la función devuelve null. @@ -224,7 +224,7 @@ If the body is not received as a valid picture, the function returns null. La función `.getText()` devuelve el cuerpo de la solicitud como un valor de texto. -If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. +Si el cuerpo no se ha dado como cadena, la función intenta convertir el valor pero puede dar resultados inesperados. @@ -254,7 +254,7 @@ Los nombres de los encabezados (llaves) se escriben en minúsculas. Tenga en cue La propiedad `.url` contiene la URL de la petición sin la parte *IP:port* y como cadena. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.url` es "/docs/invoices/today". La propiedad `.url` es de sólo lectura. @@ -276,7 +276,7 @@ La parte "host" de la petición (*IP:port*) es suministrada por el [encabezado ` La propiedad `.urlPath` contiene la URL de la solicitud sin la parte *IP:port* y como una colección de cadenas. -For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. +Por ejemplo, si la solicitud va dirigida a "http://127.0.0.1:80/docs/invoices/today", la propiedad `.urlPath` es ["docs", "invoices" , "today"]. La propiedad `.urlPath` es de sólo lectura. @@ -294,19 +294,19 @@ La propiedad `.urlQuery` contiene el verbo usado por la petición. -HTTP and HTTPS request verbs include for example "get", "post", "put", etc. +Los verbos de solicitud HTTP y HTTPS incluyen, por ejemplo, "get", "post", "put", etc. La propiedad `.verb` es de sólo lectura. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md index 3bf887380f503c..dde9a19a921c31 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objeto 4D.OutgoingMessage es un objeto [no compartible](../Concepts/shared.md La propiedad `.body` contiene el cuerpo del mensaje saliente. Los siguientes tipos de datos están soportados en la propiedad `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image La propiedad `.body` es de lectura-escritura. @@ -108,17 +108,17 @@ La función `.setBody()` def Los siguientes tipos de datos están soportados en el *body*: - - Text - - Blob - - Object - - Imagen +- Text +- Blob +- Object +- Imagen Cuando se utiliza esta función, el encabezado content-type se define automáticamente en función del tipo *body*: - - Content-Type:text/plain si el cuerpo es un Texto - - Content-Type:application/octet-stream si el body es un Blob - - Content-Type:application/json si el body es un objeto - - Content-Type:image/jpeg, image/gif... si el body es una imagen +- Content-Type:text/plain si el cuerpo es un Texto +- Content-Type:application/octet-stream si el body es un Blob +- Content-Type:application/json si el body es un objeto +- Content-Type:image/jpeg, image/gif... si el body es una imagen Si *body* no es de un tipo de valor soportado, se devuelve un error. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md index c2aac8d8067a35..9b93abeaf870fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propiedad `.keepAlive` contiene diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md index ee34091e8e1278..472d3e0bb36ed7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Los objetos de sesión son devueltos por el comando [`Session`](../commands/session.md). Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar [privilegios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sesiones Los siguientes tipos de sesiones están soportados por esta clase: @@ -38,11 +47,6 @@ La disponibilidad de las propiedades y funciones del objeto `Session` depende de | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md index c6b433cd74a1d7..b22060e96f189f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md @@ -55,8 +55,8 @@ La función `.disableState()` d Esta función no hace nada si: - - el *estado* no está habilitado actualmente en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* no está habilitado actualmente en el formulario web, +- el *estado* no existe para el formulario web. Si [activa](#enablestate) o desactiva varios estados en la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez finalizada la función. @@ -80,8 +80,8 @@ La función `.enableState()` act Esta función no hace nada si: - - el *estado* ya ha sido activado en el formulario web, - - el *estado* no existe para el formulario web. +- el *estado* ya ha sido activado en el formulario web, +- el *estado* no existe para el formulario web. Si activa o [desactiva](#disablestate) varios estados dentro de la misma función usuario, todas las modificaciones se envían al mismo tiempo al cliente una vez que la función termina. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md index e89f0eed941e0f..54894c3af956cc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md @@ -86,8 +86,8 @@ La función `4D.WebSocket.new()` crea y En *url*, pase la URL a la que responderá el servidor WebSocket. Se pueden utilizar los siguientes patrones de URL: - - `ws://host[:port]path[?query]` para conexiones estándar - - `wss://host[:port]path[?query]` para conexiones seguras TLS +- `ws://host[:port]path[?query]` para conexiones estándar +- `wss://host[:port]path[?query]` para conexiones seguras TLS Si la conexión no es posible, se devuelve un objeto `null` y se genera un error (que puede interceptar utilizando un método instalado con `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la conexión no es posible, se devuelve un objeto `null` y se genera un error En *connectionHandler*, puede pasar un objeto que contenga funciones de retrollamada a ser llamadas según los eventos de conexión, así como el tipo de datos y encabezados a manejar. - - Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. - - El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. +- Las retrollamadas se llaman automáticamente en el contexto del formulario o worker que inicia la conexión. +- El WebSocket será válido siempre y cuando el formulario o trabajador no esté cerrado. | Propiedad | Tipo | Descripción | | ----------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La función `.terminate()` cierr En *code*, puede pasar un código de estado que explique por qué se está cerrando la conexión (ver también [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. - - Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. +- Si no se especifica, el código de cierre de la conexión se establece automáticamente en 1000 para un cierre normal o, en caso contrario, en otro valor estándar del rango 1001-1015 que indique la razón real por la que se cerró la conexión. +- Si se especifica, el valor de este parámetro de código anula el ajuste automático. El valor debe ser un número entero. O 1000, o un código personalizado en el rango 3000-4999. Si especifica un valor *code*, también debe especificar un valor *reason*. En *reason*, puede pasar una cadena que describa por qué se está cerrando la conexión. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md index 7a39dc1916d619..dd24f32e2a209e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Ver también [esta entrada de blog](https://blog.4d.com/new-built-in-websocket-s Para crear y manejar su Servidor WebSocket en 4D, tendrá que utilizar dos clases 4D integradas: - - esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, - - la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. +- esta clase (`4D.WebSocketServer`) para gestionar el propio servidor, +- la clase [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para administrar conexiones y mensajes. Además, tendrá que crear dos clases de usuario que contendrán funciones de retrollamada: - - una clase usuario para gestionar las conexiones al servidor, - - una clase usuario para gestionar mensajes. +- una clase usuario para gestionar las conexiones al servidor, +- una clase usuario para gestionar mensajes. Debe [crear el servidor WebSocket](#4dwebsocketservernew) dentro de un [worker](../Develop/processes.md#worker-processes) para mantener viva la conexión. @@ -387,8 +387,8 @@ De forma predeterminada, si no se establece un valor *timeout*, la función inic Si se establece un valor de *timeout*: - - cuando se alcanza el tiempo de espera, destruye forzosamente el socket. - - si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. +- cuando se alcanza el tiempo de espera, destruye forzosamente el socket. +- si *timeout* = 0, destruye el socket de forma forzada sin cerrar los frames ni intercambiar paquetes fin, y lo hace al instante sin esperar. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md index 7108ada0d3da2f..c5f9761b457de6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Es necesario configurar el lanzamiento al i Puede configurar el servidor web `WebAdmin` para que se lance al inicio de la aplicación 4D o 4D Server (antes de que se cargue cualquier proyecto). - - Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. +- Si utiliza una aplicación 4D con interfaz, seleccione la opción de menú **Archivo > Administración web > Parámetros....**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Seleccione la opción **Iniciar servidor WebAdmin al inicio** en la caja de diá ![alt-text](../assets/en/Admin/waSettings.png) - - Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: +- Tanto si utiliza la aplicación 4D con o sin interfaz, puede habilitar el modo de inicio automático utilizando el siguiente argumento *Interfaz de línea de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Cuando esta opción está seleccionada, podrá conectarse al servidor web `WebAd **Notas:** - - Nunca se aceptan conexiones con HTTP que no sean localhost. - - Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. +- Nunca se aceptan conexiones con HTTP que no sean localhost. +- Incluso si esta opción está activada, cuando [HTTPS aceptada](#accept-https) está activada y la configuración TLS es válida, las conexiones localhost utilizan HTTPS. #### Puerto HTTP @@ -95,11 +95,11 @@ Ruta de la carpeta donde se encuentran los archivos del certificado TLS. Por def Estado o formato del archivo de registro de peticiones HTTP (HTTPDebugLog_*nn*.txt, almacenado en la carpeta "Logs" de la aplicación -- *nn* es el número de archivo). Las siguientes opciones están disponibles: - - **Desactivado** (por defecto) - - **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición - - \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) - - **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones - - **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas +- **Desactivado** (por defecto) +- **Con todas las partes del body** - activado con las partes del cuerpo en respuesta y petición +- \*\*Sin las partes del body \*\* - activado sin partes del cuerpo (se indica el tamaño del cuerpo) +- **Con los cuerpos de las peticiones** - activado con la partes del cuerpo únicamente en las peticiones +- **Con la respuesta body** - activado con la partes del cuerpo únicamente en las respuestas #### Llave de acceso @@ -109,10 +109,10 @@ La configuración de una llave de acceso es obligatoria para desbloquear el acce Una llave de acceso es similar a una contraseña pero no está asociada a un inicio de sesión. - - Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del +- Para definir una nueva llave de acceso: haga clic en el botón **Definir**, introduzca la cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. - - Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. +- Para modificar la llave de acceso: haga clic en el botón **Modificar**, introduzca la nueva cadena de la llave de acceso en la caja de diálogo y haga clic en **OK**. +- Para eliminar la llave de acceso: haga clic en el botón **Modificar**, deje vacía el área de la llave de acceso y haga clic en **OK**. #### Activar el acceso a Qodly Studio @@ -148,9 +148,9 @@ Ejemplo: ## Autenticación y sesión - - Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. +- Cuando se accede a una página de gestión web introduciendo una URL y sin identificación previa, se requiere una autenticación. El usuario debe introducir la [llave-de-acceso](#access-key) en una ventana de autenticación. Si la llave de acceso no fue definida en la configuración de `WebAdmin`, no es posible el acceso vía URL. - - Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. +- Cuando se accede a una página de gestión web directamente desde un elemento de menú de 4D o 4D Server (como **Registros > Explorador de datos** o **Ventana > Explorador de datos** (4D Server)), el acceso se concede sin autenticación, el usuario se autentifica automáticamente. Una vez concedido el acceso, se crea una [sesión web](WebServer/sessions.md) con el privilegio "WebAdmin" en la aplicación 4D. Mientras la sesión actual tenga el privilegio "WebAdmin", el componente `WebAdmin` entrega las páginas solicitadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md index 1fb388c12979ef..44c863fc5fe3dc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar 4D le permite restaurar conjuntos enteros de datos de una aplicación en caso de que se presente un incidente, independientemente de sus causas. Pueden producirse dos categorías principales de incidentes: - - La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: +- La parada inesperada de la aplicación mientras está en uso. Este incidente puede producirse por un corte de luz, un fallo de un elemento del sistema, etc. En este caso, dependiendo del estado actual de la caché de datos en el momento del incidente, la restauración de la aplicación puede requerir diferentes operaciones: - Si la caché estaba vacía, la aplicación se abre normalmente. Se registraron todos los cambios realizados en la aplicación. Este caso no requiere ninguna operación particular. - Si la caché contiene operaciones, el archivo de datos está intacto pero requiere integrar el archivo de historial actual. - Si la caché estaba en proceso de escritura, es probable que el archivo de datos esté dañado. Hay que restaurar la última copia de seguridad e integrar el archivo de historial actual. - - La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. +- La pérdida de archivo(s) de la aplicación. Este incidente puede producirse por sectores defectuosos en el disco que contiene la aplicación, un virus, un error de manipulación, etc. Hay que restaurar la última copia de seguridad y luego integrar el archivo de historial actual. Para saber si una aplicación ha sido dañada tras un incidente, basta con relanzarla con 4D. El programa realiza un auto diagnóstico y detalla las operaciones de reparación a realizar. En modo automático, estas operaciones se realizan directamente sin ninguna intervención por parte del usuario. Si se ha puesto en marcha una estrategia regular de copias de seguridad, las herramientas de restauración de 4D le permitirán (en la mayoría de los casos) recuperar la aplicación en el estado exacto en que se encontraba antes del incidente. > 4D puede lanzar procedimientos automáticamente de recuperación de las aplicaciones tras los incidentes. Estos mecanismos se gestionan mediante dos opciones disponibles en la página **Backup/Backup y Restauración** de las Propiedades. Para más información, consulte el párrafo [Restauración automática](settings.md#automatic-restore-and-log-integration).\ > Si la incidencia es el resultado de una operación inadecuada realizada sobre los datos (eliminación de un registro, por ejemplo), puede intentar reparar el archivo de datos utilizando la función "rollback" en el archivo de historial. Esta función está disponible en la página [Retroceder](MSC/rollback.md) del CSM. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md index 9d6b3f2706ff8c..a14ab4754a986e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md @@ -5,9 +5,9 @@ title: Parámetros de la copia de seguridad Los parámetros de copia de seguridad se definen a través de tres páginas en el [cuadro de diálogo de los parámetros](../settings/overview.md). Puede definir: - - la periodicidad de las copias de seguridad automáticas - - los archivos a incluir en cada copia de seguridad - - las funcionalidades avanzadas permiten ejecutar tareas automáticas +- la periodicidad de las copias de seguridad automáticas +- los archivos a incluir en cada copia de seguridad +- las funcionalidades avanzadas permiten ejecutar tareas automáticas > Las propiedades definidas en esta caja de diálogo se escriben en el archivo *Backup.4DSettings*, guardado en la carpeta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Los parámetros de copia de seguridad periódicos se definen en la página **Bac Las opciones que se encuentran en esta pestaña le permiten establecer y configurar las copias de seguridad periódicas automáticas de la aplicación. Puede elegir una configuración rápida estándar o puede personalizarla completamente. Aparecen varias opciones en función de la elección realizada en el menú **Copia de seguridad automática**: - - **Nunca**: la función de copia de seguridad programada está inactiva. - - **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. - - Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. - - **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. - - **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: +- **Nunca**: la función de copia de seguridad programada está inactiva. +- **Cada hora**: programa una copia de seguridad automática cada hora, a partir de la hora siguiente. +- Backups periódicos A continuación, puede introducir la hora a la que debe comenzar la copia de seguridad. +- **Todas las semanas**: programa una copia de seguridad automática cada semana. Dos áreas de entrada adicionales le permiten indicar el día y la hora en que debe comenzar la copia de seguridad. +- **Todos los meses**: programa una copia de seguridad automática cada mes. Dos áreas de entrada adicionales le permiten indicar el día del mes y la hora en que debe comenzar la copia de seguridad. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Al seleccionar esta opción, aparecen varias áreas de entrada adicionales: - **Cada X hora(s)**: permite programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24. * **Cada X día(s) a las x**: permite programar las copias de seguridad con una base diaria. Por ejemplo, introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe introducir la hora a la que debe comenzar la copia de seguridad. * **Cada X semana(s) a las x**: permite programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Cuando esta opción está marcada, debe introducir el día(s) de la semana y la hora que debe comenzar la copia de seguridad. Si lo desea, puede seleccionar varios días de la semana. Por ejemplo, puede utilizar esta opción para definir dos copias de seguridad semanales: una el miércoles y otra el viernes. @@ -48,12 +48,12 @@ La página Copia de seguridad/Configuración de las Propiedades permite designar Esta área le permite determinar qué archivos y/o carpetas deben copiarse durante la siguiente copia de seguridad. - - **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: +- **Datos**: archivo de datos de la aplicación. Cuando esta opción está marcada, los siguientes elementos se copian automáticamente al mismo tiempo que los datos: - el archivo de historial actual de la aplicación (si existe), - la carpeta `Settings` completa situada [junto al archivo de datos](../Project/architecture.md#settings-user-data) (si existe), es decir, *los parámetros usuario para los datos*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. - - **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* - - **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". +- **Estructura**: carpetas y archivos proyecto de la aplicación. En el caso de proyectos compilados, esta opción permite hacer una copia de seguridad del archivo .4dz. Cuando esta opción está marcada, se hace una copia de seguridad automática de la carpeta completa `Settings` situada [en el mismo nivel que la carpeta Project](../Project/architecture.md#settings-user), es decir, los *parámetros usuario*. +- **Archivo de estructura usuario (sólo para bases binaria)**: *funcionalidad obsoleta* +- **Adjuntos**: esta área permite especificar un conjunto de archivos y/o carpetas que se respaldarán al mismo tiempo que la aplicación. Estos archivos pueden ser de cualquier tipo (documentos o plantillas de plug-ins, etiquetas, informes, imágenes, etc.). Puede definir archivos individuales o carpetas cuyo contenido se respaldará completamente. Cada elemento adjunto aparece con su ruta de acceso completa en el área "Adjuntos ". - **Eliminar**: retira el archivo seleccionado de la lista de archivos adjuntos. - Gestión del archivo de historial En el caso de una restitución, la carpeta se recuperará con su estructura interna. Puede seleccionar toda carpeta o volumen conectado a la máquina, a excepción de la carpeta que contiene los archivos de la aplicación. - **Añadir archivo...**: muestra una caja de diálogo que permite seleccionar un archivo para añadirlo a la copia de seguridad. @@ -82,19 +82,19 @@ La modificación de las opciones de copia de seguridad y restauración es opcion ### Parámetros generales - - **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). +- **Conservar únicamente los últimos X archivos de copia de seguridad**: este parámetro activa y configura el mecanismo utilizado para eliminar los archivos de copia de seguridad más antiguos, lo que evita el riesgo de saturar la unidad de disco. Esta funcionalidad opera de la siguiente manera: una vez finalizado el backup actual, 4D elimina el archivo más antiguo si se encuentra en la misma ubicación que el archivo del que se está haciendo el backup y tiene el mismo nombre (puede solicitar que el archivo más antiguo se elimine antes del backup para ahorrar espacio). Si, por ejemplo, el número de conjuntos se define en 3, las tres primeras copias de seguridad crean los archivos MyBase-0001, MyBase-0002 y MyBase-0003 respectivamente. Durante la cuarta copia de seguridad, se crea el archivo MyBase-0004 y se elimina MyBase-0001. Por defecto, el mecanismo de eliminación de conjuntos está activado y 4D guarda 3 conjuntos de copia de seguridad. Para desactivar el mecanismo, basta con deseleccionar la opción. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. +- **Copia de seguridad sólo si el archivo de datos ha sido modificado**: cuando se marca esta opción, 4D inicia las copias de seguridad programadas sólo si se han añadido, modificado o eliminado datos desde la última copia de seguridad. De lo contrario, la copia de seguridad programada se cancela y se pospone hasta la siguiente copia de seguridad programada. No se genera ningún error; sin embargo, el diario de copias de seguridad señala que la copia de seguridad se ha pospuesto. Esta opción también permite ahorrar tiempo de máquina para la copia de seguridad de las aplicaciones utilizadas principalmente para su visualización. Tenga en cuenta que al activar esta opción no se tienen en cuenta las modificaciones realizadas en los archivos de estructura o en los archivos adjuntos. > Este parámetro se refiere tanto a las copias de seguridad de la aplicación como de los archivos del historial. - - **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. +- **Eliminar el archivo de copia de seguridad más antiguo antes/después de la copia de seguridad**: esta opción sólo se utiliza si la opción "Conservar sólo los últimos X archivos de copia de seguridad" está marcada. Especifica si 4D debe comenzar borrando el archivo más antiguo antes de iniciar la copia de seguridad (**antes** opción) o si el borrado debe tener lugar una vez finalizada la copia de seguridad (opción **después**). Para que este mecanismo funcione, el archivo más antiguo no debe haber sido renombrado o movido. - - **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. +- **Si falla la copia de seguridad**: esta opción permite configurar el mecanismo utilizado para gestionar las copias de seguridad fallidas (copia de seguridad imposible). Cuando no se puede realizar una copia de seguridad, 4D le permite realizar un nuevo intento. - **Reintentar en la siguiente fecha y hora programada**: esta opción sólo tiene sentido cuando se trabaja con copias de seguridad automáticas programadas. Equivale a anular la copia de seguridad fallida. Se genera un error. - **Reintentar después de X segundo(s), minuto(s) u hora(s)**: cuando se marca esta opción, se ejecuta un nuevo intento de copia de seguridad después del periodo de espera. Este mecanismo permite anticipar ciertas circunstancias que pueden bloquear la copia de seguridad. Puede establecer un periodo de espera en segundos, minutos u horas utilizando el menú correspondiente. Si el nuevo intento también falla, se genera un error y se anota el fallo en el área de estado de la última copia de seguridad y en el archivo del diario de copias de seguridad. - **Cancelar la operación después de X intentos**: este parámetro se utiliza para definir el número máximo de intentos de copia de seguridad fallidos. Si la copia de seguridad no se ha realizado con éxito una vez alcanzado el número máximo de intentos establecido, se cancela y se genera el error 1401 ("Se ha alcanzado el número máximo de intentos de copia de seguridad; la copia de seguridad automática está temporalmente desactivada"). En este caso, no se intentará realizar una nueva copia de seguridad automática mientras no se haya reiniciado la aplicación o se haya realizado con éxito una copia de seguridad manual. @@ -106,15 +106,15 @@ La modificación de las opciones de copia de seguridad y restauración es opcion Estas opciones se aplican a los archivos de copia de seguridad principales y a los archivos de copia de seguridad del historial. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Este funcionamiento permite, por ejemplo, almacenar una copia de seguridad en varios discos diferentes (DVD, dispositivos usb, etc.). Durante la restauración, 4D fusionará automáticamente los segmentos. Cada segmento se llama MyApplication[xxxx-yyyy].4BK, donde xxxx es el número de copia de seguridad e yyyy es el número de segmento. Por ejemplo, los tres segmentos de la copia de seguridad de la base MyApplication se llaman MyApplication[0006-0001].4BK, MyApplication[0006-0002].4BK y MyApplication[0006-0003].4BK. El menú **Tamaño del segmento** es un combo box que permite establecer el tamaño en MB de cada segmento de la copia de seguridad. Puede elegir uno de los tamaños preestablecidos o introducir un tamaño específico entre 0 y 2048. Si se pasa 0, no se produce ninguna segmentación (esto equivale a pasar **Ninguna**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: +- **Compression Rate** By default, 4D compresses backups to help save disk space. Sin embargo, la fase de compresión de archivos puede ralentizar notablemente las copias de seguridad cuando se trata de grandes volúmenes de datos. La opción **Tasa de compresión** permite ajustar la compresión de los archivos: - **Ninguna:** no se aplica ninguna compresión de archivos. La copia de seguridad es más rápida, pero los archivos son considerablemente más grandes. - **Rápido** (por defecto): esta opción es un compromiso entre la velocidad de la copia de seguridad y el tamaño del archivo. - **Compactado**: la tasa de compresión máxima se aplica a los archivos. Los ficheros de archivos ocupan el menor espacio posible en el disco, pero la copia de seguridad se ralentiza notablemente. - - **Tasa de entrelazamiento y tasa de redundancia** +- **Tasa de entrelazamiento y tasa de redundancia** 4D genera archivos utilizando algoritmos específicos que se basan en mecanismos de optimización (entrelazamiento) y seguridad (redundancia). Puedes configurar estos mecanismos en función de sus necesidades. Los menús asociados a estas opciones contienen índices de **Bajo**, **Medio**, **Alto** y **Ninguno** (por defecto). - **Tasa de entrelazamiento**: el entrelazamiento consiste en almacenar los datos en sectores no adyacentes para limitar los riesgos en caso de daño de los sectores. Cuanto mayor sea la tasa, mayor será la seguridad; sin embargo, el procesamiento de datos utilizará más memoria. - **Tasa de redundancia**: la redundancia permite asegurar los datos presentes en un fichero repitiendo varias veces la misma información. Cuanto mayor sea la tasa de redundancia, mayor será la seguridad de los archivos; sin embargo, el almacenamiento será más lento y el tamaño de los archivos aumentará en consecuencia. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md index 7c378f6c26d239..111a7c8b4391b2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md @@ -11,8 +11,8 @@ El lenguaje 4D es compatible con los operadores que ya conoce de otros lenguajes El lenguaje 4D soporta los operadores **binarios** y **ternarios**: - - los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. - - los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). +- los operadores binarios operan en dos objetivos (como `2 + 3`) y aparecen entre sus dos objetivos. +- los operadores ternarios operan en tres objetivos. Like C, 4D has only one ternary operator, the [ternary conditional operator](#ternary-operator) (`a ? b : c`). Los valores que los operadores afectan son los operandos. En la expresión `1 + 2`, el símbolo + es un operador binario y sus dos operandos son los valores 1 y 2. @@ -33,18 +33,18 @@ $col:=New collection //$col se inicializa con una colección vacía Los resultados del operador dependen de los **tipos de datos** a los que se aplican. 4D soporta diferentes operadores en tipos de datos escalares. Se describen con los tipos de datos, en las siguientes secciones: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) - - [**Operadores de fechas**](dt_date.md#operadores-de-fechas) - - [**Operadores de tiempo**](dt_time.md#time-operators) - - [**Operadores de números**](dt_number.md#number-operators) - - [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) - - [**Operadores de imágenes**](dt_picture.md#picture-operators) - - [**Operadores de punteros**](dt_pointer.md#pointer-operators) - - [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) - - [**Operadores en las referencias de objetos**](dt_object.md#object-operators) - - [**Operadores de referencia de colección**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (en expresiones **booleanas**) +- [**Operadores de fechas**](dt_date.md#operadores-de-fechas) +- [**Operadores de tiempo**](dt_time.md#time-operators) +- [**Operadores de números**](dt_number.md#number-operators) +- [**Operadores de bits**](dt_number.md#bitwise-operators) (en expresiones de tipo **entero largo**) +- [**Operadores de imágenes**](dt_picture.md#picture-operators) +- [**Operadores de punteros**](dt_pointer.md#pointer-operators) +- [**Operadores de cadenas**](dt_string.md#operadores-de-cadenas) +- [**Operadores en las referencias de objetos**](dt_object.md#object-operators) +- [**Operadores de referencia de colección**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores Undefined**](dt_null_undefined.md#operadores-undefined) ## Operadores de asignación compuestos @@ -272,9 +272,9 @@ El operador condicional ternario permite escribir expresiones condicionales de u Se necesitan tres operandos en el siguiente orden: - - una condición seguida de un signo de interrogación (?) - - una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) - - una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) +- una condición seguida de un signo de interrogación (?) +- una expresión a ejecutar si la condición es [truthy](#truthy-and-falsy), seguida de dos puntos (:) +- una expresión a ejecutar si la condición es [falsy](#truthy-and-falsy) ### Sintaxis @@ -325,21 +325,21 @@ Además de un tipo, cada valor también tiene un valor booleano inherente, conoc Los siguientes valores son **falsy**: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Cadenas vacías - - [] - Colecciones vacías - - {} - Objetos vacios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Cadenas vacías +- [] - Colecciones vacías +- {} - Objetos vacios Todos los demás valores se consideran **truthy**, incluyendo: - - 0 - cero numérico (Entero u otro) +- 0 - cero numérico (Entero u otro) En 4D, la evaluación **truthy** y **falsy** refleja la **usabilidad** de un valor, lo que significa que un valor truthy existe y puede ser procesado por el código sin generar errores o resultados inesperados. La razón de ser de esto es ofrecer una forma conveniente de manejar valores *undefined* y *null* en objetos y colecciones, de modo que un número reducido de instrucciones [If…Else](flow-control.md#ifelseend-if) sean necesarias para evitar errores de ejecu diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md index 6a6f75713e39cc..a1cc173febeb9b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md @@ -53,8 +53,8 @@ Esta sintaxis solo soporta declaraciones de [variables locales y de proceso](#lo `varType` puede ser: - - un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, - - una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. +- un [tipo básico](Concepts/data-types.md), en cuyo caso la variable contiene un valor del tipo declarado, +- una [referencia de clase](Concepts/classes.md) (clase 4D o clase usuario), en cuyo caso la variable contiene una referencia a un objeto de la clase definida. Si se omite `varType`, se crea una variable de tipo **variant**. @@ -86,7 +86,7 @@ La sintaxis heredada utilizando los comandos `C_XX` es obsoleta a partir de 4D 2 ### Ejemplos - - Para declarar variables básicas locales y de proceso: +- Para declarar variables básicas locales y de proceso: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //también equivalente a C_OBJECT($o) ``` - - Para declarar las variables objeto de la clase 4D: +- Para declarar las variables objeto de la clase 4D: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Para declarar las variables objeto de la clase usuario: +- Para declarar las variables objeto de la clase usuario: ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Una variable local, como su nombre indica, es local a un método, accesible sól Es posible que desee utilizar una variable local para: - - Evitar conflictos con los nombres de otras variables - - Utilizar los datos temporalmente - - Reducir el número de variables proceso +- Evitar conflictos con los nombres de otras variables +- Utilizar los datos temporalmente +- Reducir el número de variables proceso El nombre de una variable local siempre comienza por el signo dólar ($) y puede contener hasta 31 caracteres adicionales. Si introduce un nombre más largo, 4D lo trunca a la longitud adecuada. @@ -224,9 +224,9 @@ En modo interpretado, las variables se mantienen dinámicamente; se crean y se b Un proceso puede leer y escribir las variables proceso de otro proceso utilizando los comandos `GET PROCESS VARIABLE` y `SET PROCESS VARIABLE`. Es una buena práctica de programación restringir el uso de estos comandos a la situación para la que fueron creados en 4D: - - Comunicación interprocesos en lugares específicos de su código - - Gestión de arrastrar y soltar interproceso - - En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras +- Comunicación interprocesos en lugares específicos de su código +- Gestión de arrastrar y soltar interproceso +- En Cliente/Servidor, la comunicación entre los procesos en las máquinas cliente y los procedimientos almacenados ejecutados en las máquinas servidoras Para más información, consulte el capítulo **Procesos** y la descripción de estos comandos. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md index 9ae01abea102b2..b87074b4252a19 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, puede que no haya suficiente memoria para crear un BLOB. O, cuan Estos son generalmente los tipos de errores más difíciles de encontrar. A excepción de los errores de digitación, todos los tipos de errores listados arriba están cubiertos hasta cierto punto por la expresión "error de diseño o de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por ejemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Los errores de diseño o de lógica también incluyen situaciones como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Un método no hace exactamente lo que espera, ya que la presencia de un parámetro opcional no está probada. A veces el código que muestra el error puede ser diferente al código que en realidad es el origen del problema. @@ -55,8 +55,8 @@ Para encontrar rápidamente el origen del problema, vuelva a abrir la versión i La ventana de error de sintaxis aparece automáticamente cuando se interrumpe la ejecución de un método. Esto puede ocurrir cuando: - - un error impide que el código siga ejecutándose - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- un error impide que el código siga ejecutándose +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ El área de texto superior muestra un mensaje describiendo el error. El área de La ventana de error de sintaxis propone varias opciones: - - **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. +- **Modificar**: detiene la ejecución de todos los métodos. 4D cambia al entorno de Diseño y el método con el error se abre en el editor de Código, permitiéndole corregirlo. Utilice esta opción cuando reconozca inmediatamente el error y pueda arreglarlo sin más investigación. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **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. +- **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. :::tip @@ -76,14 +76,14 @@ Para ignorar un error que ocurre repetidamente (por ejemplo, en bucles), puede c ::: - - **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: +- **Abandonar**: detiene la ejecución del método y devuelve al estado antes del inicio de la ejecución del método: - 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. +- **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. - - **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. +- **Guardar...**: guarda el contenido de la ventana de error de sintaxis y la cadena de llamadas en un archivo `.txt`. ## Depurador diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md index 99fd7295b126a7..36a92919469a8b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento se puede utilizar para filtrar la entrada de datos en los objetos ed Cuando se utiliza, este evento se genera después de cada cambio realizado en el contenido de un objeto editable, independientemente de la acción que haya provocado la modificación, *es decir*: - - Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; - - Soltar un valor (acción similar a pegar); - - Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. - - Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). +- Acciones de edición estándar que modifican el contenido como pegar, cortar, borrar o cancelar; +- Soltar un valor (acción similar a pegar); +- Toda entrada de teclado realizada por el usuario; en este caso, el evento `On After Edit` se genera después de los eventos [`On Before Keystroke`](onBeforeKeystroke. d) y [`On After Keystroke`](onAfterKeystroke.md), si se utilizan. +- Cualquier modificación realizada mediante un comando del lenguaje que simule una acción del usuario (es decir, `POST KEY`). Dentro del evento `On After Edit`, los datos de texto que se ingresan son devueltos por el comando [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md index 6600c9ead2a047..fa93861d722f2b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ El evento de formulario `On Begin Drag Over` puede ser seleccionado para todos l El evento `On Begin Drag Over` es útil para preparar la acción de arrastrar. Puede utilizarse para: - - Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). - - Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). - - Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. +- Añadir los datos y las firmas al portapapeles (vía el comando `APPEND DATA TO PASTEBOARD`). +- Utilizar un icono personalizado durante la acción de arrastre (vía el comando `SET DRAG ICON`). +- Aceptar o rechazar el arrastre mediante el resultado del método del objeto arrastrado. - Para indicar que las acciones de arrastre son aceptadas, el método del objeto fuente debe devolver 0 (cero). - Para indicar que se rechazan las acciones de arrastrar, el método del objeto fuente debe devolver -1 (menos uno). - Si no se devuelve ningún resultado, 4D considera que las acciones de arrastre son aceptadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md index 21c7b1ccab37e5..40ba861bc720a5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. Sin embargo, hay varias excepciones: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md index da0b5c023d90fb..7b623c81af91d8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un registro está a punto de ser visualizado en un formulario de lista que se mu En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada registro: +- Para cada registro: - Para cada objeto en el área detallada: - Método objeto con el evento `On Display Detail` - Método formulario con el evento `On Display Detail` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md index 6b828dc261f3b0..5b1c5186896b9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over El evento `On Drag Over` se envía repetidamente al objeto de destino cuando el puntero del ratón se mueve sobre el objeto. Normalmente, en respuesta a este evento: - - Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). - - Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. +- Obtenga los datos y las firmas que se encuentran en portapapeles (mediante el comando `GET PASTEBOARD DATA`). +- Según la naturaleza y el tipo de datos en el portapapeles, se **acepta** o **rechaza** el arrastrar y soltar. Para **aceptar** el arrastrar, el método del objeto de destino debe devolver 0 (cero). Para **rechazar** el arrastrar, el método de objeto debe retornar -1 (menos uno). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md index 22491caa86174f..07196347369ba7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza En este contexto, se desencadena la siguiente secuencia de llamadas a métodos y eventos de formulario: - - Para cada objeto en el área del encabezado: +- Para cada objeto en el área del encabezado: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md index 4193db89f0ecc0..c09175fbd2a07b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Este evento se genera cuando se hace clic en el encabezado de una columna de lis Si se seleccionó la propiedad [Sortable](FormObjects/properties_Action.md#sortable) para el list box, se puede decidir si se autoriza o no una ordenación estándar de la columna pasando el valor 0 o -1 en la variable `$0`: - - Si `$0` es igual a 0, se realiza una ordenación estándar. - - Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. +- Si `$0` es igual a 0, se realiza una ordenación estándar. +- Si `$0` es igual a -1, no se realiza una ordenación estándar y el encabezado no muestra la flecha de ordenación. El desarrollador puede seguir generando una ordenación de columnas basada en criterios de ordenación personalizados utilizando el lenguaje 4D. Si la propiedad [Sortable](FormObjects/properties_Action.md#sortable) no está seleccionada para el list box, la variable `$0` no se utiliza. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md index a12a7f4383b866..f780ef9be2a24d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md @@ -9,16 +9,16 @@ Los formularios ofrecen la interfaz a través de la cual se introduce, modifica Los formularios también pueden contener otros formularios a través de las siguientes funcionalidades: - - [objetos de subformulario](FormObjects/subform_overview.md) - - [formularios heredados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulario](FormObjects/subform_overview.md) +- [formularios heredados](./properties_FormProperties.md#inherited-form-name) ## Creación de formularios Puede añadir o modificar formularios 4D utilizando los siguientes elementos: - - **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. - - **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. - - **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: +- **La interfaz 4D Developer:** cree nuevos formularios desde el menú **Archivo** o la ventana del **Explorador**. +- **El editor de formularios**: modifique sus formularios utilizando el **[editor de formularios](FormEditor/formEditor.md)**. +- **El código JSON:** cree y diseñe sus formularios utilizando JSON y guarde los archivos de los formularios en la [ubicación adecuada](Project/architecture#sources). Ejemplo: ``` { @@ -70,9 +70,9 @@ Puede añadir o modificar formularios 4D utilizando los siguientes elementos: Hay dos categorías de formularios: - - **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. +- **Los formularios de proyecto** - Formularios independientes que no están unidos a ninguna tabla. Están pensados, sobre todo, para crear cajas de diálogo de interfaz, al igual que componentes. Los formularios proyecto pueden utilizarse para crear interfaces que cumplan fácilmente con los estándares del sistema operativo. - - **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. +- **Los formularios tablas** - Se adjuntan a tablas específicas y, por tanto, se benefician de funciones automáticas útiles para el desarrollo de aplicaciones basadas en bases de datos. Normalmente, una tabla tiene formularios de entrada y salida separados. Normalmente, se selecciona la categoría del formulario al crearlo, pero se puede cambiar después. @@ -80,15 +80,15 @@ Normalmente, se selecciona la categoría del formulario al crearlo, pero se pued Cada formulario consta de al menos dos páginas: - - una página 1: una página principal, mostrada por defecto - - una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. +- una página 1: una página principal, mostrada por defecto +- una página 0: una página de fondo, cuyo contenido se muestra en todas las demás páginas. Puede crear varias páginas para un formulario de entrada. Si tiene más campos o variables de los que caben en una pantalla, puede crear páginas adicionales para mostrarlos. Las páginas múltiples le permiten hacer lo siguiente: - - Coloque la información más importante en la primera página y la menos importante en otras. - - Organice cada tema en su propia página. - - Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). - - Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. +- Coloque la información más importante en la primera página y la menos importante en otras. +- Organice cada tema en su propia página. +- Reducir o eliminar el desplazamiento durante la entrada de datos definiendo el [orden de entrada](formEditor.md#data-entry-order). +- Deje espacio alrededor de los elementos del formulario para lograr un diseño de pantalla atractivo. Las páginas múltiples son útiles sólo para los formularios de entrada. No son para imprimir. Cuando se imprime un formulario de varias páginas, sólo se imprime la primera. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md index a549dcc06d28ca..b56b453cb2a0a2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md @@ -7,11 +7,11 @@ El editor de formularios 4D soporta macros. Una macro es un conjunto de instrucc Por ejemplo, si tiene un informe recurrente con un formato específico (por ejemplo, cierto texto debe aparecer en rojo y cierto texto debe aparecer en verde), puede crear una macro para definir automáticamente el color. Puede crear macros para el editor de formularios 4D que pueden: - - Crear y ejecutar código 4D - - Mostrar las cajas de diálogo - - Seleccione los objetos de formulario - - Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades - - Modificar los archivos del proyecto (actualizar, eliminar) +- Crear y ejecutar código 4D +- Mostrar las cajas de diálogo +- Seleccione los objetos de formulario +- Añadir / eliminar / modificar los formularios, los objetos de formulario así como sus propiedades +- Modificar los archivos del proyecto (actualizar, eliminar) El código de las macros soporta [funciones de clase](Concepts/classes.md) y las [propiedades de objeto de formulario en JSON](FormObjects/properties_Reference.md) para permitir definir toda funcionalidad personalizada en el editor de formularios. @@ -238,9 +238,9 @@ Por ejemplo, si los objetos de la página actual y de los grupos han sido modifi Cuando se maneja el atributo `method` de los objetos de formulario, se puede definir el valor del atributo de dos maneras en las macros: - - Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). +- Utilizando una [cadena que contiene el nombre/ruta del archivo del método](FormObjects/properties_Action.md#method). - - Utilizando un objeto con la siguiente estructura: +- Utilizando un objeto con la siguiente estructura: | Propiedad | Tipo | Descripción | | --------- | ---- | ----------------- | @@ -252,9 +252,9 @@ Cuando se maneja el atributo `method` de los objetos de formulario, se puede def La propiedad `$4dId` define un ID único para cada objeto de la página actual. Esta clave es utilizada por el procesador de macros para controlar los cambios en `$result.currentPage`: - - si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. - - si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. - - si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. +- si la llave `$4dId` falta tanto en el formulario y en un objeto en `$result`, el objeto se crea. +- si la llave `$4dId` existe en el formulario pero falta en `$result`, el objeto se elimina. +- si la llave `$4dId` existe tanto en el formulario y en un objeto en `$result`, el objeto se modifica. #### Ejemplo @@ -297,8 +297,8 @@ La función `onError` se ejecuta cuando el procesador de macros encuentra un err Cuando se ejecuta una macro, si 4D encuentra un error que impide la cancelación de la macro, no la ejecuta. Es el caso, por ejemplo, de que la ejecución de una macro resulte en: - - borrar o modificar un script cuyo archivo es de sólo lectura. - - crear dos objetos con el mismo ID interno. +- borrar o modificar un script cuyo archivo es de sólo lectura. +- crear dos objetos con el mismo ID interno. #### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md index 09f69812c3b672..bea03bd3c7bafa 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Puede utilizar librerías de objetos en sus formularios. Una librería de objeto 4D propone dos tipos de librerías de objetos: - - una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. - - librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. +- una librería de objetos estándar y preconfigurada, disponible en todos sus proyectos. +- librerías de objetos personalizadas, que puede utilizar para almacenar sus objetos formularios favoritos o formularios proyecto completos. ## Utilización de la librería de objetos estándar @@ -21,10 +21,10 @@ La librería se muestra en una ventana aparte: La ventana tiene las siguientes características principales: - - Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. - - Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: +- Área de vista previa con mensajes de ayuda: el área central muestra una vista previa de cada objeto. Puede pasar el ratón por encima de un objeto para obtener información sobre el mismo en un mensaje de ayuda. +- Puede filtrar el contenido de la ventana utilizando el menú **Categorías**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar un objeto de la librería en su formulario, puede: +- Para utilizar un objeto de la librería en su formulario, puede: - hacer clic derecho en un objeto y seleccionar **Copiar** en el menú contextual - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Una determinada librería de objetos sólo puede ser abierta por un proyecto a l Para abrir una librería de objetos personalizada, seleccione el comando **Abrir>Librería de objetos...** en el menú **Archivo** o en la barra de herramientas de 4D. Aparece una caja de diálogo estándar para abrir archivos, que le permite seleccionar la librería de objetos que desea abrir. Puede seleccionar los siguientes tipos de archivos: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** De hecho, las librerías de objetos personalizadas son proyectos 4D clásicos. Sólo se exponen las siguientes partes de un proyecto cuando se abre como librería: - - formularios proyecto - - páginas formulario 1 +- formularios proyecto +- páginas formulario 1 ### Crear una librería de objetos @@ -74,10 +74,10 @@ Las principales operaciones están disponibles en el menú contextual o en el me ![](../assets/en/FormEditor/library5.png) - - **Cortar** o **Copiar** al portapapeles - - **Pegar** un objeto del tablero portapapeles - - **Borrar** - elimina el objeto de la librería - - **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. +- **Cortar** o **Copiar** al portapapeles +- **Pegar** un objeto del tablero portapapeles +- **Borrar** - elimina el objeto de la librería +- **Renombrar** - aparece una caja de diálogo que permite cambiar el nombre del elemento. Tenga en cuenta que los nombres de los objetos deben ser únicos en una librería. Puede colocar objetos individuales (incluidos los subformularios) o conjuntos de objetos en una librería de objetos. Cada objeto o conjunto se agrupa en un solo elemento: @@ -93,9 +93,9 @@ El uso de copiar y pegar o arrastrar y soltar con ciertos objetos de librería t A continuación se muestra una lista de objetos dependientes que se pegarán en la librería al mismo tiempo que el objeto principal que los utiliza (cuando corresponda): - - Listas - - Formatos/Filtros - - Imágenes - - Mensajes de ayuda (asociados a un campo) - - Métodos objeto +- Listas +- Formatos/Filtros +- Imágenes +- Mensajes de ayuda (asociados a un campo) +- Métodos objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md index d1186f42277c5b..364e7ce2ee9c52 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Las opciones de tamaño dependen del valor de la opción **Tamaño basado en**. ## Tamaño basado en - - **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). +- **Tamaño automático**: el tamaño del formulario será el necesario para mostrar todos los objetos, al que se añadirán los valores de margen (en píxeles) introducidos en los campos [**Margen Hor**](#hor-margin) y [**Margen Vertical**](#vert-margin). Puede elegir esta opción cuando desee utilizar objetos activos situados en un área fuera de la pantalla (*es decir*, fuera del rectángulo delimitador de la ventana) con una ventana de tamaño automático. Gracias a esta opción, la presencia de estos objetos no modificará el tamaño de la ventana. - - **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). +- **Definir tamaño**: el tamaño del formulario se basará en lo que introduzca (en píxeles) en los campos [**Ancho**](#width) y [**Alto**](#height). - - ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. +- ``: el tamaño del formulario se basará en la posición del objeto formulario seleccionado. Por ejemplo, si elige un objeto situado en la parte inferior derecha del área a mostrar, el tamaño del formulario consistirá en un rectángulo cuya esquina superior izquierda será el origen del formulario y la esquina inferior derecha corresponderá a la del objeto seleccionado, más los valores de los márgenes. > Para los formularios de salida, sólo están disponibles los campos [**Margen horizontal**](#hor-margin) o [**Ancho**](#width). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md index 1391eda981bb2a..fba2d1eb026abc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Usted crea y personaliza los formularios de su aplicación manipulando los objet Los formularios 4D soportan una gran cantidad de objetos **activos** y **estáticos** integrados: - - **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. - - **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. +- **Los objetos activos** realizan una tarea o una función de la interfaz. Los campos son objetos activos. Los otros objetos activos -objetos editable (variables), combo box, listas desplegables, botones imagen, etc.- almacenan los datos temporalmente en la memoria o realizan alguna acción, como abrir una caja de diálogo, imprimir un informe o iniciar un proceso en segundo plano. +- **Los objetos estáticos** se utilizan generalmente para definir la apariencia del formulario y sus etiquetas, así como para la interfaz gráfica. Los objetos estáticos no tienen variables asociadas como los objetos activos. Sin embargo, se pueden insertar objetos dinámicos en objetos estáticos. ## Gestión de objetos de formulario Puede añadir o modificar objetos formulario 4D de las siguientes maneras: - - **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. +- **[Editor de formularios](FormEditor/formEditor.md):** arrastre un objeto de la barra de herramientas del editor de formularios al formulario. A continuación, utilice la Lista de propiedades para especificar las propiedades del objeto. - - Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. +- Lenguaje **4D**: los comandos del tema `Objects (Forms)` como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) o [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) permiten crear y definir objetos de formulario. - - **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). +- **Código JSON en formularios dinámicos:** define las propiedades utilizando JSON. Utilice la propiedad [type](properties_Object.md#type) para definir el tipo de objeto y, a continuación, defina sus [propiedades disponibles](properties_Reference.md). Ejemplo para un objeto botón: ```json diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md index cc97f98fa863f3..faa4c83bdfbc27 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md @@ -44,6 +44,6 @@ Puede gestionar los datos con los [métodos](Concepts/methods.md) objeto o formu También puede representar expresiones de campos y de variables en sus formularios utilizando objetos alternativos, más concretamente: - - Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). - - Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). - - Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). \ No newline at end of file +- Puede mostrar e introducir datos de los campos de la base directamente en las columnas [de tipo List box](listbox_overview.md). +- Puede representar un campo de lista o una variable directamente en un formulario utilizando los objetos [Menús desplegables/Listas desplegables](dropdownList_Overview.md) y [Combo Box](comboBox_overview.md). +- Puede representar una expresión booleana como una [casilla de selección](checkbox_overview.md) o como un objeto [botón radio](radio_overview.md). \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md index bdcdb932db5ef1..fc2a7f771d3939 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Cuando corresponda, el icono desplegar/contraer se mostrará automáticamente a El contenido de un objeto formulario lista jerárquica se puede inicializar de una de las siguientes maneras: - - Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. - - Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. +- Asociar una [lista de opciones](properties_DataSource.md#choice-list) existente al objeto. La lista de elección debe haber sido definida en el editor de listas en modo Diseño. +- Asigne directamente una referencia de lista jerárquica a la [variable o expresión](properties_Object.md#variable-or-expression) asociada al objeto formulario. En ambos casos, se gestiona una lista jerárquica en tiempo de ejecución a través de su referencia *ListRef*, utilizando los comandos [lista jerárquica](../commands/theme/Hierarchical_Lists.md) del lenguaje 4D. @@ -34,9 +34,9 @@ mylist:=New list Cada representación de la lista tiene sus propias características específicas y comparte características comunes con todas las demás representaciones. Las siguientes características son específicas de cada representación de la lista: - - La selección, - - El estado desplegado/colapsado de sus elementos, - - La posición del cursor de desplazamiento. +- La selección, +- El estado desplegado/colapsado de sus elementos, +- La posición del cursor de desplazamiento. Las otras características (fuente, tamaño de fuente, estilo, control de entrada, color, contenido de la lista, iconos, etc.) son comunes a todas las representaciones y no se pueden modificar por separado. Por consiguiente, cuando se utilizan comandos basados en la configuración expandida/colapsada o en el elemento actual, por ejemplo `Count list items` (cuando no se pasa el parámetro final `*`), es importante poder especificar la representación que se utilizará sin ninguna ambigüedad. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Al igual que con otros comandos de gestión de propiedades de objetos, es posible utilizar el carácter "@" en el parámetro `NomLista`. Por regla general, esta sintaxis se utiliza para designar un conjunto de objetos del formulario. Sin embargo, en el contexto de los comandos de listas jerárquicas, esto no se aplica en todos los casos. Esta sintaxis tendrá dos efectos diferentes según el tipo de comando: - - Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." +- Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: +- Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Al igual que con otros comandos de gestión de propiedades de objetos, es posibl Es posible modificar la apariencia de una lista jerárquica en un formulario utilizando varios comandos 4D genéricos. Puede pasar a estos comandos el nombre del objeto de la lista jerárquica (utilizando el parámetro \*), o su nombre de variable (que contiene el valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Recordatorio: excepto `OBJECT SET SCROLL POSITION`, estos comandos modifican todas las representaciones de una misma lista, aunque sólo se especifique una lista a través de su nombre de objeto. @@ -107,8 +107,8 @@ Este principio se aplica independientemente del orden de llamada de los comandos Normalmente se puede trabajar de dos maneras con el contenido de las listas jerárquicas: por posición o por referencia. - - Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. - - Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. +- Cuando se trabaja por posición, 4D se basa en la posición con respecto a los elementos de la lista que aparecen en pantalla para identificarlos. El resultado será diferente según se expandan o colapsen determinados elementos jerárquicos. Tenga en cuenta que en el caso de las representaciones múltiples, cada objeto formulario tiene su propia configuración de elementos expandidos/colapsados. +- Cuando se trabaja por referencia, 4D se basa en el número de identificación *itemRef* de los elementos de la lista. Así, cada elemento puede especificarse individualmente, independientemente de su posición o de su visualización en la lista jerárquica. ### Utilizar los números de referencia de los artículos (itemRef) @@ -141,9 +141,9 @@ Básicamente, es necesario tratar con los números de referencia de los elemento Puede controlar si los elementos de la lista jerárquica pueden ser modificados por el usuario utilizando el atajo de teclado **Alt+clic**(Windows) / **Opción+clic** (macOS), o realizando una pulsación larga sobre el texto del elemento. - - Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). +- Sea cual sea la fuente de datos de la lista jerárquica, puede controlar todo el objeto con la propiedad [Editable](properties_Entry.md#enterable). - - Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Además, si llena la lista jerárquica utilizando una lista creada en el editor de listas, puede controlar si un elemento de una lista jerárquica es modificable mediante la opción **Elemento modificable** del editor de listas. Para más información, consulte [Definir las propiedades de la lista](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md index 034511204b47ad..5883f90891be86 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ Especifica si el usuario puede eliminar subregistros en un subformulario listado Esta propiedad se utiliza para declarar el formulario detallado que se utilizará en el subformulario. Puede ser: - - un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ +- un widget, es decir, un subformulario de tipo página dotado de funciones específicas. En este caso, las propiedades [list subform](#list-form) y [Source](#source) deben estar vacías o no estar presentes.\ Puede seleccionar un nombre de formulario de componente cuando se publica en el componente. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). El formulario detallado puede utilizarse para introducir o ver los subregistros. Generalmente contiene más información que el subformulario lista. Naturalmente, el formulario detallado debe pertenecer a la misma tabla que el subformulario. Normalmente se utiliza un formulario de salida como formulario lista y un formulario de entrada como formulario detallado. Si no especifica el formulario a utilizar para la entrada de la página completa, 4D utiliza automáticamente el formato de entrada por defecto de la tabla. #### Gramática JSON @@ -48,8 +48,8 @@ Esta propiedad se utiliza para declarar el formulario detallado que se utilizar Acción a realizar en caso de doble clic en una línea vacía de un subformulario listado. Las siguientes opciones están disponibles: - - No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- No hacer nada (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- Añadir registro: crea un nuevo registro en el subformulario y cambia al modo edición. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -73,9 +73,9 @@ Acción a realizar en caso de doble clic en una línea vacía de un subformulari Define la acción a realizar cuando un usuario haga doble clic en una línea en un subformulario lista. Las opciones disponibles son: - - **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. - - **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. +- **No hacer nada** (por defecto): hacer doble clic en una línea no desencadena ninguna acción automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. El registro se abre en modo de lectura-escritura para que pueda ser modificado. +- **Mostrar registro**: idéntica a la acción anterior, salvo que el registro se abre en modo de sólo lectura para que no pueda ser modificado. Independientemente de la acción seleccionada/elegida, se genera el evento de formulario `On Double clicked`. @@ -153,10 +153,10 @@ Especifica la tabla a la que pertenece el subformulario Lista (si la hay). Designa la opción para permitir a los usuarios seleccionar líneas: - - **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. - - **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ +- **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. +- **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una fila cambia su estado (entre seleccionado o no).\ Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que se cambia la línea actual. - - **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. +- **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Al hacer clic en el registro se selecciona, pero no se modifica el registro actual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). Las teclas de flecha arriba y abajo seleccionan el registro anterior/siguiente en la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md index cc8d6b7e0fd9cc..c6822aab4fdc97 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Las formas son [objetos estáticos](formObjects_overview.md#active-and-static-ob Se ofrecen las siguientes formas básicas: - - rectángulos - - líneas - - óvalos +- rectángulos +- líneas +- óvalos ## Rectángulo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md index 8d9dc854e98bd2..44dd6b6649dcfd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md @@ -11,10 +11,10 @@ Los separadores se utilizan, por ejemplo, en los formularios de salida para pode Algunas de las características generales del separador: - - Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. - - Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. - - Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. +- Puede colocar tantos separadores como desee en todo tipo de formulario y utilizar una mezcla de separadores horizontales y verticales en el mismo formulario. +- Un separador puede cruzar (superponer) un objeto. Este objeto cambiará de tamaño cuando se mueva el separador. +- Los topes de los separadores se calculan para que los objetos desplazados permanezcan totalmente visibles en el formulario o no pasen por debajo/al lado de otro separador. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Si se redimensiona un formulario mediante un separador, las nuevas dimensiones del formulario se guardan sólo mientras se muestra el formulario. Una vez que se cierra un formulario, se restablecen las dimensiones iniciales. Una vez insertado, el separador aparece como una línea. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variable se puede utilizar en su objeto y/o métodos de formulario. Su valor indica la posición actual del separador, en píxeles, en relación con su posición inicial. - - Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, - - Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, - - Si el valor es 0: el separador se ha movido a su posición original. +- Si el valor es negativo: el separador se ha movido hacia arriba o hacia la izquierda, +- Si el valor es positivo: el separador se ha movido hacia el fondo o hacia la derecha, +- Si el valor es 0: el separador se ha movido a su posición original. También puede mover el separador por programación: sólo tiene que definir el valor de la variable asociada. Por ejemplo, si un separador vertical está asociado a una variable llamada `split1`, y si se ejecuta la siguiente sentencia:`split1:=-10`, el separador se moverá 10 píxeles a la izquierda - como si el usuario lo hiciera manualmente. El movimiento se realiza realmente al final de la ejecución del método del formulario u objeto que contiene la instrucción. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md index abeae293a04be7..eba6d2a41dabd2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md @@ -13,11 +13,11 @@ Puede asignar la variable asociada al objeto a un área introducible (campo o va Se puede asociar un stepper directamente a una variable numérica, hora o fecha. - - Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: +- Para los valores de tipo hora, las propiedades Mínimo, Máximo y Paso representan segundos. Por ejemplo, para programar un paso de 8:00 a 18:00 con pasos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [máximo](properties_Scale.md#máximo) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. +- Para los valores de tipo fecha, el valor introducido en la propiedad [step](properties_Scale.md#step) representa días. Las propiedades Mínimo y Máximo se ignoran. > Para que el stepper funcione con una variable de hora o fecha, es imprescindible definir su tipo en el formulario Y para [declararla explícitamente](../Concepts/variables.md#declaring-variables) como `Time` o `Date`. @@ -29,8 +29,8 @@ Para más información, consulte [Uso de indicadores](progressIndicator.md#using ## Ver también - - [indicadores de progreso](progressIndicator.md) - - [rulers](ruler.md) +- [indicadores de progreso](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md index e57f6f3248c56a..c06a9428ab317f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un subformulario es un formulario incluido en otro formulario. Con el fin de definir claramente los conceptos implementados con los subformularios, aquí hay algunas definiciones para ciertos términos utilizados: - - **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. - - **Formulario padre**: un formulario que contiene uno o más subformularios. - - **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. - - **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. - - **Formulario listado**: instancia de subformulario mostrada como una lista. - - **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. +- **Subformulario**: un formulario destinado a ser incluido en otro formulario, llamado a su vez formulario padre. +- **Formulario padre**: un formulario que contiene uno o más subformularios. +- **Contenedor de subformulario**: un objeto incluido en el formulario padre, que muestra una instancia del subformulario. +- **Instancia de subformulario**: la representación de un subformulario en un formulario padre. Este concepto es importante porque es posible mostrar varias instancias del mismo subformulario en un formulario padre. +- **Formulario listado**: instancia de subformulario mostrada como una lista. +- **Formulario detallado**: formulario de entrada tipo página asociado a un subformulario tipo lista al que se accede haciendo doble clic en la lista. ## Sub-formularios en lista @@ -43,8 +43,8 @@ Puede vincular [una variable o una expresión](properties_Object.md#variable-or- Por defecto, 4D crea una variable o expresión de [tipo objeto](properties_Object.md#expression-type) para un contenedor de subformulario, lo cual le permite compartir valores en el contexto del subformulario utilizando el comando `Form`. Sin embargo, puede utilizar una variable o expresión de cualquier tipo escalar (tiempo, entero, etc.) especialmente si sólo necesita compartir un único valor: - - Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. +- Defina una variable ligada o una expresión de tipo escalar y llame a los comandos `OBJECT Get subform container value` y `OBJECT SET SUBFORM CONTAINER VALUE` para intercambiar valores cuando se produzcan los eventos de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) o [On Data Change](../Events/onDataChange.md). Esta solución se recomienda para sincronizar un solo valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solución se recomienda para sincronizar varios valores. ### Sincronizando formulario padre y subformulario (valor único) @@ -58,8 +58,8 @@ En el formulario padre, ambos objetos (área de entrada y contenedor subformular Para mostrar una hora estática, debe utilizar el [tipo de datos](properties_DataSource.md#data-type-expression-type) apropiado para la [variable o la expresión](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. El valor del texto debe tener el formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor - - si el subformulario pertenece a la página formulario actual o a la página 0. +- en cuanto se asigna un valor a la variable/expresión del formulario padre, incluso si se reasigna el mismo valor +- si el subformulario pertenece a la página formulario actual o a la página 0. Tenga en cuenta que, como en el ejemplo anterior, es preferible utilizar el comando `OBJECT Get subform container value` que devuelve el valor de la expresión en el contenedor del subformulario en lugar de la propia expresión, ya que es posible insertar varios subformularios en el mismo formulario padre (por ejemplo, una ventana que muestra diferentes zonas horarias contiene varios relojes). La modificación de la variable o expresión asociada desencadena eventos de formulario que permiten sincronizar los valores del formulario padre y del subformulario: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Actualizar el contenido de un formulario padre @@ -170,8 +170,8 @@ La comunicación entre el formulario padre y las instancias del subformulario pu 4D ha implementado los siguientes mecanismos para satisfacer estas necesidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md index 15cc1db6001b65..bc49bec408f392 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md @@ -42,9 +42,9 @@ En macOS, además de la posición estándar (arriba), los controles de las pesta Para suministrar las etiquetas de un control de pestañas, puede utilizar: - - un objeto - - una lista de selección - - un array +- un objeto +- una lista de selección +- un array ### Utilizar un objeto diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md index 2a64dd60b222cf..ee918a3624a6ab 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md @@ -33,9 +33,9 @@ Una vez que un texto está rotado, puede seguir cambiando su tamaño o posición ![](../assets/en/FormObjects/staticText2.png) - - Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); - - Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); - - Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). +- Si el objeto se redimensiona en la dirección A, se modifica su [ancho](properties_CoordinatesAndSizing.md#width); +- Si el objeto se redimensiona en la dirección C, se modifica su [alto](properties_CoordinatesAndSizing.md#height); +- Si el objeto se redimensiona en la dirección B, se modifican tanto su [ancho](properties_CoordinatesAndSizing.md#width) como su [alto](properties_CoordinatesAndSizing.md#height). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md index 506e5e8302c911..4e2875e55b870d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operación registrada en el archivo de registro aparece como una línea. La Esta información permite identificar la fuente y el contexto de cada operación: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: +- **Acción**: tipo de operación realizada sobre los datos. Esta columna puede contener una de las siguientes operaciones: - Apertura del archivo de datos: apertura de un archivo de datos. - Cierre del archivo de datos: cierre de un archivo de datos abierto. - Creación de un contexto: creación de un proceso que especifica un contexto de ejecución. @@ -30,24 +30,24 @@ Esta información permite identificar la fuente y el contexto de cada operación - Cancelación de transacción: transacción cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde al contexto de la operación. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. En modo cliente-servidor, se muestra el nombre de la máquina del lado del cliente; en el modo monopuesto, se muestra el nombre del usuario de la sesión. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Si se define un alias para el usuario, el alias se muestra en lugar del nombre de usuario 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Los valores están separados por ";". Solo se muestran los valores representados en forma alfanumérica.\ ***Nota:** si la base de datos está encriptada y no se ha proporcionado una llave de datos válida correspondiente al archivo de historial abierto, los valores encriptados no se muestran en esta columna.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). El botón Navegar puede utilizarse para seleccionar y abrir otro archivo de historial para la aplicación. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md index a14e13e028dc92..8ffaf959dad8a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del El área "Registros encontrados en el archivo de datos" incluye dos tablas que resumen la información del análisis del archivo de datos. - - La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: +- La primera tabla lista la información del análisis del archivo de datos. Cada línea muestra un grupo de registros recuperables en el archivo de datos: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Los nombres de las tablas asignadas automáticamente aparecen en verde. Los grupos no asignados, es decir, las tablas a las que no se ha podido asociar ningún registro, aparecen en rojo. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por defecto, esta opción está marcada para todos los grupos con registros que pueden asociarse a una tabla. - - La segunda tabla lista las tablas del archivo del proyecto. +- La segunda tabla lista las tablas del archivo del proyecto. ### Asignación manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Una vez finalizada la reparación, 4D genera un archivo de registro en la carpeta Logs del proyecto. Este archivo permite ver todas las operaciones realizadas. Se crea en formato XML y se llama: *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" donde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md index 8d9156ae2168c7..9f4d67cf863b7f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal En el editor de menús, puede introducir directamente la etiqueta como "fijo". También puede introducir una referencia para una variable o un elemento XLIFF, lo que facilitará el mantenimiento y la traducción de las aplicaciones. Puede utilizar los siguientes tipos de referencias: - - Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Una referencia a un recurso XLIFF del tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. Si se cambia el contenido de esta variable, se modificará la etiqueta del menú cuando se muestre. En este caso, la etiqueta llamará a un recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ La elección entre asociar una acción estándar o un método proyecto a un coma Puede asignar un método proyecto y/o una acción estándar a un comando de menú seleccionado en el editor de menú: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. Si el método proyecto no existe, introduzca su nombre en el combo "Nombre del método" y haga clic en el botón [...] button. 4D muestra un diálogo de creación de método proyecto que se utiliza para acceder al editor de código. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Puede introducir toda acción soportada y (opcionalmente) el parámetro que desee en el área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Puede añadir atajos de teclado a todo comando de menú. Si un comando de menú También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Esto multiplica el número de accesos directos que se pueden utilizar. Por lo tanto, se pueden definir los siguientes tipos de atajos de teclado: - - En Windows: +- En Windows: - Ctrl+caracter - Ctrl+Mayús+letra - Ctrl+Alt+caracter - Ctrl+Mayús+Alt+letra - - En macOS: +- En macOS: - Comando+letra - Comando+Mayús+letra - Comando+Opción+letra diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md index ab9d10e1b7e0bd..ced4cb58f129f5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md @@ -9,19 +9,19 @@ Lea [**Novedades en 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-20-R9/), #### Lo más destacado - - Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). - - El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Los comandos y constantes obsoletos ahora generan warnings específicos en el [Live Checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). - - Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. - - Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. - - Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. - - Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. - - Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. - - La [*biblioteca MeCab*](../settings/database.md#support-of-mecab-japanese-version) (utilizada para ordenar/buscar en idioma japonés) ahora está obsoleta y su soporte se eliminará en la próxima versión. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. +- Soporte de [token de sesión](../WebServer/sessions.md#session-token-otp) manejado con las nuevas funciones [`Session.createOTP()`](../API/SessionClass.md#createotp) y [`Session.restore()`](../API/SessionClass.md#restore). +- El asistente de etiqueta ahora utiliza el editor de Fórmula para añadir o editar fórmulas en el [área de diseño de etiquetas](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Los comandos y constantes obsoletos ahora generan warnings específicos en el [Live Checker y el compilador](../code-editor/write-class-method.md#warnings-and-errors). Puede saber si un comando está obsoleto utilizando el comando [`Command name`](../commands/command-name.md). +- Nuevos comandos [WA SET CONTEXT](../commands/wa-set-context.md) y [WA Get context](../commands/wa-get-context.md) para controlar los contenidos [$4d](../FormObjects/webArea_overview.md#4d-object) en áreas web. +- Nuevo [parámetro de base de datos `RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para optimizar por ejemplo el portapapeles compartidos cuando se usa el protocolo de escritorio remoto con 4D. +- Los componentes interpretados pueden ahora [editarse desde el proyecto local](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) ahora se actualizan automáticamente al iniciar. +- Nuevo [componente AIKit 4D](../aikit/overview.md) que permite la interacción con las API IA de terceros. +- Los siguientes retrollamadas del comando VP ahora esperan que todas las funciones personalizadas de 4D completen sus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), y [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nuevas funcionalidades [4D Netkit](https://developer.4d.com/4D-NetKit/) para administrar los calendarios Google y Microsoft 365; capacidad para usar el servidor web local para autenticación OAuth 2.0. +- La [*biblioteca MeCab*](../settings/database.md#support-of-mecab-japanese-version) (utilizada para ordenar/buscar en idioma japonés) ahora está obsoleta y su soporte se eliminará en la próxima versión. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos los bugs que se han corregido en 4D 20 R9. ## 4D 20 R8 @@ -29,29 +29,29 @@ Lea [**Novedades en 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d-20-R8/), #### Lo más destacado - - Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). - - Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). - - Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. - - [Nueva arquitectura de los componentes generados](../Desktop/building.md#build-component) para un mejor cumplimiento de las directrices de notarización de Apple. - - Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#build-an-evaluation-application) en el cuadro de diálogo de Build App. - - Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. - - Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) para un registro detallado de eventos TCP. - - Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. - - 4D Write Pro: +- Implemente sus propios [**HTTP request handlers**](../WebServer/http-request-handler.md) utilizando la nueva clase [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Las expresiones utilizadas en [propiedades de objetos de formulario](../FormObjects/properties_Reference.md) ahora se benefician de la comprobación de sintaxis en la [Lista de propiedades](../FormEditor/formEditor.md#property-list) y en el [Compilador](../Project/compiler.md#check-syntax). +- Puede [asociar una clase a un formulario](../FormEditor/properties_FormProperties.md#form-class) para habilitar la anticipación del tipo de código y la instanciación automática de los datos del formulario cuando utilice el comando [`Form`](../commands/form.md). +- Soporte de [sesiones autónomas](../API/SessionClass.md) para simplificar la codificación local de aplicaciones cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): nuevo diseño y autoguardado, funciones de modo de visualización. +- [Nueva arquitectura de los componentes generados](../Desktop/building.md#build-component) para un mejor cumplimiento de las directrices de notarización de Apple. +- Ahora puede [crear fácilmente aplicaciones de evaluación](../Desktop/building.md#build-an-evaluation-application) en el cuadro de diálogo de Build App. +- Dependencias: use el administrador de Dependencias para [buscar nuevas versiones](../Project/components.md#checking-for-new-versions) y [actualizar](../Project/components.md#updating-dependencies) componentes GitHub. +- Nuevas clases [`TCPConnection`](../API/TCPConnectionClass.md) y [`TCPEvent`](../API/TCPEventClass.md) para gestionar conexiones cliente TCP, manejar eventos y mejorar el control sobre la transmisión de datos. Añadido [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) para un registro detallado de eventos TCP. +- Nuevas opciones en [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) y [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridad de datos y protección por contraseña. +- 4D Write Pro: - Los siguientes comandos permiten ahora parámetros como objetos o colecciones: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), y [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), y [WP Insert break](../WritePro/commands/wp-insert-break.md), son ahora funciones que devuelven rangos. - New expressions related to document attributes: [This.sectionIndex](../WritePro/managing-formulas.md), [his.sectionName](../WritePro/managing-formulas.md) and [This.pageIndex](../WritePro/managing-formulas.md). - - Lenguaje 4D: +- Lenguaje 4D: - Comandos modificados: [`FORM EDIT`](../commands/form-edit.md) - Las funciones [`.sign()`](../API/CryptoKeyClass.md#sign) y [`.verify()`](../API/CryptoKeyClass.md#verify) de la clase [4D.CryptoKey](../API/CryptoKeyClass.md) soportan Blob en el parámetro *message*. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos los bugs que se han corregido en 4D 20 R8. #### Cambios de comportamiento - - Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). - - Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. +- Después de una modificación del archivo de registro usando [`SELECT LOG FILE`](../commands/select-log-file.md) o la [Configuración de copia de seguridad](../Backup/settings.md#log-management), el comando [`New log file`](../commands/new-log-file.md) ahora valida el cambio, sin esperar una copia de seguridad. Ya no se produce el error -4447 (copia de seguridad necesaria). +- Debido a su [nueva arquitectura](../Desktop/building.md#build-component), los componentes creados con 4D 20 R8 y superiores no pueden ser instalados en versiones anteriores 4D. ## 4D 20 R7 @@ -59,30 +59,30 @@ Lea [**Novedades en 4D 20 R7**](https://blog.4d.com/en-whats-new-in-4d-20-R7/), #### Lo más destacado - - Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). - - Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. - - Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. - - Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). - - Lenguaje 4D: +- Las columnas de los list box y de los encabezados de tipo hora ahora soportan la opción ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nuevas propiedades en [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) y [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Ahora puede [añadir y eliminar componentes utilizando la interfaz del gestor de componentes](../Project/components.md#monitoring-project-dependencies). +- Nuevo [**modo de tipado directo**](../Project/compiler.md#enabling-direct-typing) en el que declara todas las variables y parámetros en su código usando las palabras clave `var` y `#DECLARE`/`Function` (sólo modo soportado en nuevos proyectos). [La función de verificación de sintaxis](../Project/compiler.md#check-syntax) se ha mejorado en consecuencia. +- Soporte de [singletones de sesión](../Concepts/classes.md#singleton-classes) y nueva propiedad de clase [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nueva [palabra clave función `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funciones singleton u ORDA que pueden ser llamadas a través de [peticiones HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nueva clase [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que el servidor REST devuelva cualquier contenido web. +- Qodly Studio: ahora puede [adjuntar el depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nuevas llaves Build Application para que las aplicaciones 4D remotas validen las [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) y/o los [dominios](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Posibilidad de [crear aplicaciones autónomas sin licencias integradas](../Desktop/building.md#licenses). +- Lenguaje 4D: - Nuevos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands-legacy/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - Nuevo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) y [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos los bugs que se han corregido en 4D 20 R7. #### Cambios de comportamiento - - La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. - - El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. - - La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. +- La documentación del [Lenguaje 4D](../commands/command-index.md) y del [Lenguaje 4D Write Pro](../WritePro/commands/command-index.md) ya está disponible en developer.4d.com. Descubra todas las novedades y cambios relativos a estas documentaciones en esta nota de la versión. +- El comando [`File`](../commands/file.md) (así como [`4D.File.new()`](../API/FileClass.md#4dfilenew)) es más estricto a la hora de comprobar la sintaxis de *path* suministrada como parámetro. +- La acción de [permission](../ORDA/privileges.md#permission-actions) ha sido eliminada de las acciones disponibles. El acceso a las urls [`/rest/$catalog`](../REST/$catalog.md) ya no está controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -90,25 +90,25 @@ Lea [**Novedades en 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d-20-R6/), #### Lo más destacado - - Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). - - Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). - - Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). - - Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. - - Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. - - Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. - - Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. - - Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. - - Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). - - Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). - - Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. - - Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. +- Soporte de operadores de comparación en las [referencias de objeto](../Concepts/dt_object.md#object-operators) y las [referencias de colección](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) ahora soporta las [referencias de objeto y de colección como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). +- Cuando un componente tiene un [espacio de nombres declarado](../Extensions/develop-components.md#declarar-el-espacio-de-nombres-del-componente), sus clases ahora se comparten automáticamente entre todos los componentes cargados en el proyecto del host por [`cs.`](../Concepts/classes.md#cs). +- Gestión de componentes: soporte de [componentes almacenados en GitHub](../Project/components.md#components-stored-on-github). +- Nueva función [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) y API REST [`$clean`](../REST/$clean.md) para obtener una nueva entity selection basada en la entity selection original pero sin sus entidades eliminadas. +- Nueva función [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) y API REST [`$info/privileges`](../REST/$info.md) para inspeccionar los privilegios de sesión más fácilmente durante la depuración. +- Nuevo archivo [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar las áreas web anidadas de 4D. +- Nueva clase [HTTPAgent](../API/HTTPAgentClass.md) y nueva propiedad [`agent`](../API/HTTPRequestClass.md#options-parameter) para la clase HTTPRequest. +- Nuevas funciones [`enableState()`](../API/WebFormClass.md) y [`disableState()`](../API/WebFormClass.md) para controlar los estados de las páginas Qodly desde el servidor. +- Nueva [\`API$singleton](../REST/$singleton.md) para llamar las funciones singleton expuestas desde REST y nuevos [privilegios asociados](../ORDA/privileges.md). +- Un [nuevo botón de parámetros](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) le ayuda a actualizar su proyecto para utilizar el modo REST "conexión forzada" (el método base `On REST Authentication` es ahora obsoleto). +- Una [nueva pestaña de parámetros](../Project/compiler.md#warnings) permite definir la generación de advertencias de forma global. +- Varios comandos, principalmente del tema "entorno 4D", son ahora hilo seguro, así como algunos selectores de los comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nuevo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que ofrece el comando `PDF Get attachments` para extraer los archivos adjuntos de un documento PDF/A3. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos los bugs que se han corregido en 4D 20 R6. #### Cambios de comportamiento - - Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). - - La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). +- Soporte de encadenamiento de desplazamiento en los formularios: los subformularios principales ahora se desplazan automáticamente cuando los objetos integrados deslizables ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) u [horizontalmente](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) han llegado a sus límites y el usuario sigue desplazándose utilizando el ratón o el trackpad (desplazamiento excesivo). +- La API REST [`$catalog`](../REST/$catalog.md) ahora devuelve singletons (si los hay). ## 4D 20 R5 @@ -116,21 +116,21 @@ Lea [**Las novedades en 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d-20-R5 #### Lo más destacado - - Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. - - Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). - - Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nuevo parámetro REST [$format](../REST/$format.md). - - El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. +- Nuevo [Gestor de componentes](../Project/components.md) para gestionar componentes a través de un archivo `dependencies.json`. +- Soporte de estructuras de gestión de errores [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La capa de red QUIC ahora soporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). +- Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Nuevas propiedades de clase: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Soporte para [inicializar una propiedad de clase en su línea de declaración](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nuevo modo [forzar login para peticiones REST](../REST/authUsers.md#force-login-mode) con un [soporte específico en Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nuevo parámetro REST [$format](../REST/$format.md). +- El objeto [`Session`](../commands/session.md) está ahora disponible en sesiones de usuario remotas y en sesiones de procedimientos almacenados. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos los bugs que se han corregido en 4D 20 R5. #### Cambios de comportamiento - - Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). - - Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. +- Los plug-ins *4D Internet Commands* y *4D for OCI* ya no se incluyen en los instaladores de 4D. Para obtener estos plug-ins, necesita conectarse al [**portal de descarga de productos 4D**](https://product-download.4d.com/). +- Los cambios realizados en el editor de estructura en relación con el aspecto gráfico de las tablas y de los campos (color, posición, orden...) ahora se guardan en un archivo separado llamado `catalog_editor.json` almacenado en la carpeta [`Sources`](../Project/architecture.md#sources) del proyecto. ## 4D 20 R4 @@ -138,24 +138,24 @@ Lea [**Novedades en 4D 20 R4**](https://blog.4d.com/en-whats-new-in-4d-v20-R4/), #### Lo más destacado - - Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. - - Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). - - Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. - - Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). - - Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) - - Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. - - Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). - - Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. +- Soporte de [formato de cifrado ECDSA\`](../Admin/tls.md#encryption) para certificados TLS. +- Las conexiones TLS cliente/servidor y servidor SQL ahora se [configuran dinámicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (no se requieren archivos de certificado). +- Formato HTML directo para [exportaciones de definición de estructura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nuevo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que mejora el control del código durante los pasos de declaración, comprobación de sintaxis y compilación para evitar errores de ejecución. +- Los parámetros de métodos declarados en prototipos `#DECLARE` [ya no son necesarios en métodos "Compiler_"](../Concepts/parameters.md). +- Soporte de [formatos personalizados de fecha y hora](../Project/date-time-formats.md) +- Nueva [palabra clave `Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de error simples. +- Nuevo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- Nueva opción de compatibilidad [Impresión no bloqueante](../settings/compatibility.md). +- Nuevo [modo de edición](../Admin/dataExplorer.md#editing-data) en el Explorador de datos. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos los bugs que se han corregido en 4D 20 R4. #### Cambios de comportamiento - - El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. - - 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/)). - - En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. - - Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). +- El uso de una sintaxis heredada para declarar parámetros (por ejemplo, `C_TEXT($1)` o `var $1 : Text`) es obsoleto y genera advertencias en los pasos de escritura de código, verificación de sintaxis y compilación. +- 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/)). +- En la actualización de [la librería OpenSSL](#library-table), el nivel de seguridad SSL/TLS por defecto se ha cambiado de 1 a 2. Las llaves RSA, DSA y DH de 1024 bits o más y menos de 2048 bits, así como las llaves ECC de 160 bits o más y menos de 224 bits, ya no están permitidas. Por defecto, la compresión TLS ya estaba desactivada en versiones anteriores de OpenSSL. En el nivel de seguridad 2 no se puede activar. +- Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. Asegúrese de que su método base "On REST authentication" puede manejar contraseñas en claro (el tercer parámetro es entonces **False**) y que `Open datastore` encripta su conexión pasando la opción "tls" a **True** en *connectionInfo*. En casos concretos, también se puede utilizar una nueva opción "passwordAlgorithm" por compatibilidad (ver el comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -163,21 +163,21 @@ Lea [**Novedades en 4D 20 R3**](https://blog.4d.com/en-whats-new-in-4d-20-vR3/), #### Lo más destacado - - Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). - - Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) - - Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. +- Nueva función [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Soporte del parámetro *context* en [`Formula from string`](../commands/formula-from-string.md). +- Soporte de la propiedad `headers` en el parámetro *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Sello de modificación global](../ORDA/global-stamp.md) para ayudar a implementar módulos de sincronización de datos. Nuevas funciones: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) y [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- La asignación de referencias de archivo a atributos imagen/blob está [soportada en ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Soporte para [inicializar el valor de la variable y el tipo de datos en la línea de declaración](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- Los parámetros del archivo de registro se guardan ahora [con el archivo de datos actual](../Backup/settings.md#log-management) +- Nueva sintaxis para [declarar parámetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos los bugs que se han corregido en 4D 20 R3. #### Cambios de comportamiento - - Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). - - 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. +- Algunos errores eran detectables por su [método de gestión de errores](../Concepts/error-handling.md) solo en modo interpretado. Se ha realizado una corrección para que los siguientes errores se detecten también en modo compilado: *Indice fuera de rango*, *Tipo incompatible* y *Derreferenciación de un puntero Null*. Sin embargo, para tales errores en los procesadores Intel, el procedimiento se sigue interrumpiendo como antes, mientras que en los procesadores Apple Silicon el procedimiento solo se interrumpe si se llama al comando [`ABORT`](../commands-legacy/abort.md). +- 4D ya no incluye un intérprete PHP interno. Necesita [configurar y ejecutar su propio intérprete PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para utilizar comandos PHP. ## 4D 20 R2 @@ -191,15 +191,15 @@ Si sus aplicaciones 4D utilizan conexiones TLS, se recomienda actualizar a 4D 20 #### Lo más destacado - - Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. - - Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). - - 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 del lenguaje 4D: [Página Novedades](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) en doc.4d.com. - - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. +- Nueva [clase WebSocket](../API/WebSocketClass.md) para crear y gestionar conexiones WebSocket cliente desde 4D. +- Nueva capa de red QUIC [configuración de interfaz](../settings/client-server.md#network-layer). +- 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 del lenguaje 4D: [Página Novedades](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) en doc.4d.com. +- [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos los bugs que se han corregido en 4D 20 R2. #### Cambios de comportamiento - - **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. +- **Atención**: el valor inicial [`offset`](../API/FileHandleClass.md#offset) de los objetos [4D.FileHandle](../API/FileHandleClass.md) estaba incorrectamente definido en 1 en lugar de 0. Se ha hecho una corrección en 4D a partir de las versiones **20.1 HF1** y **20 R2** y el valor ahora es 0. ## 4D 20.x LTS diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md index d4c00814f4df3c..bd014a9a40fc59 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci Además, para garantizar el correcto funcionamiento de la funcionalidad, se requieren las siguientes condiciones: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descripción | | ------------------------------------------------------- | -------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Para activar el seguimiento de cambios en los datos: 4D realiza entonces los siguientes cambios: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desactivar el seguimiento de cambios de datos: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md index d03d3dca1c7412..fb06b21af0f510 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La sesión web creada en el almacén de datos remoto se identifica utilizando un El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estos principios se ilustran en los gráficos siguientes: @@ -29,9 +29,9 @@ Estos principios se ilustran en los gráficos siguientes: Los procesos que gestionan las sesiones de acceso al datastore se muestran en la ventana de administración de 4D Server: - - nombre: "REST Handler: \" - - tipo: tipo Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- tipo: tipo Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. En el siguiente ejemplo, se están ejecutando dos procesos para la misma sesión: @@ -47,11 +47,11 @@ Si se envía una solicitud al almacén de datos remoto después de haber cerrado Las funcionalidades ORDA relacionadas con el bloqueo de entidades y transacciones se gestionan a nivel del proceso en los datastores remotos, igual que en el modo cliente/servidor ORDA: - - 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. - - 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()`. No afectan a otros almacenes de datos. - - Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). +- 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)). Si varias entidades que apuntan a un mismo registro han sido bloqueadas en un proceso, todas deben ser desbloqueadas en el proceso para eliminar el bloqueo. Si se ha puesto un bloqueo en una entidad, el bloqueo se elimina cuando ya no hay ninguna referencia a esta entidad en la memoria. +- 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()`. No afectan a otros almacenes de datos. +- Los comandos clásicos del lenguaje 4D ([`START TRANSACTION`](../commands-legacy/start-transaction.md), [`VALIDATE TRANSACTION`](../commands-legacy/validate-transaction.md), [`CANCEL TRANSACTION`](../commands-legacy/cancel-transaction.md)) sólo se aplican al datastore principal (devuelto por `ds`). Si una entidad de un datastore remoto es retenida por una transacción en un proceso, los otros procesos no pueden actualizarla, incluso si estos procesos comparten la misma sesión. - - Los bloqueos en las entidades son eliminados y las transacciones son anuladas: +- Los bloqueos en las entidades son eliminados y las transacciones son anuladas: - cuando el proceso es eliminado. - cuando la sesión se cierra en el servidor - cuando la sesión es terminada desde la ventana de administración del servidor. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md index ad2b739bcee511..410c532096b05f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contiene varias opciones para configurar el funcionamiento general Esta opción permite configurar la visualización por defecto de 4D al inicio, cuando el usuario lanza únicamente la aplicación. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forzar la visualización de la caja de diálogo de apertura cuando se selecciona esta opción, mantenga presionada la tecla **Alt** (Windows) u **Option** (macOS) mientras lanza el proyecto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir de macOS Sierra, las aplicaciones Mac pueden beneficiarse de la funció Puede beneficiarse de esta funcionalidad en los siguientes entornos (sólo con las versiones 4D de 64 bits): - - Ventanas del editor de código - - Ventanas del editor de formularios +- Ventanas del editor de código +- Ventanas del editor de formularios Todas las ventanas de estos editores se pueden poner en forma de pestaña: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Hay tres opciones disponibles: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Apariencia (sólo para macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Hay tres opciones disponibles: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferencia sólo es compatible en macOS. En Windows, se utiliza siempre el esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de datos...** - - **Base de datos a partir de una definición de estructura...** +- **Base de datos...** +- **Base de datos a partir de una definición de estructura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Al crear un nuevo archivo de datos, 4D utiliza el idioma previamente configurado Esta área configura el acceso a la documentación HTML de 4D mostrada en su navegador actual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Lenguaje de la documentación @@ -151,8 +151,8 @@ Lenguaje de la documentación HTML a mostrar. Puede seleccionar una documentaci Define dónde buscará 4D las páginas de documentación. - - Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. - - Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. +- Cuando está marcada (por defecto), 4D busca primero la página en la carpeta local (ver abajo). Si se encuentra, 4D muestra la página en el navegador actual. If it is found, 4D displays the page in the current browser. Esto permite acceder a la documentación incluso cuando se está desconectado. +- Cuando no está marcada, 4D busca la página deseada directamente en el sitio web de documentación en línea y la muestra en el navegador actual. Si no se encuentra, 4D muestra un mensaje de error en el navegador. ### Carpeta local diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md index d099b6a053a938..535d7a3f295489 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite seleccionar, crear o configurar los temas del Editor de Có En esta lista, se selecciona el tema que se aplicará al editor de código. Se muestran todos los temas disponibles, incluidos los temas personalizados (si los hay). 4D ofrece dos temas por defecto: - - **Tema Light por defecto** - - **Tema oscuro por defecto** +- **Tema Light por defecto** +- **Tema oscuro por defecto** > Los temas por defecto no pueden ser modificados ni eliminados. @@ -38,8 +38,8 @@ Si los valores de las teclas no se definen en un tema personalizado, se ajustan Definir un tema significa: - - definir una fuente y un tamaño de fuente para todo el editor de código, - - asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. +- definir una fuente y un tamaño de fuente para todo el editor de código, +- asignar los estilos y los colores específicos a cada elemento del lenguaje 4D (campos, tablas, variables, parámetros, SQL, etc.), a cada elemento del lenguaje SQL (palabras clave, funciones, etc.) y a los fondos de color. La combinación de colores y de estilos diferentes es especialmente útil para el mantenimiento del código. @@ -83,8 +83,8 @@ Esta página configura las opciones de visualización del Editor de Código. Permite desactivar/activar los parámetros del código "internacional" para la aplicación 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Si modifica esta opción, deberá reiniciar la aplicación 4D para que se tenga en cuenta el cambio. @@ -138,9 +138,9 @@ Permite ocultar todos los iconos expandir/desplegar por defecto al mostrar el c Activa la inserción automática de () y de llaves de cierre mientras se escribe el código. Esta opción controla dos funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por ejemplo, si escribe "C_OB" y presionaa Tab, 4D escribe "C_OBJECT()" y fija el punto de inserción dentro del (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta función permite insertar pares de símbolos coincidentes en el punto de inserción o alrededor de un texto seleccionado. Por ejemplo, si resalta una cadena de caracteres y escribe un simple caracter ", toda la cadena seleccionada quedará encerrada en "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Activa la inserción automática de () y de llaves de cierre mientras se escribe Define la señalización gráfica de las llaves correspondientes en el código. Esta señalización aparece siempre que se selecciona un corchete, un paréntesis o una llave. Las siguientes opciones están disponibles: - - **Ninguno**: sin señales - - **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ +- **Ninguno**: sin señales +- **Rectángulo** (por defecto): llaves rodeadas por una línea negra\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Resaltado de las variables y campos @@ -162,9 +162,9 @@ Permite resaltar todas las ocurrencias de la misma variable o campo en una venta ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md index 188712c0ba8aab..0f0bc09902602d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitectura de un proyecto Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de una carpeta raíz del proyecto (carpeta paquete). Por ejemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un proyecto 4D se compone de varias carpetas y archivos, almacenados dentro de u La carpeta Project suele contener la siguiente jerarquía: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Clases` - `DatabaseMethods` - `Métodos` - `Formularios` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` El archivo de desarrollo de proyecto, utilizado para designar y lanzar el proyecto. Este archivo puede ser abierto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > En los proyectos 4D, el desarrollo se realiza con 4D y el desarrollo multiusuarios se gestiona a través de las herramientas de control de versión. 4D Server puede abrir archivos .4DProject para realizar pruebas. @@ -120,9 +120,9 @@ Este archivo de texto también puede contener llaves de configuración, en parti La carpeta Trash contiene los métodos y formularios que se han eliminado del proyecto (si los hay). Puede contener las siguientes carpetas: - - `Métodos` - - `Formularios` - - `TableForms` +- `Métodos` +- `Formularios` +- `TableForms` Dentro de estas carpetas, los nombres de los elementos eliminados van entre paréntesis, por ejemplo "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Esta carpeta contiene [**parámetros usuario para datos**](../Desktop/user-setti La carpeta Logs contiene todos los archivos de registro utilizados por el proyecto. Los archivos de registro incluyen, en particular: - - conversión de base de datos, - - peticiones del servidor web, - - registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) - - depuración de comandos, - - Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). +- conversión de base de datos, +- peticiones del servidor web, +- registro de actividades de backup/restitución (*Backup Journal\[xxx].txt*, ver [Historial de backup](Backup/backup.md#backup-journal)) +- depuración de comandos, +- Peticiones 4D Server (generadas en en los equipos cliente y en el servidor). > Una carpeta Logs adicional está disponible en la carpeta de preferencias del usuario del sistema (carpeta 4D activa, ver el comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para los archivos de registro de mantenimiento y e diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/components.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/components.md index 7612baba4c16b2..c297ae2c9ae076 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/components.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/components.md @@ -13,15 +13,15 @@ Al desarrollar en 4D, los archivos de los componentes pueden almacenarse de form Los componentes pueden ser interpretados o [compilados](../Desktop/building.md). - - Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. - - Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. +- Un proyecto 4D que se ejecuta en modo interpretado puede utilizar componentes interpretados o compilados. +- Un proyecto 4D que se ejecuta en modo compilado no puede utilizar componentes interpretados. En este caso, sólo se pueden utilizar componentes compilados. ### Carpeta Package La carpeta del paquete de un componente puede contener: - - para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: una [Carpeta Project](../Project/architecture.md) estándar. El nombre de la carpeta del paquete debe llevar el sufijo **.4dbase** si desea instalarlo en la carpeta [**Componentes** de su proyecto](architecture.md#components). +- para **componentes compilados**: - una carpeta "Contents" que contenga un archivo .4DZ, una carpeta *Resources*, un archivo *Info.plist* (arquitectura recomendada) - o directamente un archivo .4DZ con otras carpetas como *Resources*. @@ -37,8 +37,8 @@ La arquitectura de carpetas "Contents" se recomienda para los componentes si des Esta página describe cómo trabajar con componentes en los entornos **4D** y **4D Server**. En otros entornos, los componentes se gestionan de manera diferente: - - en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. - - en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). +- en [4D en modo remoto](../Desktop/clientServer.md), los componentes son cargados por el servidor y enviados a la aplicación remota. +- en las aplicaciones fusionadas, los componentes se [incluyen en el paso de compilación](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página describe cómo trabajar con componentes en los entornos **4D** y ** Para cargar un componente en su proyecto 4D, usted puede: - - copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), - - o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). +- copie los archivos de componentes en la carpeta [**Components** de su proyecto](architecture.md#components) (las carpetas de paquetes de componentes interpretados deben llevar el sufijo ".4dbase", ver arriba), +- o bien, declare el componente en el archivo **dependencies.json** de su proyecto; esto se hace automáticamente para los archivos locales cuando [**añade una dependencia utilizando la interfaz del gestor de dependencias**](#adding-a-github-dependency). Los componentes declarados en el archivo **dependencies.json** pueden almacenarse en diferentes ubicaciones: - - al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, - - en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** - - en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. +- al mismo nivel que la carpeta de paquetes de su proyecto 4D: esta es la ubicación predeterminada, +- en cualquier lugar de su máquina: la ruta del componente debe declararse en el archivo **environment4d.json** +- en un repositorio GitHub: la ruta del componente puede declararse en el archivo **dependencies.json** o en el archivo **environment4d.json**, o en ambos archivos. Si se instala el mismo componente en distintos lugares, se aplica un [orden de prioridad](#priority). @@ -69,8 +69,8 @@ El archivo **dependencies.json** hace referencia a todos los componentes requeri Puede contener: - - nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), - - nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). +- nombres de componentes [almacenados localmente](#local-components) (ruta por defecto o ruta definida en un archivo **environment4d.json**), +- nombres de componentes [almacenados en repositorios de GitHub](#components-stored-on-github) (su ruta puede definirse en este archivo o en un archivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ El archivo **environment4d.json** es opcional. Permite definir **rutas personali Los principales beneficios de esta arquitectura son los siguientes: - - puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. - - si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. +- puede almacenar el archivo **environment4d.json** en una carpeta padre de sus proyectos y decidir no confirmarlo, permitiéndote tener su organización local de componentes. +- si quiere utilizar el mismo repositorio GitHub para varios de sus proyectos, puede referenciarlo en el archivo **environment4d.json** y declararlo en el archivo **dependencies.json**. ### Prioridad @@ -187,9 +187,9 @@ En cuanto a los componentes almacenados en GitHub, tanto los archivos [**depende Los componentes 4D disponibles en GitHub pueden ser referenciados y cargados automáticamente en sus proyectos 4D. - - Comprima los archivos componentes en formato ZIP. - - Nombre este archivo con el mismo nombre que el repositorio GitHub. - - Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. +- Comprima los archivos componentes en formato ZIP. +- Nombre este archivo con el mismo nombre que el repositorio GitHub. +- Integre el archivo en una [versión GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) del repositorio. Estos pasos pueden automatizarse fácilmente, con código 4D o utilizando GitHub Actions, por ejemplo. @@ -232,7 +232,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g ::: - - **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: +- **Etiquetas** son textos que hacen referencia única a una versión. En los archivos [**dependencies.json**](#dependenciesjson) y [**environment4d.json**](#environment4djson), puede indicar la etiqueta de versión que desea utilizar en su proyecto. Por ejemplo: ```json { @@ -245,7 +245,7 @@ Si seleccionas la regla de dependencia [**Seguir la versión 4D**](#defining-a-g } ``` - - Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: +- Una versión también se identifica por una **versión**. The versioning system used is based on the [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/) concept, which is the most commonly used. Cada número de versión se identifica de la siguiente manera: `majorNumber.minorNumber.pathNumber`. Del mismo modo que para las etiquetas, puede indicar la versión del componente que desea utilizar en su proyecto, como en este ejemplo: ```json { @@ -262,17 +262,17 @@ Un rango se define mediante dos versiones semánticas, un mínimo y un máximo, Estos son algunos ejemplos: - - "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. - - "\*": la última versión lanzada. - - "1.\*": todas las versiones de la versión principal 1. - - "1.2.\*": todos los parches de la versión menor 1.2. - - ">=1.2.3": la última versión, a partir de la versión 1.2.3. - - ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. - - "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. - - "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. - - "<=1.2.3": la última versión hasta la 1.2.3. - - "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. - - "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. +- "latest": la versión que tiene el distintivo "latest" en las versiones de GitHub. +- "\*": la última versión lanzada. +- "1.\*": todas las versiones de la versión principal 1. +- "1.2.\*": todos los parches de la versión menor 1.2. +- ">=1.2.3": la última versión, a partir de la versión 1.2.3. +- ">1.2.3": la última versión, empezando por la versión inmediatamente posterior a la 1.2.3. +- "^1.2.3": la última versión 1, a partir de la versión 1.2.3 y estrictamente inferior a la versión 2. +- "~1.2.3": la última versión 1.2, a partir de la versión 1.2.3 y estrictamente inferior a la versión 1.3. +- "<=1.2.3": la última versión hasta la 1.2.3. +- "1.0.0 – 1.2.3" o ">=1.0.0 <=1.2.3": versión entre 1.0.0 y 1.2.3. +- "`<1.2.3 || >=2`": versión que no está entre 1.2.3 y 2.0.0. Si no especifica una etiqueta o una versión, 4D recupera automáticamente la "última" versión. @@ -282,9 +282,9 @@ El gestor de dependencias comprueba periódicamente si hay actualizaciones de co Si quiere usar la regla de dependencia [**Seguir la versión 4D**](#defining-a-github-dependency-version-range), las etiquetas para las versiones de componentes en el repositorio de Github deben cumplir con convenciones específicas. - - **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". +- **Versiones LTS**: modelo `x.y.p`, donde `x.y` corresponde a la versión principal de 4D a seguir y `p` (opcional) puede utilizarse para versiones correctivas o actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión LTS *x.y*, el Gestor de dependencias lo resolverá como "la última versión x.\*" si está disponible o "versión inferior a x". Si no existe tal versión, se notificará al usuario. Por ejemplo, "20.4" será resuelto por el gestor de dependencias como "la última versión del componente 20.\* o la versión inferior a 20". - - **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". +- **Versiones R-Release**: modelo `xRy.p`, donde `x` y `y` corresponden a la versión principal de 4D R-release a seguir y `p` (opcional) puede usarse para versiones correctivas o las actualizaciones adicionales. Cuando un proyecto especifica que sigue la versión 4D para la versión *xRy*, el Gestor de dependencias lo resolverá a la "última versión por debajo de xR(y+1)" si está disponible. Si no existe tal versión, se notificará al usuario. Por ejemplo, "20R9" será resuelto por el gestor de dependencias como "la última versión del componente por debajo de 20R10". :::note @@ -310,8 +310,8 @@ A continuación, deberá [suministrar su token de conexión](#providing-your-git Los componentes GitHub a los que se hace referencia se descargan en una carpeta de caché local y, a continuación, se cargan en su entorno. La carpeta de caché local se guarda en la siguiente ubicación: - - en macOs: `$HOME/Library/Caches//Dependencies` - - en Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- en Windows: `C:\Users\\AppData\Local\\Dependencies` ...donde `` puede ser "4D", "4D Server" o "tool4D". @@ -327,10 +327,10 @@ En un proyecto abierto, puede añadir, eliminar, actualizar y obtener informaci Para mostrar el panel Dependencias: - - con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
+- con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - con el servidor 4D, seleccione el elemento de menú **Ventana/Dependencias del proyecto**.
+- con el servidor 4D, seleccione el elemento de menú **Ventana/Dependencias del proyecto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) A continuación, se muestra el panel Dependencias. Las dependencias se ordenan por nombre en orden alfabético: @@ -345,9 +345,9 @@ Por defecto, se listan todas las dependencias identificadas por el gestor de dep ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. - - **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... - - **Conflicto**: dependencias que se cargan pero que sobrecargan al menos otra dependencia de menor [nivel de prioridad](#prioridad). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. +- **Activo**: dependencias que están cargadas y pueden ser utilizadas en el proyecto. Incluye dependencias *overloading*, las cuales son realmente cargadas. Las dependencias *Overloaded* se enumeran en el panel **Conflicts** junto con todas las dependencias en conflicto. +- **Inactivo**: dependencias que no están cargadas en el proyecto y no están disponibles. Hay muchas razones posibles para este estado: archivos que faltan, incompatibilidad de versiones... +- **Conflicto**: dependencias que se cargan pero que sobrecargan al menos otra dependencia de menor [nivel de prioridad](#prioridad). También se muestran las dependencias sobrecargadas para que pueda comprobar el origen del conflicto y tomar las medidas oportunas. ### Estado de dependencias @@ -357,16 +357,16 @@ Las dependencias que requieren la atención del desarrollador se indican mediant Las siguientes etiquetas de estado están disponibles: - - **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). - - **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). - - **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. - - **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). - - **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). - - **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. - - **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. - - **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). - - **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. - - **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. +- **Overloaded**: la dependencia no se carga porque está sobrecargada por otra dependencia con el mismo nombre en un [nivel de prioridad] superior(#prioridad). +- **Overloading**: la dependencia está cargada y está sobrecargando una o más dependencias con el mismo nombre en un [nivel de prioridad] inferior(#prioridad). +- **Not found**: la dependencia se declara en el archivo dependencies.json pero no se encuentra. +- **Inactive**: la dependencia no se carga porque no es compatible con el proyecto (por ejemplo, el componente no está compilado para la plataforma actual). +- **Duplicated**: la dependencia no se carga porque existe otra dependencia con el mismo nombre en la misma ubicación (y está cargada). +- **Disponible después del reinicio**: la referencia a dependencias acaba de ser añadida o actualizada [usando la interfaz](#monitoring-project-dependencies), se cargará una vez que la aplicación se reinicie. +- **Descargado después de reiniciar**: la referencia de dependencias acaba de ser removida [utilizando la interfaz](#removing-a-dependency), se descargará una vez que la aplicación se reinicie. +- **Actualización disponible**: se ha detectado una nueva versión de la dependencia GitHub que coincide con su [configuración de la versión del componente](#defining-a-github-dependency-version-range). +- **Reiniciado tras reinicio**: la [configuración de la versión del componente](#defining-a-github-dependency-version-range) de la dependencia de GitHub se ha modificado, se ajustará el próximo inicio. +- **Actualización reciente**: se ha cargado una nueva versión de la dependencia de GitHub al inicio. Al pasar el ratón por encima de la línea de dependencia, se muestra un mensaje que ofrece información adicional sobre el estado: @@ -399,8 +399,8 @@ Este elemento no se muestra si la relación está inactiva porque no se encuentr El icono del componente y el logotipo de ubicación ofrecen información adicional: - - El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. - - Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. +- El logotipo del componente indica si es suministrado por 4D o por un desarrollador externo. +- Los componentes locales se pueden diferenciar de los componentes GitHub por un pequeño icono. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -420,8 +420,8 @@ Si el elemento seleccionado no es válido, se mostrará un mensaje de error. Haga clic en **Añadir** para añadir la dependencia al proyecto. - - Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). - - Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). +- Si selecciona un componente situado junto a la carpeta del paquete del proyecto (ubicación predeterminada), se declara en el archivo [**dependencies.json**](#dependenciesjson). +- Si selecciona un componente que no se encuentra junto a la carpeta del paquete del proyecto, se declara en el archivo [**dependencies.json**](#dependenciesjson) y su ruta se declara en el archivo [**environment4d.json**](#environment4djson) (ver nota). El panel Dependencias le pregunta si desea guardar una [ruta relativa o absoluta](#relative-paths-vs-absolute-paths). :::note @@ -461,11 +461,11 @@ Puede definir la opción [etiqueta o versión](#tags-and-versions) para una depe ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). - - **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. - - **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. - - **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. - - **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. +- **Último**: seleccionado por defecto y permite descargar la versión etiquetada como la última versión (estable). +- **Hasta la próxima versión mayor**: define un [rango de versiones semánticas](#tags-and-versions) para restringir las actualizaciones a la próxima versión principal. +- **Hasta la siguiente versión menor**: del mismo modo, restringir las actualizaciones a la siguiente versión menor. +- **Versión exacta (Etiqueta)**: selecciona o introduce manualmente una [etiqueta específica](#tags-and-versions) de la lista disponible. +- **Siga la versión 4D**: descargue la última versión del componente compatible con la versión 4D en ejecución. Puede usar esta regla de dependencia sólo si las etiquetas de release de los componentes siguen la [convención de nombres](#naming-conventions-for-4d-version-tags) apropiada. La versión actual de la dependencia de GitHub se muestra a la derecha del elemento de la dependencia: @@ -481,8 +481,8 @@ Modificar el rango de versiones es útil, por ejemplo, si utiliza la función de El gestor de dependencias ofrece una gestión integrada de las actualizaciones en GitHub. Se soportan las siguientes funcionalidades: - - Verificación automática y manual de las versiones disponibles - - Actualización automática y manual de los componentes +- Verificación automática y manual de las versiones disponibles +- Actualización automática y manual de los componentes Las operaciones manuales pueden realizarse **por dependencia** o **para todas las dependencias**. @@ -498,11 +498,11 @@ Si suministra un [token de acceso](#providing-your-github-access-token), las ver Además, puede buscar actualizaciones en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. +- Para verificar las actualizaciones de una única dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Verificar actualizaciones** en el menú contextual. ![componente de verificación](../assets/en/Project/check-component-one.png) - - Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. +- Para verificar si hay actualizaciones de todas las dependencias, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Verificar actualizaciones**. ![componentes de verificación](../assets/en/Project/check-component-all.png) @@ -520,11 +520,11 @@ Si no desea utilizar una actualización de componentes (por ejemplo, desea perma Puede actualizar las dependencias en cualquier momento, para una sola dependencia o para todas las dependencias: - - Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: +- Para actualizar una sola dependencia, haga clic con el botón derecho del ratón en la dependencia y seleccione **Actualizar en el próximo inicio** en el menú contextual o en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias: ![componente de verificación](../assets/en/Project/update-component-one.png) - - Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: +- Para actualizar todas las dependencias a la vez, haga clic en el menú **opciones** de la parte inferior de la ventana del gestor de dependencias y seleccione **Actualizar todas las dependencias remotas en el próximo inicio**: ![componentes de verificación](../assets/en/Project/update-component-all.png) @@ -532,8 +532,8 @@ En cualquier caso, sea cual sea el estado actual de la dependencia, se realiza u Al seleccionar un comando de actualización: - - se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. - - si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. +- se muestra un cuadro de diálogo que propone **reiniciar el proyecto**, para que las dependencias actualizadas estén disponibles de inmediato. Normalmente se recomienda reiniciar el proyecto para evaluar las dependencias actualizadas. +- si hace clic en Más tarde, el comando de actualización ya no estará disponible en el menú, lo que significa que la acción se ha planificado para el siguiente inicio. #### Actualización automática @@ -547,13 +547,13 @@ Cuando esta opción no está marcada, una nueva versión del componente que coin Registrar su token de acceso personal en el gestor de dependencias es: - - obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), - - recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. +- obligatorio si el componente se almacena en un [repositorio privado de GitHub](#private-repositories), +- recomendado para una [verificación de actualizaciones de dependencias](#updating-github-dependencies) más frecuente. Para proporcionar su token de acceso a GitHub, también puede: - - haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. - - o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. +- haga clic en el botón \*\*Agregar un token de acceso personal... \* que se muestra en el cuadro de diálogo "Añadir una dependencia" después de introducir una ruta privada del repositorio de GitHub. +- o, seleccione **Agregar un token de acceso personal de GitHub...** en el menú Administrador de Dependencias en cualquier momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md index dd5d2bb8fab21b..56d2bc618d04fd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md @@ -7,10 +7,10 @@ En los proyectos aplicación, puede documentar sus métodos así como sus clases Los siguientes elementos del proyecto aceptan la documentación: - - Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) - - Clases - - Formularios - - Tablas y campos +- Métodos (métodos base, métodos componente, métodos proyecto, métodos formulario, métodos 4D Mobile y triggers) +- Clases +- Formularios +- Tablas y campos Sus archivos de documentación se escriben en la sintaxis Markdown (archivos .md) utilizando cualquier editor que soporte el Markdown. Se almacenan como archivos independientes dentro de la carpeta Proyecto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Clases` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario proyecto y su método de formulario proyecto comparten el mismo archivo de documentación para el formulario y el método. - - Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. +- Un formulario tabla y su método de formulario tabla comparten el mismo archivo de documentación para el formulario y el método. > Renombrar o eliminar un elemento documentado en su proyecto también renombrará o eliminará el archivo Markdown asociado al elemento. @@ -73,9 +73,9 @@ Para ver la documentación en la ventana del Explorador: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. +- De lo contrario, si existe un archivo de documentación para el elemento seleccionado, el contenido se muestra en el área. El contenido no se puede editar directamente en el panel. ### Modificar el archivo de documentación @@ -83,8 +83,8 @@ Puede crear y/o editar un archivo de documentación Markdown desde la ventana de Si no existe un archivo de documentación para el elemento seleccionado, puede: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ El editor de código 4D muestra una parte de la documentación de un método en Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ +- O, si no se usa ninguna etiqueta de comentario html, la primera frase después de una etiqueta `# Description` del archivo markdown.\ En este caso, la primera línea contiene el **prototipo** del método, generado automáticamente por el analizador de código de 4D. :::note @@ -130,7 +130,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Markdown soportado - - La etiqueta del título es soportada: +- La etiqueta del título es soportada: ```md # Title 1 @@ -138,7 +138,7 @@ Los nuevos archivos de documentación se crean con el siguiente contenido por de ### Title 3 ``` - - Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: +- Las etiquetas de estilo (cursiva, negrita, tachado) son compatibles: ```md _italic_ @@ -147,7 +147,7 @@ _italic_ ~~strikethrough~~ ``` - - La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: +- La etiqueta de bloque de código (\`4d ... `) es compatible con el resaltado de código 4D: ````md ```4d @@ -156,7 +156,7 @@ _italic_ ``` ```` - - La etiqueta de la tabla es soportada: +- La etiqueta de la tabla es soportada: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La etiqueta del enlace es soportada: +- La etiqueta del enlace es soportada: ```md // Caso 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Las etiquetas de imagen son soportadas: +- Las etiquetas de imagen son soportadas: ```md ![image info](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - Vista del explorador: +- Vista del explorador: ![](../assets/en/Project/explorer_Doc.png) - - Vista del editor de código: +- Vista del editor de código: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md index 275ccf33d10908..2e1fa51b509978 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md @@ -11,18 +11,18 @@ Si tiene atributos relacionales en una dataclass, utilice `$attributes` para def Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Si se especifica `$attributes` para los atributos **storage**: +- Si se especifica `$attributes` para los atributos **storage**: - `$attributes=attribute1, attribute2, ...`: solo son devueltos aquellos atributos de las entidades. ## Ejemplo con varias entidades relacionadas diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md index 7d332d71a27938..55410971e14d95 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - otras sesiones REST - - los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. +- otras sesiones REST +- los procesos 4D (cliente/servidor, almacén de datos remoto, monopuesto) ejecutadas en el servidor REST. Una entidad bloqueada por la API REST sólo puede ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Respuesta diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md index 7df9e0a557f078..f5dc55074e13ee 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md @@ -194,9 +194,9 @@ Si surge un problema al añadir o modificar una entidad, se le devolverá un err :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). - - **Booleanos** son true o false. - - Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). +- **Booleanos** son true o false. +- Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md index 50dca9d1af3f1b..8fae210e340e57 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Puede llamar a [funciones clase modelo de datos](ORDA/ordaClasses.md) definidas Las funciones pueden llamarse de dos maneras: - - utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. - - usando **GET requests**, con parámetros directamente pasados en la URL. +- utilizando peticiones **POST**, con parámetros de datos pasados en el cuerpo de la solicitud. +- usando **GET requests**, con parámetros directamente pasados en la URL. Las peticiones POST ofrecen un mejor nivel de seguridad porque evitan la ejecución de código sensible a través de una acción tan simple como hacer clic en un enlace. Sin embargo, las peticiones GET pueden ser más compatibles con la experiencia del usuario, permitiendo llamar a las funciones introduciendo una URL en un navegador (nota: el desarrollador debe asegurarse de que no se hace ninguna acción sensible en dichas funciones). @@ -96,11 +96,11 @@ Puede enviar parámetros a funciones definidas en clases de usuario ORDA o singl Se aplican las siguientes reglas: - - En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. - - En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. - - Los parámetros deben estar incluidos en una colección (formato JSON). - - Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. - - La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- En funciones llamadas a través de peticiones POST, los parámetros deben pasarse **en el cuerpo de la petición POST**. +- En las funciones llamadas a través de peticiones GET, los parámetros deben pasarse **en la URL con la sintaxis "?$params="**. +- Los parámetros deben estar incluidos en una colección (formato JSON). +- Todos los tipos de datos escalares soportados en las colecciones JSON pueden ser pasados como parámetros. +- La selección de entidades y la entidad se pueden pasar como parámetros. La lista de parámetros debe contener atributos específicos usados por el servidor REST para asignar datos a los objetos ORDA correspondientes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Ver [este ejemplo](#usando-una-entidad-que-se-creará-en-el-servidor) y [este ejemplo](#recibiendo-una-selección-de-entidades-como-parámetro). @@ -134,8 +134,8 @@ También puede pasar valores para todos los atributos de la entidad. Estos valor | __ENTITY | Boolean | Obligatorio - True para indicar al servidor que el parámetro es una entidad | | __KEY | mixto (mismo tipo que la llave primaria) | Opcional - llave primaria de la entidad | - - Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. - - Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados +- Si no se proporciona `__KEY`, se crea una nueva entidad en el servidor con los atributos dados. +- Si `__KEY` es suministrado, la entidad correspondiente a `__KEY` se carga en el servidor con los atributos dados Vea ejemplos a continuación para crear o actualizar entidades con peticiones POST. Vea un ejemplo de descarga de contenidos utilizando una entidad con una petición GET. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md index c3c4ed71c409a9..d0e2bbfcbd0b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md @@ -45,9 +45,9 @@ Todas las demás peticiones REST (manejando datos o ejecutando una función) só Las peticiones REST descriptivas pueden procesarse en sesiones de usuario web que no requieren licencias (sesiones "invitado"). Estas peticiones son: - - peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - la renderización de una página Qodly +- peticiones [`/rest/$catalog`]($catalog.md) (por ejemplo, `/rest/$catalog/$all`) - acceso a las dataclasse disponibles +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - la renderización de una página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -74,8 +74,8 @@ La función puede recibir cualquier información de autenticación o contextual Esta función debe contener dos partes: - - algún código para identificar y autenticar al remitente de la petición REST, - - si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. +- algún código para identificar y autenticar al remitente de la petición REST, +- si la autenticación tiene éxito, una llamada a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que asigna los privilegios apropiados a la sesión. Si la función no llama a [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), no se asignan privilegios, no se consume ninguna licencia y las solicitudes REST no descriptivas posteriores son rechazadas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md index 46b9ed831ac9e9..12f01887dc5591 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta sección pretende ayudar a familiarizarse con la funcionalidad de REST mediante un ejemplo sencillo. Vamos a: - - crear y configurar un proyecto de aplicación 4D básico - - acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. +- crear y configurar un proyecto de aplicación 4D básico +- acceder a los datos del proyecto 4D a través de REST utilizando un navegador estándar. Para simplificar el ejemplo, vamos a utilizar 4D y un navegador que se ejecutan en la misma máquina. Por supuesto, también puede utilizar una arquitectura remota. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md index 8a4e226d14542e..a74d6094bb15d1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md @@ -17,15 +17,15 @@ También hay tres botones de acceso directo que se pueden utilizar para filtrar ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estos procesos van precedidos de un icono en forma de una persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estos procesos van precedidos de un icono en forma de rueda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo optimiza la reactividad de 4D Server. Estos procesos van precedidos de un icono en forma de figura atenuada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Cuando seleccione esta opción: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), - - se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- se crea un grupo "Gestores de tareas", que incluye los procesos internos dedicados al reparto de tareas (Shared balancer, Net session manager, Exclusive pool worker), +- se crea un grupo "Gestores de clientes", que incluye varios procesos internos clientes. La área inferior de la ventana se utiliza para mostrar la representación gráfica de la actividad del proceso(s) seleccionados. @@ -33,16 +33,16 @@ La área inferior de la ventana se utiliza para mostrar la representación gráf La actividad del proceso es el porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). La ventana ofrece la siguiente información para cada proceso: - - Tipo de proceso (ver abajo), - - Sesión/Información: +- Tipo de proceso (ver abajo), +- Sesión/Información: - Proceso 4D - en blanco, - Proceso usuario - Nombre del usuario 4D, - Proceso web - ruta URL, - - Nombre del proceso, - - Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. - - Estado actual del proceso, - - Tiempo de ejecución (en segundos) del proceso desde su creación, - - Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). +- Nombre del proceso, +- Número del proceso (devuelto por el comando [`New process`](../commands-legacy/new-process.md) por ejemplo). El número de proceso es el número asignado en el servidor. En el caso de un proceso global, este número puede ser diferente del asignado en la máquina cliente. +- Estado actual del proceso, +- Tiempo de ejecución (en segundos) del proceso desde su creación, +- Porcentaje de tiempo que 4D Server ha dedicado a este proceso (ratio). ## Tipo del proceso @@ -83,15 +83,15 @@ La página también tiene cinco botones de control que actúan sobre el proceso ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. > También puede abortar directamente el proceso o procesos seleccionados sin que aparezca la caja de diálogo de confirmación, manteniendo pulsada la tecla **Alt** mientras hace clic en este botón, o utilizando el comando [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md). - - **Pausar proceso**: permite pausar los procesos seleccionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). +- **Pausar proceso**: permite pausar los procesos seleccionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Los procesos deben haberse pausado previamente (utilizando el botón anterior o por programación); de lo contrario, este botón no tiene ningún efecto. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Al presionar este botón, aparece una caja de diálogo de alerta para que pueda confirmar o cancelar la operación. Tenga en cuenta que la ventana del depurador sólo se muestra cuando el código 4D se ejecuta efectivamente en la máquina servidor (por ejemplo, en un trigger o en la ejecución de un método que tenga el atributo "Ejecutar en servidor"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botón se activa cuando se selecciona al menos un proceso de usuario. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md index b5f68a49fd85a1..b8e58da5e0ebd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Se añade una línea para cada operación larga realizada en los datos. Esta lí La siguiente información se ofrece para cada línea: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. En particular: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ La siguiente información se ofrece para cada línea: La página está activa y se actualiza permanentemente en cuanto se muestra. Cabe señalar que su funcionamiento puede ralentizar considerablemente la ejecución de la aplicación. Es posible suspender la actualización de esta página de una de las siguientes maneras: - - haciendo clic en el botón **Pausa**, - - haciendo clic en la lista, - - presionando la barra espaciadora. +- haciendo clic en el botón **Pausa**, +- haciendo clic en la lista, +- presionando la barra espaciadora. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Puede reanudar el seguimiento de las operaciones realizando la misma acción que para la pausa. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md index 1a6a770fa85ec1..e4be7309079c9a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md @@ -7,8 +7,8 @@ Si diferentes personas utilizan una aplicación, lo que suele ocurrir en la arqu La estrategia de control de acceso 4D depende de la configuración de su despliegue: - - en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, - - en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). +- en las aplicaciones multiusuario, puede confiar en los usuarios y grupos 4D, +- en aplicaciones monousuario, el acceso de los usuarios se controla a través de la sesión del sistema, utilizando comandos como [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md index df220ec536d74a..af0dc26c7caf25 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ En *filePath*, pase la ruta de destino y el nombre del documento a exportar. Si Puede especificar el formato del archivo exportado incluyendo una extensión después del nombre del documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", o ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", o ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si no se incluye la extensión, pero se especifica el formato en *paramObj*, el archivo exportado tendrá la extensión que corresponda al formato, excepto para el formato CSV (en este caso no se añade ninguna extensión). @@ -88,25 +88,25 @@ El parámetro opcional *paramObj* le permite definir múltiples propiedades para **Notas sobre el formato Excel**: - - Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. - - Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. +- Al exportar un documento 4D View Pro a un archivo con formato Microsoft Excel, pueden perderse algunos parámetros. Por ejemplo, los métodos y fórmulas 4D no son soportados por Excel. Puede verificar otras configuraciones con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Se recomienda utilizar el objeto *excelOptions* al exportar en formato ".xlsx". Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) para evitar problemas potientales. **Notas sobre el formato PDF**: - - Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro en PDF, las fuentes utilizadas en el documento se integran automáticamente en el archivo PDF. Sólo se pueden integrar las fuentes OpenType (archivos .OTF o .TTF) que tengan un tabla Unicode. Si no se encuentra un archivo de fuentes válido para una fuente, se utiliza una fuente por defecto. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato CSV**: - - Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. - - Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Al exportar un documento 4D View Pro al formato CSV, es posible que se pierdan algunos parámetros, ya que sólo se guardan el texto y los valores. +- Todos los valores se guardan como cadenas entre comillas. Para más información sobre valores separados por delimitadores, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. **Notas sobre el formato de archivo SpreadJS**: - - Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. - - La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. +- Los [archivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) son archivos comprimidos. +- La exportación en este formato se ejecuta de forma asíncrona, utilice la propiedad `formula` del *paramObj* para el código a ejecutar después de la exportación. Una vez finalizada la operación de exportación, `VP EXPORT DOCUMENT` activa automáticamente la ejecución del método definido en la propiedad *formula* del *paramObj*, si se usa. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md index 4e1ca7ad5d3faf..3cffc70a02a70e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ En *vpAreaName*, pase el nombre de la propiedad del área 4D View Pro. Si pasa u Puede definir dónde obtener las hojas de estilo en el parámetro opcional *sheet* utilizando el índice de la hoja (la numeración comienza en 0) o con las siguientes constantes: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md index a132f4e4e78712..ddf88d1521f080 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ El objeto devuelto contendrá la propiedad `value` y, en caso de un valor fecha Si el objeto devuelto incluye una fecha u hora, se trata como una fecha-hora y se completa de la siguiente manera: - - valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) - - valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) +- valor hora - la parte de la fecha se completa como December 30, 1899 en formato dd/MM/yyyy (30/12/1899) +- valor fecha - la parte de la hora se completa como medianoche en formato HH:mm:ss (00:00:00) Si *rangeObj* contiene varias celdas o varios rangos, se devuelve el valor de la primera celda. El comando devuelve un objeto null si la celda está vacía. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md index ca195bc81d2546..da43df81de44db 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ En *vpAreaName*, pase el nombre del área 4D View Pro. Si pasa un nombre que no En *filePath*, pase la ruta y el nombre del documento a importar. Se soportan los siguientes formatos: - - Los documentos 4D View Pro (extensión ".4vp") - - Microsoft Excel (extensión ".xlsx") - - documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) - - [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Los documentos 4D View Pro (extensión ".4vp") +- Microsoft Excel (extensión ".xlsx") +- documentos texto (extension ".txt", ".csv", el documento debe estar en utf-8) +- [SpreadJS documents](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si la extensión del documento no es una extensión reconocida, como `.4vp` o `.xlsx`, el documento se considera un documento texto. Debe pasar una ruta completa, a menos que el documento se encuentre en el mismo nivel que la carpeta Project, en cuyo caso puede pasar sólo su nombre. @@ -73,11 +73,11 @@ El parámetro opcional *paramObj* permite definir las propiedades del documento :::note Notas - - La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. - - Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- La importación de archivos en formatos .xslx, .csv y .sjs es **asíncrona**. Con estos formatos, debe utilizar el atributo `formula` si desea iniciar una acción al final del procesamiento del documento. +- Al importar un archivo con formato Microsoft Excel a un documento 4D View Pro, algunos parámetros pueden perderse. Puede verificar su configuración con [esta lista de SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Para más información sobre el formato CSV y los valores separados por delimitadores en general, ver [este artículo en Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Se recomienda utilizar el objeto *excelOptions* al importar en formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- La función callback especificada en el atributo `formula` se activa después de que todas las [funciones personalizadas 4D](../formulas.md#4d-functions) dentro del contenido importado hayan completado sus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md index 4746c96876092d..9d54bc19ff1a48 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ El comando `VP RESIZE TABLE` cambi Se aplican las siguientes reglas: - - Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. - - Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. - - Si la tabla se expande en las celdas que contienen datos: +- Los encabezados deben permanecer en la misma línea y el rango de la tabla resultante debe superponerse al rango de la tabla original. +- Si el conteo de líneas de la tabla redimensionada es inferior al conteo de líneas inicial, los valores dentro de las líneas o columnas recortadas se mantienen si no estaban vinculados a un [contexto de datos](vp-set-data-context.md), de lo contrario se eliminan. +- Si la tabla se expande en las celdas que contienen datos: - si se añaden líneas, se eliminan datos, - si se añaden columnas, los datos se mantienen y se muestran en nuevas columnas. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md index c5583c5ef7e576..bf7a7c5e68dbd3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Las hojas de cálculo se componen de líneas y columnas. A cada línea se le aso ### Selección de celdas, columnas y líneas - - Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. +- Para seleccionar una celda, basta con hacer clic en ella o utilizar las flechas de dirección del teclado. Su contenido (o fórmula) se muestra dentro de la celda. - - Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. +- Para seleccionar varias celdas continuas, arrastre el ratón de un extremo a otro de la selección. También puede hacer clic en los dos extremos de la selección mientras mantiene presionada la tecla Mayús. - - Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: +- Para seleccionar todas las celdas de la hoja de cálculo, haga clic en la celda situada en la parte superior izquierda del área: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. +- Para seleccionar una columna, haga clic en la letra (o conjunto de letras) correspondiente. - - Para seleccionar una línea, haga clic en el número correspondiente. +- Para seleccionar una línea, haga clic en el número correspondiente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. +- Para deseleccionar las celdas, basta con hacer clic en cualquier lugar de la hoja de cálculo. ### Entrada de datos @@ -76,8 +76,8 @@ Las áreas 4D View Pro se benefician de un menú contextual automático que ofre Dependiendo del área seleccionada, también están disponibles las siguientes opciones: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - haga clic en una celda o en un rango de celdas: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- haga clic en una celda o en un rango de celdas: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. Cuando se ha introducido un comentario para un área, la celda superior izquierda del área muestra un pequeño triángulo rojo:\ @@ -128,8 +128,8 @@ Luego, puede pasar `$myRange` a otro método 4D View Pro para modificar estas ce Los objetos rango 4D View Pro se componen de varias propiedades: - - area - El nombre del área 4D View Pro - - rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- area - El nombre del área 4D View Pro +- rangos - Una colección de objeto(s) rango. Las propiedades disponibles en cada objeto de rango dependen del tipo de objeto rango. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propiedad | | Tipo | Descripción | Disponible para | | --------- | ------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Los objetos rango 4D View Pro se componen de varias propiedades: 4D View Pro soporta la importación y exportación de varios formatos de documentos: - - .4vp - - .xlsx - - .txt y .csv - - .sjs - - .pdf (sólo para exportación) +- .4vp +- .xlsx +- .txt y .csv +- .sjs +- .pdf (sólo para exportación) Para más detalles, consulte la descripción de [VP IMPORT DOCUMENT](commands/vp-import-document.md) y [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md index 5872ab721ceeae..e63a91059426ad 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Algunos otros elementos tienen una capitalización diferente (por ejemplo: `this Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y sin espacios. Además, los nombres de las constantes de QodlyScript comienzan con la letra `k`. Puede que necesite adaptar estos elementos de QodlyScript al lenguaje 4D. - - Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. - - Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. +- Normalmente, sólo tendrá que convertir los nombres. Por ejemplo, `newCollection` en QodlyScript es `New collection` en lenguaje 4D. +- Sin embargo, algunos comandos han sido renombrados para un mejor cumplimiento, por ejemplo `atan` y `sqrt` son nombres de QodlyScript para los comandos `Arctan` y `Square root` en Lenguaje 4D. ### Ejemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Los nombres de comandos y constantes de QodlyScript se escriben en mayúsculas y end ``` - - Código 4D equivalente: +- Código 4D equivalente: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md index 7f1958b3caa0e6..666a14a5e8f1fe 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ En las secciones anteriores, obtenemos acceso libre a la aplicación desde las p La forma más sencilla y segura de registrar un usuario en el servidor web de 4D se basa en el siguiente escenario: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Cree una tabla con algunos campos, por ejemplo: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md index c7c8d1f1f9b64c..c9312623050565 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ Cuando un manejador de peticiones HTTP personalizado intercepta una solicitud, s Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - gestionar una autenticación a través de oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- gestionar una autenticación a través de oAuth 2.0. ## Requisitos Se soportan gestores de solicitudes HTTP personalizados: - - cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- cuando las [sesiones escalables](./sessions.md#enabling-web-sessions) están habilitadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,20 +72,20 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ Ej: `"pattern": "docs"` o `"pattern": "docs/invoices"` - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Los modelos de expresiones regulares se manejan directamente. Ej: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). #### Concordancia de modelos -URL patterns are triggered in the given order: +Los modelos de URL se activan en el orden indicado: - - se ejecuta el primer modelo coincidente - - the following patterns are not executed even if they match the URL +- se ejecuta el primer modelo coincidente +- los siguientes patrones no se ejecutan aunque coincidan con la URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Clase y método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Debe ser una clase [**compartida**](../Concepts/classes.md#shared-singleton) y [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Ver abajo](#request-handler-code) para obtener información sobre el código del gestor de peticiones. @@ -208,11 +208,11 @@ He aquí un ejemplo detallado de un archivo HTTPHandlers.json: En este ejemplo, debe implementar las siguientes funciones: - - *funciónhandle* en la clase \*GeneralHandling - - *manageAccount* en la clase *UsersHandling* - - *handleInvoices* en la clase *FinancialHandling* - - *handleDocs* en la clase *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* +- *funciónhandle* en la clase \*GeneralHandling +- *manageAccount* en la clase *UsersHandling* +- *handleInvoices* en la clase *FinancialHandling* +- *handleDocs* en la clase *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* en la clase *InvoicesHandling* Examples of URLs triggering the handlers: @@ -278,7 +278,7 @@ El archivo **HTTPHandlers.json**: ] ``` -The called URL is: http://127.0.0.1:8044/putFile?fileName=testFile +La URL llamada es: http://127.0.0.1:8044/putFile?fileName=testFile The binary content of the file is put in the body of the request and a POST verb is used. El nombre del archivo se da como parámetro (*fileName*) en la URL. Se recibe en el objeto [`urlQuery`](../API/IncomingMessageClass.md#urlquery) en la petición. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md index e550be9f53ecce..f5e2388c072a60 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, | Servidor Web | cooperativo | *configuración web* | | Servidor Web Services | cooperativo | *configuración web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de servicios web: gestiona las peticiones SOAP - - ***web setting*** significa que el modo apropiativo depende de un valor de configuración: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de servicios web: gestiona las peticiones SOAP +- ***web setting*** significa que el modo apropiativo depende de un valor de configuración: - cuando se selecciona la opción de [**sesiones escalables**](sessions.md#enabling-web-sessions), el modo apropiativo se utiliza automáticamente para los procesos web. - en caso contrario, se tendrá en cuenta la opción [**Utilizar procesos apropiativos**](webServerConfig.md#use-preemptive-processes). - en lo que respecta a los procesos de servicios web (servidor o cliente), se soporta el modo apropiativo a nivel del método. Sólo tiene que seleccionar la propiedad "Puede ejecutarse en procesos apropiativos" para los métodos del servidor SOAP publicados (ver [Publicación de un servicio web con 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) o los métodos del cliente proxy (ver [Suscripción a un servicio web en 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) y asegurarse de que el compilador confirme que son hilo seguro. @@ -35,21 +35,21 @@ La siguiente tabla indica si el modo apropiativo se utiliza o está disponible, Todo el código 4D ejecutado por el servidor web debe ser hilo seguro si quiere que sus procesos web se ejecuten en modo apropiativo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos los métodos base relacionados con la web: +- Todos los métodos base relacionados con la web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) and [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml +- Básicamente cualquier código procesado por el comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) en el contexto web, por ejemplo a través de páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para tablas con el atributo "Exponer como recurso REST" +- Triggers para tablas con el atributo "Exponer como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST Para cada uno de estos métodos y partes de código, el compilador comprobará si se respetan las reglas de seguridad de hilos, y devolverá errores en caso de que haya problemas. Para más información sobre las reglas hilo seguro, consulte el párrafo *Escribir un método hilo seguro* en el capítulo *Procesos* del manual de [Lenguaje 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ La mayoría de los comandos y funciones 4D relacionados con la web, los métodos Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Por supuesto, el código ejecutado por estos métodos también debe ser hilo seg Las siguientes URLs 4D Web Server son hilo seguro y pueden ser utilizadas en modo apropiativo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dcgi/* (los métodos base llamados también deben ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dcgi/* (los métodos base llamados también deben ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para peticiones web en campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Icono de proceso web apropiativo diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md index 68ca1d789a33e9..d9109179cd08e4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio también puede utilizarse en la [**plataforma Qodly Cloud**](https: Qodly Studio propone una interfaz web completa, que le permite: - - create Qodly pages by placing components on a canvas - - mapear componentes a Qodly Sources - - activar código 4D configurando eventos - - y mucho más. +- create Qodly pages by placing components on a canvas +- mapear componentes a Qodly Sources +- activar código 4D configurando eventos +- y mucho más. ## Configuración @@ -24,19 +24,19 @@ Qodly Studio propone una interfaz web completa, que le permite: Qodly Studio soporta los siguientes navegadores web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La resolución recomendada es 1920x1080. #### Aplicación 4D - - Desarrollo: 4D v20 R2 o superior - - Despliegue: 4D Server v20 R2 o superior - - Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). - - Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). - - El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). +- Desarrollo: 4D v20 R2 o superior +- Despliegue: 4D Server v20 R2 o superior +- Qodly Studio solo funciona con proyectos 4D (no soporta bases de datos binarias). +- Las sesiones web (*igualmente llamadas sesiones escalables*) deben [estar activadas](sessions.md#enabling-web-sessions). +- El código 4D llamado por los formularios Qodly debe ser [hilo seguro](preemptiveWeb.md). ### Acceso a Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio es servido por el [servidor web WebAdmin](../Admin/webAdmin.md) y m Para permitir el acceso a Qodly Studio, debe permitirlo explícitamente en dos niveles: - - a nivel de la aplicación 4D - - a nivel del proyecto +- a nivel de la aplicación 4D +- a nivel del proyecto Si uno de los dos niveles (o ambos) no están habilitados, se niega el acceso a Qodly Studio (se devuelve una página 403). @@ -79,8 +79,8 @@ La autenticación en el servidor web WebAdmin se realiza utilizando una llave de De acuerdo con la gestión de proyectos 4D, sólo se admiten los siguientes usos: - - el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- el desarrollo con Qodly Studio debe realizarse a través de **4D** (monousuario). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La página Qodly Studio está disponible cuando el [servidor web WebAdmin está Hay dos formas de acceder a Qodly Studio: - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si el servidor web WebAdmin ya está en funcionamiento, dependiendo de su configuración, su navegador por defecto se abre en `IPaddress:HTTPPort/studio` o `IPaddress:HTTPSPort/studio`. De lo contrario, se le preguntará si desea iniciar primero el servidor web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` o: @@ -146,24 +146,24 @@ No existe compatibilidad directa entre las aplicaciones implementadas con 4D y l Los siguientes comandos y clases están dedicados a la gestión del lado del servidor de las páginas Qodly: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. - - Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. - - Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. - - clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): devuelve la página Qodly como un objeto. +- Comando [`Web Event`](../API/WebFormClass.md#web-event): devuelve los eventos desencadenados dentro de los componentes de página ´gQodly. +- Clase [`WebForm`](../API/WebFormClass.md): funciones y propiedades para gestionar la página Qodly renderizada. +- clase [`WebFormItem`](../API/WebFormItemClass.md): funciones y propiedades para administrar componentes de página Qodly. ### Uso métodos proyecto Recomendamos utilizar funciones clase en lugar de métodos proyecto. Sólo las funciones de clase pueden ser llamadas desde los componentes. Sin embargo, puede seguir utilizando sus métodos de proyecto en Qodly Studio de dos maneras: - - Puede llamar a sus métodos desde funciones clase. - - Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. +- Puede llamar a sus métodos desde funciones clase. +- Puede [ejecutar sus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) directamente desde el Explorador Qodly. ### Uso sin conexión Puede desarrollar con Qodly Studio mientras su ordenador no esté conectado a Internet. En este caso, sin embargo, las siguientes funciones no están disponibles: - - [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía - - Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). +- [Plantillas](https://developer.qodly.com/docs/studio/pageLoaders/templates): la librería de plantillas está vacía +- Consejos de interfaz de usuario: no se muestran al hacer clic en los iconos ![alt-text](../assets/en/WebServer/tips.png). ## Despliegue @@ -179,8 +179,8 @@ Mira [esta página](https://developer.qodly.com/docs/studio/rendering) para obte Para habilitar el renderizado de las páginas Qodly, se deben configurar las siguientes opciones. - - La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. - - El [servidor web 4D](webServer.md) debe estar ejecutándose. +- La opción **Configuración** > **Web** > **Funcionalidades web** > [**Exponer como servidor REST**](../configuración/web.md#expose-as-rest-server) del proyecto 4D debe estar activada. +- El [servidor web 4D](webServer.md) debe estar ejecutándose. :::note @@ -310,9 +310,9 @@ Para cerrar la sesión del usuario, solo necesita ejecutar la acción estándar Al desencadenar la acción de cierre de sesión de una sesión de usuario web, se producen los siguientes efectos: - - la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), - - se libera la licencia asociada de 4D, - - el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. +- la sesión de usuario web actual pierde sus privilegios, sólo se permiten [peticiones REST descriptivas](../REST/authUsers.md#descriptive-rest-requests), +- se libera la licencia asociada de 4D, +- el tiempo de espera de 'Session.storage' se mantiene hasta que se alcanza el tiempo de inactividad de la sesión web (al menos una hora). Durante este periodo tras un cierre de sesión, si el usuario vuelve a iniciar sesión, se utiliza la misma sesión y el objeto compartido `Session.storage` está disponible con su contenido actual. ## Acerca del uso de licencias para renderización @@ -364,7 +364,7 @@ Para más información sobre el atributo `SameSite`, consulte [esta entrada de b Para evitar utilizar más licencias de las necesarias, recomendamos hacer una de las siguientes cosas: - - Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. - - Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. +- Ejecute el renderizador en otra pestaña del navegador (introduciendo la URL renderizada de su página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Asegúrese de que Qodly Studio y su base de datos se alcanzan en el mismo esquema URL. +- Utilice el valor `Lax` para la [cookie de sesión](webServerConfig.md#session-cookie-samesite) del servidor web de la base de datos de su proyecto. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md index 9f07c189b3543c..fe6a075457925b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Las siguientes etiquetas 4D están disponibles: - - 4DTEXT, para insertar variables y expresiones 4D como texto, - - 4DHTML, para insertar el código HTML, - - 4DEVAL, para evaluar toda expresión 4D, - - 4DSCRIPT, para ejecutar un método 4D, - - 4DINCLUDE, para incluir una página dentro de otra, - - 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, - - 4DCODE, para insertar el código 4D, - - 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, - - 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, - - 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. +- 4DTEXT, para insertar variables y expresiones 4D como texto, +- 4DHTML, para insertar el código HTML, +- 4DEVAL, para evaluar toda expresión 4D, +- 4DSCRIPT, para ejecutar un método 4D, +- 4DINCLUDE, para incluir una página dentro de otra, +- 4DBASE, para modificar la carpeta por defecto utilizada por la etiqueta 4DINCLUDE, +- 4DCODE, para insertar el código 4D, +- 4DIF, 4DELSE, 4DELSEIF y 4DENDIF, para insertar condiciones en el código HTML, +- 4DLOOP y 4DENDLOOP, para hacer bucles en el código HTML, +- 4DEACH y 4DENDEACH, para hacer bucles en colecciones, selecciones de entidades o propiedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md index 2426aba0213929..3a3ad6511e0fe4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un proyecto 4D puede iniciar y monitorizar un servidor web para la aplicación p El servidor web principal de 4D puede iniciarse de diferentes maneras: - - Utilizando un botón o comando de menú. +- Utilizando un botón o comando de menú. - 4D: **Ejecutar\>Iniciar el servidor Web** menú
![](../assets/en/WebServer/start1.png) - 4D Server: botón **Iniciar servidor HTTP** de la página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) +- Se inicia automáticamente cada vez que se abre la aplicación 4D. Para ello, despliegue la página **Web\/Configuración** de la Configuración y active la casilla **Lanzar servidor web al iniciar**:
![](../assets/en/WebServer/config.png) - - Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. +- Programáticamente, llamando a la función [`webServer.start()`](API/WebServerClass.md#start) o al comando `WEB START SERVER`. El servidor web de todo componente puede ser lanzado llamando a la función [`webServer.start()`](API/WebServerClass.md#start) en el objeto servidor web del componente. @@ -29,9 +29,9 @@ El servidor web de todo componente puede ser lanzado llamando a la función [`we El servidor web principal de 4D puede detenerse de diferentes maneras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. +- Programáticamente, llamando a la función [`webServer.stop()`](API/WebServerClass.md#stop) o al comando `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ En cualquier momento, puede vacíar la caché de las páginas y de las imágenes Para ello, puede: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. La caché se borra inmediatamente. @@ -64,11 +64,11 @@ La caché se borra inmediatamente. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta información sólo está disponible si el servidor web está activo y si el tamaño de la caché es mayor que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta información sólo está disponible si el servidor web está activo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta información sólo está disponible si el servidor web está activo. ## URL para la administración @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Cuando se llam 4D le permite generar dos historiales de peticiones web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md index 244df1ec2bc429..82af1b6f04e9a6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts y métodos permitidos para el servicio CORS. Nombre de dominio o dirección IP desde donde las páginas externas pueden enviar solicitudes de datos al Servidor a través de CORS. Se pueden añadir múltiples atributos de dominio para crear una lista blanca. Se soportan varias sintaxis: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propiedad methods) Métodos HTTP aceptados para el host CORS correspondiente. Se soportan los siguientes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separe cada método con un ";" (por ejemplo: "post;get"). Si methods está vacío, null o indefinido, todos los métodos están activos. @@ -145,9 +145,9 @@ Por defecto, cuando el servidor web se lanza por primera vez, 4D crea una págin Puede designar otra página de inicio por defecto introduciendo su nombre de ruta. - - La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - La ruta no debe comenzar ni terminar con una barra. +- La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- La ruta no debe comenzar ni terminar con una barra. Por ejemplo, si quiere que la página de inicio por defecto sea "MyHome.htm", y se encuentra en la carpeta "Web" (situada a su vez en la carpeta raíz HTML por defecto), utilice "Web/MyHome.htm". @@ -318,13 +318,13 @@ Valores posibles: cadena de direcciones IP. Los formatos IPv6 (por ejemplo "2001 #### Acerca de la compatibilidad con IPv6 - - **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. +- **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. De hecho, el servidor 4D no detecta ningún error en este caso porque el puerto permanece libre en la dirección IPv6. Sin embargo, no es posible acceder a ella utilizando la dirección IPv4 de la máquina, ni mediante la dirección local 127.0.0.1. Si su servidor 4D no parece responder en el puerto definido, puede probar la dirección [::1] en la máquina del servidor (equivalente a 127.0.0.1 para IPv6, añada [:portNum] para probar otro número de puerto). Si 4D responde, es probable que otra aplicación esté utilizando el puerto en IPv4. - - **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. +- **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Estas direcciones se escriben con un prefijo de 96 bits en formato IPv6, seguido de 32 bits escritos en la notación decimal punto de IPv4. Por ejemplo, ::ffff:192.168.2.34 representa la dirección IPv4 192.168.2.34. - - **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: +- **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: ```code4d 2001:0DB8::85a3:0:ac1f:8001 // Dirección IPv6 @@ -417,10 +417,10 @@ Versión mínima de TLS aceptada para las conexiones. Se rechazarán los intento Valores posibles: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (por defecto) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (por defecto) +- 4 = TLSv1_3 Valores posibles: @@ -486,10 +486,10 @@ Por ejemplo: Disallow: /GIFS/ ``` - - “User-Agent: \*” - todos los robots son afectados. - - “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. - - “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. - - “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. +- “User-Agent: \*” - todos los robots son afectados. +- “Disallow: /4D” - Los robots no están autorizados a acceder a los URLs comenzando por/4D. +- “Disallow: /%23%23” - Los robots no están autorizados a acceder a los URLs comenzando por/%23%23. +- “Disallow: /GIFS/’ - Los robots no pueden acceder a la carpeta /GIFS/ ni a sus subcarpetas. Otro ejemplo: @@ -514,15 +514,15 @@ Además, la carpeta raíz HTML define, en el disco duro del servidor web, el niv Por defecto, 4D define una carpeta raíz HTML llamada **WebFolder**. Si no existe, la carpeta raíz HTML se crea físicamente en el disco en el momento en que se lanza el servidor web por primera vez. Se crea la carpeta raíz: - - con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). - - con 4D en modo remoto, en la carpeta de recursos locales. +- con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). +- con 4D en modo remoto, en la carpeta de recursos locales. Puede designar otra página carpeta HTML raíz por defecto introduciendo su ruta de acceso. - - La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). - - La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) - - Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta - - La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). +- La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). +- La ruta se expresa con la sintaxis POSIX (las carpetas se separan con una barra ("/")) +- Para "subir" un nivel en la jerarquía de las carpetas, introduzca "." (dos puntos) antes del nombre de la carpeta +- La ruta no debe comenzar con una barra (excepto si quiere que la carpeta raíz HTML sea la carpeta remota del proyecto o de 4D, pero que el acceso a las carpetas anteriores esté prohibido, en cuyo caso puede pasar "/" como carpeta raíz). Por ejemplo, si quiere que la carpeta raíz HTML sea la subcarpeta "Web" de la carpeta "MyWebApp", introduzca "MyWebApp/Web". @@ -577,9 +577,9 @@ Valor del atributo `SameSite` de la cookie de sesión. Este atributo le permite Hay tres valores disponibles: - - "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. - - "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). - - "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. +- "Lax": las cookies no se envían en las subpeticiones de sitios cruzados (por ejemplo, para cargar imágenes o marcos en un sitio de terceros), sino que se envían cuando un usuario está navegando hacia el sitio de origen (es decir, sigue un enlace). +- "Ninguna": las cookies se envían en todos los contextos, es decir, en las respuestas a las solicitudes de primera parte y de origen cruzado. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). El valor del atributo `Secure` de la cookie de sesión se define automáticamente en "True" si la conexión es HTTPS (sea cual sea el valor del atributo `SameSite`). @@ -623,9 +623,9 @@ En algunos casos, se pueden invocar otras funciones internas optimizadas. Las co Dos opciones le permiten definir cómo funcionan las conexiones persistentes: - - **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

+- **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Once this period is over, the server closes the connection.

+- **Tiempo de espera antes de desconexión**: este valor define el periodo máximo de espera (en segundos) durante el cual el servidor web mantiene una conexión TCP abierta sin recibir ninguna petición del navegador web. Once this period is over, the server closes the connection.

Si el navegador web envía una solicitud después de cerrar la conexión, se crea automáticamente una nueva conexión TCP. Esta operación no es visible para el usuario.

diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md index 4eee0fff8607b1..2215d57311fd1f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un proyecto 4D puede iniciar y monitorear un servidor web para la aplicación pr Por ejemplo, si ha instalado dos componentes en su aplicación principal, puede iniciar y supervisar hasta tres servidores web independientes desde su aplicación: - - un servidor web para la aplicación local, - - un servidor web para el componente #1, - - un servidor web para el componente #2. +- un servidor web para la aplicación local, +- un servidor web para el componente #1, +- un servidor web para el componente #2. Aparte de la memoria, no hay límite en el número de componentes y por lo tanto, de servidores web, que se pueden adjuntar a un solo proyecto de aplicación 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicación local o componente) puede ser utilizado en su propio contexto independiente, incluyendo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - el procesamiento de las etiquetas 4D y las llamadas de métodos, - - sesiones web y gestión del protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- el procesamiento de las etiquetas 4D y las llamadas de métodos, +- sesiones web y gestión del protocolo TLS. Esto le permite desarrollar componentes independientes y funcionalidades que vienen con sus propias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si la aplicación utiliza componentes y quiere llamar a: - - el servidor web de la aplicación local a partir de un componente o - - el servidor que ha recibido la solicitud (sin importar el servidor), +- el servidor web de la aplicación local a partir de un componente o +- el servidor que ha recibido la solicitud (sin importar el servidor), también se puede utilizar: @@ -94,8 +94,8 @@ Estas propiedades son definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. si no se utiliza, en los parámetros de la aplicación local o del componente. - - Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. - - Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). +- Si el servidor web no se inicia, las propiedades contienen los valores que se utilizarán en el próximo inicio del servidor web. +- Si se inicia el servidor web, las propiedades contienen los valores reales utilizados por el servidor web (la configuración predeterminada podría haber sido anulada por el parámetro `settings` de la función [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion*, y *perfectForwardSecrecy* son propiedades de sólo lectura que no pueden predefinirse en el parámetro del objeto `settings` para la función [`start()`](API/WebServerClass.md#start). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md index 775755c86b19a5..aaf5a0ae4cbc51 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ El comando **WP Insert break** inse En *targetObj*, pase: - - un rango, o - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - un documento 4D Write Pro +- un rango, o +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- un documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insertar el contenido al principio del objetivo | | wk replace | Integer | 0 | Sustituir contenido de destino | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Constante | Tipo | Valor | Comentario | | --------------------- | ------- | ----- | ------------------------------------------------------------------------------------- | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Si *targetObj* no es un rango, *rangeUpdate* se ignora. +- Si *targetObj* no es un rango, *rangeUpdate* se ignora. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md index 90b584c29f6f92..9b4b9d5dd56d7d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ El comando **WP Insert document body**El comando **Form** devuelve el objeto asociado al formulario actual (instanciado a partir del parámetro *formData* o de la clase de usuario asignada en el editor de formularios). 4D automatically associates an object to the current form in the following cases: - - el formulario actual ha sido cargado por uno de los comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), - - el formulario actual es un subformulario, - - un formulario de tabla se muestra actualmente en la pantalla. +- el formulario actual ha sido cargado por uno de los comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), +- el formulario actual es un subformulario, +- un formulario de tabla se muestra actualmente en la pantalla. ### Comandos (DIALOG...) Si el formulario actual se está mostrando o cargando mediante una llamada a los comandos [DIALOG](dialog.md), [`Print form`](print-form.md), o [`FORM LOAD`](form-load.md), **Form** devuelve cualquiera de los dos: - - el objeto *formData* pasado como parámetro a este comando, si existe, - - o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, - - o, un objeto vacío. +- el objeto *formData* pasado como parámetro a este comando, si existe, +- o, un objeto instanciado de la [clase de usuario asociada al formulario](../FormEditor/properties_FormProperties.md#form-class), si existe, +- o, un objeto vacío. ### Subformulario Si el formulario actual es un subformulario, el objeto devuelto depende de la variable contenedor padre: - - Si la variable asociada al contenedor padre ha sido tipificada como objeto, **Form** devuelve el valor de esta variable.\ +- Si la variable asociada al contenedor padre ha sido tipificada como objeto, **Form** devuelve el valor de esta variable.\ En este caso, el objeto devuelto por **Form** es el mismo que el devuelto por la siguiente expresión: ```4d (OBJECT Get pointer(Object subform container))-> ``` - - Si la variable asociada al contenedor padre no ha sido tipificada como objeto, **Form** devuelve un objeto vacío, mantenido por 4D en el contexto del subformulario. +- Si la variable asociada al contenedor padre no ha sido tipificada como objeto, **Form** devuelve un objeto vacío, mantenido por 4D en el contexto del subformulario. Para más información, consulte la sección *Subformularios de página*. @@ -69,7 +69,7 @@ En un formulario que muestra el registro de una persona, un botón "Check childr **Nota:** el campo objeto "Children" se representa sólo para mostrar su estructura en este ejemplo. -En el formulario de verificación, ha asignado algunas propiedades del objeto Formulario a las entradas: +En el formulario de verificación, ha asignado algunas propiedades del objeto Form a las entradas: ![](../assets/en/commands/pict3541682.en.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md index 6154cc3aea3326..5d6d8d4c2581f6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Si el nuevo índice del elemento está más allá del último elemento existente Puede pasar cualquier número de valores de los siguientes tipos soportados: - - number (real, longint...). Los valores numéricos se almacenan siempre como reales. - - text - - boolean - - date - - time (almacenado como número de milisegundos - real) - - null - - objeto compartido - - colección compartida +- number (real, longint...). Los valores numéricos se almacenan siempre como reales. +- text +- boolean +- date +- time (almacenado como número de milisegundos - real) +- null +- objeto compartido +- colección compartida :::note diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md index d4450f98092e22..b1777d0a1ecce1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs En el parámetro *form*, puede pasar: - - el nombre de un formulario, o - - la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o - - un objeto que contiene la descripción del formulario. +- el nombre de un formulario, o +- la ruta (en sintaxis POSIX) de un archivo .json válido que contenga una descripción del formulario a utilizar (ver *Ruta de acceso al archivo de formulario*), o +- un objeto que contiene la descripción del formulario. Como **Print form** no genera un salto de página después de imprimir el formulario, es fácil combinar diferentes formularios en la misma página. Así, **Print form** es perfecto para tareas de impresión complejas que implican diferentes tablas y diferentes formularios. Para forzar un salto de página entre formularios, utilice el comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir la impresión a la página siguiente de un formulario cuya altura es superior al espacio disponible, invoque el comando [CANCEL](../commands-legacy/cancel.md) antes del comando [PAGE BREAK](../commands-legacy/page-break.md). Se pueden utilizar tres sintaxis diferentes: - - **Impresión de área de detalle** +- **Impresión de área de detalle** Sintaxis: @@ -43,7 +43,7 @@ Sintaxis: En este caso, **Print form** sólo imprime el área de detalle del formulario (el área entre la línea de encabezado y la línea de detalle). - - **Impresión de área de formulario** +- **Impresión de área de formulario** Sintaxis: @@ -79,7 +79,7 @@ En este caso, el comando imprimirá la sección designada por el *marker*. Pase | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impresión de sección** +- **Impresión de sección** Sintaxis: @@ -101,8 +101,8 @@ El valor devuelto por **Print form** indica la altura del área de impresión. E Las cajas de diálogo de la impresora no aparecen cuando se utiliza **Print form**. El informe no utiliza la configuración de impresión definida en el modo Diseño para el formulario. Hay dos formas de especificar los parámetros de impresión antes de realizar una serie de llamadas a **Print form**: - - Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. - - Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. +- Llamar a [PRINT SETTINGS](../commands-legacy/print-settings.md). En este caso, deja que el usuario elija la configuración. +- Llame a [SET PRINT OPTION](../commands-legacy/set-print-option.md) y [GET PRINT OPTION](../commands-legacy/get-print-option.md). En este caso, los parámetros de impresión se especifican por programación. **Print form** crea cada página impresa en la memoria. Cada página se imprime cuando la página en memoria está llena o cuando se llama a [PAGE BREAK](../commands-legacy/page-break.md). Para asegurar la impresión de la última página después de cualquier uso de **Print form**, debe concluir con el comando [PAGE BREAK](../commands-legacy/page-break.md) (excepto en el contexto de un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). En caso contrario, si la última página no está llena, permanece en memoria y no se imprime. @@ -116,8 +116,8 @@ Este comando imprime áreas y objetos externos (por ejemplo, áreas 4D Write o 4 **4D Server:** este comando puede ejecutarse en 4D Server en el marco de un procedimiento almacenado. En este contexto: - - Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). - - En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. +- Asegúrese de que no aparezca ningún cuadro de diálogo en el equipo servidor (salvo que se trate de un requisito específico). +- En el caso de un problema relacionado con la impresora (falta de papel, impresora desconectada, etc.), no se genera ningún mensaje de error. ## Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md index b4751f2dfdaa35..d4a6922bde6cc9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md @@ -44,7 +44,7 @@ El objeto devuelto contiene las siguientes propiedades: | type | Integer | Tipo de proceso en ejecución. Valores posibles: ver abajo | | visible | Boolean | True si es visible, false en caso contrario | - - Valores posibles para "state": +- Valores posibles para "state": | Constante | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ El objeto devuelto contiene las siguientes propiedades: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores posibles para "type": +- Valores posibles para "type": | Constante | Valor | | ----------------------------- | ----- | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/session.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/session.md index b7f7e51f07b0c6..2da30fc83dedf0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/session.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Ver también +## Ver también [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md index e3802249a306f6..2682c1471d6107 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md @@ -13,8 +13,8 @@ Las páginas Cliente-Servidor agrupan los parámetros relacionados con el uso de Esta opción le permite indicar si la base de datos 4D Server aparecerá o no en la lista de bases de datos publicadas. - - Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). - - Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. +- Cuando esta opción está marcada (por defecto), la base de datos se hace pública y aparece en la lista de bases de datos publicadas (pestaña**Disponible**). +- Cuando la opción no está marcada, la base de datos no se hace pública y no aparece en la lista de bases de datos publicadas. Para conectarse, los usuarios deben introducir manualmente la dirección de la base de datos en la pestaña **Personalizada** de la caja de diálogo de conexión. :::note @@ -49,11 +49,11 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con 4D Server utiliza tres puertos TCP para las comunicaciones entre los servidores internos y los clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). - - **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Servidor de aplicaciones**: 19813 por defecto (puede modificarse a través de la página "Cliente-Servidor/Configuración" de las Preferencias, ver arriba). +- **Servidor DB4D** (servidor de base de datos): 19814 por defecto. Este número de puerto no se puede modificar directamente, pero siempre consiste en el número de puerto del servidor de aplicaciones + 1. Cuando un cliente 4D se conecta a 4D Server, utiliza el puerto TCP del servidor de aplicaciones (19813 o el puerto indicado después de los dos puntos ':' en la dirección IP mostrada en la caja de diálogo de conexión). La conexión a otros servidores a través de sus respectivos puertos es entonces automática; ya no es necesario especificarlos.\ Tenga en cuenta que en caso de acceso a través de un enrutador o un cortafuegos, los tres puertos TCP deben abrirse explícitamente. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por defecto. Este número de puerto no puede modificarse directamente, pero siempre consta del número de puerto del servidor de aplicaciones + 2. #### Autenticación del usuario con el servidor de dominio @@ -67,9 +67,9 @@ Cuando la autenticación única (SSO) está activa (ver arriba), debe llenar est Esta caja desplegable contiene 3 opciones de capa de red a elegir entre: **legacy**, **ServerNet** y **QUIC** (sólo en modo proyecto), que se utilizan para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). - - **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legal**: esta antigua capa de red "Legal" sigue siendo soportada para garantizar la compatibilidad de las bases de datos creadas antes de la v15. Esta capa de red también puede habilitarse por programación utilizando el comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por defecto): activa la capa de red de ServerNet en el servidor (disponible desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -109,9 +109,9 @@ Esta opción permite activar el modo seguro para las comunicaciones entre la má Este parámetro puede utilizarse para definir globalmente el modo de actualización de la instancia local de la carpeta **Resources** en los equipos 4D conectados cuando se modifica la carpeta **Resources** de la base de datos durante la sesión (la carpeta **Resources** se sincroniza automáticamente en el equipo remoto cada vez que se abre una sesión). Hay tres parámetros disponibles: - - **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. - - **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ +- **Nunca**: la carpeta local **Resources** no se actualiza durante la sesión. La notificación enviada por el servidor es ignorada. La carpeta **Resources** local puede actualizarse manualmente mediante el comando **Update Local Resources** del menú de acción (ver [Uso del explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Siempre**: la sincronización de la carpeta local **Resources** se realiza automáticamente durante la sesión cada vez que el servidor envía una notificación. +- **Preguntar**: cuando la notificación es enviada por el servidor, se muestra una caja de diálogo en las máquinas cliente, indicando la modificación. A continuación, el usuario puede aceptar o rechazar la sincronización de la carpeta local **Resources**.\ La carpeta **Resources** centraliza los archivos personalizados necesarios para la interfaz de la base (archivos de traducción, imágenes, etc.). Se pueden utilizar mecanismos automáticos o manuales para notificar a cada cliente cuándo se ha modificado el contenido de esta carpeta. Para más información, consulte la sección [Gestión de la carpeta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuración IP @@ -124,10 +124,10 @@ Esta tabla permite definir las reglas de control de acceso a la base en función El funcionamiento de la tabla de configuración es el siguiente: - - La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. - - La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. - - La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. - - Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: +- La columna "Autorizar-Rechazar" permite seleccionar el tipo de regla a aplicar (Autorizar-Rechazar) mediante un menú emergente. Para añadir una regla, haga clic en el botón Añadir. Aparece una nueva línea en la tabla. El botón **Borrar** permite eliminar la línea actual. +- La columna "Dirección IP" permite designar las direcciones IP afectadas por la regla. Para especificar una dirección, haga clic en la columna e introduzca la dirección de la siguiente forma: 123.45.67.89 (formato IPv4) o 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Puede utilizar un caracter \* (asterisco) para especificar las direcciones del tipo "comienza por". Por ejemplo, 192.168.\* indica todas las direcciones que empiezan por 192.168. +- La aplicación de las reglas se basa en el orden de visualización de la tabla. Si dos reglas son contradictorias, se da prioridad a la regla situada más arriba en la tabla. Puede reordenar las líneas modificando la ordenación actual (haga clic en el encabezado de la columna para alternar la dirección de la ordenación). También puede mover las líneas utilizando arrastrar y soltar. +- Por razones de seguridad, sólo las direcciones que realmente coincidan con una regla podrán conectarse. En otras palabras, si la tabla sólo contiene una o más reglas de tipo Rechazar, todas las direcciones serán rechazadas porque ninguna coincidirá con al menos una regla. Si desea denegar sólo determinadas direcciones (y permitir otras), añada una regla Autorizar\* al final de la tabla. Por ejemplo: - Denegar 192.168.\* (denegar todas las direcciones que empiecen por 192.168) - Autorizar \* (y permitir todas las demás direcciones) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md index 486f1c14d151de..9865cbdbab0102 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md @@ -8,10 +8,10 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien > El número de opciones mostradas depende de la versión de 4D con la que se creó la base de datos/proyecto original, así como de los ajustes modificados en esta base de datos/proyecto.\ > Esta página enumera las opciones de compatibilidad disponibles para las bases de datos/proyectos convertidos a partir de 4D v18. Para las opciones de compatibilidad más antiguas, consulte la [página Compatibilidad](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) en **doc.4d.com**. - - **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. +- **Utilizar la capa de red heredada**: a partir de 4D v15, las aplicaciones 4D proponen una nueva capa red, llamada *ServerNet*, para manejar las comunicaciones entre 4D Server y las máquinas 4D remotas (clientes). La antigua capa de red ha quedado obsoleta, pero se mantiene para garantizar la compatibilidad con las bases existentes. Utilizando esta opción, puede activar la antigua capa de red en cualquier momento en sus aplicaciones 4D Server dependiendo de sus necesidades. *ServerNet* se utiliza automáticamente para las nuevas bases y las bases convertidas a partir de una versión v15 o posterior. Tenga en cuenta que, en caso de modificación, deberá reiniciar la aplicación para que se tenga en cuenta el cambio. Toda aplicación cliente que estuviera conectada también debe reiniciarse para poder conectarse con la nueva capa de red. **Nota**: esta opción también puede gestionarse por programación utilizando el comando `SET DATABASE PARAMETER`. - - **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: +- **Utilizar XPath estándar**: por defecto, esta opción está desmarcada para las bases convertidas desde una versión 4D anterior a la v18 R3, y marcada para las bases creadas con 4D v18 R3 y superiores. A partir de la v18 R3, la implementación de XPath en 4D ha sido modificada para ser más compatible y soportar más predicados. Como consecuencia, las funcionalidades no estándar de la implementación anterior ya no funcionan. Incluyen: - el caracter inicial "/" no es sólo el nodo raíz - la utilización del caracter / como primer caracter en una expresión XPath no declara una ruta absoluta desde el nodo raíz - no hay nodo actual implícito - el nodo actual debe incluirse en la expresión XPath @@ -19,12 +19,12 @@ La página Compatibilidad agrupa los parámetros relacionados con el mantenimien Aunque no es estándar, es posible que desee seguir utilizando estas funcionalidades para que su código siga funcionando como antes -- en este caso, basta con establecer la opción *desmarcarcada*. Por otra parte, si su código no se basa en la implementación no estándar y si desea beneficiarse de las funcionalidades extendidas de XPath en sus bases de datos (como se describe en el comando [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md)), asegúrese de que la opción \**Utilizar XPath estándar* esté *marcada*. - - **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utilizar LF como caracter de fin de línea en macOS**: a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos texto con salto de línea (LF) como caracter de fin de línea (EOL) por defecto en lugar de CR (CRLF para xml SAX) en macOS en nuevos proyectos. Si desea beneficiarse de este nuevo comportamiento en proyectos convertidos a partir de versiones anteriores de 4D, marque esta opción. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- \*\*No añadir un BOM al escribir un archivo de texto unicode por defecto:\*\*a partir de 4D v19 R2 (y 4D v19 R3 para archivos XML), 4D escribe archivos de texto sin BOM ("Byte order mark") por defecto. En las versiones anteriores, los archivos texto se escribían con un BOM por defecto. Seleccione esta opción si desea activar el nuevo comportamiento en los proyectos convertidos. Ver [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), y [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). +- **Mapear valores NULL a valores en blanco sin marcar por defecto una creación de campo**: para un mejor cumplimiento con las especificaciones ORDA, en bases de datos creadas con 4D v19 R4 y superiores, la propiedad de campo **Mapear valores NULL a valores en blanco** no está marcada por defecto cuando creas campos. Puede aplicar este comportamiento por defecto a sus bases de datos convertidas marcando esta opción (se recomienda trabajar con valores Null, ya que están totalmente soportados por [ORDA](../ORDA/overview.md). - - **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). +- **Impresión sin bloqueo**: a partir de 4D v20 R4, cada proceso tiene sus propias configuraciones de impresión (opciones de impresión, impresora actual, etc.), lo que le permite ejecutar múltiples trabajos de impresión simultáneamente. Marque esta opción si desea beneficiarse de esta nueva implementación en sus proyectos 4D convertidos o bases de datos convertidas de modo binario a modo proyecto. **Si se deja sin marcar**, se aplica la implementación anterior: la configuración actual de impresión 4D se aplica globalmente, la impresora se pone en modo "ocupado" cuando hay un trabajo de impresión en marcha, se debe llamar a `CLOSE PRINTING JOB` para que la impresora esté disponible para el siguiente trabajo de impresión (consulte la documentación anterior de 4D para más información). - - **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Guardar el color y las coordenadas de la estructura en un archivo catalog_editor.json separado**: a partir de 4D v20 R5, cambios realizados en el editor de estructura en relación a la apariencia gráfica de tablas y campos (color, posición, orden...) se guardan en un archivo independiente llamado `catalog_editor.json`, almacenado en la carpeta [Sources] del proyecto(../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. Por razones de compatibilidad, esta funcionalidad no está habilitada por defecto en proyectos convertidos de versiones anteriores de 4D, necesita marcar esta opción. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/database.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/database.md index 07a07d9635560d..bb4303daa68eff 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/database.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/database.md @@ -31,9 +31,9 @@ La ubicación actual de esta carpeta se muestra en el área "Actual:". Puede hac Se ofrecen tres opciones de ubicación: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Puede averiguar la ubicación actual definida por su sistema utilizando el comando [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D. Los archivos se colocan en una subcarpeta cuyo nombre está formado por el nombre de la base y un identificador único. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Si se modifica la opción de ubicación, será necesario reiniciar la base para que se tenga en cuenta la nueva opción. 4D verifica si se puede acceder a la carpeta seleccionada mediante escritura. Si no es así, la aplicación prueba otras opciones hasta encontrar una carpeta válida. > Esta opción se almacena en las "propiedades adicionales" de la estructura, accesibles durante la exportación XML de la definición de estructura (ver [Exportar e importar las definiciones de estructura](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +41,7 @@ Se ofrecen tres opciones de ubicación: > Si cambia una de estas opciones, tiene que salir y volver a abrir la base para que el cambio surta efecto. Una vez reabierta la base, se vuelven a indexar automáticamente todos sus índices. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Cuando la opción está marcada, la arroba se considera un caracter simple si se encuentra dentro de una palabra. Esta posibilidad es especialmente útil cuando se buscan direcciones de correo electrónico, donde el signo @ se utiliza internamente. Esta opción influye en las búsquedas, ordenaciones, comparaciones de cadenas de caracteres, así como en los datos almacenados en las tablas y los que se encuentran en memoria, como los arrays. Los campos y variables de tipo alfa (indexados o no) y texto se ven afectados por como se interpreta el caracter @ en las búsquedas y ordenaciones. @@ -52,19 +52,19 @@ Se ofrecen tres opciones de ubicación: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razones de seguridad, sólo el Administrador o Diseñador de la base de datos puede modificar este parámetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. La elección de un idioma de comparación afecta a la ordenación y la búsqueda de textos, así como al cambio entre minúsculas y mayúsculas, pero no afecta a la traducción de etiquetas ni a los formatos de fecha, hora o moneda, que permanecen en el idioma del sistema. Por defecto, 4D utiliza el lenguaje del sistema. Así, un proyecto 4D puede funcionar en un lenguaje distinto del del sistema. Cuando se abre un proyecto, el motor de 4D detecta el lenguaje utilizado por el archivo de datos y lo pasa al lenguaje (modo intérpretado o compilado). Las comparaciones de texto, independientemente de si las efectúa el motor del proyecto o el lenguaje, se hacen en el mismo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). En este caso, la configuración se aplica a todas las nuevas bases creadas por 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por defecto, cuando esta opción no está marcada, 4D utiliza un sofisticado algoritmo que tiene en cuenta las características lingüísticas. Este algoritmo es similar al que utilizan los programas de tratamiento de textos para determinar los límites al seleccionar una palabra sobre la que se hace doble clic. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Cuando esta opción está marcada, 4D utiliza un algoritmo simplificado. En esta configuración, todo caracter no alfanumérico (es decir, que no sea una letra o un número) se considera un separador de palabras claves. Esta configuración cumple requisitos específicos asociados a determinados idiomas, como el japonés. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica la interpretación de caracteres como la "Marca sonora prolongada Katakana-Hiragana" o "長音記号" o las "Marcas de iteración japonesa" como "ゝ" o "ゞ". Es probable que un hablante típico de japonés prefiera los resultados cuando el ajuste está activado. #### Soporte de Mecab (versión japonesa) @@ -82,7 +82,7 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ### Parámetros de la caché para la base - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Esto permite configurar una memoria caché de alto rendimiento adaptada a la mayoría de las configuraciones. A continuación, el tamaño de la memoria caché se calcula dinámicamente en función de los parámetros definidos. Los valores ofrecidos por defecto corresponden al uso estándar de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Este valor aumenta para la optimización cuando otras aplicaciones se ejecutan en la misma máquina que 4D. - **Porcentaje de memoria disponible utilizada para la caché**: porcentaje de la memoria restante asignada por defecto a la caché.\ @@ -98,11 +98,11 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). El tamaño de la memoria caché que introduzca se reservará para la base 4D, independientemente del estado de los recursos de la máquina. Esta configuración puede utilizarse en determinadas configuraciones específicas, o cuando la base está diseñada para utilizarse en sistemas disímiles en cuanto a memoria. En la mayoría de los casos, la caché adaptativa ofrece un mejor rendimiento. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D guarda los datos colocados en la caché a intervalos regulares. Puede especificar todo intervalo de tiempo entre 1 segundo y 500 minutos. Por defecto, 4D guarda sus datos cada 20 segundos. La aplicación también guarda sus datos en el disco cada vez que cambia a otro entorno o sale de la aplicación. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Cuando prevea una entrada de muchos datos, considere la posibilidad de establecer un intervalo de tiempo breve entre guardados. En caso de corte del suministro eléctrico, sólo perderá los datos introducidos desde el último almacenamiento (si la base de datos funciona sin archivo de historial). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md index 7d47ee3b1c3e32..b35956d2815b04 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md @@ -23,9 +23,9 @@ La fuente y el tamaño de la fuente por defecto dependen de la plataforma de eje Otras opciones permiten configurar la visualización de varias ventanas del modo Aplicación. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Dado que esta operación bloquea momentáneamente las acciones del usuario, la visualización de esta ventana le permite saber que la descarga está en curso. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Este menú permite seleccionar la paleta de colores que se utilizará en la apli Los siguientes esquemas están disponibles: - - **Claro**: la aplicación usará el Tema Claro Predeterminado +- **Claro**: la aplicación usará el Tema Claro Predeterminado ![](../assets/en/settings/light-appearance.png) - - **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado +- **Oscuro**: la aplicación usará el Tema Oscuro Predeterminado ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Los temas por defecto pueden ser manejados utilizando CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). El esquema de aplicación principal se aplicará a los formularios por defecto. Sin embargo, se puede remplazar: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atajos @@ -72,9 +72,9 @@ El área de Atajos directos sirve para ver y modificar los atajos por defecto pa Los accesos directos por defecto son los siguientes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece la siguiente caja de diálogo: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/security.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/security.md index 898eec6f0369de..6a18b242beb789 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/security.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/security.md @@ -11,7 +11,7 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l > Estos parámetros no se aplican a las bases proyecto abiertas en modo monopuesto. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - El Diseñador y el Administrador siempre tienen acceso al entorno de diseño y al Explorador de ejecución, incluso si no son parte explícitamente del grupo de acceso específico. Para más información sobre usuarios y grupos de usuarios, consulta el capítulo [Usuarios y grupos](../Users/handling_users_groups.md). - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Ya no es necesario ingresar un nombre de usuario. Además, si no ha asociado una contraseña al usuario por defecto, la caja de diálogo Contraseña ya no aparece y la base se abre directamente. Esta opción simplifica el acceso a la base de datos a la vez que mantiene un sistema completo de control de datos. - Si ha asociado una contraseña al usuario predeterminado, al abrir la base aparece una caja de diálogo en el que los usuarios deben introducir una contraseña. - Si no ha asociado una contraseña al Usuario Predeterminado, la caja de diálogo de Identificación de Usuario no aparecerá.**Nota:** puede "forzar" la visualización de la caja de diálogo Identificación de usuario cuando el modo "Usuario por defecto" está activo, por ejemplo para conectarse como Administrador o Diseñador. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Si no está marcada, los usuarios deben introducir tanto su nombre como su contraseña. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. Este botón permite al usuario acceder a una caja de diálogo que puede utilizar para modificar su contraseña (para más información sobre esta caja de diálogo, consulte "Modificación de la contraseña por el usuario" en [Garantizar el mantenimiento del sistema](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para ello, desmarque esta opción. ## Opciones - - **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: +- **Filtrado de comandos y métodos proyecto en el editor de fórmulas y en los documentos 4D View Pro y 4D Write Pro**: por razones de seguridad, por defecto 4D restringe el acceso a los comandos, funciones y métodos proyecto en el [Editor de fórmulas](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) en el modo Aplicación o añadido a áreas multiestilo (usando [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), Documentos 4D Write Pro y 4D View Pro: sólo ciertas funciones 4D y métodos proyecto que han sido declarados explícitamente utilizando el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) pueden ser utilizados. Puede eliminar total o parcialmente este filtrado mediante las siguientes opciones. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Permite definir un modo de acceso ilimitado a los comandos y métodos sin perder el control de las operaciones efectuadas. Durante la fase de desarrollo, este modo puede utilizarse para probar libremente todas las fórmulas, informes, etc. Durante el funcionamiento, puede utilizarse para definir soluciones seguras que permitan el acceso temporal a comandos y métodos. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contiene opciones relacionadas con la protección del acceso y de l - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Cuando esta opción está marcada, los usuarios tienen acceso a todos los comandos 4D, plug-ins y métodos proyecto (excepto los invisibles). **Nota:** esta opción tiene prioridad sobre el comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Cuando se selecciona, este comando no hace nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para más información, consulte [Parámetros usuario](../Desktop/user-settings.md). - - **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. +- **Ejecutar el método "On Host Database Event" de los componentes**: el [método base On Host Database Event](../commands-legacy/on-host-database-event-database-method.md) facilita las fases de inicialización y copia de seguridad de los componentes 4D. Por razones de seguridad, debe autorizar explícitamente la ejecución de este método en cada base de datos local. Para hacer esto, debe marcar esta opción. Por defecto, no está marcado. Cuando esta opción está seleccionada: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/web.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/web.md index 0b5750d313b529..68bacf5927c493 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/web.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R9/settings/web.md @@ -82,9 +82,9 @@ Cuando se selecciona esta opción, el servidor web no ofrece ningún soporte esp En este modo, puede configurar los parámetros del servidor web adicionales: - - [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) - - [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) - - [Usar procesos apropiativos](#use-preemptive-processes) +- [Máximo de procesos web simultáneos](#maximum-concurrent-web-processes) +- [Reutilización de contextos temporales (4D en modo remoto)](#reuse-temporary-contexts) +- [Usar procesos apropiativos](#use-preemptive-processes) #### Sesiones antiguas (sesiones procesos únicos) @@ -164,9 +164,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D El menú de formato de registro ofrece las siguientes opciones: - - **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. +- **Sin archivo de registro**: cuando se selecciona esta opción, 4D no generará un archivo de historial de peticiones. - - **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ +- **CLF (Common Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato CLF. Con el formato CLF, cada línea del archivo representa una solicitud, como:\ host rfc931 user [DD/MMM/AAAA:HH:MM:SS] "request" state length\ Cada campo está separado por un espacio y cada línea termina con la secuencia CR/LF (character 13, character 10). @@ -177,9 +177,9 @@ El menú de formato de registro ofrece las siguientes opciones: > La fecha y hora son locales al servidor. - - petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) - - estado: respuesta dada por el servidor. - - longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. +- petición: solicitud enviada por el cliente (por ejemplo, GET /index.htm HTTP/1.0) +- estado: respuesta dada por el servidor. +- longitud: tamaño de los datos devueltos (excepto el encabezado HTTP) o 0. > **Nota:** por razones de rendimiento, las operaciones se guardan en una memoria búfer por paquetes de 1Kb antes de ser escritas en el disco. Las operaciones también se escriben en disco si no se ha enviado ninguna petición cada 5 segundos. > Los posibles valores de estado son los siguientes @@ -193,16 +193,16 @@ El menú de formato de registro ofrece las siguientes opciones: > 500: Internal error > El formato CLF no puede personalizarse. - - **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. +- **DLF (Combined Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato DLF. El formato DLF es similar al formato CLF y utiliza exactamente la misma estructura. Simplemente añade dos campos HTTP adicionales al final de cada petición: Referer y User-agent. - Referer: contiene la URL de la página que apunta al documento solicitado. - User-agent: contiene el nombre y la versión del navegador o del software cliente en el origen de la petición. > El formato DLF no se puede personalizar. - - **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. +- **ELF (Extended Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato ELF. El formato ELF está muy extendido en el mundo de los navegadores HTTP. Puede utilizarse para construir historiales sofisticados que respondan a necesidades específicas. Por esta razón, el formato ELF se puede personalizar: es posible elegir los campos que se van a registrar, así como su orden de inserción en el archivo. - - **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. +- **WLF (WebStar Log Format)**: cuando se selecciona esta opción, el historial de peticiones se genera en formato WLF. El formato WLF se desarrolló específicamente para el servidor 4D WebSTAR. Es similar al formato ELF, con sólo unos pocos campos adicionales. Al igual que el formato ELF, se puede personalizar. **Configuring the fields** When you choose the ELF (Extended Log Format) or WLF (WebStar Log Format) format, the "Weg Log Token Selection" area displays the fields available for the chosen format. Deberá seleccionar cada campo para incluirlo en el registro. You will need to select each field to be included in the log. @@ -241,14 +241,14 @@ La siguiente tabla enumera los campos disponibles para cada formato (en orden al Configure los parámetros de copia de seguridad automática para el registro de las peticiones. Primero debe elegir la frecuencia (días, semanas, etc.) o el criterio de límite de tamaño de archivo haciendo clic en el botón de opción correspondiente. A continuación, debe especificar el momento preciso de la copia de seguridad si es necesario. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Puede introducir un valor entre 1 y 24 . - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduzca 1 si desea realizar una copia de seguridad diaria. Cuando esta opción está marcada, debe indicar la hora a la que debe comenzar la copia de seguridad. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Introduzca 1 si desea realizar una copia de seguridad semanal. Enter 1 if you want to perform a weekly backup. When this option is checked, you must indicate the day(s) of the week and the time when each backup must be started. You can select several days of the week if desired. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Introduzca 1 si desea realizar una copia de seguridad mensual. Enter 1 if you want to perform a monthly backup. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Una copia de seguridad se activa automáticamente cuando el archivo alcanza el tamaño especificado. Puedes definir un límite de tamaño de 1, 10, 100 o 1000 MB. > En el caso de las copias de seguridad programadas, si el servidor web no fue lanzado cuando se programó la copia de seguridad, en el siguiente lanzamiento 4D considera que la copia de seguridad ha fallado y aplica los parámetros adecuados, definidos en las Propiedades de la base. @@ -262,9 +262,9 @@ Para más información sobre el soporte de los servicios web en 4D, consulte el Esta área contiene varias opciones relativas con el uso de 4D como un "servidor" de Servicios Web, es decir la publicación de los métodos proyecto en forma de Servicios Web. - - **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. - - **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. - - **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: esta opción le permite inicializar la publicación de servicios web. Si esta opción no ha sido seleccionada, 4D rechaza las peticiones SOAP y no genera una WSDL - incluso si los métodos tienen el atributo *Publicado en WSDL*. Cuando esta opción está marcada, 4D crea el archivo WSDL. +- **Nombre del Servicio Web**: esta área le permite cambiar el "nombre genérico" del Servicio Web. Este nombre se utiliza para diferenciar los servicios tanto a nivel de servidor SOAP (cuando el servidor publica varios Servicios Web diferentes), así como en los directorios de Servicios Web. Por defecto, 4D utiliza el nombre A_WebService. +- **Espacio de nombres de Servicios Web**: esta área se utiliza para cambiar el espacio de nombres (namespace) de los Servicios Web publicados por 4D. Cada Servicio Web publicado en Internet debe ser único. La unicidad de los nombres de los Servicios Web se asegura mediante el uso de espacios de nombres XML. Un namespace es una cadena de caracteres arbitraria usada para identificar de manera única un conjunto de etiquetas XML. Por lo general, el espacio de nombres comienza por la URL de la empresa (http://mycompany.com/mynamespace). En este caso, no es indispensable tener nada en particular en la URL indicada; lo que importa es que la cadena de caracteres utilizada sea única. Por defecto, 4D utiliza el siguiente espacio de nombres: http://www.4d.com/namespace/default. > Conforme al estándar XML para los nombres de etiquetas, las cadenas de caracteres utilizadas no deben contener espacios ni comenzar con un número. Además, para evitar cualquier riesgo de incompatibilidad, recomendamos que no utilice ningún caracter extendido (como los caracteres acentuados). @@ -272,7 +272,7 @@ Esta área contiene varias opciones relativas con el uso de 4D como un "servidor Esta área contiene varias opciones relacionadas con el uso de 4D como un "cliente" de Servicios Web, es decir, suscribirse a los servicios publicados en la red. - - **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". +- **Prefijo de los métodos creados por el asistente**: esta área le permite cambiar el prefijo que se añade automáticamente por 4D al nombre de los métodos proxy generados por el asistente de servicios web. Los métodos proyecto proxy forman un enlace entre la aplicación 4D y el servidor de Servicios Web. Por defecto, 4D utiliza el prefijo "proxy_". ## Funcionalidades Web @@ -306,9 +306,9 @@ Este botón solo está disponible en los proyectos abiertos con la aplicación 4 El botón activa la siguiente secuencia de actualización: - - Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. - - Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). - - Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. +- Se elimina el grupo de usuarios de la API REST definido en el menú **Leer/Escribir**. +- Se elimina el método base `On REST Authentication` (se traslada a la papelera del sistema). +- Se crea un archivo ["roles.json"](../ORDA/privileges.md#rolesjson-file) por defecto en la carpeta [Sources](../Project/architecture.md#sources) del proyecto si no existe, con su atributo `forceLogin` a `True`. Recuerde reiniciar su proyecto después de realizar esta actualización. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/ClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/ClassClass.md index b1b0365605edcc..9d1cb639f79189 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/ClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/ClassClass.md @@ -160,8 +160,8 @@ Vous pouvez passer un ou plusieurs paramètres optionnels *param*, qui seront pa :::note Notes - - Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. - - Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. +- Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. +- Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/Document.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/Document.md index e5c0997f07ca47..f026e9fde75c7c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/Document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/Document.md @@ -320,8 +320,8 @@ Cette propriété est en **lecture seule**. La propriété `.original` renvoie l'élément cible d'un fichier alias, d'un raccourci ou d'un lien symbolique. L'élément cible peut être : - - un objet File - - un objet Folder +- un objet File +- un objet Folder Pour les fichiers sans alias, la propriété retourne le même objet File que le fichier. @@ -585,8 +585,8 @@ La fonction `.getText()` retourne le con Optionnellement, vous pouvez indiquer le jeu de caractères à utiliser pour la lecture du contenu. Vous pouvez passer soit : - - dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), - - ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. +- dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), +- ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. > Pour consulter la liste des jeux de caractères pris en charge par 4D, veuillez vous reporter à la description de la commande `CONVERT FROM TEXT`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index b7e2d6073fd621..ce7f23754c5200 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objet 4D.OutgoingMessage est [non partageable](../Concepts/shared.md). La propriété `.body` contient le body du message sortant. Les types de données suivants sont pris en charge dans la propriété `.body` : - - text - - blob - - object - - image +- text +- blob +- object +- image La propriété `.body` est en lecture-écriture. @@ -108,17 +108,17 @@ La fonction `.setBody()` dé Les types de données suivants sont pris en charge dans la propriété *body* : - - Text - - Blob - - Object - - Image +- Text +- Blob +- Object +- Image Lorsque cette fonction est utilisée, le header content-type est automatiquement défini en fonction du type de *body* : - - Content-Type:text/plain si le body est un texte - - Content-Type:application/octet-stream si le body est un Blob - - Content-Type:application/json si le body est un objet - - Content-Type:image/jpeg, image/gif... si le body est une image +- Content-Type:text/plain si le body est un texte +- Content-Type:application/octet-stream si le body est un Blob +- Content-Type:application/json si le body est un objet +- Content-Type:image/jpeg, image/gif... si le body est une image Si *body* n'est pas un type de valeur pris en charge, une erreur est renvoyée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md index 325787d945631f..098475b2abbeec 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propriété `.keepAlive` contient diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md index 4e72b1fa295c2c..fc09af75bcdf99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Les objets de session sont retournés par la commande [`Session`](../commands/session.md). Ces objets fournissent au développeur une interface permettant de gérer la session utilisateur courante et d'exécuter des actions telles que le stockage de données contextuelles, le partage d'informations entre les process de la session, le lancement de process préemptifs liés à la session ou (uniquement pour le web) la gestion des [privilèges](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Types de sessions Les types de sessions suivants sont pris en charge par cette classe : @@ -38,11 +47,6 @@ La disponibilité des propriétés et des fonctions de l'objet `Session` dépend | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() @@ -268,7 +272,7 @@ $privileges := Session.getPrivileges() #### Voir également [.setPrivileges()](#setprivileges)
-[Permissions : Inspecter les privilèges de la session pour faciliter le débogage (article de blog)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) +[*Permissions – Inspect the privileges in the session for an easy debugging* (blog post)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebFormClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebFormClass.md index 3d92f3b48c546e..d16c4e85d76af2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebFormClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebFormClass.md @@ -55,8 +55,8 @@ La fonction `.disableState()` d Cette fonction ne fait rien si : - - l'*état* n'est actuellement pas activé dans le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* n'est actuellement pas activé dans le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous [activez](#enablestate) ou désactivez plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. @@ -80,8 +80,8 @@ La fonction `.enableState()` act Cette fonction ne fait rien si : - - l'*état* a déjà été activé sur le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* a déjà été activé sur le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous activez ou [désactivez](#disablestate) plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketClass.md index e8b5a0245406bc..97ee1a22f9519e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketClass.md @@ -86,8 +86,8 @@ La fonction `4D.WebSocket.new()` crée e Dans *url*, indiquez l'URL à laquelle le serveur WebSocket répondra. Les modèles d'URL suivants peuvent être utilisés : - - `ws://host[:port]path[?query]` pour les connexions standard - - `wss://host[:port]path[?query]` pour les connexions TLS sécurisées +- `ws://host[:port]path[?query]` pour les connexions standard +- `wss://host[:port]path[?query]` pour les connexions TLS sécurisées Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur est générée (que vous pouvez intercepter à l'aide d'une méthode installée avec `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur e Dans *connectionHandler*, vous pouvez transmettre un objet contenant des fonctions de callback à appeler selon les événements de connexion, ainsi que le type de données et les en-têtes à gérer. - - Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. - - La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. +- Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. +- La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. | Propriété | Type | Description | | ----------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La fonction `.terminate()` refer Dans *code*, vous pouvez passer un code d'état expliquant pourquoi la connexion est fermée (voir aussi [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)) : - - S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. - - Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. +- S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. +- Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. Dans *reason*, vous pouvez passer une chaîne de caractères décrivant la raison pour laquelle la connexion est fermée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md index aca94359426e7e..f9e929fbc81107 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Voir également [cet article de blog](https://blog.4d.com/new-built-in-websocket Pour créer et gérer votre serveur WebSocket dans 4D, vous devrez utiliser deux classes intégrées à 4D : - - cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, - - la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. +- cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, +- la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. De plus, vous devrez créer deux classes utilisateurs qui contiendront les fonctions de callback : - - une classe utilisateur pour gérer les connexions serveur, - - une classe utilisateur pour gérer les messages. +- une classe utilisateur pour gérer les connexions serveur, +- une classe utilisateur pour gérer les messages. Vous devez [créer le serveur WebSocket](#4dwebsocketservernew) dans un [worker](../Develop/processes.md#worker-processes) pour maintenir la connexion en vie. @@ -387,8 +387,8 @@ Par défaut, si aucune valeur *timeout* n'est définie, la fonction initialise l Si une valeur *timeout* est définie : - - lorsque le temps d'attente est atteint, détruit de force la socket. - - si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. +- lorsque le temps d'attente est atteint, détruit de force la socket. +- si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Admin/webAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/current/Admin/webAdmin.md index 3c407cc2d8f7ab..87bace3ccb1808 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Admin/webAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Admin/webAdmin.md @@ -17,7 +17,7 @@ Par défaut, le serveur web `WebAdmin` ne démarre pas automatiquement. Il faut Vous pouvez configurer le server web `WebAdmin` pour qu'il se lance au démarrage de 4D ou 4D Server (avant l'ouverture d'un projet). - - Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. +- Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Cochez l'option **Lancer le serveur WebAdmin au démarrage** dans la boîte de d ![alt-text](../assets/en/Admin/waSettings.png) - - Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : +- Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Quand cette option est cochée, il est possible de se connecter au serveur `WebA **Notes :** - - Les connections HTTP autres que sur localhost ne sont jamais acceptées. - - Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. +- Les connections HTTP autres que sur localhost ne sont jamais acceptées. +- Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. #### Port HTTP @@ -94,11 +94,11 @@ Chemin du dossier qui contient les fichiers de certificat TLS. Par défaut, le c Statut ou format du fichier de logs des requêtes HTTP (HTTPDebugLog_*nn*.txt, stocké dans le dossier "Logs" de l'application. --*nn* représente le numéro du fichier). Les options suivantes sont disponibles : - - **Désactivé** (valeur par défaut) - - **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses - - **Sans les body** - activé sans les parts des body (la taille du body est indiquée) - - **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes - - **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses +- **Désactivé** (valeur par défaut) +- **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses +- **Sans les body** - activé sans les parts des body (la taille du body est indiquée) +- **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes +- **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses #### Clé d'accès @@ -108,9 +108,9 @@ La configuration d'une clé d'accès est obligatoire pour débloquer l'accès au Une clé d'accès est similaire à un mot de passe, mais sans login associé. - - Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. - - Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. - - Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. +- Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. +- Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. +- Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. #### Activer l'accès à Qodly Studio @@ -145,9 +145,9 @@ Voici un exemple : ## Authentification et Session - - Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. +- Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. - - Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. +- Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. Une fois l'accès autorisé, une [session web](WebServer/sessions.md) est créée avec les privilèges "WebAdmin" sur l'application 4D. Tant que la session courante a le privilège "WebAdmin", le composant `WebAdmin` sert les pages demandées dans les requêtes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Backup/restore.md b/i18n/fr/docusaurus-plugin-content-docs/current/Backup/restore.md index afa6d06b767f25..67abbc73dc2080 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Backup/restore.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Backup/restore.md @@ -5,12 +5,12 @@ title: Restitution 4D vous permet de récupérer l’intégralité des données d’une application en cas d’incident, quelles que soient ses causes. Deux catégories principales d’incidents peuvent se produire : - - L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : +- L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : - Si le cache était vide, l'application s’ouvre normalement. Toutes les modifications apportées à l'application ont été enregistrées. Ce cas ne nécessite aucune opération particulière. - Si le cache contenait des opérations, le fichier de données est intact mais il est nécessaire d’intégrer le fichier d’historique courant. - Si le cache était en cours d’écriture, le fichier de données est probablement endommagé. Il est nécessaire de restituer la dernière sauvegarde et d’intégrer le fichier d’historique courant. - - La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. +- La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. > 4D peut lancer automatiquement des procédures de récupération des applications après incident. Ces mécanismes sont gérés à l’aide de deux options accessibles dans la Page **Sauvegarde/Sauvegarde & et Restitution** de la fenêtre des Propriétés. Pour plus d'informations, reportez-vous au paragraphe [Restitution automatique](settings.md#automatic-restore-and-log-integration).\ > Si l'incident résulte d'une opération inappropriée effectuée sur les données (suppression d'un enregistrement par exemple), vous pouvez tenter de réparer le fichier de données à l'aide de la fonction "rollback" du fichier d'historique.\ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Backup/settings.md b/i18n/fr/docusaurus-plugin-content-docs/current/Backup/settings.md index 34d711987f2faa..b74890eeed329a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Backup/settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Backup/settings.md @@ -5,9 +5,9 @@ title: Paramètres de sauvegarde Les paramètres de sauvegarde sont définis sur trois pages dans la [boîte de dialogue des Paramètres](../settings/overview.md). Vous pouvez définir : - - la périodicité des sauvegardes automatiques - - les fichiers à inclure dans chaque sauvegarde - - les fonctionnalités avancées permettant d'exécuter des tâches automatiques +- la périodicité des sauvegardes automatiques +- les fichiers à inclure dans chaque sauvegarde +- les fonctionnalités avancées permettant d'exécuter des tâches automatiques > Les propriétés définies dans cette boîte de dialogue sont écrits dans le fichier *Backup.4DSettings*, stocké dans le [dossier Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Les paramètres des sauvegardes périodiques sont définis dans la Page **Sauveg Les options regroupées dans cet onglet permettent de définir et de paramétrer des sauvegardes périodiques automatiques de l'application. Vous pouvez choisir un paramétrage standard rapide ou personnaliser entièrement la périodicité. Diverses options apparaissent en fonction de la valeur définie dans le menu **Sauvegarde automatique** : - - **Jamais** : la fonction de sauvegarde périodique est inactivée. - - **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. - - **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. - - **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : +- **Jamais** : la fonction de sauvegarde périodique est inactivée. +- **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. +- **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. +- **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : - **Toutes les N heure(s)** : permet de programmer des sauvegardes sur une base horaire. Vous pouvez saisir une valeur comprise entre 1 et 24. * **Tous les jours** : programme une sauvegarde automatique par jour. Saisissez par exemple 1 si vous souhaitez une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. * **Toutes les N semaine(s), jour à N** : permet de programmer des sauvegardes sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jour(s) de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. @@ -48,12 +48,12 @@ La Page Sauvegarde/Configuration des Propriétés permet de désigner les fichie Cette zone permet de désigner les fichiers et/ou dossiers à copier lors de la prochaine sauvegarde. - - **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : +- **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : - le fichier journal courant de l'application (le cas échéant), - le dossier `Settings` complet situé [à côté du fichier de données](../Project/architecture.md#settings-user-data) (le cas échéant), c'est-à-dire *les paramètres utilisateur pour les données*. - - **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. - - **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* - - **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. +- **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. +- **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* +- **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. - **Supprimer** : retire de la liste des fichiers joints l’élément sélectionné. - Gestion du fichier d'historique En cas de restitution, le dossier sera récupéré avec sa structure interne. Vous pouvez désigner tout dossier ou volume connecté au poste, à l’exception du dossier contenant les fichiers de l'application. - **Ajouter fichier...** : affiche une boîte de dialogue permettant de sélectionner un fichier à joindre à la sauvegarde. @@ -82,19 +82,19 @@ La modification des options de sauvegarde et de restauration est facultative. Le ### Paramètres généraux - - **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). +- **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). Si, par exemple, le nombre de jeux est fixé à 3, les trois premières sauvegardes créent successivement les archives MaBase-0001, MaBase-0002 et MaBase-0003. Lors de la quatrième sauvegarde, l’archive MaBase-0004 est créée alors que l’archive MaBase-0001 est supprimée. Par défaut, le mécanisme de suppression des jeux est activé et 4D conserve 3 jeux de sauvegarde. Pour ne pas activer le mécanisme, désélectionnez l’option. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. +- **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. +- **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. - - **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. +- **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. - Périodicité Elle revient à annuler la sauvegarde ayant échoué. Une erreur est générée. - **Réessayer dans N seconde(s), minute(s) ou heure(s)** : lorsque cette option est cochée, une nouvelle tentative de sauvegarde est effectuée à l’issue du délai défini. Ce mécanisme permet d’anticiper certaines circonstances bloquant la sauvegarde. Vous pouvez fixer un délai en secondes, minutes ou heures à l’aide du menu correspondant. Si la nouvelle tentative échoue également, une erreur est générée et l’échec est inscrit dans les zones de statut de la dernière sauvegarde et dans le Journal des sauvegardes. - **Annuler l’opération au bout de N tentatives** : ce paramètre permet de définir le nombre de fois que le module de sauvegarde réessaiera de lancer la sauvegarde en cas d’échec. Si, à l’issue du nombre d’essais défini, la sauvegarde n’a pas pu être effectuée, elle est annulée et l’erreur 1401 est générée (“Le nombre maximal de tentatives de sauvegarde est atteint, la sauvegarde automatique est temporairement désactivée”). Dans ce cas, aucune nouvelle sauvegarde automatique ne sera lancée tant que l’application n’aura pas été redémarrée ou qu’une sauvegarde manuelle n’aura été effectuée avec succès. @@ -106,15 +106,15 @@ La modification des options de sauvegarde et de restauration est facultative. Le Ces options s’appliquent aux fichiers de sauvegarde principaux et aux fichiers de sauvegarde de l’historique. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. Le menu **Taille du segment** est une combo box permettant de définir la taille en Mo de chaque segment de sauvegarde. Vous pouvez choisir une des tailles prédéfinies ou saisir une taille spécifique entre 0 et 2048. Si vous passez 0, aucune segmentation n’est effectuée (équivaut à la valeur **Aucune**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. +- **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. - **Aucun** : aucune compression n’est appliquée. La sauvegarde peut être sensiblement plus rapide mais les fichiers d’archives sont plus volumineux sur le disque. - **Normal** (par défaut) : cette option constitue un compromis vitesse de sauvegarde/taille des archives. - **Elevé** : le taux de compression maximal est appliqué aux archives. Les fichiers d’archives prennent le moins de place possible sur le disque mais la sauvegarde peut être sensiblement ralentie. - - **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). +- **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). - **Taux d’entrelacement** : l’entrelacement consiste à stocker les données dans des secteurs non contigus afin de limiter les risques en cas d’endommagement des secteurs. Plus le taux est élevé, plus la sécurité est élevée ; en contrepartie, le traitement des données consomme davantage de mémoire. - **Taux de redondance** : la redondance permet de sécuriser les données présentes dans un fichier en répétant plusieurs fois les mêmes informations. Plus le taux est élevé, plus le fichier est sécurisé, mais plus le stockage est lent et la taille du fichier importante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/operators.md b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/operators.md index d589041c258de8..82e97a3608a5d2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/operators.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/operators.md @@ -11,8 +11,8 @@ Le langage 4D prend en charge les opérateurs que vous connaissez peut-être dé Le langage 4D prend en charge les opérateurs **binaires** et **ternaires** : - - les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. - - les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). +- les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. +- les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). Les valeurs que les opérateurs affectent sont des opérandes. Dans l'expression `1 + 2`, le symbole + est un opérateur binaire et ses deux opérandes sont les valeurs 1 et 2. @@ -33,18 +33,18 @@ $col:=New collection //$col est initialisé avec une collection vide Les résultats des opérateurs dépendent des **types de données** auxquels ils sont appliqués. Ils sont décrits avec les types de données, dans les sections suivantes : - - [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) - - [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) - - [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) - - [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) - - [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) - - [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) - - [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) - - [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) - - [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) - - [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) - - [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) - - [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) +- [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) +- [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) +- [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) +- [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) +- [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) +- [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) +- [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) +- [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) +- [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) +- [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) +- [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) +- [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) ## Opérateurs d'affectation composés @@ -272,9 +272,9 @@ L'opérateur conditionnel ternaire vous permet d'écrire des expressions conditi Il prend trois opérandes dans l'ordre suivant : - - une condition suivie d'un point d'interrogation (?) - - une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) - - une expression à exécuter si la condition est [falsy](#truthy-and-falsy) +- une condition suivie d'un point d'interrogation (?) +- une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) +- une expression à exécuter si la condition est [falsy](#truthy-and-falsy) ### Syntaxe @@ -325,21 +325,21 @@ En plus d'un type, chaque valeur possède également une valeur booléenne inhé Les valeurs suivantes sont **falsy**: - - false - - Null - - undefined - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Chaînes vides - - [] - Collections vides - - {} - Objets vides +- false +- Null +- undefined +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Chaînes vides +- [] - Collections vides +- {} - Objets vides Toutes les autres valeurs sont considérées comme **truthy**, notamment : - - 0 - zéro numérique (Entier ou autre) +- 0 - zéro numérique (Entier ou autre) Dans 4D, l'évaluation à **truthy** et **falsy** reflète la **possibilité d'utilisation** d'une valeur, ce qui signifie qu'une valeur truthy existe et peut être traitée par le code sans générer d'erreurs ou de résultats inattendus. L'objectif est de fournir un moyen pratique de gérer les valeurs *undefined* et *null* dans les objets et les collections, de sorte qu'un nombre réduit d'instructions [If…Else](flow-control.md#ifelseend-if) soit nécessaire pour éviter les erreurs d'exécut diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/variables.md index e88a916f5bb4f2..a1b7c382575f99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -53,8 +53,8 @@ Cette syntaxe ne prend en charge que les déclarations de [variables locales et `varType` peut être : - - un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, - - une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. +- un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, +- une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. Si `varType` est omis, une variable de type **variant** est créée. @@ -86,7 +86,7 @@ L'ancienne syntaxe utilisant les commandes `C_XXX` est obsolète à partir de la ### Exemples - - Pour déclarer les variables locales et les variables process basiques : +- Pour déclarer les variables locales et les variables process basiques : ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //également équivalent à C_OBJECT($o) ``` - - Pour déclarer les variables objet de classe 4D : +- Pour déclarer les variables objet de classe 4D : ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Pour déclarer les variables objet de classe utilisateur : +- Pour déclarer les variables objet de classe utilisateur : ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Une variable locale, comme son nom l’indique, est locale à une méthode — c Vous pouvez choisir d'utiliser une variable locale pour : - - Eviter des conflits de noms avec les autres variables - - Utiliser temporairement des valeurs, - - Réduire le nombre de variables process +- Eviter des conflits de noms avec les autres variables +- Utiliser temporairement des valeurs, +- Réduire le nombre de variables process Le nom d’une variable locale commence toujours par le signe dollar ($) et peut contenir jusqu’à 31 autres caractères. Si vous saisissez un nom plus long, 4D le tronque pour le ramener à 31 caractères. @@ -224,9 +224,9 @@ En mode interprété, les variables sont gérées dynamiquement; elles sont cré Un process peut lire et écrire des variables process dans un autre process à l'aide des commandes `GET PROCESS VARIABLE` et `SET PROCESS VARIABLE`. Nous vous recommandons de n'utiliser ces commandes que dans le cadre des besoins décrits ci-dessous (qui sont les raisons pour lesquelles ces commandes ont été créées dans 4D) : - - Communication interprocess à des endroits particuliers de votre code - - Gestion du glisser-déposer interprocess - - En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur +- Communication interprocess à des endroits particuliers de votre code +- Gestion du glisser-déposer interprocess +- En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur Pour plus d'informations, consultez le chapitre **Process** et la description de ces commandes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/basics.md b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/basics.md index 450585e371221c..94977872be4248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/basics.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/basics.md @@ -33,13 +33,13 @@ Il peut arriver que la mémoire soit insuffisante pour créer une BLOB. Ou, lors Ce sont généralement les types d'erreurs les plus difficiles à trouver. À l'exception des erreurs de frappe, tous les types d'erreurs énumérés ci-dessus sont, dans une certaine mesure, couverts par l'expression "erreur de conception ou de logique". Utilisez le [débogueur](debugger.md) pour les détecter. Par exemple : - - Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. - - Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. +- Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. +- Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. Les erreurs de conception ou de logique comprennent également des situations telles que : - - Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. - - Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. +- Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. +- Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. Parfois, le morceau de code qui affiche l'erreur peut être différent du code qui est en fait à l'origine du problème. @@ -55,8 +55,8 @@ Pour trouver rapidement l'origine du problème, rouvrez la version interprétée La fenêtre d'erreur de syntaxe apparaît automatiquement lorsque l'exécution d'une méthode est interrompue. Cela peut se produire lorsque : - - une erreur empêche la poursuite de l'exécution du code - - la méthode produit une fausse assertion (voir la commande `ASSERT`) +- une erreur empêche la poursuite de l'exécution du code +- la méthode produit une fausse assertion (voir la commande `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ La zone de texte supérieure affiche un message décrivant l'erreur. La zone de La fenêtre d'erreur de syntaxe propose plusieurs options : - - **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. +- **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. - - **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. +- **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. - - **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. +- **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. :::tip @@ -76,14 +76,14 @@ Pour ignorer une erreur qui se répète (par exemple, dans les boucles), vous po ::: - - **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : +- **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : - Si une méthode formulaire ou méthode objet s'exécute en réponse à un événement, elle est arrêtée et vous revenez au formulaire. - Si la méthode est exécutée à partir de l'environnement de l'application, vous revenez à cet environnement. - - **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. +- **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. - - **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. +- **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. ## Débogueur diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md index 2dbedc9655644c..3f1b6436ef1e91 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Cet événement peut être utilisé pour filtrer la saisie de données dans les Lorsqu'il est utilisé, cet événement est généré après chaque modification apportée au contenu d'un objet saisissable, quelle que soit l'action qui a provoqué la modification, c'est-à-dire : - - Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; - - Déposer une valeur (action similaire à coller); - - Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. - - Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). +- Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; +- Déposer une valeur (action similaire à coller); +- Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. +- Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). Dans l'événement `On After Edit`, les données texte saisies sont retournées par la commande [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md index 33cd0dd5bc3ac9..547ac39b5ab982 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ L'événement de formulaire `On Begin Drag Over` peut être sélectionné pour t L'événement `On Begin Drag Over` est utile pour préparer l'action de glisser. Il peut être utilisé pour : - - Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). - - Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). - - Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. +- Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). +- Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). +- Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. - Pour indiquer que les actions de glisser sont acceptées, la méthode de l'objet source doit retourner 0 (zéro). - Pour indiquer que les actions de glisser sont refusées, la méthode de l'objet source doit retourner -1. - Si aucun résultat n'est retourné, 4D considère que les actions de glisser sont acceptées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onClicked.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onClicked.md index 78486e986347fb..c4858cd18410e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onClicked.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onClicked.md @@ -15,11 +15,11 @@ L'événement `On Clicked` est généré lorsque l'utilisateur clique sur un obj L'événement `On Clicked` se produit généralement une fois que le bouton de la souris est relâché. Cependant, il existe plusieurs exceptions : - - [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. - - [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. - - [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. - - [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée - - Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem +- [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. +- [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. +- [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. +- [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée +- Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem Dans le cas d'un événement `On Clicked`, vous pouvez tester le nombre de clics effectués par l'utilisateur à l'aide de la commande `Clickcount`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md index 51e4b7d4d42184..9bdac220339752 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un enregistrement est sur le point d'être affiché sous forme de liste affiché Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque enregistrement : +- Pour chaque enregistrement : - Pour chaque objet de la zone détaillée : - Méthode objet avec l'événement `On Display Detail` - Méthode formulaire avec l'événement `On Display Detail` diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDragOver.md index a6852001e87193..830756654af344 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over L'événement `On Drag Over` est envoyé à plusieurs reprises à l'objet de destination lorsque le pointeur de la souris est déplacé sur l'objet. Généralement, en réponse à cet événement : - - Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). - - En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. +- Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). +- En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. Pour **rejeter** le glisser, la méthode de l'objet de destination doit retourner -1. Lors d'un événement `On Drag Over`, 4D traite la méthode objet comme une fonction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeader.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeader.md index 959a61907fb292..7b762fede644f4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeader.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeader.md @@ -15,7 +15,7 @@ L'événement `On Header` est appelé lorsqu'un enregistrement est sur le point Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque objet de la zone d'en-tête : +- Pour chaque objet de la zone d'en-tête : - Méthode objet avec l'événement `On Header` - Méthode formulaire avec l'événement `On Header` diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md index bad94509cacfcd..2c99b4f29b928c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Cet événement est généré lorsqu'un clic se produit sur l'en-tête d'une col Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) a été sélectionnée pour la list box, vous pouvez décider d'autoriser ou non un tri standard de la colonne en passant la valeur 0 ou -1 dans la variable `$0` : - - Si `$0` est égal à 0, un tri standard est effectué. - - Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. +- Si `$0` est égal à 0, un tri standard est effectué. +- Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) n'est pas sélectionnée pour la list box, la variable `$0` n'est pas utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Extensions/develop-components.md b/i18n/fr/docusaurus-plugin-content-docs/current/Extensions/develop-components.md index 6409a79785068f..b6b35732c41280 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Extensions/develop-components.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Extensions/develop-components.md @@ -179,14 +179,18 @@ Select **Edit...** item is available when you right-click on the component name ![edit-component](../assets/en/Project/Edit-component.png) -When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the component code is editable in the following pages: +When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the following standard pages are available and give access to the component contents: ![tab-component](../assets/en/Project/tab-component.png) +- Home, including folders, methods, classes and (preview only) forms - Project Methods - Database Methods ([On Web Connection](../commands-legacy/on-web-connection-database-method.md), [On Web Authentication](../commands-legacy/on-web-authentication-database-method.md), [On Host Database Event](../commands-legacy/on-host-database-event-database-method.md)) - Classes - Project Form Methods +- Commands and Constants +- Plug-ins +- Trash ![tab-component](../assets/en/Project/tab-component.gif) @@ -194,7 +198,8 @@ Standard 4D IDE features are available for the component. You can execute the fo - add, duplicate, delete, edit/save [methods and classes](../Project/code-overview.md) - preview code, show/edit [documentation](../Project/documentation.md), display/edit [method properties](../Project/code-overview.md#project-method-properties), -- run methods. +- run methods, +- restore from trash or empty trash. ## Complétion de code pour les composants compilés diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md index 07c7cc5a3e58e0..bc7cb2ef2796ea 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -9,16 +9,16 @@ Les formulaires fournissent l'interface par laquelle les informations sont saisi Les formulaires peuvent également contenir d'autres formulaires grâce aux fonctionnalités suivantes : - - [objets de sous-formulaire](FormObjects/subform_overview.md) - - [formulaires hérités](./properties_FormProperties.md#inherited-form-name) +- [objets de sous-formulaire](FormObjects/subform_overview.md) +- [formulaires hérités](./properties_FormProperties.md#inherited-form-name) ## Création de formulaires Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suivants : - - **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. - - **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. - - **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : +- **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. +- **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. +- **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : ``` { @@ -70,9 +70,9 @@ Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suiv Il existe deux catégories de formulaires : - - **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. +- **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. - - **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. +- **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. En règle générale, vous sélectionnez la catégorie de formulaire lorsque vous créez le formulaire, mais vous pouvez la modifier par la suite. @@ -80,15 +80,15 @@ En règle générale, vous sélectionnez la catégorie de formulaire lorsque vou Chaque formulaire est composé d'au moins deux pages : - - une page 1 : une page principale, affichée par défaut - - une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. +- une page 1 : une page principale, affichée par défaut +- une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. Vous pouvez créer plusieurs pages pour un formulaire d'entrée. Si le nombre de champs ou de variables est supérieur au nombre maximal supporté sur un écran, vous pouvez créer des pages supplémentaires pour les afficher. Plusieurs pages vous permettent d'effectuer les opérations suivantes : - - Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. - - Organisez chaque sujet sur sa propre page. - - Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). - - Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. +- Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. +- Organisez chaque sujet sur sa propre page. +- Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). +- Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. Les pages multiples sont utiles uniquement pour les formulaires d'entrée. Elles ne sont pas destinées à être imprimées. Lorsqu'un formulaire de plusieurs pages est imprimé, seule la première page est imprimée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/macros.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/macros.md index a8e027a858e3db..69f494bd4c96d0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/macros.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/macros.md @@ -7,11 +7,11 @@ L'éditeur de formulaires 4D prend en charge les macros. Une macro est un ensemb Par exemple, si vous avez un rapport récurrent avec une mise en forme spécifique (par exemple, certains textes doivent apparaître en rouge et certains textes en vert), vous pouvez créer une macro pour définir automatiquement la couleur. Vous pouvez créer des macros pour l'éditeur de formulaires de 4D qui pourront : - - Créer et exécuter du code 4D - - Afficher les boîtes de dialogue - - Sélectionnez des objets de formulaire - - Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés - - Modifier les fichiers de projet (mettre à jour, supprimer) +- Créer et exécuter du code 4D +- Afficher les boîtes de dialogue +- Sélectionnez des objets de formulaire +- Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés +- Modifier les fichiers de projet (mettre à jour, supprimer) Le code des macros prend en charge les [class functions (fonctions de classe)](Concepts/classes.md) et les [propriétés d'objet de formulaire en JSON](FormObjects/properties_Reference.md) pour vous permettre de définir n'importe quelle fonctionnalité perso @@ -238,9 +238,9 @@ Par exemple, si des objets de la page courante et des groupes ont été modifié Lors de la manipulation de l'attribut `method` des objets de formulaire, vous pouvez définir la valeur de l'attribut de deux manières différentes dans les macros : - - En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). +- En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). - - En utilisant un objet avec la structure suivante : +- En utilisant un objet avec la structure suivante : | Propriété | Type | Description | | --------- | ---- | ------------------ | @@ -252,9 +252,9 @@ Lors de la manipulation de l'attribut `method` des objets de formulaire, vous po La propriété `$4dId` définit un ID unique pour chaque objet de la page courante. Cette clé est utilisée par le processeur de macros pour gérer les modifications dans `$result.currentPage` : - - si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. - - si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. - - si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. +- si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. +- si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. +- si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. #### Exemple @@ -297,8 +297,8 @@ La fonction `onError` est exécutée lorsque le processeur de macros rencontre u Lors de l'exécution d'une macro, si 4D rencontre une erreur qui empêche l'annulation de la macro, il n'exécute pas la macro. C'est le cas par exemple si l'exécution d'une macro se traduirait par : - - supprimer ou modifier un script dont le fichier est en lecture seule. - - créer deux objets avec le même ID interne. +- supprimer ou modifier un script dont le fichier est en lecture seule. +- créer deux objets avec le même ID interne. #### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md index d1ea471e38b245..b192585d543e57 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Vous pouvez utiliser des bibliothèques d'objets dans vos formulaires. Une bibli 4D propose deux types de bibliothèques d'objets : - - une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. - - des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. +- une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. +- des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. ## Utilisation de la bibliothèque d'objets standard @@ -21,10 +21,10 @@ La bibliothèque est affichée dans une fenêtre séparée : La fenêtre présente les caractéristiques principales suivantes : - - Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. - - You can filter the window contents by using the **Categories** menu: +- Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. +- You can filter the window contents by using the **Categories** menu: ![](../assets/en/FormEditor/library3.png) - - Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : +- Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : - faire un clic droit sur un objet et sélectionnez **Copier** dans le menu contextuel - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Une même bibliothèque d’objets ne peut être ouverte que par un seul projet Pour ouvrir une bibliothèque d’objets personnalisée, sélectionnez la commande **Ouvrir>Bibliothèque d’objets...** dans le menu **Fichier** ou la barre d’outils de 4D. Une boîte de dialogue standard d’ouverture de fichiers apparaît, vous permettant de désigner la bibliothèque d’objets à ouvrir. Vous pouvez sélectionner les types de fichier suivants : - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Les bibliothèques d’objets personnalisées sont des projets 4D classiques. Seules les parties suivantes d'un projet sont exposées lorsqu'il est ouvert en tant que bibliothèque : - - formulaires projet - - pages 1 des formulaires +- formulaires projet +- pages 1 des formulaires ### Construire une bibliothèque d’objets @@ -74,10 +74,10 @@ Les principales opérations sont accessibles via le menu contextuel ou le menu d ![](../assets/en/FormEditor/library5.png) - - **Couper** ou **Copier** vers le conteneur de données - - **Coller** un objet à partir du conteneur de données - - **Effacer** - supprime l'objet de la bibliothèque - - **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. +- **Couper** ou **Copier** vers le conteneur de données +- **Coller** un objet à partir du conteneur de données +- **Effacer** - supprime l'objet de la bibliothèque +- **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. Vous pouvez placer dans la bibliothèque des objets individuels (y compris des sous-formulaires) ou des ensembles d’objets. Chaque objet ou ensemble d’objets est regroupé en un seul élément : @@ -93,9 +93,9 @@ Le copier-coller ou le glisser-déposer de certains objets dans la bibliothèque Voici la liste des objets dépendants qui seront collés dans la bibliothèque en même temps que l’objet principal qui les utilise (le cas échéant) : - - Enumérations - - Formats/Filtres - - Images - - Messages d’aide (liés à un champ) - - Méthodes objet +- Enumérations +- Formats/Filtres +- Images +- Messages d’aide (liés à un champ) +- Méthodes objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md index 8aa56e015e88e3..35608377f7063e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Les options de taille dépendent de la valeur de l'option **Taille basée sur**. ## Taille basée sur - - **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. +- **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. Vous pouvez choisir cette option lorsque vous souhaitez utiliser des objets actifs placés dans une zone hors écran (c'est-à-dire en dehors du rectangle de délimitation de la fenêtre) avec une fenêtre de taille automatique. Grâce à cette option, la présence de ces objets ne modifiera pas la taille de la fenêtre. - - **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. +- **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. - - `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. +- `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. > For output forms, only the [**Hor margin**](#hor-margin) or [**Width**](#width) fields are available. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md index acf434fe291b19..cf683fda71fd71 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Vous créez et personnalisez les formulaires de votre application en manipulant Les formulaires 4D prennent en charge un grand nombre d'objets **actifs** et **statiques** intégrés : - - **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. - - **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. +- **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. +- **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. ## Gérer les objets de formulaire Vous pouvez ajouter des objets dans un formulaire de nombreuses manières : - - **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. +- **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. - - **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. +- **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. - - **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). +- **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). Exemple d'un objet bouton : ```json diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md index 91166fb527d796..db63beabb77e04 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md @@ -50,6 +50,6 @@ For security reasons, in [multi-style](./properties_Text.md#multi-style) input a Vous pouvez également représenter des expressions de champ et de variable dans vos formulaires à l'aide d'objets alternatifs, plus particulièrement : - - Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). - - Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). - - Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). +- Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). +- Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). +- Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index 86b38f5ebf8f20..fef79c525aa2ca 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Le cas échéant, l'icône déployer/contractée est automatiquement affichée Le contenu d'un objet formulaire liste hiérarchique peut être initialisé de l'une des manières suivantes : - - Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. - - Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. +- Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. +- Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. Dans les deux cas, vous gérez une liste hiérarchique lors de l'exécution via sa référence *ListRef*, à l'aide des commandes de [liste hiérarchique](../commands/theme/Hierarchical_Lists.md) du langage 4D. @@ -34,9 +34,9 @@ mylist:=New list Chaque représentation de liste dispose de caractéristiques propres et partage des caractéristiques communes avec l’ensemble des représentations. Les caractéristiques propres à chaque représentation de liste sont les suivantes : - - La sélection, - - L’état déployé/contracté des éléments, - - La position du curseur de défilement. +- La sélection, +- L’état déployé/contracté des éléments, +- La position du curseur de défilement. The other characteristics (font, font size, style, entry control, color, list contents, icons, etc.) are common to all the representations and cannot be modified separately. Consequently, when you use commands based on the expanded/collapsed configuration or the current item, for example `Count list items` (when the final `*` parameter is not passed), it is important to be able to specify the representation to be used without any ambiguity. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Comme pour les autres commandes de gestion des propriété d’objets, il est possible d’utiliser le caractère “@” dans le paramètre `NomListe`. En principe, cette syntaxe permet de désigner un ensemble d’objets dans le formulaire. Toutefois, dans le contexte des commandes de liste hiérarchique, ce principe n’est pas applicable dans tous les cas. Cette syntaxe aura deux effets différents en fonction du type de commande : - - Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” +- Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : +- Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po Il est possible de modifier l’apparence d’une liste hiérarchique dans un formulaire à l’aide de plusieurs commandes 4D génériques. Vous devez passer à ces commandes soit le nom d’objet de la liste hiérarchique (en utilisant le paramètre \*), soit son nom de variable (contenant la valeur RefListe) : - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Rappel : A l'exception de la commande `OBJECT SET SCROLL POSITION`, ces commandes modifient toutes les représentations d'une même liste, même si vous désignez une liste via son nom d'objet. @@ -107,8 +107,8 @@ Ce principe est appliqué quel que soit l’ordre d’appel des commandes. Si un Vous pouvez généralement travailler de deux manières avec le contenu des listes hiérarchiques : par position ou par référence. - - Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. - - Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. +- Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. +- Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. ### Exploiter les numéros de référence des éléments (réfElément) @@ -149,9 +149,9 @@ En pratique, vous devez vous préoccuper des numéros de référence d'élément Vous pouvez choisir si les éléments de la liste hiérarchique peuvent être modifiés par l'utilisateur à l'aide du raccourci **Alt + clic** (Windows)/ **Option + clic** (macOS), ou en effectuant un clic long sur le texte de l'élément. - - Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). +- Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). - - En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md index 63918123b3f637..6a27ac901b2f4c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md @@ -25,7 +25,7 @@ Indique si l’utilisateur peut supprimer des sous-enregistrements dans un sous- Cette option permet de désigner un formulaire détaillé à utiliser dans un sous-formulaire. Il peut être : - - un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ @@ -33,7 +33,7 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so > Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). - - le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. +- le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. #### Grammaire JSON @@ -55,8 +55,8 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulaire de liste. Les options suivantes sont disponibles : - - Ne rien faire : ignore le double-clic. - - Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. +- Ne rien faire : ignore le double-clic. +- Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. #### Grammaire JSON @@ -80,9 +80,9 @@ Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulair Définit l'action à réaliser lorsqu'un utilisateur double-clique sur une ligne dans un sous-formulaire liste. Les options disponibles sont : - - **Do nothing** (default): Double-clicking a row does not trigger any automatic action. - - **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. - - **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. +- **Do nothing** (default): Double-clicking a row does not trigger any automatic action. +- **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. +- **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. Regardless of the action selected/chosen, the `On Double clicked` form event is generated. @@ -164,8 +164,8 @@ Spécifie la table à laquelle appartient le sous-formulaire Liste (le cas éch Désigne l'option permettant aux utilisateurs de sélectionner des lignes : - - **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. - - **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ +- **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. +- **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ @@ -173,7 +173,7 @@ Désigne l'option permettant aux utilisateurs de sélectionner des lignes : A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ The Up and Down arrow keys select the previous/next row in the list. Les autres touches de navigation font défiler la liste. The `On Selection Change` form event is generated every time the current row is changed. - - **Multiple**: Several rows can be selected simultaneously in this mode. +- **Multiple**: Several rows can be selected simultaneously in this mode. - Les sous-enregistrements sélectionnés sont retournés par la commande `GET HIGHLIGHTED RECORDS`. - Cliquer sur l'enregistrement permettra de le sélectionner, mais ne modifiera pas l'enregistrement courant. - Si vous pressez **Ctrl+clic** (Windows) ou **Commande+clic** (macOS) sur un enregistrement, cela fera basculer son état (entre sélectionné ou non). Les touches fléchées Haut et Bas sélectionnent l'enregistrement précédent/suivant dans la liste. Les autres touches de navigation font défiler la liste. L'événement formulaire `On Selection Change` est généré chaque fois que l'enregistrement sélectionné est modifié. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md index 522f4bb609875e..3a8c52a17e060c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Les formes sont des [objets statiques](formObjects_overview.md#active-and-static Les formes 4D prennent en charge les formes basiques suivantes : - - rectangles - - lignes - - ovales +- rectangles +- lignes +- ovales ## Rectangle diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/splitters.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/splitters.md index 455819ccb29fb5..63b61e272c7a0a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/splitters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/splitters.md @@ -11,10 +11,10 @@ L’utilisation type du séparateur est le formulaire de sortie dans lequel les Les caractéristiques générales des séparateurs sont les suivantes : - - Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. - - Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. - - Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. - - Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. +- Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. +- Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. +- Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. +- Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. Une fois inséré, un séparateur se présente sous la forme d’un trait. Vous pouvez modifier son [style de bordure](properties_BackgroundAndBorder.md#border-line-style) afin d’obtenir un trait plus ou moins épais, ou [modifier sa couleur](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Vous pouvez associer une méthode objet à un séparateur. Cette méthode sera a Une [variable](properties_Object.md#variable-or-expression) de type *Entier long* est associée à chaque objet séparateur. Cette variable peut être utilisée dans vos méthodes objet et/ou formulaire. Elle prend pour valeur le déplacement courant, en pixels, du séparateur. - - Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, - - Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, - - Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. +- Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, +- Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, +- Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. Vous pouvez également déplacer le séparateur par programmation : il suffit de modifier la valeur de la variable associée. Imaginons par exemple qu’un séparateur vertical soit associé à la variable `sépara1`. Si vous écrivez `sépara1:=-10`, le séparateur sera déplacé de 10 pixels vers la gauche — comme si l’utilisateur l’avait fait manuellement. Le déplacement s’effectue au terme de l’exécution de la méthode objet ou formulaire contenant l’instruction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/stepper.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/stepper.md index b69cbae04d9fe3..2ca2b0558845bc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/stepper.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/stepper.md @@ -13,11 +13,11 @@ La variable associée à l’objet peut être affectée à une zone saisissable Un stepper peut être directement associé à une variable numérique, heure ou date. - - Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : +- Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : - [minimum](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. +- Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. > Pour que le stepper fonctionne avec une variable heure ou date, il est impératif de définir son type dans le formulaire ET de le [déclarer explicitement](../Concepts/variables.md#declaring-variables) comme `Time` ou Date\`. @@ -29,8 +29,8 @@ Pour plus d'informations, veuillez vous reporter à la section [Utiliser des ind ## Voir également - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md index 211a36f4fe1939..abd9d336f929c2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un sous-formulaire est un formulaire inclus dans un autre formulaire. Afin de bien définir les notions mises en oeuvre avec les sous-formulaires, voici quelques définitions relatives aux termes employés : - - **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. - - **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). - - **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. - - **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. - - **Formulaire liste écran** : instance de sous-formulaire en liste. - - **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. +- **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. +- **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). +- **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. +- **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. +- **Formulaire liste écran** : instance de sous-formulaire en liste. +- **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. ## Sous-formulaires en liste @@ -43,8 +43,8 @@ You can bind [a variable or an expression](properties_Object.md#variable-or-expr By default, 4D creates a variable or expression of [object type](properties_Object.md#expression-type) for a subform container, which allows you to share values in the context of the subform using the `Form` command. However, you can use a variable or expression of any scalar type (time, integer, etc.) especially if you only need to share a single value: - - Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. - - Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. +- Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. +- Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. ### Synchronisation du formulaire parent et du sous-formulaire (valeur unique) @@ -58,8 +58,8 @@ Dans le formulaire parent, les deux objets (zone de saisie et conteneur de sous- To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. - - If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. +- If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. +- If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. La valeur texte doit être formatée "hh:mm:ss". @@ -88,15 +88,15 @@ It updates the value of `Form.clockValue` in the subform: L’événement formulaire [Sur modif variable liée](../Events/onBoundVariableChange.md) est généré : - - dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée - - si le sous-formulaire appartient à la page formulaire courante ou à la page 0. +- dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée +- si le sous-formulaire appartient à la page formulaire courante ou à la page 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). La modification de la variable ou de l'expression liée déclenche des événements formulaire qui vous permettent de synchroniser les valeurs du formulaire parent et du sous-formulaire : - - Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. - - Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. +- Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. +- Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. #### Mise à jour du contenu d'un formulaire parent @@ -170,8 +170,8 @@ La communication entre le formulaire parent et les instances du sous-formulaire Pour répondre à ces besoins, 4D propose les mécanismes suivants : - - Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` - - Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` +- Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` +- Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` > La commande `GOTO OBJECT` peut rechercher l’objet de destination dans le formulaire parent même si elle exécutée depuis un sous-formulaire. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md index 0ec07cb47cd10e..ffdb38e99ad775 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md @@ -42,9 +42,9 @@ Sous macOS, les onglets peuvent être orientés, en plus de la position standard Pour fournir les étiquettes d'un onglet, vous pouvez utiliser : - - un objet - - une liste déroulante - - un tableau +- un objet +- une liste déroulante +- un tableau ### Utiliser un objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/text.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/text.md index 2f4e9c9a419512..fe63997661a170 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/text.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/text.md @@ -33,9 +33,9 @@ Une fois qu’un texte a été orienté, il reste possible de modifier sa taille ![](../assets/en/FormObjects/staticText2.png) - - Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; - - Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; - - Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. +- Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; +- Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; +- Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/MSC/analysis.md b/i18n/fr/docusaurus-plugin-content-docs/current/MSC/analysis.md index 3a3b60d2ce9b35..07f7a4e7f217e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/MSC/analysis.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/MSC/analysis.md @@ -14,9 +14,9 @@ Chaque opération élémentaire enregistrée dans le fichier d’historique appa Les informations affichées permettent d’identifier la source et le contexte de chaque opération : - - **Opération** : numéro de séquence de l’opération dans le fichier d’historique. +- **Opération** : numéro de séquence de l’opération dans le fichier d’historique. - - **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : +- **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : - Ouverture du fichier de données : ouverture d’un fichier de données. - Fermeture du fichier de données : fermeture du fichier de données ouvert. - Création d’un contexte : création d’un process définissant un contexte d’exécution. @@ -30,26 +30,26 @@ Les informations affichées permettent d’identifier la source et le contexte d - Annulation de transaction : transaction annulée. - Contexte de mise à jour : modification des données supplémentaires (ex : un appel à `CHANGE CURRENT USER` ou `SET USER ALIAS`). - - **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. +- **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. - - **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. +- **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. - - **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. +- **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. - - **Taille** : taille (en octets) des données traitées par l’opération. +- **Taille** : taille (en octets) des données traitées par l’opération. - - **Date et Heure** : date et heure à laquelle l’opération a été effectuée. +- **Date et Heure** : date et heure à laquelle l’opération a été effectuée. - - **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. +- **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. - - **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. +- **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. - - **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ +- **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ ***Note :** Si la base de données est chiffrée et si aucune clé de données valide correspondant au fichier d'historique ouvert n'a été fournie, les valeurs chiffrées ne sont pas affichées dans cette colonne.* - - **Enregistrements** : numéro de l’enregistrement. +- **Enregistrements** : numéro de l’enregistrement. Cliquez sur **Analyser** pour mettre à jour le contenu du fichier d'historique courant de l'application sélectionnée (nommé par défaut dataname.journal). Le bouton Parcourir peut être utilisé pour sélectionner et ouvrir un autre fichier journal pour l'application. Le bouton **Exporter...** peut être utilisé pour exporter le contenu du fichier en tant que texte. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/MSC/repair.md b/i18n/fr/docusaurus-plugin-content-docs/current/MSC/repair.md index 0ddaaae0171a58..f4ff5d4178d563 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/MSC/repair.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/MSC/repair.md @@ -51,13 +51,13 @@ Lorsque vous cliquez sur le bouton **Réparer**, 4D effectue une analyse complè La zone "Enregistrements trouvés dans le fichier de données" comporte deux tableaux synthétisant les informations issues de l’analyse du fichier de données. - - Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : +- Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : - La colonne **Ordre** indique l’ordre de récupération des groupes d’enregistrements. - La colonne **Nombre** indique le nombre d'enregistrements contenus dans la table. - Si tous les enregistrements et toutes les tables ont été attribués, seule la zone principale est affichée. Les noms des tables attribuées automatiquement sont affichés en caractères verts. Les groupes qui n'ont pas encore été attribués, c'est-à-dire, les tables qui n'ont pas pu être associées à des enregistrements sont affichées en caractères rouges. - Voir le compte rendu Par défaut, l’option est cochée pour tous les groupes avec les enregistrements qui peuvent être associés à une table. - - Le deuxième tableau liste les tables du fichier de structure. +- Le deuxième tableau liste les tables du fichier de structure. ### Attribution manuelle @@ -74,7 +74,7 @@ Le bouton **Ignorer enregistrements** permet de supprimer l’association effect Une fois la réparation terminée, 4D génère un fichier de compte-rendu dans le dossier Logs du projet. Ce fichier liste l’ensemble des opérations qui ont été menées. Il est créé au format xml et est nommé : *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" où : - - *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", - - *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". +- *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", +- *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". Lorsque vous cliquez sur le bouton **Voir le compte rendu**, 4D affiche le fichier de compte-rendu le plus récent dans le navigateur par défaut de l’ordinateur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Menus/properties.md b/i18n/fr/docusaurus-plugin-content-docs/current/Menus/properties.md index b27f7547434bf5..948efad95aca75 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Menus/properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Menus/properties.md @@ -11,8 +11,8 @@ La propriété **Title** contient le libellé d'un menu ou d'une ligne de menu, Dans l'éditeur de menus, vous pouvez saisir directement le libellé "en dur". Vous pouvez également saisir une référence pour une variable ou un élément XLIFF, ce qui facilitera la mise à jour et la traduction des applications. Vous pouvez utiliser types de références suivants : - - Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. - - Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. +- Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. +- Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. En utilisant le langage 4D, vous définissez la propriété Title à l'aide du paramètre *itemText* des commandes `APPEND MENU ITEM`, `INSERT MENU ITEM`, et `SET MENU ITEM`. @@ -53,8 +53,8 @@ Vous choisissez d’associer une action standard ou une méthode projet à la co Pour associer une méthode projet et/ou une action standard à une commande de menu sélectionnée dans l'éditeur de menu : - - **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. - - **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. +- **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. +- **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. **Note macOS :** Sous macOS, les commandes de menus créés associées à l'action *Quitter* sont automatiquement placées dans le menu de l’application, conformément aux normes d’interface de cette plate-forme. A l'aide du langage 4D, vous pouvez associer une méthode projet via la commande `SET MENU ITEM METHOD` et une action standard via la commande `SET MENU ITEM PROPERTY`. @@ -101,13 +101,13 @@ Vous pouvez affecter des raccourcis clavier à toute commande de menu. Lorsqu’ Vous pouvez également ajouter les touches **Majuscule** ainsi que **Alt** (Windows) ou **Option** (macOS) au raccourci clavier associé à une commande. Cette possibilité multiplie le nombre de raccourcis clavier utilisables dans les barres de menus. Les raccourcis clavier définis peuvent donc être de différents types : - - Sous Windows : +- Sous Windows : - Ctrl+lettre - Ctrl+Maj+lettre - Ctrl+Alt+lettre - Ctrl+Maj+Alt+lettre - - Sous macOS : +- Sous macOS : - Commande+lettre - Commande+Maj+lettre - Commande+Option+lettre diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md b/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md index a053ab76a4389c..20921bb9449862 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -9,17 +9,17 @@ Lisez [**Les nouveautés de 4D 21**](https://blog.4d.com/fe-whats-new-in-4d-v21/ #### Points forts - - The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. - - Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. - - Langage 4D: +- The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. +- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. +- Langage 4D: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). #### Changements de comportement - - Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. - - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). +- Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. +- Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. +- Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). ## 4D 20 R10 @@ -27,27 +27,27 @@ Lisez [**Les nouveautés de 4D 20 R10**](https://blog.4d.com/fe-whats-new-in-4d- #### Points forts - - Handling of [ORDA events on data](../ORDA/orda-events.md). - - Nouvelle option `connectionTimeout` dans le paramètre [`options`](../API/TCPConnectionClass.md#options-parameter) de la fonction [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Langage 4D: +- Handling of [ORDA events on data](../ORDA/orda-events.md). +- Nouvelle option `connectionTimeout` dans le paramètre [`options`](../API/TCPConnectionClass.md#options-parameter) de la fonction [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Langage 4D: - Pour des raisons de cohérence, les commandes [`Create entity selection`](../commands/create-entity-selection.md) et [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) ont été déplacées du thème ["4D Environnement"](../commands/theme/4D_Environment.md) vers le thème ["Sélections"](../commands/theme/Selection.md). - Nouvelles commandes [`OBJET SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) et [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) pour assigner et lire les objets `Formula` comme sources de données pour les objets de formulaire. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) et [`LISTBOX Get property`](../commands/listbox-get-property.md) prennent en charge trois nouvelles constantes : `lk current item`, `lk current item position`, et `lk selected items expression`. - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### Changements de comportement - - Sous Windows, les polices d'imprimante courantes destinées uniquement à l'impression (c'est-à-dire non utilisables à l'écran) ne sont plus chargées par 4D au démarrage. - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- Sous Windows, les polices d'imprimante courantes destinées uniquement à l'impression (c'est-à-dire non utilisables à l'écran) ne sont plus chargées par 4D au démarrage. +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -55,20 +55,20 @@ Lisez [**Les nouveautés de 4D 20 R9**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) est désormais obsolète et sera supprimée dans la prochaine version. - - Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). - - L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). - - Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. - - Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. - - Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). - - Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. - - Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. - - Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. - - 4D Write Pro Interface : nouvelle [IA intégrée](../WritePro/writeprointerface.md#integrated-ai) pour interagir avec **chatGTP** depuis vos documents 4D Write Pro. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. +- La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) est désormais obsolète et sera supprimée dans la prochaine version. +- Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). +- L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). +- Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. +- Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. +- Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). +- Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. +- Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. +- Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. +- 4D Write Pro Interface : nouvelle [IA intégrée](../WritePro/writeprointerface.md#integrated-ai) pour interagir avec **chatGTP** depuis vos documents 4D Write Pro. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. ## 4D 20 R8 @@ -76,29 +76,29 @@ Lisez [**Les nouveautés de 4D 20 R8**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). - - Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). - - Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. - - [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. - - [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. - - Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#evaluation-application) dans la boîte de dialogue du Générateur d'applications. - - Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. - - Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) pour la journalisation détaillée des événements TCP. - - Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. - - 4D Write Pro : +- Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). +- Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). +- Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. +- [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. +- [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. +- Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#evaluation-application) dans la boîte de dialogue du Générateur d'applications. +- Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. +- Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) pour la journalisation détaillée des événements TCP. +- Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. +- 4D Write Pro : - Les commandes suivantes acceptent maintenant des paramètres tels que des objets ou des collections : [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get Attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), et [WP Insert picture] (../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), et [WP Insert break](../WritePro/commands/wp-insert-break.md), sont maintenant des fonctions qui retournent des plages. - Nouvelles expressions liées aux attributs de documents : [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) et [This.pageIndex](../WritePro/managing-formulas.md). - - Langage 4D: +- Langage 4D: - Commande modifiée : [`FORM EDIT`](../commands/form-edit.md) - Les fonctions [`.sign()`](../API/CryptoKeyClass.md#sign) et [`.verify()`](../API/CryptoKeyClass.md#verify) de la [classe 4D.CryptoKey](../API/CryptoKeyClass.md) prennent en charge des Blobs dans le paramètre *message*. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. #### Changements de comportement - - Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. - - En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. +- Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. +- En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. ## 4D 20 R7 @@ -106,30 +106,30 @@ Lisez [**Les nouveautés de 4D 20 R7**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). - - Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. - - Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. - - Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. - - Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). - - Langage 4D: +- Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). +- Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. +- Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. +- Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. +- Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). +- Langage 4D: - Nouvelles commandes : [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Commandes modifiées : [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*o\*". - - 4D Write Pro : +- 4D Write Pro : - Nouvelle commande : [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Commandes modifiées : [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. #### Changements de comportement - - Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. - - La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. - - L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. +- Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. +- La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. +- L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -137,25 +137,25 @@ Lisez [**Les nouveautés de 4D 20 R6**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). - - Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). - - Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). - - Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. - - Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. - - Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. - - Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. - - Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. - - Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). - - Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). - - Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. - - Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. +- Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). +- Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). +- Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). +- Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. +- Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. +- Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. +- Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. +- Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. +- Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). +- Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). +- Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. +- Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. #### Changements de comportement - - Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). - - L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). +- Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). +- L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). ## 4D 20 R5 @@ -163,21 +163,21 @@ Lisez [**Les nouveautés de 4D 20 R5**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. - - Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). - - Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). - - Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nouveau paramètre REST [$format](../REST/$format.md). - - L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. +- Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. +- Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). +- Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). +- Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nouveau paramètre REST [$format](../REST/$format.md). +- L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. #### Changements de comportement - - Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). - - Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). +- Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). +- Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). ## 4D 20 R4 @@ -185,24 +185,24 @@ Lisez [**Les nouveautés de 4D 20 R4**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. - - Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). - - Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. - - Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). - - Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) - - Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. - - Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). - - Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). - - Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. +- Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. +- Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). +- Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. +- Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). +- Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) +- Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. +- Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). +- Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). +- Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. #### Changements de comportement - - L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. - - La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). - - Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. - - Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). +- L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. +- La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). +- Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. +- Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -210,21 +210,21 @@ Lisez [**Les nouveautés de 4D 20 R3**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). - - Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). - - Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) - - Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. +- Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). +- Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). +- Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) +- Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. #### Changements de comportement - - Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). - - 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. +- Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). +- 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. ## 4D 20 R2 @@ -238,15 +238,15 @@ Si vos applications 4D utilisent des connexions TLS, il est recommandé de mettr #### Points forts - - Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. - - Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. - - 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. - - 4D Write Pro Interface : Nouveau [Table Wizard](../WritePro/writeprointerface.md). - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. +- Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. +- Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. +- 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. +- 4D Write Pro Interface : Nouveau [Table Wizard](../WritePro/writeprointerface.md). +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. #### Changements de comportement - - **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. +- **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. ## 4D 20.x LTS diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md index 48c74a65b4b864..9b0733a2694544 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Pour activer le suivi des changements de données, la structure de l'application De plus, pour assurer la bonne marche de la fonctionnalité, les conditions suivantes sont requises : - - Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. - - Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : +- Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. +- Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : | Champ | Type | Description | | ------------------------------------------------------- | --------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Pour activer le suivi des changements de données : 4D effectue alors les modifications suivantes : - - Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). - - Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. +- Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). +- Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. Pour désactiver le suivi des changements de données : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index eaec1aa2c56823..66bd65e1fc9a42 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md index 7e38656d222ca3..87dfd77783f99b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La session web créée sur le datastore distant est identifiée à l'aide d'un I Le `localID` est local à la machine qui se connecte au datastore distant, ce qui signifie que : - - Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. - - Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. - - Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. +- Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. +- Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. +- Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. Ces principes sont illustrés dans les graphiques suivants : @@ -29,9 +29,9 @@ Ces principes sont illustrés dans les graphiques suivants : Les process qui gèrent les sessions d'accès aux datastore apparaissent dans la fenêtre d'administration de 4D Server : - - nom : "REST Handler : \" - - type : type Worker Server HTTP - - session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. +- nom : "REST Handler : \" +- type : type Worker Server HTTP +- session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. Dans l'exemple suivant, deux process sont en cours d'exécution pour la même session : @@ -47,11 +47,11 @@ Si une demande est envoyée au datastore distant après la fermeture de la sessi Les fonctionnalités ORDA relatives au verrouillage d'entité et aux transactions sont gérées au niveau du process dans les datastore distants, tout comme en mode client/serveur ORDA : - - Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. - - Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. - - 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`). +- Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. +- Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. +- 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`). Si une entité d'un datastore distant est verrouillée par une transaction dans un process, les autres process ne peuvent pas la mettre à jour, même si ces process partagent la même session. - - Les verrous sur les entités sont supprimés et les transactions sont annulées : +- Les verrous sur les entités sont supprimés et les transactions sont annulées : - lorsque le process est tué. - quand la session est fermée sur le serveur - lorsque la session est arrêtée à partir de la fenêtre d’administration du serveur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/general.md b/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/general.md index b199ec37d80b4c..b24e860f1804e9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/general.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/general.md @@ -11,12 +11,12 @@ Cette page regroupe diverses options permettant de paramétrer le fonctionnement Cette option permet de configurer l’affichage proposé par défaut par 4D au démarrage, lorsque l’utilisateur lance uniquement l’application. - - **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. - - **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. - - **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. +- **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. +- **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. +- **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. > To force the display of the opening dialog box when this option is selected, hold down the **Alt** (Windows) or **Option** (macOS) key while launching the project. - - **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. - - **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. +- **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. +- **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. > > > **4D Server**: The 4D Server application ignores this option. Dans cet environnement, le mode **Ne rien faire** est toujours utilisé. @@ -30,8 +30,8 @@ Depuis macOS Sierra, les applications Mac bénéficient d'onglets automatiques f Vous pouvez bénéficier de cette fonctionnalité dans les environnements de 4D suivants (versions 64 bits uniquement) : - - Fenêtres de l'éditeur de code - - Fenêtres de l'éditeur de formulaires +- Fenêtres de l'éditeur de code +- Fenêtres de l'éditeur de formulaires Toutes les fenêtres de ces éditeurs peuvent être ouvertes sous forme d'onglets : @@ -47,9 +47,9 @@ Dans la boîte de dialogue des Préférences de 4D, l'option **Fenêtre à ongle Trois options sont disponibles : - - **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). - - **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). - - **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. +- **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). +- **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). +- **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. ### Apparence (macOS uniquement) @@ -59,9 +59,9 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser pour l'e Trois options sont disponibles : - - **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. - - **Clair** : Utiliser le thème clair - - **Sombre** : utiliser le thème sombre +- **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. +- **Clair** : Utiliser le thème clair +- **Sombre** : utiliser le thème sombre > Cette préférence n'est prise en charge que sur macOS. Sous Windows, la palette "Light" est toujours utilisée. @@ -73,8 +73,8 @@ Si cette option est cochée, lorsque l’utilisateur passe en mode Application v Si vous sélectionnez cette option, deux éléments s'ajoutent au menu **Fichier > Nouveau** et au bouton **Nouveau** de la barre d'outils : - - **Database...** - - **Base de données à partir d'une définition de structure...** +- **Database...** +- **Base de données à partir d'une définition de structure...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Lors de la création d’un nouveau fichier de données, 4D utilise la langue d Cette zone permet de configurer l'accès à la documentation HTML de 4D qui s'affiche dans votre navigateur courant : - - When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; - - Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . +- When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; +- Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . ### Langue de documentation @@ -151,8 +151,8 @@ Langue de la documentation HTML à afficher. Vous pouvez sélectionner une docum Définit l'emplacement des pages de documentation recherchées par 4D. - - Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. - - If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. +- Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. +- If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. ### Dossier local diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/methods.md b/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/methods.md index 9be8a4354abe73..7d45b24ea92cac 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/methods.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Preferences/methods.md @@ -15,8 +15,8 @@ Cette page permet de sélectionner, de créer ou de configurer les thèmes de l' Sélectionnez, dans cette liste, le thème à appliquer à l'éditeur de code. Tous les thèmes disponibles sont affichés, y compris les thèmes personnalisés (le cas échéant). 4D propose deux thèmes par défaut : - - **Default Light Theme** - - **Default Dark Theme** +- **Default Light Theme** +- **Default Dark Theme** > Les thèmes par défaut ne peuvent être ni modifiés ni supprimés. @@ -38,8 +38,8 @@ Si des valeurs clés ne sont pas définies dans un thème personnalisé, elles p Définir un thème signifie : - - définir une police et une taille de police pour l'ensemble de l'éditeur de code, - - attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. +- définir une police et une taille de police pour l'ensemble de l'éditeur de code, +- attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. La combinaison de couleurs et de styles différents est particulièrement utile à des fins de maintenance du code. @@ -83,8 +83,8 @@ Cette page configure les options d'affichage de l'éditeur de code. Permet de désactiver/activer les paramètres du code "international" pour l'application 4D locale. - - **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. - - **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. +- **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. +- **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. > Si vous modifiez cette option, vous devez redémarrer l'application 4D pour que le changement soit pris en compte. @@ -138,9 +138,9 @@ Permet de masquer, par défaut, toutes les icônes plier/déplier lorsque vous a Active l'insertion automatique de () et de caractères fermants lors de la saisie du code. Cette option contrôle deux fonctionnalités automatiques : - - **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). +- **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). - - **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : +- **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Active l'insertion automatique de () et de caractères fermants lors de la saisi Permet de modifier la signalisation graphique des caractères d'encadrement correspondants dans le code. Cette signalisation apparaît lorsqu’un crochet, une parenthèse ou une accolade est sélectionné(e). Les options suivantes sont disponibles : - - **Aucun** : Aucun signal - - **Rectangle** (default): Braces surrounded by a black line\ +- **Aucun** : Aucun signal +- **Rectangle** (default): Braces surrounded by a black line\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). - - **Gras** : caractères affichés en gras. +- **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). +- **Gras** : caractères affichés en gras. #### Surbrillance des variables et champs @@ -162,9 +162,9 @@ Permet de mettre en surbrillance toutes les occurrences d'un(e) même variable o ![](../assets/en/Preferences/optionsVariables.png) - - **Non** (par défaut) : Pas de surbrillance - - **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué - - **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné +- **Non** (par défaut) : Pas de surbrillance +- **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué +- **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné La couleur de surlignage peut être modifiée dans la page [Définition d'un thème](#définition-dun-thème). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Project/architecture.md b/i18n/fr/docusaurus-plugin-content-docs/current/Project/architecture.md index 57a47fc24adf11..3a413828c5340d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Project/architecture.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Project/architecture.md @@ -5,7 +5,7 @@ title: Architecture d'un projet Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un dossier racine de projet (dossier package). Par exemple : - - MyPackage (*dossier racine du projet*) +- MyPackage (*dossier racine du projet*) - `Composants` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un do La hiérarchie du dossier Project se présente généralement comme suit : - - fichier `.4DProject` - - `Sources` +- fichier `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Formulaires` - `TableForms` - `Les Triggers` - - `DerivedData` - - `Trash` (le cas échéant) +- `DerivedData` +- `Trash` (le cas échéant) ### fichier `.4DProject` Le fichier de développement de projet, utilisé pour désigner et lancer le projet. Ce fichier peut être ouvert par : - - 4D - - 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) > Dans les projets 4D, le développement est réalisé avec 4D et le développement multi-utilisateurs est géré par des outils de contrôle de version. 4D Server peut ouvrir des fichiers .4DProject à des fins de test. @@ -120,9 +120,9 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe Le dossier Trash contient des méthodes et des formulaires qui ont été supprimés du projet (le cas échéant). Il peut contenir les dossiers suivants : - - `Methods` - - `Formulaires` - - `TableForms` +- `Methods` +- `Formulaires` +- `TableForms` Dans ces dossiers, les noms des éléments supprimés sont entre parenthèses, par exemple. "(myMethod).4dm". L'organisation des dossiers est identique à celle du dossier [Sources](#sources). @@ -175,11 +175,11 @@ This folder contains [**user settings for data**](../Desktop/user-settings.md#us Le dossier Logs contient tous les fichiers journaux utilisés par le projet. Les fichiers journaux comprennent notamment : - - conversion de base de données, - - requêtes de serveur Web, - - journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) - - débogage de commandes, - - Requêtes 4D Server (générées sur les postes clients et sur le serveur). +- conversion de base de données, +- requêtes de serveur Web, +- journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) +- débogage de commandes, +- Requêtes 4D Server (générées sur les postes clients et sur le serveur). > Un dossier Logs supplémentaire est disponible dans le dossier des préférences système de l'utilisateur (dossier 4D actif, voir commande [Get 4D folder](../commands-legacy/get-4d-folder.md)) pour les fichiers journaux de maintenance et d diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/fr/docusaurus-plugin-content-docs/current/Project/components.md index 2ac7efc67fdc63..55d5cf69c7d540 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Project/components.md @@ -13,15 +13,15 @@ Lorsque vous développez dans 4D, les fichiers de composants peuvent être stock Les composants peuvent être interprétés ou [compilés](../Desktop/building.md). - - Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. - - Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. +- Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. +- Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. ### Dossier racine (package) Le dossier racine d'un composant (dossier *MyComponent.4dbase*) peut contenir : - - pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. - - pour les **composants compilés** : +- pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. +- pour les **composants compilés** : - soit un dossier "Contents" contenant un fichier .4DZ, un dossier *Resources*, un fichier *Info.plist* (architecture recommandée) - soit directement un fichier .4DZ avec d'autres dossiers tels que *Resources*. @@ -37,8 +37,8 @@ L'architecture de dossier "Contents" est recommandée pour les composants si vou Cette page décrit comment travailler avec les composants dans les environnements **4D** et **4D Server**. Dans les autres environnements, les composants sont gérés différemment : - - dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. - - dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). +- dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. +- dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Cette page décrit comment travailler avec les composants dans les environnement Pour charger un composant dans votre projet 4D, vous pouvez soit : - - copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), - - ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). +- copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), +- ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). Les composants déclarés dans le fichier **dependencies.json** peuvent être stockés à différents endroits : - - au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, - - n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** - - sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. +- au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, +- n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** +- sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. Si le même composant est installé à différents endroits, un [ordre de priorité](#priority) est appliqué. @@ -69,8 +69,8 @@ Le fichier **dependencies.json** référence tous les composants nécessaires à Il peut contenir : - - les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), - - les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). +- les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), +- les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ Le fichier **environment4d.json** est facultatif. Il vous permet de définir des Les principaux avantages de cette architecture sont les suivants : - - vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. - - si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. +- vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. +- si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. ### Priorité @@ -187,9 +187,9 @@ En ce qui concerne les composants stockés sur GitHub, les fichiers [**dependenc Pour pouvoir référencer et utiliser directement un composant 4D stocké sur GitHub, vous devez configurer le dépôt du composant GitHub : - - Compressez les fichiers des composants au format ZIP. - - Nommez cette archive avec le même nom que le dépôt GitHub. - - Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. +- Compressez les fichiers des composants au format ZIP. +- Nommez cette archive avec le même nom que le dépôt GitHub. +- Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. Ces étapes peuvent être facilement automatisées, avec du code 4D ou en utilisant des actions GitHub, par exemple. @@ -232,7 +232,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin ::: - - Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : +- Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : ```json { @@ -245,7 +245,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin } ``` - - Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : +- Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : ```json { @@ -262,17 +262,17 @@ Un intervalle est défini par deux versions sémantiques, un minimum et un maxim Voici quelques exemples : - - "latest" : la version ayant le badge "latest" dans les releases GitHub. - - "\*" : la dernière version publiée. - - "1.\*" : toutes les versions de la version majeure 1. - - "1.2.\*" : tous les correctifs de la version mineure 1.2. - - ">=1.2.3" : la dernière version, à partir de la version 1.2.3. - - ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. - - "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. - - "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. - - "<=1.2.3" : la dernière version jusqu'à la 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. - - "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. +- "latest" : la version ayant le badge "latest" dans les releases GitHub. +- "\*" : la dernière version publiée. +- "1.\*" : toutes les versions de la version majeure 1. +- "1.2.\*" : tous les correctifs de la version mineure 1.2. +- ">=1.2.3" : la dernière version, à partir de la version 1.2.3. +- ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. +- "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. +- "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. +- "<=1.2.3" : la dernière version jusqu'à la 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. +- "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. Si vous ne spécifiez pas de tag ou de version, 4D récupère automatiquement la version "latest". @@ -282,9 +282,9 @@ Le Gestionnaire de dépendances vérifie périodiquement si des mises à jour de Si vous souhaitez utiliser la règle de dépendance [**Suivre la version 4D**](#defining-a-github-dependency-version-range), les tags des releases des composants sur le dépôt Github doivent respecter des conventions spécifiques. - - **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". +- **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". - - **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. +- **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. :::note @@ -310,8 +310,8 @@ Vous devez ensuite [fournir votre token de connexion](#providing-your-github-acc Les composants GitHub référencés sont téléchargés dans un dossier de cache local puis chargés dans votre environnement. Le dossier de cache local est stocké à l'emplacement suivant : - - sous macOs : `$HOME/Library/Caches//Dependencies` - - sous Windows : `C:\Users\\AppData\Local\\Dependencies` +- sous macOs : `$HOME/Library/Caches//Dependencies` +- sous Windows : `C:\Users\\AppData\Local\\Dependencies` ...où `` peut être "4D", "4D Server" ou "tool4D". @@ -319,12 +319,12 @@ Les composants GitHub référencés sont téléchargés dans un dossier de cache When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Cela inclut : - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ Dans un projet ouvert, vous pouvez ajouter, supprimer, mettre à jour et obtenir Pour afficher la fenêtre Dépendances : - - avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
+- avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
+- avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
![menu-dépendances-serveur](../assets/en/Project/dependency-menu-server.png) La fenêtre Dépendances s'affiche alors. Les dépendances sont classées par nom par ordre alphabétique : @@ -362,11 +362,11 @@ Par défaut, toutes les dépendances identifiées par le Gestionnaire de dépend ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. - - **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. +- **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. ### Secondary dependencies @@ -384,16 +384,16 @@ Les dépendances nécessitant l'attention du développeur sont signalées par un Les étiquettes de statut suivantes sont disponibles : - - **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. - - **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. - - **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. - - **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). - - **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). - - **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. - - **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. - - **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. - - **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. - - **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. +- **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. +- **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. +- **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. +- **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). +- **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). +- **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. +- **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. +- **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. +- **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. +- **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. Une infobulle s'affiche lorsque vous survolez la ligne de dépendance, fournissant des informations supplémentaires sur le statut : @@ -427,8 +427,8 @@ Cet élément n'est pas affiché si la dépendance est inactive parce que ses fi L'icône du composant et le logo de l'emplacement fournissent des informations supplémentaires : - - Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. - - Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. +- Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. +- Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Si l'élément sélectionné n'est pas valide, un message d'erreur s'affiche. Cliquez sur **Ajouter** pour ajouter la dépendance au projet. - - Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). - - Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). +- Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). +- Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Vous pouvez définir l'option [règle de dépendance](#tags-and-versions) pour u ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). - - **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. - - **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. - - **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. - - **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. +- **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). +- **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. +- **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. +- **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. +- **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. La version courante de la dépendance GitHub est affichée sur le côté droit de l'élément de la dépendance : @@ -509,8 +509,8 @@ La modification de la plage de versions est utile par exemple si vous utilisez l Le Gestionnaire de dépendances permet une gestion intégrée des mises à jour sur GitHub. Les fonctionnalités suivantes sont prises en charge : - - Vérification automatique et manuelle des versions disponibles - - Mise à jour automatique et manuelle des composants +- Vérification automatique et manuelle des versions disponibles +- Mise à jour automatique et manuelle des composants Les opérations manuelles peuvent être effectuées **par dépendance** ou **pour toutes les dépendances**. @@ -526,11 +526,11 @@ Si vous fournissez un [token d'accès](#providing-your-github-access-token), les En outre, vous pouvez vérifier les mises à jour à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. +- Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. ![check component](../assets/en/Project/check-component-one.png) - - Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. +- Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. ![check components](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Si vous ne souhaitez pas utiliser la mise à jour des composants (par exemple, v Vous pouvez mettre à jour les dépendances à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : +- Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : ![check component](../assets/en/Project/update-component-one.png) - - Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : +- Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ Dans tous les cas, quel que soit le statut courant de la dépendance, une vérif Lorsque vous sélectionnez une commande de mise à jour : - - une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. - - si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. +- une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. +- si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. #### Mise à jour automatique @@ -575,13 +575,13 @@ Lorsque cette option n'est pas cochée, une nouvelle version de composant corres L'enregistrement de votre *token* (jeton) d'accès personnel dans le gestionnaire de dépendances est : - - obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), - - recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. +- obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), +- recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. Pour fournir votre jeton d'accès à GitHub, vous pouvez soit : - - cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. - - ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. +- cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. +- ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Project/documentation.md b/i18n/fr/docusaurus-plugin-content-docs/current/Project/documentation.md index b9fb76949e4525..a376f818c231b2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Project/documentation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Project/documentation.md @@ -7,10 +7,10 @@ Dans les projets d'application, vous pouvez documenter vos méthodes ainsi que v Les éléments de projet suivants peuvent être documentés : - - Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) - - Classes - - Formulaires - - Tables et champs +- Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) +- Classes +- Formulaires +- Tables et champs Vos fichiers de documentation sont écrits dans la syntaxe Markdown (fichiers .md) à l'aide de n'importe quel éditeur prenant en charge le Markdown. Ils sont stockés en tant que fichiers indépendants dans votre dossier Project. @@ -34,7 +34,7 @@ Tous les fichiers de documentation sont stockés dans le dossier `Documentation` L'architecture du dossier `Documentation` est la suivante : - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ L'architecture du dossier `Documentation` est la suivante : - table1.md - ... - - Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. - - Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. > Renommer ou supprimer un élément documenté dans votre projet renomme ou supprime également le fichier Markdown associé à l'élément. @@ -73,9 +73,9 @@ Pour afficher la documentation dans la fenêtre de l'Explorateur : ![](../assets/en/Project/comments-explo2.png) - - Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). +- Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). - - Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. +- Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. ### Modifier le fichier documentation @@ -83,8 +83,8 @@ Vous pouvez créer et/ou modifier un fichier de documentation Markdown à partir S'il n'y a pas de fichier de documentation pour l'élément sélectionné, vous pouvez : - - cliquez sur le bouton **Créer** dans le volet `Documentation` ou, - - choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. +- cliquez sur le bouton **Créer** dans le volet `Documentation` ou, +- choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ L'éditeur de code 4D affiche une partie de la documentation d'une méthode dans Si un fichier nommé`\.md` existe dans le dossier `\/documentation` , l'éditeur de code affiche (par priorité) : - - Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. +- Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. - - Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ +- Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D. @@ -131,7 +131,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Prise en charge du markdown - - La balise de titre est prise en charge : +- La balise de titre est prise en charge : ```md # Title 1 @@ -139,7 +139,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Title 3 ``` - - Les balises de style (italique, gras, barré) sont prises en charge : +- Les balises de style (italique, gras, barré) sont prises en charge : ```md _italic_ @@ -148,7 +148,7 @@ _italic_ ~~strikethrough~~ ``` - - La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : +- La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : ````md ```4d @@ -157,7 +157,7 @@ _italic_ ``` ```` - - La balise de tableau est prise en charge : +- La balise de tableau est prise en charge : ```md | Parameter | Type | Description | @@ -166,7 +166,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La balise de lien est prise en charge : +- La balise de lien est prise en charge : ```md // Case 1 @@ -178,7 +178,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Les balises d'image sont prises en charge : +- Les balises d'image sont prises en charge : ```md ![image info](pictures/image.png) @@ -225,10 +225,10 @@ $logo:=GetLogo(5) ``` ```` - - Vue de l'explorateur : +- Vue de l'explorateur : ![](../assets/en/Project/explorer_Doc.png) - - Vue de l'éditeur de code : +- Vue de l'éditeur de code : ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$attributes.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$attributes.md index fc307574f2b1cc..72713992861bd9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$attributes.md @@ -11,18 +11,18 @@ Lorsque vous avez des attributs relationnels dans une dataclass, utilisez `$attr Vous pouvez appliquer des `$attributes` à une entité (par exemple, People (1)) ou à une entity selection (par exemple, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. +- Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. - - Si `$attributes` est spécifié pour les attributs **related entity** : +- Si `$attributes` est spécifié pour les attributs **related entity** : - `$attributes=relatedEntity` : l'entité liée est retournée sous une forme simple (propriété __KEY différée (clé primaire)) et `URI`. - `$attributes=relatedEntity.*` : tous les attributs de l'entité liée sont retournés - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs de l'entité liée sont retournés. - - Si `$attributes` est spécifié pour les attributs **related entities** : +- Si `$attributes` est spécifié pour les attributs **related entities** : - `$attributes=relatedEntities.*` : toutes les propriétés des entités liées sont retournées - `$attributes=relatedEntities.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs des entités liées sont retournés. - - Si `$attributes` est spécifié pour les attributs **storage** : +- Si `$attributes` est spécifié pour les attributs **storage** : - `$attributes=attribute1, attribute2, ...` : seuls les attributs des entités sont renvoyés. ## Exemple avec plusieurs entités liées diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$lock.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$lock.md index f291bc472820ca..9bb7a1a9f8c763 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$lock.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$lock.md @@ -27,13 +27,13 @@ Les verrouillages déclenchés par l'API REST sont placés au niveau de la [sess Une entité verrouillée est considérée comme *verrouillée* (c'est-à-dire que les actions de verrouillage / déverrouillage / mise à jour / suppression ne sont pas possibles) par : - - d'autres sessions REST - - les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. +- d'autres sessions REST +- les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. Une entité verrouillée par l'API REST peut être déverrouillée uniquement : - - via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` - - ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). +- via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` +- ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). ### Réponse diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$method.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$method.md index 21c28f15321bb4..bea88fda52e2c1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/$method.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/$method.md @@ -194,9 +194,9 @@ Si un problème survient lors de l'ajout ou de la modification d'une entité, un :::note - - **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). - - Les valeurs des **booléens** sont vrai ou faux. - - Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). +- Les valeurs des **booléens** sont vrai ou faux. +- Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md index f311bd3e223da4..5740fc0d6c2ff1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Vous pouvez appeler les [fonctions de classe du modèle de données](ORDA/ordaCl Les fonctions peuvent être appelées de deux manières : - - en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. - - en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. +- en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. +- en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. Les requêtes POST offrent un meilleur niveau de sécurité car elles évitent l'exécution de code sensible par une action aussi simple que de cliquer sur un lien. Cependant, les requêtes GET peuvent être plus conformes à l'expérience utilisateur, en permettant d'appeler des fonctions en saisissant un URL dans un navigateur (note : le développeur doit s'assurer qu'aucune action sensible n'est effectuée dans ces fonctions). @@ -96,11 +96,11 @@ Vous pouvez envoyer des paramètres à des fonctions de classes utilisateur ou d Les règles suivantes s'appliquent : - - Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. - - Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. - - Les paramètres doivent être inclus dans une collection (format JSON). - - Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. - - L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. +- Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. +- Les paramètres doivent être inclus dans une collection (format JSON). +- Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. +- L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Voir [cet exemple](#using-an-entity-to-be-created-on-the-server) et [cet exemple](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Vous pouvez également transmettre des valeurs pour tous les attributs de l'enti | __ENTITY | Boolean | Obligatoire - Vrai pour indiquer au serveur que le paramètre est une entité | | __KEY | mixte (type identique à celui de la clé primaire) | Optionnel - clé primaire de l'entité | - - Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. - - Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés +- Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. +- Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés Voir les exemples ci-dessous pour la création ou la mise à jour d'entités avec des requêtes POST. Voir un exemple de téléchargement de contenu à l'aide d'une entité avec une requête GET. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/authUsers.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/authUsers.md index a58197e4054127..bb3704ed202c99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/authUsers.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/authUsers.md @@ -44,9 +44,9 @@ Toutes les autres requêtes REST (manipulant des données ou exécutant une fonc Les requêtes REST descriptives peuvent être traitées dans des sessions d'utilisateurs web qui ne nécessitent pas de licences (sessions "guest"). Ces requêtes sont : - - requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles - - `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur - - `/rest/$getWebForm` - le rendu d'une page Qodly +- requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles +- `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur +- `/rest/$getWebForm` - le rendu d'une page Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ La fonction peut recevoir toute information d'authentification ou contextuelle e Cette fonction doit contenir deux parties : - - un code pour identifier et authentifier l'expéditeur de la demande REST, - - si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. +- un code pour identifier et authentifier l'expéditeur de la demande REST, +- si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. Si la fonction ne fait pas appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), aucun privilège n'est attribué, aucune licence n'est consommée et les requêtes REST non descriptives ultérieures sont rejetées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/REST/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/current/REST/gettingStarted.md index 7ab8a9f2d6c9d8..25bdced0fd754f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/REST/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/REST/gettingStarted.md @@ -9,8 +9,8 @@ Le serveur REST est inclus dans 4D et 4D Server et automatiquement disponible da Cette section est destinée à vous familiariser avec la fonctionnalité REST à l'aide d'un exemple simple. Nous allons : - - créer et configurer un projet d'application 4D basique - - accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. +- créer et configurer un projet d'application 4D basique +- accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. Pour simplifier l'exemple, nous allons utiliser 4D et un navigateur qui s'exécutent sur la même machine. Bien entendu, vous pouvez également utiliser une architecture distante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/processes.md b/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/processes.md index f3df174864fa88..1c7e3fb711047c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/processes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/processes.md @@ -17,15 +17,15 @@ Vous disposez également de trois boutons-raccourcis permettant de filtrer par f ![](../assets/en/Admin/server-process-buttons.png) - - **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. - - **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. - - **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. +- **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. +- **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. +- **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. L’option **Afficher les process par groupes** vous permet de regrouper les process internes de 4D Server ainsi que les process clients, pour plus de lisibilité. Lorsque vous cochez cette option : - - les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, - - le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), - - le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. +- les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, +- le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), +- le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. La zone inférieure de la fenêtre permet d’afficher la représentation graphique de l’activité du ou des process sélectionné(s). @@ -33,16 +33,16 @@ La zone inférieure de la fenêtre permet d’afficher la représentation graphi L’activité du process est le pourcentage du temps que 4D Server a consacré à ce process (ratio). La fenêtre fournit les informations suivantes pour chaque process : - - Type de process (cf. ci-dessous), - - Session: +- Type de process (cf. ci-dessous), +- Session: - Process 4D - vide, - Process utilisateur - nom de l'utilisateur 4D, - Process web - chemin URL, - - Nom du process, - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. - - Etat courant du process, - - Temps (en secondes) d'exécution du process depuis sa création, - - Pourcentage du temps que 4D Server a consacré à ce process (ratio). +- Nom du process, +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. +- Etat courant du process, +- Temps (en secondes) d'exécution du process depuis sa création, +- Pourcentage du temps que 4D Server a consacré à ce process (ratio). ## Type du process @@ -83,15 +83,15 @@ La page comporte cinq boutons de commande permettant d’agir sur le ou les proc ![](../assets/en/Admin/server-process-actions.png) - - **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. +- **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Endormir process** : permet d’endormir le ou les process sélectionné(s). - - **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. - - **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). +- **Endormir process** : permet d’endormir le ou les process sélectionné(s). +- **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. +- **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). > Vous pouvez déboguer un process directement, sans afficher la boîte de dialogue de confirmation : pour cela, appuyez sur la touche **Alt** avant de cliquer sur le bouton. - - **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. +- **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md b/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md index 88e4afb8dfdc4c..a24ecfbc38ac30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Chaque opération longue sur les données entraîne l’ajout d’une ligne. La Les informations suivantes sont fournies pour chaque ligne : - - **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" - - **Durée** (ms) : durée en cours de l’opération en millisecondes - - **Informations** : libellé de l’opération. - - **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : +- **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" +- **Durée** (ms) : durée en cours de l’opération en millisecondes +- **Informations** : libellé de l’opération. +- **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : - **Créée sur** : indique si l'opération résulte d'une action d'un client (Créée sur client) ou si elle a été démarrée explicitement sur le serveur via une procédure stockée ou l'option "Exécuter sur serveur" (Créée sur serveur). - **Détails de l'opération** : décrit le type d'opération ainsi que (pour les opérations de recherche) le plan de recherche. - **Sous-opérations** (le cas échéant) : affiche les opérations dépendantes de l'opération sélectionnée (par exemple, suppression des enregistrements liés avant suppression de l'enregistrement parent). @@ -26,9 +26,9 @@ Les informations suivantes sont fournies pour chaque ligne : La page est active et mise à jour en permanence dès qu’elle est affichée. Il est à noter que son fonctionnement peut ralentir sensiblement l’exécution de l’application. Il est possible de suspendre la mise à jour de la page d’une des manières suivantes : - - en cliquant sur le bouton **Pause**, - - en cliquant dans la liste, - - en appuyant sur la barre d’espace. +- en cliquant sur le bouton **Pause**, +- en cliquant dans la liste, +- en appuyant sur la barre d’espace. Lorsque la page est en pause, le message "SUSPENDU" est affiché et le libellé du bouton devient **Reprendre**. Il est possible de reprendre l’observation des opérations en effectuant la même action que pour la mise en pause. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Users/overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/Users/overview.md index c236eba874ff74..1953c331cd9336 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Users/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Users/overview.md @@ -7,8 +7,8 @@ Si plusieurs personnes utilisent une application, ce qui est souvent le cas dans La stratégie de contrôle d'accès 4D dépend de la configuration de votre déploiement : - - dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, - - dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). +- dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, +- dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). > Consultez le document [4D Security guide](https://blog.4d.com/4d-security-guide/) pour une vue d'ensemble des fonctions de sécurité de 4D. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md index 01c8c873fe4fef..e25e474a6ccd30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Dans *filePath*, passez le chemin de destination et le nom du document à export Vous pouvez préciser le format du document en incluant une extension après son nom : - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", or ".csv") - - [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", or ".csv") +- [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si l'extension n'est pas incluse, mais que le format est spécifié dans *paramObj*, le fichier exporté aura l'extension correspondant au format, sauf pour le format CSV (aucune extension n'est ajoutée dans ce cas). @@ -88,25 +88,25 @@ Le paramètre optionnel *paramObj* vous permet de définir plusieurs propriété **Notes sur le format Excel** : - - Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. +- Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. **Notes sur le format PDF** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format CSV** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. - - Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. +- Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format de fichier SpreadJS** : - - [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Une fois l'opération d'exportation terminée, `VP EXPORT DOCUMENT` déclenche automatiquement l'exécution de la méthode définie dans la propriété *formula* de *paramObj*, si elle est utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md index ba7deb2c1a617b..7be68c67b0c15f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Vous pouvez définir où lire les feuilles de style via le paramètre *sheet* en passant le numéro d'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes : - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md index 6ef3aed705324f..c28b402a6b1381 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ L'objet retourné contiendra la propriété `value` et, dans le cas d'une valeur Si l'objet retourné inclut une date ou une heure, il est traité en tant que datetime et est complété comme suit : - - valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) - - valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) +- valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) +- valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) Si *rangeObj* contient plusieurs cellules ou plusieurs plages, la valeur de la première cellule est retournée. La commande retourne un objet null si la cellule est vide. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md index 5000ed7973c022..ceeabfea445387 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Dans *filePath*, passez le chemin et le nom du document à importer. Les formats suivants sont pris en charge : - - Les documents 4D View Pro (extension ".4vp") - - Microsoft Excel (extension ".xlsx") - - documents texte (extension ".txt", ".csv", le document doit être en utf-8) - - [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Les documents 4D View Pro (extension ".4vp") +- Microsoft Excel (extension ".xlsx") +- documents texte (extension ".txt", ".csv", le document doit être en utf-8) +- [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si l'extension du document n'est pas une extension reconnue, telle que `.4vp` ou `.xlsx`, le document est considéré comme un document texte. Vous devez passer un chemin d'accès complet, sauf si le document est situé au même niveau que le dossier Project, auquel cas vous pouvez simplement passer son nom. @@ -73,11 +73,11 @@ Le paramètre optionnel *paramObj* vous permet de définir les propriétés du d :::note Notes - - Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md index 60d66464e2227f..429215433cfae2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ La commande `VP RESIZE TABLE` modi Les règles suivantes s'appliquent : - - Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. - - Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. - - Si la table se développe sur des cellules contenant des données : +- Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. +- Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. +- Si la table se développe sur des cellules contenant des données : - si des lignes sont ajoutées, les données sont supprimées, - si des colonnes sont ajoutées, les données sont conservées et affichées dans de nouvelles colonnes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md index 44d8f2689dda1f..2b20cdb1f27596 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Les feuilles de calcul sont composées de lignes et de colonnes. Un numéro est ### Sélection des cellules, des colonnes et des lignes - - Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. +- Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. - - Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. +- Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. - - Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : +- Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). +- Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). - - Pour sélectionner une ligne, cliquez sur le chiffre correspondant. +- Pour sélectionner une ligne, cliquez sur le chiffre correspondant. - - Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. +- Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. - - Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. +- Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. ### Saisie de données @@ -76,8 +76,8 @@ Les zones 4D View Pro bénéficient d'un menu contextuel automatique qui offre d En fonction de la zone cliquée, les options suivantes sont également disponibles : - - cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu - - cliquez sur une cellule ou une plage de cellules : +- cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu +- cliquez sur une cellule ou une plage de cellules : - **Filtrer** : permet de masquer la ligne via des filtres (voir "Filtrer les lignes" dans la [documentation SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Trier** : permet de trier le contenu des colonnes. - **Insérer un commentaire** : permet à l'utilisateur de saisir un commentaire pour une zone. Lorsqu'un commentaire a été saisi pour une zone, la cellule supérieure gauche de la zone affiche un petit triangle rouge :\ @@ -128,8 +128,8 @@ Ensuite, vous pouvez passer `$myRange` à une autre méthode 4D View Pro pour mo Les objets plage 4D View Pro sont composés de plusieurs propriétés : - - area - Le nom de la zone 4D View Pro - - ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. +- area - Le nom de la zone 4D View Pro +- ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. | Propriété | | Type | Description | Disponible pour | | --------- | ------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Les objets plage 4D View Pro sont composés de plusieurs propriétés : 4D View Pro prend en charge l'import et l'export de plusieurs formats de documents : - - .4vp - - .xlsx - - .txt et .csv - - .sjs - - .pdf (à des fins d'export uniquement) +- .4vp +- .xlsx +- .txt et .csv +- .sjs +- .pdf (à des fins d'export uniquement) Pour plus de détails, consultez la description de [VP IMPORT DOCUMENT](commands/vp-import-document.md) et [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md index be935548f38b11..d09a66e2938ac9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Certains autres éléments ont une casse différente (par exemple : `this` vs `T Les noms des commandes et des constantes QodlyScript sont écrits en camel case sans espaces. De plus, les noms de constantes de QodlyScript commencent par la lettre `k`. Vous devrez peut-être adapter ces éléments QodlyScript au langage 4D. - - Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. - - Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. +- Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. +- Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. ### Exemple - - Code QodlyScript : +- Code QodlyScript : ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Les noms des commandes et des constantes QodlyScript sont écrits en camel case end ``` - - Code équivalent en langage 4D : +- Code équivalent en langage 4D : ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md index 74201be81f79d1..fa269cbe8b4f6e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Dans les sections ci-dessus, nous obtenons un accès libre à l'application à p La façon la plus simple et sécurisée de connecter un utilisateur sur le serveur web 4D est basée sur le scénario suivant : - - Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) - - La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. +- Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) +- La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. 1. Créez une table avec certains champs, par exemple : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index f60926b16c7b05..3f3bc43413eede 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Conditions requises Custom HTTP Request handlers are supported: - - when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/.+/index\.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ URL patterns can be given as **prefixes** or using **regular expressions**. Les modèles d'URL sont déclenchés dans l'ordre indiqué : - - le premier motif correspondant est exécuté - - the following patterns are not executed even if they match the URL +- le premier motif correspondant est exécuté +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Class and method You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. +- "method": class function belonging to the class. [See below](#request-handler-code) for information about the request handler code. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* in the *UsersHandling* class - - *handleInvoices* in the *FinancialHandling* class - - *handleDocs* in the *DocsHandling* class - - *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class +- *handle function* in the *GeneralHandling* class +- *manageAccount* in the *UsersHandling* class +- *handleInvoices* in the *FinancialHandling* class +- *handleDocs* in the *DocsHandling* class +- *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class Examples of URLs triggering the handlers: diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md index 930dc64822479b..a11763db72b129 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process | Serveur Web | coopératif | *paramètres web* | | Server Web Services | coopératif | *paramètres web* | - - Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) - - Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) - - Serveur de services Web : gère les requêtes SOAP - - ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: +- Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) +- Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) +- Serveur de services Web : gère les requêtes SOAP +- ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: - if scalable sessions are enabled, the preemptive mode is automatically used for web and web service processes. - if scalable sessions are not enabled: - for web processes, the [**Use preemptive processes**](webServerConfig.md#use-preemptive-processes) option is taken into account. @@ -36,21 +36,21 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souhaitez que les process Web soient lancés en mode préemptif. Lorsque l'option [Utiliser des process préemptifs](#availability-of-preemptive-mode-for-web-processes) est cochée dans le dialogue des Propriétés, les parties de l'application listées ci-dessous sont automatiquement évaluées par 4D Compiler : - - Toutes les méthodes base liées au web : +- Toutes les méthodes base liées au web : - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) et [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; +- La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; - - Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages - - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" +- Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" - - Triggers pour les tables comportant l'attribut "Expose as REST resource" +- Triggers pour les tables comportant l'attribut "Expose as REST resource" - - [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST +- [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST For each of these methods and code parts, the compiler will check if the [thread-safety rules are respected](../Develop/preemptive.md#writing-a-thread-safe-method), and will return errors in case of issues. @@ -62,8 +62,8 @@ La plupart des commandes, fonctions, méthodes base et URLs 4D sont thread-safe Toutes les commandes 4D relatives au Web sont thread-safe, à savoir : - - toutes les commandes du thème *Web Server* - - toutes les commandes du thème *Client HTTP*. +- toutes les commandes du thème *Web Server* +- toutes les commandes du thème *Client HTTP*. Les méthodes base ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif (voir ci-dessus) : `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -73,15 +73,15 @@ Bien sûr, le code exécuté par ces méthodes doit aussi être thread-safe. Les URLs Web Server ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif : - - *4daction/* (la méthode projet appelée doit également être à thread-safe) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) - - *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) +- *4daction/* (la méthode projet appelée doit également être à thread-safe) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) +- *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) ### Icône de process web préemptif diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md index 982f0b87a6ed3e..1d73a0c4482c7d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio peut également être utilisé sur la [**plateforme Qodly Cloud**]( Qodly Studio proposes a full-featured web UI, allowing you to: - - create Qodly pages by placing components on a canvas - - map components to Qodly Sources - - déclencher du code 4D en configurant des événements - - et bien plus encore ! +- create Qodly pages by placing components on a canvas +- map components to Qodly Sources +- déclencher du code 4D en configurant des événements +- et bien plus encore ! ## Configuration @@ -24,19 +24,19 @@ Qodly Studio proposes a full-featured web UI, allowing you to: Qodly Studio prend en charge les navigateurs Web suivants : - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La résolution recommandée est de 1920x1080. #### Application 4D - - Développement : 4D 20 R2 ou version ultérieure - - Déploiement : 4D Server 20 R2 ou version ultérieure - - Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). - - Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). - - Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). +- Développement : 4D 20 R2 ou version ultérieure +- Déploiement : 4D Server 20 R2 ou version ultérieure +- Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). +- Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). +- Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). ### Activer l'accès à Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio est alimenté par le [serveur WebAdmin](../Admin/webAdmin.md) et af Pour permettre l'accès à Qodly Studio, vous devez explicitement autoriser deux niveaux : - - au niveau de l'application 4D - - niveau projet +- au niveau de l'application 4D +- niveau projet Si l'un des deux niveaux (ou les deux) n'est pas activé, l'accès à Qodly Studio est refusé (une page 403 est renvoyée). @@ -79,8 +79,8 @@ L'authentification sur le serveur WebAdmin utilise une access key (clé d'accès Conformément à la gestion des projets 4D, seules les utilisations suivantes sont prises en charge : - - le développement avec Qodly Studio s'effectue avec **4D** (monoposte). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- le développement avec Qodly Studio s'effectue avec **4D** (monoposte). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La page Qodly Studio est disponible lorsque le [serveur WebAdmin est lancé](../ Il y a deux façons d'accéder à Qodly Studio : - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si le serveur WebAdmin est déjà en cours d'exécution, selon sa configuration, votre navigateur par défaut s'ouvre à l'adresse `IPaddress:HTTPPort/studio` ou `IPaddress:HTTPSPort/studio`. Sinon, vous serez invité à démarrer d'abord le serveur web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` ou : @@ -144,24 +144,24 @@ Notez que dans 4D monoposte, si vous ouvrez du code 4D avec l'éditeur de code d The following commands and classes are dedicated to the server-side management of Qodly pages: - - [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. - - [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. - - [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. - - [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. +- [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. +- [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. +- [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. +- [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. ### Utilisation des méthodes projet Nous recommandons d'utiliser les fonctions de classe plutôt que les méthodes projet. Seules les fonctions de classe peuvent être appelées à partir des composants. Cependant, vous pouvez toujours utiliser les méthodes projet dans Qodly Studio de deux manières : - - Vous pouvez appeler vos méthodes à partir des fonctions de classe. - - Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. +- Vous pouvez appeler vos méthodes à partir des fonctions de classe. +- Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. ### Utilisation hors ligne Vous pouvez développer avec Qodly Studio lorsque votre ordinateur n'est pas connecté à internet. Dans ce cas cependant, les fonctions suivantes ne sont pas accessibles : - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide - - UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide +- UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). ## Déploiement @@ -177,8 +177,8 @@ See [this page](https://developer.qodly.com/docs/studio/rendering) for detailed To enable the rendering of Qodly pages, the following options must be set. - - The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. - - Le [serveur Web 4D](webServer.md) doit être démarré. +- The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. +- Le [serveur Web 4D](webServer.md) doit être démarré. :::note @@ -308,9 +308,9 @@ To logout the user, you just need to execute the **Logout** standard action from Déclencher l'action de déconnexion d'une session utilisateur Web a les effets suivants : - - la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, - - la licence 4D associée est libérée, - - le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. +- la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, +- la licence 4D associée est libérée, +- le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. ## Utilisation de licences pour le rendu @@ -362,7 +362,7 @@ Pour plus d'informations sur l'attribut `SameSite`, consultez [cet article de bl Pour éviter d'utiliser plus de licences que nécessaire, nous vous recommandons d'effectuer l'une des actions suivantes : - - Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. - - Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. +- Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. +- Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/templates.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/templates.md index 003879e7952808..c71cb2bb77fe56 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/templates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/templates.md @@ -19,16 +19,16 @@ La valeur de la variable 4D *vtSiteName* sera insérée dans la page HTML. Les balises 4D suivantes sont disponibles : - - 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, - - 4DHTML, pour insérer du code HTML, - - 4DEVAL, pour évaluer toute expression 4D, - - 4DSCRIPT, pour exécuter une méthode 4D, - - 4DINCLUDE, pour inclure une page dans une autre, - - 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, - - 4DCODE, pour insérer du code 4D, - - 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, - - 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, - - 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. +- 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, +- 4DHTML, pour insérer du code HTML, +- 4DEVAL, pour évaluer toute expression 4D, +- 4DSCRIPT, pour exécuter une méthode 4D, +- 4DINCLUDE, pour inclure une page dans une autre, +- 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, +- 4DCODE, pour insérer du code 4D, +- 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, +- 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, +- 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. Ces balises sont décrites dans la page [Balises de transformation](../Tags/transformation-tags.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md index 5eb1fb5bbc72d8..83c947cfc03387 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un projet 4D peut démarrer et surveiller un serveur Web pour l'application prin Il y a plusieurs manières de démarrer le serveur Web principal : - - via un bouton/une commande de menu : +- via un bouton/une commande de menu : - 4D: **Exécution\>Démarrer le serveur Web**
![](../assets/en/WebServer/start1.png) - 4D Server : Bouton **Démarrer le serveur HTTP** dans la page Serveur HTTP
![](../assets/en/WebServer/start2.png) - - automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) +- automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) - - Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. +- Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. Le serveur Web de n'importe quel composant peut être lancé en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) sur l'objet serveur Web du composant. @@ -29,9 +29,9 @@ Le serveur Web de n'importe quel composant peut être lancé en appelant la fonc Il y a plusieurs manières d'arrêter le serveur Web principal : - - Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). +- Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). - - Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. +- Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. Le serveur Web de n'importe quel composant peut être arrêté en appelant la fonction `webServer.stop()` sur l'objet serveur Web du composant. @@ -53,8 +53,8 @@ Cette commande vous permet de vérifier que le serveur web, l'affichage de la pa Pour ce faire, vous pouvez : - - 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. - - 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. +- 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. +- 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. Le cache est alors immédiatement effacé. @@ -64,11 +64,11 @@ Le cache est alors immédiatement effacé. La page **Watch** (rubrique **Web**) de l'Explorateur d'exécution affiche les informations du serveur Web, notamment : - - **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. +- **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. - - **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. +- **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. - - **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. +- **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. ## URLs d'administration @@ -123,8 +123,8 @@ L'URL */4DWEBTEST* permet de vérifier l'état du serveur web. Lorsque cette URL 4D vous permet de générer deux historiques de requêtes Web : - - un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), - - un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). +- un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), +- un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). Les deux fichiers journaux sont automatiquement créés dans le dossier **Logs** du projet d'application. @@ -225,15 +225,15 @@ Les paramètres de sauvegarde automatique du logweb.txt sont définis sur la pag D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md index c2a535a167f54e..1ef4d8fc63371e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Liste des hôtes et méthodes autorisé(e)s pour le service CORS. Nom de domaine ou adresse IP à partir desquels les pages externes sont autorisées à envoyer des demandes de données au serveur via CORS. Plusieurs attributs de domaine peuvent être ajoutés pour créer une liste blanche. Plusieurs syntaxes sont supportées : - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Méthodes HTTP autorisées (propriété méthodes) Méthodes HTTP acceptées pour l'hôte CORS correspondant. Les méthodes HTTP suivantes sont prises en charge : - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Séparez chaque méthode par un ";" (ex : "post;get"). Si Méthodes est vide, null ou non défini, toutes les méthodes sont activées. @@ -145,9 +145,9 @@ Par défaut, quand le serveur web est lancé pour la première fois, 4D crée un Vous pouvez désigner une autre page comme page d'accueil par défaut en entrant son chemin d'accès : - - Le chemin est relatif au [dossier HTML racine ](#root-folder), - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Le chemin ne doit pas commencer ou finir par un slash. +- Le chemin est relatif au [dossier HTML racine ](#root-folder), +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Le chemin ne doit pas commencer ou finir par un slash. Par exemple, pour que la page d'accueil par défaut soit "MyHome.htm", si elle se trouve dans le dossier "Web" (lui-même situé dans le dossier racine HTML par défaut), utilisez "Web/MyHome.htm". @@ -318,15 +318,15 @@ Valeurs possibles: Chaîne de caractères représentant l'adresse IP. Les format #### À propos du support de l'IPv6 - - **Aucun avertissement lorsque le port TCP est occupé**
+- **Aucun avertissement lorsque le port TCP est occupé**
Lorsque le serveur est configuré pour répondre sur "Toutes" les adresses IP, si le port TCP est utilisé par une autre application, cela n'est pas indiqué au démarrage du serveur. En fait, le serveur 4D ne détecte pas d'erreur dans ce cas car le port reste libre sur l'adresse IPv6. Cependant, il n'est pas possible d'y accéder en utilisant l'adresse IPv4 de la machine, ni au moyen de l'adresse locale : 127.0.0.1. Si votre serveur 4D ne semble pas répondre sur le port défini, vous pouvez tester l'adresse [::1] sur la machine serveur (équivalent à 127.0.0.1 pour IPv6, ajoutez [:portNum] pour tester un autre numéro de port). Si 4D répond, il est probable qu'une autre application utilise le port en IPv4. - - **Adresses IPv6 avec mappage d'IPv4**
+- **Adresses IPv6 avec mappage d'IPv4**
Pour standardiser le traitement, 4D fournit une représentation hybride standard des adresses IPv4 en IPv6. Ces adresses sont écrites avec un préfixe de 96 bits au format IPv6, suivi de 32 bits écrits dans la notation décimale à point d'IPv4. Par exemple, ::ffff:192.168.2.34 représente l'adresse IPv4 192.168.2.34. - - **Indication des numéros de port**
+- **Indication des numéros de port**
Comme la notation IPv6 utilise les deux-points (:), l'ajout de numéros de port peut entraîner une certaine confusion, par exemple : ```code4d @@ -420,10 +420,10 @@ Version TLS minimale acceptée pour les connexions. Les tentatives de connexion Valeurs possibles : - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (par défaut) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (par défaut) +- 4 = TLSv1_3 En cas de modification, le serveur doit être redémarré pour utiliser la nouvelle valeur. @@ -489,10 +489,10 @@ Par exemple : Disallow: /GIFS/ ``` - - “User-Agent: \*” - tous les robots sont concernés. - - “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. - - "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. - - "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. +- “User-Agent: \*” - tous les robots sont concernés. +- “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. +- "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. +- "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. Autre exemple : @@ -517,15 +517,15 @@ De plus, le dossier racine HTML définit, sur le disque dur du serveur web, le n Par défaut, 4D définit un dossier racine HTML nommé **WebFolder**. S'il n'existe pas encore, le dossier racine HTML est physiquement créé sur le disque au moment où le serveur Web est lancé pour la première fois. Le dossier racine est créé : - - avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). - - avec 4D en mode remote, dans le fichier des ressources locales. +- avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). +- avec 4D en mode remote, dans le fichier des ressources locales. Vous pouvez désigner un autre dossier HTML racine comme page d'accueil par défaut en entrant son chemin d'accès. - - Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier - - Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). +- Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier +- Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). Par exemple, si vous voulez que le dossier racine HTML soit le sous-dossier "Web" du dossier "MyWebApp", entrez "MyWebApp/Web". @@ -580,9 +580,9 @@ Valeur de l'attribut `SameSite` du cookie de session. Cet attribut vous permet d Trois valeurs sont disponibles : - - "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. - - "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). - - "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). +- "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. +- "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). +- "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). La valeur de l'attribut `Secure` du cookie de session est automatiquement définie sur "True" si la connexion est HTTPS (quelle que soit la valeur de l'attribut `SameSite`). @@ -622,9 +622,9 @@ Dans certains cas, d'autres fonctions internes optimisées peuvent être appelé Deux options permettent de définir le mode de fonctionnement des connexions persistantes : - - **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de demandes par connexion permet d'éviter le server flooding, provoqué par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

+- **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de demandes par connexion permet d'éviter le server flooding, provoqué par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

La valeur par défaut (100) peut être augmentée ou diminuée en fonction des ressources de la machine hébergeant le Serveur Web 4D.

- - **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois cette période terminée, le serveur ferme la connexion.

+- **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois cette période terminée, le serveur ferme la connexion.

Si le navigateur Web envoie une requête après la fermeture de la connexion, une nouvelle connexion TCP est automatiquement créée. Cette opération est invisible pour l'utilisateur.

diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md index 22c7a8f9e814dd..aefd09100c335e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un projet 4D peut démarrer et piloter un serveur Web pour l'application princip Par exemple, si vous avez installé deux composants dans votre application principale, vous pouvez démarrer et contrôler jusqu'à trois serveurs Web indépendants à partir de votre application : - - un serveur web pour l'application hôte, - - un serveur web pour le composant n°1, - - un serveur web pour le composant n°2. +- un serveur web pour l'application hôte, +- un serveur web pour le composant n°1, +- un serveur web pour le composant n°2. En dehors de la mémoire, il n'y a pas de limite au nombre de composants et donc, de serveurs Web, pouvant être rattachés à un seul projet d'application 4D. @@ -19,9 +19,9 @@ Chaque serveur web 4D, y compris le serveur web de l'application principale, est Chaque serveur web (application hôte ou composant) peut être utilisé dans son propre contexte, notamment : - - les appels vers la méthode base `On Web Authentication` et `On Web Connection` - - le traitement des balises 4D et les appels de méthodes, - - sessions web et gestion du protocole TLS. +- les appels vers la méthode base `On Web Authentication` et `On Web Connection` +- le traitement des balises 4D et les appels de méthodes, +- sessions web et gestion du protocole TLS. Cela vous permet de développer des composants indépendants et des fonctionnalités qui accompagnent leurs propres interfaces Web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si l'application utilise des composants et que vous souhaitez appeler : - - le serveur Web de l'application hôte à partir d'un composant ou - - le serveur qui a reçu la requête (quel que soit le serveur) +- le serveur Web de l'application hôte à partir d'un composant ou +- le serveur qui a reçu la requête (quel que soit le serveur) vous pouvez également utiliser : @@ -94,8 +94,8 @@ Ces propriétés sont définies : 2. si elles ne sont pas utilisées, à l'aide de la commande `WEB SET OPTION` (applications hôtes uniquement), 3. si elles ne sont pas utilisées, dans les propriétés de l'application hôte ou du composant. - - Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. - - Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). +- Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. +- Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion* et *perfectForwardSecrecy* sont des propriétés en lecture seule qui ne peuvent pas être prédéfinies dans le paramètre objet `settings` pour la fonction [`start()`](API/WebServerClass.md#start). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md b/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md index 7f5b5c680bfea3..d9285ee439492b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ La commande **WP Insert break** ins Dans *targetObj*, passez : - - une plage, ou - - un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou - - un document 4D Write Pro +- une plage, ou +- un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou +- un document 4D Write Pro Dans *breakType*, passez l'une des constantes suivantes du thème *4D Write Pro Constants* pour définir le type de break à insérer : @@ -62,7 +62,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio | wk prepend | Integer | 1 | Insérer le contenu au début de la cible | | wk replace | Integer | 0 | Remplacer le contenu de la cible | - - Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : +- Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : | Constante | Type | Valeur | Commentaire | | --------------------- | ------- | ------ | ------------------------------------------------------------------------------- | @@ -71,7 +71,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio Si vous ne passez pas un paramètre *rangeUpdate*, par défaut, le contenu inséré est inclus dans la plage résultante. - - Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. +- Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md b/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md index f83b3a2c602bdd..46ec6f90585fa9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandThe **Form** command returns the object associated with the current form (instantiated from the *formData* parameter or the user class assigned in the Form editor).La commande **Form** renvoie l'objet associé au formulaire courant (instancié à partir du paramètre *formData* ou de la classe utilisateur attribuée dans l'éditeur de formulaire). 4D associe automatiquement un objet au formulaire courant dans les cas suivants : - - le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), - - le formulaire courant est un sous-formulaire, - - un formulaire table est actuellement affiché à l'écran. +- le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), +- le formulaire courant est un sous-formulaire, +- un formulaire table est actuellement affiché à l'écran. ### Commandes (DIALOG...) Si le formulaire courant est affiché ou chargé par un appel aux commandes [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** renvoie soit : - - l'objet *formData* passé en paramètre à cette commande, le cas échéant, - - ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, - - ou un objet vide. +- l'objet *formData* passé en paramètre à cette commande, le cas échéant, +- ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, +- ou un objet vide. ### Sous-formulaire Si le formulaire courant est un sous-formulaire, l'objet renvoyé dépend de la variable du conteneur parent : - - **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ +- **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ Dans le contexte d'un formulaire de saisie affiché à partir d'un formulaire de sortie (c'est-à-dire après un double-clic sur un enregistrement), l'objet retourné contient la propriété suivante : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. +- Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. Pour plus d'informations, veuillez vous référer à la section *Sous-formulaires en page*. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands/generate-uuid.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands/generate-uuid.md index 04cdda07fe40d7..92f6273caac017 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands/generate-uuid.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands/generate-uuid.md @@ -9,43 +9,43 @@ displayed_sidebar: docs -| Paramètres | Type | | Description | -| ---------- | ------- | --------------------------- | ----------------------------------------------------------------- | -| version | Integer | → | UUID version: 4 (default) or 7 | -| Résultat | Text | ← | New UUID as non-canonical text (32 characters) | +| Paramètres | Type | | Description | +| ---------- | ------- | --------------------------- | -------------------------------------------------------------------------------- | +| version | Integer | → | Version de l'UUID : 4 (par défaut) ou 7 | +| Résultat | Text | ← | Nouvel UUID sous forme de texte non canonique (32 caractères) |
Historique -| Release | Modifications | -| ------- | ------------------------------ | -| 20 R10 | Support of *version* parameter | +| Release | Modifications | +| ------- | -------------------------------------- | +| 20 R10 | Prise en charge du paramètre *version* |
## Description -The Generate UUID returns a new 32-character UUID identifier in non-canonical form. +La fonction Generate UUID renvoie un nouvel identifiant UUID de 32 caractères sous une forme non canonique. -An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). +Un UUID est un nombre de 16 octets (128 bits). Il contient 32 caractères hexadécimaux. Il peut être exprimé soit sous forme non canonique (série de 32 lettres \[A-F, a-f\] et/ou chiffres \[0-9\], par exemple 550e8400e29b41d4a716446655440000), soit sous forme canonique (groupes de 8,4,4,4,4,12, par exemple 550e8400-e29b-41d4-a716-446655440000). -You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: +Vous pouvez utiliser le paramètre facultatif *version* pour définir la **version de l'UUID** à générer. Les valeurs suivantes sont acceptées : -- **4** (default if omitted), for fully random UUIDs -- **7**, for random and timestamp UUIDs (chronological order matches lexical order). +- **4** (par défaut si omis), pour des UUID entièrement aléatoires +- **7**, pour des UUID aléatoires et horodatés (l'ordre chronologique correspond à l'ordre lexical). :::note -For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). +Pour plus d'informations sur les UUID version 7, veuillez lire [cet article de blog](https://blog.4d.com/sort-uuids-with-version-7). ::: -In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. +Dans 4D, les numéros UUID peuvent être stockés dans des champs (voir [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190)). Une [option des Propriétés 4D](../settings/database.md#auto-uuid-version) permet de générer des UUID version 7 dans les champs automatiques. ## Exemple -Generation of a UUID in a variable: +Génération d'un UUID dans une variable : ```4d  var MyUUID : Text diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md index 457e0da1d396c5..5b553fcd1c85d3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Si l'indice du nouvel élément est au-delà du dernier élément existant de la Vous pouvez passer tout nombre de valeurs de n'importe quel type pris en charge : - - nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. - - text - - boolean - - date - - heure (stockée en nombre de milliseconds - réel) - - Null - - Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. - - *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. +- nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. +- text +- boolean +- date +- heure (stockée en nombre de milliseconds - réel) +- Null +- Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. +- *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. :::note diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands/print-form.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands/print-form.md index c4c80a9153de6c..8e4b4910b6ac60 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands/print-form.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs Dans le paramètre *form*, vous pouvez passer soit : - - le nom d'un formulaire, - - le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou - - un objet contenant la description du formulaire à utiliser. +- le nom d'un formulaire, +- le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou +- un objet contenant la description du formulaire à utiliser. Comme **Print form** ne génère pas de saut de page après avoir imprimé un formulaire, elle vous permet de combiner facilement différents formulaires sur la même page. Ainsi, **Print form** est idéale pour effectuer des impressions complexes impliquant plusieurs tables et plusieurs formulaires. Pour forcer un saut de page entre les formulaires, utilisez la commande [PAGE BREAK](../commands-legacy/page-break.md). Pour reporter l'impression à la page suivante d'un formulaire dont la hauteur est supérieure à l'espace disponible, appelez la commande [CANCEL](../commands-legacy/cancel.md) avant la commande [PAGE BREAK](../commands-legacy/page-break.md). Trois syntaxes différentes peuvent être utilisées : - - **Impression du corps d'un formulaire** +- **Impression du corps d'un formulaire** Syntaxe : @@ -43,7 +43,7 @@ Syntaxe : Dans ce cas, **Print form** n'imprime que la zone de corps du formulaire (la zone comprise entre les marqueur d'en-tête et de corps). - - **Impression de zone de formulaire** +- **Impression de zone de formulaire** Syntaxe : @@ -79,7 +79,7 @@ Dans ce cas, la commande imprime la section désignée par *marker*. Passez dans | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impression de section** +- **Impression de section** Syntaxe : @@ -101,8 +101,8 @@ La valeur retournée par **Print form** indique la hauteur de la zone d’impres Les boîtes de dialogue standard d'impression n'apparaissent pas lorsque vous utilisez la commande **Print form**. L'état généré ne tient pas compte des paramètres d'impression définis en mode Développement pour le formulaire. Il y a deux manières de définir les paramètres d'impression avant d'effectuer une série d'appels à **Print form** : - - Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. - - Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. +- Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. +- Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. **Print form** construit chaque page à imprimer en mémoire. Chaque page est imprimée lorsque la page en mémoire est remplie ou lorsque vous appelez [PAGE BREAK](../commands-legacy/page-break.md). Pour vous assurer que la dernière page d'une impression exécutée par l'intermédiaire de **Print form** est effectivement imprimée, il faut terminer par la commande [PAGE BREAK](../commands-legacy/page-break.md) (sauf dans le cadre d'un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), voir note). Sinon, la dernière page, si elle n'est pas remplie, reste en mémoire et n'est pas imprimée. @@ -116,8 +116,8 @@ Cette commande permet d'imprimer des zones et des objets externes (par exemple, **4D Server:** Cette commande peut être exécutée sur 4D Server dans le cadre d'une procédure stockée. Dans ce contexte : - - Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). - - Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. +- Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). +- Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands/process-info.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands/process-info.md index e4d6424de97c3a..2151b672b79934 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands/process-info.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands/process-info.md @@ -44,7 +44,7 @@ L'objet retourné contient les propriétés suivantes : | type | Integer | Type de process en cours d'exécution. Valeurs possibles : voir ci-dessous | | visible | Boolean | Vrai si visible, faux sinon | - - Valeurs possibles pour "state" : +- Valeurs possibles pour "state" : | Constante | Valeur | | ------------------------- | ------ | @@ -57,7 +57,7 @@ L'objet retourné contient les propriétés suivantes : | Waiting for internal flag | 4 | | Paused | 5 | - - Valeurs possibles pour "type" : +- Valeurs possibles pour "type" : | Constante | Valeur | | ----------------------------- | ------ | diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands/session.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands/session.md index e6e0b844d3486f..4a89b74547e797 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands/session.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Voir également +## Voir également [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/client-server.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/client-server.md index 6087df4d15d96f..553b3374234af0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/client-server.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/client-server.md @@ -13,8 +13,8 @@ Les pages Client-serveur regroupent les propriétés liées à l'utilisation de Cette option vous permet d'indiquer si la base de données 4D Server apparaîtra ou non dans la liste des bases de données publiées. - - Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). - - Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. +- Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). +- Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. :::note @@ -49,11 +49,11 @@ Pour mettre à jour les autres machines clientes qui ne sont pas connectées, il 4D Server utilise trois ports TCP pour les communications entre les serveurs internes et les clients : - - **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). - - **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). - - **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ +- **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). +- **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). +- **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ Notez que dans le cas d'un accès via un routeur ou un pare-feu, les ports TCP doivent être ouverts explicitement. - - [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. +- [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. #### Authentification de l'utilisateur auprès du serveur de domaine @@ -67,9 +67,9 @@ Lorsque l'authentification unique (SSO) est activée (voir ci-dessus), vous deve Cette liste déroulante contient 3 options de couche réseau : **Historique**, **ServerNet** et **QUIC** (uniquement en mode projet), qui sont utilisées pour gérer les communications entre le serveur 4D et les machines 4D distantes (clients). - - **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). - - **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. +- **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). +- **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. **Notes** : @@ -109,9 +109,9 @@ Cette option permet d'activer le mode sécurisé pour les communications entre l Ce paramètre permet de définir globalement le mode de mise à jour de l'instance locale du dossier **Resources** sur les machines 4D connectées lorsque le dossier **Resources** de la base de données est modifié en cours de session (le dossier **Ressources** est automatiquement synchronisé sur la machine distante à chaque ouverture de session). Trois paramètres sont disponibles : - - **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. - - **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ +- **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. +- **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ Le dossier **Resources** centralise les fichiers personnalisés nécessaires à l'interface de la base de données (fichiers de traduction, images, etc.). Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. ## Page Configuration IP @@ -124,10 +124,10 @@ Cette table vous permet de définir des règles de contrôle d’accès à la ba Le fonctionnement de la table de configuration est le suivant : - - La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. - - La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. - - L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. - - Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : +- La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. +- La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. +- L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. +- Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : - Refuser 192.168.\* (refuser toutes adresses débutant par 192.168) - Autoriser \* (et autoriser les autres) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md index dfe730e6c2aeea..53417de66be248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -10,10 +10,10 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants.\ > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants. Pour les options de compatibilité plus anciennes, consultez la [page Compatibilité](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) sur **doc.4d.com**. - - **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. +- **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. **Note :** Cette option peut également être gérée par programmation en utilisant la commande `SET DATABASE PARAMETER`. - - **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : +- **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : - le caractère "/" initial n'est pas seulement le noeud racine - l'utilisation du caractère / comme premier caractère d'une expression XPath ne déclare pas un chemin absolu à partir du noeud racine - pas de noeud courant implicite - le noeud courant doit être intégré dans l'expression XPath @@ -21,12 +21,12 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa Même si ces fonctionnalités ne sont pas standard, vous pourriez vouloir continuer à les utiliser afin que votre code continue de fonctionner comme avant -- dans ce cas, il vous suffit de *désélectionner* l'option. On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). +- **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). - - **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). +- **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). - - **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file +- **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/database.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/database.md index b9ab2101358f08..4348479a6feb37 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/database.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/database.md @@ -31,7 +31,7 @@ This setting only applies to UUIDs generated afterwards. Already saved auto UUID :::note -For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). +Pour plus d'informations sur les UUID version 7, veuillez lire [cet article de blog](https://blog.4d.com/sort-uuids-with-version-7). ::: @@ -45,9 +45,9 @@ L’emplacement courant de ce dossier est affiché dans la zone “Actuel :”. Trois options d’emplacement sont proposées : - - \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. - - **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. - - **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. +- \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. +- **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. +- **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -55,7 +55,7 @@ Trois options d’emplacement sont proposées : > Si vous modifiez ces options, vous devez quitter et rouvrir la base afin que la modification soit prise en compte. A la réouverture, une réindexation automatique est effectuée sur tous les index de la base. - - **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. +- **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Lorsque l’option est cochée, le caractère @ est considéré comme un simple caractère s’il se trouve au milieu d’un mot. Cette possibilité est particulièrement utile pour les bases de données stockant des adresses e-mail (qui se présentent sous la forme “nom@fournisseur.xx”). Cette option influe sur les recherches, les tris et les comparaisons de chaînes de caractères, pour les données stockées dans les tables ou en mémoire (tableaux). Sont concernés les champs alpha (indexés ou non) et texte ainsi que les variables alpha et texte. @@ -66,19 +66,19 @@ Trois options d’emplacement sont proposées : - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - Pour des raisons de sécurité, seuls l’Administrateur et le Super_Utilisateur de la base peuvent modifier ce paramètre. - - **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. +- **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. Un projet 4D peut ainsi fonctionner dans une langue différente de celle du système. A l’ouverture d’un projet, le moteur de 4D détecte la langue utilisée par le fichier de données et la fournit au langage (interpréteur ou mode compilé). Les comparaisons de texte, qu’elles soient effectuées par le moteur de base de données ou par le langage, sont donc toujours effectuées dans la même langue. > Il est possible de modifier ce paramètre dans les Préférences de l'application (voir [Page General](../Preferences/general.md)). Dans ce cas, il s'applique à toutes les nouvelles bases créées par 4D. - - \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. +- \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. Cet algorithme est semblable à celui utilisé de façon standard par les logiciels de traitement de texte pour déterminer les limites d'une sélection en cas de double-clic dans un mot. Pour plus d’informations sur cet algorithme, reportez-vous à l'adresse `http://userguide.icu-project.org/boundaryanalysis`. Lorsque cette option est cochée, 4D utilise un algorithme simplifié. Dans cette configuration, tout caractère non alphanumérique (c'est-à-dire qui n'est ni une lettre ni un chiffre) est considéré comme séparateur de mot-clé. Ce paramétrage répond à des besoins spécifiques associés à certaines langues telles que le japonais. - - **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. +- **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. #### Prise en charge de Mecab (version japonaise) @@ -96,7 +96,7 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ### Paramètres du cache pour la base - - **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. +- **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. - **Mémoire à réserver pour le système et les autres applications** : partie de la mémoire RAM à réserver au Système et aux autres applications. Cette valeur peut être augmentée à des fins d’optimisation lorsque d’autres applications consommatrices de mémoire tournent sur le même poste que 4D. - **Mémoire disponible utilisée pour le cache** : Pourcentage de la mémoire restante allouée par défaut au cache.\ @@ -112,11 +112,11 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ![](../assets/en/settings/memory-maximum-size.png) - - **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). +- **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). La taille de mémoire cache que vous saisissez sera réservée pour la base 4D, quel que soit l’état des ressources de la machine. Ce paramétrage peut être utilisé dans certaines configurations spécifiques, ou lorsque la base est destinée à fonctionner sur des systèmes disparates en termes de mémoire. Dans la plupart des cas, le cache adaptatif est plus performant. - - **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. +- **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. 4D écrit les données placées dans le cache à intervalles fixes. Vous pouvez définir tout intervalle compris entre 1 seconde et 500 minutes. Par défaut, 4D stocke vos données toutes les 20 secondes. L’application écrit aussi vos données sur disque lorsque vous changez de mode ou quittez l’application. You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. Quand vous prévoyez de saisir beaucoup de données, il est souhaitable de fixer un intervalle court. En effet, en cas de coupure de courant, vous ne perdriez que les données saisies depuis la dernière écriture (si la base fonctionne sans fichier d’historique). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/interface.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/interface.md index d3b7351d3bf32d..191e92fc300c18 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/interface.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/interface.md @@ -23,9 +23,9 @@ La police et la taille de police par défaut dépendent de la plate-forme d'exé D'autres options permettent de configurer l'affichage de diverses fenêtres du mode Application. - - **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. +- **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. - - **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. +- **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. :::note @@ -33,9 +33,9 @@ Vous pouvez définir la [fréquence d'écriture du cache](database.md#memory-pag ::: - - **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. +- **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. - - **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : +- **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser au nivea Les palettes suivants sont disponibles : - - **Clair**: l'application utilisera le thème clair par défaut +- **Clair**: l'application utilisera le thème clair par défaut ![](../assets/en/settings/light-appearance.png) - - **Foncé** : l'application utilisera le thème foncé par défaut +- **Foncé** : l'application utilisera le thème foncé par défaut ![](../assets/en/settings/dark-appearance.png) - - **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) +- **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) > Les thèmes par défaut peuvent être gérés par du CSS. Pour plus d'informations, veuillez consulter la section [Media Queries](../FormEditor/createStylesheet.md#media-queries). La palette d'application principale sera appliquée aux formulaires par défaut. Toutefois, elle peut être remplacée : - - par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; - - en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". +- par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; +- en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". ## Raccourcis @@ -72,9 +72,9 @@ La zone Raccourcis clavier permet d'afficher et de modifier les raccourcis clavi Les raccourcis clavier par défaut sont les suivants : - - Acceptation de saisie : **Entrée** - - Annulation de saisie : **Echap** - - Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) +- Acceptation de saisie : **Entrée** +- Annulation de saisie : **Echap** +- Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) Pour modifier le raccourci d'une opération, cliquez sur le bouton **Modifier** correspondant. La boîte de dialogue suivante apparaît : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/security.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/security.md index 42455b206c0482..84cd29f3ec95e7 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/security.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/security.md @@ -11,7 +11,7 @@ Cette page regroupe les options relatives à la protection des accès et des don > Ces paramètres ne s'appliquent pas aux bases projets ouvertes en monoposte. - - **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. +- **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. A noter que : @@ -19,21 +19,21 @@ Cette page regroupe les options relatives à la protection des accès et des don - Le Super_Utilisateur et l'Administrateur ont toujours accès à l'environnement de développement et à l'Explorateur d'exécution, même s'ils ne font pas explicitement partie du groupe d'accès spécifié. Pour plus d'information sur les utilisateurs et les groupes d'utilisateurs, veuillez vous référer au chapitre [Utilisateurs et groupes](../Users/handling_users_groups.md). - - **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. +- **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. L’intérêt de cette option est de simplifier les accès multiples à la base tout en maintenant un système complet de contrôle des données. - Si vous avez associé un mot de passe à l’utilisateur par défaut, une boîte de dialogue apparaît à l’ouverture de la base, les utilisateurs doivent uniquement saisir un mot de passe. - Si vous n'avez pas associé de mot de passe à l'Utilisateur par défaut, la boîte de dialogue d'identification de l'utilisateur ne s'affichera pas.**Note:** Vous pouvez “forcer” l'affichage de la boîte de dialogue d'identification de l'utilisateur lorsque le mode “Utilisateur par défaut” est actif, par exemple pour vous connecter en tant qu'Administrateur ou Super_Utilisateur. Pour cela, ouvrez (ou connectez-vous à) la base de données tout en maintenant la touche **Majuscule** enfoncée. - - **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **Trier la liste des utilisateurs par ordre alphabétique** (option utilisable uniquement si la précédente est cochée) : Lorsque cette option est cochée, la liste des utilisateurs dans la boîte de dialogue de saisie des mots de passe est triée par ordre alphabétique. - - **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. +- **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. ## Options - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. A l'aide des options suivantes, vous pouvez supprimer complètement ou partiellement ce filtrage. - **Activé pour tous** (par défaut) : L'accès aux commandes, fonctions et méthodes projets est limité pour tous les utilisateurs, y compris au Super Utilisateur et à l'Administrateur. - **Désactivé pour le Super Utilisateur et l'Administrateur** : Cette option accorde, uniquement au Super Utilisateur et à l'Administrateur, un accès complet aux commandes et méthodes 4D. Elle peut être utilisée pour définir un mode d'accès illimité aux commandes et méthodes tout en gardant le contrôle des actions effectuées. En phase de développement, ce mode peut être utilisé pour tester librement toutes les formules, les états, etc. En cours d'exploitation, il peut être utilisé pour mettre en oeuvre des solutions sécurisées permettant un accès temporaire à toutes les commandes et méthodes. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Cette page regroupe les options relatives à la protection des accès et des don - **Désactivé pour tous** : Cette option désactive le contrôle dans les formules. Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsqu'elle est cochée, cette commande ne fait rien. - - **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). +- **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. Lorsque cette option est cochée : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/settings/web.md b/i18n/fr/docusaurus-plugin-content-docs/current/settings/web.md index 49c87f7bc72c0a..1366bcdb7ba6de 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/web.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/web.md @@ -78,9 +78,9 @@ Lorsque cette option est sélectionnée, le serveur Web ne fournit aucune prise Dans ce mode, vous pouvez configurer des paramètres de serveur Web supplémentaires : - - [Process Web simultanés maxi](#maximum-concurrent-web-processes) - - [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) - - [Utiliser des process préemptifs](#use-preemptive-processes) +- [Process Web simultanés maxi](#maximum-concurrent-web-processes) +- [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) +- [Utiliser des process préemptifs](#use-preemptive-processes) #### Anciennes sessions (sessions process uniques) @@ -162,9 +162,9 @@ Démarre ou arrête l'enregistrement des requêtes reçues par le serveur Web 4D Le menu de format du journal propose les options suivantes : - - **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. +- **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. - - **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ +- **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ Chaque champ est séparé par un espace et chaque ligne se termine par la séquence CR/LF (caractère 13, caractère 10). - hôte : adresse IP du client (ex. 192.100.100.10) @@ -174,9 +174,9 @@ Le menu de format du journal propose les options suivantes : > La date et heure sont locales au serveur. - - requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) - - statut : réponse donnée par le serveur. - - longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. +- requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) +- statut : réponse donnée par le serveur. +- longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. > **Note :** Pour des raisons de performances, les opération sont stockées dans une mémoire tampon par paquets de 1 Ko avant d'être écrites sur disque. Les opérations sont également écrites sur disque si aucune requête n'a été envoyée au bout de 5 secondes. > Les valeurs possibles de l'état sont les suivantes : @@ -190,16 +190,16 @@ Le menu de format du journal propose les options suivantes : > 500 : Erreur interne > Le format CLF ne peut pas être personnalisé. - - **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. +- **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. - Referer : contient l’URL de la page pointant vers le document demandé. - User-agent : contient le nom et la version du navigateur ou du logiciel client à l’origine de la requête. > Le format DLF ne peut pas être personnalisé. - - **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. +- **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. - - **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. +- **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. **Configurer les champs** Lorsque vous choisissez le format ELF (Extended Log Format) ou WLF (WebStar Log Format), la zone “Formatage du journal” affiche les champs disponibles pour le format. Vous devrez sélectionner chaque champ à inclure dans le journal. Pour cela, utilisez les flèches de commande ou procédez par glisser-déposer. @@ -238,14 +238,14 @@ Le tableau suivant répertorie les champs disponibles pour chaque format (par or Paramètres d’archivage automatique du journal des requêtes. D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. > En cas de sauvegarde périodique, si le serveur Web n’était pas lancé au moment théorique de la sauvegarde, 4D considère au lancement suivant que la sauvegarde a échoué et applique les paramétrages adéquats, définis dans les Propriétés. @@ -259,9 +259,9 @@ Pour plus d'informations sur la prise en charge des services Web dans 4D, veuill Cette zone affiche les options relatives à l’utilisation de 4D en tant que “serveur” de Web Services, c’est-à-dire publiant des méthodes projet sous forme de Web Services. - - **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. - - **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. - - **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. +- **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. +- **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. +- **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. > Conformément à la norme XML concernant les noms de balises, la chaîne de caractères utilisée ne doit pas contenir d’espaces ni débuter par un chiffre. En outre, pour éviter tout risque d’incompatibilité, il est recommandé de ne pas utiliser de caractères étendus (tels que des caractères accentués). @@ -269,7 +269,7 @@ Cette zone affiche les options relatives à l’utilisation de 4D en tant que Cette zone contient une option relative à l’utilisation de 4D en tant que “client” de Web Services, c’est-à-dire souscrivant à des services publiés sur le réseau. - - **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. +- **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. ## Fonctionnalités Web @@ -303,9 +303,9 @@ Ce bouton est uniquement disponible dans les projets ouverts avec l'application Le bouton déclenche la séquence de mise à niveau suivante : - - Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. - - La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). - - Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. +- Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. +- La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). +- Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. N'oubliez pas de redémarrer votre projet après avoir effectué cette mise à niveau. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md index b1b0365605edcc..9d1cb639f79189 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md @@ -160,8 +160,8 @@ Vous pouvez passer un ou plusieurs paramètres optionnels *param*, qui seront pa :::note Notes - - Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. - - Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. +- Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. +- Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/Document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/Document.md index e5c0997f07ca47..f026e9fde75c7c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/Document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/Document.md @@ -320,8 +320,8 @@ Cette propriété est en **lecture seule**. La propriété `.original` renvoie l'élément cible d'un fichier alias, d'un raccourci ou d'un lien symbolique. L'élément cible peut être : - - un objet File - - un objet Folder +- un objet File +- un objet Folder Pour les fichiers sans alias, la propriété retourne le même objet File que le fichier. @@ -585,8 +585,8 @@ La fonction `.getText()` retourne le con Optionnellement, vous pouvez indiquer le jeu de caractères à utiliser pour la lecture du contenu. Vous pouvez passer soit : - - dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), - - ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. +- dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), +- ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. > Pour consulter la liste des jeux de caractères pris en charge par 4D, veuillez vous reporter à la description de la commande `CONVERT FROM TEXT`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md index b7e2d6073fd621..ce7f23754c5200 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objet 4D.OutgoingMessage est [non partageable](../Concepts/shared.md). La propriété `.body` contient le body du message sortant. Les types de données suivants sont pris en charge dans la propriété `.body` : - - text - - blob - - object - - image +- text +- blob +- object +- image La propriété `.body` est en lecture-écriture. @@ -108,17 +108,17 @@ La fonction `.setBody()` dé Les types de données suivants sont pris en charge dans la propriété *body* : - - Text - - Blob - - Object - - Image +- Text +- Blob +- Object +- Image Lorsque cette fonction est utilisée, le header content-type est automatiquement défini en fonction du type de *body* : - - Content-Type:text/plain si le body est un texte - - Content-Type:application/octet-stream si le body est un Blob - - Content-Type:application/json si le body est un objet - - Content-Type:image/jpeg, image/gif... si le body est une image +- Content-Type:text/plain si le body est un texte +- Content-Type:application/octet-stream si le body est un Blob +- Content-Type:application/json si le body est un objet +- Content-Type:image/jpeg, image/gif... si le body est une image Si *body* n'est pas un type de valeur pris en charge, une erreur est renvoyée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md index 325787d945631f..098475b2abbeec 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propriété `.keepAlive` contient diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md index 4e72b1fa295c2c..7ac3c3c2823db9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Les objets de session sont retournés par la commande [`Session`](../commands/session.md). Ces objets fournissent au développeur une interface permettant de gérer la session utilisateur courante et d'exécuter des actions telles que le stockage de données contextuelles, le partage d'informations entre les process de la session, le lancement de process préemptifs liés à la session ou (uniquement pour le web) la gestion des [privilèges](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Types de sessions Les types de sessions suivants sont pris en charge par cette classe : @@ -38,11 +47,6 @@ La disponibilité des propriétés et des fonctions de l'objet `Session` dépend | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md index 3d92f3b48c546e..d16c4e85d76af2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md @@ -55,8 +55,8 @@ La fonction `.disableState()` d Cette fonction ne fait rien si : - - l'*état* n'est actuellement pas activé dans le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* n'est actuellement pas activé dans le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous [activez](#enablestate) ou désactivez plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. @@ -80,8 +80,8 @@ La fonction `.enableState()` act Cette fonction ne fait rien si : - - l'*état* a déjà été activé sur le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* a déjà été activé sur le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous activez ou [désactivez](#disablestate) plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md index 4448b28230ca79..9da5511bdf5b7a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md @@ -86,8 +86,8 @@ La fonction `4D.WebSocket.new()` crée e Dans *url*, indiquez l'URL à laquelle le serveur WebSocket répondra. Les modèles d'URL suivants peuvent être utilisés : - - `ws://host[:port]path[?query]` pour les connexions standard - - `wss://host[:port]path[?query]` pour les connexions TLS sécurisées +- `ws://host[:port]path[?query]` pour les connexions standard +- `wss://host[:port]path[?query]` pour les connexions TLS sécurisées Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur est générée (que vous pouvez intercepter à l'aide d'une méthode installée avec `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur e Dans *connectionHandler*, vous pouvez transmettre un objet contenant des fonctions de callback à appeler selon les événements de connexion, ainsi que le type de données et les en-têtes à gérer. - - Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. - - La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. +- Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. +- La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. | Propriété | Type | Description | | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La fonction `.terminate()` refer Dans *code*, vous pouvez passer un code d'état expliquant pourquoi la connexion est fermée (voir aussi [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)) : - - S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. - - Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. +- S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. +- Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. Dans *reason*, vous pouvez passer une chaîne de caractères décrivant la raison pour laquelle la connexion est fermée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md index aca94359426e7e..f9e929fbc81107 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Voir également [cet article de blog](https://blog.4d.com/new-built-in-websocket Pour créer et gérer votre serveur WebSocket dans 4D, vous devrez utiliser deux classes intégrées à 4D : - - cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, - - la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. +- cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, +- la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. De plus, vous devrez créer deux classes utilisateurs qui contiendront les fonctions de callback : - - une classe utilisateur pour gérer les connexions serveur, - - une classe utilisateur pour gérer les messages. +- une classe utilisateur pour gérer les connexions serveur, +- une classe utilisateur pour gérer les messages. Vous devez [créer le serveur WebSocket](#4dwebsocketservernew) dans un [worker](../Develop/processes.md#worker-processes) pour maintenir la connexion en vie. @@ -387,8 +387,8 @@ Par défaut, si aucune valeur *timeout* n'est définie, la fonction initialise l Si une valeur *timeout* est définie : - - lorsque le temps d'attente est atteint, détruit de force la socket. - - si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. +- lorsque le temps d'attente est atteint, détruit de force la socket. +- si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md index 3c407cc2d8f7ab..87bace3ccb1808 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md @@ -17,7 +17,7 @@ Par défaut, le serveur web `WebAdmin` ne démarre pas automatiquement. Il faut Vous pouvez configurer le server web `WebAdmin` pour qu'il se lance au démarrage de 4D ou 4D Server (avant l'ouverture d'un projet). - - Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. +- Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Cochez l'option **Lancer le serveur WebAdmin au démarrage** dans la boîte de d ![alt-text](../assets/en/Admin/waSettings.png) - - Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : +- Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Quand cette option est cochée, il est possible de se connecter au serveur `WebA **Notes :** - - Les connections HTTP autres que sur localhost ne sont jamais acceptées. - - Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. +- Les connections HTTP autres que sur localhost ne sont jamais acceptées. +- Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. #### Port HTTP @@ -94,11 +94,11 @@ Chemin du dossier qui contient les fichiers de certificat TLS. Par défaut, le c Statut ou format du fichier de logs des requêtes HTTP (HTTPDebugLog_*nn*.txt, stocké dans le dossier "Logs" de l'application. --*nn* représente le numéro du fichier). Les options suivantes sont disponibles : - - **Désactivé** (valeur par défaut) - - **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses - - **Sans les body** - activé sans les parts des body (la taille du body est indiquée) - - **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes - - **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses +- **Désactivé** (valeur par défaut) +- **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses +- **Sans les body** - activé sans les parts des body (la taille du body est indiquée) +- **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes +- **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses #### Clé d'accès @@ -108,9 +108,9 @@ La configuration d'une clé d'accès est obligatoire pour débloquer l'accès au Une clé d'accès est similaire à un mot de passe, mais sans login associé. - - Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. - - Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. - - Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. +- Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. +- Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. +- Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. #### Activer l'accès à Qodly Studio @@ -145,9 +145,9 @@ Voici un exemple : ## Authentification et Session - - Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. +- Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. - - Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. +- Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. Une fois l'accès autorisé, une [session web](WebServer/sessions.md) est créée avec les privilèges "WebAdmin" sur l'application 4D. Tant que la session courante a le privilège "WebAdmin", le composant `WebAdmin` sert les pages demandées dans les requêtes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md index afa6d06b767f25..67abbc73dc2080 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md @@ -5,12 +5,12 @@ title: Restitution 4D vous permet de récupérer l’intégralité des données d’une application en cas d’incident, quelles que soient ses causes. Deux catégories principales d’incidents peuvent se produire : - - L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : +- L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : - Si le cache était vide, l'application s’ouvre normalement. Toutes les modifications apportées à l'application ont été enregistrées. Ce cas ne nécessite aucune opération particulière. - Si le cache contenait des opérations, le fichier de données est intact mais il est nécessaire d’intégrer le fichier d’historique courant. - Si le cache était en cours d’écriture, le fichier de données est probablement endommagé. Il est nécessaire de restituer la dernière sauvegarde et d’intégrer le fichier d’historique courant. - - La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. +- La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. > 4D peut lancer automatiquement des procédures de récupération des applications après incident. Ces mécanismes sont gérés à l’aide de deux options accessibles dans la Page **Sauvegarde/Sauvegarde & et Restitution** de la fenêtre des Propriétés. Pour plus d'informations, reportez-vous au paragraphe [Restitution automatique](settings.md#automatic-restore-and-log-integration).\ > Si l'incident résulte d'une opération inappropriée effectuée sur les données (suppression d'un enregistrement par exemple), vous pouvez tenter de réparer le fichier de données à l'aide de la fonction "rollback" du fichier d'historique.\ diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md index 34d711987f2faa..b74890eeed329a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md @@ -5,9 +5,9 @@ title: Paramètres de sauvegarde Les paramètres de sauvegarde sont définis sur trois pages dans la [boîte de dialogue des Paramètres](../settings/overview.md). Vous pouvez définir : - - la périodicité des sauvegardes automatiques - - les fichiers à inclure dans chaque sauvegarde - - les fonctionnalités avancées permettant d'exécuter des tâches automatiques +- la périodicité des sauvegardes automatiques +- les fichiers à inclure dans chaque sauvegarde +- les fonctionnalités avancées permettant d'exécuter des tâches automatiques > Les propriétés définies dans cette boîte de dialogue sont écrits dans le fichier *Backup.4DSettings*, stocké dans le [dossier Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Les paramètres des sauvegardes périodiques sont définis dans la Page **Sauveg Les options regroupées dans cet onglet permettent de définir et de paramétrer des sauvegardes périodiques automatiques de l'application. Vous pouvez choisir un paramétrage standard rapide ou personnaliser entièrement la périodicité. Diverses options apparaissent en fonction de la valeur définie dans le menu **Sauvegarde automatique** : - - **Jamais** : la fonction de sauvegarde périodique est inactivée. - - **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. - - **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. - - **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : +- **Jamais** : la fonction de sauvegarde périodique est inactivée. +- **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. +- **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. +- **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : - **Toutes les N heure(s)** : permet de programmer des sauvegardes sur une base horaire. Vous pouvez saisir une valeur comprise entre 1 et 24. * **Tous les jours** : programme une sauvegarde automatique par jour. Saisissez par exemple 1 si vous souhaitez une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. * **Toutes les N semaine(s), jour à N** : permet de programmer des sauvegardes sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jour(s) de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. @@ -48,12 +48,12 @@ La Page Sauvegarde/Configuration des Propriétés permet de désigner les fichie Cette zone permet de désigner les fichiers et/ou dossiers à copier lors de la prochaine sauvegarde. - - **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : +- **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : - le fichier journal courant de l'application (le cas échéant), - le dossier `Settings` complet situé [à côté du fichier de données](../Project/architecture.md#settings-user-data) (le cas échéant), c'est-à-dire *les paramètres utilisateur pour les données*. - - **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. - - **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* - - **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. +- **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. +- **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* +- **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. - **Supprimer** : retire de la liste des fichiers joints l’élément sélectionné. - Gestion du fichier d'historique En cas de restitution, le dossier sera récupéré avec sa structure interne. Vous pouvez désigner tout dossier ou volume connecté au poste, à l’exception du dossier contenant les fichiers de l'application. - **Ajouter fichier...** : affiche une boîte de dialogue permettant de sélectionner un fichier à joindre à la sauvegarde. @@ -82,19 +82,19 @@ La modification des options de sauvegarde et de restauration est facultative. Le ### Paramètres généraux - - **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). +- **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). Si, par exemple, le nombre de jeux est fixé à 3, les trois premières sauvegardes créent successivement les archives MaBase-0001, MaBase-0002 et MaBase-0003. Lors de la quatrième sauvegarde, l’archive MaBase-0004 est créée alors que l’archive MaBase-0001 est supprimée. Par défaut, le mécanisme de suppression des jeux est activé et 4D conserve 3 jeux de sauvegarde. Pour ne pas activer le mécanisme, désélectionnez l’option. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. +- **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. +- **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. - - **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. +- **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. - Périodicité Elle revient à annuler la sauvegarde ayant échoué. Une erreur est générée. - **Réessayer dans N seconde(s), minute(s) ou heure(s)** : lorsque cette option est cochée, une nouvelle tentative de sauvegarde est effectuée à l’issue du délai défini. Ce mécanisme permet d’anticiper certaines circonstances bloquant la sauvegarde. Vous pouvez fixer un délai en secondes, minutes ou heures à l’aide du menu correspondant. Si la nouvelle tentative échoue également, une erreur est générée et l’échec est inscrit dans les zones de statut de la dernière sauvegarde et dans le Journal des sauvegardes. - **Annuler l’opération au bout de N tentatives** : ce paramètre permet de définir le nombre de fois que le module de sauvegarde réessaiera de lancer la sauvegarde en cas d’échec. Si, à l’issue du nombre d’essais défini, la sauvegarde n’a pas pu être effectuée, elle est annulée et l’erreur 1401 est générée (“Le nombre maximal de tentatives de sauvegarde est atteint, la sauvegarde automatique est temporairement désactivée”). Dans ce cas, aucune nouvelle sauvegarde automatique ne sera lancée tant que l’application n’aura pas été redémarrée ou qu’une sauvegarde manuelle n’aura été effectuée avec succès. @@ -106,15 +106,15 @@ La modification des options de sauvegarde et de restauration est facultative. Le Ces options s’appliquent aux fichiers de sauvegarde principaux et aux fichiers de sauvegarde de l’historique. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. Le menu **Taille du segment** est une combo box permettant de définir la taille en Mo de chaque segment de sauvegarde. Vous pouvez choisir une des tailles prédéfinies ou saisir une taille spécifique entre 0 et 2048. Si vous passez 0, aucune segmentation n’est effectuée (équivaut à la valeur **Aucune**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. +- **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. - **Aucun** : aucune compression n’est appliquée. La sauvegarde peut être sensiblement plus rapide mais les fichiers d’archives sont plus volumineux sur le disque. - **Normal** (par défaut) : cette option constitue un compromis vitesse de sauvegarde/taille des archives. - **Elevé** : le taux de compression maximal est appliqué aux archives. Les fichiers d’archives prennent le moins de place possible sur le disque mais la sauvegarde peut être sensiblement ralentie. - - **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). +- **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). - **Taux d’entrelacement** : l’entrelacement consiste à stocker les données dans des secteurs non contigus afin de limiter les risques en cas d’endommagement des secteurs. Plus le taux est élevé, plus la sécurité est élevée ; en contrepartie, le traitement des données consomme davantage de mémoire. - **Taux de redondance** : la redondance permet de sécuriser les données présentes dans un fichier en répétant plusieurs fois les mêmes informations. Plus le taux est élevé, plus le fichier est sécurisé, mais plus le stockage est lent et la taille du fichier importante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md index d589041c258de8..82e97a3608a5d2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md @@ -11,8 +11,8 @@ Le langage 4D prend en charge les opérateurs que vous connaissez peut-être dé Le langage 4D prend en charge les opérateurs **binaires** et **ternaires** : - - les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. - - les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). +- les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. +- les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). Les valeurs que les opérateurs affectent sont des opérandes. Dans l'expression `1 + 2`, le symbole + est un opérateur binaire et ses deux opérandes sont les valeurs 1 et 2. @@ -33,18 +33,18 @@ $col:=New collection //$col est initialisé avec une collection vide Les résultats des opérateurs dépendent des **types de données** auxquels ils sont appliqués. Ils sont décrits avec les types de données, dans les sections suivantes : - - [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) - - [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) - - [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) - - [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) - - [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) - - [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) - - [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) - - [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) - - [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) - - [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) - - [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) - - [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) +- [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) +- [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) +- [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) +- [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) +- [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) +- [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) +- [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) +- [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) +- [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) +- [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) +- [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) +- [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) ## Opérateurs d'affectation composés @@ -272,9 +272,9 @@ L'opérateur conditionnel ternaire vous permet d'écrire des expressions conditi Il prend trois opérandes dans l'ordre suivant : - - une condition suivie d'un point d'interrogation (?) - - une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) - - une expression à exécuter si la condition est [falsy](#truthy-and-falsy) +- une condition suivie d'un point d'interrogation (?) +- une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) +- une expression à exécuter si la condition est [falsy](#truthy-and-falsy) ### Syntaxe @@ -325,21 +325,21 @@ En plus d'un type, chaque valeur possède également une valeur booléenne inhé Les valeurs suivantes sont **falsy**: - - false - - Null - - undefined - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Chaînes vides - - [] - Collections vides - - {} - Objets vides +- false +- Null +- undefined +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Chaînes vides +- [] - Collections vides +- {} - Objets vides Toutes les autres valeurs sont considérées comme **truthy**, notamment : - - 0 - zéro numérique (Entier ou autre) +- 0 - zéro numérique (Entier ou autre) Dans 4D, l'évaluation à **truthy** et **falsy** reflète la **possibilité d'utilisation** d'une valeur, ce qui signifie qu'une valeur truthy existe et peut être traitée par le code sans générer d'erreurs ou de résultats inattendus. L'objectif est de fournir un moyen pratique de gérer les valeurs *undefined* et *null* dans les objets et les collections, de sorte qu'un nombre réduit d'instructions [If…Else](flow-control.md#ifelseend-if) soit nécessaire pour éviter les erreurs d'exécut diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md index e88a916f5bb4f2..a1b7c382575f99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md @@ -53,8 +53,8 @@ Cette syntaxe ne prend en charge que les déclarations de [variables locales et `varType` peut être : - - un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, - - une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. +- un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, +- une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. Si `varType` est omis, une variable de type **variant** est créée. @@ -86,7 +86,7 @@ L'ancienne syntaxe utilisant les commandes `C_XXX` est obsolète à partir de la ### Exemples - - Pour déclarer les variables locales et les variables process basiques : +- Pour déclarer les variables locales et les variables process basiques : ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //également équivalent à C_OBJECT($o) ``` - - Pour déclarer les variables objet de classe 4D : +- Pour déclarer les variables objet de classe 4D : ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Pour déclarer les variables objet de classe utilisateur : +- Pour déclarer les variables objet de classe utilisateur : ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Une variable locale, comme son nom l’indique, est locale à une méthode — c Vous pouvez choisir d'utiliser une variable locale pour : - - Eviter des conflits de noms avec les autres variables - - Utiliser temporairement des valeurs, - - Réduire le nombre de variables process +- Eviter des conflits de noms avec les autres variables +- Utiliser temporairement des valeurs, +- Réduire le nombre de variables process Le nom d’une variable locale commence toujours par le signe dollar ($) et peut contenir jusqu’à 31 autres caractères. Si vous saisissez un nom plus long, 4D le tronque pour le ramener à 31 caractères. @@ -224,9 +224,9 @@ En mode interprété, les variables sont gérées dynamiquement; elles sont cré Un process peut lire et écrire des variables process dans un autre process à l'aide des commandes `GET PROCESS VARIABLE` et `SET PROCESS VARIABLE`. Nous vous recommandons de n'utiliser ces commandes que dans le cadre des besoins décrits ci-dessous (qui sont les raisons pour lesquelles ces commandes ont été créées dans 4D) : - - Communication interprocess à des endroits particuliers de votre code - - Gestion du glisser-déposer interprocess - - En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur +- Communication interprocess à des endroits particuliers de votre code +- Gestion du glisser-déposer interprocess +- En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur Pour plus d'informations, consultez le chapitre **Process** et la description de ces commandes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md index 450585e371221c..94977872be4248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md @@ -33,13 +33,13 @@ Il peut arriver que la mémoire soit insuffisante pour créer une BLOB. Ou, lors Ce sont généralement les types d'erreurs les plus difficiles à trouver. À l'exception des erreurs de frappe, tous les types d'erreurs énumérés ci-dessus sont, dans une certaine mesure, couverts par l'expression "erreur de conception ou de logique". Utilisez le [débogueur](debugger.md) pour les détecter. Par exemple : - - Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. - - Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. +- Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. +- Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. Les erreurs de conception ou de logique comprennent également des situations telles que : - - Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. - - Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. +- Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. +- Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. Parfois, le morceau de code qui affiche l'erreur peut être différent du code qui est en fait à l'origine du problème. @@ -55,8 +55,8 @@ Pour trouver rapidement l'origine du problème, rouvrez la version interprétée La fenêtre d'erreur de syntaxe apparaît automatiquement lorsque l'exécution d'une méthode est interrompue. Cela peut se produire lorsque : - - une erreur empêche la poursuite de l'exécution du code - - la méthode produit une fausse assertion (voir la commande `ASSERT`) +- une erreur empêche la poursuite de l'exécution du code +- la méthode produit une fausse assertion (voir la commande `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ La zone de texte supérieure affiche un message décrivant l'erreur. La zone de La fenêtre d'erreur de syntaxe propose plusieurs options : - - **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. +- **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. - - **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. +- **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. - - **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. +- **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. :::tip @@ -76,14 +76,14 @@ Pour ignorer une erreur qui se répète (par exemple, dans les boucles), vous po ::: - - **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : +- **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : - Si une méthode formulaire ou méthode objet s'exécute en réponse à un événement, elle est arrêtée et vous revenez au formulaire. - Si la méthode est exécutée à partir de l'environnement de l'application, vous revenez à cet environnement. - - **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. +- **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. - - **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. +- **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. ## Débogueur diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md index bbb5877378151f..1b7faf45be6041 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Cet événement peut être utilisé pour filtrer la saisie de données dans les Lorsqu'il est utilisé, cet événement est généré après chaque modification apportée au contenu d'un objet saisissable, quelle que soit l'action qui a provoqué la modification, c'est-à-dire : - - Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; - - Déposer une valeur (action similaire à coller); - - Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. - - Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). +- Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; +- Déposer une valeur (action similaire à coller); +- Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. +- Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). Dans l'événement `On After Edit`, les données texte saisies sont retournées par la commande [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md index 33cd0dd5bc3ac9..547ac39b5ab982 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ L'événement de formulaire `On Begin Drag Over` peut être sélectionné pour t L'événement `On Begin Drag Over` est utile pour préparer l'action de glisser. Il peut être utilisé pour : - - Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). - - Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). - - Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. +- Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). +- Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). +- Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. - Pour indiquer que les actions de glisser sont acceptées, la méthode de l'objet source doit retourner 0 (zéro). - Pour indiquer que les actions de glisser sont refusées, la méthode de l'objet source doit retourner -1. - Si aucun résultat n'est retourné, 4D considère que les actions de glisser sont acceptées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md index 78486e986347fb..c4858cd18410e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md @@ -15,11 +15,11 @@ L'événement `On Clicked` est généré lorsque l'utilisateur clique sur un obj L'événement `On Clicked` se produit généralement une fois que le bouton de la souris est relâché. Cependant, il existe plusieurs exceptions : - - [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. - - [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. - - [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. - - [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée - - Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem +- [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. +- [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. +- [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. +- [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée +- Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem Dans le cas d'un événement `On Clicked`, vous pouvez tester le nombre de clics effectués par l'utilisateur à l'aide de la commande `Clickcount`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md index 51e4b7d4d42184..9bdac220339752 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un enregistrement est sur le point d'être affiché sous forme de liste affiché Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque enregistrement : +- Pour chaque enregistrement : - Pour chaque objet de la zone détaillée : - Méthode objet avec l'événement `On Display Detail` - Méthode formulaire avec l'événement `On Display Detail` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md index a6852001e87193..830756654af344 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over L'événement `On Drag Over` est envoyé à plusieurs reprises à l'objet de destination lorsque le pointeur de la souris est déplacé sur l'objet. Généralement, en réponse à cet événement : - - Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). - - En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. +- Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). +- En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. Pour **rejeter** le glisser, la méthode de l'objet de destination doit retourner -1. Lors d'un événement `On Drag Over`, 4D traite la méthode objet comme une fonction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md index 959a61907fb292..7b762fede644f4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md @@ -15,7 +15,7 @@ L'événement `On Header` est appelé lorsqu'un enregistrement est sur le point Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque objet de la zone d'en-tête : +- Pour chaque objet de la zone d'en-tête : - Méthode objet avec l'événement `On Header` - Méthode formulaire avec l'événement `On Header` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md index bad94509cacfcd..2c99b4f29b928c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Cet événement est généré lorsqu'un clic se produit sur l'en-tête d'une col Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) a été sélectionnée pour la list box, vous pouvez décider d'autoriser ou non un tri standard de la colonne en passant la valeur 0 ou -1 dans la variable `$0` : - - Si `$0` est égal à 0, un tri standard est effectué. - - Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. +- Si `$0` est égal à 0, un tri standard est effectué. +- Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) n'est pas sélectionnée pour la list box, la variable `$0` n'est pas utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md index 07c7cc5a3e58e0..bc7cb2ef2796ea 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md @@ -9,16 +9,16 @@ Les formulaires fournissent l'interface par laquelle les informations sont saisi Les formulaires peuvent également contenir d'autres formulaires grâce aux fonctionnalités suivantes : - - [objets de sous-formulaire](FormObjects/subform_overview.md) - - [formulaires hérités](./properties_FormProperties.md#inherited-form-name) +- [objets de sous-formulaire](FormObjects/subform_overview.md) +- [formulaires hérités](./properties_FormProperties.md#inherited-form-name) ## Création de formulaires Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suivants : - - **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. - - **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. - - **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : +- **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. +- **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. +- **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : ``` { @@ -70,9 +70,9 @@ Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suiv Il existe deux catégories de formulaires : - - **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. +- **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. - - **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. +- **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. En règle générale, vous sélectionnez la catégorie de formulaire lorsque vous créez le formulaire, mais vous pouvez la modifier par la suite. @@ -80,15 +80,15 @@ En règle générale, vous sélectionnez la catégorie de formulaire lorsque vou Chaque formulaire est composé d'au moins deux pages : - - une page 1 : une page principale, affichée par défaut - - une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. +- une page 1 : une page principale, affichée par défaut +- une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. Vous pouvez créer plusieurs pages pour un formulaire d'entrée. Si le nombre de champs ou de variables est supérieur au nombre maximal supporté sur un écran, vous pouvez créer des pages supplémentaires pour les afficher. Plusieurs pages vous permettent d'effectuer les opérations suivantes : - - Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. - - Organisez chaque sujet sur sa propre page. - - Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). - - Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. +- Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. +- Organisez chaque sujet sur sa propre page. +- Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). +- Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. Les pages multiples sont utiles uniquement pour les formulaires d'entrée. Elles ne sont pas destinées à être imprimées. Lorsqu'un formulaire de plusieurs pages est imprimé, seule la première page est imprimée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md index a8e027a858e3db..69f494bd4c96d0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md @@ -7,11 +7,11 @@ L'éditeur de formulaires 4D prend en charge les macros. Une macro est un ensemb Par exemple, si vous avez un rapport récurrent avec une mise en forme spécifique (par exemple, certains textes doivent apparaître en rouge et certains textes en vert), vous pouvez créer une macro pour définir automatiquement la couleur. Vous pouvez créer des macros pour l'éditeur de formulaires de 4D qui pourront : - - Créer et exécuter du code 4D - - Afficher les boîtes de dialogue - - Sélectionnez des objets de formulaire - - Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés - - Modifier les fichiers de projet (mettre à jour, supprimer) +- Créer et exécuter du code 4D +- Afficher les boîtes de dialogue +- Sélectionnez des objets de formulaire +- Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés +- Modifier les fichiers de projet (mettre à jour, supprimer) Le code des macros prend en charge les [class functions (fonctions de classe)](Concepts/classes.md) et les [propriétés d'objet de formulaire en JSON](FormObjects/properties_Reference.md) pour vous permettre de définir n'importe quelle fonctionnalité perso @@ -238,9 +238,9 @@ Par exemple, si des objets de la page courante et des groupes ont été modifié Lors de la manipulation de l'attribut `method` des objets de formulaire, vous pouvez définir la valeur de l'attribut de deux manières différentes dans les macros : - - En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). +- En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). - - En utilisant un objet avec la structure suivante : +- En utilisant un objet avec la structure suivante : | Propriété | Type | Description | | --------- | ---- | ------------------ | @@ -252,9 +252,9 @@ Lors de la manipulation de l'attribut `method` des objets de formulaire, vous po La propriété `$4dId` définit un ID unique pour chaque objet de la page courante. Cette clé est utilisée par le processeur de macros pour gérer les modifications dans `$result.currentPage` : - - si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. - - si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. - - si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. +- si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. +- si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. +- si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. #### Exemple @@ -297,8 +297,8 @@ La fonction `onError` est exécutée lorsque le processeur de macros rencontre u Lors de l'exécution d'une macro, si 4D rencontre une erreur qui empêche l'annulation de la macro, il n'exécute pas la macro. C'est le cas par exemple si l'exécution d'une macro se traduirait par : - - supprimer ou modifier un script dont le fichier est en lecture seule. - - créer deux objets avec le même ID interne. +- supprimer ou modifier un script dont le fichier est en lecture seule. +- créer deux objets avec le même ID interne. #### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md index d1ea471e38b245..b192585d543e57 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Vous pouvez utiliser des bibliothèques d'objets dans vos formulaires. Une bibli 4D propose deux types de bibliothèques d'objets : - - une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. - - des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. +- une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. +- des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. ## Utilisation de la bibliothèque d'objets standard @@ -21,10 +21,10 @@ La bibliothèque est affichée dans une fenêtre séparée : La fenêtre présente les caractéristiques principales suivantes : - - Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. - - You can filter the window contents by using the **Categories** menu: +- Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. +- You can filter the window contents by using the **Categories** menu: ![](../assets/en/FormEditor/library3.png) - - Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : +- Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : - faire un clic droit sur un objet et sélectionnez **Copier** dans le menu contextuel - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Une même bibliothèque d’objets ne peut être ouverte que par un seul projet Pour ouvrir une bibliothèque d’objets personnalisée, sélectionnez la commande **Ouvrir>Bibliothèque d’objets...** dans le menu **Fichier** ou la barre d’outils de 4D. Une boîte de dialogue standard d’ouverture de fichiers apparaît, vous permettant de désigner la bibliothèque d’objets à ouvrir. Vous pouvez sélectionner les types de fichier suivants : - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Les bibliothèques d’objets personnalisées sont des projets 4D classiques. Seules les parties suivantes d'un projet sont exposées lorsqu'il est ouvert en tant que bibliothèque : - - formulaires projet - - pages 1 des formulaires +- formulaires projet +- pages 1 des formulaires ### Construire une bibliothèque d’objets @@ -74,10 +74,10 @@ Les principales opérations sont accessibles via le menu contextuel ou le menu d ![](../assets/en/FormEditor/library5.png) - - **Couper** ou **Copier** vers le conteneur de données - - **Coller** un objet à partir du conteneur de données - - **Effacer** - supprime l'objet de la bibliothèque - - **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. +- **Couper** ou **Copier** vers le conteneur de données +- **Coller** un objet à partir du conteneur de données +- **Effacer** - supprime l'objet de la bibliothèque +- **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. Vous pouvez placer dans la bibliothèque des objets individuels (y compris des sous-formulaires) ou des ensembles d’objets. Chaque objet ou ensemble d’objets est regroupé en un seul élément : @@ -93,9 +93,9 @@ Le copier-coller ou le glisser-déposer de certains objets dans la bibliothèque Voici la liste des objets dépendants qui seront collés dans la bibliothèque en même temps que l’objet principal qui les utilise (le cas échéant) : - - Enumérations - - Formats/Filtres - - Images - - Messages d’aide (liés à un champ) - - Méthodes objet +- Enumérations +- Formats/Filtres +- Images +- Messages d’aide (liés à un champ) +- Méthodes objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md index 8aa56e015e88e3..35608377f7063e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Les options de taille dépendent de la valeur de l'option **Taille basée sur**. ## Taille basée sur - - **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. +- **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. Vous pouvez choisir cette option lorsque vous souhaitez utiliser des objets actifs placés dans une zone hors écran (c'est-à-dire en dehors du rectangle de délimitation de la fenêtre) avec une fenêtre de taille automatique. Grâce à cette option, la présence de ces objets ne modifiera pas la taille de la fenêtre. - - **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. +- **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. - - `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. +- `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. > For output forms, only the [**Hor margin**](#hor-margin) or [**Width**](#width) fields are available. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md index acf434fe291b19..cf683fda71fd71 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Vous créez et personnalisez les formulaires de votre application en manipulant Les formulaires 4D prennent en charge un grand nombre d'objets **actifs** et **statiques** intégrés : - - **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. - - **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. +- **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. +- **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. ## Gérer les objets de formulaire Vous pouvez ajouter des objets dans un formulaire de nombreuses manières : - - **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. +- **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. - - **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. +- **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. - - **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). +- **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). Exemple d'un objet bouton : ```json diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md index 91166fb527d796..db63beabb77e04 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md @@ -50,6 +50,6 @@ For security reasons, in [multi-style](./properties_Text.md#multi-style) input a Vous pouvez également représenter des expressions de champ et de variable dans vos formulaires à l'aide d'objets alternatifs, plus particulièrement : - - Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). - - Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). - - Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). +- Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). +- Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). +- Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md index 86b38f5ebf8f20..fef79c525aa2ca 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Le cas échéant, l'icône déployer/contractée est automatiquement affichée Le contenu d'un objet formulaire liste hiérarchique peut être initialisé de l'une des manières suivantes : - - Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. - - Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. +- Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. +- Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. Dans les deux cas, vous gérez une liste hiérarchique lors de l'exécution via sa référence *ListRef*, à l'aide des commandes de [liste hiérarchique](../commands/theme/Hierarchical_Lists.md) du langage 4D. @@ -34,9 +34,9 @@ mylist:=New list Chaque représentation de liste dispose de caractéristiques propres et partage des caractéristiques communes avec l’ensemble des représentations. Les caractéristiques propres à chaque représentation de liste sont les suivantes : - - La sélection, - - L’état déployé/contracté des éléments, - - La position du curseur de défilement. +- La sélection, +- L’état déployé/contracté des éléments, +- La position du curseur de défilement. The other characteristics (font, font size, style, entry control, color, list contents, icons, etc.) are common to all the representations and cannot be modified separately. Consequently, when you use commands based on the expanded/collapsed configuration or the current item, for example `Count list items` (when the final `*` parameter is not passed), it is important to be able to specify the representation to be used without any ambiguity. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Comme pour les autres commandes de gestion des propriété d’objets, il est possible d’utiliser le caractère “@” dans le paramètre `NomListe`. En principe, cette syntaxe permet de désigner un ensemble d’objets dans le formulaire. Toutefois, dans le contexte des commandes de liste hiérarchique, ce principe n’est pas applicable dans tous les cas. Cette syntaxe aura deux effets différents en fonction du type de commande : - - Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” +- Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : +- Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po Il est possible de modifier l’apparence d’une liste hiérarchique dans un formulaire à l’aide de plusieurs commandes 4D génériques. Vous devez passer à ces commandes soit le nom d’objet de la liste hiérarchique (en utilisant le paramètre \*), soit son nom de variable (contenant la valeur RefListe) : - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Rappel : A l'exception de la commande `OBJECT SET SCROLL POSITION`, ces commandes modifient toutes les représentations d'une même liste, même si vous désignez une liste via son nom d'objet. @@ -107,8 +107,8 @@ Ce principe est appliqué quel que soit l’ordre d’appel des commandes. Si un Vous pouvez généralement travailler de deux manières avec le contenu des listes hiérarchiques : par position ou par référence. - - Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. - - Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. +- Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. +- Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. ### Exploiter les numéros de référence des éléments (réfElément) @@ -149,9 +149,9 @@ En pratique, vous devez vous préoccuper des numéros de référence d'élément Vous pouvez choisir si les éléments de la liste hiérarchique peuvent être modifiés par l'utilisateur à l'aide du raccourci **Alt + clic** (Windows)/ **Option + clic** (macOS), ou en effectuant un clic long sur le texte de l'élément. - - Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). +- Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). - - En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md index 7fde4eb6cbc93b..f2cae35c1488c9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md @@ -25,7 +25,7 @@ Indique si l’utilisateur peut supprimer des sous-enregistrements dans un sous- Cette option permet de désigner un formulaire détaillé à utiliser dans un sous-formulaire. Il peut être : - - un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ @@ -33,7 +33,7 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so > Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). - - le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. +- le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. #### Grammaire JSON @@ -51,8 +51,8 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulaire de liste. Les options suivantes sont disponibles : - - Ne rien faire : ignore le double-clic. - - Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. +- Ne rien faire : ignore le double-clic. +- Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. #### Grammaire JSON @@ -76,9 +76,9 @@ Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulair Définit l'action à réaliser lorsqu'un utilisateur double-clique sur une ligne dans un sous-formulaire liste. Les options disponibles sont : - - **Do nothing** (default): Double-clicking a row does not trigger any automatic action. - - **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. - - **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. +- **Do nothing** (default): Double-clicking a row does not trigger any automatic action. +- **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. +- **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. Regardless of the action selected/chosen, the `On Double clicked` form event is generated. @@ -156,8 +156,8 @@ Spécifie la table à laquelle appartient le sous-formulaire Liste (le cas éch Désigne l'option permettant aux utilisateurs de sélectionner des lignes : - - **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. - - **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ +- **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. +- **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ @@ -165,7 +165,7 @@ Désigne l'option permettant aux utilisateurs de sélectionner des lignes : A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ The Up and Down arrow keys select the previous/next row in the list. Les autres touches de navigation font défiler la liste. The `On Selection Change` form event is generated every time the current row is changed. - - **Multiple**: Several rows can be selected simultaneously in this mode. +- **Multiple**: Several rows can be selected simultaneously in this mode. - Les sous-enregistrements sélectionnés sont retournés par la commande `GET HIGHLIGHTED RECORDS`. - Cliquer sur l'enregistrement permettra de le sélectionner, mais ne modifiera pas l'enregistrement courant. - Si vous pressez **Ctrl+clic** (Windows) ou **Commande+clic** (macOS) sur un enregistrement, cela fera basculer son état (entre sélectionné ou non). Les touches fléchées Haut et Bas sélectionnent l'enregistrement précédent/suivant dans la liste. Les autres touches de navigation font défiler la liste. L'événement formulaire `On Selection Change` est généré chaque fois que l'enregistrement sélectionné est modifié. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md index 522f4bb609875e..3a8c52a17e060c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Les formes sont des [objets statiques](formObjects_overview.md#active-and-static Les formes 4D prennent en charge les formes basiques suivantes : - - rectangles - - lignes - - ovales +- rectangles +- lignes +- ovales ## Rectangle diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md index 455819ccb29fb5..63b61e272c7a0a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md @@ -11,10 +11,10 @@ L’utilisation type du séparateur est le formulaire de sortie dans lequel les Les caractéristiques générales des séparateurs sont les suivantes : - - Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. - - Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. - - Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. - - Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. +- Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. +- Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. +- Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. +- Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. Une fois inséré, un séparateur se présente sous la forme d’un trait. Vous pouvez modifier son [style de bordure](properties_BackgroundAndBorder.md#border-line-style) afin d’obtenir un trait plus ou moins épais, ou [modifier sa couleur](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Vous pouvez associer une méthode objet à un séparateur. Cette méthode sera a Une [variable](properties_Object.md#variable-or-expression) de type *Entier long* est associée à chaque objet séparateur. Cette variable peut être utilisée dans vos méthodes objet et/ou formulaire. Elle prend pour valeur le déplacement courant, en pixels, du séparateur. - - Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, - - Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, - - Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. +- Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, +- Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, +- Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. Vous pouvez également déplacer le séparateur par programmation : il suffit de modifier la valeur de la variable associée. Imaginons par exemple qu’un séparateur vertical soit associé à la variable `sépara1`. Si vous écrivez `sépara1:=-10`, le séparateur sera déplacé de 10 pixels vers la gauche — comme si l’utilisateur l’avait fait manuellement. Le déplacement s’effectue au terme de l’exécution de la méthode objet ou formulaire contenant l’instruction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md index b69cbae04d9fe3..2ca2b0558845bc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md @@ -13,11 +13,11 @@ La variable associée à l’objet peut être affectée à une zone saisissable Un stepper peut être directement associé à une variable numérique, heure ou date. - - Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : +- Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : - [minimum](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. +- Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. > Pour que le stepper fonctionne avec une variable heure ou date, il est impératif de définir son type dans le formulaire ET de le [déclarer explicitement](../Concepts/variables.md#declaring-variables) comme `Time` ou Date\`. @@ -29,8 +29,8 @@ Pour plus d'informations, veuillez vous reporter à la section [Utiliser des ind ## Voir également - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md index 211a36f4fe1939..abd9d336f929c2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un sous-formulaire est un formulaire inclus dans un autre formulaire. Afin de bien définir les notions mises en oeuvre avec les sous-formulaires, voici quelques définitions relatives aux termes employés : - - **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. - - **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). - - **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. - - **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. - - **Formulaire liste écran** : instance de sous-formulaire en liste. - - **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. +- **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. +- **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). +- **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. +- **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. +- **Formulaire liste écran** : instance de sous-formulaire en liste. +- **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. ## Sous-formulaires en liste @@ -43,8 +43,8 @@ You can bind [a variable or an expression](properties_Object.md#variable-or-expr By default, 4D creates a variable or expression of [object type](properties_Object.md#expression-type) for a subform container, which allows you to share values in the context of the subform using the `Form` command. However, you can use a variable or expression of any scalar type (time, integer, etc.) especially if you only need to share a single value: - - Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. - - Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. +- Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. +- Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. ### Synchronisation du formulaire parent et du sous-formulaire (valeur unique) @@ -58,8 +58,8 @@ Dans le formulaire parent, les deux objets (zone de saisie et conteneur de sous- To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. - - If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. +- If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. +- If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. La valeur texte doit être formatée "hh:mm:ss". @@ -88,15 +88,15 @@ It updates the value of `Form.clockValue` in the subform: L’événement formulaire [Sur modif variable liée](../Events/onBoundVariableChange.md) est généré : - - dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée - - si le sous-formulaire appartient à la page formulaire courante ou à la page 0. +- dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée +- si le sous-formulaire appartient à la page formulaire courante ou à la page 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). La modification de la variable ou de l'expression liée déclenche des événements formulaire qui vous permettent de synchroniser les valeurs du formulaire parent et du sous-formulaire : - - Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. - - Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. +- Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. +- Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. #### Mise à jour du contenu d'un formulaire parent @@ -170,8 +170,8 @@ La communication entre le formulaire parent et les instances du sous-formulaire Pour répondre à ces besoins, 4D propose les mécanismes suivants : - - Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` - - Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` +- Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` +- Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` > La commande `GOTO OBJECT` peut rechercher l’objet de destination dans le formulaire parent même si elle exécutée depuis un sous-formulaire. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md index 0ec07cb47cd10e..ffdb38e99ad775 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md @@ -42,9 +42,9 @@ Sous macOS, les onglets peuvent être orientés, en plus de la position standard Pour fournir les étiquettes d'un onglet, vous pouvez utiliser : - - un objet - - une liste déroulante - - un tableau +- un objet +- une liste déroulante +- un tableau ### Utiliser un objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md index 2f4e9c9a419512..fe63997661a170 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md @@ -33,9 +33,9 @@ Une fois qu’un texte a été orienté, il reste possible de modifier sa taille ![](../assets/en/FormObjects/staticText2.png) - - Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; - - Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; - - Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. +- Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; +- Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; +- Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md index 3a3b60d2ce9b35..07f7a4e7f217e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md @@ -14,9 +14,9 @@ Chaque opération élémentaire enregistrée dans le fichier d’historique appa Les informations affichées permettent d’identifier la source et le contexte de chaque opération : - - **Opération** : numéro de séquence de l’opération dans le fichier d’historique. +- **Opération** : numéro de séquence de l’opération dans le fichier d’historique. - - **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : +- **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : - Ouverture du fichier de données : ouverture d’un fichier de données. - Fermeture du fichier de données : fermeture du fichier de données ouvert. - Création d’un contexte : création d’un process définissant un contexte d’exécution. @@ -30,26 +30,26 @@ Les informations affichées permettent d’identifier la source et le contexte d - Annulation de transaction : transaction annulée. - Contexte de mise à jour : modification des données supplémentaires (ex : un appel à `CHANGE CURRENT USER` ou `SET USER ALIAS`). - - **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. +- **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. - - **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. +- **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. - - **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. +- **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. - - **Taille** : taille (en octets) des données traitées par l’opération. +- **Taille** : taille (en octets) des données traitées par l’opération. - - **Date et Heure** : date et heure à laquelle l’opération a été effectuée. +- **Date et Heure** : date et heure à laquelle l’opération a été effectuée. - - **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. +- **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. - - **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. +- **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. - - **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ +- **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ ***Note :** Si la base de données est chiffrée et si aucune clé de données valide correspondant au fichier d'historique ouvert n'a été fournie, les valeurs chiffrées ne sont pas affichées dans cette colonne.* - - **Enregistrements** : numéro de l’enregistrement. +- **Enregistrements** : numéro de l’enregistrement. Cliquez sur **Analyser** pour mettre à jour le contenu du fichier d'historique courant de l'application sélectionnée (nommé par défaut dataname.journal). Le bouton Parcourir peut être utilisé pour sélectionner et ouvrir un autre fichier journal pour l'application. Le bouton **Exporter...** peut être utilisé pour exporter le contenu du fichier en tant que texte. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md index 0ddaaae0171a58..f4ff5d4178d563 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md @@ -51,13 +51,13 @@ Lorsque vous cliquez sur le bouton **Réparer**, 4D effectue une analyse complè La zone "Enregistrements trouvés dans le fichier de données" comporte deux tableaux synthétisant les informations issues de l’analyse du fichier de données. - - Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : +- Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : - La colonne **Ordre** indique l’ordre de récupération des groupes d’enregistrements. - La colonne **Nombre** indique le nombre d'enregistrements contenus dans la table. - Si tous les enregistrements et toutes les tables ont été attribués, seule la zone principale est affichée. Les noms des tables attribuées automatiquement sont affichés en caractères verts. Les groupes qui n'ont pas encore été attribués, c'est-à-dire, les tables qui n'ont pas pu être associées à des enregistrements sont affichées en caractères rouges. - Voir le compte rendu Par défaut, l’option est cochée pour tous les groupes avec les enregistrements qui peuvent être associés à une table. - - Le deuxième tableau liste les tables du fichier de structure. +- Le deuxième tableau liste les tables du fichier de structure. ### Attribution manuelle @@ -74,7 +74,7 @@ Le bouton **Ignorer enregistrements** permet de supprimer l’association effect Une fois la réparation terminée, 4D génère un fichier de compte-rendu dans le dossier Logs du projet. Ce fichier liste l’ensemble des opérations qui ont été menées. Il est créé au format xml et est nommé : *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" où : - - *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", - - *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". +- *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", +- *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". Lorsque vous cliquez sur le bouton **Voir le compte rendu**, 4D affiche le fichier de compte-rendu le plus récent dans le navigateur par défaut de l’ordinateur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md index b27f7547434bf5..948efad95aca75 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md @@ -11,8 +11,8 @@ La propriété **Title** contient le libellé d'un menu ou d'une ligne de menu, Dans l'éditeur de menus, vous pouvez saisir directement le libellé "en dur". Vous pouvez également saisir une référence pour une variable ou un élément XLIFF, ce qui facilitera la mise à jour et la traduction des applications. Vous pouvez utiliser types de références suivants : - - Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. - - Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. +- Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. +- Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. En utilisant le langage 4D, vous définissez la propriété Title à l'aide du paramètre *itemText* des commandes `APPEND MENU ITEM`, `INSERT MENU ITEM`, et `SET MENU ITEM`. @@ -53,8 +53,8 @@ Vous choisissez d’associer une action standard ou une méthode projet à la co Pour associer une méthode projet et/ou une action standard à une commande de menu sélectionnée dans l'éditeur de menu : - - **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. - - **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. +- **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. +- **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. **Note macOS :** Sous macOS, les commandes de menus créés associées à l'action *Quitter* sont automatiquement placées dans le menu de l’application, conformément aux normes d’interface de cette plate-forme. A l'aide du langage 4D, vous pouvez associer une méthode projet via la commande `SET MENU ITEM METHOD` et une action standard via la commande `SET MENU ITEM PROPERTY`. @@ -101,13 +101,13 @@ Vous pouvez affecter des raccourcis clavier à toute commande de menu. Lorsqu’ Vous pouvez également ajouter les touches **Majuscule** ainsi que **Alt** (Windows) ou **Option** (macOS) au raccourci clavier associé à une commande. Cette possibilité multiplie le nombre de raccourcis clavier utilisables dans les barres de menus. Les raccourcis clavier définis peuvent donc être de différents types : - - Sous Windows : +- Sous Windows : - Ctrl+lettre - Ctrl+Maj+lettre - Ctrl+Alt+lettre - Ctrl+Maj+Alt+lettre - - Sous macOS : +- Sous macOS : - Commande+lettre - Commande+Maj+lettre - Commande+Option+lettre diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md index b190e770e48b30..7a0d3436096157 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md @@ -9,27 +9,27 @@ Lisez [**Les nouveautés de 4D 20 R10**](https://blog.4d.com/fe-whats-new-in-4d- #### Points forts - - Handling of [ORDA events on data](../ORDA/orda-events.md). - - Nouvelle option `connectionTimeout` dans le paramètre [`options`](../API/TCPConnectionClass.md#options-parameter) de la fonction [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Langage 4D: +- Handling of [ORDA events on data](../ORDA/orda-events.md). +- Nouvelle option `connectionTimeout` dans le paramètre [`options`](../API/TCPConnectionClass.md#options-parameter) de la fonction [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Langage 4D: - Pour des raisons de cohérence, les commandes [`Create entity selection`](../commands/create-entity-selection.md) et [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) ont été déplacées du thème ["4D Environnement"](../commands/theme/4D_Environment.md) vers le thème ["Sélections"](../commands/theme/Selection.md). - Nouvelles commandes [`OBJET SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) et [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) pour assigner et lire les objets `Formula` comme sources de données pour les objets de formulaire. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) et [`LISTBOX Get property`](../commands/listbox-get-property.md) prennent en charge trois nouvelles constantes : `lk current item`, `lk current item position`, et `lk selected items expression`. - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### Changements de comportement - - Sous Windows, les polices d'imprimante courantes destinées uniquement à l'impression (c'est-à-dire non utilisables à l'écran) ne sont plus chargées par 4D au démarrage. - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- Sous Windows, les polices d'imprimante courantes destinées uniquement à l'impression (c'est-à-dire non utilisables à l'écran) ne sont plus chargées par 4D au démarrage. +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -37,20 +37,20 @@ Lisez [**Les nouveautés de 4D 20 R9**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) est désormais obsolète et sera supprimée dans la prochaine version. - - Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). - - L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). - - Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. - - Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. - - Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). - - Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. - - Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. - - Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. - - 4D Write Pro Interface : nouvelle [IA intégrée](../WritePro/writeprointerface.md#integrated-ai) pour interagir avec **chatGTP** depuis vos documents 4D Write Pro. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. +- La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) est désormais obsolète et sera supprimée dans la prochaine version. +- Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). +- L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). +- Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. +- Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. +- Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). +- Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. +- Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. +- Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. +- 4D Write Pro Interface : nouvelle [IA intégrée](../WritePro/writeprointerface.md#integrated-ai) pour interagir avec **chatGTP** depuis vos documents 4D Write Pro. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. ## 4D 20 R8 @@ -58,29 +58,29 @@ Lisez [**Les nouveautés de 4D 20 R8**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). - - Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). - - Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. - - [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. - - [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. - - Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#evaluation-application) dans la boîte de dialogue du Générateur d'applications. - - Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. - - Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) pour la journalisation détaillée des événements TCP. - - Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. - - 4D Write Pro : +- Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). +- Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). +- Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. +- [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. +- [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. +- Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#evaluation-application) dans la boîte de dialogue du Générateur d'applications. +- Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. +- Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) pour la journalisation détaillée des événements TCP. +- Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. +- 4D Write Pro : - Les commandes suivantes acceptent maintenant des paramètres tels que des objets ou des collections : [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get Attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), et [WP Insert picture] (../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), et [WP Insert break](../WritePro/commands/wp-insert-break.md), sont maintenant des fonctions qui retournent des plages. - Nouvelles expressions liées aux attributs de documents : [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) et [This.pageIndex](../WritePro/managing-formulas.md). - - Langage 4D: +- Langage 4D: - Commande modifiée : [`FORM EDIT`](../commands/form-edit.md) - Les fonctions [`.sign()`](../API/CryptoKeyClass.md#sign) et [`.verify()`](../API/CryptoKeyClass.md#verify) de la [classe 4D.CryptoKey](../API/CryptoKeyClass.md) prennent en charge des Blobs dans le paramètre *message*. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. #### Changements de comportement - - Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. - - En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. +- Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. +- En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. ## 4D 20 R7 @@ -88,30 +88,30 @@ Lisez [**Les nouveautés de 4D 20 R7**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). - - Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. - - Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. - - Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. - - Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). - - Langage 4D: +- Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). +- Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. +- Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. +- Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. +- Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). +- Langage 4D: - Nouvelles commandes : [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Commandes modifiées : [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro : +- 4D Write Pro : - Nouvelle commande : [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Commandes modifiées : [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. #### Changements de comportement - - Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. - - La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. - - L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. +- Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. +- La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. +- L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -119,25 +119,25 @@ Lisez [**Les nouveautés de 4D 20 R6**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). - - Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). - - Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). - - Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. - - Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. - - Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. - - Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. - - Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. - - Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). - - Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). - - Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. - - Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. +- Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). +- Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). +- Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). +- Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. +- Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. +- Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. +- Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. +- Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. +- Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). +- Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). +- Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. +- Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. #### Changements de comportement - - Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). - - L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). +- Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). +- L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). ## 4D 20 R5 @@ -145,21 +145,21 @@ Lisez [**Les nouveautés de 4D 20 R5**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. - - Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). - - Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). - - Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nouveau paramètre REST [$format](../REST/$format.md). - - L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. +- Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. +- Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). +- Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). +- Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nouveau paramètre REST [$format](../REST/$format.md). +- L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. #### Changements de comportement - - Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). - - Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). +- Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). +- Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). ## 4D 20 R4 @@ -167,24 +167,24 @@ Lisez [**Les nouveautés de 4D 20 R4**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. - - Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). - - Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. - - Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). - - Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) - - Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. - - Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). - - Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). - - Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. +- Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. +- Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). +- Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. +- Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). +- Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) +- Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. +- Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). +- Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). +- Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. #### Changements de comportement - - L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. - - La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). - - Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. - - Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). +- L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. +- La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). +- Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. +- Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -192,21 +192,21 @@ Lisez [**Les nouveautés de 4D 20 R3**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). - - Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). - - Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) - - Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. +- Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). +- Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). +- Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) +- Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. #### Changements de comportement - - Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). - - 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. +- Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). +- 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. ## 4D 20 R2 @@ -220,15 +220,15 @@ Si vos applications 4D utilisent des connexions TLS, il est recommandé de mettr #### Points forts - - Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. - - Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. - - 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. - - 4D Write Pro Interface : Nouveau [Table Wizard](../WritePro/writeprointerface.md). - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. +- Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. +- Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. +- 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. +- 4D Write Pro Interface : Nouveau [Table Wizard](../WritePro/writeprointerface.md). +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. #### Changements de comportement - - **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. +- **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. ## 4D 20.x LTS diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md index 48c74a65b4b864..9b0733a2694544 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Pour activer le suivi des changements de données, la structure de l'application De plus, pour assurer la bonne marche de la fonctionnalité, les conditions suivantes sont requises : - - Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. - - Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : +- Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. +- Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : | Champ | Type | Description | | ------------------------------------------------------- | --------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Pour activer le suivi des changements de données : 4D effectue alors les modifications suivantes : - - Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). - - Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. +- Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). +- Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. Pour désactiver le suivi des changements de données : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md index eaec1aa2c56823..66bd65e1fc9a42 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md index 7e38656d222ca3..87dfd77783f99b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La session web créée sur le datastore distant est identifiée à l'aide d'un I Le `localID` est local à la machine qui se connecte au datastore distant, ce qui signifie que : - - Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. - - Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. - - Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. +- Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. +- Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. +- Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. Ces principes sont illustrés dans les graphiques suivants : @@ -29,9 +29,9 @@ Ces principes sont illustrés dans les graphiques suivants : Les process qui gèrent les sessions d'accès aux datastore apparaissent dans la fenêtre d'administration de 4D Server : - - nom : "REST Handler : \" - - type : type Worker Server HTTP - - session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. +- nom : "REST Handler : \" +- type : type Worker Server HTTP +- session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. Dans l'exemple suivant, deux process sont en cours d'exécution pour la même session : @@ -47,11 +47,11 @@ Si une demande est envoyée au datastore distant après la fermeture de la sessi Les fonctionnalités ORDA relatives au verrouillage d'entité et aux transactions sont gérées au niveau du process dans les datastore distants, tout comme en mode client/serveur ORDA : - - Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. - - Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. - - 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`). +- Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. +- Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. +- 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`). Si une entité d'un datastore distant est verrouillée par une transaction dans un process, les autres process ne peuvent pas la mettre à jour, même si ces process partagent la même session. - - Les verrous sur les entités sont supprimés et les transactions sont annulées : +- Les verrous sur les entités sont supprimés et les transactions sont annulées : - lorsque le process est tué. - quand la session est fermée sur le serveur - lorsque la session est arrêtée à partir de la fenêtre d’administration du serveur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md index b199ec37d80b4c..b24e860f1804e9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md @@ -11,12 +11,12 @@ Cette page regroupe diverses options permettant de paramétrer le fonctionnement Cette option permet de configurer l’affichage proposé par défaut par 4D au démarrage, lorsque l’utilisateur lance uniquement l’application. - - **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. - - **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. - - **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. +- **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. +- **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. +- **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. > To force the display of the opening dialog box when this option is selected, hold down the **Alt** (Windows) or **Option** (macOS) key while launching the project. - - **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. - - **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. +- **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. +- **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. > > > **4D Server**: The 4D Server application ignores this option. Dans cet environnement, le mode **Ne rien faire** est toujours utilisé. @@ -30,8 +30,8 @@ Depuis macOS Sierra, les applications Mac bénéficient d'onglets automatiques f Vous pouvez bénéficier de cette fonctionnalité dans les environnements de 4D suivants (versions 64 bits uniquement) : - - Fenêtres de l'éditeur de code - - Fenêtres de l'éditeur de formulaires +- Fenêtres de l'éditeur de code +- Fenêtres de l'éditeur de formulaires Toutes les fenêtres de ces éditeurs peuvent être ouvertes sous forme d'onglets : @@ -47,9 +47,9 @@ Dans la boîte de dialogue des Préférences de 4D, l'option **Fenêtre à ongle Trois options sont disponibles : - - **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). - - **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). - - **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. +- **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). +- **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). +- **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. ### Apparence (macOS uniquement) @@ -59,9 +59,9 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser pour l'e Trois options sont disponibles : - - **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. - - **Clair** : Utiliser le thème clair - - **Sombre** : utiliser le thème sombre +- **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. +- **Clair** : Utiliser le thème clair +- **Sombre** : utiliser le thème sombre > Cette préférence n'est prise en charge que sur macOS. Sous Windows, la palette "Light" est toujours utilisée. @@ -73,8 +73,8 @@ Si cette option est cochée, lorsque l’utilisateur passe en mode Application v Si vous sélectionnez cette option, deux éléments s'ajoutent au menu **Fichier > Nouveau** et au bouton **Nouveau** de la barre d'outils : - - **Database...** - - **Base de données à partir d'une définition de structure...** +- **Database...** +- **Base de données à partir d'une définition de structure...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Lors de la création d’un nouveau fichier de données, 4D utilise la langue d Cette zone permet de configurer l'accès à la documentation HTML de 4D qui s'affiche dans votre navigateur courant : - - When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; - - Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . +- When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; +- Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . ### Langue de documentation @@ -151,8 +151,8 @@ Langue de la documentation HTML à afficher. Vous pouvez sélectionner une docum Définit l'emplacement des pages de documentation recherchées par 4D. - - Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. - - If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. +- Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. +- If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. ### Dossier local diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md index 9be8a4354abe73..7d45b24ea92cac 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md @@ -15,8 +15,8 @@ Cette page permet de sélectionner, de créer ou de configurer les thèmes de l' Sélectionnez, dans cette liste, le thème à appliquer à l'éditeur de code. Tous les thèmes disponibles sont affichés, y compris les thèmes personnalisés (le cas échéant). 4D propose deux thèmes par défaut : - - **Default Light Theme** - - **Default Dark Theme** +- **Default Light Theme** +- **Default Dark Theme** > Les thèmes par défaut ne peuvent être ni modifiés ni supprimés. @@ -38,8 +38,8 @@ Si des valeurs clés ne sont pas définies dans un thème personnalisé, elles p Définir un thème signifie : - - définir une police et une taille de police pour l'ensemble de l'éditeur de code, - - attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. +- définir une police et une taille de police pour l'ensemble de l'éditeur de code, +- attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. La combinaison de couleurs et de styles différents est particulièrement utile à des fins de maintenance du code. @@ -83,8 +83,8 @@ Cette page configure les options d'affichage de l'éditeur de code. Permet de désactiver/activer les paramètres du code "international" pour l'application 4D locale. - - **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. - - **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. +- **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. +- **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. > Si vous modifiez cette option, vous devez redémarrer l'application 4D pour que le changement soit pris en compte. @@ -138,9 +138,9 @@ Permet de masquer, par défaut, toutes les icônes plier/déplier lorsque vous a Active l'insertion automatique de () et de caractères fermants lors de la saisie du code. Cette option contrôle deux fonctionnalités automatiques : - - **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). +- **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). - - **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : +- **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Active l'insertion automatique de () et de caractères fermants lors de la saisi Permet de modifier la signalisation graphique des caractères d'encadrement correspondants dans le code. Cette signalisation apparaît lorsqu’un crochet, une parenthèse ou une accolade est sélectionné(e). Les options suivantes sont disponibles : - - **Aucun** : Aucun signal - - **Rectangle** (default): Braces surrounded by a black line\ +- **Aucun** : Aucun signal +- **Rectangle** (default): Braces surrounded by a black line\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). - - **Gras** : caractères affichés en gras. +- **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). +- **Gras** : caractères affichés en gras. #### Surbrillance des variables et champs @@ -162,9 +162,9 @@ Permet de mettre en surbrillance toutes les occurrences d'un(e) même variable o ![](../assets/en/Preferences/optionsVariables.png) - - **Non** (par défaut) : Pas de surbrillance - - **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué - - **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné +- **Non** (par défaut) : Pas de surbrillance +- **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué +- **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné La couleur de surlignage peut être modifiée dans la page [Définition d'un thème](#définition-dun-thème). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md index 57a47fc24adf11..3a413828c5340d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md @@ -5,7 +5,7 @@ title: Architecture d'un projet Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un dossier racine de projet (dossier package). Par exemple : - - MyPackage (*dossier racine du projet*) +- MyPackage (*dossier racine du projet*) - `Composants` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un do La hiérarchie du dossier Project se présente généralement comme suit : - - fichier `.4DProject` - - `Sources` +- fichier `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Formulaires` - `TableForms` - `Les Triggers` - - `DerivedData` - - `Trash` (le cas échéant) +- `DerivedData` +- `Trash` (le cas échéant) ### fichier `.4DProject` Le fichier de développement de projet, utilisé pour désigner et lancer le projet. Ce fichier peut être ouvert par : - - 4D - - 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) > Dans les projets 4D, le développement est réalisé avec 4D et le développement multi-utilisateurs est géré par des outils de contrôle de version. 4D Server peut ouvrir des fichiers .4DProject à des fins de test. @@ -120,9 +120,9 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe Le dossier Trash contient des méthodes et des formulaires qui ont été supprimés du projet (le cas échéant). Il peut contenir les dossiers suivants : - - `Methods` - - `Formulaires` - - `TableForms` +- `Methods` +- `Formulaires` +- `TableForms` Dans ces dossiers, les noms des éléments supprimés sont entre parenthèses, par exemple. "(myMethod).4dm". L'organisation des dossiers est identique à celle du dossier [Sources](#sources). @@ -175,11 +175,11 @@ This folder contains [**user settings for data**](../Desktop/user-settings.md#us Le dossier Logs contient tous les fichiers journaux utilisés par le projet. Les fichiers journaux comprennent notamment : - - conversion de base de données, - - requêtes de serveur Web, - - journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) - - débogage de commandes, - - Requêtes 4D Server (générées sur les postes clients et sur le serveur). +- conversion de base de données, +- requêtes de serveur Web, +- journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) +- débogage de commandes, +- Requêtes 4D Server (générées sur les postes clients et sur le serveur). > Un dossier Logs supplémentaire est disponible dans le dossier des préférences système de l'utilisateur (dossier 4D actif, voir commande [Get 4D folder](../commands-legacy/get-4d-folder.md)) pour les fichiers journaux de maintenance et d diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/components.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/components.md index a942bb611c5ec0..c9830702ecf2ca 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/components.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/components.md @@ -13,15 +13,15 @@ Lorsque vous développez dans 4D, les fichiers de composants peuvent être stock Les composants peuvent être interprétés ou [compilés](../Desktop/building.md). - - Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. - - Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. +- Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. +- Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. ### Dossier racine (package) Le dossier racine d'un composant (dossier *MyComponent.4dbase*) peut contenir : - - pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. - - pour les **composants compilés** : +- pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. +- pour les **composants compilés** : - soit un dossier "Contents" contenant un fichier .4DZ, un dossier *Resources*, un fichier *Info.plist* (architecture recommandée) - soit directement un fichier .4DZ avec d'autres dossiers tels que *Resources*. @@ -37,8 +37,8 @@ L'architecture de dossier "Contents" est recommandée pour les composants si vou Cette page décrit comment travailler avec les composants dans les environnements **4D** et **4D Server**. Dans les autres environnements, les composants sont gérés différemment : - - dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. - - dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). +- dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. +- dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Cette page décrit comment travailler avec les composants dans les environnement Pour charger un composant dans votre projet 4D, vous pouvez soit : - - copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), - - ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). +- copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), +- ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). Les composants déclarés dans le fichier **dependencies.json** peuvent être stockés à différents endroits : - - au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, - - n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** - - sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. +- au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, +- n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** +- sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. Si le même composant est installé à différents endroits, un [ordre de priorité](#priority) est appliqué. @@ -69,8 +69,8 @@ Le fichier **dependencies.json** référence tous les composants nécessaires à Il peut contenir : - - les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), - - les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). +- les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), +- les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ Le fichier **environment4d.json** est facultatif. Il vous permet de définir des Les principaux avantages de cette architecture sont les suivants : - - vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. - - si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. +- vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. +- si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. ### Priorité @@ -187,9 +187,9 @@ En ce qui concerne les composants stockés sur GitHub, les fichiers [**dependenc Pour pouvoir référencer et utiliser directement un composant 4D stocké sur GitHub, vous devez configurer le dépôt du composant GitHub : - - Compressez les fichiers des composants au format ZIP. - - Nommez cette archive avec le même nom que le dépôt GitHub. - - Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. +- Compressez les fichiers des composants au format ZIP. +- Nommez cette archive avec le même nom que le dépôt GitHub. +- Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. Ces étapes peuvent être facilement automatisées, avec du code 4D ou en utilisant des actions GitHub, par exemple. @@ -232,7 +232,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin ::: - - Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : +- Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : ```json { @@ -245,7 +245,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin } ``` - - Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : +- Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : ```json { @@ -262,17 +262,17 @@ Un intervalle est défini par deux versions sémantiques, un minimum et un maxim Voici quelques exemples : - - "latest" : la version ayant le badge "latest" dans les releases GitHub. - - "\*" : la dernière version publiée. - - "1.\*" : toutes les versions de la version majeure 1. - - "1.2.\*" : tous les correctifs de la version mineure 1.2. - - ">=1.2.3" : la dernière version, à partir de la version 1.2.3. - - ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. - - "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. - - "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. - - "<=1.2.3" : la dernière version jusqu'à la 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. - - "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. +- "latest" : la version ayant le badge "latest" dans les releases GitHub. +- "\*" : la dernière version publiée. +- "1.\*" : toutes les versions de la version majeure 1. +- "1.2.\*" : tous les correctifs de la version mineure 1.2. +- ">=1.2.3" : la dernière version, à partir de la version 1.2.3. +- ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. +- "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. +- "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. +- "<=1.2.3" : la dernière version jusqu'à la 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. +- "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. Si vous ne spécifiez pas de tag ou de version, 4D récupère automatiquement la version "latest". @@ -282,9 +282,9 @@ Le Gestionnaire de dépendances vérifie périodiquement si des mises à jour de Si vous souhaitez utiliser la règle de dépendance [**Suivre la version 4D**](#defining-a-github-dependency-version-range), les tags des releases des composants sur le dépôt Github doivent respecter des conventions spécifiques. - - **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". +- **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". - - **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. +- **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. :::note @@ -310,8 +310,8 @@ Vous devez ensuite [fournir votre token de connexion](#providing-your-github-acc Les composants GitHub référencés sont téléchargés dans un dossier de cache local puis chargés dans votre environnement. Le dossier de cache local est stocké à l'emplacement suivant : - - sous macOs : `$HOME/Library/Caches//Dependencies` - - sous Windows : `C:\Users\\AppData\Local\\Dependencies` +- sous macOs : `$HOME/Library/Caches//Dependencies` +- sous Windows : `C:\Users\\AppData\Local\\Dependencies` ...où `` peut être "4D", "4D Server" ou "tool4D". @@ -319,12 +319,12 @@ Les composants GitHub référencés sont téléchargés dans un dossier de cache When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Cela inclut : - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ Dans un projet ouvert, vous pouvez ajouter, supprimer, mettre à jour et obtenir Pour afficher la fenêtre Dépendances : - - avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
+- avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
+- avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) La fenêtre Dépendances s'affiche alors. Les dépendances sont classées par nom par ordre alphabétique : @@ -362,11 +362,11 @@ Par défaut, toutes les dépendances identifiées par le Gestionnaire de dépend ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. - - **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. +- **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. ### Secondary dependencies @@ -384,16 +384,16 @@ Les dépendances nécessitant l'attention du développeur sont signalées par un Les étiquettes de statut suivantes sont disponibles : - - **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. - - **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. - - **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. - - **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). - - **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). - - **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. - - **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. - - **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. - - **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. - - **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. +- **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. +- **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. +- **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. +- **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). +- **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). +- **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. +- **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. +- **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. +- **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. +- **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. Une infobulle s'affiche lorsque vous survolez la ligne de dépendance, fournissant des informations supplémentaires sur le statut : @@ -427,8 +427,8 @@ Cet élément n'est pas affiché si la dépendance est inactive parce que ses fi L'icône du composant et le logo de l'emplacement fournissent des informations supplémentaires : - - Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. - - Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. +- Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. +- Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Si l'élément sélectionné n'est pas valide, un message d'erreur s'affiche. Cliquez sur **Ajouter** pour ajouter la dépendance au projet. - - Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). - - Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). +- Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). +- Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Vous pouvez définir l'option [règle de dépendance](#tags-and-versions) pour u ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). - - **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. - - **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. - - **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. - - **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. +- **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). +- **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. +- **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. +- **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. +- **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. La version courante de la dépendance GitHub est affichée sur le côté droit de l'élément de la dépendance : @@ -509,8 +509,8 @@ La modification de la plage de versions est utile par exemple si vous utilisez l Le Gestionnaire de dépendances permet une gestion intégrée des mises à jour sur GitHub. Les fonctionnalités suivantes sont prises en charge : - - Vérification automatique et manuelle des versions disponibles - - Mise à jour automatique et manuelle des composants +- Vérification automatique et manuelle des versions disponibles +- Mise à jour automatique et manuelle des composants Les opérations manuelles peuvent être effectuées **par dépendance** ou **pour toutes les dépendances**. @@ -526,11 +526,11 @@ Si vous fournissez un [token d'accès](#providing-your-github-access-token), les En outre, vous pouvez vérifier les mises à jour à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. +- Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. ![check component](../assets/en/Project/check-component-one.png) - - Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. +- Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. ![check components](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Si vous ne souhaitez pas utiliser la mise à jour des composants (par exemple, v Vous pouvez mettre à jour les dépendances à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : +- Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : ![check component](../assets/en/Project/update-component-one.png) - - Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : +- Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ Dans tous les cas, quel que soit le statut courant de la dépendance, une vérif Lorsque vous sélectionnez une commande de mise à jour : - - une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. - - si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. +- une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. +- si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. #### Mise à jour automatique @@ -575,13 +575,13 @@ Lorsque cette option n'est pas cochée, une nouvelle version de composant corres L'enregistrement de votre *token* (jeton) d'accès personnel dans le gestionnaire de dépendances est : - - obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), - - recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. +- obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), +- recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. Pour fournir votre jeton d'accès à GitHub, vous pouvez soit : - - cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. - - ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. +- cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. +- ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md index b9fb76949e4525..a376f818c231b2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md @@ -7,10 +7,10 @@ Dans les projets d'application, vous pouvez documenter vos méthodes ainsi que v Les éléments de projet suivants peuvent être documentés : - - Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) - - Classes - - Formulaires - - Tables et champs +- Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) +- Classes +- Formulaires +- Tables et champs Vos fichiers de documentation sont écrits dans la syntaxe Markdown (fichiers .md) à l'aide de n'importe quel éditeur prenant en charge le Markdown. Ils sont stockés en tant que fichiers indépendants dans votre dossier Project. @@ -34,7 +34,7 @@ Tous les fichiers de documentation sont stockés dans le dossier `Documentation` L'architecture du dossier `Documentation` est la suivante : - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ L'architecture du dossier `Documentation` est la suivante : - table1.md - ... - - Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. - - Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. > Renommer ou supprimer un élément documenté dans votre projet renomme ou supprime également le fichier Markdown associé à l'élément. @@ -73,9 +73,9 @@ Pour afficher la documentation dans la fenêtre de l'Explorateur : ![](../assets/en/Project/comments-explo2.png) - - Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). +- Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). - - Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. +- Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. ### Modifier le fichier documentation @@ -83,8 +83,8 @@ Vous pouvez créer et/ou modifier un fichier de documentation Markdown à partir S'il n'y a pas de fichier de documentation pour l'élément sélectionné, vous pouvez : - - cliquez sur le bouton **Créer** dans le volet `Documentation` ou, - - choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. +- cliquez sur le bouton **Créer** dans le volet `Documentation` ou, +- choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ L'éditeur de code 4D affiche une partie de la documentation d'une méthode dans Si un fichier nommé`\.md` existe dans le dossier `\/documentation` , l'éditeur de code affiche (par priorité) : - - Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. +- Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. - - Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ +- Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D. @@ -131,7 +131,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Prise en charge du markdown - - La balise de titre est prise en charge : +- La balise de titre est prise en charge : ```md # Title 1 @@ -139,7 +139,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Title 3 ``` - - Les balises de style (italique, gras, barré) sont prises en charge : +- Les balises de style (italique, gras, barré) sont prises en charge : ```md _italic_ @@ -148,7 +148,7 @@ _italic_ ~~strikethrough~~ ``` - - La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : +- La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : ````md ```4d @@ -157,7 +157,7 @@ _italic_ ``` ```` - - La balise de tableau est prise en charge : +- La balise de tableau est prise en charge : ```md | Parameter | Type | Description | @@ -166,7 +166,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La balise de lien est prise en charge : +- La balise de lien est prise en charge : ```md // Case 1 @@ -178,7 +178,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Les balises d'image sont prises en charge : +- Les balises d'image sont prises en charge : ```md ![image info](pictures/image.png) @@ -225,10 +225,10 @@ $logo:=GetLogo(5) ``` ```` - - Vue de l'explorateur : +- Vue de l'explorateur : ![](../assets/en/Project/explorer_Doc.png) - - Vue de l'éditeur de code : +- Vue de l'éditeur de code : ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md index fc307574f2b1cc..72713992861bd9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md @@ -11,18 +11,18 @@ Lorsque vous avez des attributs relationnels dans une dataclass, utilisez `$attr Vous pouvez appliquer des `$attributes` à une entité (par exemple, People (1)) ou à une entity selection (par exemple, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. +- Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. - - Si `$attributes` est spécifié pour les attributs **related entity** : +- Si `$attributes` est spécifié pour les attributs **related entity** : - `$attributes=relatedEntity` : l'entité liée est retournée sous une forme simple (propriété __KEY différée (clé primaire)) et `URI`. - `$attributes=relatedEntity.*` : tous les attributs de l'entité liée sont retournés - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs de l'entité liée sont retournés. - - Si `$attributes` est spécifié pour les attributs **related entities** : +- Si `$attributes` est spécifié pour les attributs **related entities** : - `$attributes=relatedEntities.*` : toutes les propriétés des entités liées sont retournées - `$attributes=relatedEntities.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs des entités liées sont retournés. - - Si `$attributes` est spécifié pour les attributs **storage** : +- Si `$attributes` est spécifié pour les attributs **storage** : - `$attributes=attribute1, attribute2, ...` : seuls les attributs des entités sont renvoyés. ## Exemple avec plusieurs entités liées diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md index f291bc472820ca..9bb7a1a9f8c763 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md @@ -27,13 +27,13 @@ Les verrouillages déclenchés par l'API REST sont placés au niveau de la [sess Une entité verrouillée est considérée comme *verrouillée* (c'est-à-dire que les actions de verrouillage / déverrouillage / mise à jour / suppression ne sont pas possibles) par : - - d'autres sessions REST - - les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. +- d'autres sessions REST +- les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. Une entité verrouillée par l'API REST peut être déverrouillée uniquement : - - via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` - - ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). +- via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` +- ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). ### Réponse diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md index 21c28f15321bb4..bea88fda52e2c1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md @@ -194,9 +194,9 @@ Si un problème survient lors de l'ajout ou de la modification d'une entité, un :::note - - **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). - - Les valeurs des **booléens** sont vrai ou faux. - - Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). +- Les valeurs des **booléens** sont vrai ou faux. +- Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md index 3fcd42322177a2..76d5a6bbd7b1f0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Vous pouvez appeler les [fonctions de classe du modèle de données](ORDA/ordaCl Les fonctions peuvent être appelées de deux manières : - - en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. - - en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. +- en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. +- en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. Les requêtes POST offrent un meilleur niveau de sécurité car elles évitent l'exécution de code sensible par une action aussi simple que de cliquer sur un lien. Cependant, les requêtes GET peuvent être plus conformes à l'expérience utilisateur, en permettant d'appeler des fonctions en saisissant un URL dans un navigateur (note : le développeur doit s'assurer qu'aucune action sensible n'est effectuée dans ces fonctions). @@ -96,11 +96,11 @@ Vous pouvez envoyer des paramètres à des fonctions de classes utilisateur ou d Les règles suivantes s'appliquent : - - Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. - - Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. - - Les paramètres doivent être inclus dans une collection (format JSON). - - Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. - - L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. +- Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. +- Les paramètres doivent être inclus dans une collection (format JSON). +- Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. +- L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Voir [cet exemple](#using-an-entity-to-be-created-on-the-server) et [cet exemple](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Vous pouvez également transmettre des valeurs pour tous les attributs de l'enti | __ENTITY | Boolean | Obligatoire - Vrai pour indiquer au serveur que le paramètre est une entité | | __KEY | mixte (type identique à celui de la clé primaire) | Optionnel - clé primaire de l'entité | - - Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. - - Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés +- Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. +- Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés Voir les exemples ci-dessous pour la création ou la mise à jour d'entités avec des requêtes POST. Voir un exemple de téléchargement de contenu à l'aide d'une entité avec une requête GET. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md index a58197e4054127..bb3704ed202c99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md @@ -44,9 +44,9 @@ Toutes les autres requêtes REST (manipulant des données ou exécutant une fonc Les requêtes REST descriptives peuvent être traitées dans des sessions d'utilisateurs web qui ne nécessitent pas de licences (sessions "guest"). Ces requêtes sont : - - requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles - - `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur - - `/rest/$getWebForm` - le rendu d'une page Qodly +- requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles +- `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur +- `/rest/$getWebForm` - le rendu d'une page Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ La fonction peut recevoir toute information d'authentification ou contextuelle e Cette fonction doit contenir deux parties : - - un code pour identifier et authentifier l'expéditeur de la demande REST, - - si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. +- un code pour identifier et authentifier l'expéditeur de la demande REST, +- si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. Si la fonction ne fait pas appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), aucun privilège n'est attribué, aucune licence n'est consommée et les requêtes REST non descriptives ultérieures sont rejetées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md index 7ab8a9f2d6c9d8..25bdced0fd754f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md @@ -9,8 +9,8 @@ Le serveur REST est inclus dans 4D et 4D Server et automatiquement disponible da Cette section est destinée à vous familiariser avec la fonctionnalité REST à l'aide d'un exemple simple. Nous allons : - - créer et configurer un projet d'application 4D basique - - accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. +- créer et configurer un projet d'application 4D basique +- accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. Pour simplifier l'exemple, nous allons utiliser 4D et un navigateur qui s'exécutent sur la même machine. Bien entendu, vous pouvez également utiliser une architecture distante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md index f3df174864fa88..1c7e3fb711047c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md @@ -17,15 +17,15 @@ Vous disposez également de trois boutons-raccourcis permettant de filtrer par f ![](../assets/en/Admin/server-process-buttons.png) - - **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. - - **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. - - **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. +- **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. +- **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. +- **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. L’option **Afficher les process par groupes** vous permet de regrouper les process internes de 4D Server ainsi que les process clients, pour plus de lisibilité. Lorsque vous cochez cette option : - - les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, - - le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), - - le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. +- les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, +- le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), +- le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. La zone inférieure de la fenêtre permet d’afficher la représentation graphique de l’activité du ou des process sélectionné(s). @@ -33,16 +33,16 @@ La zone inférieure de la fenêtre permet d’afficher la représentation graphi L’activité du process est le pourcentage du temps que 4D Server a consacré à ce process (ratio). La fenêtre fournit les informations suivantes pour chaque process : - - Type de process (cf. ci-dessous), - - Session: +- Type de process (cf. ci-dessous), +- Session: - Process 4D - vide, - Process utilisateur - nom de l'utilisateur 4D, - Process web - chemin URL, - - Nom du process, - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. - - Etat courant du process, - - Temps (en secondes) d'exécution du process depuis sa création, - - Pourcentage du temps que 4D Server a consacré à ce process (ratio). +- Nom du process, +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. +- Etat courant du process, +- Temps (en secondes) d'exécution du process depuis sa création, +- Pourcentage du temps que 4D Server a consacré à ce process (ratio). ## Type du process @@ -83,15 +83,15 @@ La page comporte cinq boutons de commande permettant d’agir sur le ou les proc ![](../assets/en/Admin/server-process-actions.png) - - **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. +- **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Endormir process** : permet d’endormir le ou les process sélectionné(s). - - **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. - - **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). +- **Endormir process** : permet d’endormir le ou les process sélectionné(s). +- **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. +- **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). > Vous pouvez déboguer un process directement, sans afficher la boîte de dialogue de confirmation : pour cela, appuyez sur la touche **Alt** avant de cliquer sur le bouton. - - **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. +- **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md index 88e4afb8dfdc4c..a24ecfbc38ac30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Chaque opération longue sur les données entraîne l’ajout d’une ligne. La Les informations suivantes sont fournies pour chaque ligne : - - **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" - - **Durée** (ms) : durée en cours de l’opération en millisecondes - - **Informations** : libellé de l’opération. - - **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : +- **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" +- **Durée** (ms) : durée en cours de l’opération en millisecondes +- **Informations** : libellé de l’opération. +- **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : - **Créée sur** : indique si l'opération résulte d'une action d'un client (Créée sur client) ou si elle a été démarrée explicitement sur le serveur via une procédure stockée ou l'option "Exécuter sur serveur" (Créée sur serveur). - **Détails de l'opération** : décrit le type d'opération ainsi que (pour les opérations de recherche) le plan de recherche. - **Sous-opérations** (le cas échéant) : affiche les opérations dépendantes de l'opération sélectionnée (par exemple, suppression des enregistrements liés avant suppression de l'enregistrement parent). @@ -26,9 +26,9 @@ Les informations suivantes sont fournies pour chaque ligne : La page est active et mise à jour en permanence dès qu’elle est affichée. Il est à noter que son fonctionnement peut ralentir sensiblement l’exécution de l’application. Il est possible de suspendre la mise à jour de la page d’une des manières suivantes : - - en cliquant sur le bouton **Pause**, - - en cliquant dans la liste, - - en appuyant sur la barre d’espace. +- en cliquant sur le bouton **Pause**, +- en cliquant dans la liste, +- en appuyant sur la barre d’espace. Lorsque la page est en pause, le message "SUSPENDU" est affiché et le libellé du bouton devient **Reprendre**. Il est possible de reprendre l’observation des opérations en effectuant la même action que pour la mise en pause. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md index c236eba874ff74..1953c331cd9336 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md @@ -7,8 +7,8 @@ Si plusieurs personnes utilisent une application, ce qui est souvent le cas dans La stratégie de contrôle d'accès 4D dépend de la configuration de votre déploiement : - - dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, - - dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). +- dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, +- dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). > Consultez le document [4D Security guide](https://blog.4d.com/4d-security-guide/) pour une vue d'ensemble des fonctions de sécurité de 4D. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md index 01c8c873fe4fef..e25e474a6ccd30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Dans *filePath*, passez le chemin de destination et le nom du document à export Vous pouvez préciser le format du document en incluant une extension après son nom : - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", or ".csv") - - [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", or ".csv") +- [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si l'extension n'est pas incluse, mais que le format est spécifié dans *paramObj*, le fichier exporté aura l'extension correspondant au format, sauf pour le format CSV (aucune extension n'est ajoutée dans ce cas). @@ -88,25 +88,25 @@ Le paramètre optionnel *paramObj* vous permet de définir plusieurs propriété **Notes sur le format Excel** : - - Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. +- Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. **Notes sur le format PDF** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format CSV** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. - - Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. +- Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format de fichier SpreadJS** : - - [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Une fois l'opération d'exportation terminée, `VP EXPORT DOCUMENT` déclenche automatiquement l'exécution de la méthode définie dans la propriété *formula* de *paramObj*, si elle est utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md index ba7deb2c1a617b..7be68c67b0c15f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Vous pouvez définir où lire les feuilles de style via le paramètre *sheet* en passant le numéro d'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes : - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md index 6ef3aed705324f..c28b402a6b1381 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ L'objet retourné contiendra la propriété `value` et, dans le cas d'une valeur Si l'objet retourné inclut une date ou une heure, il est traité en tant que datetime et est complété comme suit : - - valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) - - valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) +- valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) +- valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) Si *rangeObj* contient plusieurs cellules ou plusieurs plages, la valeur de la première cellule est retournée. La commande retourne un objet null si la cellule est vide. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md index 957ab64f0ef25e..30b1f55b1cbe4f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Dans *filePath*, passez le chemin et le nom du document à importer. Les formats suivants sont pris en charge : - - Les documents 4D View Pro (extension ".4vp") - - Microsoft Excel (extension ".xlsx") - - documents texte (extension ".txt", ".csv", le document doit être en utf-8) - - [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Les documents 4D View Pro (extension ".4vp") +- Microsoft Excel (extension ".xlsx") +- documents texte (extension ".txt", ".csv", le document doit être en utf-8) +- [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si l'extension du document n'est pas une extension reconnue, telle que `.4vp` ou `.xlsx`, le document est considéré comme un document texte. Vous devez passer un chemin d'accès complet, sauf si le document est situé au même niveau que le dossier Project, auquel cas vous pouvez simplement passer son nom. @@ -73,11 +73,11 @@ Le paramètre optionnel *paramObj* vous permet de définir les propriétés du d :::note Notes - - Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md index 60d66464e2227f..429215433cfae2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ La commande `VP RESIZE TABLE` modi Les règles suivantes s'appliquent : - - Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. - - Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. - - Si la table se développe sur des cellules contenant des données : +- Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. +- Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. +- Si la table se développe sur des cellules contenant des données : - si des lignes sont ajoutées, les données sont supprimées, - si des colonnes sont ajoutées, les données sont conservées et affichées dans de nouvelles colonnes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md index 44d8f2689dda1f..2b20cdb1f27596 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Les feuilles de calcul sont composées de lignes et de colonnes. Un numéro est ### Sélection des cellules, des colonnes et des lignes - - Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. +- Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. - - Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. +- Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. - - Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : +- Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). +- Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). - - Pour sélectionner une ligne, cliquez sur le chiffre correspondant. +- Pour sélectionner une ligne, cliquez sur le chiffre correspondant. - - Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. +- Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. - - Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. +- Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. ### Saisie de données @@ -76,8 +76,8 @@ Les zones 4D View Pro bénéficient d'un menu contextuel automatique qui offre d En fonction de la zone cliquée, les options suivantes sont également disponibles : - - cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu - - cliquez sur une cellule ou une plage de cellules : +- cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu +- cliquez sur une cellule ou une plage de cellules : - **Filtrer** : permet de masquer la ligne via des filtres (voir "Filtrer les lignes" dans la [documentation SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Trier** : permet de trier le contenu des colonnes. - **Insérer un commentaire** : permet à l'utilisateur de saisir un commentaire pour une zone. Lorsqu'un commentaire a été saisi pour une zone, la cellule supérieure gauche de la zone affiche un petit triangle rouge :\ @@ -128,8 +128,8 @@ Ensuite, vous pouvez passer `$myRange` à une autre méthode 4D View Pro pour mo Les objets plage 4D View Pro sont composés de plusieurs propriétés : - - area - Le nom de la zone 4D View Pro - - ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. +- area - Le nom de la zone 4D View Pro +- ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. | Propriété | | Type | Description | Disponible pour | | --------- | ------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Les objets plage 4D View Pro sont composés de plusieurs propriétés : 4D View Pro prend en charge l'import et l'export de plusieurs formats de documents : - - .4vp - - .xlsx - - .txt et .csv - - .sjs - - .pdf (à des fins d'export uniquement) +- .4vp +- .xlsx +- .txt et .csv +- .sjs +- .pdf (à des fins d'export uniquement) Pour plus de détails, consultez la description de [VP IMPORT DOCUMENT](commands/vp-import-document.md) et [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md index be935548f38b11..d09a66e2938ac9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Certains autres éléments ont une casse différente (par exemple : `this` vs `T Les noms des commandes et des constantes QodlyScript sont écrits en camel case sans espaces. De plus, les noms de constantes de QodlyScript commencent par la lettre `k`. Vous devrez peut-être adapter ces éléments QodlyScript au langage 4D. - - Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. - - Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. +- Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. +- Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. ### Exemple - - Code QodlyScript : +- Code QodlyScript : ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Les noms des commandes et des constantes QodlyScript sont écrits en camel case end ``` - - Code équivalent en langage 4D : +- Code équivalent en langage 4D : ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md index 74201be81f79d1..fa269cbe8b4f6e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Dans les sections ci-dessus, nous obtenons un accès libre à l'application à p La façon la plus simple et sécurisée de connecter un utilisateur sur le serveur web 4D est basée sur le scénario suivant : - - Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) - - La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. +- Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) +- La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. 1. Créez une table avec certains champs, par exemple : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md index f60926b16c7b05..3f3bc43413eede 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Conditions requises Custom HTTP Request handlers are supported: - - when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/.+/index\.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ URL patterns can be given as **prefixes** or using **regular expressions**. Les modèles d'URL sont déclenchés dans l'ordre indiqué : - - le premier motif correspondant est exécuté - - the following patterns are not executed even if they match the URL +- le premier motif correspondant est exécuté +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Class and method You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. +- "method": class function belonging to the class. [See below](#request-handler-code) for information about the request handler code. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* in the *UsersHandling* class - - *handleInvoices* in the *FinancialHandling* class - - *handleDocs* in the *DocsHandling* class - - *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class +- *handle function* in the *GeneralHandling* class +- *manageAccount* in the *UsersHandling* class +- *handleInvoices* in the *FinancialHandling* class +- *handleDocs* in the *DocsHandling* class +- *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class Examples of URLs triggering the handlers: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md index 1b23eea8d806ac..e7ba5e309ee91f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process | Serveur Web | coopératif | *paramètres web* | | Server Web Services | coopératif | *paramètres web* | - - Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) - - Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) - - Serveur de services Web : gère les requêtes SOAP - - ***web setting*** signifie que le mode préemptif dépend d'une valeur de réglage : +- Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) +- Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) +- Serveur de services Web : gère les requêtes SOAP +- ***web setting*** signifie que le mode préemptif dépend d'une valeur de réglage : - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - sinon, l'option [**Utiliser des process préemptifs**](webServerConfig.md#use-preemptive-processes) est prise en compte. - en ce qui concerne les process de service Web (serveur ou client), le mode préemptif est pris en charge au niveau de la méthode. You just have to select "Can be run in preemptive processes" property for published SOAP server methods (see [Publishing a Web Service with 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) or proxy client methods (see [Subscribing to a Web Service in 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) and make sure they are confirmed thread-safe by the compiler. @@ -35,21 +35,21 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souhaitez que les process Web soient lancés en mode préemptif. Lorsque l'option [Utiliser des process préemptifs](#availability-of-preemptive-mode-for-web-processes) est cochée dans le dialogue des Propriétés, les parties de l'application listées ci-dessous sont automatiquement évaluées par 4D Compiler : - - Toutes les méthodes base liées au web : +- Toutes les méthodes base liées au web : - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) et [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; +- La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; - - Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages - - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" +- Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" - - Triggers pour les tables comportant l'attribut "Expose as REST resource" +- Triggers pour les tables comportant l'attribut "Expose as REST resource" - - [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST +- [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST Pour chacune de ces méthodes ou parties de code, le compilateur vérifiera si les règles thread-safe sont respectées, et retournera une erreur en cas de problème. Pour plus d'informations à propos des règles thread-safe, veuillez vous référer au paragraphe *Ecrire une méthode thread-safe* dans le chapitre *Process* du manuel de [Langage 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ La plupart des commandes, fonctions, méthodes base et URLs 4D sont thread-safe Toutes les commandes 4D relatives au Web sont thread-safe, à savoir : - - toutes les commandes du thème *Web Server* - - toutes les commandes du thème *Client HTTP*. +- toutes les commandes du thème *Web Server* +- toutes les commandes du thème *Client HTTP*. Les méthodes base ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif (voir ci-dessus) : `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Bien sûr, le code exécuté par ces méthodes doit aussi être thread-safe. Les URLs Web Server ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif : - - *4daction/* (la méthode projet appelée doit également être à thread-safe) - - *4dcgi/* (les méthodes base appelées doivent également être thread-safe) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) - - *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) +- *4daction/* (la méthode projet appelée doit également être à thread-safe) +- *4dcgi/* (les méthodes base appelées doivent également être thread-safe) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) +- *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) ### Icône de process web préemptif diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md index f1490bbde78d3f..f16a65241179fc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio peut également être utilisé sur la [**plateforme Qodly Cloud**]( Qodly Studio proposes a full-featured web UI, allowing you to: - - create Qodly pages by placing components on a canvas - - map components to Qodly Sources - - déclencher du code 4D en configurant des événements - - et bien plus encore ! +- create Qodly pages by placing components on a canvas +- map components to Qodly Sources +- déclencher du code 4D en configurant des événements +- et bien plus encore ! ## Configuration @@ -24,19 +24,19 @@ Qodly Studio proposes a full-featured web UI, allowing you to: Qodly Studio prend en charge les navigateurs Web suivants : - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La résolution recommandée est de 1920x1080. #### Application 4D - - Développement : 4D 20 R2 ou version ultérieure - - Déploiement : 4D Server 20 R2 ou version ultérieure - - Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). - - Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). - - Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). +- Développement : 4D 20 R2 ou version ultérieure +- Déploiement : 4D Server 20 R2 ou version ultérieure +- Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). +- Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). +- Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). ### Activer l'accès à Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio est alimenté par le [serveur WebAdmin](../Admin/webAdmin.md) et af Pour permettre l'accès à Qodly Studio, vous devez explicitement autoriser deux niveaux : - - au niveau de l'application 4D - - niveau projet +- au niveau de l'application 4D +- niveau projet Si l'un des deux niveaux (ou les deux) n'est pas activé, l'accès à Qodly Studio est refusé (une page 403 est renvoyée). @@ -79,8 +79,8 @@ L'authentification sur le serveur WebAdmin utilise une access key (clé d'accès Conformément à la gestion des projets 4D, seules les utilisations suivantes sont prises en charge : - - le développement avec Qodly Studio s'effectue avec **4D** (monoposte). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- le développement avec Qodly Studio s'effectue avec **4D** (monoposte). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La page Qodly Studio est disponible lorsque le [serveur WebAdmin est lancé](../ Il y a deux façons d'accéder à Qodly Studio : - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si le serveur WebAdmin est déjà en cours d'exécution, selon sa configuration, votre navigateur par défaut s'ouvre à l'adresse `IPaddress:HTTPPort/studio` ou `IPaddress:HTTPSPort/studio`. Sinon, vous serez invité à démarrer d'abord le serveur web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` ou : @@ -145,24 +145,24 @@ Il n'y a pas de compatibilité directe entre les applications implémentées ave The following commands and classes are dedicated to the server-side management of Qodly pages: - - [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. - - [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. - - [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. - - [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. +- [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. +- [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. +- [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. +- [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. ### Utilisation des méthodes projet Nous recommandons d'utiliser les fonctions de classe plutôt que les méthodes projet. Seules les fonctions de classe peuvent être appelées à partir des composants. Cependant, vous pouvez toujours utiliser les méthodes projet dans Qodly Studio de deux manières : - - Vous pouvez appeler vos méthodes à partir des fonctions de classe. - - Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. +- Vous pouvez appeler vos méthodes à partir des fonctions de classe. +- Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. ### Utilisation hors ligne Vous pouvez développer avec Qodly Studio lorsque votre ordinateur n'est pas connecté à internet. Dans ce cas cependant, les fonctions suivantes ne sont pas accessibles : - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide - - UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide +- UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). ## Déploiement @@ -178,8 +178,8 @@ See [this page](https://developer.qodly.com/docs/studio/rendering) for detailed To enable the rendering of Qodly pages, the following options must be set. - - The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. - - Le [serveur Web 4D](webServer.md) doit être démarré. +- The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. +- Le [serveur Web 4D](webServer.md) doit être démarré. :::note @@ -309,9 +309,9 @@ To logout the user, you just need to execute the **Logout** standard action from Déclencher l'action de déconnexion d'une session utilisateur Web a les effets suivants : - - la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, - - la licence 4D associée est libérée, - - le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. +- la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, +- la licence 4D associée est libérée, +- le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. ## Utilisation de licences pour le rendu @@ -363,7 +363,7 @@ Pour plus d'informations sur l'attribut `SameSite`, consultez [cet article de bl Pour éviter d'utiliser plus de licences que nécessaire, nous vous recommandons d'effectuer l'une des actions suivantes : - - Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. - - Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. +- Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. +- Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md index 003879e7952808..c71cb2bb77fe56 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md @@ -19,16 +19,16 @@ La valeur de la variable 4D *vtSiteName* sera insérée dans la page HTML. Les balises 4D suivantes sont disponibles : - - 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, - - 4DHTML, pour insérer du code HTML, - - 4DEVAL, pour évaluer toute expression 4D, - - 4DSCRIPT, pour exécuter une méthode 4D, - - 4DINCLUDE, pour inclure une page dans une autre, - - 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, - - 4DCODE, pour insérer du code 4D, - - 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, - - 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, - - 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. +- 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, +- 4DHTML, pour insérer du code HTML, +- 4DEVAL, pour évaluer toute expression 4D, +- 4DSCRIPT, pour exécuter une méthode 4D, +- 4DINCLUDE, pour inclure une page dans une autre, +- 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, +- 4DCODE, pour insérer du code 4D, +- 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, +- 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, +- 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. Ces balises sont décrites dans la page [Balises de transformation](../Tags/transformation-tags.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md index 5eb1fb5bbc72d8..83c947cfc03387 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un projet 4D peut démarrer et surveiller un serveur Web pour l'application prin Il y a plusieurs manières de démarrer le serveur Web principal : - - via un bouton/une commande de menu : +- via un bouton/une commande de menu : - 4D: **Exécution\>Démarrer le serveur Web**
![](../assets/en/WebServer/start1.png) - 4D Server : Bouton **Démarrer le serveur HTTP** dans la page Serveur HTTP
![](../assets/en/WebServer/start2.png) - - automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) +- automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) - - Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. +- Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. Le serveur Web de n'importe quel composant peut être lancé en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) sur l'objet serveur Web du composant. @@ -29,9 +29,9 @@ Le serveur Web de n'importe quel composant peut être lancé en appelant la fonc Il y a plusieurs manières d'arrêter le serveur Web principal : - - Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). +- Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). - - Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. +- Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. Le serveur Web de n'importe quel composant peut être arrêté en appelant la fonction `webServer.stop()` sur l'objet serveur Web du composant. @@ -53,8 +53,8 @@ Cette commande vous permet de vérifier que le serveur web, l'affichage de la pa Pour ce faire, vous pouvez : - - 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. - - 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. +- 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. +- 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. Le cache est alors immédiatement effacé. @@ -64,11 +64,11 @@ Le cache est alors immédiatement effacé. La page **Watch** (rubrique **Web**) de l'Explorateur d'exécution affiche les informations du serveur Web, notamment : - - **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. +- **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. - - **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. +- **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. - - **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. +- **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. ## URLs d'administration @@ -123,8 +123,8 @@ L'URL */4DWEBTEST* permet de vérifier l'état du serveur web. Lorsque cette URL 4D vous permet de générer deux historiques de requêtes Web : - - un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), - - un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). +- un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), +- un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). Les deux fichiers journaux sont automatiquement créés dans le dossier **Logs** du projet d'application. @@ -225,15 +225,15 @@ Les paramètres de sauvegarde automatique du logweb.txt sont définis sur la pag D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md index 69ce160f5ae2d3..d49a4de96f110b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Liste des hôtes et méthodes autorisé(e)s pour le service CORS. Nom de domaine ou adresse IP à partir desquels les pages externes sont autorisées à envoyer des demandes de données au serveur via CORS. Plusieurs attributs de domaine peuvent être ajoutés pour créer une liste blanche. Plusieurs syntaxes sont supportées : - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Méthodes HTTP autorisées (propriété méthodes) Méthodes HTTP acceptées pour l'hôte CORS correspondant. Les méthodes HTTP suivantes sont prises en charge : - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Séparez chaque méthode par un ";" (ex : "post;get"). Si Méthodes est vide, null ou non défini, toutes les méthodes sont activées. @@ -145,9 +145,9 @@ Par défaut, quand le serveur web est lancé pour la première fois, 4D crée un Vous pouvez désigner une autre page comme page d'accueil par défaut en entrant son chemin d'accès : - - Le chemin est relatif au [dossier HTML racine ](#root-folder), - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Le chemin ne doit pas commencer ou finir par un slash. +- Le chemin est relatif au [dossier HTML racine ](#root-folder), +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Le chemin ne doit pas commencer ou finir par un slash. Par exemple, pour que la page d'accueil par défaut soit "MyHome.htm", si elle se trouve dans le dossier "Web" (lui-même situé dans le dossier racine HTML par défaut), utilisez "Web/MyHome.htm". @@ -318,15 +318,15 @@ Valeurs possibles: Chaîne de caractères représentant l'adresse IP. Les format #### À propos du support de l'IPv6 - - **Aucun avertissement lorsque le port TCP est occupé**
+- **Aucun avertissement lorsque le port TCP est occupé**
Lorsque le serveur est configuré pour répondre sur "Toutes" les adresses IP, si le port TCP est utilisé par une autre application, cela n'est pas indiqué au démarrage du serveur. En fait, le serveur 4D ne détecte pas d'erreur dans ce cas car le port reste libre sur l'adresse IPv6. Cependant, il n'est pas possible d'y accéder en utilisant l'adresse IPv4 de la machine, ni au moyen de l'adresse locale : 127.0.0.1. Si votre serveur 4D ne semble pas répondre sur le port défini, vous pouvez tester l'adresse [::1] sur la machine serveur (équivalent à 127.0.0.1 pour IPv6, ajoutez [:portNum] pour tester un autre numéro de port). Si 4D répond, il est probable qu'une autre application utilise le port en IPv4. - - **Adresses IPv6 avec mappage d'IPv4**
+- **Adresses IPv6 avec mappage d'IPv4**
Pour standardiser le traitement, 4D fournit une représentation hybride standard des adresses IPv4 en IPv6. Ces adresses sont écrites avec un préfixe de 96 bits au format IPv6, suivi de 32 bits écrits dans la notation décimale à point d'IPv4. Par exemple, ::ffff:192.168.2.34 représente l'adresse IPv4 192.168.2.34. - - **Indication des numéros de port**
+- **Indication des numéros de port**
Comme la notation IPv6 utilise les deux-points (:), l'ajout de numéros de port peut entraîner une certaine confusion, par exemple : ```code4d @@ -420,10 +420,10 @@ Version TLS minimale acceptée pour les connexions. Les tentatives de connexion Valeurs possibles : - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (par défaut) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (par défaut) +- 4 = TLSv1_3 En cas de modification, le serveur doit être redémarré pour utiliser la nouvelle valeur. @@ -489,10 +489,10 @@ Par exemple : Disallow: /GIFS/ ``` - - “User-Agent: \*” - tous les robots sont concernés. - - “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. - - "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. - - "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. +- “User-Agent: \*” - tous les robots sont concernés. +- “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. +- "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. +- "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. Autre exemple : @@ -517,15 +517,15 @@ De plus, le dossier racine HTML définit, sur le disque dur du serveur web, le n Par défaut, 4D définit un dossier racine HTML nommé **WebFolder**. S'il n'existe pas encore, le dossier racine HTML est physiquement créé sur le disque au moment où le serveur Web est lancé pour la première fois. Le dossier racine est créé : - - avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). - - avec 4D en mode remote, dans le fichier des ressources locales. +- avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). +- avec 4D en mode remote, dans le fichier des ressources locales. Vous pouvez désigner un autre dossier HTML racine comme page d'accueil par défaut en entrant son chemin d'accès. - - Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier - - Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). +- Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier +- Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). Par exemple, si vous voulez que le dossier racine HTML soit le sous-dossier "Web" du dossier "MyWebApp", entrez "MyWebApp/Web". @@ -580,9 +580,9 @@ Valeur de l'attribut `SameSite` du cookie de session. Cet attribut vous permet d Trois valeurs sont disponibles : - - "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. - - "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). - - "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). +- "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. +- "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). +- "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). La valeur de l'attribut `Secure` du cookie de session est automatiquement définie sur "True" si la connexion est HTTPS (quelle que soit la valeur de l'attribut `SameSite`). @@ -626,9 +626,9 @@ Dans certains cas, d'autres fonctions internes optimisées peuvent être appelé Deux options permettent de définir le mode de fonctionnement des connexions persistantes : - - **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de requêtes par connexion permet d'éviter la saturation du serveur, provoquée par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

+- **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de requêtes par connexion permet d'éviter la saturation du serveur, provoquée par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

La valeur par défaut (100) peut être augmentée ou diminuée en fonction des ressources de la machine hébergeant le serveur Web 4D.

- - **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois ce délai écoulé, le serveur ferme la connexion.

+- **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois ce délai écoulé, le serveur ferme la connexion.

Si le navigateur Web envoie une requête après la fermeture de la connexion, une nouvelle connexion TCP est automatiquement créée. Cette opération est invisible pour l'utilisateur.

diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md index 22c7a8f9e814dd..aefd09100c335e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un projet 4D peut démarrer et piloter un serveur Web pour l'application princip Par exemple, si vous avez installé deux composants dans votre application principale, vous pouvez démarrer et contrôler jusqu'à trois serveurs Web indépendants à partir de votre application : - - un serveur web pour l'application hôte, - - un serveur web pour le composant n°1, - - un serveur web pour le composant n°2. +- un serveur web pour l'application hôte, +- un serveur web pour le composant n°1, +- un serveur web pour le composant n°2. En dehors de la mémoire, il n'y a pas de limite au nombre de composants et donc, de serveurs Web, pouvant être rattachés à un seul projet d'application 4D. @@ -19,9 +19,9 @@ Chaque serveur web 4D, y compris le serveur web de l'application principale, est Chaque serveur web (application hôte ou composant) peut être utilisé dans son propre contexte, notamment : - - les appels vers la méthode base `On Web Authentication` et `On Web Connection` - - le traitement des balises 4D et les appels de méthodes, - - sessions web et gestion du protocole TLS. +- les appels vers la méthode base `On Web Authentication` et `On Web Connection` +- le traitement des balises 4D et les appels de méthodes, +- sessions web et gestion du protocole TLS. Cela vous permet de développer des composants indépendants et des fonctionnalités qui accompagnent leurs propres interfaces Web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si l'application utilise des composants et que vous souhaitez appeler : - - le serveur Web de l'application hôte à partir d'un composant ou - - le serveur qui a reçu la requête (quel que soit le serveur) +- le serveur Web de l'application hôte à partir d'un composant ou +- le serveur qui a reçu la requête (quel que soit le serveur) vous pouvez également utiliser : @@ -94,8 +94,8 @@ Ces propriétés sont définies : 2. si elles ne sont pas utilisées, à l'aide de la commande `WEB SET OPTION` (applications hôtes uniquement), 3. si elles ne sont pas utilisées, dans les propriétés de l'application hôte ou du composant. - - Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. - - Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). +- Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. +- Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion* et *perfectForwardSecrecy* sont des propriétés en lecture seule qui ne peuvent pas être prédéfinies dans le paramètre objet `settings` pour la fonction [`start()`](API/WebServerClass.md#start). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md index 7f5b5c680bfea3..d9285ee439492b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ La commande **WP Insert break** ins Dans *targetObj*, passez : - - une plage, ou - - un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou - - un document 4D Write Pro +- une plage, ou +- un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou +- un document 4D Write Pro Dans *breakType*, passez l'une des constantes suivantes du thème *4D Write Pro Constants* pour définir le type de break à insérer : @@ -62,7 +62,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio | wk prepend | Integer | 1 | Insérer le contenu au début de la cible | | wk replace | Integer | 0 | Remplacer le contenu de la cible | - - Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : +- Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : | Constante | Type | Valeur | Commentaire | | --------------------- | ------- | ------ | ------------------------------------------------------------------------------- | @@ -71,7 +71,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio Si vous ne passez pas un paramètre *rangeUpdate*, par défaut, le contenu inséré est inclus dans la plage résultante. - - Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. +- Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md index f83b3a2c602bdd..46ec6f90585fa9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandLa commande **Form** renvoie l'objet associé au formulaire courant (instancié à partir du paramètre *formData* ou de la classe utilisateur attribuée dans l'éditeur de formulaire). 4D associe automatiquement un objet au formulaire courant dans les cas suivants : - - le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), - - le formulaire courant est un sous-formulaire, - - un formulaire table est actuellement affiché à l'écran. +- le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), +- le formulaire courant est un sous-formulaire, +- un formulaire table est actuellement affiché à l'écran. ### Commandes (DIALOG...) Si le formulaire courant est affiché ou chargé par un appel aux commandes [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** renvoie soit : - - l'objet *formData* passé en paramètre à cette commande, le cas échéant, - - ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, - - ou un objet vide. +- l'objet *formData* passé en paramètre à cette commande, le cas échéant, +- ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, +- ou un objet vide. ### Sous-formulaire Si le formulaire courant est un sous-formulaire, l'objet renvoyé dépend de la variable du conteneur parent : - - **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ +- **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ Dans le contexte d'un formulaire de saisie affiché à partir d'un formulaire de sortie (c'est-à-dire après un double-clic sur un enregistrement), l'objet retourné contient la propriété suivante : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. +- Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. Pour plus d'informations, veuillez vous référer à la section *Sous-formulaires en page*. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md index 04cdda07fe40d7..92f6273caac017 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md @@ -9,43 +9,43 @@ displayed_sidebar: docs -| Paramètres | Type | | Description | -| ---------- | ------- | --------------------------- | ----------------------------------------------------------------- | -| version | Integer | → | UUID version: 4 (default) or 7 | -| Résultat | Text | ← | New UUID as non-canonical text (32 characters) | +| Paramètres | Type | | Description | +| ---------- | ------- | --------------------------- | -------------------------------------------------------------------------------- | +| version | Integer | → | Version de l'UUID : 4 (par défaut) ou 7 | +| Résultat | Text | ← | Nouvel UUID sous forme de texte non canonique (32 caractères) |
Historique -| Release | Modifications | -| ------- | ------------------------------ | -| 20 R10 | Support of *version* parameter | +| Release | Modifications | +| ------- | -------------------------------------- | +| 20 R10 | Prise en charge du paramètre *version* |
## Description -The Generate UUID returns a new 32-character UUID identifier in non-canonical form. +La fonction Generate UUID renvoie un nouvel identifiant UUID de 32 caractères sous une forme non canonique. -An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). +Un UUID est un nombre de 16 octets (128 bits). Il contient 32 caractères hexadécimaux. Il peut être exprimé soit sous forme non canonique (série de 32 lettres \[A-F, a-f\] et/ou chiffres \[0-9\], par exemple 550e8400e29b41d4a716446655440000), soit sous forme canonique (groupes de 8,4,4,4,4,12, par exemple 550e8400-e29b-41d4-a716-446655440000). -You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: +Vous pouvez utiliser le paramètre facultatif *version* pour définir la **version de l'UUID** à générer. Les valeurs suivantes sont acceptées : -- **4** (default if omitted), for fully random UUIDs -- **7**, for random and timestamp UUIDs (chronological order matches lexical order). +- **4** (par défaut si omis), pour des UUID entièrement aléatoires +- **7**, pour des UUID aléatoires et horodatés (l'ordre chronologique correspond à l'ordre lexical). :::note -For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). +Pour plus d'informations sur les UUID version 7, veuillez lire [cet article de blog](https://blog.4d.com/sort-uuids-with-version-7). ::: -In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. +Dans 4D, les numéros UUID peuvent être stockés dans des champs (voir [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190)). Une [option des Propriétés 4D](../settings/database.md#auto-uuid-version) permet de générer des UUID version 7 dans les champs automatiques. ## Exemple -Generation of a UUID in a variable: +Génération d'un UUID dans une variable : ```4d  var MyUUID : Text diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md index 457e0da1d396c5..5b553fcd1c85d3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Si l'indice du nouvel élément est au-delà du dernier élément existant de la Vous pouvez passer tout nombre de valeurs de n'importe quel type pris en charge : - - nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. - - text - - boolean - - date - - heure (stockée en nombre de milliseconds - réel) - - Null - - Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. - - *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. +- nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. +- text +- boolean +- date +- heure (stockée en nombre de milliseconds - réel) +- Null +- Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. +- *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. :::note diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md index 4b98187d7cf741..9e5f7ad5a9d05f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs Dans le paramètre *form*, vous pouvez passer soit : - - le nom d'un formulaire, - - le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou - - un objet contenant la description du formulaire à utiliser. +- le nom d'un formulaire, +- le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou +- un objet contenant la description du formulaire à utiliser. Comme **Print form** ne génère pas de saut de page après avoir imprimé un formulaire, elle vous permet de combiner facilement différents formulaires sur la même page. Ainsi, **Print form** est idéale pour effectuer des impressions complexes impliquant plusieurs tables et plusieurs formulaires. Pour forcer un saut de page entre les formulaires, utilisez la commande [PAGE BREAK](../commands-legacy/page-break.md). Pour reporter l'impression à la page suivante d'un formulaire dont la hauteur est supérieure à l'espace disponible, appelez la commande [CANCEL](../commands-legacy/cancel.md) avant la commande [PAGE BREAK](../commands-legacy/page-break.md). Trois syntaxes différentes peuvent être utilisées : - - **Impression du corps d'un formulaire** +- **Impression du corps d'un formulaire** Syntaxe : @@ -43,7 +43,7 @@ Syntaxe : Dans ce cas, **Print form** n'imprime que la zone de corps du formulaire (la zone comprise entre les marqueur d'en-tête et de corps). - - **Impression de zone de formulaire** +- **Impression de zone de formulaire** Syntaxe : @@ -79,7 +79,7 @@ Dans ce cas, la commande imprime la section désignée par *marker*. Passez dans | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impression de section** +- **Impression de section** Syntaxe : @@ -101,8 +101,8 @@ La valeur retournée par **Print form** indique la hauteur de la zone d’impres Les boîtes de dialogue standard d'impression n'apparaissent pas lorsque vous utilisez la commande **Print form**. L'état généré ne tient pas compte des paramètres d'impression définis en mode Développement pour le formulaire. Il y a deux manières de définir les paramètres d'impression avant d'effectuer une série d'appels à **Print form** : - - Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. - - Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. +- Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. +- Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. **Print form** construit chaque page à imprimer en mémoire. Chaque page est imprimée lorsque la page en mémoire est remplie ou lorsque vous appelez [PAGE BREAK](../commands-legacy/page-break.md). Pour vous assurer que la dernière page d'une impression exécutée par l'intermédiaire de **Print form** est effectivement imprimée, il faut terminer par la commande [PAGE BREAK](../commands-legacy/page-break.md) (sauf dans le cadre d'un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), voir note). Sinon, la dernière page, si elle n'est pas remplie, reste en mémoire et n'est pas imprimée. @@ -116,8 +116,8 @@ Cette commande permet d'imprimer des zones et des objets externes (par exemple, **4D Server:** Cette commande peut être exécutée sur 4D Server dans le cadre d'une procédure stockée. Dans ce contexte : - - Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). - - Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. +- Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). +- Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md index 1884e7d3fc1f52..beaa5cb365a0b5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md @@ -44,7 +44,7 @@ L'objet retourné contient les propriétés suivantes : | type | Integer | Type de process en cours d'exécution. Valeurs possibles : voir ci-dessous | | visible | Boolean | Vrai si visible, faux sinon | - - Valeurs possibles pour "state" : +- Valeurs possibles pour "state" : | Constante | Valeur | | ------------------------- | ------ | @@ -57,7 +57,7 @@ L'objet retourné contient les propriétés suivantes : | Waiting for internal flag | 4 | | Paused | 5 | - - Valeurs possibles pour "type" : +- Valeurs possibles pour "type" : | Constante | Valeur | | ----------------------------- | ------ | diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md index e6e0b844d3486f..4a89b74547e797 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Voir également +## Voir également [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md index 6087df4d15d96f..553b3374234af0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md @@ -13,8 +13,8 @@ Les pages Client-serveur regroupent les propriétés liées à l'utilisation de Cette option vous permet d'indiquer si la base de données 4D Server apparaîtra ou non dans la liste des bases de données publiées. - - Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). - - Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. +- Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). +- Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. :::note @@ -49,11 +49,11 @@ Pour mettre à jour les autres machines clientes qui ne sont pas connectées, il 4D Server utilise trois ports TCP pour les communications entre les serveurs internes et les clients : - - **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). - - **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). - - **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ +- **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). +- **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). +- **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ Notez que dans le cas d'un accès via un routeur ou un pare-feu, les ports TCP doivent être ouverts explicitement. - - [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. +- [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. #### Authentification de l'utilisateur auprès du serveur de domaine @@ -67,9 +67,9 @@ Lorsque l'authentification unique (SSO) est activée (voir ci-dessus), vous deve Cette liste déroulante contient 3 options de couche réseau : **Historique**, **ServerNet** et **QUIC** (uniquement en mode projet), qui sont utilisées pour gérer les communications entre le serveur 4D et les machines 4D distantes (clients). - - **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). - - **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. +- **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). +- **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. **Notes** : @@ -109,9 +109,9 @@ Cette option permet d'activer le mode sécurisé pour les communications entre l Ce paramètre permet de définir globalement le mode de mise à jour de l'instance locale du dossier **Resources** sur les machines 4D connectées lorsque le dossier **Resources** de la base de données est modifié en cours de session (le dossier **Ressources** est automatiquement synchronisé sur la machine distante à chaque ouverture de session). Trois paramètres sont disponibles : - - **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. - - **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ +- **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. +- **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ Le dossier **Resources** centralise les fichiers personnalisés nécessaires à l'interface de la base de données (fichiers de traduction, images, etc.). Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. ## Page Configuration IP @@ -124,10 +124,10 @@ Cette table vous permet de définir des règles de contrôle d’accès à la ba Le fonctionnement de la table de configuration est le suivant : - - La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. - - La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. - - L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. - - Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : +- La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. +- La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. +- L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. +- Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : - Refuser 192.168.\* (refuser toutes adresses débutant par 192.168) - Autoriser \* (et autoriser les autres) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md index dfe730e6c2aeea..53417de66be248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md @@ -10,10 +10,10 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants.\ > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants. Pour les options de compatibilité plus anciennes, consultez la [page Compatibilité](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) sur **doc.4d.com**. - - **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. +- **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. **Note :** Cette option peut également être gérée par programmation en utilisant la commande `SET DATABASE PARAMETER`. - - **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : +- **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : - le caractère "/" initial n'est pas seulement le noeud racine - l'utilisation du caractère / comme premier caractère d'une expression XPath ne déclare pas un chemin absolu à partir du noeud racine - pas de noeud courant implicite - le noeud courant doit être intégré dans l'expression XPath @@ -21,12 +21,12 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa Même si ces fonctionnalités ne sont pas standard, vous pourriez vouloir continuer à les utiliser afin que votre code continue de fonctionner comme avant -- dans ce cas, il vous suffit de *désélectionner* l'option. On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). +- **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). - - **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). +- **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). - - **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file +- **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/database.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/database.md index b9ab2101358f08..4348479a6feb37 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/database.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/database.md @@ -31,7 +31,7 @@ This setting only applies to UUIDs generated afterwards. Already saved auto UUID :::note -For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). +Pour plus d'informations sur les UUID version 7, veuillez lire [cet article de blog](https://blog.4d.com/sort-uuids-with-version-7). ::: @@ -45,9 +45,9 @@ L’emplacement courant de ce dossier est affiché dans la zone “Actuel :”. Trois options d’emplacement sont proposées : - - \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. - - **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. - - **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. +- \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. +- **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. +- **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -55,7 +55,7 @@ Trois options d’emplacement sont proposées : > Si vous modifiez ces options, vous devez quitter et rouvrir la base afin que la modification soit prise en compte. A la réouverture, une réindexation automatique est effectuée sur tous les index de la base. - - **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. +- **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Lorsque l’option est cochée, le caractère @ est considéré comme un simple caractère s’il se trouve au milieu d’un mot. Cette possibilité est particulièrement utile pour les bases de données stockant des adresses e-mail (qui se présentent sous la forme “nom@fournisseur.xx”). Cette option influe sur les recherches, les tris et les comparaisons de chaînes de caractères, pour les données stockées dans les tables ou en mémoire (tableaux). Sont concernés les champs alpha (indexés ou non) et texte ainsi que les variables alpha et texte. @@ -66,19 +66,19 @@ Trois options d’emplacement sont proposées : - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - Pour des raisons de sécurité, seuls l’Administrateur et le Super_Utilisateur de la base peuvent modifier ce paramètre. - - **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. +- **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. Un projet 4D peut ainsi fonctionner dans une langue différente de celle du système. A l’ouverture d’un projet, le moteur de 4D détecte la langue utilisée par le fichier de données et la fournit au langage (interpréteur ou mode compilé). Les comparaisons de texte, qu’elles soient effectuées par le moteur de base de données ou par le langage, sont donc toujours effectuées dans la même langue. > Il est possible de modifier ce paramètre dans les Préférences de l'application (voir [Page General](../Preferences/general.md)). Dans ce cas, il s'applique à toutes les nouvelles bases créées par 4D. - - \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. +- \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. Cet algorithme est semblable à celui utilisé de façon standard par les logiciels de traitement de texte pour déterminer les limites d'une sélection en cas de double-clic dans un mot. Pour plus d’informations sur cet algorithme, reportez-vous à l'adresse `http://userguide.icu-project.org/boundaryanalysis`. Lorsque cette option est cochée, 4D utilise un algorithme simplifié. Dans cette configuration, tout caractère non alphanumérique (c'est-à-dire qui n'est ni une lettre ni un chiffre) est considéré comme séparateur de mot-clé. Ce paramétrage répond à des besoins spécifiques associés à certaines langues telles que le japonais. - - **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. +- **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. #### Prise en charge de Mecab (version japonaise) @@ -96,7 +96,7 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ### Paramètres du cache pour la base - - **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. +- **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. - **Mémoire à réserver pour le système et les autres applications** : partie de la mémoire RAM à réserver au Système et aux autres applications. Cette valeur peut être augmentée à des fins d’optimisation lorsque d’autres applications consommatrices de mémoire tournent sur le même poste que 4D. - **Mémoire disponible utilisée pour le cache** : Pourcentage de la mémoire restante allouée par défaut au cache.\ @@ -112,11 +112,11 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ![](../assets/en/settings/memory-maximum-size.png) - - **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). +- **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). La taille de mémoire cache que vous saisissez sera réservée pour la base 4D, quel que soit l’état des ressources de la machine. Ce paramétrage peut être utilisé dans certaines configurations spécifiques, ou lorsque la base est destinée à fonctionner sur des systèmes disparates en termes de mémoire. Dans la plupart des cas, le cache adaptatif est plus performant. - - **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. +- **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. 4D écrit les données placées dans le cache à intervalles fixes. Vous pouvez définir tout intervalle compris entre 1 seconde et 500 minutes. Par défaut, 4D stocke vos données toutes les 20 secondes. L’application écrit aussi vos données sur disque lorsque vous changez de mode ou quittez l’application. You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. Quand vous prévoyez de saisir beaucoup de données, il est souhaitable de fixer un intervalle court. En effet, en cas de coupure de courant, vous ne perdriez que les données saisies depuis la dernière écriture (si la base fonctionne sans fichier d’historique). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md index d3b7351d3bf32d..191e92fc300c18 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md @@ -23,9 +23,9 @@ La police et la taille de police par défaut dépendent de la plate-forme d'exé D'autres options permettent de configurer l'affichage de diverses fenêtres du mode Application. - - **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. +- **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. - - **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. +- **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. :::note @@ -33,9 +33,9 @@ Vous pouvez définir la [fréquence d'écriture du cache](database.md#memory-pag ::: - - **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. +- **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. - - **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : +- **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser au nivea Les palettes suivants sont disponibles : - - **Clair**: l'application utilisera le thème clair par défaut +- **Clair**: l'application utilisera le thème clair par défaut ![](../assets/en/settings/light-appearance.png) - - **Foncé** : l'application utilisera le thème foncé par défaut +- **Foncé** : l'application utilisera le thème foncé par défaut ![](../assets/en/settings/dark-appearance.png) - - **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) +- **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) > Les thèmes par défaut peuvent être gérés par du CSS. Pour plus d'informations, veuillez consulter la section [Media Queries](../FormEditor/createStylesheet.md#media-queries). La palette d'application principale sera appliquée aux formulaires par défaut. Toutefois, elle peut être remplacée : - - par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; - - en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". +- par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; +- en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". ## Raccourcis @@ -72,9 +72,9 @@ La zone Raccourcis clavier permet d'afficher et de modifier les raccourcis clavi Les raccourcis clavier par défaut sont les suivants : - - Acceptation de saisie : **Entrée** - - Annulation de saisie : **Echap** - - Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) +- Acceptation de saisie : **Entrée** +- Annulation de saisie : **Echap** +- Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) Pour modifier le raccourci d'une opération, cliquez sur le bouton **Modifier** correspondant. La boîte de dialogue suivante apparaît : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/security.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/security.md index 42455b206c0482..84cd29f3ec95e7 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/security.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/security.md @@ -11,7 +11,7 @@ Cette page regroupe les options relatives à la protection des accès et des don > Ces paramètres ne s'appliquent pas aux bases projets ouvertes en monoposte. - - **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. +- **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. A noter que : @@ -19,21 +19,21 @@ Cette page regroupe les options relatives à la protection des accès et des don - Le Super_Utilisateur et l'Administrateur ont toujours accès à l'environnement de développement et à l'Explorateur d'exécution, même s'ils ne font pas explicitement partie du groupe d'accès spécifié. Pour plus d'information sur les utilisateurs et les groupes d'utilisateurs, veuillez vous référer au chapitre [Utilisateurs et groupes](../Users/handling_users_groups.md). - - **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. +- **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. L’intérêt de cette option est de simplifier les accès multiples à la base tout en maintenant un système complet de contrôle des données. - Si vous avez associé un mot de passe à l’utilisateur par défaut, une boîte de dialogue apparaît à l’ouverture de la base, les utilisateurs doivent uniquement saisir un mot de passe. - Si vous n'avez pas associé de mot de passe à l'Utilisateur par défaut, la boîte de dialogue d'identification de l'utilisateur ne s'affichera pas.**Note:** Vous pouvez “forcer” l'affichage de la boîte de dialogue d'identification de l'utilisateur lorsque le mode “Utilisateur par défaut” est actif, par exemple pour vous connecter en tant qu'Administrateur ou Super_Utilisateur. Pour cela, ouvrez (ou connectez-vous à) la base de données tout en maintenant la touche **Majuscule** enfoncée. - - **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **Trier la liste des utilisateurs par ordre alphabétique** (option utilisable uniquement si la précédente est cochée) : Lorsque cette option est cochée, la liste des utilisateurs dans la boîte de dialogue de saisie des mots de passe est triée par ordre alphabétique. - - **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. +- **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. ## Options - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. A l'aide des options suivantes, vous pouvez supprimer complètement ou partiellement ce filtrage. - **Activé pour tous** (par défaut) : L'accès aux commandes, fonctions et méthodes projets est limité pour tous les utilisateurs, y compris au Super Utilisateur et à l'Administrateur. - **Désactivé pour le Super Utilisateur et l'Administrateur** : Cette option accorde, uniquement au Super Utilisateur et à l'Administrateur, un accès complet aux commandes et méthodes 4D. Elle peut être utilisée pour définir un mode d'accès illimité aux commandes et méthodes tout en gardant le contrôle des actions effectuées. En phase de développement, ce mode peut être utilisé pour tester librement toutes les formules, les états, etc. En cours d'exploitation, il peut être utilisé pour mettre en oeuvre des solutions sécurisées permettant un accès temporaire à toutes les commandes et méthodes. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Cette page regroupe les options relatives à la protection des accès et des don - **Désactivé pour tous** : Cette option désactive le contrôle dans les formules. Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsqu'elle est cochée, cette commande ne fait rien. - - **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). +- **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. Lorsque cette option est cochée : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/web.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/web.md index 36890369cb56e8..a9f9f1fb9201a5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/web.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/settings/web.md @@ -82,9 +82,9 @@ Lorsque cette option est sélectionnée, le serveur Web ne fournit aucune prise Dans ce mode, vous pouvez configurer des paramètres de serveur Web supplémentaires : - - [Process Web simultanés maxi](#maximum-concurrent-web-processes) - - [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) - - [Utiliser des process préemptifs](#use-preemptive-processes) +- [Process Web simultanés maxi](#maximum-concurrent-web-processes) +- [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) +- [Utiliser des process préemptifs](#use-preemptive-processes) #### Anciennes sessions (sessions process uniques) @@ -166,9 +166,9 @@ Démarre ou arrête l'enregistrement des requêtes reçues par le serveur Web 4D Le menu de format du journal propose les options suivantes : - - **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. +- **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. - - **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ +- **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ Chaque champ est séparé par un espace et chaque ligne se termine par la séquence CR/LF (caractère 13, caractère 10). - hôte : adresse IP du client (ex. 192.100.100.10) @@ -178,9 +178,9 @@ Le menu de format du journal propose les options suivantes : > La date et heure sont locales au serveur. - - requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) - - statut : réponse donnée par le serveur. - - longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. +- requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) +- statut : réponse donnée par le serveur. +- longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. > **Note :** Pour des raisons de performances, les opération sont stockées dans une mémoire tampon par paquets de 1 Ko avant d'être écrites sur disque. Les opérations sont également écrites sur disque si aucune requête n'a été envoyée au bout de 5 secondes. > Les valeurs possibles de l'état sont les suivantes : @@ -194,16 +194,16 @@ Le menu de format du journal propose les options suivantes : > 500 : Erreur interne > Le format CLF ne peut pas être personnalisé. - - **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. +- **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. - Referer : contient l’URL de la page pointant vers le document demandé. - User-agent : contient le nom et la version du navigateur ou du logiciel client à l’origine de la requête. > Le format DLF ne peut pas être personnalisé. - - **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. +- **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. - - **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. +- **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. **Configurer les champs** Lorsque vous choisissez le format ELF (Extended Log Format) ou WLF (WebStar Log Format), la zone “Formatage du journal” affiche les champs disponibles pour le format. Vous devrez sélectionner chaque champ à inclure dans le journal. Pour cela, utilisez les flèches de commande ou procédez par glisser-déposer. @@ -242,14 +242,14 @@ Le tableau suivant répertorie les champs disponibles pour chaque format (par or Paramètres d’archivage automatique du journal des requêtes. D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. > En cas de sauvegarde périodique, si le serveur Web n’était pas lancé au moment théorique de la sauvegarde, 4D considère au lancement suivant que la sauvegarde a échoué et applique les paramétrages adéquats, définis dans les Propriétés. @@ -263,9 +263,9 @@ Pour plus d'informations sur la prise en charge des services Web dans 4D, veuill Cette zone affiche les options relatives à l’utilisation de 4D en tant que “serveur” de Web Services, c’est-à-dire publiant des méthodes projet sous forme de Web Services. - - **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. - - **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. - - **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. +- **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. +- **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. +- **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. > Conformément à la norme XML concernant les noms de balises, la chaîne de caractères utilisée ne doit pas contenir d’espaces ni débuter par un chiffre. En outre, pour éviter tout risque d’incompatibilité, il est recommandé de ne pas utiliser de caractères étendus (tels que des caractères accentués). @@ -273,7 +273,7 @@ Cette zone affiche les options relatives à l’utilisation de 4D en tant que Cette zone contient une option relative à l’utilisation de 4D en tant que “client” de Web Services, c’est-à-dire souscrivant à des services publiés sur le réseau. - - **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. +- **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. ## Fonctionnalités Web @@ -307,9 +307,9 @@ Ce bouton est uniquement disponible dans les projets ouverts avec l'application Le bouton déclenche la séquence de mise à niveau suivante : - - Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. - - La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). - - Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. +- Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. +- La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). +- Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. N'oubliez pas de redémarrer votre projet après avoir effectué cette mise à niveau. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md index b1b0365605edcc..9d1cb639f79189 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md @@ -160,8 +160,8 @@ Vous pouvez passer un ou plusieurs paramètres optionnels *param*, qui seront pa :::note Notes - - Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. - - Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. +- Si `.new()` est appelé sur une [classe singleton](../Concepts/classes.md#singleton-classes) qui a déjà été instanciée, l'instance singleton est retournée, et non une nouvelle instance. +- Si `.new()` est appelé sur une classe inexistante, une erreur est retournée. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/Document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/Document.md index e5c0997f07ca47..f026e9fde75c7c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/Document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/Document.md @@ -320,8 +320,8 @@ Cette propriété est en **lecture seule**. La propriété `.original` renvoie l'élément cible d'un fichier alias, d'un raccourci ou d'un lien symbolique. L'élément cible peut être : - - un objet File - - un objet Folder +- un objet File +- un objet Folder Pour les fichiers sans alias, la propriété retourne le même objet File que le fichier. @@ -585,8 +585,8 @@ La fonction `.getText()` retourne le con Optionnellement, vous pouvez indiquer le jeu de caractères à utiliser pour la lecture du contenu. Vous pouvez passer soit : - - dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), - - ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. +- dans *charSetName*, une chaîne contenant le nom de jeu standard (par exemple "ISO-8859-1" ou "UTF-8"), +- ou dans *charSetNum*, l'ID MIBEnum (numéro) du nom du jeu standard. > Pour consulter la liste des jeux de caractères pris en charge par 4D, veuillez vous reporter à la description de la commande `CONVERT FROM TEXT`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md index b7e2d6073fd621..ce7f23754c5200 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Un objet 4D.OutgoingMessage est [non partageable](../Concepts/shared.md). La propriété `.body` contient le body du message sortant. Les types de données suivants sont pris en charge dans la propriété `.body` : - - text - - blob - - object - - image +- text +- blob +- object +- image La propriété `.body` est en lecture-écriture. @@ -108,17 +108,17 @@ La fonction `.setBody()` dé Les types de données suivants sont pris en charge dans la propriété *body* : - - Text - - Blob - - Object - - Image +- Text +- Blob +- Object +- Image Lorsque cette fonction est utilisée, le header content-type est automatiquement défini en fonction du type de *body* : - - Content-Type:text/plain si le body est un texte - - Content-Type:application/octet-stream si le body est un Blob - - Content-Type:application/json si le body est un objet - - Content-Type:image/jpeg, image/gif... si le body est une image +- Content-Type:text/plain si le body est un texte +- Content-Type:application/octet-stream si le body est un Blob +- Content-Type:application/json si le body est un objet +- Content-Type:image/jpeg, image/gif... si le body est une image Si *body* n'est pas un type de valeur pris en charge, une erreur est renvoyée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md index 325787d945631f..098475b2abbeec 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ La propriété `.keepAlive` contient diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md index 4e72b1fa295c2c..7ac3c3c2823db9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Les objets de session sont retournés par la commande [`Session`](../commands/session.md). Ces objets fournissent au développeur une interface permettant de gérer la session utilisateur courante et d'exécuter des actions telles que le stockage de données contextuelles, le partage d'informations entre les process de la session, le lancement de process préemptifs liés à la session ou (uniquement pour le web) la gestion des [privilèges](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Types de sessions Les types de sessions suivants sont pris en charge par cette classe : @@ -38,11 +47,6 @@ La disponibilité des propriétés et des fonctions de l'objet `Session` dépend | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md index 3d92f3b48c546e..d16c4e85d76af2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md @@ -55,8 +55,8 @@ La fonction `.disableState()` d Cette fonction ne fait rien si : - - l'*état* n'est actuellement pas activé dans le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* n'est actuellement pas activé dans le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous [activez](#enablestate) ou désactivez plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. @@ -80,8 +80,8 @@ La fonction `.enableState()` act Cette fonction ne fait rien si : - - l'*état* a déjà été activé sur le formulaire web, - - l'*état* n'existe pas pour le formulaire web. +- l'*état* a déjà été activé sur le formulaire web, +- l'*état* n'existe pas pour le formulaire web. Si vous activez ou [désactivez](#disablestate) plusieurs états dans la même fonction utilisateur, toutes les modifications sont envoyées en même temps au client une fois que la fonction se termine. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md index e8b5a0245406bc..97ee1a22f9519e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md @@ -86,8 +86,8 @@ La fonction `4D.WebSocket.new()` crée e Dans *url*, indiquez l'URL à laquelle le serveur WebSocket répondra. Les modèles d'URL suivants peuvent être utilisés : - - `ws://host[:port]path[?query]` pour les connexions standard - - `wss://host[:port]path[?query]` pour les connexions TLS sécurisées +- `ws://host[:port]path[?query]` pour les connexions standard +- `wss://host[:port]path[?query]` pour les connexions TLS sécurisées Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur est générée (que vous pouvez intercepter à l'aide d'une méthode installée avec `ON ERR CALL`). @@ -95,8 +95,8 @@ Si la connexion n'est pas possible, un objet `null` est renvoyé et une erreur e Dans *connectionHandler*, vous pouvez transmettre un objet contenant des fonctions de callback à appeler selon les événements de connexion, ainsi que le type de données et les en-têtes à gérer. - - Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. - - La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. +- Les callbacks sont automatiquement appelées dans le contexte du formulaire ou du worker qui initie la connexion. +- La WebSocket reste valide tant que le formulaire ou le worker n'est pas fermé. | Propriété | Type | Description | | ----------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ La fonction `.terminate()` refer Dans *code*, vous pouvez passer un code d'état expliquant pourquoi la connexion est fermée (voir aussi [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)) : - - S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. - - Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. +- S'il n'est pas spécifié, le code de fermeture de la connexion est automatiquement fixé à 1000 pour une fermeture normale, ou à une autre valeur standard dans la plage 1001-1015 qui indique la raison réelle de la fermeture de la connexion. +- Si elle est spécifiée, la valeur de ce paramètre de code remplace le réglage automatique. La valeur doit être un nombre entier. Soit 1000, soit un code personnalisé compris entre 3000 et 4999. Si vous spécifiez la valeur du \*code \* , vous devez également spécifier une *reason*. Dans *reason*, vous pouvez passer une chaîne de caractères décrivant la raison pour laquelle la connexion est fermée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md index aca94359426e7e..f9e929fbc81107 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Voir également [cet article de blog](https://blog.4d.com/new-built-in-websocket Pour créer et gérer votre serveur WebSocket dans 4D, vous devrez utiliser deux classes intégrées à 4D : - - cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, - - la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. +- cette classe (`4D.WebSocketServer`) pour gérer le serveur lui-même, +- la classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) pour gérer les connexions et les messages. De plus, vous devrez créer deux classes utilisateurs qui contiendront les fonctions de callback : - - une classe utilisateur pour gérer les connexions serveur, - - une classe utilisateur pour gérer les messages. +- une classe utilisateur pour gérer les connexions serveur, +- une classe utilisateur pour gérer les messages. Vous devez [créer le serveur WebSocket](#4dwebsocketservernew) dans un [worker](../Develop/processes.md#worker-processes) pour maintenir la connexion en vie. @@ -387,8 +387,8 @@ Par défaut, si aucune valeur *timeout* n'est définie, la fonction initialise l Si une valeur *timeout* est définie : - - lorsque le temps d'attente est atteint, détruit de force la socket. - - si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. +- lorsque le temps d'attente est atteint, détruit de force la socket. +- si *timeout* = 0, détruit de force la socket sans trame de fermeture ni d'échange de paquets FIN, et le fait instantanément sans délai d'attente. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md index 3c407cc2d8f7ab..87bace3ccb1808 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md @@ -17,7 +17,7 @@ Par défaut, le serveur web `WebAdmin` ne démarre pas automatiquement. Il faut Vous pouvez configurer le server web `WebAdmin` pour qu'il se lance au démarrage de 4D ou 4D Server (avant l'ouverture d'un projet). - - Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. +- Si vous utilisez une application 4D avec une interface, sélectionnez **Fichier > Administration Web > Propriétés...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Cochez l'option **Lancer le serveur WebAdmin au démarrage** dans la boîte de d ![alt-text](../assets/en/Admin/waSettings.png) - - Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : +- Que vous utilisiez une application 4D avec ou sans interface, vous pouvez activer le lancement automatique au démarrage en utilisant l'argument suivant dans *L'interface de ligne de commande* : ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Quand cette option est cochée, il est possible de se connecter au serveur `WebA **Notes :** - - Les connections HTTP autres que sur localhost ne sont jamais acceptées. - - Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. +- Les connections HTTP autres que sur localhost ne sont jamais acceptées. +- Même si cette option est activée, quand [HTTPS Accepté](#accept-https) est activé et que la configuration TLS est valide, les connections sur localhost se font via HTTPS. #### Port HTTP @@ -94,11 +94,11 @@ Chemin du dossier qui contient les fichiers de certificat TLS. Par défaut, le c Statut ou format du fichier de logs des requêtes HTTP (HTTPDebugLog_*nn*.txt, stocké dans le dossier "Logs" de l'application. --*nn* représente le numéro du fichier). Les options suivantes sont disponibles : - - **Désactivé** (valeur par défaut) - - **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses - - **Sans les body** - activé sans les parts des body (la taille du body est indiquée) - - **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes - - **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses +- **Désactivé** (valeur par défaut) +- **Avec tous les body** - activé avec toutes les parts des body des requêtes et réponses +- **Sans les body** - activé sans les parts des body (la taille du body est indiquée) +- **Avec les body des requêtes** - activé avec les parts des body uniquement dans les requêtes +- **Avec la réponse corps** - activé avec les parts des body uniquement dans les réponses #### Clé d'accès @@ -108,9 +108,9 @@ La configuration d'une clé d'accès est obligatoire pour débloquer l'accès au Une clé d'accès est similaire à un mot de passe, mais sans login associé. - - Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. - - Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. - - Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. +- Pour définir une nouvelle clé d'accès, cliquez sur le bouton **Définir**, entrez une chaîne de caractères et cliquez sur **OK**. Une fois fait, le label du bouton devient **Modifier**. +- Pour modifier la clé d'accès, cliquez sur **Modifier**, entrez la nouvelle clé d'accès et cliquez sur **OK**. +- Pour supprimer la clé d'accès, cliquez sur **Modifier**, laissez le champ d'entrée vide et cliquez sur **OK**. #### Activer l'accès à Qodly Studio @@ -145,9 +145,9 @@ Voici un exemple : ## Authentification et Session - - Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. +- Lorsqu'on accède à une page de gestion web en entrant une URL et sans identification préalable, une authentification est nécessaire. L'utilisateur doit entrer la [clé d'accès](#access-key) dans une fenêtre d'authentification. Si aucune clé d'accès n'a été définie dans les propriétés `WebAdmin`, aucun accès via URL n'est possible. - - Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. +- Qand une page d'administration web est ouverte directement depuis un menu 4D ou 4D Server, tel que **Enregistrements> Data Explorer**ou**Fenêtre> Explorateur de données**(4D Server), l'accès est autorisé sans authentification. Une fois l'accès autorisé, une [session web](WebServer/sessions.md) est créée avec les privilèges "WebAdmin" sur l'application 4D. Tant que la session courante a le privilège "WebAdmin", le composant `WebAdmin` sert les pages demandées dans les requêtes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md index afa6d06b767f25..67abbc73dc2080 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md @@ -5,12 +5,12 @@ title: Restitution 4D vous permet de récupérer l’intégralité des données d’une application en cas d’incident, quelles que soient ses causes. Deux catégories principales d’incidents peuvent se produire : - - L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : +- L’arrêt inopiné de l'application pendant son exploitation. Cet incident peut se produire à cause d’une coupure de courant, la panne d’un élément du système, etc. Dans ce cas, en fonction de l’état courant du cache de données au moment de l’incident, la récupération de l'application peut nécessiter différentes opérations : - Si le cache était vide, l'application s’ouvre normalement. Toutes les modifications apportées à l'application ont été enregistrées. Ce cas ne nécessite aucune opération particulière. - Si le cache contenait des opérations, le fichier de données est intact mais il est nécessaire d’intégrer le fichier d’historique courant. - Si le cache était en cours d’écriture, le fichier de données est probablement endommagé. Il est nécessaire de restituer la dernière sauvegarde et d’intégrer le fichier d’historique courant. - - La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. +- La perte de fichier(s) de l'application. Cet incident peut être causé par des secteurs défectueux sur le disque contenant l'application, un virus, une erreur de manipulation, etc. Il est nécessaire de restituer la dernière sauvegarde puis d’intégrer éventuellement l’historique courant. Pour savoir si une application a été endommagée à la suite d’un incident, il suffit de la relancer avec 4D. Le programme effectue un auto-diagnostic et précise les opérations de réparation à effectuer. En mode automatique, ces opérations sont effectuées directement, sans intervention de l’utilisateur. Si une stratégie de sauvegarde régulière a été mise en place, les outils de récupération de 4D vous permettront (dans la plupart des cas) de retrouver l'application dans l’état exact où elle se trouvait avant l’incident. > 4D peut lancer automatiquement des procédures de récupération des applications après incident. Ces mécanismes sont gérés à l’aide de deux options accessibles dans la Page **Sauvegarde/Sauvegarde & et Restitution** de la fenêtre des Propriétés. Pour plus d'informations, reportez-vous au paragraphe [Restitution automatique](settings.md#automatic-restore-and-log-integration).\ > Si l'incident résulte d'une opération inappropriée effectuée sur les données (suppression d'un enregistrement par exemple), vous pouvez tenter de réparer le fichier de données à l'aide de la fonction "rollback" du fichier d'historique.\ diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md index 34d711987f2faa..b74890eeed329a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md @@ -5,9 +5,9 @@ title: Paramètres de sauvegarde Les paramètres de sauvegarde sont définis sur trois pages dans la [boîte de dialogue des Paramètres](../settings/overview.md). Vous pouvez définir : - - la périodicité des sauvegardes automatiques - - les fichiers à inclure dans chaque sauvegarde - - les fonctionnalités avancées permettant d'exécuter des tâches automatiques +- la périodicité des sauvegardes automatiques +- les fichiers à inclure dans chaque sauvegarde +- les fonctionnalités avancées permettant d'exécuter des tâches automatiques > Les propriétés définies dans cette boîte de dialogue sont écrits dans le fichier *Backup.4DSettings*, stocké dans le [dossier Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ Les paramètres des sauvegardes périodiques sont définis dans la Page **Sauveg Les options regroupées dans cet onglet permettent de définir et de paramétrer des sauvegardes périodiques automatiques de l'application. Vous pouvez choisir un paramétrage standard rapide ou personnaliser entièrement la périodicité. Diverses options apparaissent en fonction de la valeur définie dans le menu **Sauvegarde automatique** : - - **Jamais** : la fonction de sauvegarde périodique est inactivée. - - **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. - - **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. - - **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. - - **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : +- **Jamais** : la fonction de sauvegarde périodique est inactivée. +- **Toutes les heures** : programme une sauvegarde automatique par heure, à partir de la prochaine heure. +- **Toutes les semaines** : programme une sauvegarde automatique par semaine. Une zone de saisie vous permet d'indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour et l'heure de la sauvegarde. +- **Tous les mois** : programme une sauvegarde automatique par mois. Deux zones de saisie supplémentaires vous permettent d'indiquer le jour du mois et l'heure de la sauvegarde. +- **Personnalisée** : permet de configurer des sauvegardes périodiques "sur-mesure". Lorsque vous sélectionnez cette, plusieurs zones de saisie supplémentaires apparaissent : - **Toutes les N heure(s)** : permet de programmer des sauvegardes sur une base horaire. Vous pouvez saisir une valeur comprise entre 1 et 24. * **Tous les jours** : programme une sauvegarde automatique par jour. Saisissez par exemple 1 si vous souhaitez une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. * **Toutes les N semaine(s), jour à N** : permet de programmer des sauvegardes sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jour(s) de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. @@ -48,12 +48,12 @@ La Page Sauvegarde/Configuration des Propriétés permet de désigner les fichie Cette zone permet de désigner les fichiers et/ou dossiers à copier lors de la prochaine sauvegarde. - - **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : +- **Data** : fichier de données de l'application. Lorsque cette option est cochée, les éléments suivants sont automatiquement sauvegardés en même temps que les données : - le fichier journal courant de l'application (le cas échéant), - le dossier `Settings` complet situé [à côté du fichier de données](../Project/architecture.md#settings-user-data) (le cas échéant), c'est-à-dire *les paramètres utilisateur pour les données*. - - **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. - - **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* - - **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. +- **Structure** : fichiers et dossiers du projet d'application. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. Dans le cas de projets compilés, cette option permet de sauvegarder le fichier .4dz. +- **Fichier de structure utilisateur (uniquement pour les bases binaires)** : *fonctionnalité obsolète* +- **Attachments** : cette zone permet de désigner un ensemble de fichiers et/ou de dossiers à sauvegarder en même temps que l'application. Ces fichiers peuvent être de tout type (documents ou modèles de plug-ins, étiquettes, états, images, etc.). Vous pouvez désigner soit des fichiers individuels, soit des dossiers dont le contenu sera intégralement sauvegardé. Chaque élément joint est listé avec son chemin d’accès complet dans la zone “Fichiers joints”. - **Supprimer** : retire de la liste des fichiers joints l’élément sélectionné. - Gestion du fichier d'historique En cas de restitution, le dossier sera récupéré avec sa structure interne. Vous pouvez désigner tout dossier ou volume connecté au poste, à l’exception du dossier contenant les fichiers de l'application. - **Ajouter fichier...** : affiche une boîte de dialogue permettant de sélectionner un fichier à joindre à la sauvegarde. @@ -82,19 +82,19 @@ La modification des options de sauvegarde et de restauration est facultative. Le ### Paramètres généraux - - **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). +- **Conserver uniquement les N derniers fichiers de sauvegarde** : ce paramètre permet d’activer et de configurer le mécanisme de suppression des fichiers de sauvegarde les plus anciens, afin d’éviter tout risque de saturation du volume. Le principe de fonctionnement est le suivant : après avoir terminé la sauvegarde courante, 4D efface l’archive la plus ancienne si celle-ci est localisée au même endroit que l’archive à sauvegarder et porte le même nom (vous pouvez, pour des raisons d’économie de place, demander que l’archive la plus ancienne soit effacée avant la sauvegarde). Si, par exemple, le nombre de jeux est fixé à 3, les trois premières sauvegardes créent successivement les archives MaBase-0001, MaBase-0002 et MaBase-0003. Lors de la quatrième sauvegarde, l’archive MaBase-0004 est créée alors que l’archive MaBase-0001 est supprimée. Par défaut, le mécanisme de suppression des jeux est activé et 4D conserve 3 jeux de sauvegarde. Pour ne pas activer le mécanisme, désélectionnez l’option. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. +- **Sauvegarder uniquement si le fichier de données a été modifié** : lorsque cette option est cochée, 4D déclenche les sauvegardes périodiques uniquement si des données ont été ajoutées, modifiées ou supprimées depuis la dernière sauvegarde. Dans le cas contraire, la sauvegarde prévue est annulée et reportée à l’échéance suivante. Aucune erreur n’est générée ; le report est toutefois indiqué dans le Journal des sauvegardes. Cette option permet notamment d’économiser du temps machine sur la sauvegarde d'applications principalement utilisées en consultation. A noter qu'elle ne prend pas en compte les éventuelles modifications apportées au fichier de structure ou aux fichiers joints. > Ce paramètre concerne à la fois les sauvegardes de l'application et les sauvegardes de l’historique. - - **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. +- **Effacer la sauvegarde la plus ancienne avant sauvegarde / après sauvegarde** : cette option n’est utilisée que si l’option “Conserver uniquement les N derniers fichiers de sauvegarde” est cochée. Elle vous permet de spécifier si 4D doit commencer par effacer l’archive la plus ancienne avant d’effectuer une sauvegarde (option **avant**) ou si l’effacement doit être effectué après la sauvegarde (option **après**). Pour que ce mécanisme fonctionne, l’archive la plus ancienne ne doit pas avoir été renommée ou déplacée. - - **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. +- **Si la sauvegarde échoue** : cette option permet de définir le mécanisme de prise en charge des échecs des sauvegardes (sauvegarde impossible). Lorsqu’une sauvegarde est impossible, 4D permet d’effectuer une nouvelle tentative. - Périodicité Elle revient à annuler la sauvegarde ayant échoué. Une erreur est générée. - **Réessayer dans N seconde(s), minute(s) ou heure(s)** : lorsque cette option est cochée, une nouvelle tentative de sauvegarde est effectuée à l’issue du délai défini. Ce mécanisme permet d’anticiper certaines circonstances bloquant la sauvegarde. Vous pouvez fixer un délai en secondes, minutes ou heures à l’aide du menu correspondant. Si la nouvelle tentative échoue également, une erreur est générée et l’échec est inscrit dans les zones de statut de la dernière sauvegarde et dans le Journal des sauvegardes. - **Annuler l’opération au bout de N tentatives** : ce paramètre permet de définir le nombre de fois que le module de sauvegarde réessaiera de lancer la sauvegarde en cas d’échec. Si, à l’issue du nombre d’essais défini, la sauvegarde n’a pas pu être effectuée, elle est annulée et l’erreur 1401 est générée (“Le nombre maximal de tentatives de sauvegarde est atteint, la sauvegarde automatique est temporairement désactivée”). Dans ce cas, aucune nouvelle sauvegarde automatique ne sera lancée tant que l’application n’aura pas été redémarrée ou qu’une sauvegarde manuelle n’aura été effectuée avec succès. @@ -106,15 +106,15 @@ La modification des options de sauvegarde et de restauration est facultative. Le Ces options s’appliquent aux fichiers de sauvegarde principaux et aux fichiers de sauvegarde de l’historique. - - **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. +- **Segment Size (Mb)** 4D allows you to segment archives, i.e., to cut it up into smaller sizes. Ce fonctionnement permet par exemple de stocker une sauvegarde sur plusieurs volumes (DVDs, usb, etc.). Au moment de la restitution, 4D fusionnera automatiquement les segments. Chaque segment est appelé MonApplication[xxxx-yyyy].4BK, où xxxx représente le numéro de la sauvegarde et yyyy celui du segment. Par exemple, les trois segments de la sixième sauvegarde de la base MonApplication seront appelés MonApplication[0006-0001].4BK, MonApplication[0006-0002].4BK et MonApplication[0006-0003].4BK. Le menu **Taille du segment** est une combo box permettant de définir la taille en Mo de chaque segment de sauvegarde. Vous pouvez choisir une des tailles prédéfinies ou saisir une taille spécifique entre 0 et 2048. Si vous passez 0, aucune segmentation n’est effectuée (équivaut à la valeur **Aucune**). - - **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. +- **Compression Rate** By default, 4D compresses backups to help save disk space. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. En contrepartie, la phase de compression des fichiers peut ralentir sensiblement les sauvegardes dans le cas de la manipulation de gros volumes de données. - **Aucun** : aucune compression n’est appliquée. La sauvegarde peut être sensiblement plus rapide mais les fichiers d’archives sont plus volumineux sur le disque. - **Normal** (par défaut) : cette option constitue un compromis vitesse de sauvegarde/taille des archives. - **Elevé** : le taux de compression maximal est appliqué aux archives. Les fichiers d’archives prennent le moins de place possible sur le disque mais la sauvegarde peut être sensiblement ralentie. - - **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). +- **Taux d’entrelacement et Taux de redondance** 4D peut générer des archives à l’aide d’algorithmes spécifiques, basés sur des mécanismes d’optimisation (entrelacement) et de sécurisation (redondance). Vous pouvez paramétrer ces mécanismes en fonction de vos besoins. Les menus associés à ces options vous permettent de choisir un taux **Faible**, **Moyen**, **Elevé** ou **Aucun** (défaut). - **Taux d’entrelacement** : l’entrelacement consiste à stocker les données dans des secteurs non contigus afin de limiter les risques en cas d’endommagement des secteurs. Plus le taux est élevé, plus la sécurité est élevée ; en contrepartie, le traitement des données consomme davantage de mémoire. - **Taux de redondance** : la redondance permet de sécuriser les données présentes dans un fichier en répétant plusieurs fois les mêmes informations. Plus le taux est élevé, plus le fichier est sécurisé, mais plus le stockage est lent et la taille du fichier importante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md index d589041c258de8..82e97a3608a5d2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md @@ -11,8 +11,8 @@ Le langage 4D prend en charge les opérateurs que vous connaissez peut-être dé Le langage 4D prend en charge les opérateurs **binaires** et **ternaires** : - - les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. - - les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). +- les opérateurs binaires opèrent sur deux cibles (comme `2 + 3`) et apparaissent entre leurs deux cibles. +- les opérateurs ternaires opèrent sur trois cibles. Comme le C, 4D ne possède qu'un seul opérateur ternaire, [l'opérateur conditionnel ternaire](#ternary-operator) (`a ? b : c`). Les valeurs que les opérateurs affectent sont des opérandes. Dans l'expression `1 + 2`, le symbole + est un opérateur binaire et ses deux opérandes sont les valeurs 1 et 2. @@ -33,18 +33,18 @@ $col:=New collection //$col est initialisé avec une collection vide Les résultats des opérateurs dépendent des **types de données** auxquels ils sont appliqués. Ils sont décrits avec les types de données, dans les sections suivantes : - - [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) - - [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) - - [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) - - [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) - - [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) - - [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) - - [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) - - [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) - - [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) - - [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) - - [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) - - [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) +- [**Opérateurs logiques**](dt_boolean.md#operateurs-logiques) (sur les expressions de type **booléen**) +- [**Opérateurs sur les dates**](dt_date.md#operateurs-sur-les-dates) +- [**Opérateurs sur les heures**](dt_time.md#operateurs-sur-les-heures) +- [**Opérateurs sur les nombres**](dt_number.md#operateurs-sur-les-nombres) +- [**Opérateurs sur les bits**](dt_number.md#operateurs-sur-les-bits) (sur les expressions de type **entier long**) +- [**Opérateurs sur les images**](dt_picture.md#operateurs-sur-les-images) +- [**Opérateurs sur les pointeurs**](dt_pointer.md#operateurs-sur-les-pointeurs) +- [**Opérateurs sur les chaînes**](dt_string.md#operateurs-sur-les-chaines) +- [**Opérateurs sur les références d'objets**](dt_object.md#operateurs-sur-les-objets) +- [**Opérateurs sur les références de collections**](dt_collection.md#operateurs-sur-les-collections) +- [**Opérateurs sur les Null**](dt_null_undefined.md#operateurs-sur-les-null) +- [**Opérateurs sur les Undefined**](dt_null_undefined.md#operateurs-sur-les-undefined) ## Opérateurs d'affectation composés @@ -272,9 +272,9 @@ L'opérateur conditionnel ternaire vous permet d'écrire des expressions conditi Il prend trois opérandes dans l'ordre suivant : - - une condition suivie d'un point d'interrogation (?) - - une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) - - une expression à exécuter si la condition est [falsy](#truthy-and-falsy) +- une condition suivie d'un point d'interrogation (?) +- une expression à exécuter si la condition est [truthy](#truthy-and-falsy), suivie de deux points (:) +- une expression à exécuter si la condition est [falsy](#truthy-and-falsy) ### Syntaxe @@ -325,21 +325,21 @@ En plus d'un type, chaque valeur possède également une valeur booléenne inhé Les valeurs suivantes sont **falsy**: - - false - - Null - - undefined - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Chaînes vides - - [] - Collections vides - - {} - Objets vides +- false +- Null +- undefined +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Chaînes vides +- [] - Collections vides +- {} - Objets vides Toutes les autres valeurs sont considérées comme **truthy**, notamment : - - 0 - zéro numérique (Entier ou autre) +- 0 - zéro numérique (Entier ou autre) Dans 4D, l'évaluation à **truthy** et **falsy** reflète la **possibilité d'utilisation** d'une valeur, ce qui signifie qu'une valeur truthy existe et peut être traitée par le code sans générer d'erreurs ou de résultats inattendus. L'objectif est de fournir un moyen pratique de gérer les valeurs *undefined* et *null* dans les objets et les collections, de sorte qu'un nombre réduit d'instructions [If…Else](flow-control.md#ifelseend-if) soit nécessaire pour éviter les erreurs d'exécut diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md index e88a916f5bb4f2..a1b7c382575f99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md @@ -53,8 +53,8 @@ Cette syntaxe ne prend en charge que les déclarations de [variables locales et `varType` peut être : - - un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, - - une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. +- un [type basique](Concepts/data-types.md), auquel cas la variable contient une valeur du type déclaré, +- une [référence de classe](Concepts/classes.md) (classe 4D ou classe utilisateur), auquel cas la variable contient une référence à un objet de la classe définie. Si `varType` est omis, une variable de type **variant** est créée. @@ -86,7 +86,7 @@ L'ancienne syntaxe utilisant les commandes `C_XXX` est obsolète à partir de la ### Exemples - - Pour déclarer les variables locales et les variables process basiques : +- Pour déclarer les variables locales et les variables process basiques : ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D.Object //également équivalent à C_OBJECT($o) ``` - - Pour déclarer les variables objet de classe 4D : +- Pour déclarer les variables objet de classe 4D : ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - Pour déclarer les variables objet de classe utilisateur : +- Pour déclarer les variables objet de classe utilisateur : ```4d var $myClass : cs.MyClass @@ -193,9 +193,9 @@ Une variable locale, comme son nom l’indique, est locale à une méthode — c Vous pouvez choisir d'utiliser une variable locale pour : - - Eviter des conflits de noms avec les autres variables - - Utiliser temporairement des valeurs, - - Réduire le nombre de variables process +- Eviter des conflits de noms avec les autres variables +- Utiliser temporairement des valeurs, +- Réduire le nombre de variables process Le nom d’une variable locale commence toujours par le signe dollar ($) et peut contenir jusqu’à 31 autres caractères. Si vous saisissez un nom plus long, 4D le tronque pour le ramener à 31 caractères. @@ -224,9 +224,9 @@ En mode interprété, les variables sont gérées dynamiquement; elles sont cré Un process peut lire et écrire des variables process dans un autre process à l'aide des commandes `GET PROCESS VARIABLE` et `SET PROCESS VARIABLE`. Nous vous recommandons de n'utiliser ces commandes que dans le cadre des besoins décrits ci-dessous (qui sont les raisons pour lesquelles ces commandes ont été créées dans 4D) : - - Communication interprocess à des endroits particuliers de votre code - - Gestion du glisser-déposer interprocess - - En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur +- Communication interprocess à des endroits particuliers de votre code +- Gestion du glisser-déposer interprocess +- En client/serveur, communication entre les process sur les postes clients et les procédures stockées exécutées sur le serveur Pour plus d'informations, consultez le chapitre **Process** et la description de ces commandes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md index 450585e371221c..94977872be4248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md @@ -33,13 +33,13 @@ Il peut arriver que la mémoire soit insuffisante pour créer une BLOB. Ou, lors Ce sont généralement les types d'erreurs les plus difficiles à trouver. À l'exception des erreurs de frappe, tous les types d'erreurs énumérés ci-dessus sont, dans une certaine mesure, couverts par l'expression "erreur de conception ou de logique". Utilisez le [débogueur](debugger.md) pour les détecter. Par exemple : - - Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. - - Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. +- Une *erreur de syntaxe* peut se produire lorsque vous essayez d'utiliser une variable qui n'est pas encore initialisée. +- Une *erreur au niveau de l'Environnement* peut se produire lorsque vous essayez d'ouvrir un document, parce que le nom de ce document est reçu par une sous-routine qui n'a pas obtenu la bonne valeur comme paramètre. Les erreurs de conception ou de logique comprennent également des situations telles que : - - Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. - - Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. +- Un enregistrement n'est pas correctement mis à jour parce que, en appelant `SAVE RECORD`, vous avez oublié de tester d'abord si l'enregistrement était verrouillé ou non. +- Une méthode ne fait pas exactement ce que vous attendez, car la présence d'un paramètre facultatif n'est pas testée. Parfois, le morceau de code qui affiche l'erreur peut être différent du code qui est en fait à l'origine du problème. @@ -55,8 +55,8 @@ Pour trouver rapidement l'origine du problème, rouvrez la version interprétée La fenêtre d'erreur de syntaxe apparaît automatiquement lorsque l'exécution d'une méthode est interrompue. Cela peut se produire lorsque : - - une erreur empêche la poursuite de l'exécution du code - - la méthode produit une fausse assertion (voir la commande `ASSERT`) +- une erreur empêche la poursuite de l'exécution du code +- la méthode produit une fausse assertion (voir la commande `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ La zone de texte supérieure affiche un message décrivant l'erreur. La zone de La fenêtre d'erreur de syntaxe propose plusieurs options : - - **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. +- **Modifier** : arrête l'exécution de toutes les méthodes. 4D bascule en mode Développement et la méthode comportant l'erreur s'ouvre dans l'éditeur de code, ce qui vous permet de la corriger. Utilisez cette option lorsque vous reconnaissez immédiatement l'erreur et que vous pouvez la corriger sans autre forme de procès. - - **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. +- **Trace** : Accède au mode Trace/Debugger. La fenêtre du [débogueur](debugger.md) s'affiche. Si la ligne en cours n'a été exécutée que partiellement, vous devrez peut-être cliquer plusieurs fois sur le bouton **Trace**. - - **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. +- **Continuer** : L'exécution se poursuit. La ligne contenant l'erreur peut être partiellement exécutée, selon l'endroit où se trouve l'erreur. Continuez avec prudence : l'erreur peut empêcher le reste de votre méthode de s'exécuter correctement. Nous vous recommandons de cliquer sur **Continuer** uniquement si l'erreur se trouve dans un appel trivial (tel que `SET WINDOW TITLE`) qui n'empêche pas d'exécuter et de tester le reste de votre code. :::tip @@ -76,14 +76,14 @@ Pour ignorer une erreur qui se répète (par exemple, dans les boucles), vous po ::: - - **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : +- **Abandonner** : Stoppe l'exécution de la méthode et revient à l'état antérieur au début de l'exécution de la méthode : - Si une méthode formulaire ou méthode objet s'exécute en réponse à un événement, elle est arrêtée et vous revenez au formulaire. - Si la méthode est exécutée à partir de l'environnement de l'application, vous revenez à cet environnement. - - **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. +- **Copier** : Copie les informations de débogage dans le presse-papiers. L'info décrit l'environnement interne de l'erreur (numéro, composant interne, etc.). Elles sont formatées sous forme de texte tabulé. - - **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. +- **Enregistrer...**: Enregistre le contenu de la fenêtre d'erreur de syntaxe et la chaîne d'appel dans un fichier `.txt`. ## Débogueur diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md index 2dbedc9655644c..3f1b6436ef1e91 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Cet événement peut être utilisé pour filtrer la saisie de données dans les Lorsqu'il est utilisé, cet événement est généré après chaque modification apportée au contenu d'un objet saisissable, quelle que soit l'action qui a provoqué la modification, c'est-à-dire : - - Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; - - Déposer une valeur (action similaire à coller); - - Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. - - Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). +- Actions d'édition standard qui modifient le contenu comme les actions coller, couper, supprimer ou annuler; +- Déposer une valeur (action similaire à coller); +- Toute saisie au clavier effectuée par l'utilisateur ; dans ce cas, l'événement `On After Edit` est généré après les événements [`On Before Keystroke`](onBeforeKeystroke.md) et [`On After Keystroke`](onAfterKeystroke.md), s'ils sont utilisés. +- Toute modification apportée à l'aide d'une commande de langage qui simule une action de l'utilisateur (c'est-à-dire `POST KEY`). Dans l'événement `On After Edit`, les données texte saisies sont retournées par la commande [`Get edited text`](../commands-legacy/get-edited-text.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md index 33cd0dd5bc3ac9..547ac39b5ab982 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ L'événement de formulaire `On Begin Drag Over` peut être sélectionné pour t L'événement `On Begin Drag Over` est utile pour préparer l'action de glisser. Il peut être utilisé pour : - - Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). - - Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). - - Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. +- Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). +- Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). +- Accepter ou refuser le glisser via le résultat de la méthode de l'objet déplacé. - Pour indiquer que les actions de glisser sont acceptées, la méthode de l'objet source doit retourner 0 (zéro). - Pour indiquer que les actions de glisser sont refusées, la méthode de l'objet source doit retourner -1. - Si aucun résultat n'est retourné, 4D considère que les actions de glisser sont acceptées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md index 78486e986347fb..c4858cd18410e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md @@ -15,11 +15,11 @@ L'événement `On Clicked` est généré lorsque l'utilisateur clique sur un obj L'événement `On Clicked` se produit généralement une fois que le bouton de la souris est relâché. Cependant, il existe plusieurs exceptions : - - [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. - - [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. - - [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. - - [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée - - Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem +- [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. +- [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. +- [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. +- [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée +- Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exem Dans le cas d'un événement `On Clicked`, vous pouvez tester le nombre de clics effectués par l'utilisateur à l'aide de la commande `Clickcount`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md index 51e4b7d4d42184..9bdac220339752 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Un enregistrement est sur le point d'être affiché sous forme de liste affiché Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque enregistrement : +- Pour chaque enregistrement : - Pour chaque objet de la zone détaillée : - Méthode objet avec l'événement `On Display Detail` - Méthode formulaire avec l'événement `On Display Detail` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md index a6852001e87193..830756654af344 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over L'événement `On Drag Over` est envoyé à plusieurs reprises à l'objet de destination lorsque le pointeur de la souris est déplacé sur l'objet. Généralement, en réponse à cet événement : - - Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). - - En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. +- Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). +- En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. Pour **rejeter** le glisser, la méthode de l'objet de destination doit retourner -1. Lors d'un événement `On Drag Over`, 4D traite la méthode objet comme une fonction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md index 959a61907fb292..7b762fede644f4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md @@ -15,7 +15,7 @@ L'événement `On Header` est appelé lorsqu'un enregistrement est sur le point Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : - - Pour chaque objet de la zone d'en-tête : +- Pour chaque objet de la zone d'en-tête : - Méthode objet avec l'événement `On Header` - Méthode formulaire avec l'événement `On Header` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md index bad94509cacfcd..2c99b4f29b928c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Cet événement est généré lorsqu'un clic se produit sur l'en-tête d'une col Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) a été sélectionnée pour la list box, vous pouvez décider d'autoriser ou non un tri standard de la colonne en passant la valeur 0 ou -1 dans la variable `$0` : - - Si `$0` est égal à 0, un tri standard est effectué. - - Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. +- Si `$0` est égal à 0, un tri standard est effectué. +- Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) n'est pas sélectionnée pour la list box, la variable `$0` n'est pas utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md index 07c7cc5a3e58e0..bc7cb2ef2796ea 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md @@ -9,16 +9,16 @@ Les formulaires fournissent l'interface par laquelle les informations sont saisi Les formulaires peuvent également contenir d'autres formulaires grâce aux fonctionnalités suivantes : - - [objets de sous-formulaire](FormObjects/subform_overview.md) - - [formulaires hérités](./properties_FormProperties.md#inherited-form-name) +- [objets de sous-formulaire](FormObjects/subform_overview.md) +- [formulaires hérités](./properties_FormProperties.md#inherited-form-name) ## Création de formulaires Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suivants : - - **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. - - **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. - - **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : +- **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. +- **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. +- **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture#sources). Voici un exemple : ``` { @@ -70,9 +70,9 @@ Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suiv Il existe deux catégories de formulaires : - - **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. +- **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. - - **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. +- **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. En règle générale, vous sélectionnez la catégorie de formulaire lorsque vous créez le formulaire, mais vous pouvez la modifier par la suite. @@ -80,15 +80,15 @@ En règle générale, vous sélectionnez la catégorie de formulaire lorsque vou Chaque formulaire est composé d'au moins deux pages : - - une page 1 : une page principale, affichée par défaut - - une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. +- une page 1 : une page principale, affichée par défaut +- une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. Vous pouvez créer plusieurs pages pour un formulaire d'entrée. Si le nombre de champs ou de variables est supérieur au nombre maximal supporté sur un écran, vous pouvez créer des pages supplémentaires pour les afficher. Plusieurs pages vous permettent d'effectuer les opérations suivantes : - - Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. - - Organisez chaque sujet sur sa propre page. - - Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). - - Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. +- Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. +- Organisez chaque sujet sur sa propre page. +- Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](formEditor.md#data-entry-order). +- Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. Les pages multiples sont utiles uniquement pour les formulaires d'entrée. Elles ne sont pas destinées à être imprimées. Lorsqu'un formulaire de plusieurs pages est imprimé, seule la première page est imprimée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md index a8e027a858e3db..69f494bd4c96d0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md @@ -7,11 +7,11 @@ L'éditeur de formulaires 4D prend en charge les macros. Une macro est un ensemb Par exemple, si vous avez un rapport récurrent avec une mise en forme spécifique (par exemple, certains textes doivent apparaître en rouge et certains textes en vert), vous pouvez créer une macro pour définir automatiquement la couleur. Vous pouvez créer des macros pour l'éditeur de formulaires de 4D qui pourront : - - Créer et exécuter du code 4D - - Afficher les boîtes de dialogue - - Sélectionnez des objets de formulaire - - Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés - - Modifier les fichiers de projet (mettre à jour, supprimer) +- Créer et exécuter du code 4D +- Afficher les boîtes de dialogue +- Sélectionnez des objets de formulaire +- Ajouter / supprimer / modifier des formulaires, des objets de formulaire ainsi que leurs propriétés +- Modifier les fichiers de projet (mettre à jour, supprimer) Le code des macros prend en charge les [class functions (fonctions de classe)](Concepts/classes.md) et les [propriétés d'objet de formulaire en JSON](FormObjects/properties_Reference.md) pour vous permettre de définir n'importe quelle fonctionnalité perso @@ -238,9 +238,9 @@ Par exemple, si des objets de la page courante et des groupes ont été modifié Lors de la manipulation de l'attribut `method` des objets de formulaire, vous pouvez définir la valeur de l'attribut de deux manières différentes dans les macros : - - En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). +- En utilisant une [chaîne de caractères contenant le nom/chemin du fichier](FormObjects/properties_Action.md#method). - - En utilisant un objet avec la structure suivante : +- En utilisant un objet avec la structure suivante : | Propriété | Type | Description | | --------- | ---- | ------------------ | @@ -252,9 +252,9 @@ Lors de la manipulation de l'attribut `method` des objets de formulaire, vous po La propriété `$4dId` définit un ID unique pour chaque objet de la page courante. Cette clé est utilisée par le processeur de macros pour gérer les modifications dans `$result.currentPage` : - - si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. - - si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. - - si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. +- si la clé `$4dId` est manquante à la fois dans le formulaire et dans un objet dans `$result`, l'objet est créé. +- si la clé `$4dId` existe dans le formulaire mais est manquante dans `$result`, l'objet est supprimé. +- si la clé `$4dId` existe à la fois dans le formulaire et dans un objet dans `$result` l'objet est modifié. #### Exemple @@ -297,8 +297,8 @@ La fonction `onError` est exécutée lorsque le processeur de macros rencontre u Lors de l'exécution d'une macro, si 4D rencontre une erreur qui empêche l'annulation de la macro, il n'exécute pas la macro. C'est le cas par exemple si l'exécution d'une macro se traduirait par : - - supprimer ou modifier un script dont le fichier est en lecture seule. - - créer deux objets avec le même ID interne. +- supprimer ou modifier un script dont le fichier est en lecture seule. +- créer deux objets avec le même ID interne. #### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md index d1ea471e38b245..b192585d543e57 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Vous pouvez utiliser des bibliothèques d'objets dans vos formulaires. Une bibli 4D propose deux types de bibliothèques d'objets : - - une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. - - des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. +- une bibliothèque d'objets standard préconfigurée, standard, disponible dans tous vos projets. +- des bibliothèques d’objets personnalisées, que vous pouvez utiliser pour stocker vos objets formulaires favoris ou des formulaires projets complets. ## Utilisation de la bibliothèque d'objets standard @@ -21,10 +21,10 @@ La bibliothèque est affichée dans une fenêtre séparée : La fenêtre présente les caractéristiques principales suivantes : - - Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. - - You can filter the window contents by using the **Categories** menu: +- Zone d'aperçu avec des messages d'aide : la zone centrale affiche un aperçu de chaque objet. Vous pouvez survoler un objet pour obtenir des informations sur celui-ci dans un message d'aide. +- You can filter the window contents by using the **Categories** menu: ![](../assets/en/FormEditor/library3.png) - - Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : +- Pour utiliser un objet de la bibliothèque dans votre formulaire, vous pouvez soit : - faire un clic droit sur un objet et sélectionnez **Copier** dans le menu contextuel - or drag and drop the object from the library The object is then added to the form. @@ -56,13 +56,13 @@ Une même bibliothèque d’objets ne peut être ouverte que par un seul projet Pour ouvrir une bibliothèque d’objets personnalisée, sélectionnez la commande **Ouvrir>Bibliothèque d’objets...** dans le menu **Fichier** ou la barre d’outils de 4D. Une boîte de dialogue standard d’ouverture de fichiers apparaît, vous permettant de désigner la bibliothèque d’objets à ouvrir. Vous pouvez sélectionner les types de fichier suivants : - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Les bibliothèques d’objets personnalisées sont des projets 4D classiques. Seules les parties suivantes d'un projet sont exposées lorsqu'il est ouvert en tant que bibliothèque : - - formulaires projet - - pages 1 des formulaires +- formulaires projet +- pages 1 des formulaires ### Construire une bibliothèque d’objets @@ -74,10 +74,10 @@ Les principales opérations sont accessibles via le menu contextuel ou le menu d ![](../assets/en/FormEditor/library5.png) - - **Couper** ou **Copier** vers le conteneur de données - - **Coller** un objet à partir du conteneur de données - - **Effacer** - supprime l'objet de la bibliothèque - - **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. +- **Couper** ou **Copier** vers le conteneur de données +- **Coller** un objet à partir du conteneur de données +- **Effacer** - supprime l'objet de la bibliothèque +- **Renommer** - une boite de dialogue apparait pour vous permettre de renommer l'élément. A noter que les noms d'objets doivent être uniques dans une bibliothèque. Vous pouvez placer dans la bibliothèque des objets individuels (y compris des sous-formulaires) ou des ensembles d’objets. Chaque objet ou ensemble d’objets est regroupé en un seul élément : @@ -93,9 +93,9 @@ Le copier-coller ou le glisser-déposer de certains objets dans la bibliothèque Voici la liste des objets dépendants qui seront collés dans la bibliothèque en même temps que l’objet principal qui les utilise (le cas échéant) : - - Enumérations - - Formats/Filtres - - Images - - Messages d’aide (liés à un champ) - - Méthodes objet +- Enumérations +- Formats/Filtres +- Images +- Messages d’aide (liés à un champ) +- Méthodes objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md index 8aa56e015e88e3..35608377f7063e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ Les options de taille dépendent de la valeur de l'option **Taille basée sur**. ## Taille basée sur - - **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. +- **Automatic Size**: The size of the form will be that necessary to display all the objects, to which will be added the margin values (in pixels) entered in the [**Hor Margin**](#hor-margin) and [**Vert Margin**](#vert-margin) fields. Vous pouvez choisir cette option lorsque vous souhaitez utiliser des objets actifs placés dans une zone hors écran (c'est-à-dire en dehors du rectangle de délimitation de la fenêtre) avec une fenêtre de taille automatique. Grâce à cette option, la présence de ces objets ne modifiera pas la taille de la fenêtre. - - **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. +- **Set Size**: The size of the form will be based on what you enter (in pixels) in the [**Width**](#width) and [**Height**](#height) fields. - - `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. +- `\`: The size of the form will be based on the position of the selected form object. Par exemple, si vous choisissez un objet qui est placé dans la partie inférieure droite de la zone à afficher, la taille du formulaire sera constituée d'un rectangle dont le coin supérieur gauche sera l'origine du formulaire et le coin inférieur droit correspondra à celle de l'objet sélectionné, plus les éventuelles valeurs de marge. > For output forms, only the [**Hor margin**](#hor-margin) or [**Width**](#width) fields are available. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md index acf434fe291b19..cf683fda71fd71 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ Vous créez et personnalisez les formulaires de votre application en manipulant Les formulaires 4D prennent en charge un grand nombre d'objets **actifs** et **statiques** intégrés : - - **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. - - **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. +- **Les objets actifs** réalisent une tâche ou une fonction de l’interface. Les champs sont des objets actifs. Les autres objets actifs — objets saisissables (variables), combo box, listes déroulantes, boutons image, etc. — stockent des données temporairement en mémoire ou effectuent une tâche telle que l'ouverture d'une boite de dialogue, l'impression d'un état ou le lancement d'un processus d'arrière-plan. +- **Les objets statiques** sont généralement utilisés pour le décor, les libellés ou encore l'interface graphique du formulaire. A la différence des objets actifs, les objets statiques ne sont pas associés à des variables. A noter qu'il est possible d'insérer des éléments dynamiques dans les objets statiques. ## Gérer les objets de formulaire Vous pouvez ajouter des objets dans un formulaire de nombreuses manières : - - **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. +- **[Éditeur de formulaire](FormEditor/formEditor.md) :** en glissant un objet de la barre d'outils de l'éditeur de formulaire vers le formulaire. Utilisez ensuite la liste de propriétés pour indiquer les propriétés de l'objet. - - **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. +- **4D language**: Commands from the `Objects (Forms)` theme such as [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) allow to create and define form objects. - - **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). +- **Code JSON dans les formulaires dynamiques :** Définissez les propriétés à l'aide du JSON. Utilisez la propriété [type](properties_Object.md#type) pour définir le type d'objet puis indiquez ses [propriétés disponibles](properties_Reference.md). Exemple d'un objet bouton : ```json diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md index 8329eb99fae1b7..37a1970255c0c5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md @@ -44,6 +44,6 @@ Vous pouvez gérer les données avec des [méthodes](Concepts/methods.md) objet Vous pouvez également représenter des expressions de champ et de variable dans vos formulaires à l'aide d'objets alternatifs, plus particulièrement : - - Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). - - Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). - - Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). \ No newline at end of file +- Vous pouvez afficher et saisir des données à partir des champs de la base de données directement dans des colonnes [de type List box](listbox_overview.md). +- Vous pouvez représenter un champ ou une variable liste directement dans un formulaire à l'aide des objets [Pop-up Menus/Listes déroulantes](dropdownList_Overview.md) et [Combo Boxes](comboBox_overview.md). +- Vous pouvez représenter une expression booléenne sous forme de [case à cocher](checkbox_overview.md) ou de [bouton radio](radio_overview.md). \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md index 86b38f5ebf8f20..fef79c525aa2ca 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Le cas échéant, l'icône déployer/contractée est automatiquement affichée Le contenu d'un objet formulaire liste hiérarchique peut être initialisé de l'une des manières suivantes : - - Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. - - Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. +- Associer une [énumération](properties_DataSource.md#choice-list) à l'objet. L'énumération doit avoir été définie dans l'éditeur de listes en mode Développement. +- Assignez directement une référence de liste hiérarchique à la [variable ou à l'expression](properties_Object.md#variable-or-expression) associée à l'objet formulaire. Dans les deux cas, vous gérez une liste hiérarchique lors de l'exécution via sa référence *ListRef*, à l'aide des commandes de [liste hiérarchique](../commands/theme/Hierarchical_Lists.md) du langage 4D. @@ -34,9 +34,9 @@ mylist:=New list Chaque représentation de liste dispose de caractéristiques propres et partage des caractéristiques communes avec l’ensemble des représentations. Les caractéristiques propres à chaque représentation de liste sont les suivantes : - - La sélection, - - L’état déployé/contracté des éléments, - - La position du curseur de défilement. +- La sélection, +- L’état déployé/contracté des éléments, +- La position du curseur de défilement. The other characteristics (font, font size, style, entry control, color, list contents, icons, etc.) are common to all the representations and cannot be modified separately. Consequently, when you use commands based on the expanded/collapsed configuration or the current item, for example `Count list items` (when the final `*` parameter is not passed), it is important to be able to specify the representation to be used without any ambiguity. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Comme pour les autres commandes de gestion des propriété d’objets, il est possible d’utiliser le caractère “@” dans le paramètre `NomListe`. En principe, cette syntaxe permet de désigner un ensemble d’objets dans le formulaire. Toutefois, dans le contexte des commandes de liste hiérarchique, ce principe n’est pas applicable dans tous les cas. Cette syntaxe aura deux effets différents en fonction du type de commande : - - Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” +- Pour les commandes fixant des propriétés, cette syntaxe désigne tous les objets dont le nom correspond (fonctionnement standard). Par exemple, le paramètre "LH@" désigne tous les objets de type liste hiérarchique dont le nom débute par “LH” - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : +- Pour les commandes récupérant des propriétés, cette syntaxe désigne le premier objet dont le nom correspond. Ces commandes sont : - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Comme pour les autres commandes de gestion des propriété d’objets, il est po Il est possible de modifier l’apparence d’une liste hiérarchique dans un formulaire à l’aide de plusieurs commandes 4D génériques. Vous devez passer à ces commandes soit le nom d’objet de la liste hiérarchique (en utilisant le paramètre \*), soit son nom de variable (contenant la valeur RefListe) : - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Rappel : A l'exception de la commande `OBJECT SET SCROLL POSITION`, ces commandes modifient toutes les représentations d'une même liste, même si vous désignez une liste via son nom d'objet. @@ -107,8 +107,8 @@ Ce principe est appliqué quel que soit l’ordre d’appel des commandes. Si un Vous pouvez généralement travailler de deux manières avec le contenu des listes hiérarchiques : par position ou par référence. - - Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. - - Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. +- Lorsque vous travaillez par position, 4D se base sur la position relative des éléments dans la liste affichée à l'écran pour les identifier. Le résultat sera différent selon que certains éléments hiérarchiques sont déployés ou non. A noter qu'en cas de multi-représentation, chaque objet de formulaire comporte sa propre configuration d'éléments contractés/déployés. +- Lorsque vous travaillez par référence, 4D se base sur le numéro unique *réfElément* des éléments de la liste. Chaque élément peut être ainsi désigné, quelle que soit sa position ou son affichage dans la liste hiérarchique. ### Exploiter les numéros de référence des éléments (réfElément) @@ -149,9 +149,9 @@ En pratique, vous devez vous préoccuper des numéros de référence d'élément Vous pouvez choisir si les éléments de la liste hiérarchique peuvent être modifiés par l'utilisateur à l'aide du raccourci **Alt + clic** (Windows)/ **Option + clic** (macOS), ou en effectuant un clic long sur le texte de l'élément. - - Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). +- Quelle que soit la source de données de la liste hiérarchique, vous pouvez contrôler l'ensemble de l'objet avec la propriété [Saisissable](properties_Entry.md#enterable). - - En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- En outre, si vous remplissez la liste hiérarchique à l'aide d'une liste créée dans l'éditeur de listes, vous contrôlez si un élément d'une liste hiérarchique est modifiable à l'aide de l'option **Élément modifiable** dans l'éditeur de listes. For more information, see [Setting list properties](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md index 7fde4eb6cbc93b..f2cae35c1488c9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md @@ -25,7 +25,7 @@ Indique si l’utilisateur peut supprimer des sous-enregistrements dans un sous- Cette option permet de désigner un formulaire détaillé à utiliser dans un sous-formulaire. Il peut être : - - un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- un widget, c'est-à-dire un sous-formulaire de type page doté de fonctions spécifiques. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ @@ -33,7 +33,7 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so > Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). - - le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. +- le formulaire détaillé à associer au [sous-formulaire de liste](#list-form). Le formulaire détaillé peut être utilisé pour saisir ou afficher des sous-enregistrements. Il contient généralement plus d'informations que le sous-formulaire liste. Naturellement, le formulaire détaillé doit appartenir à la même table que le sous-formulaire. Vous utilisez normalement un formulaire de sortie comme formulaire liste et un formulaire d'entrée comme formulaire détaillé. Si vous n'indiquez pas le formulaire à utiliser pour la saisie pleine page, 4D utilise automatiquement le format d'entrée par défaut de la table. #### Grammaire JSON @@ -51,8 +51,8 @@ Cette option permet de désigner un formulaire détaillé à utiliser dans un so Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulaire de liste. Les options suivantes sont disponibles : - - Ne rien faire : ignore le double-clic. - - Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. +- Ne rien faire : ignore le double-clic. +- Ajouter un enregistrement : crée un nouvel enregistrement dans le sous-formulaire et passe en mode édition. Pour cela, il vous suffit de cliquer deux fois sur le champ à modifier afin de le passer en mode édition (veillez à laisser suffisamment de temps entre les deux clics pour ne pas générer de double-clic). Sinon, il sera créé en mode page, dans le [formulaire détaillé](#detail-form) associé au sous-formulaire. #### Grammaire JSON @@ -76,9 +76,9 @@ Action à effectuer en cas de double-clic sur une ligne vide d'un sous-formulair Définit l'action à réaliser lorsqu'un utilisateur double-clique sur une ligne dans un sous-formulaire liste. Les options disponibles sont : - - **Do nothing** (default): Double-clicking a row does not trigger any automatic action. - - **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. - - **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. +- **Do nothing** (default): Double-clicking a row does not trigger any automatic action. +- **Modifier enregistrement** : Un double-clic sur une ligne permet d'afficher l'enregistrement correspondant dans le [ formulaire détaillé défini pour le sous-formulaire liste](#detail-form). L'enregistrement est ouvert en lecture-écriture afin qu'il puisse être modifié. +- **Display Record**: Identical to the previous action, except that the record is opened in read-only mode so it cannot be modified. Regardless of the action selected/chosen, the `On Double clicked` form event is generated. @@ -156,8 +156,8 @@ Spécifie la table à laquelle appartient le sous-formulaire Liste (le cas éch Désigne l'option permettant aux utilisateurs de sélectionner des lignes : - - **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. - - **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ +- **None**: Rows cannot be selected if this mode is chosen. Cliquer sur la liste n'aura aucun effet à moins que l'option [Saisissable en liste](#enterable-in-list) soit activée. The navigation keys only cause the list to scroll; the `On Selection Change` form event is not generated. +- **Single**: One row at a time can be selected in this mode. Un clic sur une ligne la sélectionne. A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ @@ -165,7 +165,7 @@ Désigne l'option permettant aux utilisateurs de sélectionner des lignes : A **Ctrl+click** (Windows) or **Command+click** (macOS) on a row toggles its state (between selected or not).\ The Up and Down arrow keys select the previous/next row in the list.\ The Up and Down arrow keys select the previous/next row in the list. Les autres touches de navigation font défiler la liste. The `On Selection Change` form event is generated every time the current row is changed. - - **Multiple**: Several rows can be selected simultaneously in this mode. +- **Multiple**: Several rows can be selected simultaneously in this mode. - Les sous-enregistrements sélectionnés sont retournés par la commande `GET HIGHLIGHTED RECORDS`. - Cliquer sur l'enregistrement permettra de le sélectionner, mais ne modifiera pas l'enregistrement courant. - Si vous pressez **Ctrl+clic** (Windows) ou **Commande+clic** (macOS) sur un enregistrement, cela fera basculer son état (entre sélectionné ou non). Les touches fléchées Haut et Bas sélectionnent l'enregistrement précédent/suivant dans la liste. Les autres touches de navigation font défiler la liste. L'événement formulaire `On Selection Change` est généré chaque fois que l'enregistrement sélectionné est modifié. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md index 522f4bb609875e..3a8c52a17e060c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ Les formes sont des [objets statiques](formObjects_overview.md#active-and-static Les formes 4D prennent en charge les formes basiques suivantes : - - rectangles - - lignes - - ovales +- rectangles +- lignes +- ovales ## Rectangle diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md index 455819ccb29fb5..63b61e272c7a0a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md @@ -11,10 +11,10 @@ L’utilisation type du séparateur est le formulaire de sortie dans lequel les Les caractéristiques générales des séparateurs sont les suivantes : - - Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. - - Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. - - Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. - - Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. +- Vous pouvez placer autant de séparateurs que vous voulez dans tout type de formulaire. De même, il est possible de mêler des séparateurs horizontaux et verticaux dans un même formulaire. +- Un séparateur peut traverser un objet. Celui-ci sera redimensionné lors du déplacement du séparateur. +- Les butées des séparateurs sont calculées de manière à ce que les objets déplacés restent entièrement visibles dans le formulaire ou ne passent pas sous/à côté d’un autre séparateur. Lorsque la propriété [Pousseur](properties_ResizingOptions.md#pusher) est associée à un séparateur, son déplacement vers la droite ou vers le bas ne rencontre pas de butée. +- Les redimensionnements effectués dans les formulaires à l’aide des séparateurs ne sont conservés que durant l’affichage du formulaire. Une fois le formulaire refermé, les dimensions initiales sont restaurées. Une fois inséré, un séparateur se présente sous la forme d’un trait. Vous pouvez modifier son [style de bordure](properties_BackgroundAndBorder.md#border-line-style) afin d’obtenir un trait plus ou moins épais, ou [modifier sa couleur](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Vous pouvez associer une méthode objet à un séparateur. Cette méthode sera a Une [variable](properties_Object.md#variable-or-expression) de type *Entier long* est associée à chaque objet séparateur. Cette variable peut être utilisée dans vos méthodes objet et/ou formulaire. Elle prend pour valeur le déplacement courant, en pixels, du séparateur. - - Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, - - Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, - - Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. +- Si elle est négative : le déplacement a été effectué vers le haut ou vers la gauche, +- Si elle est positive : le déplacement a été effectué vers le bas ou vers la droite, +- Si elle est égale à 0 : le séparateur a été relâché à son emplacement d’origine. Vous pouvez également déplacer le séparateur par programmation : il suffit de modifier la valeur de la variable associée. Imaginons par exemple qu’un séparateur vertical soit associé à la variable `sépara1`. Si vous écrivez `sépara1:=-10`, le séparateur sera déplacé de 10 pixels vers la gauche — comme si l’utilisateur l’avait fait manuellement. Le déplacement s’effectue au terme de l’exécution de la méthode objet ou formulaire contenant l’instruction. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md index b69cbae04d9fe3..2ca2b0558845bc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md @@ -13,11 +13,11 @@ La variable associée à l’objet peut être affectée à une zone saisissable Un stepper peut être directement associé à une variable numérique, heure ou date. - - Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : +- Pour les valeurs de type heure, les propriétés Minimum, Maximum et Pas représentent des secondes. Par exemple, pour définir un stepper de 8h00 à 18h00 avec des pas de 10 minutes : - [minimum](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. +- Pour les valeurs du type de date, la valeur saisie dans la propriété [step](properties_Scale.md#step) représente des jours. Les propriétés Minimum et Maximum sont ignorées. > Pour que le stepper fonctionne avec une variable heure ou date, il est impératif de définir son type dans le formulaire ET de le [déclarer explicitement](../Concepts/variables.md#declaring-variables) comme `Time` ou Date\`. @@ -29,8 +29,8 @@ Pour plus d'informations, veuillez vous reporter à la section [Utiliser des ind ## Voir également - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md index 211a36f4fe1939..abd9d336f929c2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Un sous-formulaire est un formulaire inclus dans un autre formulaire. Afin de bien définir les notions mises en oeuvre avec les sous-formulaires, voici quelques définitions relatives aux termes employés : - - **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. - - **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). - - **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. - - **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. - - **Formulaire liste écran** : instance de sous-formulaire en liste. - - **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. +- **Sous-formulaire** : formulaire destiné à être inclus dans un autre formulaire, lui-même nommé formulaire parent. +- **Formulaire parent** : formulaire contenant un ou plusieurs sous-formulaire(s). +- **Conteneur de sous-formulaire** : objet inclus dans le formulaire parent, contenant une instance du sous-formulaire. +- **Instance de sous-formulaire** : la représentation d’un sous-formulaire dans un formulaire parent. Cette notion est importante car il est possible d’afficher plusieurs instances d’un même sous-formulaire dans un formulaire parent. +- **Formulaire liste écran** : instance de sous-formulaire en liste. +- **Formulaire détaillé** : formulaire de saisie en page associé au sous-formulaire en liste et accessible via un double-clic dans la liste. ## Sous-formulaires en liste @@ -43,8 +43,8 @@ You can bind [a variable or an expression](properties_Object.md#variable-or-expr By default, 4D creates a variable or expression of [object type](properties_Object.md#expression-type) for a subform container, which allows you to share values in the context of the subform using the `Form` command. However, you can use a variable or expression of any scalar type (time, integer, etc.) especially if you only need to share a single value: - - Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. - - Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. +- Define a bound variable or expression of a scalar type and call the `OBJECT Get subform container value` and `OBJECT SET SUBFORM CONTAINER VALUE` commands to exchange values when [On Bound Variable Change](../Events/onBoundVariableChange.md) or [On Data Change](../Events/onDataChange.md) form events occur. Cette solution est recommandée pour synchroniser une seule valeur. +- Define a bound variable or expression of the **object** type and use the `Form` command to access its properties from the subform. Cette solution est recommandée pour synchroniser plusieurs valeurs. ### Synchronisation du formulaire parent et du sous-formulaire (valeur unique) @@ -58,8 +58,8 @@ Dans le formulaire parent, les deux objets (zone de saisie et conteneur de sous- To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. - - If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. +- If you use a variable (e.g. `parisTime`), it must be of the `text` or `time` type. +- If you use an expression (e.g. `Form.myValue`), it must contain a `text` value. La valeur texte doit être formatée "hh:mm:ss". @@ -88,15 +88,15 @@ It updates the value of `Form.clockValue` in the subform: L’événement formulaire [Sur modif variable liée](../Events/onBoundVariableChange.md) est généré : - - dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée - - si le sous-formulaire appartient à la page formulaire courante ou à la page 0. +- dès qu'une valeur est assignée à la variable/expression du formulaire parent, même si la même valeur est réassignée +- si le sous-formulaire appartient à la page formulaire courante ou à la page 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). La modification de la variable ou de l'expression liée déclenche des événements formulaire qui vous permettent de synchroniser les valeurs du formulaire parent et du sous-formulaire : - - Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. - - Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. +- Use the [On Bound Variable Change](../Events/onBoundVariableChange.md) form event to indicate to the subform (form method of subform) that the variable or expression was modified in the parent form. +- Use the [On Data Change](../Events/onDataChange.md) form event to indicate to the subform container that the variable or expression value was modified in the subform. #### Mise à jour du contenu d'un formulaire parent @@ -170,8 +170,8 @@ La communication entre le formulaire parent et les instances du sous-formulaire Pour répondre à ces besoins, 4D propose les mécanismes suivants : - - Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` - - Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` +- Appel de l’objet conteneur depuis le sous-formulaire via la commande `CALL SUBFORM CONTAINER` +- Exécution d’une méthode dans le contexte du sous-formulaire via la commande `EXECUTE METHOD IN SUBFORM` > La commande `GOTO OBJECT` peut rechercher l’objet de destination dans le formulaire parent même si elle exécutée depuis un sous-formulaire. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md index 0ec07cb47cd10e..ffdb38e99ad775 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md @@ -42,9 +42,9 @@ Sous macOS, les onglets peuvent être orientés, en plus de la position standard Pour fournir les étiquettes d'un onglet, vous pouvez utiliser : - - un objet - - une liste déroulante - - un tableau +- un objet +- une liste déroulante +- un tableau ### Utiliser un objet diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md index 2f4e9c9a419512..fe63997661a170 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md @@ -33,9 +33,9 @@ Une fois qu’un texte a été orienté, il reste possible de modifier sa taille ![](../assets/en/FormObjects/staticText2.png) - - Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; - - Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; - - Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. +- Si l’objet est redimensionné dans la direction A, sa [largeur](properties_CoordinatesAndSizing.md#width) sera modifiée ; +- Si l’objet est redimensionné dans la direction C, sa [hauteur](properties_CoordinatesAndSizing.md#height) sera modifiée ; +- Si l’objet est redimensionné dans la direction B, sa [largeur](properties_CoordinatesAndSizing.md#width) et sa [hauteur](properties_CoordinatesAndSizing.md#height) seront modifiées. ## Propriétés prises en charge diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md index 3a3b60d2ce9b35..07f7a4e7f217e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md @@ -14,9 +14,9 @@ Chaque opération élémentaire enregistrée dans le fichier d’historique appa Les informations affichées permettent d’identifier la source et le contexte de chaque opération : - - **Opération** : numéro de séquence de l’opération dans le fichier d’historique. +- **Opération** : numéro de séquence de l’opération dans le fichier d’historique. - - **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : +- **Action** : type d’opération effectuée. Cette colonne peut contenir les opérations suivantes : - Ouverture du fichier de données : ouverture d’un fichier de données. - Fermeture du fichier de données : fermeture du fichier de données ouvert. - Création d’un contexte : création d’un process définissant un contexte d’exécution. @@ -30,26 +30,26 @@ Les informations affichées permettent d’identifier la source et le contexte d - Annulation de transaction : transaction annulée. - Contexte de mise à jour : modification des données supplémentaires (ex : un appel à `CHANGE CURRENT USER` ou `SET USER ALIAS`). - - **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. +- **Table** : table à laquelle appartient l’enregistrement ou le BLOB ajouté/supprimé/modifié. - - **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. +- **Clé primaire/BLOB** : contenu de la clé primaire de l'enregistrement (lorsque la clé primaire est composée de plusieurs champs, les valeurs sont séparées par des points-virgules), ou numéro de séquence du BLOB impliqué dans l’opération. - - **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. +- **Process** : numéro interne du process dans lequel l’opération a été effectuée. Ce numéro interne correspond au contexte de l’opération. - - **Taille** : taille (en octets) des données traitées par l’opération. +- **Taille** : taille (en octets) des données traitées par l’opération. - - **Date et Heure** : date et heure à laquelle l’opération a été effectuée. +- **Date et Heure** : date et heure à laquelle l’opération a été effectuée. - - **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. +- **Utilisateur système** : nom de l’utilisateur système ayant effectué l’opération. En mode client-serveur, le nom de la machine côté client est affiché; en mode mono-utilisateur, le nom de session de l'utilisateur s'affiche. - - **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. +- **Utilisateur 4D** : nom de l’utilisateur 4D ayant effectué l’opération. Si un alias est défini pour l'utilisateur, l'alias s'affiche à la place du nom d'utilisateur 4D. - - **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ +- **Valeurs** : valeurs des champs de l’enregistrement en cas d’ajout ou de modification. Les valeurs sont séparées par des “;”. Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ Seules les valeurs représentées sous forme alphanumérique sont affichées.\ ***Note :** Si la base de données est chiffrée et si aucune clé de données valide correspondant au fichier d'historique ouvert n'a été fournie, les valeurs chiffrées ne sont pas affichées dans cette colonne.* - - **Enregistrements** : numéro de l’enregistrement. +- **Enregistrements** : numéro de l’enregistrement. Cliquez sur **Analyser** pour mettre à jour le contenu du fichier d'historique courant de l'application sélectionnée (nommé par défaut dataname.journal). Le bouton Parcourir peut être utilisé pour sélectionner et ouvrir un autre fichier journal pour l'application. Le bouton **Exporter...** peut être utilisé pour exporter le contenu du fichier en tant que texte. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md index 0ddaaae0171a58..f4ff5d4178d563 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md @@ -51,13 +51,13 @@ Lorsque vous cliquez sur le bouton **Réparer**, 4D effectue une analyse complè La zone "Enregistrements trouvés dans le fichier de données" comporte deux tableaux synthétisant les informations issues de l’analyse du fichier de données. - - Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : +- Le premier tableau liste les informations issues de l’analyse du fichier de données. Chaque ligne représente un groupe d’enregistrements récupérables dans le fichier de données : - La colonne **Ordre** indique l’ordre de récupération des groupes d’enregistrements. - La colonne **Nombre** indique le nombre d'enregistrements contenus dans la table. - Si tous les enregistrements et toutes les tables ont été attribués, seule la zone principale est affichée. Les noms des tables attribuées automatiquement sont affichés en caractères verts. Les groupes qui n'ont pas encore été attribués, c'est-à-dire, les tables qui n'ont pas pu être associées à des enregistrements sont affichées en caractères rouges. - Voir le compte rendu Par défaut, l’option est cochée pour tous les groupes avec les enregistrements qui peuvent être associés à une table. - - Le deuxième tableau liste les tables du fichier de structure. +- Le deuxième tableau liste les tables du fichier de structure. ### Attribution manuelle @@ -74,7 +74,7 @@ Le bouton **Ignorer enregistrements** permet de supprimer l’association effect Une fois la réparation terminée, 4D génère un fichier de compte-rendu dans le dossier Logs du projet. Ce fichier liste l’ensemble des opérations qui ont été menées. Il est créé au format xml et est nommé : *ApplicationName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" où : - - *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", - - *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". +- *ApplicationName* est le nom du fichier de structure sans extension, par exemple "Factures", +- *aaaa-mm-jj hh-mm-ss* est l'horodatage du fichier, basé sur la date et l'heure système locales au moment du lancement de l'opération de vérification, par exemple "2019-02-11 15-20-45". Lorsque vous cliquez sur le bouton **Voir le compte rendu**, 4D affiche le fichier de compte-rendu le plus récent dans le navigateur par défaut de l’ordinateur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md index b27f7547434bf5..948efad95aca75 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md @@ -11,8 +11,8 @@ La propriété **Title** contient le libellé d'un menu ou d'une ligne de menu, Dans l'éditeur de menus, vous pouvez saisir directement le libellé "en dur". Vous pouvez également saisir une référence pour une variable ou un élément XLIFF, ce qui facilitera la mise à jour et la traduction des applications. Vous pouvez utiliser types de références suivants : - - Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. - - Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. +- Une référence à une ressource XLIFF, du type :xliff:MonLibellé. Pour plus d’informations sur les références XLIFF, reportez-vous à la section *Annexe B : Architecture XLIFF* du *Mode Développement 4D*. +- Un nom de variable interprocess suivi d’un chiffre, par exemple :`:<>vlang,3`. Il suffit de changer le contenu de cette variable pour modifier le libellé du menu lors de son affichage. Dans ce cas, le libellé fera appel à une ressource XLIFF. La valeur contenue dans la variable `<>vlang` correspond à l’attribut *id* de l’élément *group*. La seconde valeur (3 dans cet exemple) désigne l’attribut *id* de l’élément *trans-unit*. En utilisant le langage 4D, vous définissez la propriété Title à l'aide du paramètre *itemText* des commandes `APPEND MENU ITEM`, `INSERT MENU ITEM`, et `SET MENU ITEM`. @@ -53,8 +53,8 @@ Vous choisissez d’associer une action standard ou une méthode projet à la co Pour associer une méthode projet et/ou une action standard à une commande de menu sélectionnée dans l'éditeur de menu : - - **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. - - **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. +- **Nom de la méthode** : sélectionnez une méthode projet existante dans la combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] bouton. 4D affiche une boîte de dialogue de création de méthode de projet qui permet d'accéder à l'éditeur de code. +- **Action standard associée** : Choisissez ou saisissez le nom de l’action que vous souhaitez associer dans la combo box "Action standard associée". Vous pouvez saisir toute action prise en charge et (optionnellement) tout paramètre dans la zone. Pour la liste complète des actions standard, veuillez vous reporter à la section **Actions standard** dans le *Mode Développement*. **Note macOS :** Sous macOS, les commandes de menus créés associées à l'action *Quitter* sont automatiquement placées dans le menu de l’application, conformément aux normes d’interface de cette plate-forme. A l'aide du langage 4D, vous pouvez associer une méthode projet via la commande `SET MENU ITEM METHOD` et une action standard via la commande `SET MENU ITEM PROPERTY`. @@ -101,13 +101,13 @@ Vous pouvez affecter des raccourcis clavier à toute commande de menu. Lorsqu’ Vous pouvez également ajouter les touches **Majuscule** ainsi que **Alt** (Windows) ou **Option** (macOS) au raccourci clavier associé à une commande. Cette possibilité multiplie le nombre de raccourcis clavier utilisables dans les barres de menus. Les raccourcis clavier définis peuvent donc être de différents types : - - Sous Windows : +- Sous Windows : - Ctrl+lettre - Ctrl+Maj+lettre - Ctrl+Alt+lettre - Ctrl+Maj+Alt+lettre - - Sous macOS : +- Sous macOS : - Commande+lettre - Commande+Maj+lettre - Commande+Option+lettre diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md index 0ffac1cf8fa283..b6bb6bacbab3e5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md @@ -9,19 +9,19 @@ Lisez [**Les nouveautés de 4D 20 R9**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). - - L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). - - Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. - - Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. - - Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). - - Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. - - Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. - - Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. - - La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) (utilisée pour trier/rechercher en langue japonaise) est désormais obsolète et sa prise en charge sera supprimée dans la prochaine version. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. +- Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). +- L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). +- Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. +- Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. +- Les composants interprétés peuvent maintenant être [édités depuis le projet hôte](../Extensions/develop-components.md#editing-components-from-the-host). +- Les [licenses](../Admin/licenses.md) sont maintenant automatiquement actualisées au démarrage. +- Nouveau [composant 4D AIkit](../aikit/overview.md) permettant l'interaction avec les API IA tierces. +- Les fonctions de callback suivantes de 4D View Pro attendent maintenant que toutes les fonctions personnalisées de 4D terminent leurs calculs : [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), et [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Nouvelles fonctionnalités [4D NetKit](https://developer.4d.com/4D-NetKit/) permettant de gérer les calendriers Google et Microsoft 365 ; possibilité d'utiliser le serveur web hôte pour l'authentification OAuth 2.0. +- La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) (utilisée pour trier/rechercher en langue japonaise) est désormais obsolète et sa prise en charge sera supprimée dans la prochaine version. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R9) : liste de tous les bugs qui ont été corrigés dans 4D 20 R9. ## 4D 20 R8 @@ -29,29 +29,29 @@ Lisez [**Les nouveautés de 4D 20 R8**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). - - Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). - - Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. - - [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. - - [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. - - Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#build-an-evaluation-application) dans la boîte de dialogue du Générateur d'applications. - - Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. - - Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) pour la journalisation détaillée des événements TCP. - - Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. - - 4D Write Pro : +- Implémentez votre propre [**gestionnaire de requêtes HTTP**](../WebServer/http-request-handler.md) en utilisant la nouvelle classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- Les expressions utilisées dans [les propriétés des objets de formulaire] (../FormObjects/properties_Reference.md) bénéficient maintenant de la vérification syntaxique dans la [liste des propriétés] (../FormEditor/formEditor.md#property-list) et dans le [Compilateur](../Project/compiler.md#check-syntax). +- Vous pouvez [associer une classe à un formulaire](../FormEditor/properties_FormProperties.md#form-class) pour activer le type-ahead et l'instanciation automatique des données de formulaire lors de l'utilisation de la commande [`Form`](../commands/form.md). +- Prise en charge de [sessions autonomes](../API/SessionClass.md) pour simplifier le développement en local d'applications client/serveur. +- [débogueur 4D](../Debugging/debugger.md) : nouveau design, nouvelles fonctions de sauvegarde automatique et de mode d'affichage. +- [Nouvelle architecture des composants générés](../Desktop/building.md#build-component) pour une meilleure conformité avec les directives de notarisation d'Apple. +- Vous pouvez maintenant facilement [générer des applications d'évaluation](../Desktop/building.md#build-an-evaluation-application) dans la boîte de dialogue du Générateur d'applications. +- Dépendances : Utilisez le Gestionnaire de dépendances pour [vérifier les nouvelles versions](../Project/components.md#checking-for-new-versions) et [mettre à jour](../Project/components.md#updating-dependencies) les composants GitHub. +- Nouvelles classes [`TCPConnection`](../API/TCPConnectionClass.md) et [`TCPEvent`](../API/TCPEventClass.md) pour gérer les connexions client TCP, traiter les événements et améliorer le contrôle de la transmission des données. Ajout de [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) pour la journalisation détaillée des événements TCP. +- Nouvelles options dans [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) et [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) pour contrôler les styles, les formules, l'intégrité des données et la protection par mot de passe. +- 4D Write Pro : - Les commandes suivantes acceptent maintenant des paramètres tels que des objets ou des collections : [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get Attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), et [WP Insert picture] (../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), et [WP Insert break](../WritePro/commands/wp-insert-break.md), sont maintenant des fonctions qui retournent des plages. - Nouvelles expressions liées aux attributs de documents : [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) et [This.pageIndex](../WritePro/managing-formulas.md). - - Langage 4D: +- Langage 4D: - Commande modifiée : [`FORM EDIT`](../commands/form-edit.md) - Les fonctions [`.sign()`](../API/CryptoKeyClass.md#sign) et [`.verify()`](../API/CryptoKeyClass.md#verify) de la [classe 4D.CryptoKey](../API/CryptoKeyClass.md) prennent en charge des Blobs dans le paramètre *message*. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. #### Changements de comportement - - Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. - - En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. +- Après une modification du fichier journal en utilisant [`SELECT LOG FILE`](../commands/select-log-file.md) ou les [paramètres de sauvegarde](../Backup/settings.md#log-management), la commande [`New log file`](../commands/new-log-file.md) valide maintenant le changement, sans attendre une sauvegarde. L'erreur -4447 (sauvegarde requise) n'est plus générée. +- En raison de leur [nouvelle architecture](../Desktop/building.md#build-component), les composants construits avec 4D 20 R8 et suivantes ne peuvent pas être installés dans les versions 4D précédentes. ## 4D 20 R7 @@ -59,30 +59,30 @@ Lisez [**Les nouveautés de 4D 20 R7**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). - - Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). - - Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). - - Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. - - Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. - - Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. - - Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). - - Langage 4D: +- Les colonnes et les en-têtes des list box de type heure prennent désormais en charge l'option ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- Nouvelles propriétés dans [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) et [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist). +- Vous pouvez désormais [ajouter et supprimer des composants à l'aide de l'interface du Gestionnaire de composants](../Project/components.md#monitoring-project-dependencies). +- Nouveau [**mode de typage direct**](../Project/compiler.md#enabling-direct-typing) dans lequel vous déclarez toutes les variables et paramètres dans votre code en utilisant les mots-clés `var` et `#DECLARE`/`Function` (seul mode supporté dans les nouveaux projets). La [fonctionnalité de vérification de syntaxe](../Project/compiler.md#check-syntax) a été adaptée en conséquence. +- Prise en charge des [singletons de session](../Concepts/classes.md#singleton-classes) et nouvelle propriété de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nouveau [mot-clé fonction `onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) pour définir des fonctions singleton ou ORDA qui peuvent être appelées par des [requêtes HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nouvelle classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) pour que le serveur REST retourne n'importe quel contenu web. +- Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. +- Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). +- Langage 4D: - Nouvelles commandes : [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Commandes modifiées : [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands-legacy/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro : +- 4D Write Pro : - Nouvelle commande : [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Commandes modifiées : [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R7) : liste de tous les bugs qui ont été corrigés dans 4D 20 R7. #### Changements de comportement - - Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. - - La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. - - L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. +- Les documentations du [Langage 4D](../commands/command-index.md) et du [Langage 4D Write Pro](../WritePro/commands/command-index.md) sont maintenant entièrement disponibles sur developer.4d.com. Découvrez toutes les nouvelles fonctionnalités et les modifications concernant ces documentations dans cette release note. +- La commande [`File`](../commands/file.md) (ainsi que [`4D.File.new()`](../API/FileClass.md#4dfilenew)) est plus stricte lorsqu'il s'agit de vérifier la syntaxe du *path* fourni en paramètre. +- L'action de [permission](../ORDA/privileges.md#permission-actions) **describe** a été supprimée des actions disponibles. L'accès aux urls [`/rest/$catalog`](../REST/$catalog.md) n'est plus contrôlé. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -90,25 +90,25 @@ Lisez [**Les nouveautés de 4D 20 R6**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). - - Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). - - Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). - - Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. - - Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. - - Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. - - Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. - - Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. - - Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). - - Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). - - Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. - - Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). - - Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. +- Prise en charge des opérateurs de comparaison sur les [références d'objet](../Concepts/dt_object.md#operateurs-sur-les-objets) et les [références de collection](../Concepts/dt_collection.md#operateurs-sur-les-collections). [`collection.query()`](../API/CollectionClass.md#query) prend maintenant en charge les [références d'objet et de collection en tant que valeurs de requête](../API/CollectionClass.md#reference-dobject-ou-de-collection-comme-value). +- Lorsqu'un composant a un [espace de noms déclaré](../Extensions/develop-components.md#declaring-the-component-namespace), ses classes sont maintenant automatiquement partagées entre tous les composants chargés dans le projet hôte via [`cs.`](../Concepts/classes.md#cs). +- Gestionnaire de composants : Prise en charge des [composants stockés sur GitHub](../Project/components.md#components-stored-on-github). +- Nouvelle fonction [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) et API REST [`$clean`](../REST/$clean.md) pour obtenir une nouvelle entity selection basée sur l'entity selection originale mais sans ses entités supprimées. +- Nouvelle fonction [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) et API REST [`$info/privileges`](../REST/$info.md) pour inspecter les privilèges de session plus facilement lors du débogage. +- Nouveau fichier [4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) pour personnaliser les zones Web embarquées dans 4D. +- Nouvelle classe [HTTPAgent](../API/HTTPAgentClass.md) et nouvelle propriété [`agent`](../API/HTTPRequestClass.md#options-parameter) pour la classe HTTPRequest. +- Nouvelles fonctions [`enableState()`](../API/WebFormClass.md) et [`disableState()`](../API/WebFormClass.md) pour contrôler les *states* des pages Qodly depuis le serveur. +- Nouvelle [API `$singleton`](../REST/$singleton.md) pour appeler les fonctions singleton exposées depuis REST et nouveaux [privilèges associés](../ORDA/privileges.md). +- Un [nouveau bouton de paramètre](../settings/web.md#activer-la-validation-dauthentification-rest-avec-la-fonction-dsauthentify) vous aide à mettre à niveau votre projet pour utiliser le mode REST "connexion forcée" (la méthode base `On REST Authentication` est maintenant obsolète). +- Un [nouvel onglet de paramètres](../Project/compiler.md#warnings) vous permet de définir la génération de warnings de manière globale. +- Plusieurs commandes, principalement du thème "Environnement 4D", sont maintenant thread-safe, ainsi que quelques sélecteurs des commandes [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md). +- Nouveau [composant 4D-QPDF](https://github.com/4d/4D-QPDF) qui fournit la commande `PDF Get attachments` pour extraire les pièces jointes d'un document PDF/A3. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R6) : liste de tous les bugs qui ont été corrigés dans 4D 20 R6. #### Changements de comportement - - Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). - - L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). +- Prise en charge de l'enchaînement de défilement dans les formulaires : les parents des sous-formulaires défilent désormais automatiquement lorsque les objets intégrés défilables ([verticalement](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalement](../FormObjects/properties_Appearance.md#horizontal-scroll-bar)) ont atteint leurs limites et que l'utilisateur continue de faire défiler à l'aide de la souris ou du trackpad (*overscrolling*). +- L'API REST [`$catalog`](../REST/$catalog.md) retourne maintenant les singletons (le cas échéant). ## 4D 20 R5 @@ -116,21 +116,21 @@ Lisez [**Les nouveautés de 4D 20 R5**](https://blog.4d.com/fe-whats-new-in-4d-2 #### Points forts - - Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. - - Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). - - Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). - - Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). - - Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). - - Nouveau paramètre REST [$format](../REST/$format.md). - - L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. +- Nouveau [Gestionnaire de composants](../Project/components.md) permettant de contrôler les composants à travers un fichier `dependencies.json`. +- Prise en charge des structures de gestion d'erreur [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- La couche réseau QUIC prend désormais en charge le [*broadcasting*](../Desktop/clientServer.md#ouverture-d-un-projet-à-distance), [SSO](https://doc.4d.com/4Dv20R/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.fe.html) et [IPv6](https://doc.4d.com/4Dv20R/4D/20-R5/Paramètres-IP.300-6932707.fe.html). +- Prise en charge des [restricted entity selections](../ORDA/entities.md#restricting-entity-selections). +- Prise en charge des [classes partagées](../Concepts/classes.md#shared-classes) et des [classes singleton](../Concepts/classes.md#singleton-classes). Nouvelles propriétés de classe : [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Prise en charge de l'[initialisation d'une propriété de classe dans sa ligne de déclaration](../Concepts/classes.md#initializing-the-property-in-the-declaration-line). +- Nouveau [mode de connexion force login pour les requêtes REST](../REST/authUsers.md#force-login-mode) avec une [prise en charge spécifique dans Qodly Studio for 4D](../WebServer/qodly-studio.md#force-login). +- Nouveau paramètre REST [$format](../REST/$format.md). +- L'objet [`Session`](../commands/session.md) est maintenant disponible pour les sessions utilisateur à distance et les procédures stockées. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R5) : liste de tous les bugs qui ont été corrigés dans 4D 20 R5. #### Changements de comportement - - Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). - - Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). +- Les plug-ins *4D Internet Commands* et *4D for OCI* ne sont plus inclus dans les installateurs 4D. Pour obtenir ces plug-ins, vous devez vous connecter au [**portail de téléchargement des produits 4D**](https://product-download.4d.com/). +- Les modifications apportées à l'éditeur de structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont maintenant sauvegardés dans un fichier séparé nommé `catalog_editor.json` stocké dans le dossier [`Sources`](../Project/architecture.md#sources). ## 4D 20 R4 @@ -138,24 +138,24 @@ Lisez [**Les nouveautés de 4D 20 R4**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. - - Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). - - Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. - - Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). - - Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) - - Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. - - Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). - - Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). - - Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. +- Prise en charge du [format de cryptage `ECDSA`](../Admin/tls.md#encryption) pour les certificats TLS. +- Les connexions TLS client/serveur et serveur SQL sont désormais [configurées dynamiquement](../Admin/tls.md#enabling-tls-with-the-other-servers) (aucun fichier de certificat n'est requis). +- Format HTML direct pour les [exports de définition de structure](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Nouveau [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) qui améliore le contrôle du code pendant le typage, la vérification de la syntaxe et les étapes de compilation afin d'éviter les erreurs d'exécution. +- Les paramètres de méthode déclarés dans les prototypes `#DECLARE` ne sont [plus nécessaires dans les méthodes "Compiler_"(../Concepts/parameters.md). +- Prise en charge des [formats de date et d'heure personnalisés](../Project/date-time-formats.md) +- Nouveau mot-clé [`Try(expression)`](../Concepts/error-handling.md#tryexpression) pour gérer les cas d'erreur simples. +- Nouvelle commande [`HTTP Parse message`](../commands/http-parse-message.md). +- Nouvelle option de compatibilité [Impression non bloquante](../settings/compatibility.md). +- Nouveau [mode édition](../Admin/dataExplorer.md#editing-data) dans le Data Explorer. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R4) : liste de tous les bugs qui ont été corrigés dans 4D 20 R4. #### Changements de comportement - - L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. - - La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). - - Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. - - Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). +- L'utilisation d'une ancienne syntaxe pour la déclaration des paramètres (par exemple `C_TEXT($1)` ou `var $1 : Text`) est maintenant dépréciée et génère des warnings lors du typage du code, de la vérification syntaxique et de la compilation. +- La cohérence des sélections est désormais préservée lorsque certains enregistrements sont supprimés puis d'autres créés (voir [ce billet de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/)). +- Dans la mise à jour de la [bibliothèque OpenSSL](#library-table), le niveau de sécurité SSL/TLS par défaut a été modifié de 1 à 2. Les clés RSA, DSA et DH de 1024 bits et plus et de moins de 2048 bits ainsi que les clés ECC de 160 bits et plus et de moins de 224 bits ne sont plus autorisées. Par défaut, la compression TLS était déjà désactivée dans les versions précédentes d'OpenSSL. Au niveau de sécurité 2, il ne peut pas être activé. +- Assurez-vous que votre méthode base "On REST authentication" peut gérer les mots de passe en clair (le troisième paramètre est alors **False**) et que `Open datastore` chiffre votre connexion en passant l'option "tls" à **True** dans *connectionInfo*. Afin de permettre la vérification du mot de passe lorsque [l'annuaire des utilisateurs 4D utilise l'algorithme bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), la valeur "password" dans le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md) est maintenant envoyée en clair par défaut. Dans certains cas spécifiques, l'option "passwordAlgorithm" peut également être utilisée pour la compatibilité (voir la commande [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -163,21 +163,21 @@ Lisez [**Les nouveautés de 4D 20 R3**](https://blog.4d.com/fe-whats-new-in-4d-v #### Points forts - - Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). - - Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). - - Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) - - Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. +- Nouvelle fonction [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Prise en charge du paramètre *context* dans [`Formula from string`](../commands/formula-from-string.md). +- Prise en charge de la propriété `headers` dans le paramètre *connectionHandler* de [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marqueur de modification global](../ORDA/global-stamp.md) pour faciliter la mise en œuvre de modules de synchronisation des données. Nouvelles fonctions : [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) et [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- L'assignation de références de fichiers à des attributs picture/blob est [prise en charge dans ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Prise en charge de [l'initialisation de la valeur et du type de données de la variable dans la ligne de déclaration](../Concepts/variables/#initialisation des variables dans la ligne de déclaration). +- Les paramètres du fichier journal sont désormais [sauvegardés avec le fichier de données courant](../Backup/settings.md#log-management) +- Nouvelle syntaxe pour [déclarer des paramètres variadiques](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro : Prise en charge de [l'importation](../ViewPro/commands/vp-import-from-blob) et de [l'exportation](../ViewPro/commands/vp-export-to-blob) des documents 4D View Pro au format Blob. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R3) : liste de tous les bugs qui ont été corrigés dans 4D 20 R3. #### Changements de comportement - - Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). - - 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. +- Certaines erreurs ne pouvaient être interceptées par votre [méthode de gestion des erreurs](../Concepts/error-handling.md) qu'en mode interprété. Une correction a été apportée, de sorte que les erreurs suivantes seront désormais également détectées en mode compilé : *Indice hors de l'intervalle*, *Type incompatible*, et *Déréférencement d'un pointeur Null*. Cependant, pour de telles erreurs sur les processeurs Intel, la procédure est toujours interrompue comme auparavant, alors que sur les processeurs Apple Silicon, la procédure n'est interrompue que si vous appelez la commande [`ABORT`](../commands-legacy/abort.md). +- 4D n'inclut plus d'interpréteur PHP interne. Vous devez [configurer et exécuter votre propre interpréteur PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) pour utiliser les commandes PHP. ## 4D 20 R2 @@ -191,15 +191,15 @@ Si vos applications 4D utilisent des connexions TLS, il est recommandé de mettr #### Points forts - - Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. - - Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. - - 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. - - Commandes du langage 4D : [page What's new](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) sur doc.4d.com. - - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. +- Nouvelle [classe WebSocket](../API/WebSocketClass.md) pour créer et gérer les connexions WebSocket clientes depuis 4D. +- Nouvelle [option d'interface](../settings/client-server.md#network-layer) pour la couche réseau QUIC. +- 4D View Pro : Prise en charge du format de fichier **.sjs** pour [l'importation](../ViewPro/commands/vp-import-document) et [l'exportation](../ViewPro/commands/vp-export-document) de documents. +- Commandes du langage 4D : [page What's new](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.en.html) sur doc.4d.com. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R2) : liste de tous les bugs qui ont été corrigés dans 4D 20 R2. #### Changements de comportement - - **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. +- **Attention** : La valeur de départ [`offset`](../API/FileHandleClass.md#offset) des objets [4D.FileHandle](../API/FileHandleClass.md) était incorrectement fixée à 1 au lieu de 0. Une correction a été apportée dans 4D à partir des versions **20.1 HF1** et **20 R2** et la valeur est maintenant 0. ## 4D 20.x LTS diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md index 48c74a65b4b864..9b0733a2694544 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Pour activer le suivi des changements de données, la structure de l'application De plus, pour assurer la bonne marche de la fonctionnalité, les conditions suivantes sont requises : - - Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. - - Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : +- Le champ `__GlobalStamp` doit être de type *Integer 64 bits*, avec *index automatique*, *Exposer comme ressource REST*, et *Invisible* sélectionné. +- Une table `__DeletedRecords` doit être ajoutée, avec les champs suivants : | Champ | Type | Description | | ------------------------------------------------------- | --------------- | ------------------------------------------ | @@ -64,8 +64,8 @@ Pour activer le suivi des changements de données : 4D effectue alors les modifications suivantes : - - Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). - - Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. +- Un champ `__GlobalStamp` préconfiguré est ajouté à la ou aux table(s). +- Si elle n'existe pas déjà, une table `__DeletedRecords` est ajoutée à la structure. Pour désactiver le suivi des changements de données : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md index 7e38656d222ca3..87dfd77783f99b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ La session web créée sur le datastore distant est identifiée à l'aide d'un I Le `localID` est local à la machine qui se connecte au datastore distant, ce qui signifie que : - - Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. - - Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. - - Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. +- Si d'autres process de la même application doivent accéder au même datastore distant, ils peuvent utiliser le même `localID` et partager alors la même session. +- Si un autre process de la même application ouvre le même datastore distant, mais avec un autre `localID`, il créera une nouvelle session sur le datastore distant. +- Si un autre poste se connecte au même datastore distant avec le même `localID`, il créera une autre session avec un autre cookie. Ces principes sont illustrés dans les graphiques suivants : @@ -29,9 +29,9 @@ Ces principes sont illustrés dans les graphiques suivants : Les process qui gèrent les sessions d'accès aux datastore apparaissent dans la fenêtre d'administration de 4D Server : - - nom : "REST Handler : \" - - type : type Worker Server HTTP - - session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. +- nom : "REST Handler : \" +- type : type Worker Server HTTP +- session : le nom de session est le nom d'utilisateur passé à la commande `Open datastore`. Dans l'exemple suivant, deux process sont en cours d'exécution pour la même session : @@ -47,11 +47,11 @@ Si une demande est envoyée au datastore distant après la fermeture de la sessi Les fonctionnalités ORDA relatives au verrouillage d'entité et aux transactions sont gérées au niveau du process dans les datastore distants, tout comme en mode client/serveur ORDA : - - Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. - - Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. - - 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`). +- Si un process verrouille une entité à partir d'un datastore distant, l'entité est verrouillée pour tous les autres process, même lorsque ces process partagent la même session (voir [Verrouillage d'entités](entities.md#entity-locking)). Si plusieurs entités pointant vers le même enregistrement ont été verrouillées dans un process, elles doivent toutes être déverrouillées dans le process pour supprimer le verrou. Si un verrou a été mis sur une entité, il est supprimé lorsqu'il n'existe plus de référence à cette entité en mémoire. +- Les transactions peuvent être lancées, validées ou annulées séparément sur chaque datastore distant à l'aide des méthodes `dataStore.startTransaction( )`, `dataStore.cancelTransaction( )`, et `dataStore.validateTransaction( )`. Elles n’ont pas d’incidences sur les autres datastore. +- 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`). Si une entité d'un datastore distant est verrouillée par une transaction dans un process, les autres process ne peuvent pas la mettre à jour, même si ces process partagent la même session. - - Les verrous sur les entités sont supprimés et les transactions sont annulées : +- Les verrous sur les entités sont supprimés et les transactions sont annulées : - lorsque le process est tué. - quand la session est fermée sur le serveur - lorsque la session est arrêtée à partir de la fenêtre d’administration du serveur. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md index b199ec37d80b4c..b24e860f1804e9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md @@ -11,12 +11,12 @@ Cette page regroupe diverses options permettant de paramétrer le fonctionnement Cette option permet de configurer l’affichage proposé par défaut par 4D au démarrage, lorsque l’utilisateur lance uniquement l’application. - - **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. - - **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. - - **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. +- **Ne rien faire** : seule la fenêtre de l’application apparaît, vide. +- **Dialogue d’ouverture de base de données locale** : 4D affiche une boîte de dialogue standard d’ouverture de documents, permettant de désigner un projet local. +- **Ouvrir le dernier projet utilisé** : 4D ouvre directement le dernier projet utilisé, aucune boîte de dialogue d’ouverture n’apparaît. > To force the display of the opening dialog box when this option is selected, hold down the **Alt** (Windows) or **Option** (macOS) key while launching the project. - - **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. - - **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. +- **Dialogue d’ouverture du projet distant** : 4D affiche la boîte de dialogue standard de connexion avec 4D Server, permettant de désigner une base de données publiée sur le réseau. +- **Dialogue Assistant de bienvenue** (réglage d'usine) : 4D affiche la boîte de dialogue de l'Assistant de bienvenue. > > > **4D Server**: The 4D Server application ignores this option. Dans cet environnement, le mode **Ne rien faire** est toujours utilisé. @@ -30,8 +30,8 @@ Depuis macOS Sierra, les applications Mac bénéficient d'onglets automatiques f Vous pouvez bénéficier de cette fonctionnalité dans les environnements de 4D suivants (versions 64 bits uniquement) : - - Fenêtres de l'éditeur de code - - Fenêtres de l'éditeur de formulaires +- Fenêtres de l'éditeur de code +- Fenêtres de l'éditeur de formulaires Toutes les fenêtres de ces éditeurs peuvent être ouvertes sous forme d'onglets : @@ -47,9 +47,9 @@ Dans la boîte de dialogue des Préférences de 4D, l'option **Fenêtre à ongle Trois options sont disponibles : - - **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). - - **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). - - **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. +- **Selon les préférences système** (défaut) : les fenêtres de 4D se comporteront comme elles ont été définies dans les Préférences Système de macOS (En plein écran uniquement, Toujours ou Manuellement). +- **Never**: Opening a new document in 4D form editor or Code Editor will always result in creating a new window (tabs are never created). +- **Toujours** : L'ouverture d'un nouveau document dans l'éditeur de formulaires ou l'éditeur de méthodes de 4D provoquera l'ajout d'un onglet. ### Apparence (macOS uniquement) @@ -59,9 +59,9 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser pour l'e Trois options sont disponibles : - - **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. - - **Clair** : Utiliser le thème clair - - **Sombre** : utiliser le thème sombre +- **Selon les préférences de la palette de couleurs du système** (par défaut) : Utilisez la palette de couleurs définie dans les préférences système de macOS. +- **Clair** : Utiliser le thème clair +- **Sombre** : utiliser le thème sombre > Cette préférence n'est prise en charge que sur macOS. Sous Windows, la palette "Light" est toujours utilisée. @@ -73,8 +73,8 @@ Si cette option est cochée, lorsque l’utilisateur passe en mode Application v Si vous sélectionnez cette option, deux éléments s'ajoutent au menu **Fichier > Nouveau** et au bouton **Nouveau** de la barre d'outils : - - **Database...** - - **Base de données à partir d'une définition de structure...** +- **Database...** +- **Base de données à partir d'une définition de structure...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Lors de la création d’un nouveau fichier de données, 4D utilise la langue d Cette zone permet de configurer l'accès à la documentation HTML de 4D qui s'affiche dans votre navigateur courant : - - When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; - - Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . +- When you hit the **F1** key while the cursor is inserted in a 4D class function or command name in the Code Editor; +- Lorsque l'utilisateur double-clique sur une commande dans la **page des commandes** de l'Explorateur . ### Langue de documentation @@ -151,8 +151,8 @@ Langue de la documentation HTML à afficher. Vous pouvez sélectionner une docum Définit l'emplacement des pages de documentation recherchées par 4D. - - Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. - - If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. +- Lorsque cette option est cochée (par défaut), 4D recherche d'abord la page dans le dossier local (voir ci-dessous). Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Si la page est trouvée à l'emplacement défini, elle est affichée dans le navigateur courant. Ce principe permet par exemple de travailler en mode déconnecté, en accédant à une version locale de la documentation. +- If it is not found, 4D displays an error message in the browser. Si elle n'est pas trouvée, 4D affiche un message d'erreur dans le navigateur. ### Dossier local diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md index 9be8a4354abe73..7d45b24ea92cac 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md @@ -15,8 +15,8 @@ Cette page permet de sélectionner, de créer ou de configurer les thèmes de l' Sélectionnez, dans cette liste, le thème à appliquer à l'éditeur de code. Tous les thèmes disponibles sont affichés, y compris les thèmes personnalisés (le cas échéant). 4D propose deux thèmes par défaut : - - **Default Light Theme** - - **Default Dark Theme** +- **Default Light Theme** +- **Default Dark Theme** > Les thèmes par défaut ne peuvent être ni modifiés ni supprimés. @@ -38,8 +38,8 @@ Si des valeurs clés ne sont pas définies dans un thème personnalisé, elles p Définir un thème signifie : - - définir une police et une taille de police pour l'ensemble de l'éditeur de code, - - attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. +- définir une police et une taille de police pour l'ensemble de l'éditeur de code, +- attribuer des styles et des couleurs spécifiques à chaque élément de langage 4D (champs, tables, variables, paramètres, SQL, etc.), à chaque élément de langage SQL (mots-clés, fonctions, etc.) et aux fonds de couleur. La combinaison de couleurs et de styles différents est particulièrement utile à des fins de maintenance du code. @@ -83,8 +83,8 @@ Cette page configure les options d'affichage de l'éditeur de code. Permet de désactiver/activer les paramètres du code "international" pour l'application 4D locale. - - **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. - - **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. +- **non coché (par défaut)** : Les paramètres Anglais-US et la langue de programmation anglaise sont utilisés dans les méthodes 4D. +- **coché** : Les paramètres régionaux sont utilisés dans les méthodes 4D. > Si vous modifiez cette option, vous devez redémarrer l'application 4D pour que le changement soit pris en compte. @@ -138,9 +138,9 @@ Permet de masquer, par défaut, toutes les icônes plier/déplier lorsque vous a Active l'insertion automatique de () et de caractères fermants lors de la saisie du code. Cette option contrôle deux fonctionnalités automatiques : - - **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). +- **paire de parenthèses ()** : Ajoutée après une commande 4D, un mot-clé ou une méthode projet insérée à partir d'une liste de suggestions ou de complétion, si l'élément inséré nécessite un ou plusieurs arguments obligatoires. Par exemple, si vous tapez "C_OB" et vous appuyez sur la touche Tab, 4D écrit "C_OBJECT()" et place le point d'insertion à l'intérieur du (). - - **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : +- **fermeture }, ), ] ou "** : caractère ajouté lorsque vous tapez respectivement une ouverture {, (, ] ou ". Cette fonction permet d'insérer des paires de symboles correspondants au point d'insertion ou autour d'un texte sélectionné. Par exemple, si vous mettez en surbrillance une chaîne de caractères et que vous tapez un simple caractère ", toute la chaîne sélectionnée sera entourée de "" : ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Active l'insertion automatique de () et de caractères fermants lors de la saisi Permet de modifier la signalisation graphique des caractères d'encadrement correspondants dans le code. Cette signalisation apparaît lorsqu’un crochet, une parenthèse ou une accolade est sélectionné(e). Les options suivantes sont disponibles : - - **Aucun** : Aucun signal - - **Rectangle** (default): Braces surrounded by a black line\ +- **Aucun** : Aucun signal +- **Rectangle** (default): Braces surrounded by a black line\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). - - **Gras** : caractères affichés en gras. +- **Couleur de fond** : Caractères mis en surbrillance (la couleur est définie dans la page [Thème](thèmes)). +- **Gras** : caractères affichés en gras. #### Surbrillance des variables et champs @@ -162,9 +162,9 @@ Permet de mettre en surbrillance toutes les occurrences d'un(e) même variable o ![](../assets/en/Preferences/optionsVariables.png) - - **Non** (par défaut) : Pas de surbrillance - - **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué - - **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné +- **Non** (par défaut) : Pas de surbrillance +- **Sur curseur** : Toutes les occurrences sont mises en évidence lorsque le texte est cliqué +- **Sur sélection** : Toutes les occurrences sont mises en évidence lorsque le texte est sélectionné La couleur de surlignage peut être modifiée dans la page [Définition d'un thème](#définition-dun-thème). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md index 57a47fc24adf11..3a413828c5340d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md @@ -5,7 +5,7 @@ title: Architecture d'un projet Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un dossier racine de projet (dossier package). Par exemple : - - MyPackage (*dossier racine du projet*) +- MyPackage (*dossier racine du projet*) - `Composants` - `Data` - `Logs` @@ -27,23 +27,23 @@ Un projet 4D est composé de plusieurs dossiers et fichiers, stockés dans un do La hiérarchie du dossier Project se présente généralement comme suit : - - fichier `.4DProject` - - `Sources` +- fichier `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Formulaires` - `TableForms` - `Les Triggers` - - `DerivedData` - - `Trash` (le cas échéant) +- `DerivedData` +- `Trash` (le cas échéant) ### fichier `.4DProject` Le fichier de développement de projet, utilisé pour désigner et lancer le projet. Ce fichier peut être ouvert par : - - 4D - - 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (lecture seule, voir [Ouvrir un projet distant](Desktop/clientServer.md#opening-a-remote-project)) > Dans les projets 4D, le développement est réalisé avec 4D et le développement multi-utilisateurs est géré par des outils de contrôle de version. 4D Server peut ouvrir des fichiers .4DProject à des fins de test. @@ -120,9 +120,9 @@ This text file can also contain configuration keys, in particular [`"tokenizedTe Le dossier Trash contient des méthodes et des formulaires qui ont été supprimés du projet (le cas échéant). Il peut contenir les dossiers suivants : - - `Methods` - - `Formulaires` - - `TableForms` +- `Methods` +- `Formulaires` +- `TableForms` Dans ces dossiers, les noms des éléments supprimés sont entre parenthèses, par exemple. "(myMethod).4dm". L'organisation des dossiers est identique à celle du dossier [Sources](#sources). @@ -175,11 +175,11 @@ This folder contains [**user settings for data**](../Desktop/user-settings.md#us Le dossier Logs contient tous les fichiers journaux utilisés par le projet. Les fichiers journaux comprennent notamment : - - conversion de base de données, - - requêtes de serveur Web, - - journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) - - débogage de commandes, - - Requêtes 4D Server (générées sur les postes clients et sur le serveur). +- conversion de base de données, +- requêtes de serveur Web, +- journal des activités de sauvegarde/restitution (*Journal de sauvegarde\[xxx].txt*, voir [Journal de sauvegarde](Backup/backup.md#backup-journal)) +- débogage de commandes, +- Requêtes 4D Server (générées sur les postes clients et sur le serveur). > Un dossier Logs supplémentaire est disponible dans le dossier des préférences système de l'utilisateur (dossier 4D actif, voir commande [Get 4D folder](../commands-legacy/get-4d-folder.md)) pour les fichiers journaux de maintenance et d diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/components.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/components.md index a1369b883e86a4..0e1608fe273d57 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/components.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/components.md @@ -13,15 +13,15 @@ Lorsque vous développez dans 4D, les fichiers de composants peuvent être stock Les composants peuvent être interprétés ou [compilés](../Desktop/building.md). - - Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. - - Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. +- Un projet 4D fonctionnant en mode interprété peut utiliser des composants interprétés ou compilés. +- Un projet 4D exécuté en mode compilé ne peut pas utiliser de composants interprétés. Dans ce cas, seuls les composants compilés peuvent être utilisés. ### Dossier racine (package) Le dossier racine d'un composant (dossier *MyComponent.4dbase*) peut contenir : - - pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. - - pour les **composants compilés** : +- pour les **composants interprétés** : un [dossier project](../Project/architecture.md) standard. Le nom du dossier du dossier racine doit être suffixé **.4dbase** si vous voulez l'installer dans le dossier [**Components**](architecture.md#components) de votre projet. +- pour les **composants compilés** : - soit un dossier "Contents" contenant un fichier .4DZ, un dossier *Resources*, un fichier *Info.plist* (architecture recommandée) - soit directement un fichier .4DZ avec d'autres dossiers tels que *Resources*. @@ -37,8 +37,8 @@ L'architecture de dossier "Contents" est recommandée pour les composants si vou Cette page décrit comment travailler avec les composants dans les environnements **4D** et **4D Server**. Dans les autres environnements, les composants sont gérés différemment : - - dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. - - dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). +- dans [4D en mode distant](../Desktop/clientServer.md), les composants sont chargés par le serveur et envoyés à l'application distante. +- dans les applications fusionnées, les composants sont [inclus à l'étape de construction](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Cette page décrit comment travailler avec les composants dans les environnement Pour charger un composant dans votre projet 4D, vous pouvez soit : - - copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), - - ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). +- copier les fichiers des composants dans le [dossier **Components** de votre projet](architecture.md#components) (les dossiers des composants interprétés doivent être suffixés avec ".4dbase", voir ci-dessus), +- ou déclarer le composant dans le fichier **dependencies.json** de votre projet ; ceci est fait automatiquement pour les fichiers locaux lorsque vous [**ajoutez une dépendance en utilisant l'interface du Gestionnaire de dépendances**](#adding-a-github-dependency). Les composants déclarés dans le fichier **dependencies.json** peuvent être stockés à différents endroits : - - au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, - - n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** - - sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. +- au même niveau que le dossier racine de votre projet 4D : c'est l'emplacement par défaut, +- n'importe où sur votre machine : le chemin du composant doit être déclaré dans le fichier **environment4d.json** +- sur un dépôt GitHub : le chemin du composant peut être déclaré dans le fichier **dependencies.json** ou dans le fichier **environment4d.json**, ou dans les deux. Si le même composant est installé à différents endroits, un [ordre de priorité](#priority) est appliqué. @@ -69,8 +69,8 @@ Le fichier **dependencies.json** référence tous les composants nécessaires à Il peut contenir : - - les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), - - les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). +- les noms des composants [stockés localement](#local-components) (chemin par défaut ou chemin défini dans un fichier **environment4d.json**), +- les noms des composants [stockés sur des dépôts GitHub](#components-stored-on-github) (leur chemin peut être défini dans ce fichier ou dans un fichier **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ Le fichier **environment4d.json** est facultatif. Il vous permet de définir des Les principaux avantages de cette architecture sont les suivants : - - vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. - - si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. +- vous pouvez stocker le fichier **environment4d.json** dans un dossier parent de vos projets et décider de ne pas le livrer (*commit*), ce qui vous permet d'avoir une organisation locale pour vos composants. +- si vous souhaitez utiliser le même dépôt GitHub pour plusieurs de vos projets, vous pouvez le référencer dans le fichier **environment4d.json** et le déclarer dans le fichier **dependencies.json**. ### Priorité @@ -187,9 +187,9 @@ En ce qui concerne les composants stockés sur GitHub, les fichiers [**dependenc Pour pouvoir référencer et utiliser directement un composant 4D stocké sur GitHub, vous devez configurer le dépôt du composant GitHub : - - Compressez les fichiers des composants au format ZIP. - - Nommez cette archive avec le même nom que le dépôt GitHub. - - Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. +- Compressez les fichiers des composants au format ZIP. +- Nommez cette archive avec le même nom que le dépôt GitHub. +- Intégrez l'archive dans une [release GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) du dépôt. Ces étapes peuvent être facilement automatisées, avec du code 4D ou en utilisant des actions GitHub, par exemple. @@ -232,7 +232,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin ::: - - Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : +- Les **Tags** sont des textes qui référencent de manière unique une release. Dans les fichiers [**dependencies.json**](#dependenciesjson) et [**environment4d.json**](#environment4djson), vous pouvez indiquer le release tag que vous souhaitez utiliser dans votre projet. Par exemple : ```json { @@ -245,7 +245,7 @@ Si vous sélectionnez la règle de dépendance [**Suivre la version 4D**](#defin } ``` - - Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : +- Une release est également identifiée par une **version**. Le système de versionnement utilisé est basé sur le concept de [*Semantic Versioning*](https://regex101.com/r/Ly7O1x/3/), qui est le plus couramment utilisé. Chaque numéro de version est identifié comme suit : `majorNumber.minorNumber.pathNumber`. De la même manière que pour les tags, vous pouvez indiquer la version du composant que vous souhaitez utiliser dans votre projet, comme dans cet exemple : ```json { @@ -262,17 +262,17 @@ Un intervalle est défini par deux versions sémantiques, un minimum et un maxim Voici quelques exemples : - - "latest" : la version ayant le badge "latest" dans les releases GitHub. - - "\*" : la dernière version publiée. - - "1.\*" : toutes les versions de la version majeure 1. - - "1.2.\*" : tous les correctifs de la version mineure 1.2. - - ">=1.2.3" : la dernière version, à partir de la version 1.2.3. - - ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. - - "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. - - "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. - - "<=1.2.3" : la dernière version jusqu'à la 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. - - "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. +- "latest" : la version ayant le badge "latest" dans les releases GitHub. +- "\*" : la dernière version publiée. +- "1.\*" : toutes les versions de la version majeure 1. +- "1.2.\*" : tous les correctifs de la version mineure 1.2. +- ">=1.2.3" : la dernière version, à partir de la version 1.2.3. +- ">1.2.3" : la dernière version, en commençant par la version juste après la 1.2.3. +- "^1.2.3" : la dernière version 1, à partir de la version 1.2.3 et strictement inférieure à la version 2. +- "~1.2.3" : la dernière version 1.2, à partir de la version 1.2.3 et strictement inférieure à la version 1.3. +- "<=1.2.3" : la dernière version jusqu'à la 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3" : version comprise entre 1.0.0 et 1.2.3. +- "`<1.2.3 || >=2`" : version qui n'est pas comprise entre 1.2.3 et 2.0.0. Si vous ne spécifiez pas de tag ou de version, 4D récupère automatiquement la version "latest". @@ -282,9 +282,9 @@ Le Gestionnaire de dépendances vérifie périodiquement si des mises à jour de Si vous souhaitez utiliser la règle de dépendance [**Suivre la version 4D**](#defining-a-github-dependency-version-range), les tags des releases des composants sur le dépôt Github doivent respecter des conventions spécifiques. - - **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". +- **Versions LTS** : Modèle `x.y.p`, où `x.y` correspond à la version principale de 4D à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version LTS *x.y*, le Gestionnaire de dépendances le résoudra comme "la dernière version x.\*" si elle est disponible ou "une version inférieure à x". Si une telle version n'existe pas, l'utilisateur en sera informé. Par exemple, "20.4" sera résolu par le Gestionnaire de dépendances comme "la dernière version du composant 20.\* ou une version inférieure à 20". - - **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. +- **Versions R-Release** : Modèle `xRy.p`, où `x` et `y` correspondent à la version principale de 4D R à suivre et `p` (facultatif) peut être utilisé pour les versions correctives ou les mises à jour supplémentaires. Lorsqu'un projet spécifie qu'il suit la version 4D pour la version *xRy*, le Gestionnaire de dépendances le résoudra à la "dernière version inférieure à xR(y+1)" si elle est disponible. Si une telle version n'existe pas, l'utilisateur en sera informé. Si une telle version n'existe pas, l'utilisateur en sera informé. :::note @@ -310,8 +310,8 @@ Vous devez ensuite [fournir votre token de connexion](#providing-your-github-acc Les composants GitHub référencés sont téléchargés dans un dossier de cache local puis chargés dans votre environnement. Le dossier de cache local est stocké à l'emplacement suivant : - - sous macOs : `$HOME/Library/Caches//Dependencies` - - sous Windows : `C:\Users\\AppData\Local\\Dependencies` +- sous macOs : `$HOME/Library/Caches//Dependencies` +- sous Windows : `C:\Users\\AppData\Local\\Dependencies` ...où `` peut être "4D", "4D Server" ou "tool4D". @@ -327,10 +327,10 @@ Dans un projet ouvert, vous pouvez ajouter, supprimer, mettre à jour et obtenir Pour afficher la fenêtre Dépendances : - - avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
+- avec 4D, sélectionnez la ligne de menu **Développement/Dépendances du projet** (environnement de développement),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
+- avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) La fenêtre Dépendances s'affiche alors. Les dépendances sont classées par nom par ordre alphabétique : @@ -345,9 +345,9 @@ Par défaut, toutes les dépendances identifiées par le Gestionnaire de dépend ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. - - **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... - - **Conflit** : Dépendances qui sont chargées mais qui surchargent au moins une autre dépendance à un [niveau de priorité](#priority) inférieur. Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. +- **Actifs** : Dépendances chargées et utilisables dans le projet. Il comprend des dépendances *overloading*, qui sont effectivement chargées. Les dépendances *overloaded* sont listées dans l'onglet **Conflits**, ainsi que toutes les dépendances conflictuelles. +- **Inactifs** : Dépendances qui ne sont pas chargées dans le projet et qui ne sont pas disponibles. Diverses raisons peuvent expliquer ce statut : fichiers manquants, incompatibilité de version... +- **Conflit** : Dépendances qui sont chargées mais qui surchargent au moins une autre dépendance à un [niveau de priorité](#priority) inférieur. Les dépendances surchargées sont également affichées afin que vous puissiez vérifier l'origine du conflit et prendre les mesures appropriées. ### Statut des dépendances @@ -357,16 +357,16 @@ Les dépendances nécessitant l'attention du développeur sont signalées par un Les étiquettes de statut suivantes sont disponibles : - - **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. - - **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. - - **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. - - **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). - - **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). - - **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. - - **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. - - **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. - - **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. - - **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. +- **Overloaded** : La dépendance n'est pas chargée car elle est surchargée par une autre dépendance portant le même nom et ayant un [niveau de priorité](#priority) plus élevé. +- **Overloading** : La dépendance est chargée et surcharge une ou plusieurs autres dépendances avec le même nom à un [niveau de priorité](#priority) inférieur. +- **Non trouvé** : La dépendance est déclarée dans le fichier dependencies.json mais n'est pas trouvée. +- **Inactif** : La dépendance n'est pas chargée car elle n'est pas compatible avec le projet (par exemple, le composant n'est pas compilé pour la plate-forme actuelle). +- **Dupliqué** : La dépendance n'est pas chargée car une autre dépendance portant le même nom existe au même endroit (et est chargée). +- **Disponible après redémarrage** : La référence de la dépendance vient d'être ajoutée ou mise à jour [à l'aide de l'interface](#monitoring-project-dependencies), elle sera chargée une fois que l'application aura redémarré. +- **Déchargé après redémarrage** : La référence à la dépendance vient d'être supprimée [en utilisant l'interface](#removing-a-dependency), elle sera déchargée une fois que l'application aura redémarré. +- **Mise à jour disponible \** : Une nouvelle version de la dépendance GitHub correspondant à votre [configuration de version du composant](#defining-a-github-dependency-version-range) a été détectée. +- **Actualisé après redémarrage** : La [configuration de version](#defining-a-github-dependency-version-range) de la dépendance GitHub a été modifiée, elle sera ajustée au prochain démarrage. +- **Mise à jour récente** : Une nouvelle version de la dépendance GitHub a été chargée au démarrage. Une infobulle s'affiche lorsque vous survolez la ligne de dépendance, fournissant des informations supplémentaires sur le statut : @@ -399,8 +399,8 @@ Cet élément n'est pas affiché si la dépendance est inactive parce que ses fi L'icône du composant et le logo de l'emplacement fournissent des informations supplémentaires : - - Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. - - Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. +- Le logo du composant indique s'il est fourni par 4D ou par un développeur tiers. +- Les composants locaux peuvent être différenciés des composants GitHub par une petite icône. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -420,8 +420,8 @@ Si l'élément sélectionné n'est pas valide, un message d'erreur s'affiche. Cliquez sur **Ajouter** pour ajouter la dépendance au projet. - - Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). - - Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). +- Si vous sélectionnez un composant situé à côté du dossier racine du projet (emplacement par défaut), il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson). +- Si vous sélectionnez un composant qui n'est pas situé à côté du dossier racinedu projet, il est déclaré dans le fichier [**dependencies.json**](#dependenciesjson) et son chemin est déclaré dans le fichier [**environment4d.json**](#environment4djson) (voir note). Le panneau Dépendances vous demande si vous souhaitez enregistrer un [chemin relatif ou absolu](#relative-paths-vs-absolute-paths). :::note @@ -461,11 +461,11 @@ Vous pouvez définir l'option [règle de dépendance](#tags-and-versions) pour u ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). - - **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. - - **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. - - **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. - - **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. +- **La dernière** : Sélectionné par défaut et permet de télécharger la version qui est étiquetée comme la dernière version (stable). +- **Jusqu'à la version majeure suivante** : Définit une [plage sémantique de versions](#tags-and-versions) pour limiter les mises à jour à la version majeure suivante. +- **Jusqu'à la prochaine version mineure** : De même, limite les mises à jour à la version mineure suivante. +- **Version exacte (balise)** : Sélectionnez ou saisissez manuellement un [tag spécifique](#tags-and-versions) dans la liste disponible. +- **Suivre la version 4D** : Téléchargez la dernière version du composant compatible avec la version 4D courante. Vous ne pouvez utiliser cette règle de dépendance que si les tags de release des composants respectent la [convention de nommage](#naming-conventions-for-4d-version-tags) appropriée. La version courante de la dépendance GitHub est affichée sur le côté droit de l'élément de la dépendance : @@ -481,8 +481,8 @@ La modification de la plage de versions est utile par exemple si vous utilisez l Le Gestionnaire de dépendances permet une gestion intégrée des mises à jour sur GitHub. Les fonctionnalités suivantes sont prises en charge : - - Vérification automatique et manuelle des versions disponibles - - Mise à jour automatique et manuelle des composants +- Vérification automatique et manuelle des versions disponibles +- Mise à jour automatique et manuelle des composants Les opérations manuelles peuvent être effectuées **par dépendance** ou **pour toutes les dépendances**. @@ -498,11 +498,11 @@ Si vous fournissez un [token d'accès](#providing-your-github-access-token), les En outre, vous pouvez vérifier les mises à jour à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. +- Pour vérifier les mises à jour d'une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Vérifier les mises à jour** dans le menu contextuel. ![check component](../assets/en/Project/check-component-one.png) - - Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. +- Pour vérifier les mises à jour de toutes les dépendances, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Vérifier les mises à jour**. ![check components](../assets/en/Project/check-component-all.png) @@ -520,11 +520,11 @@ Si vous ne souhaitez pas utiliser la mise à jour des composants (par exemple, v Vous pouvez mettre à jour les dépendances à tout moment, pour une seule dépendance ou pour toutes les dépendances : - - Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : +- Pour mettre à jour une seule dépendance, cliquez avec le bouton droit de la souris sur la dépendance et sélectionnez **Mettre à jour au prochain démarrage** dans le menu contextuel ou dans le menu **options** en bas de la fenêtre du gestionnaire de dépendances : ![check component](../assets/en/Project/update-component-one.png) - - Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : +- Pour mettre à jour toutes les dépendances en une seule fois, cliquez sur le menu **options** en bas de la fenêtre du gestionnaire de dépendances et sélectionnez **Mettre à jour toutes les dépendances distantes au prochain démarrage** : ![check components](../assets/en/Project/update-component-all.png) @@ -532,8 +532,8 @@ Dans tous les cas, quel que soit le statut courant de la dépendance, une vérif Lorsque vous sélectionnez une commande de mise à jour : - - une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. - - si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. +- une boîte de dialogue s'affiche et propose de **redémarrer le projet**, afin que les dépendances mises à jour soient immédiatement disponibles. Il est généralement recommandé de redémarrer le projet pour évaluer les dépendances mises à jour. +- si vous cliquez sur Plus tard, la commande de mise à jour n'est plus disponible dans le menu, ce qui signifie que l'action a été planifiée pour le prochain démarrage. #### Mise à jour automatique @@ -547,13 +547,13 @@ Lorsque cette option n'est pas cochée, une nouvelle version de composant corres L'enregistrement de votre *token* (jeton) d'accès personnel dans le gestionnaire de dépendances est : - - obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), - - recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. +- obligatoire si le composant est stocké sur un [dépôt GitHub privé](#private-repositories), +- recommandé pour une [vérification des mises à jour des dépendances](#updating-github-dependencies) plus fréquente. Pour fournir votre jeton d'accès à GitHub, vous pouvez soit : - - cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. - - ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. +- cliquez sur le bouton **Ajouter un jeton d'accès personnel...** qui est affiché dans la boîte de dialogue "Ajouter une dépendance" après avoir entré un chemin de dépôt privé GitHub. +- ou sélectionner **Ajouter un jeton d'accès personnel GitHub...** dans le menu du Gestionnaire de dépendances à tout moment. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md index b9fb76949e4525..a376f818c231b2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md @@ -7,10 +7,10 @@ Dans les projets d'application, vous pouvez documenter vos méthodes ainsi que v Les éléments de projet suivants peuvent être documentés : - - Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) - - Classes - - Formulaires - - Tables et champs +- Méthodes (méthodes base, méthodes composants, méthodes projet, méthodes formulaire, méthodes 4D Mobile et triggers) +- Classes +- Formulaires +- Tables et champs Vos fichiers de documentation sont écrits dans la syntaxe Markdown (fichiers .md) à l'aide de n'importe quel éditeur prenant en charge le Markdown. Ils sont stockés en tant que fichiers indépendants dans votre dossier Project. @@ -34,7 +34,7 @@ Tous les fichiers de documentation sont stockés dans le dossier `Documentation` L'architecture du dossier `Documentation` est la suivante : - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ L'architecture du dossier `Documentation` est la suivante : - table1.md - ... - - Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire projet et sa méthode de formulaire projet partagent le même fichier de documentation pour le formulaire et la méthode. - - Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. +- Un formulaire table et sa méthode de formulaire table partagent le même fichier de documentation pour le formulaire et la méthode. > Renommer ou supprimer un élément documenté dans votre projet renomme ou supprime également le fichier Markdown associé à l'élément. @@ -73,9 +73,9 @@ Pour afficher la documentation dans la fenêtre de l'Explorateur : ![](../assets/en/Project/comments-explo2.png) - - Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). +- Si aucun fichier de documentation n'a été trouvé pour l'élément sélectionné, un bouton **Créer** s'affiche (voir ci-dessous). - - Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. +- Sinon, s'il existe un fichier de documentation pour l'élément sélectionné, le contenu est affiché dans la zone. Le contenu n'est pas directement modifiable dans le volet. ### Modifier le fichier documentation @@ -83,8 +83,8 @@ Vous pouvez créer et/ou modifier un fichier de documentation Markdown à partir S'il n'y a pas de fichier de documentation pour l'élément sélectionné, vous pouvez : - - cliquez sur le bouton **Créer** dans le volet `Documentation` ou, - - choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. +- cliquez sur le bouton **Créer** dans le volet `Documentation` ou, +- choisissez l'option **Modifier la documentation...** dans le menu contextuel ou le menu d'options de l'Explorateur. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ L'éditeur de code 4D affiche une partie de la documentation d'une méthode dans Si un fichier nommé`\.md` existe dans le dossier `\/documentation` , l'éditeur de code affiche (par priorité) : - - Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. +- Tout texte saisi dans une balise de commentaire HTML (``) en haut du fichier markdown. - - Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ +- Ou, si aucune balise de commentaire html n'est utilisée, la première phrase après une balise `# Description` du fichier markdown.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D.\ Dans ce cas, la première ligne contient le **prototype** de la méthode, généré automatiquement par l'analyseur de code de 4D. @@ -131,7 +131,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Prise en charge du markdown - - La balise de titre est prise en charge : +- La balise de titre est prise en charge : ```md # Title 1 @@ -139,7 +139,7 @@ De nouveaux fichiers de documentation sont créés avec les contenus par défaut ### Title 3 ``` - - Les balises de style (italique, gras, barré) sont prises en charge : +- Les balises de style (italique, gras, barré) sont prises en charge : ```md _italic_ @@ -148,7 +148,7 @@ _italic_ ~~strikethrough~~ ``` - - La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : +- La balise de bloc de code (\`4d ... `) est prise en charge avec la surbrillance du code 4D : ````md ```4d @@ -157,7 +157,7 @@ _italic_ ``` ```` - - La balise de tableau est prise en charge : +- La balise de tableau est prise en charge : ```md | Parameter | Type | Description | @@ -166,7 +166,7 @@ _italic_ | toolbar | Text |Toolbar name | ``` - - La balise de lien est prise en charge : +- La balise de lien est prise en charge : ```md // Case 1 @@ -178,7 +178,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - Les balises d'image sont prises en charge : +- Les balises d'image sont prises en charge : ```md ![image info](pictures/image.png) @@ -225,10 +225,10 @@ $logo:=GetLogo(5) ``` ```` - - Vue de l'explorateur : +- Vue de l'explorateur : ![](../assets/en/Project/explorer_Doc.png) - - Vue de l'éditeur de code : +- Vue de l'éditeur de code : ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md index fc307574f2b1cc..72713992861bd9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md @@ -11,18 +11,18 @@ Lorsque vous avez des attributs relationnels dans une dataclass, utilisez `$attr Vous pouvez appliquer des `$attributes` à une entité (par exemple, People (1)) ou à une entity selection (par exemple, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. +- Si `$attributes` n'est pas spécifié dans une requête, ou si la valeur "\*" est passée, tous les attributs disponibles sont extraits. Les attributs de type **related entity** sont extraits avec la forme simple : un objet avec la propriété `__KEY` (clé primaire) et `URI`. Les attributs de type **related entities** ne sont pas extraits. - - Si `$attributes` est spécifié pour les attributs **related entity** : +- Si `$attributes` est spécifié pour les attributs **related entity** : - `$attributes=relatedEntity` : l'entité liée est retournée sous une forme simple (propriété __KEY différée (clé primaire)) et `URI`. - `$attributes=relatedEntity.*` : tous les attributs de l'entité liée sont retournés - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs de l'entité liée sont retournés. - - Si `$attributes` est spécifié pour les attributs **related entities** : +- Si `$attributes` est spécifié pour les attributs **related entities** : - `$attributes=relatedEntities.*` : toutes les propriétés des entités liées sont retournées - `$attributes=relatedEntities.attributePath1, relatedEntity.attributePath2, ...` : seuls ces attributs des entités liées sont retournés. - - Si `$attributes` est spécifié pour les attributs **storage** : +- Si `$attributes` est spécifié pour les attributs **storage** : - `$attributes=attribute1, attribute2, ...` : seuls les attributs des entités sont renvoyés. ## Exemple avec plusieurs entités liées diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md index f291bc472820ca..9bb7a1a9f8c763 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md @@ -27,13 +27,13 @@ Les verrouillages déclenchés par l'API REST sont placés au niveau de la [sess Une entité verrouillée est considérée comme *verrouillée* (c'est-à-dire que les actions de verrouillage / déverrouillage / mise à jour / suppression ne sont pas possibles) par : - - d'autres sessions REST - - les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. +- d'autres sessions REST +- les process 4D (client/serveur, datastore distant, monoposte) exécutés sur le serveur REST. Une entité verrouillée par l'API REST peut être déverrouillée uniquement : - - via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` - - ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). +- via son verrou, c'est-à-dire un `/?$lock=false` dans la session REST qui définit `/?$lock=true` +- ou si le [timeout d'inactivité]($directory.md) de la session est atteint (la session est fermée). ### Réponse diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md index 21c28f15321bb4..bea88fda52e2c1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md @@ -194,9 +194,9 @@ Si un problème survient lors de l'ajout ou de la modification d'une entité, un :::note - - **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). - - Les valeurs des **booléens** sont vrai ou faux. - - Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Les dates** doivent être exprimées au format JS : YYYY-MM-DDTHH:MM:SSZ (par exemple, "2010-10-05T23:00:00Z"). Si vous avez sélectionné la propriété Date uniquement pour votre attribut Date, le fuseau horaire et l'heure (heure, minutes et secondes) seront supprimés. Dans ce cas, vous pouvez également envoyer la date au format qui vous est retourné dd!mm!yyyy (par exemple, 05!10!2013). +- Les valeurs des **booléens** sont vrai ou faux. +- Les fichiers téléchargés à l'aide de `$upload` peuvent être appliqués à un attribut de type Image ou BLOB en transmettant l'objet renvoyé dans le format suivant `{ "ID" : "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md index 3fcd42322177a2..76d5a6bbd7b1f0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md @@ -7,8 +7,8 @@ Vous pouvez appeler les [fonctions de classe du modèle de données](ORDA/ordaCl Les fonctions peuvent être appelées de deux manières : - - en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. - - en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. +- en utilisant des requêtes **POST**, avec des paramètres de données transmis dans le body de la requête. +- en utilisant des requêtes **GET**, avec des paramètres passés directement dans l'URL. Les requêtes POST offrent un meilleur niveau de sécurité car elles évitent l'exécution de code sensible par une action aussi simple que de cliquer sur un lien. Cependant, les requêtes GET peuvent être plus conformes à l'expérience utilisateur, en permettant d'appeler des fonctions en saisissant un URL dans un navigateur (note : le développeur doit s'assurer qu'aucune action sensible n'est effectuée dans ces fonctions). @@ -96,11 +96,11 @@ Vous pouvez envoyer des paramètres à des fonctions de classes utilisateur ou d Les règles suivantes s'appliquent : - - Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. - - Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. - - Les paramètres doivent être inclus dans une collection (format JSON). - - Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. - - L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Dans les fonctions appelées par des requêtes POST, les paramètres doivent être passés **dans le body de la requête POST**. +- Dans les fonctions appelées par des requêtes GET, les paramètres doivent être passés **dans l'URL avec la syntaxe " ?$params="**. +- Les paramètres doivent être inclus dans une collection (format JSON). +- Tous les types de données scalaires pris en charge dans les collections JSON peuvent être passés en tant que paramètres. +- L'entity selection et l'entité peuvent être passées en tant que paramètres. La liste des paramètres doit contenir les attributs spécifiques utilisés par le serveur REST pour assigner les données aux objets ORDA correspondants : `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Voir [cet exemple](#using-an-entity-to-be-created-on-the-server) et [cet exemple](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Vous pouvez également transmettre des valeurs pour tous les attributs de l'enti | __ENTITY | Boolean | Obligatoire - Vrai pour indiquer au serveur que le paramètre est une entité | | __KEY | mixte (type identique à celui de la clé primaire) | Optionnel - clé primaire de l'entité | - - Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. - - Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés +- Si `__KEY` n'est pas fourni, une nouvelle entité est créée sur le serveur avec les attributs donnés. +- Si `__KEY` est fourni, l'entité correspondant à `__KEY` est chargée sur le serveur avec les attributs donnés Voir les exemples ci-dessous pour la création ou la mise à jour d'entités avec des requêtes POST. Voir un exemple de téléchargement de contenu à l'aide d'une entité avec une requête GET. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md index a58197e4054127..bb3704ed202c99 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md @@ -44,9 +44,9 @@ Toutes les autres requêtes REST (manipulant des données ou exécutant une fonc Les requêtes REST descriptives peuvent être traitées dans des sessions d'utilisateurs web qui ne nécessitent pas de licences (sessions "guest"). Ces requêtes sont : - - requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles - - `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur - - `/rest/$getWebForm` - le rendu d'une page Qodly +- requêtes [`/rest/$catalog`]($catalog.md) (par exemple `/rest/$catalog/$all`) - accès aux dataclass disponibles +- `/rest/$catalog/authentify` - la fonction datastore utilisée pour connecter l'utilisateur +- `/rest/$getWebForm` - le rendu d'une page Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ La fonction peut recevoir toute information d'authentification ou contextuelle e Cette fonction doit contenir deux parties : - - un code pour identifier et authentifier l'expéditeur de la demande REST, - - si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. +- un code pour identifier et authentifier l'expéditeur de la demande REST, +- si l'authentification réussit, un appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) qui attribue les privilèges appropriés à la session. Si la fonction ne fait pas appel à [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), aucun privilège n'est attribué, aucune licence n'est consommée et les requêtes REST non descriptives ultérieures sont rejetées. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md index 7ab8a9f2d6c9d8..25bdced0fd754f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md @@ -9,8 +9,8 @@ Le serveur REST est inclus dans 4D et 4D Server et automatiquement disponible da Cette section est destinée à vous familiariser avec la fonctionnalité REST à l'aide d'un exemple simple. Nous allons : - - créer et configurer un projet d'application 4D basique - - accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. +- créer et configurer un projet d'application 4D basique +- accéder aux données du projet 4D via REST à l'aide d'un navigateur standard. Pour simplifier l'exemple, nous allons utiliser 4D et un navigateur qui s'exécutent sur la même machine. Bien entendu, vous pouvez également utiliser une architecture distante. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md index f3df174864fa88..1c7e3fb711047c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md @@ -17,15 +17,15 @@ Vous disposez également de trois boutons-raccourcis permettant de filtrer par f ![](../assets/en/Admin/server-process-buttons.png) - - **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. - - **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. - - **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. +- **Process utilisateurs** : Process générés par et pour les sessions utilisateurs. Ces process sont précédés d’une icône en forme de personnage. +- **Process 4D** : Process générés par le moteur de 4D Server. Ces process sont précédés d’une icône en forme de roue crantée. +- **Process en attente** : Process inactifs mais conservés temporairement et pouvant être réutilisés à tout moment. Ce mécanisme permet d’optimiser la réactivité de 4D Server. Ces process sont précédés d’une icône grisée en forme de personnage. L’option **Afficher les process par groupes** vous permet de regrouper les process internes de 4D Server ainsi que les process clients, pour plus de lisibilité. Lorsque vous cochez cette option : - - les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, - - le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), - - le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. +- les process clients 4D "jumeaux" (Process client 4D principal et Process base 4D client, cf. paragraphe [Type du process](#process-type)) sont groupés en un seul, +- le groupe "Gestionnaires de tâches" est créé ; il inclut les process internes dédiés à la répartition des tâches (Shared balancer, Net session manager, Exclusive pool worker), +- le groupe "Gestionnaires clients" est créé ; il inclut les différents process internes clients. La zone inférieure de la fenêtre permet d’afficher la représentation graphique de l’activité du ou des process sélectionné(s). @@ -33,16 +33,16 @@ La zone inférieure de la fenêtre permet d’afficher la représentation graphi L’activité du process est le pourcentage du temps que 4D Server a consacré à ce process (ratio). La fenêtre fournit les informations suivantes pour chaque process : - - Type de process (cf. ci-dessous), - - Session: +- Type de process (cf. ci-dessous), +- Session: - Process 4D - vide, - Process utilisateur - nom de l'utilisateur 4D, - Process web - chemin URL, - - Nom du process, - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. - - Etat courant du process, - - Temps (en secondes) d'exécution du process depuis sa création, - - Pourcentage du temps que 4D Server a consacré à ce process (ratio). +- Nom du process, +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). Le numéro du process est le numéro attribué sur le serveur. Dans le cas d’un process global, ce numéro peut être différent de celui attribué sur le poste client. +- Etat courant du process, +- Temps (en secondes) d'exécution du process depuis sa création, +- Pourcentage du temps que 4D Server a consacré à ce process (ratio). ## Type du process @@ -83,15 +83,15 @@ La page comporte cinq boutons de commande permettant d’agir sur le ou les proc ![](../assets/en/Admin/server-process-actions.png) - - **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. +- **Tuer process** : permet de tuer le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Endormir process** : permet d’endormir le ou les process sélectionné(s). - - **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. - - **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). +- **Endormir process** : permet d’endormir le ou les process sélectionné(s). +- **Réactiver process** : permet de réactiver le ou les process sélectionné(s). Les process doivent avoir été auparavant endormis (via le bouton précédent ou par programmation) sinon le bouton est sans effet. +- **Tracer process** : permet d’ouvrir sur le poste serveur une ou plusieurs fenêtre(s) du débogueur pour le ou les process sélectionné(s). Lorsque vous cliquez sur ce bouton, une boîte de dialogue d’alerte apparaît, vous permettant de confirmer ou d’annuler l’opération. A noter que la fenêtre du débogueur ne s’affiche que lorsque du code 4D est effectivement exécuté sur le poste serveur (par exemple dans le cadre d’un trigger ou de l’exécution d’une méthode ayant l’attribut "Exécuter sur serveur"). > Vous pouvez déboguer un process directement, sans afficher la boîte de dialogue de confirmation : pour cela, appuyez sur la touche **Alt** avant de cliquer sur le bouton. - - **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. +- **Voir utilisateurs** : permet d’afficher dans la [page Utilisateurs](users.md) tous les process du ou des utilisateur(s) sélectionné(s). Le bouton est actif lorsqu’un process utilisateur au moins est sélectionné. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md index 88e4afb8dfdc4c..a24ecfbc38ac30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ Chaque opération longue sur les données entraîne l’ajout d’une ligne. La Les informations suivantes sont fournies pour chaque ligne : - - **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" - - **Durée** (ms) : durée en cours de l’opération en millisecondes - - **Informations** : libellé de l’opération. - - **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : +- **Heure début** : heure de démarrage de l’opération au format "jj/mm/aaaa - hh:mm:ss" +- **Durée** (ms) : durée en cours de l’opération en millisecondes +- **Informations** : libellé de l’opération. +- **Détails** : cette zone affiche un ensemble d'informations détaillées dont le contenu varie en fonction du type d'opération sélectionné. En particulier : - **Créée sur** : indique si l'opération résulte d'une action d'un client (Créée sur client) ou si elle a été démarrée explicitement sur le serveur via une procédure stockée ou l'option "Exécuter sur serveur" (Créée sur serveur). - **Détails de l'opération** : décrit le type d'opération ainsi que (pour les opérations de recherche) le plan de recherche. - **Sous-opérations** (le cas échéant) : affiche les opérations dépendantes de l'opération sélectionnée (par exemple, suppression des enregistrements liés avant suppression de l'enregistrement parent). @@ -26,9 +26,9 @@ Les informations suivantes sont fournies pour chaque ligne : La page est active et mise à jour en permanence dès qu’elle est affichée. Il est à noter que son fonctionnement peut ralentir sensiblement l’exécution de l’application. Il est possible de suspendre la mise à jour de la page d’une des manières suivantes : - - en cliquant sur le bouton **Pause**, - - en cliquant dans la liste, - - en appuyant sur la barre d’espace. +- en cliquant sur le bouton **Pause**, +- en cliquant dans la liste, +- en appuyant sur la barre d’espace. Lorsque la page est en pause, le message "SUSPENDU" est affiché et le libellé du bouton devient **Reprendre**. Il est possible de reprendre l’observation des opérations en effectuant la même action que pour la mise en pause. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md index c236eba874ff74..1953c331cd9336 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md @@ -7,8 +7,8 @@ Si plusieurs personnes utilisent une application, ce qui est souvent le cas dans La stratégie de contrôle d'accès 4D dépend de la configuration de votre déploiement : - - dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, - - dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). +- dans les applications multi-utilisateurs, vous pouvez vous appuyer sur les utilisateurs et les groupes 4D, +- dans les applications monoposte, l'accès des utilisateurs est contrôlé par la session du système, à l'aide de commandes telles que [`Current system user`](../commands-legacy/current-system-user.md). > Consultez le document [4D Security guide](https://blog.4d.com/4d-security-guide/) pour une vue d'ensemble des fonctions de sécurité de 4D. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md index 01c8c873fe4fef..e25e474a6ccd30 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Dans *filePath*, passez le chemin de destination et le nom du document à export Vous pouvez préciser le format du document en incluant une extension après son nom : - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", or ".csv") - - [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", or ".csv") +- [SpreadJS document](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Si l'extension n'est pas incluse, mais que le format est spécifié dans *paramObj*, le fichier exporté aura l'extension correspondant au format, sauf pour le format CSV (aucune extension n'est ajoutée dans ce cas). @@ -88,25 +88,25 @@ Le paramètre optionnel *paramObj* vous permet de définir plusieurs propriété **Notes sur le format Excel** : - - Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. +- Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier d'autres paramètres avec [cette liste de SpreadJS] (https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Using *excelOptions* object is recommended when exporting in ".xlsx" format. Make sure to not mix this object with legacy first level properties (*password*, *includeBindingSource*...) to avoid potiental issues. **Notes sur le format PDF** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format CSV** : - - Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. - - Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés. +- Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, voir [cet article sur Wikipédia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notes sur le format de fichier SpreadJS** : - - [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- [Fichiers SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) sont des fichiers zippés. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Une fois l'opération d'exportation terminée, `VP EXPORT DOCUMENT` déclenche automatiquement l'exécution de la méthode définie dans la propriété *formula* de *paramObj*, si elle est utilisée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md index ba7deb2c1a617b..7be68c67b0c15f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Vous pouvez définir où lire les feuilles de style via le paramètre *sheet* en passant le numéro d'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes : - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemple diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md index 6ef3aed705324f..c28b402a6b1381 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ L'objet retourné contiendra la propriété `value` et, dans le cas d'une valeur Si l'objet retourné inclut une date ou une heure, il est traité en tant que datetime et est complété comme suit : - - valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) - - valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) +- valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899) +- valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00) Si *rangeObj* contient plusieurs cellules ou plusieurs plages, la valeur de la première cellule est retournée. La commande retourne un objet null si la cellule est vide. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md index 5000ed7973c022..ceeabfea445387 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Dans *vpAreaName*, passez le nom de la zone 4D View Pro. Si vous passez un nom i Dans *filePath*, passez le chemin et le nom du document à importer. Les formats suivants sont pris en charge : - - Les documents 4D View Pro (extension ".4vp") - - Microsoft Excel (extension ".xlsx") - - documents texte (extension ".txt", ".csv", le document doit être en utf-8) - - [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") +- Les documents 4D View Pro (extension ".4vp") +- Microsoft Excel (extension ".xlsx") +- documents texte (extension ".txt", ".csv", le document doit être en utf-8) +- [Documents SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extension ".sjs") Si l'extension du document n'est pas une extension reconnue, telle que `.4vp` ou `.xlsx`, le document est considéré comme un document texte. Vous devez passer un chemin d'accès complet, sauf si le document est situé au même niveau que le dossier Project, auquel cas vous pouvez simplement passer son nom. @@ -73,11 +73,11 @@ Le paramètre optionnel *paramObj* vous permet de définir les propriétés du d :::note Notes - - Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importing files in .xslx, .csv, and .sjs formats is **asynchronous**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Lors de l'importation d'un fichier au format Microsoft Excel dans un document 4D View Pro, certains paramètres peuvent être perdus. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Pour plus d'informations sur le format CSV et les valeurs séparées par des délimiteurs en général, voir [cet article sur Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md index 60d66464e2227f..429215433cfae2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ La commande `VP RESIZE TABLE` modi Les règles suivantes s'appliquent : - - Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. - - Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. - - Si la table se développe sur des cellules contenant des données : +- Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale. +- Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un [contexte de données](vp-set-data-context.md), sinon elles sont supprimées. +- Si la table se développe sur des cellules contenant des données : - si des lignes sont ajoutées, les données sont supprimées, - si des colonnes sont ajoutées, les données sont conservées et affichées dans de nouvelles colonnes. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md index 44d8f2689dda1f..2b20cdb1f27596 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md @@ -37,20 +37,20 @@ Les feuilles de calcul sont composées de lignes et de colonnes. Un numéro est ### Sélection des cellules, des colonnes et des lignes - - Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. +- Pour sélectionner une cellule, il suffit de cliquer dessus ou d'utiliser les flèches de direction du clavier. Son contenu (ou sa formule) s'affiche dans la cellule. - - Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. +- Pour sélectionner plusieurs cellules continues, faites glisser la souris d'une extrémité à l'autre de la sélection. Vous pouvez également cliquer sur les deux extrémités de la sélection tout en maintenant la touche Maj enfoncée. - - Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : +- Pour sélectionner toutes les cellules dans la feuille de calcul, cliquez sur la cellule en haut à gauche de la zone : ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). +- Pour sélectionner une colonne, cliquez sur la lettre (ou le groupe de lettres) correspondant(e). - - Pour sélectionner une ligne, cliquez sur le chiffre correspondant. +- Pour sélectionner une ligne, cliquez sur le chiffre correspondant. - - Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. +- Pour sélectionner un groupe de cellules non continues, maintenez la touche **Ctrl** (Windows) ou **Command** (macOS) enfoncée et cliquez sur chaque cellule à sélectionner. - - Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. +- Pour désélectionner des cellules, il suffit de cliquer n'importe où dans la feuille de calcul. ### Saisie de données @@ -76,8 +76,8 @@ Les zones 4D View Pro bénéficient d'un menu contextuel automatique qui offre d En fonction de la zone cliquée, les options suivantes sont également disponibles : - - cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu - - cliquez sur une cellule ou une plage de cellules : +- cliquez sur un en-tête de colonne ou de ligne : **Insérer**, **Supprimer**, **Masquer** ou **Décompresser** le contenu +- cliquez sur une cellule ou une plage de cellules : - **Filtrer** : permet de masquer la ligne via des filtres (voir "Filtrer les lignes" dans la [documentation SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Trier** : permet de trier le contenu des colonnes. - **Insérer un commentaire** : permet à l'utilisateur de saisir un commentaire pour une zone. Lorsqu'un commentaire a été saisi pour une zone, la cellule supérieure gauche de la zone affiche un petit triangle rouge :\ @@ -128,8 +128,8 @@ Ensuite, vous pouvez passer `$myRange` à une autre méthode 4D View Pro pour mo Les objets plage 4D View Pro sont composés de plusieurs propriétés : - - area - Le nom de la zone 4D View Pro - - ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. +- area - Le nom de la zone 4D View Pro +- ranges - Une collection d'objet(s) plage. Les propriétés disponibles dans chaque objet de gamme dépendent du type d'objet plage. Par exemple, un objet plage de type colonne comprendra uniquement les propriétés *.column* et *.sheet*. | Propriété | | Type | Description | Disponible pour | | --------- | ------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | @@ -146,10 +146,10 @@ Les objets plage 4D View Pro sont composés de plusieurs propriétés : 4D View Pro prend en charge l'import et l'export de plusieurs formats de documents : - - .4vp - - .xlsx - - .txt et .csv - - .sjs - - .pdf (à des fins d'export uniquement) +- .4vp +- .xlsx +- .txt et .csv +- .sjs +- .pdf (à des fins d'export uniquement) Pour plus de détails, consultez la description de [VP IMPORT DOCUMENT](commands/vp-import-document.md) et [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md index be935548f38b11..d09a66e2938ac9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Certains autres éléments ont une casse différente (par exemple : `this` vs `T Les noms des commandes et des constantes QodlyScript sont écrits en camel case sans espaces. De plus, les noms de constantes de QodlyScript commencent par la lettre `k`. Vous devrez peut-être adapter ces éléments QodlyScript au langage 4D. - - Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. - - Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. +- Généralement, vous devrez simplement convertir les noms. Par exemple, `newCollection` dans QodlyScript est `New collection` dans le langage 4D. +- Cependant, certaines commandes ont été renommées pour une meilleure conformité, par exemple `atan` et `sqrt` sont les noms en QodlyScript des commandes `Arctan` et `Square root` en langage 4D. ### Exemple - - Code QodlyScript : +- Code QodlyScript : ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ Les noms des commandes et des constantes QodlyScript sont écrits en camel case end ``` - - Code équivalent en langage 4D : +- Code équivalent en langage 4D : ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md index 74201be81f79d1..fa269cbe8b4f6e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Dans les sections ci-dessus, nous obtenons un accès libre à l'application à p La façon la plus simple et sécurisée de connecter un utilisateur sur le serveur web 4D est basée sur le scénario suivant : - - Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) - - La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. +- Les utilisateurs sont stockés dans une table dédiée et non exposée (nommée *WebUsers* par exemple) +- La table *WebUsers* pourrait être [chiffrée](MSC/encrypt.md) et stocke le nom d'utilisateur et un hachage de leur mot de passe. 1. Créez une table avec certains champs, par exemple : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md index f60926b16c7b05..3f3bc43413eede 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Conditions requises Custom HTTP Request handlers are supported: - - when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- when [scalable sessions](./sessions.md#enabling-web-sessions) are enabled, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/.+/index\.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ URL patterns can be given as **prefixes** or using **regular expressions**. Les modèles d'URL sont déclenchés dans l'ordre indiqué : - - le premier motif correspondant est exécuté - - the following patterns are not executed even if they match the URL +- le premier motif correspondant est exécuté +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Class and method You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. It must be a [**shared**](../Concepts/classes.md#shared-singleton) and [**singleton**](../Concepts/classes.md#singleton-classes) class. +- "method": class function belonging to the class. [See below](#request-handler-code) for information about the request handler code. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* in the *UsersHandling* class - - *handleInvoices* in the *FinancialHandling* class - - *handleDocs* in the *DocsHandling* class - - *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class +- *handle function* in the *GeneralHandling* class +- *manageAccount* in the *UsersHandling* class +- *handleInvoices* in the *FinancialHandling* class +- *handleDocs* in the *DocsHandling* class +- *handleTheInvoice* / *handleDetails* / *handleInvoices* in the *InvoicesHandling* class Examples of URLs triggering the handlers: diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md index 1b23eea8d806ac..e7ba5e309ee91f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process | Serveur Web | coopératif | *paramètres web* | | Server Web Services | coopératif | *paramètres web* | - - Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) - - Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) - - Serveur de services Web : gère les requêtes SOAP - - ***web setting*** signifie que le mode préemptif dépend d'une valeur de réglage : +- Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) +- Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) +- Serveur de services Web : gère les requêtes SOAP +- ***web setting*** signifie que le mode préemptif dépend d'une valeur de réglage : - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - sinon, l'option [**Utiliser des process préemptifs**](webServerConfig.md#use-preemptive-processes) est prise en compte. - en ce qui concerne les process de service Web (serveur ou client), le mode préemptif est pris en charge au niveau de la méthode. You just have to select "Can be run in preemptive processes" property for published SOAP server methods (see [Publishing a Web Service with 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) or proxy client methods (see [Subscribing to a Web Service in 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) and make sure they are confirmed thread-safe by the compiler. @@ -35,21 +35,21 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souhaitez que les process Web soient lancés en mode préemptif. Lorsque l'option [Utiliser des process préemptifs](#availability-of-preemptive-mode-for-web-processes) est cochée dans le dialogue des Propriétés, les parties de l'application listées ci-dessous sont automatiquement évaluées par 4D Compiler : - - Toutes les méthodes base liées au web : +- Toutes les méthodes base liées au web : - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) et [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; +- La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; - - Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages - - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" +- Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" - - Triggers pour les tables comportant l'attribut "Expose as REST resource" +- Triggers pour les tables comportant l'attribut "Expose as REST resource" - - [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST +- [Fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) appelées via REST Pour chacune de ces méthodes ou parties de code, le compilateur vérifiera si les règles thread-safe sont respectées, et retournera une erreur en cas de problème. Pour plus d'informations à propos des règles thread-safe, veuillez vous référer au paragraphe *Ecrire une méthode thread-safe* dans le chapitre *Process* du manuel de [Langage 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ La plupart des commandes, fonctions, méthodes base et URLs 4D sont thread-safe Toutes les commandes 4D relatives au Web sont thread-safe, à savoir : - - toutes les commandes du thème *Web Server* - - toutes les commandes du thème *Client HTTP*. +- toutes les commandes du thème *Web Server* +- toutes les commandes du thème *Client HTTP*. Les méthodes base ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif (voir ci-dessus) : `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Bien sûr, le code exécuté par ces méthodes doit aussi être thread-safe. Les URLs Web Server ci-dessous sont thread-safe et peuvent être utilisées en mode préemptif : - - *4daction/* (la méthode projet appelée doit également être à thread-safe) - - *4dcgi/* (les méthodes base appelées doivent également être thread-safe) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) - - *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) +- *4daction/* (la méthode projet appelée doit également être à thread-safe) +- *4dcgi/* (les méthodes base appelées doivent également être thread-safe) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (généré par `PROCESS 4D TAGS` pour les requêtes web relatives aux champs images) +- *4dimg/* (généré par `PROCESS 4D TAGS` pour les requêtes web sur les variables image) ### Icône de process web préemptif diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md index f1490bbde78d3f..f16a65241179fc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio peut également être utilisé sur la [**plateforme Qodly Cloud**]( Qodly Studio proposes a full-featured web UI, allowing you to: - - create Qodly pages by placing components on a canvas - - map components to Qodly Sources - - déclencher du code 4D en configurant des événements - - et bien plus encore ! +- create Qodly pages by placing components on a canvas +- map components to Qodly Sources +- déclencher du code 4D en configurant des événements +- et bien plus encore ! ## Configuration @@ -24,19 +24,19 @@ Qodly Studio proposes a full-featured web UI, allowing you to: Qodly Studio prend en charge les navigateurs Web suivants : - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox La résolution recommandée est de 1920x1080. #### Application 4D - - Développement : 4D 20 R2 ou version ultérieure - - Déploiement : 4D Server 20 R2 ou version ultérieure - - Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). - - Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). - - Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). +- Développement : 4D 20 R2 ou version ultérieure +- Déploiement : 4D Server 20 R2 ou version ultérieure +- Qodly Studio ne fonctionne qu'avec des projets 4D (les bases de données binaires ne sont pas prises en charge). +- Les sessions web (*également appelées sessions évolutives*) doivent [être activées](sessions.md#enabling-web-sessions). +- Le code 4D appelé par les pages Qodly doit être [thread-safe](preemptiveWeb.md). ### Activer l'accès à Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio est alimenté par le [serveur WebAdmin](../Admin/webAdmin.md) et af Pour permettre l'accès à Qodly Studio, vous devez explicitement autoriser deux niveaux : - - au niveau de l'application 4D - - niveau projet +- au niveau de l'application 4D +- niveau projet Si l'un des deux niveaux (ou les deux) n'est pas activé, l'accès à Qodly Studio est refusé (une page 403 est renvoyée). @@ -79,8 +79,8 @@ L'authentification sur le serveur WebAdmin utilise une access key (clé d'accès Conformément à la gestion des projets 4D, seules les utilisations suivantes sont prises en charge : - - le développement avec Qodly Studio s'effectue avec **4D** (monoposte). - - deployment of 4D applications powered with Qodly pages must be done using **4D Server**. +- le développement avec Qodly Studio s'effectue avec **4D** (monoposte). +- deployment of 4D applications powered with Qodly pages must be done using **4D Server**. :::warning @@ -94,10 +94,10 @@ La page Qodly Studio est disponible lorsque le [serveur WebAdmin est lancé](../ Il y a deux façons d'accéder à Qodly Studio : - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). Si le serveur WebAdmin est déjà en cours d'exécution, selon sa configuration, votre navigateur par défaut s'ouvre à l'adresse `IPaddress:HTTPPort/studio` ou `IPaddress:HTTPSPort/studio`. Sinon, vous serez invité à démarrer d'abord le serveur web WebAdmin. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` ou : @@ -145,24 +145,24 @@ Il n'y a pas de compatibilité directe entre les applications implémentées ave The following commands and classes are dedicated to the server-side management of Qodly pages: - - [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. - - [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. - - [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. - - [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. +- [`Web Form`](../API/WebFormClass.md#web-form) command: returns the Qodly page as an object. +- [`Web Event`](../API/WebFormClass.md#web-event) command: returns events triggered within Qodly page components. +- [`WebForm`](../API/WebFormClass.md) class: functions and properties to manage the rendered Qodly page. +- [`WebFormItem`](../API/WebFormItemClass.md) class: functions and properties to manage Qodly page components. ### Utilisation des méthodes projet Nous recommandons d'utiliser les fonctions de classe plutôt que les méthodes projet. Seules les fonctions de classe peuvent être appelées à partir des composants. Cependant, vous pouvez toujours utiliser les méthodes projet dans Qodly Studio de deux manières : - - Vous pouvez appeler vos méthodes à partir des fonctions de classe. - - Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. +- Vous pouvez appeler vos méthodes à partir des fonctions de classe. +- Vous pouvez directement [exécuter vos méthodes](https://developer.qodly.com/docs/studio/coding#methods-and-classes) depuis l'Explorateur Qodly. ### Utilisation hors ligne Vous pouvez développer avec Qodly Studio lorsque votre ordinateur n'est pas connecté à internet. Dans ce cas cependant, les fonctions suivantes ne sont pas accessibles : - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide - - UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): la bibliothèque de templates (modèles) est vide +- UI tips (infobulles interface utilisateur) : ils ne sont pas affichés lorsque vous cliquez sur les icônes ![alt-text](../assets/en/WebServer/tips.png). ## Déploiement @@ -178,8 +178,8 @@ See [this page](https://developer.qodly.com/docs/studio/rendering) for detailed To enable the rendering of Qodly pages, the following options must be set. - - The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. - - Le [serveur Web 4D](webServer.md) doit être démarré. +- The 4D project's **Settings** > **Web** > **Web Features** > [**Expose as REST server**](../settings/web.md#expose-as-rest-server) option must be activated. +- Le [serveur Web 4D](webServer.md) doit être démarré. :::note @@ -309,9 +309,9 @@ To logout the user, you just need to execute the **Logout** standard action from Déclencher l'action de déconnexion d'une session utilisateur Web a les effets suivants : - - la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, - - la licence 4D associée est libérée, - - le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. +- la session utilisateur web courante perd ses privilèges, seules les [requêtes REST descriptives](../REST/authUsers.md#descriptive-rest-requests) sont autorisées, +- la licence 4D associée est libérée, +- le `Session.storage` est conservé jusqu'à ce que le délai d'inactivité de la session Web soit atteint (au moins une heure). Pendant cette période après une déconnexion, si l'utilisateur se connecte à nouveau, la même session est réutilisée et l'objet partagé `Session.storage` est disponible avec son contenu actuel. ## Utilisation de licences pour le rendu @@ -363,7 +363,7 @@ Pour plus d'informations sur l'attribut `SameSite`, consultez [cet article de bl Pour éviter d'utiliser plus de licences que nécessaire, nous vous recommandons d'effectuer l'une des actions suivantes : - - Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. - - Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. +- Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assurez-vous que Qodly Studio et votre base de données sont accessibles sur le même schéma d'URL. +- Utilisez la valeur `Lax` pour le [cookie de session](webServerConfig.md#session-cookie-samesite) du serveur web de la base de données de votre projet. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md index 003879e7952808..c71cb2bb77fe56 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md @@ -19,16 +19,16 @@ La valeur de la variable 4D *vtSiteName* sera insérée dans la page HTML. Les balises 4D suivantes sont disponibles : - - 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, - - 4DHTML, pour insérer du code HTML, - - 4DEVAL, pour évaluer toute expression 4D, - - 4DSCRIPT, pour exécuter une méthode 4D, - - 4DINCLUDE, pour inclure une page dans une autre, - - 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, - - 4DCODE, pour insérer du code 4D, - - 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, - - 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, - - 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. +- 4DTEXT, pour insérer des variables et des expressions 4D en tant que texte, +- 4DHTML, pour insérer du code HTML, +- 4DEVAL, pour évaluer toute expression 4D, +- 4DSCRIPT, pour exécuter une méthode 4D, +- 4DINCLUDE, pour inclure une page dans une autre, +- 4DBASE, pour modifier le dossier par défaut utilisé par la balise 4DINCLUDE, +- 4DCODE, pour insérer du code 4D, +- 4DIF, 4DELSE, 4DELSEIF et 4DENDIF, pour insérer des conditions dans le code HTML, +- 4DLOOP et 4DENDLOOP, pour faire des boucles dans le code HTML, +- 4DEACH et 4DENDEACH, pour boucler des collections, des entity selections ou des propriétés d'objets. Ces balises sont décrites dans la page [Balises de transformation](../Tags/transformation-tags.md). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md index 5eb1fb5bbc72d8..83c947cfc03387 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Un projet 4D peut démarrer et surveiller un serveur Web pour l'application prin Il y a plusieurs manières de démarrer le serveur Web principal : - - via un bouton/une commande de menu : +- via un bouton/une commande de menu : - 4D: **Exécution\>Démarrer le serveur Web**
![](../assets/en/WebServer/start1.png) - 4D Server : Bouton **Démarrer le serveur HTTP** dans la page Serveur HTTP
![](../assets/en/WebServer/start2.png) - - automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) +- automatiquement à l'ouverture de l'application 4D. Pour ce faire, affichez la page **Web\/Configuration** des Propriétés et cochez la case **Lancer le serveur Web au démarrage** :
![](../assets/en/WebServer/config.png) - - Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. +- Par programmation, en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) ou la commande `WEB START SERVER`. Le serveur Web de n'importe quel composant peut être lancé en appelant la fonction [`webServer.start()`](API/WebServerClass.md#start) sur l'objet serveur Web du composant. @@ -29,9 +29,9 @@ Le serveur Web de n'importe quel composant peut être lancé en appelant la fonc Il y a plusieurs manières d'arrêter le serveur Web principal : - - Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). +- Via le menu 4D, **Exécution > Arrêter le serveur Web**, ou via le bouton **Arrêter le serveur HTTP** de 4D Server (les deux items affichent **Démarrer...** quand le serveur n'est pas encore démarré). - - Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. +- Par programmation, en appelant la fonction [`webServer.stop()`](API/WebServerClass.md#stop) ou la commande `WEB STOP SERVER`. Le serveur Web de n'importe quel composant peut être arrêté en appelant la fonction `webServer.stop()` sur l'objet serveur Web du composant. @@ -53,8 +53,8 @@ Cette commande vous permet de vérifier que le serveur web, l'affichage de la pa Pour ce faire, vous pouvez : - - 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. - - 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. +- 4D: cliquer sur le bouton **Vider le cache** dans la [page Web/Options (I)](../settings/web.md) de la boîte de dialogue des Propriétés. +- 4D Server : cliquer sur le bouton **Vider le cache** dans la page HTTP de la fenêtre d'administration de 4D Server. Le cache est alors immédiatement effacé. @@ -64,11 +64,11 @@ Le cache est alors immédiatement effacé. La page **Watch** (rubrique **Web**) de l'Explorateur d'exécution affiche les informations du serveur Web, notamment : - - **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. +- **Occupation du cache Web** : indique le nombre de pages présentes dans le cache web ainsi que le pourcentage d'utilisation. Cette information n'est disponible que si le serveur web est actif et que la taille du cache est supérieure à 0. - - **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. +- **Temps d’activité du serveur Web** : indique la durée d'utilisation (au format heures:minutes:secondes) du serveur Web. Ces informations ne sont disponibles que si le serveur web est actif. - - **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. +- **Nombre de requêtes http** : indique le nombre total de requêtes HTTP reçues depuis le démarrage du serveur web, ainsi qu'un nombre instantané de requêtes par seconde (mesure prise entre deux mises à jour de l'Explorateur d'exécution). Ces informations ne sont disponibles que si le serveur web est actif. ## URLs d'administration @@ -123,8 +123,8 @@ L'URL */4DWEBTEST* permet de vérifier l'état du serveur web. Lorsque cette URL 4D vous permet de générer deux historiques de requêtes Web : - - un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), - - un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). +- un historique de débogage, utile dans la phase de développement du serveur web (*HTTPDebugLog.txt*), +- un journal standardisé des requêtes web, plutôt utilisé à des fins statistiques (*logweb.txt*). Les deux fichiers journaux sont automatiquement créés dans le dossier **Logs** du projet d'application. @@ -225,15 +225,15 @@ Les paramètres de sauvegarde automatique du logweb.txt sont définis sur la pag D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md index 69ce160f5ae2d3..d49a4de96f110b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Liste des hôtes et méthodes autorisé(e)s pour le service CORS. Nom de domaine ou adresse IP à partir desquels les pages externes sont autorisées à envoyer des demandes de données au serveur via CORS. Plusieurs attributs de domaine peuvent être ajoutés pour créer une liste blanche. Plusieurs syntaxes sont supportées : - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Méthodes HTTP autorisées (propriété méthodes) Méthodes HTTP acceptées pour l'hôte CORS correspondant. Les méthodes HTTP suivantes sont prises en charge : - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Séparez chaque méthode par un ";" (ex : "post;get"). Si Méthodes est vide, null ou non défini, toutes les méthodes sont activées. @@ -145,9 +145,9 @@ Par défaut, quand le serveur web est lancé pour la première fois, 4D crée un Vous pouvez désigner une autre page comme page d'accueil par défaut en entrant son chemin d'accès : - - Le chemin est relatif au [dossier HTML racine ](#root-folder), - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Le chemin ne doit pas commencer ou finir par un slash. +- Le chemin est relatif au [dossier HTML racine ](#root-folder), +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Le chemin ne doit pas commencer ou finir par un slash. Par exemple, pour que la page d'accueil par défaut soit "MyHome.htm", si elle se trouve dans le dossier "Web" (lui-même situé dans le dossier racine HTML par défaut), utilisez "Web/MyHome.htm". @@ -318,15 +318,15 @@ Valeurs possibles: Chaîne de caractères représentant l'adresse IP. Les format #### À propos du support de l'IPv6 - - **Aucun avertissement lorsque le port TCP est occupé**
+- **Aucun avertissement lorsque le port TCP est occupé**
Lorsque le serveur est configuré pour répondre sur "Toutes" les adresses IP, si le port TCP est utilisé par une autre application, cela n'est pas indiqué au démarrage du serveur. En fait, le serveur 4D ne détecte pas d'erreur dans ce cas car le port reste libre sur l'adresse IPv6. Cependant, il n'est pas possible d'y accéder en utilisant l'adresse IPv4 de la machine, ni au moyen de l'adresse locale : 127.0.0.1. Si votre serveur 4D ne semble pas répondre sur le port défini, vous pouvez tester l'adresse [::1] sur la machine serveur (équivalent à 127.0.0.1 pour IPv6, ajoutez [:portNum] pour tester un autre numéro de port). Si 4D répond, il est probable qu'une autre application utilise le port en IPv4. - - **Adresses IPv6 avec mappage d'IPv4**
+- **Adresses IPv6 avec mappage d'IPv4**
Pour standardiser le traitement, 4D fournit une représentation hybride standard des adresses IPv4 en IPv6. Ces adresses sont écrites avec un préfixe de 96 bits au format IPv6, suivi de 32 bits écrits dans la notation décimale à point d'IPv4. Par exemple, ::ffff:192.168.2.34 représente l'adresse IPv4 192.168.2.34. - - **Indication des numéros de port**
+- **Indication des numéros de port**
Comme la notation IPv6 utilise les deux-points (:), l'ajout de numéros de port peut entraîner une certaine confusion, par exemple : ```code4d @@ -420,10 +420,10 @@ Version TLS minimale acceptée pour les connexions. Les tentatives de connexion Valeurs possibles : - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (par défaut) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (par défaut) +- 4 = TLSv1_3 En cas de modification, le serveur doit être redémarré pour utiliser la nouvelle valeur. @@ -489,10 +489,10 @@ Par exemple : Disallow: /GIFS/ ``` - - “User-Agent: \*” - tous les robots sont concernés. - - “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. - - "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. - - "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. +- “User-Agent: \*” - tous les robots sont concernés. +- “Disallow: /4D” - Les robots ne sont pas autorisés à accéder aux URLs commençant par /4D. +- "Disallow : /%23%23" - les robots ne sont pas autorisés à accéder aux URL commençant par /%23%23. +- "Disallow : /GIFS/' - les robots ne sont pas autorisés à accéder au dossier /GIFS/ ou à ses sous-dossiers. Autre exemple : @@ -517,15 +517,15 @@ De plus, le dossier racine HTML définit, sur le disque dur du serveur web, le n Par défaut, 4D définit un dossier racine HTML nommé **WebFolder**. S'il n'existe pas encore, le dossier racine HTML est physiquement créé sur le disque au moment où le serveur Web est lancé pour la première fois. Le dossier racine est créé : - - avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). - - avec 4D en mode remote, dans le fichier des ressources locales. +- avec 4D en mode local ou 4D Server, à côté du [dossier du projet](Project/architecture.md#project-folder). +- avec 4D en mode remote, dans le fichier des ressources locales. Vous pouvez désigner un autre dossier HTML racine comme page d'accueil par défaut en entrant son chemin d'accès. - - Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). - - Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), - - Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier - - Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). +- Le chemin est relatif au [dossier du projet](Project/architecture.md#project-folder) (4D local et 4D Server) ou au dossier contenant l'application 4D ou le package logiciel (4D en mode distant). +- Le chemin ext exprimé avec la syntaxe POSIX (les dossiers sont séparés par un slash (/)), +- Pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (deux points) avant le nom de dossier +- Le chemin ne doit pas commencer par une barre oblique (sauf si vous souhaitez que le dossier racine HTML soit le dossier distant du projet ou de 4D, pour interdire l'accès aux dossiers au-dessus, auquel cas vous pouvez passer "/" comme dossier racine). Par exemple, si vous voulez que le dossier racine HTML soit le sous-dossier "Web" du dossier "MyWebApp", entrez "MyWebApp/Web". @@ -580,9 +580,9 @@ Valeur de l'attribut `SameSite` du cookie de session. Cet attribut vous permet d Trois valeurs sont disponibles : - - "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. - - "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). - - "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). +- "Strict" (valeur par défaut de l'attribut`SameSite` pour les cookies de session 4D) : les cookies ne seront envoyés que dans le contexte de première partie, c'est-à-dire le contexte correspondant au domaine du site, et jamais à des sites Web tiers. +- "Lax" : Les cookies ne sont pas envoyés lors de sous-requêtes intersites (par exemple pour charger des images ou des cadres dans un site tiers), mais sont envoyés lorsqu'un utilisateur navigue vers le site d'origine (c'est-à-dire lorsqu'il suit un lien). +- "None" : Les cookies sont envoyés dans tous les contextes, c'est-à-dire dans les réponses aux demandes primaires et cross-origin. Lorsque la valeur "None" est utilisée, l'attribut du cookie `Secure` doit également être défini (sinon le cookie sera bloqué). La valeur de l'attribut `Secure` du cookie de session est automatiquement définie sur "True" si la connexion est HTTPS (quelle que soit la valeur de l'attribut `SameSite`). @@ -626,9 +626,9 @@ Dans certains cas, d'autres fonctions internes optimisées peuvent être appelé Deux options permettent de définir le mode de fonctionnement des connexions persistantes : - - **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de requêtes par connexion permet d'éviter la saturation du serveur, provoquée par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

+- **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de requêtes par connexion permet d'éviter la saturation du serveur, provoquée par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

La valeur par défaut (100) peut être augmentée ou diminuée en fonction des ressources de la machine hébergeant le serveur Web 4D.

- - **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois ce délai écoulé, le serveur ferme la connexion.

+- **Délai avant déconnexion** : Cette valeur définit l'attente maximale (en secondes) pour le maintien d'une connexion TCP sans réception d'une requête de la part du navigateur web. Une fois ce délai écoulé, le serveur ferme la connexion.

Si le navigateur Web envoie une requête après la fermeture de la connexion, une nouvelle connexion TCP est automatiquement créée. Cette opération est invisible pour l'utilisateur.

diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md index 22c7a8f9e814dd..aefd09100c335e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Un projet 4D peut démarrer et piloter un serveur Web pour l'application princip Par exemple, si vous avez installé deux composants dans votre application principale, vous pouvez démarrer et contrôler jusqu'à trois serveurs Web indépendants à partir de votre application : - - un serveur web pour l'application hôte, - - un serveur web pour le composant n°1, - - un serveur web pour le composant n°2. +- un serveur web pour l'application hôte, +- un serveur web pour le composant n°1, +- un serveur web pour le composant n°2. En dehors de la mémoire, il n'y a pas de limite au nombre de composants et donc, de serveurs Web, pouvant être rattachés à un seul projet d'application 4D. @@ -19,9 +19,9 @@ Chaque serveur web 4D, y compris le serveur web de l'application principale, est Chaque serveur web (application hôte ou composant) peut être utilisé dans son propre contexte, notamment : - - les appels vers la méthode base `On Web Authentication` et `On Web Connection` - - le traitement des balises 4D et les appels de méthodes, - - sessions web et gestion du protocole TLS. +- les appels vers la méthode base `On Web Authentication` et `On Web Connection` +- le traitement des balises 4D et les appels de méthodes, +- sessions web et gestion du protocole TLS. Cela vous permet de développer des composants indépendants et des fonctionnalités qui accompagnent leurs propres interfaces Web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Si l'application utilise des composants et que vous souhaitez appeler : - - le serveur Web de l'application hôte à partir d'un composant ou - - le serveur qui a reçu la requête (quel que soit le serveur) +- le serveur Web de l'application hôte à partir d'un composant ou +- le serveur qui a reçu la requête (quel que soit le serveur) vous pouvez également utiliser : @@ -94,8 +94,8 @@ Ces propriétés sont définies : 2. si elles ne sont pas utilisées, à l'aide de la commande `WEB SET OPTION` (applications hôtes uniquement), 3. si elles ne sont pas utilisées, dans les propriétés de l'application hôte ou du composant. - - Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. - - Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). +- Si le serveur Web n'est pas démarré, les propriétés contiennent les valeurs qui seront utilisées au prochain démarrage du serveur Web. +- Si le serveur Web est démarré, les propriétés contiennent les valeurs réelles utilisées par le serveur Web (les paramètres par défaut peuvent avoir été remplacés par le paramètre `settings` de la fonction [`.start()`](API/WebServerClass.md#start). > *isRunning*, *name*, *openSSLVersion* et *perfectForwardSecrecy* sont des propriétés en lecture seule qui ne peuvent pas être prédéfinies dans le paramètre objet `settings` pour la fonction [`start()`](API/WebServerClass.md#start). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md index 7f5b5c680bfea3..d9285ee439492b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ La commande **WP Insert break** ins Dans *targetObj*, passez : - - une plage, ou - - un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou - - un document 4D Write Pro +- une plage, ou +- un élément (tableau / ligne / paragraphe / corps / en-tête / pied de page / image en ligne / section / sous-section), ou +- un document 4D Write Pro Dans *breakType*, passez l'une des constantes suivantes du thème *4D Write Pro Constants* pour définir le type de break à insérer : @@ -62,7 +62,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio | wk prepend | Integer | 1 | Insérer le contenu au début de la cible | | wk replace | Integer | 0 | Remplacer le contenu de la cible | - - Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : +- Si *targetObj* est une plage, vous pouvez utiliser le paramètre facultatif *rangeUpdate* pour transmettre l'une des constantes suivantes afin de spécifier si le contenu inséré est inclus ou non dans la plage résultante : | Constante | Type | Valeur | Commentaire | | --------------------- | ------- | ------ | ------------------------------------------------------------------------------- | @@ -71,7 +71,7 @@ Dans le paramètre *mode*, passez une constante pour indiquer le mode d'insertio Si vous ne passez pas un paramètre *rangeUpdate*, par défaut, le contenu inséré est inclus dans la plage résultante. - - Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. +- Si *targetObj* n'est pas une plage, *rangeUpdate* est ignoré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md index f83b3a2c602bdd..46ec6f90585fa9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandLa commande **Form** renvoie l'objet associé au formulaire courant (instancié à partir du paramètre *formData* ou de la classe utilisateur attribuée dans l'éditeur de formulaire). 4D associe automatiquement un objet au formulaire courant dans les cas suivants : - - le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), - - le formulaire courant est un sous-formulaire, - - un formulaire table est actuellement affiché à l'écran. +- le formulaire courant a été chargé par l'une des commandes [`DIALOG`](dialog.md), [`Print form`](print-form.md), ou [`FORM LOAD`](form-load.md), +- le formulaire courant est un sous-formulaire, +- un formulaire table est actuellement affiché à l'écran. ### Commandes (DIALOG...) Si le formulaire courant est affiché ou chargé par un appel aux commandes [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** renvoie soit : - - l'objet *formData* passé en paramètre à cette commande, le cas échéant, - - ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, - - ou un objet vide. +- l'objet *formData* passé en paramètre à cette commande, le cas échéant, +- ou un objet instancié de la [classe utilisateur associée au formulaire](../FormEditor/properties_FormProperties.md#form-class), le cas échéant, +- ou un objet vide. ### Sous-formulaire Si le formulaire courant est un sous-formulaire, l'objet renvoyé dépend de la variable du conteneur parent : - - **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ +- **Form** retourne l'objet associé au formulaire table affiché à l'écran.\ Dans le contexte d'un formulaire de saisie affiché à partir d'un formulaire de sortie (c'est-à-dire après un double-clic sur un enregistrement), l'objet retourné contient la propriété suivante : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. +- Si la variable associée au conteneur parent n'a pas été typée en tant qu'objet, **Form** renvoie un objet vide, géré par 4D dans le contexte du sous-formulaire. Pour plus d'informations, veuillez vous référer à la section *Sous-formulaires en page*. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md index 457e0da1d396c5..5b553fcd1c85d3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Si l'indice du nouvel élément est au-delà du dernier élément existant de la Vous pouvez passer tout nombre de valeurs de n'importe quel type pris en charge : - - nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. - - text - - boolean - - date - - heure (stockée en nombre de milliseconds - réel) - - Null - - Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. - - *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. +- nombre (réel, entier...). Les valeurs numériques sont toujours stockées sous forme de réels. +- text +- boolean +- date +- heure (stockée en nombre de milliseconds - réel) +- Null +- Si vous souhaitez que l'évaluation soit sensible à la casse ou pour différencier des caractères accentués, passez la constante `ck diacritical` dans le paramètre option. +- *$1.stop* (booléen, optionnel) : **true** pour stopper le rétroappel de la méthode. :::note diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md index 4b98187d7cf741..9e5f7ad5a9d05f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs Dans le paramètre *form*, vous pouvez passer soit : - - le nom d'un formulaire, - - le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou - - un objet contenant la description du formulaire à utiliser. +- le nom d'un formulaire, +- le chemin d'accès (en syntaxe POSIX) d'un fichier .json valide contenant une description du formulaire à utiliser (voir *Chemin d'accès au fichier de formulaire*), ou +- un objet contenant la description du formulaire à utiliser. Comme **Print form** ne génère pas de saut de page après avoir imprimé un formulaire, elle vous permet de combiner facilement différents formulaires sur la même page. Ainsi, **Print form** est idéale pour effectuer des impressions complexes impliquant plusieurs tables et plusieurs formulaires. Pour forcer un saut de page entre les formulaires, utilisez la commande [PAGE BREAK](../commands-legacy/page-break.md). Pour reporter l'impression à la page suivante d'un formulaire dont la hauteur est supérieure à l'espace disponible, appelez la commande [CANCEL](../commands-legacy/cancel.md) avant la commande [PAGE BREAK](../commands-legacy/page-break.md). Trois syntaxes différentes peuvent être utilisées : - - **Impression du corps d'un formulaire** +- **Impression du corps d'un formulaire** Syntaxe : @@ -43,7 +43,7 @@ Syntaxe : Dans ce cas, **Print form** n'imprime que la zone de corps du formulaire (la zone comprise entre les marqueur d'en-tête et de corps). - - **Impression de zone de formulaire** +- **Impression de zone de formulaire** Syntaxe : @@ -79,7 +79,7 @@ Dans ce cas, la commande imprime la section désignée par *marker*. Passez dans | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impression de section** +- **Impression de section** Syntaxe : @@ -101,8 +101,8 @@ La valeur retournée par **Print form** indique la hauteur de la zone d’impres Les boîtes de dialogue standard d'impression n'apparaissent pas lorsque vous utilisez la commande **Print form**. L'état généré ne tient pas compte des paramètres d'impression définis en mode Développement pour le formulaire. Il y a deux manières de définir les paramètres d'impression avant d'effectuer une série d'appels à **Print form** : - - Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. - - Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. +- Appeler [PRINT SETTINGS](../commands-legacy/print-settings.md). Dans ce cas, vous laissez l'utilisateur définir ses paramètres dans les boîtes de dialogue d'impression. +- Appeler [SET PRINT OPTION](../commands-legacy/set-print-option.md) et [GET PRINT OPTION](../commands-legacy/get-print-option.md). Dans ce cas, les paramètres sont définis par programmation. **Print form** construit chaque page à imprimer en mémoire. Chaque page est imprimée lorsque la page en mémoire est remplie ou lorsque vous appelez [PAGE BREAK](../commands-legacy/page-break.md). Pour vous assurer que la dernière page d'une impression exécutée par l'intermédiaire de **Print form** est effectivement imprimée, il faut terminer par la commande [PAGE BREAK](../commands-legacy/page-break.md) (sauf dans le cadre d'un [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md), voir note). Sinon, la dernière page, si elle n'est pas remplie, reste en mémoire et n'est pas imprimée. @@ -116,8 +116,8 @@ Cette commande permet d'imprimer des zones et des objets externes (par exemple, **4D Server:** Cette commande peut être exécutée sur 4D Server dans le cadre d'une procédure stockée. Dans ce contexte : - - Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). - - Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. +- Veillez à ce qu'aucune boîte de dialogue n'apparaisse sur la machine serveur (sauf exigence particulière). +- Dans le cas d'un problème concernant l'imprimante (manque de papier, imprimante déconnectée, etc.), aucun message d'erreur n'est généré. ## Exemple 1 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md index 1884e7d3fc1f52..beaa5cb365a0b5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md @@ -44,7 +44,7 @@ L'objet retourné contient les propriétés suivantes : | type | Integer | Type de process en cours d'exécution. Valeurs possibles : voir ci-dessous | | visible | Boolean | Vrai si visible, faux sinon | - - Valeurs possibles pour "state" : +- Valeurs possibles pour "state" : | Constante | Valeur | | ------------------------- | ------ | @@ -57,7 +57,7 @@ L'objet retourné contient les propriétés suivantes : | Waiting for internal flag | 4 | | Paused | 5 | - - Valeurs possibles pour "type" : +- Valeurs possibles pour "type" : | Constante | Valeur | | ----------------------------- | ------ | diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/session.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/session.md index e6e0b844d3486f..4a89b74547e797 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/session.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Voir également +## Voir également [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md index 6087df4d15d96f..553b3374234af0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md @@ -13,8 +13,8 @@ Les pages Client-serveur regroupent les propriétés liées à l'utilisation de Cette option vous permet d'indiquer si la base de données 4D Server apparaîtra ou non dans la liste des bases de données publiées. - - Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). - - Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. +- Lorsque cette option est cochée (par défaut), la base de données est rendue publique et apparaît dans la liste des bases de données publiées (onglet **Disponible**). +- Lorsque l'option n'est pas cochée, la base de données n'est pas rendue publique et n'apparaît pas dans la liste des bases de données publiées. Pour se connecter, les utilisateurs doivent saisir manuellement l'adresse de la base de données dans l'onglet **Personnalisé** de la boîte de dialogue de connexion. :::note @@ -49,11 +49,11 @@ Pour mettre à jour les autres machines clientes qui ne sont pas connectées, il 4D Server utilise trois ports TCP pour les communications entre les serveurs internes et les clients : - - **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). - - **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). - - **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ +- **SQL Server** : 19812 par défaut (peut être modifié via la page "SQL/Configuration" des Préférences). +- **Serveur d'application** : 19813 par défaut (peut être modifié via la page "Client-Serveur/Configuration" des Préférences, voir ci-dessus). +- **DB4D Server** (serveur de base de données) : 19814 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 1. Lorsqu'un client 4D se connecte à 4D Server, il utilise le port TCP du serveur d'application (19813 ou le port indiqué après le signe ':' dans l'adresse IP affichée dans la boîte de dialogue de connexion). La connexion aux autres serveurs via leurs ports respectifs est alors automatique ; il n'est plus nécessaire de les spécifier.\ Notez que dans le cas d'un accès via un routeur ou un pare-feu, les ports TCP doivent être ouverts explicitement. - - [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. +- [**Débogueur à distance**](../Debugging/debugging-remote.md) : 19815 par défaut. Ce numéro de port ne peut pas être modifié directement mais il est toujours composé du numéro de port du serveur d'application + 2. #### Authentification de l'utilisateur auprès du serveur de domaine @@ -67,9 +67,9 @@ Lorsque l'authentification unique (SSO) est activée (voir ci-dessus), vous deve Cette liste déroulante contient 3 options de couche réseau : **Historique**, **ServerNet** et **QUIC** (uniquement en mode projet), qui sont utilisées pour gérer les communications entre le serveur 4D et les machines 4D distantes (clients). - - **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). - - **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. +- **Historique** : Cette ancienne couche réseau "historique" est toujours prise en charge afin d'assurer la compatibilité avec les bases de données créées avant la version 15. Cette couche réseau peut également être activée par programmation à l'aide de la commande [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (par défaut) : Active la couche réseau ServerNet sur le serveur (disponible depuis 4D v15). +- **QUIC** (disponible uniquement en mode projet) : Active la couche réseau QUIC sur le serveur. **Notes** : @@ -109,9 +109,9 @@ Cette option permet d'activer le mode sécurisé pour les communications entre l Ce paramètre permet de définir globalement le mode de mise à jour de l'instance locale du dossier **Resources** sur les machines 4D connectées lorsque le dossier **Resources** de la base de données est modifié en cours de session (le dossier **Ressources** est automatiquement synchronisé sur la machine distante à chaque ouverture de session). Trois paramètres sont disponibles : - - **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. - - **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ +- **Jamais** : Le dossier **Resources** local n'est pas mis à jour pendant la session. La notification envoyée par le serveur est ignorée. Le dossier **Resources** local peut être mis à jour manuellement à l'aide de la commande **Update Local Resources** du menu d'action (voir [Utilisation de l'explorateur de ressources](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Toujours** : La synchronisation du dossier local **Resources** est automatiquement effectuée pendant la session chaque fois qu'une notification est envoyée par le serveur. +- **Demander** : Lorsque la notification est envoyée par le serveur, une boîte de dialogue est affichée sur les postes clients, indiquant la modification. L'utilisateur peut ensuite accepter ou refuser la synchronisation du dossier **Resources** local.\ Le dossier **Resources** centralise les fichiers personnalisés nécessaires à l'interface de la base de données (fichiers de traduction, images, etc.). Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. Des mécanismes automatiques ou manuels permettent de notifier chaque client lorsque le contenu de ce dossier a été modifié. ## Page Configuration IP @@ -124,10 +124,10 @@ Cette table vous permet de définir des règles de contrôle d’accès à la ba Le fonctionnement de la table de configuration est le suivant : - - La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. - - La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. - - L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. - - Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : +- La colonne “Autoriser-Refuser” permet de sélectionner le type de règle à appliquer (Autoriser ou Refuser) à l’aide d’un pop up menu. Pour ajouter une règle d’adresses, cliquez sur le bouton Ajouter. Une nouvelle ligne apparaît dans la table. Le bouton **Supprimer** permet de supprimer la ligne courante. +- La colonne “Adresse IP” permet de désigner la ou les adresse(s) IP concernée(s) par la règle. Pour spécifier une adresse, cliquez dans la colonne et saisissez l’adresse sous la forme 123.45.67.89 (format IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (format IPv6). Vous pouvez utiliser le caractère \* (étoile) pour spécifier des adresses du type “commence par”. Par exemple, 192.168.\* indique toutes les adresses débutant par 192.168. +- L’application des règles s’effectue dans l’ordre d’affichage de la table. Si deux règles sont contradictoires, la priorité sera accordée à la règle située le plus haut dans le tableau. Vous pouvez réordonner les lignes en modifiant le tri courant (cliquez sur un en-tête de colonne pour alterner le sens de tri). Vous pouvez également déplacer des lignes par glisser-déposer. +- Pour des raisons de sécurité, seules les adresses correspondant à une règle d’autorisation explicite pourront se connecter. En particulier, si la table contient uniquement une ou plusieurs règle(s) de type Refuser, toutes les adresses seront refusées car aucune ne satisfera à au moins une règle. Si vous souhaitez refuser certaines adresses et autoriser toutes les autres, ajoutez une règle Autoriser \* à la fin de la table. Par exemple : - Refuser 192.168.\* (refuser toutes adresses débutant par 192.168) - Autoriser \* (et autoriser les autres) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md index dfe730e6c2aeea..53417de66be248 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md @@ -10,10 +10,10 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants.\ > Cette page répertorie les options de compatibilité disponibles pour les bases de données/projets convertis à partir de 4D 18 et suivants. Pour les options de compatibilité plus anciennes, consultez la [page Compatibilité](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) sur **doc.4d.com**. - - **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. +- **Utiliser l'ancienne couche réseau** : À partir de 4D v15, les applications 4D proposent une nouvelle couche réseau, nommée *ServerNet*, pour gérer les communications entre 4D Server et les postes 4D distants (clients). L'ancienne couche réseau devient obsolète, mais est conservée pour assurer la compatibilité des bases existantes. A l'aide de cette option, vous pouvez activer ou désactiver à tout moment l'ancienne couche réseau dans vos applications 4D Server en fonction de vos besoins. *ServerNet* est automatiquement utilisé pour les nouvelles bases de données et les bases de données converties depuis une version 15 ou ultérieure. A noter qu'en cas de modification de l'option, vous devez redémarrer l'application pour que le changement soit pris en compte. Toute application cliente qui était connectée doit également être redémarrée afin de se connecter avec la nouvelle couche réseau. **Note :** Cette option peut également être gérée par programmation en utilisant la commande `SET DATABASE PARAMETER`. - - **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : +- **Utiliser XPath standard :** Par défaut, cette option est désélectionnée pour les bases converties depuis une version de 4D antérieure à la 18 R3, et est cochée pour les bases créées sous une version 4D 18 R3 ou une version plus récente. A partir de la version 18 R3, l'implémentation de XPath dans 4D a été modifiée pour une meilleure conformité et pour la prise en charge d'un plus grand nombre de prédicats. Par conséquent, les fonctionnalités non standard de l'implémentation antérieure ne fonctionnent plus. Elles incluent : - le caractère "/" initial n'est pas seulement le noeud racine - l'utilisation du caractère / comme premier caractère d'une expression XPath ne déclare pas un chemin absolu à partir du noeud racine - pas de noeud courant implicite - le noeud courant doit être intégré dans l'expression XPath @@ -21,12 +21,12 @@ La page Compatibilité regroupe les paramètres relatifs au maintien de la compa Même si ces fonctionnalités ne sont pas standard, vous pourriez vouloir continuer à les utiliser afin que votre code continue de fonctionner comme avant -- dans ce cas, il vous suffit de *désélectionner* l'option. On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Utiliser LF comme caractère de fin de ligne sur macOS :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit les fichiers texte avec un saut de ligne (LF) comme caractère de fin de ligne (EOL) par défaut au lieu de Retour Chariot (CR) (CRLF pour xml SAX) sur macOS dans les nouveaux projets. Si vous souhaitez bénéficier de ce nouveau comportement dans les projets convertis à partir de versions antérieures de 4D, cochez cette option. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Ne pas ajouter de BOM lors de l'écriture d'un fichier texte unicode par défaut :** À partir de 4D 19 R2 (et 4D 19 R3 pour les fichiers XML), 4D écrit des fichiers texte sans BOM ("Byte order mark") par défaut. Dans les versions antérieures, les fichiers texte étaient écrits avec un BOM par défaut. Sélectionnez cette option si vous souhaitez activer le nouveau comportement dans les projets convertis. Voir [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), et [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). +- **Traduire les NULL en valeurs vides non cochée par défaut à la création d'un champ** : Pour une meilleure conformité avec les spécifications ORDA, dans les bases de données créées avec 4D 19 R4 et versions ultérieures, la propriété de champ **Traduire les NULL en valeurs vides** est non cochée par défaut lors de la création des champs. Vous pouvez appliquer ce comportement par défaut à vos bases de données converties en cochant cette option (il est recommandé de travailler avec des valeurs Null car elles sont entièrement prises en charge par [ORDA](../ORDA/overview.md)). - - **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). +- **Impression non-bloquante** : À partir de 4D 20 R4, chaque process a ses propres paramètres d'impression (options d'impression, imprimante courante, etc.), ce qui vous permet d'exécuter plusieurs tâches d'impression simultanément. Cochez cette option si vous souhaitez bénéficier de cette nouvelle implémentation dans vos projets 4D convertis ou dans les bases de données converties du mode binaire au mode projet. **Lorsque l'option n'est pas cochée**, l'implémentation précédente est appliquée : les paramètres d'impression 4D courants sont appliqués globalement, l'imprimante passe en mode "occupé" lorsqu'un job d'impression est en cours, vous devez appeler `CLOSE PRINTING JOB` pour que l'imprimante soit disponible pour le prochain job d'impression (consultez la documentation 4D précédente pour plus d'informations). - - **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file +- **Sauvegarder les couleurs et les coordonnées de la structure dans un fichier catalog_editor.json séparé** : À partir de 4D 20 R5, les modifications apportées dans l'éditeur de Structure concernant l'apparence graphique des tables et des champs (couleur, position, ordre...) sont sauvegardées dans un fichier séparé nommé `catalog_editor.json`, stocké dans le dossier [Sources](../Project/architecture.md#sources) du projet. Cette nouvelle architecture de fichiers facilite la gestion des conflits de fusion dans les applications de gestion de versions (VCS) car le fichier `catalog.4DCatalog` ne contient désormais que les modifications cruciales de la structure de la base de données. Pour des raisons de compatibilité, cette fonctionnalité n'est pas activée par défaut dans les projets convertis à partir des versions précédentes de 4D, vous devez cocher cette option. Lorsque la fonctionnalité est activée, le fichier `catalog_editor.json` est créé lors de la première modification dans l'éditeur de structure. \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/database.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/database.md index d3189e6cb35434..14fe3f3aae2351 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/database.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/database.md @@ -31,9 +31,9 @@ L’emplacement courant de ce dossier est affiché dans la zone “Actuel :”. Trois options d’emplacement sont proposées : - - \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. - - **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. - - **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. +- \*\*Système \*\*: Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier situé à l’emplacement spécifié par Windows ou macOS. You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. Les fichiers sont placés dans un sous-dossier dont le nom est construit à partir du nom de la base et d’un identifiant unique. +- **Dossier du fichier de données** (option par défaut) : Lorsque cette option est sélectionnée, les fichiers temporaires 4D sont créés dans un dossier nommé “temporary files” situé au même niveau que le fichier de données de la base. +- **Défini par l’utilisateur** : Cette option permet de définir un emplacement personnalisé. En cas de modification de cette option, sa prise en compte nécessitera le redémarrage de la base. 4D vérifie que le dossier sélectionné est accessible en écriture. Si ce n’est pas le cas, l’application essaiera les autres options jusqu’à ce qu’un dossier valide soit trouvé. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +41,7 @@ Trois options d’emplacement sont proposées : > Si vous modifiez ces options, vous devez quitter et rouvrir la base afin que la modification soit prise en compte. A la réouverture, une réindexation automatique est effectuée sur tous les index de la base. - - **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. +- **Considérer @ comme joker uniquement au début et à la fin des chaînes de caractères** : Cette option vous permet de définir la manière dont le symbole "@" sera interprété lorsqu'il est utilisé dans une recherche ou une comparaison de chaînes de caractères, lorsqu'il se trouve au sein d'un mot. When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Lorsque l’option est cochée, le caractère @ est considéré comme un simple caractère s’il se trouve au milieu d’un mot. Cette possibilité est particulièrement utile pour les bases de données stockant des adresses e-mail (qui se présentent sous la forme “nom@fournisseur.xx”). Cette option influe sur les recherches, les tris et les comparaisons de chaînes de caractères, pour les données stockées dans les tables ou en mémoire (tableaux). Sont concernés les champs alpha (indexés ou non) et texte ainsi que les variables alpha et texte. @@ -52,19 +52,19 @@ Trois options d’emplacement sont proposées : - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - Pour des raisons de sécurité, seuls l’Administrateur et le Super_Utilisateur de la base peuvent modifier ce paramètre. - - **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. +- **Langue du fichier de données courant :** cette option permet de paramétrer la langue utilisée pour le traitement et la comparaison des chaînes de caractères pour la base de données ouverte. Le choix d’une langue de comparaison influe sur le tri et la recherche des textes ainsi que le passage en minuscules/majuscules mais n’a pas d’incidence sur la traduction des libellés ou sur les formats de dates, d’heure ou monétaires qui restent, eux, dans la langue du système. Par défaut, 4D utilise la langue du système. Un projet 4D peut ainsi fonctionner dans une langue différente de celle du système. A l’ouverture d’un projet, le moteur de 4D détecte la langue utilisée par le fichier de données et la fournit au langage (interpréteur ou mode compilé). Les comparaisons de texte, qu’elles soient effectuées par le moteur de base de données ou par le langage, sont donc toujours effectuées dans la même langue. > Il est possible de modifier ce paramètre dans les Préférences de l'application (voir [Page General](../Preferences/general.md)). Dans ce cas, il s'applique à toutes les nouvelles bases créées par 4D. - - \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. +- \*\*N'utiliser que les caractères non alphanumériques pour les mots-clés \*\* : cette option modifie l'algorithme utilisé par 4D pour identifier les séparateurs de mots-clés et donc construire les index de mots-clés. Par défaut, lorsque cette option n'est pas cochée, 4D utilise un algorithme sophistiqué tenant compte des spécificités linguistiques. Cet algorithme est semblable à celui utilisé de façon standard par les logiciels de traitement de texte pour déterminer les limites d'une sélection en cas de double-clic dans un mot. Pour plus d’informations sur cet algorithme, reportez-vous à l'adresse `http://userguide.icu-project.org/boundaryanalysis`. Lorsque cette option est cochée, 4D utilise un algorithme simplifié. Dans cette configuration, tout caractère non alphanumérique (c'est-à-dire qui n'est ni une lettre ni un chiffre) est considéré comme séparateur de mot-clé. Ce paramétrage répond à des besoins spécifiques associés à certaines langues telles que le japonais. - - **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. +- **Ordre de tri approprié pour la recherche** : Cette option s'affiche uniquement lorsque la langue japonaise est sélectionnée. Elle modifie l'interprétation de caractères tels que "Marques Katakana-Hiragana de son prolongé" ou "長音記号" ou les "Marques d'itération japonaises" telles que "ゝ" ou "ゞ". Un locuteur japonais préférera les résultats issus d'une recherche effectuée lorsque le paramètre est activé. #### Prise en charge de Mecab (version japonaise) @@ -82,7 +82,7 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ### Paramètres du cache pour la base - - **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. +- **Calcul du cache adaptatif** : Lorsque cette option est cochée, la gestion de la mémoire cache est assurée dynamiquement par le système — dans des limites que vous définissez. Ce principe permet de configurer une mémoire cache performante, adaptée à la plupart des configurations. La taille du cache est alors calculée dynamiquement en fonction des paramétrages définis. Les valeurs proposées par défaut correspondent à une utilisation standard de 4D. - **Mémoire à réserver pour le système et les autres applications** : partie de la mémoire RAM à réserver au Système et aux autres applications. Cette valeur peut être augmentée à des fins d’optimisation lorsque d’autres applications consommatrices de mémoire tournent sur le même poste que 4D. - **Mémoire disponible utilisée pour le cache** : Pourcentage de la mémoire restante allouée par défaut au cache.\ @@ -98,11 +98,11 @@ Utilisez les paramètres de cet onglet pour configurer la mémoire cache de la b ![](../assets/en/settings/memory-maximum-size.png) - - **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). +- **Calcul du cache adaptatif non cochée** : dans ce mode, vous définissez vous-même la taille de la mémoire cache pour la base. 4D affiche alors une zone de saisie permettant de définir la mémoire cache à utiliser ainsi que les informations relatives à la mémoire physique (mémoire RAM disponible sur la machine), le cache actuel et le cache après redémarrage (tenant compte de vos modifications). La taille de mémoire cache que vous saisissez sera réservée pour la base 4D, quel que soit l’état des ressources de la machine. Ce paramétrage peut être utilisé dans certaines configurations spécifiques, ou lorsque la base est destinée à fonctionner sur des systèmes disparates en termes de mémoire. Dans la plupart des cas, le cache adaptatif est plus performant. - - **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. +- **Ecriture cache toutes les… Minutes/secondes** : spécifie la fréquence de sauvegarde automatique du cache de données, c’est-à-dire son écriture sur le disque. 4D écrit les données placées dans le cache à intervalles fixes. Vous pouvez définir tout intervalle compris entre 1 seconde et 500 minutes. Par défaut, 4D stocke vos données toutes les 20 secondes. L’application écrit aussi vos données sur disque lorsque vous changez de mode ou quittez l’application. You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. Quand vous prévoyez de saisir beaucoup de données, il est souhaitable de fixer un intervalle court. En effet, en cas de coupure de courant, vous ne perdriez que les données saisies depuis la dernière écriture (si la base fonctionne sans fichier d’historique). diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md index d3b7351d3bf32d..191e92fc300c18 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md @@ -23,9 +23,9 @@ La police et la taille de police par défaut dépendent de la plate-forme d'exé D'autres options permettent de configurer l'affichage de diverses fenêtres du mode Application. - - **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. +- **Accueil** : lorsque cette option est désélectionnée, la [fenêtre d’accueil (ou “splash screen”) de la barre de menus courante](Menus/bars.md#splash-screen) en mode Application n’apparaît pas. Lorsque vous masquez cette fenêtre, c'est à vous de gérer l'affichage de toutes vos fenêtres par programmation, par exemple dans la méthode base `On Startup`. - - **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. +- **Ecriture du cache** : Lorsque cette option est cochée, 4D affiche une fenêtre en bas à gauche de l'écran pendant que les données du cache sont vidées. Etant donné que cette opération bloque momentanément les actions de l'utilisateur, l'affichage de cette fenêtre lui permet de savoir que l'écriture du cache est en cours. :::note @@ -33,9 +33,9 @@ Vous pouvez définir la [fréquence d'écriture du cache](database.md#memory-pag ::: - - **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. +- **Progression de l'impression** : permet, lors de l'impression, d'activer ou de désactiver l'affichage de la boîte de dialogue de progression de l'impression. - - **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : +- **Utiliser le mode SDI sous Windows** : Lorsque cette option est cochée, 4D active automatiquement le [mode SDI (Interface à document unique)](../Menus/sdi.md) dans votre application lorsqu'elle est exécutée dans un [contexte pris en charge](../Menus/sdi.md#disponibilité-du-mode-sdi). Lorsque vous sélectionnez cette option, sur Windows le menu **Exécuter** de la barre de menus 4D vous permet de sélectionner le mode dans lequel vous souhaitez tester l'application : ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Ce menu vous permet de sélectionner la palette de couleurs à utiliser au nivea Les palettes suivants sont disponibles : - - **Clair**: l'application utilisera le thème clair par défaut +- **Clair**: l'application utilisera le thème clair par défaut ![](../assets/en/settings/light-appearance.png) - - **Foncé** : l'application utilisera le thème foncé par défaut +- **Foncé** : l'application utilisera le thème foncé par défaut ![](../assets/en/settings/dark-appearance.png) - - **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) +- **Héritée** (par défaut) : l'application hérite du niveau de priorité le plus élevé (c'est-à-dire les préférences de l'utilisateur du système d'exploitation) > Les thèmes par défaut peuvent être gérés par du CSS. Pour plus d'informations, veuillez consulter la section [Media Queries](../FormEditor/createStylesheet.md#media-queries). La palette d'application principale sera appliquée aux formulaires par défaut. Toutefois, elle peut être remplacée : - - par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; - - en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". +- par la commande [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) au niveau de la session de travail ; +- en utilisant la propriété de formulaire [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) à chaque niveau de formulaire (niveau de priorité le plus élevé). **Note** : à l'impression, les formulaires utilisent toujours la palette "Light". ## Raccourcis @@ -72,9 +72,9 @@ La zone Raccourcis clavier permet d'afficher et de modifier les raccourcis clavi Les raccourcis clavier par défaut sont les suivants : - - Acceptation de saisie : **Entrée** - - Annulation de saisie : **Echap** - - Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) +- Acceptation de saisie : **Entrée** +- Annulation de saisie : **Echap** +- Ajout d'un sous-formulaire : **Ctrl+Shift+/** (Windows) ou **Command+Shift+/** (macOS) Pour modifier le raccourci d'une opération, cliquez sur le bouton **Modifier** correspondant. La boîte de dialogue suivante apparaît : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/security.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/security.md index 42455b206c0482..84cd29f3ec95e7 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/security.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/security.md @@ -11,7 +11,7 @@ Cette page regroupe les options relatives à la protection des accès et des don > Ces paramètres ne s'appliquent pas aux bases projets ouvertes en monoposte. - - **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. +- **Accès Développement et Explorateur d'exécution** : permet au groupe d’utilisateurs spécifié d’accéder au mode Développement de la base et d'afficher l'Explorateur d'exécution. A noter que : @@ -19,21 +19,21 @@ Cette page regroupe les options relatives à la protection des accès et des don - Le Super_Utilisateur et l'Administrateur ont toujours accès à l'environnement de développement et à l'Explorateur d'exécution, même s'ils ne font pas explicitement partie du groupe d'accès spécifié. Pour plus d'information sur les utilisateurs et les groupes d'utilisateurs, veuillez vous référer au chapitre [Utilisateurs et groupes](../Users/handling_users_groups.md). - - **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. +- **Utilisateur par défaut** : lorsqu’un utilisateur est défini dans ce menu, chaque utilisateur ouvrant ou se connectant à la base dispose des privilèges et restrictions d’accès qui ont été assignés à cet utilisateur par défaut. Il n’est alors plus nécessaire de saisir un nom d’utilisateur. De plus, si vous n’avez pas associé de mot de passe à l’utilisateur par défaut, la boîte de dialogue de saisie du mot de passe n’apparaît pas, la base s’ouvre directement. L’intérêt de cette option est de simplifier les accès multiples à la base tout en maintenant un système complet de contrôle des données. - Si vous avez associé un mot de passe à l’utilisateur par défaut, une boîte de dialogue apparaît à l’ouverture de la base, les utilisateurs doivent uniquement saisir un mot de passe. - Si vous n'avez pas associé de mot de passe à l'Utilisateur par défaut, la boîte de dialogue d'identification de l'utilisateur ne s'affichera pas.**Note:** Vous pouvez “forcer” l'affichage de la boîte de dialogue d'identification de l'utilisateur lorsque le mode “Utilisateur par défaut” est actif, par exemple pour vous connecter en tant qu'Administrateur ou Super_Utilisateur. Pour cela, ouvrez (ou connectez-vous à) la base de données tout en maintenant la touche **Majuscule** enfoncée. - - **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **Afficher les utilisateurs dans la fenêtre Mots de passe** : si cette option est cochée, les utilisateurs doivent choisir leur nom dans une liste d’utilisateurs et saisir leur mot de passe dans la boîte de dialogue de saisie des mots de passe. Si cette option n’est pas cochée, les utilisateurs doivent saisir leur nom et leur mot de passe. Pour plus d’informations sur les deux versions de la boîte de dialogue de mots de passe, consultez la section "Accès au système" dans [Présentation du contrôle des accès](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **Trier la liste des utilisateurs par ordre alphabétique** (option utilisable uniquement si la précédente est cochée) : Lorsque cette option est cochée, la liste des utilisateurs dans la boîte de dialogue de saisie des mots de passe est triée par ordre alphabétique. - - **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. +- **Les utilisateurs peuvent changer leur mot de passe** : lorsque cette option est cochée, un bouton **Changer** est affiché dans la boîte de dialogue d’ouverture ou de connexion à la base. Si vous le souhaitez, vous pouvez masquer le bouton **Changer** afin de ne pas permettre aux utilisateurs de modifier leur mot du passe. Ce bouton permet à l’utilisateur d’accéder à la boîte de dialogue qui peut être utilisée pour changer son mot de passe (pour plus d'informations sur cette boîte de dialogue, consultez la rubrique "Modification du mot de passe par l'utilisateur" dans [Assurer la maintenance du système](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Il suffit pour cela de désélectionner cette option. ## Options - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. A l'aide des options suivantes, vous pouvez supprimer complètement ou partiellement ce filtrage. - **Activé pour tous** (par défaut) : L'accès aux commandes, fonctions et méthodes projets est limité pour tous les utilisateurs, y compris au Super Utilisateur et à l'Administrateur. - **Désactivé pour le Super Utilisateur et l'Administrateur** : Cette option accorde, uniquement au Super Utilisateur et à l'Administrateur, un accès complet aux commandes et méthodes 4D. Elle peut être utilisée pour définir un mode d'accès illimité aux commandes et méthodes tout en gardant le contrôle des actions effectuées. En phase de développement, ce mode peut être utilisé pour tester librement toutes les formules, les états, etc. En cours d'exploitation, il peut être utilisé pour mettre en oeuvre des solutions sécurisées permettant un accès temporaire à toutes les commandes et méthodes. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Cette page regroupe les options relatives à la protection des accès et des don - **Désactivé pour tous** : Cette option désactive le contrôle dans les formules. Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsque cette option est cochée, les utilisateurs ont accès à l'ensemble des commandes, plug-ins et méthodes projets (à l'exception de ceux qui sont invisibles). Lorsqu'elle est cochée, cette commande ne fait rien. - - **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). +- **Autoriser les propriétés utilisateur** : Vous devez cocher cette option si vous souhaitez utiliser la fonctionnalité d’externalisation des propriétés utilisateur. Lorsque cette option est cochée, jusqu'à trois boîtes de dialogue sont disponibles pour définir les propriétés : **Propriétés structure**, **Propriétés utilisateur**, et **Propriétés utilisateur pour fichier de données**. For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Pour des raisons de sécurité, vous devez autoriser explicitement l’exécution de cette méthode dans chaque base hôte. Pour cela, vous devez cocher l'option. Cette option n'est pas cochée par défaut. Lorsque cette option est cochée : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/web.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/web.md index 36890369cb56e8..a9f9f1fb9201a5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/web.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R9/settings/web.md @@ -82,9 +82,9 @@ Lorsque cette option est sélectionnée, le serveur Web ne fournit aucune prise Dans ce mode, vous pouvez configurer des paramètres de serveur Web supplémentaires : - - [Process Web simultanés maxi](#maximum-concurrent-web-processes) - - [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) - - [Utiliser des process préemptifs](#use-preemptive-processes) +- [Process Web simultanés maxi](#maximum-concurrent-web-processes) +- [Réutilisation des contextes temporaires (en mode distant)](#reuse-temporary-context) +- [Utiliser des process préemptifs](#use-preemptive-processes) #### Anciennes sessions (sessions process uniques) @@ -166,9 +166,9 @@ Démarre ou arrête l'enregistrement des requêtes reçues par le serveur Web 4D Le menu de format du journal propose les options suivantes : - - **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. +- **Pas de journal** : Lorsque cette option est sélectionnée, 4D ne génère pas d’historique des requêtes. - - **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ +- **CLF (Common Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format CLF. Avec le format CLF, chaque ligne du fichier représente une requête, telle que :\ host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ Chaque champ est séparé par un espace et chaque ligne se termine par la séquence CR/LF (caractère 13, caractère 10). - hôte : adresse IP du client (ex. 192.100.100.10) @@ -178,9 +178,9 @@ Le menu de format du journal propose les options suivantes : > La date et heure sont locales au serveur. - - requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) - - statut : réponse donnée par le serveur. - - longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. +- requête : requête envoyée par le client (ex. GET /index.htm HTTP/1.0) +- statut : réponse donnée par le serveur. +- longueur : taille des données renvoyées (hors en-tête HTTP) ou 0. > **Note :** Pour des raisons de performances, les opération sont stockées dans une mémoire tampon par paquets de 1 Ko avant d'être écrites sur disque. Les opérations sont également écrites sur disque si aucune requête n'a été envoyée au bout de 5 secondes. > Les valeurs possibles de l'état sont les suivantes : @@ -194,16 +194,16 @@ Le menu de format du journal propose les options suivantes : > 500 : Erreur interne > Le format CLF ne peut pas être personnalisé. - - **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. +- **DLF (Combined Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format DLF. Le format DLF est semblable au format CLF dont il reprend exactement la structure. Il ajoute simplement deux champs HTTP supplémentaires à la fin de chaque requête : Referer et User-agent. - Referer : contient l’URL de la page pointant vers le document demandé. - User-agent : contient le nom et la version du navigateur ou du logiciel client à l’origine de la requête. > Le format DLF ne peut pas être personnalisé. - - **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. +- **ELF (Extended Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format ELF. Le format ELF est largement répandu dans le monde des serveurs HTTP. Il peut être utilisé pour construire des historiques sophistiqués qui répondent à des besoins spécifiques. Pour cette raison, le format ELF peut être personnalisé : il est possible de choisir les champs à enregistrer ainsi que leur ordre d'insertion dans le fichier. - - **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. +- **WLF (WebStar Log Format)** : Lorsque cette option est sélectionnée, l’historique des requêtes est généré au format WLF. Le format WLF a été développé spécifiquement pour le serveur 4D WebSTAR. Il est semblable au format ELF, il dispose simplement de champs supplémentaires. Comme le format ELF, il est personnalisable. **Configurer les champs** Lorsque vous choisissez le format ELF (Extended Log Format) ou WLF (WebStar Log Format), la zone “Formatage du journal” affiche les champs disponibles pour le format. Vous devrez sélectionner chaque champ à inclure dans le journal. Pour cela, utilisez les flèches de commande ou procédez par glisser-déposer. @@ -242,14 +242,14 @@ Le tableau suivant répertorie les champs disponibles pour chaque format (par or Paramètres d’archivage automatique du journal des requêtes. D'abord, vous devez choisir la fréquence (jours, semaines, etc.) ou le critère de limite de taille du fichier en cliquant sur le bouton radio correspondant. Vous devez ensuite spécifier le moment précis de la sauvegarde si nécessaire. - - **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. - - **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. +- **Pas de sauvegarde du journal** : La fonction de sauvegarde programmée est désactivée. +- **Toutes les X heure(s)** : Cette option est utilisée pour programmer des sauvegardes sur une base horaire. Vous pouvez entrer une valeur entre 1 et 24. - **à partir de**: Permet de définir l'heure du déclenchement du premier backup. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. - - **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. - - **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. - - **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base journalière. Saisissez 1 si vous souhaitez effectuer une sauvegarde quotidienne. Lorsque vous cochez cette option, vous devez indiquer l’heure à laquelle la sauvegarde doit être déclenchée. +- **Tous les N jour(s) à N** : permet de programmer des backups sur une base hebdomadaire. Saisissez 1 si vous souhaitez une sauvegarde hebdomadaire. Lorsque vous cochez cette option, vous devez indiquer le ou les jours de la semaine et l’heure à laquelle chaque sauvegarde doit être déclenchée. Vous pouvez cocher un ou plusieurs jour(s) de la semaine. Par exemple, vous pouvez utiliser cette option pour définir deux sauvegardes hebdomadaires : une le mercredi et une le vendredi. +- **Tous les N mois, Ne jour à N** : permet de programmer des sauvegardes sur une base mensuelle. Saisissez 1 si vous souhaitez une sauvegarde mensuelle. Lorsque vous cochez cette option, vous devez indiquer le jour de chaque mois auquel la sauvegarde doit être déclenchée, ainsi que l’heure de déclenchement. +- **Tous les N Mo** : Cette option est utilisée pour programmer les sauvegardes en fonction de la taille du fichier journal courant. Une sauvegarde se déclenche automatiquement quand le fichier atteint la taille spécifiée. La taille limite du fichier peut être fixée à 1, 10, 100 ou 1000 Mo. > En cas de sauvegarde périodique, si le serveur Web n’était pas lancé au moment théorique de la sauvegarde, 4D considère au lancement suivant que la sauvegarde a échoué et applique les paramétrages adéquats, définis dans les Propriétés. @@ -263,9 +263,9 @@ Pour plus d'informations sur la prise en charge des services Web dans 4D, veuill Cette zone affiche les options relatives à l’utilisation de 4D en tant que “serveur” de Web Services, c’est-à-dire publiant des méthodes projet sous forme de Web Services. - - **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. - - **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. - - **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. +- **Autoriser requêtes Web Services** : Cette option permet d’initialiser la publication de Web Services. Si cette option n’est pas cochée, 4D refuse les requêtes SOAP et ne génère pas de WSDL — même si des méthodes disposent de l’attribut *Disponible via Web Service*. Lorsque cette option est cochée, 4D crée le fichier WSDL. +- **Nom Web Service**: cette zone permet de modifier le “nom générique” du Web Service. Ce nom permet de différencier les services au niveau du serveur SOAP (lorsque le serveur publie plusieurs Web Services), ainsi que dans les annuaires de Web Services. Par défaut, 4D utilise le nom A_WebService. +- **Espace de nommage Web Services** : cette zone permet de modifier l’espace de nommage (le namespace) des Web Services publiés par 4D. Chaque Web Service publié sur Internet doit être unique. L’unicité des noms de Web Services est assuré à l’aide des espaces de nommage XML (XML namespace). Un espace de nommage est une chaîne de caractères arbitraire permettant d’identifier de manière unique un ensemble de balises XML. Typiquement, l’espace de nommage début par l’URL de la société (http://masociete.com/monespacedenommage). Dans ce cas, il n’est pas indispensable qu’il y ait quelque chose à l’URL défini, il importe simplement que la chaîne de caractères utilisée soit unique. Par défaut, 4D utilise l’espace de nommage http://www.4d.com/namespace/default. > Conformément à la norme XML concernant les noms de balises, la chaîne de caractères utilisée ne doit pas contenir d’espaces ni débuter par un chiffre. En outre, pour éviter tout risque d’incompatibilité, il est recommandé de ne pas utiliser de caractères étendus (tels que des caractères accentués). @@ -273,7 +273,7 @@ Cette zone affiche les options relatives à l’utilisation de 4D en tant que Cette zone contient une option relative à l’utilisation de 4D en tant que “client” de Web Services, c’est-à-dire souscrivant à des services publiés sur le réseau. - - **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. +- **Préfixe des méthodes créées par l’assistant** : cette zone vous permet de modifier le préfixe automatiquement ajouté par 4D devant le nom des méthodes proxy générées par l’assistant Web Services. Les méthodes projet proxy font le lien entre l’application 4D et le serveur de Web Services. Par défaut, 4D utilise le préfixe “proxy_”. ## Fonctionnalités Web @@ -307,9 +307,9 @@ Ce bouton est uniquement disponible dans les projets ouverts avec l'application Le bouton déclenche la séquence de mise à niveau suivante : - - Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. - - La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). - - Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. +- Le groupe d'utilisateurs de l'API REST défini dans le menu **Lecture/Écriture** est supprimé. +- La méthode base `On REST Authentication` est supprimée (déplacée dans la corbeille du système). +- Un fichier ["roles.json"](../ORDA/privileges.md#fichier-rolesjson) par défaut est créé dans le dossier [Sources](../Project/architecture.md#sources) du projet s'il n'existe pas déjà, avec son attribut `forceLogin` défini sur `True`. N'oubliez pas de redémarrer votre projet après avoir effectué cette mise à niveau. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/ClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/ClassClass.md index f17dade9988946..30be85fda23689 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/ClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/ClassClass.md @@ -160,8 +160,8 @@ title: Class :::note 注記 - - すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 - - 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 +- すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 +- 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/Document.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/Document.md index cb7edf57941cd8..1b71686ebb69e1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/Document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/Document.md @@ -320,8 +320,8 @@ title: Document クラス `.original` プロパティは、エイリアス、ショートカット、シンボリックリンクファイルのターゲット要素を返します。 ターゲット要素は以下のいずれかです: ターゲット要素は以下のいずれかです: - - File オブジェクト - - Folder オブジェクト +- File オブジェクト +- Folder オブジェクト エイリアスでないファイルについては、プロパティは同じファイルオブジェクトをファイルとして返します。 @@ -585,8 +585,8 @@ $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite) 任意で、コンテンツの読み取りに使用する文字セットを渡します。 これには、次の二つの方法があります: - - *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 - - *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 +- *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 +- *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 > 4D によってサポートされている文字セットの一覧については、`CONVERT FROM TEXT` コマンドを参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index 1e1cbd8927b9c2..7ed93331603884 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage `.body` プロパティには送信されるメッセージ本文が格納されています。 `.body` プロパティでは以下のデータ型がサポートされます: - - text - - blob - - object - - image +- text +- blob +- object +- image `.body` プロパティは読み書き可能です。 @@ -108,17 +108,17 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage *body* 引数では以下のデータ型がサポートされています: - - Text - - BLOB - - Object - - ピクチャー +- Text +- BLOB +- Object +- ピクチャー この関数が使用された場合、content-type ヘッダーは*body* 引数の型に応じて自動的に設定されます: - - Content-Type: 本文がテキストの場合にはtext/plain - - Content-Type: 本文がBlob の場合にはapplication/octet-stream - - Content-Type: 本文がオブジェクトの場合にはapplication/json - - Content-Type: image/jpeg、image/gif... (本文が画像の場合) +- Content-Type: 本文がテキストの場合にはtext/plain +- Content-Type: 本文がBlob の場合にはapplication/octet-stream +- Content-Type: 本文がオブジェクトの場合にはapplication/json +- Content-Type: image/jpeg、image/gif... (本文が画像の場合) *body* がサポートされていない値の型だった場合、エラーが返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md index 6609af77779e06..7d998df44714c1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ SMTPステータスコードについての詳細は [こちらのページ](htt SMTP接続は、以下の場合に自動的に閉じられます: - - `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 - - `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 +- `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 +- `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md index 191ed5e78b294e..17a62d0915dcc1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Session オブジェクトは [`Session`](../commands/session.md) コマンドによって返されます。 このオブジェクトは、カレントユーザーセッションを管理するためのインターフェースをデベロッパーに対して提供し、コンテキストデータの保存、プロセス間の情報共有、セッションに関連したプリエンプティブプロセスの開始などのアクションの実行や、[アクセス権](../ORDA/privileges.md) の管理を可能にします。 +:::info To learn more + +Blog posts about this feature: + +- [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### セッションの種類 このクラスは以下の種類のセッションをサポートしています: @@ -38,11 +47,6 @@ Session オブジェクトは [`Session`](../commands/session.md) コマンド | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() @@ -268,7 +272,7 @@ $privileges := Session.getPrivileges() #### 参照 [.setPrivileges()](#setprivileges)
-[ブログ記事: セッション権限を検査してデバッグを容易に](https://blog.4d.com/ja/permissions-inspect-session-privileges-for-easy-debugging) +[*Permissions – Inspect the privileges in the session for an easy debugging* (blog post)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/TCPEventClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/TCPEventClass.md index b0e89875e7e1f5..f7083647889e0a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/TCPEventClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/TCPEventClass.md @@ -7,10 +7,10 @@ title: TCPEvent
履歴 -| リリース | 内容 | -| ----- | ---------------------- | -| 20 R9 | 新しい `ip` および `port` 属性 | -| 20 R8 | クラスを追加 | +| リリース | 内容 | +| ----- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | クラスを追加 |
@@ -20,12 +20,24 @@ title: TCPEvent 次のプロパティを利用することができます: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### 説明 + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ title: TCPEvent - - -## .ip - -**ip** : Text - -#### 説明 - -`.ip` プロパティには、リモートマシンのIP アドレスが格納されています。 - - - ## .port diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/UDPEventClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/UDPEventClass.md index caf4ed6f86f534..2e865946757ebf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/UDPEventClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/UDPEventClass.md @@ -19,34 +19,34 @@ title: UDPEvent 次のプロパティを利用することができます: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| - + -## .data +## .address -**data** : Blob +**address** : Text #### 説明 -`.data` プロパティには、イベントに関連づけられたデータ が格納されています。 これは"data" 型のイベントにおいてのみ有効です。 +The `.address` property contains the IP address of the remote machine. - + -## .ip +## .data -**ip** : Text +**data** : Blob #### 説明 -`.ip` プロパティにはリモートマシンの IP アドレス が格納されています。 +`.data` プロパティには、イベントに関連づけられたデータ が格納されています。 これは"data" 型のイベントにおいてのみ有効です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebFormClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebFormClass.md index 4263a51c3caa38..5cab3d46d6789e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebFormClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebFormClass.md @@ -56,8 +56,8 @@ Webフォームのコンポーネント (構成要素) とは、これらの Web この関数は、以下の場合には何もしません: - - Webフォーム上で *state* が現在有効ではない。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* が現在有効ではない。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を [有効化](#enablestate) または無効化した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 @@ -82,8 +82,8 @@ Webフォームの state に関する詳細については、[developer.qodly.co この関数は、以下の場合には何もしません: - - Webフォーム上で *state* がすでに有効である。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* がすでに有効である。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を有効化または [無効化](#disablestate)した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketClass.md index fde54ce68e3b01..eacb93bd59f35f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketClass.md @@ -86,8 +86,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *url*には、WebSocketサーバーが応答する URL を渡します。 以下の URLパターンが使用できます: - - 標準接続用: `ws://host[:port]path[?query]` - - TLSセキュア接続用: `wss://host[:port]path[?query]` +- 標準接続用: `ws://host[:port]path[?query]` +- TLSセキュア接続用: `wss://host[:port]path[?query]` 接続できない場合、`null` オブジェクトが返され、エラーが生成されます (このエラーは `ON ERR CALL` で実装したメソッドによってインターセプトできます)。 @@ -95,8 +95,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *connectionHandler* には、接続イベントに応じて呼び出されるコールバック関数のほか、処理するデータ型やヘッダーを含むオブジェクトを渡すことができます。 - - コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 - - フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 +- コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 +- フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 | プロパティ | 型 | 説明 | | ----------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ This.headers.Cookie:="yummy_cookie=choco; tasty_cookie=strawberry" *code* には、接続を閉じる理由を説明するステータスコードを渡すことができます ([RFC6455 の WebSocket Connection Close Code](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5) も参照ください): - - 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 - - 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 +- 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 +- 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 *reason* には、接続を閉じる理由を説明するテキストを渡すことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md index 84edc11d112719..14752f7a1265e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ WebSocketプロトコルは、WebSocketサーバーとクライアント (Webブ 4D で WebSocketサーバーを作成し、扱うには、4Dビルトインクラスを 2つ使用する必要があります。 - - このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 - - [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 +- このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 +- [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 さらに、2つのユーザークラスを作成し、コールバック関数を定義する必要があります: - - サーバー接続を処理するためのユーザークラス - - メッセージを処理するためのユーザークラス +- サーバー接続を処理するためのユーザークラス +- メッセージを処理するためのユーザークラス 接続を維持するため、[WebSocketサーバーの作成](#4dwebsocketservernew) は [ワーカー](../Develop/processes.md#worker-プロセス) 内にて行う必要があります。 @@ -387,8 +387,8 @@ Function broadcast($ws : 4D.WebSocketConnection; $message:text) *timeout* 値が設定されている場合: - - 待機時間に達したら強制的にソケットを破棄します。 - - *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 +- 待機時間に達したら強制的にソケットを破棄します。 +- *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Admin/webAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/current/Admin/webAdmin.md index 657829ce598c98..81090d6fc2c115 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Admin/webAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Admin/webAdmin.md @@ -17,7 +17,7 @@ WebAdmin 内部コンポーネントは、"WebAdmin" 権限を持つユーザー `WebAdmin` Webサーバーは、4D または 4D Server アプリケーションの起動時 (プロジェクトの読み込み前) に開始するように設定できます。 - - インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 +- インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Web管理設定ダイアログボックスで、**WebAdmin サーバーをスタ ![alt-text](../assets/en/Admin/waSettings.png) - - ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: +- ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Web管理の設定ダイアログボックスを開くには、**ファイル **注:** - - ローカルホスト以外による HTTP接続は受け付けません。 - - このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 +- ローカルホスト以外による HTTP接続は受け付けません。 +- このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 #### HTTP ポート @@ -94,11 +94,11 @@ TLS証明書ファイルが置かれているフォルダーのパスです。 HTTPリクエストログファイル (アプリケーションの "Logs" フォルダーに格納されている HTTPDebugLog_*nn*.txt (nn はファイル番号)) の状態やフォーマットを指定します。 次のオプションから選択することができます: - - **無効化** (デフォルト) - - **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 - - **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) - - **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 - - **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 +- **無効化** (デフォルト) +- **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 +- **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) +- **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 +- **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 #### アクセスキー @@ -108,9 +108,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ アクセスキーはパスワードに似ていますが、ログインとは関係ありません。 - - 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 - - アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 - - 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 +- 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 +- アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 +- 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 #### Qodly Studio へのアクセスを有効化する @@ -145,9 +145,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ ## 認証とセッション - - 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 +- 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 - - 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 +- 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 アクセスが許可されると、4Dアプリケーション上に "WebAdmin" 権限を持つ Web[セッション](WebServer/sessions.md) が作成されます。 カレントセッションが "WebAdmin" 権限を持っている限り、`WebAdmin` コンポーネントは要求されたページを提供します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Backup/restore.md b/i18n/ja/docusaurus-plugin-content-docs/current/Backup/restore.md index 6986d96dadd991..3ab479d1071d65 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Backup/restore.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Backup/restore.md @@ -5,12 +5,12 @@ title: 復元 問題が発生したときは、一連のアプリケーションファイル全体を復元することができます。 主に 2つのカテゴリの問題が発生する可能性があります: - - アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: +- アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: - キャッシュが空の場合、アプリケーションを問題なく開くことができます。 アプリケーションに対しておこなわれた変更はデータファイルに記録されています。 この場合には、特別な手順は必要ありません。 - キャッシュに未保存の処理が含まれている場合、データファイルは損傷していませんが、カレントのログファイルを統合する必要があります。 - キャッシュの内容をデータファイルに書き込み中だった場合、データファイルはおそらく損傷しています。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 - - アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 +- アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 > 問題発生後に、自動で 4Dのアプリケーション復旧処理を起動することができます。 このメカニズムは、ストラクチャー設定の **バックアップ/バックアップ＆復旧** ページで利用できるオプションを使用して管理します。 詳細は [自動復元](settings.md#自動復元とログの統合) を参照してください。\ > 問題が、データに対しておこなわれた不適切な処理の結果引き起こされた場合 (たとえば誤ってレコードを削除した等)、ログファイルの "ロールバック" 機能を使用してデータファイルを復旧できます。 この機能は MSC の [ロールバック](MSC/rollback.md) ページから利用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Backup/settings.md b/i18n/ja/docusaurus-plugin-content-docs/current/Backup/settings.md index c28b98d4c1ef79..0b5e516ddd4702 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Backup/settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Backup/settings.md @@ -5,9 +5,9 @@ title: バックアップ設定 バックアップ設定の定義は、[ストラクチャー設定ダイアログボックス](../settings/overview.md) 内で 3ページにわたっています。 次の設定がおこなえます: - - 自動バックアップ用のスケジューラー設定 - - 各バックアップに含めるファイル - - 自動タスクの実行を可能にする高度な設定 +- 自動バックアップ用のスケジューラー設定 +- 各バックアップに含めるファイル +- 自動タスクの実行を可能にする高度な設定 > このダイアログボックスで定義された設定は *Backup.4DSettings* ファイルに書き込まれ、[Settings フォルダー](Project/architecture.md#settings-ユーザー) に保存されます。 @@ -23,12 +23,12 @@ title: バックアップ設定 このページにあるオプションを使用して、アプリケーションの自動バックアップのスケジュールを設定できます。 標準のクイック設定、または完全なカスタマイズを選択できます。 **自動バックアップ** メニューでの選択に基づき、さまざまなオプションが表示されます: - - **しない**: スケジュールに基づくバックアップは無効となります。 - - **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 - - **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 - - **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 - - **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 - - **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: +- **しない**: スケジュールに基づくバックアップは無効となります。 +- **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 +- **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 +- **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 +- **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 +- **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: - **X 時間ごと**: 時間単位でバックアップの間隔をスケジュールできます。 1から24までの値を設定できます。 * **X 日ごと**: 日単位でバックアップの間隔をスケジュールできます。 たとえば、毎日バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップが開始される時刻を設定しなければなりません。 * **X 週ごと**: 週単位でバックアップの間隔をスケジュールできます。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップを開始する曜日と時刻を設定しなければなりません。 複数の曜日を選択することもできます。 たとえば、毎週水曜日と金曜日にバックアップをするようプログラムできます。 @@ -48,12 +48,12 @@ title: バックアップ設定 このエリアでは、次回のバックアップ時にコピー対象とするファイルやフォルダーを指定します。 - - **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: +- **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: - データベースのカレントログファイル (あれば) - [データファイルの隣に置かれた](../Project/architecture.md#settings-フォルダー) `Settings` フォルダー (あれば)。これは *データファイル用のユーザー設定* を格納しています。 - - **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 - - **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* - - **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 +- **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 +- **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* +- **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 - **削除**: 選択したファイルを添付エリアから取り除きます。 - **フォルダー追加...**: バックアップに追加するフォルダーを選択するダイアログボックスを表示します。 復元の場合、フォルダーがその内容物とともに復元されます。 アプリケーションファイルを含むフォルダーを除き、すべてのフォルダーやマシンに接続されたボリュームを選択できます。 - **ファイル追加...**: バックアップに追加するファイルを選択するダイアログボックスを表示します。 @@ -82,19 +82,19 @@ title: バックアップ設定 ### 一般設定 - - **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 +- **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 たとえば、3世代のファイルを保持するよう設定している場合、最初の 3回のバックアップで MyBase-0001、MyBase-0002、MyBase-0003 が作成され、 4回目のバックアップで MyBase-0004 が作成されたのちに MyBase-0001 が削除されます。 この設定はデフォルトで有効になっており、4D は 3世代のバックアップを保持します。 このメカニズムを無効にするには、チェックボックスの選択を外します。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 +- **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 +- **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 - - **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 +- **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 - **次回の予定された日付と時刻に再試行する**: このオプションは、定期的な自動バックアップを設定されている場合にのみ意味があります。 失敗したバックアップはキャンセルされます。 エラーが生成されます。 - **指定時間経過後に再試行**: このオプションが選択されていると、設定された待ち時間経過後にバックアップを再試行します。 このメカニズムを使用すると、バックアップをブロックするような特定の状況に対応することが可能となります。 秒、分、あるいは時間単位で待ち時間を設定できます。 次のバックアップ試行にも失敗するとエラーが生成され、ステータスエリアに失敗状況が表示され、バックアップジャーナルにも記録されます。 - **操作をキャンセル X 試行後**: このパラメーターを使用して、バックアップ試行の失敗最大数を設定できます。 この最大数に達してもバックアップが正しく実行できなかった場合、バックアップはキャンセルされ、エラー 1401 ("バックアップ試行の最大数に達しました。自動バックアップは無効になります") が生成されます。 この場合、データベースを再起動するか、手動バックアップが成功するまで自動バックアップはおこなわれません。 @@ -106,17 +106,17 @@ title: バックアップ設定 これらのオプションはメインのバックアップファイルとログバックアップファイルに適用されます。 - - **セグメントサイズ (MB)**: +- **セグメントサイズ (MB)**: 4D ではアーカイブをセグメントに分割することができます。 この振る舞いにより、たとえばバックアップファイルを複数の異なるディスク (DVDやUSBデバイス等) に格納できます。 復元時、4D はセグメントを自動的に統合します。 各セグメントには MyApplication[xxxx-yyyy].4BK といった名称がつけられます (xxxx はバックアップ番号、yyyy はセグメント番号)。 たとえば、MyApplication のバックアップが 3つのセグメントに分割されると、次のような名前になります: MyApplication[0006-0001].4BK、MyApplication[0006-0002].4BK、MyApplication[0006-0003].4BK **セグメントサイズ** はコンボボックスであり、各セグメントのサイズを MB単位で設定できます。 メニューから定義済み値を選択するか、0~2048 の値を入力できます。 0 を指定するとセグメント化はされません (**なし** を指定したのと同じ)。 - - **圧縮率**: +- **圧縮率**: デフォルトで 4D はバックアップファイルを圧縮してディスクスペースを節約します。 しかし大量のデータがある場合、ファイルの圧縮処理はバックアップにかかる時間を長くします。 **圧縮率** オプションを使用してファイルの圧縮モードを調整できます: - **なし**: ファイルの圧縮はおこなわれません。 バックアップは早くおこなわれますが、ファイルサイズは大きくなります。 - **速度** (デフォルト): このオプションはバックアップの速度とアーカイブサイズのバランスが考慮されたものです。 - **圧縮率**: アーカイブに最大の圧縮率が適用されます。 アーカイブファイルはディスク上で最小のサイズとなりますが、バックアップの速度は低下します。 - - **インターレース率と冗長率**: +- **インターレース率と冗長率**: 4D は、最適化 (インターレース) とセキュリティ (冗長) メカニズムに基づく特定のアルゴリズムを使用してアーカイブを生成します。 これらのメカニズムを必要に応じて設定できます。 これらのオプションのメニューには低・中・高・なし (デフォルト) の選択肢があります。 - **インターレース率**: インターレースとはデータを連続しない領域に書き込むことにより、セクター損傷の際のリスクを低減させるものです。 率を上げることでリスクがより低減されますが、データの処理により多くのメモリが必要となります。 - **冗長率**: 冗長は同じ情報を複数回繰り返すことで、ファイル中のデータを保護するものです。 冗長率を高くするとよりファイルが保護されます。しかし書き込みは遅くなり、ファイルサイズも増大します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md index b64738eed44277..6797c5d2ea76b5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: - - 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 - - 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -33,18 +33,18 @@ $col:=New collection // $col を空のコレクションで初期化します 演算の結果は、オペランドの **データ型** に依存します。4D はスカラーデータ型に対して様々な演算子をサポートしています。 詳細は、各データ型の項にて説明されています: - - [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) - - [**日付演算子**](dt_date.md#日付演算子) - - [**時間演算子**](dt_time.md#時間演算子) - - [**数値演算子**](dt_number.md#数値演算子) - - [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) - - [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) - - [**ポインター演算子**](dt_pointer.md#ポインター演算子) - - [**文字列演算子**](dt_string.md#文字列演算子) - - [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) - - [**コレクション参照演算子**](dt_collection.md#コレクション演算子) - - [**Null 演算子**](dt_null_undefined.md#null-演算子) - - [**未定義演算子**](dt_null_undefined.md#未定義演算子) +- [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) +- [**日付演算子**](dt_date.md#日付演算子) +- [**時間演算子**](dt_time.md#時間演算子) +- [**数値演算子**](dt_number.md#数値演算子) +- [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) +- [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) +- [**ポインター演算子**](dt_pointer.md#ポインター演算子) +- [**文字列演算子**](dt_string.md#文字列演算子) +- [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) +- [**コレクション参照演算子**](dt_collection.md#コレクション演算子) +- [**Null 演算子**](dt_null_undefined.md#null-演算子) +- [**未定義演算子**](dt_null_undefined.md#未定義演算子) ## 複合代入演算子 @@ -272,9 +272,9 @@ $name:=$person.maidenName || $person.name 三項演算子は 3つのオペランドを次の順序で受け取ります: - - 条件とクエスチョンマーク (?) - - 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) - - 条件が [falsy](#truthy-と-falsy) の場合に実行される式 +- 条件とクエスチョンマーク (?) +- 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) +- 条件が [falsy](#truthy-と-falsy) の場合に実行される式 ### シンタックス @@ -325,21 +325,21 @@ $fullname:=($person.firstname && $person.lastname) ? ($person.firstname+" "+$per 以下の値は **falsy** です: - - false - - Null - - undefined - - Null オブジェクト - - Null コレクション - - Null ポインター - - Null ピクチャー - - Null 日付 !00-00-00! - - "" - 空の文字列 - - [] - 空のコレクション - - {} - 空のオブジェクト +- false +- Null +- undefined +- Null オブジェクト +- Null コレクション +- Null ポインター +- Null ピクチャー +- Null 日付 !00-00-00! +- "" - 空の文字列 +- [] - 空のコレクション +- {} - 空のオブジェクト 上記以外の値はすべて **truthy** と評価されます。次の値も truthy です: - - 0 - 数値のゼロ (整数かどうかを問わず) +- 0 - 数値のゼロ (整数かどうかを問わず) 4Dでは、**truthy** と **falsy** の評価は値の **使用性** を反映します。つまり、truthy な値は存在し、エラーや予期せぬ結果を発生させずにコードによって処理できることを意味します。 その目的は、オブジェクトやコレクションにおける *undefined* や *null* 値を扱うための便利な方法を提供し、実行時エラーを回避するのに必要な [If...Else](flow-control.md#ifelseend-if) 文の数を少なくすることにあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md index c5099654e05cd7..bf38f56c24bd72 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -54,8 +54,8 @@ var $myVar // バリアント型変数 `varType` には次が指定できます: - - [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます - - [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます +- [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます +- [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます `varType` を省略すると、**variant** 型の変数が作成されます。 @@ -87,7 +87,7 @@ var $myVar // バリアント型変数 ### 例題 - - 基本のデータ型の、ローカル変数およびプロセス変数の宣言: +- 基本のデータ型の、ローカル変数およびプロセス変数の宣言: ```4d var $myText; myText; $vt : Text @@ -99,14 +99,14 @@ var $o : 4D.Object // C_OBJECT($o) とも同義です ``` - - 4Dクラス型のオブジェクト変数の宣言: +- 4Dクラス型のオブジェクト変数の宣言: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - ユーザークラス型のオブジェクト変数の宣言: +- ユーザークラス型のオブジェクト変数の宣言: ```4d var $myClass : cs.MyClass @@ -194,9 +194,9 @@ MyNumber:=3 ローカル変数は、以下のような目的のために使用されます: - - 他の変数名との重複を避ける。 - - データを一時的に使用する。 - - プロセス変数の数を減らす。 +- 他の変数名との重複を避ける。 +- データを一時的に使用する。 +- プロセス変数の数を減らす。 ローカル変数の名前は必ずドル記号 ($) で始め、この記号を除く31文字までの文字を指定できます。 これより長い名前を指定すると、4D は余分の32文字以降を切り捨てます。 @@ -225,9 +225,9 @@ MyNumber:=3 `GET PROCESS VARIABLE` や `SET PROCESS VARIABLE` を使用して、あるプロセスから他のプロセスのプロセス変数の値を取得したり、設定したりできます。 これらのコマンドの利用は、以下のような状況に限定することが、良いプログラミングの作法です: - - コード内の特定の箇所におけるプロセス間通信 - - プロセス間のドラッグ＆ドロップ処理 - - クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 +- コード内の特定の箇所におけるプロセス間通信 +- プロセス間のドラッグ＆ドロップ処理 +- クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 詳細については **プロセス** の章と、各コマンドの説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Debugging/basics.md b/i18n/ja/docusaurus-plugin-content-docs/current/Debugging/basics.md index 9500d212469b2e..6f8747a80166fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Debugging/basics.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Debugging/basics.md @@ -33,13 +33,13 @@ title: デバッガー 一般に、これらは発見が最も難しいタイプのエラーです。 これまでに説明しているエラーは、タイプミスを除いて、"設計またはロジックのエラー" という範疇に該当します。 これらを検知するには、[デバッガー](debugger.md) を使用します。 例: - - まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 - - 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 +- まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 +- 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 設計またはロジックのエラーには、次のような場合もあります: - - `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 - - オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 +- `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 +- オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 場合によって問題の原因は、実際に中断が発生しているコード部分ではなく、外部にあることもあります。 @@ -55,8 +55,8 @@ title: デバッガー メソッドの実行が停止されるとシンタックスエラーウィンドウが表示されます。 これは以下の理由で起こります: - - 以降のメソッド実行を妨げるエラーが発生した。 - - メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 +- 以降のメソッド実行を妨げるエラーが発生した。 +- メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ title: デバッガー シンタックスエラーウィンドウにはいくつかのオプションが用意されています: - - **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 +- **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 - - **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 +- **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 - - **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 +- **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 :::tip @@ -76,14 +76,14 @@ title: デバッガー ::: - - **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: +- **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: - イベントに対してフォームメソッドまたはオブジェクトメソッドが実行されている場合には、これらは停止され、フォームに戻ります。 - メソッドがアプリケーションモードから実行されている場合には、このモードに戻ります。 - - **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 +- **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 - - **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 +- **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 ## デバッガー diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md index 804217b5d17516..e37db10b0ae5a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md @@ -15,10 +15,10 @@ title: On After Edit このイベントは、変更がおこなわれた方法に関係なく、入力可能オブジェクトの内容が変更されるたびに生成されます。*つまり*: - - ペーストやカット、削除、キャンセルなどの標準の編集アクション - - 値のドロップ (ペーストと同様のアクション) - - ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 - - ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 +- ペーストやカット、削除、キャンセルなどの標準の編集アクション +- 値のドロップ (ペーストと同様のアクション) +- ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 +- ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 `On After Edit` イベント内において、入力テキストは [`Get edited text`](../commands-legacy/get-edited-text.md) コマンドによって返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md index a71ad495fc74bf..6442cb5cb2fd76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ title: On Begin Drag Over `On Begin Drag Over` イベントは、ドラッグアクションの準備に役立ちます。 このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: - - `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 - - `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 - - ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 +- `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 +- `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 +- ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 - ドラッグアクションを受け入れるには、ソースオブジェクトのメソッドは 0 (ゼロ) を返さなければなりません。 - ドラッグアクションを拒否するには、ソースオブジェクトのメソッドは -1 (マイナス1) を返さなければなりません。 - 結果が返されない場合は、ドラッグアクションが受け入れられたと 4D は判断します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onClicked.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onClicked.md index fb9943c47bf011..a0ee2f849bb5d4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onClicked.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onClicked.md @@ -15,11 +15,11 @@ title: On Clicked `On Clicked` イベントは通常、マウスボタンが離されたときに生成されます。 しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: - - [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 - - [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 - - [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 - - [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 - - リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 +- [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 +- [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 +- [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 +- [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 +- リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 `On Clicked` イベントのコンテキストにおいては `Clickcount` コマンドを使うことによってユーザーがおこなったクリック数をテストすることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md index 18ab0753f5e4fa..7d6fbdfc0b4604 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ title: On Display Detail このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - レコードごとに: +- レコードごとに: - 詳細エリアのオブジェクトごとに: - オブジェクトメソッドの `On Display Detail` イベント - フォームメソッドの `On Display Detail` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDragOver.md index 5816317910d07c..4cd0137a1c567d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over `On Drag Over` イベントは、マウスポインターがオブジェクトの上を移動する時に、繰り返しドロップ先オブジェクトに送られます。 このイベントの応答として、開発者は通常、以下のことをおこないます: - - ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 - - ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 +- ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 +- ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 ドラッグを **受け付ける** には、ドロップ先のオブジェクトメソッドが 0 (ゼロ) を返さなければなりません。 ドラッグを **拒否** するには、オブジェクトメソッドが -1 (マイナス1) を返さなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeader.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeader.md index 823b0b85ca3b81..2beac18b7b5659 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeader.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeader.md @@ -15,7 +15,7 @@ title: On Header このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - ヘッダーエリアのオブジェクトごとに: +- ヘッダーエリアのオブジェクトごとに: - オブジェクトメソッドの `On Header` イベント - フォームメソッドの `On Header` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md index 7120814e5d39cf..5317c52b286d9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md @@ -15,8 +15,8 @@ title: On Header Click リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されている場合、`$0` に 0 または -1 を渡して標準の並べ替えをおこなうかどうか指定できます: - - `$0 = 0` の場合、標準の並べ替えがおこなわれます。 - - `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 +- `$0 = 0` の場合、標準の並べ替えがおこなわれます。 +- `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されていない場合、`$0` は使用されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md index 8c2a56f640c5b6..5fa846241b07dd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md @@ -179,14 +179,18 @@ Select **Edit...** item is available when you right-click on the component name ![edit-component](../assets/en/Project/Edit-component.png) -When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the component code is editable in the following pages: +When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the following standard pages are available and give access to the component contents: ![tab-component](../assets/en/Project/tab-component.png) +- Home, including folders, methods, classes and (preview only) forms - ⒋ プロジェクトメソッド - Database Methods ([On Web Connection](../commands-legacy/on-web-connection-database-method.md), [On Web Authentication](../commands-legacy/on-web-authentication-database-method.md), [On Host Database Event](../commands-legacy/on-host-database-event-database-method.md)) - クラス - Project Form Methods +- Commands and Constants +- プラグイン +- Trash ![tab-component](../assets/en/Project/tab-component.gif) @@ -194,7 +198,8 @@ Standard 4D IDE features are available for the component. You can execute the fo - add, duplicate, delete, edit/save [methods and classes](../Project/code-overview.md) - preview code, show/edit [documentation](../Project/documentation.md), display/edit [method properties](../Project/code-overview.md#project-method-properties), -- run methods. +- run methods, +- restore from trash or empty trash. ## コンパイル済みコンポーネントのコード補完 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md index d5d31f0b890637..5ced8fbcb3e9a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -9,16 +9,16 @@ title: Forms また、以下の機能により、フォームは他のフォームを含むことができます: - - [サブフォームオブジェクト](FormObjects/subform_overview.md) - - [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) +- [サブフォームオブジェクト](FormObjects/subform_overview.md) +- [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) ## フォームを作成する 4Dフォームの追加や変更は、以下の要素を使っておこないます: - - **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 - - **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 - - **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: +- **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 +- **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 +- **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: ``` { @@ -70,9 +70,9 @@ title: Forms 2つのカテゴリーのフォームが存在します: - - **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 +- **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 - - **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 +- **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 フォームを作成する際にフォームカテゴリーを選択しますが、後から変更することも可能です。 @@ -80,15 +80,15 @@ title: Forms 各フォームは、少なくとも 2つのページで構成されています: - - ページ1: デフォルトで表示されるメインページ - - ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます +- ページ1: デフォルトで表示されるメインページ +- ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます 1つの入力フォームに複数のページを作成することができます。 一画面に納まりきらない数のフィールドや変数がある場合は、これらを表示するためにページを追加することができます。 複数のページを作成すると、以下のようなことが可能になります: - - もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 - - トピックごとに、専用ページにまとめる。 - - [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 - - フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 +- もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 +- トピックごとに、専用ページにまとめる。 +- [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 +- フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 複数ページは入力フォームとして使用する場合にのみ役立ちます。 印刷出力には向きません。 マルチページフォームを印刷すると、最初のページしか印刷されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/macros.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/macros.md index 3b5a305a52788f..2957ab4f5948ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/macros.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/macros.md @@ -7,11 +7,11 @@ title: フォームエディターマクロ たとえば、定期レポートに特定のフォーマットが指定されている場合 (例: テキストによってフォントカラーが赤や緑であるなど)、マクロを作成してフォントカラーの設定を自動でおこなうことができます。 4Dフォームエディターのマクロでは、次のことがおこなえます: - - 4Dコードを作成・実行する - - ダイアログを表示する - - オブジェクトを選択する - - フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する - - プロジェクトファイルを編集する (更新・削除) +- 4Dコードを作成・実行する +- ダイアログを表示する +- オブジェクトを選択する +- フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する +- プロジェクトファイルを編集する (更新・削除) フォームエディター用のカスタム機能を定義するため、マクロコードは [クラス関数](Concepts/classes.md) と [JSON のフォームオブジェクトプロパティ](FormObjects/properties_Reference.md) を使用できます。 @@ -237,9 +237,9 @@ Class constructor($macro : Object) フォームオブジェクトの `method` 属性を操作する場合、属性値は2通りの方法で定義できます: - - [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 +- [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 - - 次の構造を持つオブジェクトの使用: +- 次の構造を持つオブジェクトの使用: | プロパティ | 型 | 説明 | | ------ | ---- | ------- | @@ -251,9 +251,9 @@ Class constructor($macro : Object) `$4dId` プロパティは、現在のページにある各オブジェクトについて一意のIDを定義します。 このキーは`$result.currentPage` の変更を反映させるのに使用されます: - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 - - フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 +- フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 #### 例題 @@ -296,8 +296,8 @@ Function onInvoke($editor : Object)->$result : Object マクロの実行時に発生したエラーが、マクロの取り消しを不可能にする内容の場合、マクロは実行されません。 たとえば次のような場合が該当します: - - 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき - - 同じ内部ID を持つオブジェクトを複数作成しようとしたとき +- 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき +- 同じ内部ID を持つオブジェクトを複数作成しようとしたとき #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md index 802f09a55fede7..f99f6a4a11dc2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ title: オブジェクトライブラリ 4D では 2種類のオブジェクトライブラリを利用できます: - - 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます - - カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです +- 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます +- カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです ## 標準のオブジェクトライブラリの使用 @@ -21,10 +21,10 @@ title: オブジェクトライブラリ このウィンドウには次の主な機能があります: - - Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 - - 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: +- Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 +- 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: ![](../assets/en/FormEditor/library1.png) - - ライブラリのオブジェクトをフォーム上で使うには: +- ライブラリのオブジェクトをフォーム上で使うには: - オブジェクト上で右クリックし、コンテキストメニューから **コピー** を選択してフォーム上で同様に **ペースト** するか、 - ライブラリからフォーム上へと、オブジェクトをドラッグ＆ドロップします。 すると、フォームに当該オブジェクトが追加されます。 @@ -57,13 +57,13 @@ title: オブジェクトライブラリ カスタムのオブジェクトライブラリを開くには、**ファイル** メニューまたはツールバーから **開く > オブジェクトライブラリ...** コマンドを選択します。 標準のファイルを開くダイアログボックスが表示され、オブジェクトライブラリを選択できます。 次のファイルタイプが選択できます: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** カスタムオブジェクトライブラリは、実質的には標準の 4D プロジェクトです。 プロジェクトをライブラリとして開くと、次のものが公開されます: - - プロジェクトフォーム - - フォームのページ1 +- プロジェクトフォーム +- フォームのページ1 ### オブジェクトライブラリの構築 @@ -75,10 +75,10 @@ title: オブジェクトライブラリ ![](../assets/en/FormEditor/library5.png) - - ペーストボードへの **カット** または **コピー** - - ペーストボードからオブジェクトを **ペースト** - - **クリア** でライブラリからオブジェクトを削除 - - **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 +- ペーストボードへの **カット** または **コピー** +- ペーストボードからオブジェクトを **ペースト** +- **クリア** でライブラリからオブジェクトを削除 +- **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 オブジェクトライブラリには個々のオブジェクト (サブフォーム含む) やオブジェクトグループを格納できます。 それぞれのオブジェクトは1つのアイテムとしてグループ化されます: @@ -94,9 +94,9 @@ title: オブジェクトライブラリ メインのオブジェクトと一緒にライブラリに登録される依存オブジェクトは以下のとおりです: - - リスト - - フォーマット/フィルター - - ピクチャー - - ヘルプTips (フィールドにリンク) - - オブジェクトメソッド +- リスト +- フォーマット/フィルター +- ピクチャー +- ヘルプTips (フィールドにリンク) +- オブジェクトメソッド diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md index a48b9606f1e4aa..7068adb59aaf88 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ title: フォームサイズ ## サイズを決めるもの - - **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 +- **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 自動サイズのウィンドウを用いて、オフスクリーンエリア (ウィンドウの矩形境界線の外側のエリア) に配置したアクティブオブジェクトを使用したい場合にこのオプションを選択することができます。 このオプションを選択すると、これらのオブジェクトによりウィンドウサイズが変更されなくなります。 - - **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 +- **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 - - `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 +- `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 > 出力フォームの場合は [**水平マージン**](#水平-マージン) または [**幅**](#幅) フィールドだけが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md index 5f5880a86f38e4..0482a54ca27094 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ title: フォームオブジェクト 4D フォームでは多くのビルトイン **アクティブ** オブジェクトおよび **スタティック** オブジェクトが提供されています: - - **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 - - **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 +- **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 +- **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 ## オブジェクトの操作 4D フォームオブジェクトの追加や編集は次の方法でおこなえます: - - **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 +- **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 - - **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 +- **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 - - **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 +- **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 次はボタンオブジェクトの例です: ```json diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md index 4d09df782992d4..275394a1dab283 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md @@ -50,6 +50,6 @@ title: 入力 フィールドや変数などの式は、フォーム内において入力オブジェクト以外を用いて表示することができます。具体的には以下の方法があります: - - データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 - - [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 - - ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 +- データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 +- [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 +- ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index 46ec76d7d18ecf..c908ecfbd2ab1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -13,8 +13,8 @@ title: 階層リスト 階層リストの中身は次の方法で初期化することができます: - - 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 - - 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 +- 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 +- 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 どちらの場合においても、階層リストはランタイムでは *ListRef* の参照を通して、4D ランゲージの[階層リスト](../commands/theme/Hierarchical_Lists.md) のコマンドを使用して管理します。 @@ -34,9 +34,9 @@ mylist:=New list 特定のリストを使用している複数のフォームオブジェクトがある場合、それらにはそれぞれに固有の性質と、それらの間で共有される性質を持ちます。 以下の性質はリストフォームオブジェクトごとに固有のものです: - - 選択された項目 - - 項目の展開/折りたたみ状況 - - スクロールカーソルの位置 +- 選択された項目 +- 項目の展開/折りたたみ状況 +- スクロールカーソルの位置 それ以外の性質 (フォント、フォントサイズ、スタイル、入力制御、カラー、リストの内容、アイコン等) は他のリストフォームオブジェクトと共有され、個別に変更することはできません。 したがって、展開/折りたたみ状況に基づくコマンドやカレントの項目に関するコマンド、たとえば `Count list items` を (最後の `*` 引数を渡さずに) 使用するとき、どのフォームオブジェクトに対する処理なのかを明示的に指定することが重要です。 @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 他のオブジェクトプロパティ管理コマンドのように、`ListName` 引数で “@” 文字を使用できます。 このシンタックスは、フォーム上の複数のオブジェクトを指定するために使用されます。 しかし階層リストコマンドのコンテキストにおいては、これはすべての場合に適用されるわけではありません。 コマンドのタイプにより、このシンタックスは 2つの異なる効果があります: - - プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 +- プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: +- プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) いくつかの 4Dの汎用コマンドを使用して、フォーム上の階層リストオブジェクトの見た目を変更することができます。 これらのコマンドには、\* を用いたシンタックスを使用して階層リストのオブジェクト名を渡すか、あるいは標準シンタックスを使用して階層リストの ListRef 参照を格納している変数を渡します。 - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > 注記: `OBJECT SET SCROLL POSITION` コマンドを除き、これらのコマンドでオブジェクト名を指定したとしても、変更は同じリストを使うすべてのオブジェクトに反映されます。 @@ -107,8 +107,8 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 階層リストのコンテンツにアクセスするには、通常は位置または参照のいずれかを使用しておこないます。 - - 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 - - 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 +- 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 +- 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 ### 項目参照番号を使用する (itemRef) @@ -141,9 +141,9 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) ユーザーが階層リストの項目を変更できるかどうかを管理することができます。階層リストの項目が修正可能である場合、**Alt+クリック** (Windows) または **Optionキー+クリック** (macOS) ショートカットを使用するか、または項目のテキスト上でロングクリックすると、編集できるようになります。 - - データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 +- データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 - - また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 +- また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md index c1547ffeb43582..df7961939cbbb8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ title: サブフォーム このプロパティを使用して、サブフォームで使用する詳細フォームを割り当てます。 以下のものを使用できます: - - ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ +- ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ コンポーネントで公開されていれば、コンポーネントフォーム名を選べます。 > サブフォームを介して追加の機能を提供する [コンポーネント](Concepts/components.md) を作成することが可能です。 - - [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 +- [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 #### JSON 文法 @@ -52,8 +52,8 @@ title: サブフォーム リストサブフォームの空行がダブルクリックされた際に実行されるアクションを指定します。 次のオプションから選択することができます: - - 何もしない: ダブルクリックを無視します。 - - レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 +- 何もしない: ダブルクリックを無視します。 +- レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 #### JSON 文法 @@ -77,9 +77,9 @@ title: サブフォーム ユーザーがリストサブフォームの行をダブルクリックした際に実行されるアクションを指定します。 選択可能なオプションは以下の通りです: - - **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 - - **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 - - **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 +- **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 +- **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 +- **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 選択されているアクションに関わらず、`On Double Clicked` フォームイベントが生成されます。 @@ -161,10 +161,10 @@ title: サブフォーム リストボックス行の選択モードを指定します: - - **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 - - **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ +- **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 +- **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ 上下キーを使うとリストの前後の行が選択されます。 その他のナビゲーションキーはリストをスクロールします。 カレントの行が変更されるたびに、`On Selection Change` フォームイベントが生成されます。 - - **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 +- **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 - 選択されたサブレコードは `GET HIGHLIGHTED RECORDS` で取得できます。 - レコードはクリックにより選択されますが、カレントレコードは変更されません。 - **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象レコードの選択状態 (選択・非選択) が切り替わります。 上下キーを使うとリストの前後のレコードが選択されます。 その他のナビゲーションキーはリストをスクロールします。 選択レコードが変更されるたびに、`On Selection Change` フォームイベントが生成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md index b5e6f8d3e97ef4..db4b8ddfb3586c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ title: 図形 次の基本の図形が提供されています: - - 四角 - - 線 - - 楕円 +- 四角 +- 線 +- 楕円 ## 四角 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/splitters.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/splitters.md index 01b27f6fe5dd2a..89558aadffe1d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/splitters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/splitters.md @@ -11,10 +11,10 @@ title: スプリッター スプリッターの一般的な特徴をいくつか次に説明します: - - あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 - - スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 - - フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 - - スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 +- あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 +- スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 +- フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 +- スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 スプリッターは挿入されると線として表示されます。 その [線のスタイル](properties_BackgroundAndBorder.md#境界線スタイル) を変更してさらに細い線に設定したり、線の種類によっては [線の色](properties_BackgroundAndBorder.md#線カラー) を設定したりすることができます。 @@ -55,8 +55,8 @@ title: スプリッター 各スプリッターには *倍長整数* 型の [変数](properties_Object.md#変数あるいは式) が割り当てられます。 この変数はオブジェクトメソッドやフォームメソッドで使用することができます。 この変数の値により、スプリッターの最初の位置に対する現在位置がピクセル単位で示されます。 - - この値が負数の場合: スプリッターは上または左方向へ移動されました。 - - この値が正数の場合: スプリッターは下または右方向へ移動されました。 - - この値が 0 の場合: スプリッターは元の位置に移動されました。 +- この値が負数の場合: スプリッターは上または左方向へ移動されました。 +- この値が正数の場合: スプリッターは下または右方向へ移動されました。 +- この値が 0 の場合: スプリッターは元の位置に移動されました。 プログラムによってスプリッターを移動させることも可能です。これをおこなうには、関連付けた変数の値を設定します。 たとえば、垂直スプリッターに `split1` という名前の変数が関連付けられている場合、`split1:=-10` という命令を実行すると、ユーザーが手動で動かす場合と同じように、スプリッターは 10ピクセル左方向へ移動します。 移動が実際におこなわれるのは、この命令文が記述されているフォームメソッドまたはオブジェクトメソッドを実行しおわったときです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/stepper.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/stepper.md index 2303c2289e500e..8f362edcb1ab32 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/stepper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/stepper.md @@ -13,11 +13,11 @@ title: ステッパー ステッパーには数値、時間、日付変数を割り当てることができます。 - - 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: +- 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: - [最小](properties_Scale.md#最小) = 28,800 (8\*60\*60) - [最大](properties_Scale.md#最大) = 64,800 (18\*60\*60) - [ステップ](properties_Scale.md#ステップ) = 600 (10\*60) - - 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 +- 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 > 時間や日付変数に対してステッパーを動作させるためには、プロパティリストで型を設定するだけでなく、`Time` または `Date` 型として [明示的に宣言](../Concepts/variables.md#変数の宣言) する必要があります。 @@ -29,8 +29,8 @@ title: ステッパー ## 参照 - - [進捗インジケーター](progressIndicator.md) - - [ルーラー](ruler.md) +- [進捗インジケーター](progressIndicator.md) +- [ルーラー](ruler.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md index 42924315d34a8a..140dd6f5bccbe0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ title: サブフォーム サブフォームに実装されたコンセプトを明確に説明するために、いくつかの用語についてここで定義します: - - **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 - - **親フォーム**: 1つ以上のサブフォームを含むフォーム。 - - **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 - - **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 - - **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 - - **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 +- **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 +- **親フォーム**: 1つ以上のサブフォームを含むフォーム。 +- **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 +- **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 +- **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 +- **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 ## リストサブフォーム @@ -43,8 +43,8 @@ title: サブフォーム デフォルトで、4D はサブフォームコンテナーに [オブジェクト型](properties_Object.md#式の型式タイプ) の変数あるいは式をバインドし、`Form` コマンドを使ってサブフォームのコンテキストで値を共有できるようにします。 しかし、単一の値のみを共有したい場合は、任意のスカラー型 (時間、整数など) の変数や式を使用することもできます。 - - バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 - - または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 +- バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 +- または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 ### 親フォームとサブフォームの同期 (単一値) @@ -58,8 +58,8 @@ title: サブフォーム 時間を静的に表示するには、適切な [データ型](properties_DataSource.md#データタイプ-式の型) を [変数または式](properties_Object.md#変数あるいは式) に使用する必要があります。 - - 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 - - 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 +- 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 +- 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 テキスト値のフォーマットは "hh:mm:ss" でなくてはなりません。 @@ -91,15 +91,15 @@ End if [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントは以下のときに生成されます: - - 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 - - サブフォームが 0ページまたはカレントフォームページに置かれているとき。 +- 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 +- サブフォームが 0ページまたはカレントフォームページに置かれているとき。 先の例のとおり、式を直接使用するのではなく、親フォームのサブフォームコンテナーの式の値を取得する `OBJECT Get subform container value` コマンドの利用が推奨されます。親フォームに同じサブフォームを複数配置することが可能だからです (たとえば、複数のタイムゾーンを表示するために時計を複数表示するウィンドウ)。 バインドされた変数あるいは式を変更すると、フォームイベントが発生し、親フォームとサブフォームの値を同期させることができます: - - 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 - - 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 +- 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 +- 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 #### 親フォームの内容を更新する @@ -177,8 +177,8 @@ End if このようなニーズにこたえるため、4Dは以下のメカニズムを実装しています: - - `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 - - `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 +- `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 +- `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 > `GOTO OBJECT` はサブフォームから実行されても、親フォーム内にて目的のオブジェクトを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md index e8e126265e682c..31fd406343928b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md @@ -42,9 +42,9 @@ macOSの場合、タブコントロールを標準位置 (上) だけでなく タブコントロールにラベルを設定するには、次のものを利用できます: - - オブジェクト - - 選択リスト - - 配列 +- オブジェクト +- 選択リスト +- 配列 ### オブジェクトの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/text.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/text.md index cf3f24dced5d66..acd1812e9e7576 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/text.md @@ -33,9 +33,9 @@ title: Text ![](../assets/en/FormObjects/staticText2.png) - - オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 - - オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 - - オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 +- オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 +- オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 +- オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/analysis.md b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/analysis.md index c6ad7de797c35d..bc308e52b40ab0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/analysis.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/analysis.md @@ -14,9 +14,9 @@ sidebar_label: ログ解析ページ この情報を使用して各操作のソースとコンテキストを識別できます: - - **操作**: ログファイル中での一連の操作番号 +- **操作**: ログファイル中での一連の操作番号 - - **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: +- **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: - データファイルを開く: データファイルを開いた - データファイルを閉じる: 開いたデータファイルを閉じた - コンテキストの作成する: 実行コンテキストを指定するプロセスを作成した @@ -30,24 +30,24 @@ sidebar_label: ログ解析ページ - トランザクションのキャンセル: トランザクションをキャンセルした - コンテキストの更新: 追加データを変更した (例: `CHANGE CURRENT USER` あるいは `SET USER ALIAS` の呼び出し) - - **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル +- **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル - - **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 +- **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 - - **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 +- **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 - - **サイズ**: 操作により処理されたデータのサイズ (バイト単位) +- **サイズ**: 操作により処理されたデータのサイズ (バイト単位) - - **日付と時刻**: 処理が実行された日付と時刻 +- **日付と時刻**: 処理が実行された日付と時刻 - - **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 +- **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 - - **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 +- **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 - - **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ +- **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ ***注**: データベースが暗号化されており、開かれたログファイルに対応する有効なデータキーが提供されていない場合、暗号化された値はこのカラムには表示されません。* - - **レコード**: レコード番号 +- **レコード**: レコード番号 選択したアプリケーションのカレントログファイル (デフォルトで "データファイル名.journal" というファイル名) の内容を更新するには **解析** をクリックします。 ブラウズボタンをクリックすると、アプリケーションの他のログファイルを選択できます。 **書き出し...** ボタンを使用してファイルの内容をテキストとして書き出せます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/repair.md b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/repair.md index 24e5228e57e8c6..a95c87ac97d369 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/repair.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/repair.md @@ -51,13 +51,13 @@ sidebar_label: 修復ページ "データファイル中で見つかったレコード" エリアには 2つのリストがあり、データスキャン結果の概要が表示されます。 - - 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: +- 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: - **順番** の列には、レコードグループの再生順が表示されます。 - **カウント** 列には、グループに含まれるレコード数が表示されます。 - **割当先テーブル** 列には、識別されたレコードのグループに割り当てられたテーブルの名前が表示されます。 割り当てられたテーブルの名前は自動で緑色で表示されます。 割り当てされなかったグループ、つまりどのレコードにも関連づけることができなかったテーブルは赤色で表示されます。 - **再生** 列では、レコードを再生するかどうかを各グループごとに指定できます。 デフォルトで、テーブルに割り当てられるすべてのグループが選択されています。 - - 右側のリストには、プロジェクトファイルのテーブルが表示されます。 +- 右側のリストには、プロジェクトファイルのテーブルが表示されます。 ### 手動による割り当て @@ -74,7 +74,7 @@ sidebar_label: 修復ページ 修復が完了すると、4D はプロジェクトの Logsフォルダーにログファイルを生成します。 このファイルを使用すると実行されたオペレーションをすべて閲覧することができます。 このファイルは XML形式で作成され、ApplicationName_Repair_Log_yyyy-mm-dd hh-mm-ss.xml というファイル名がつけられます。 - - *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) - - *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 +- *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) +- *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 **ログファイルを開く** ボタンをクリックすると、4Dはマシンのデフォルトブラウザーを使用して直近のログファイルを開きます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Menus/properties.md b/i18n/ja/docusaurus-plugin-content-docs/current/Menus/properties.md index f04f9165350aaa..b751554c4bdddd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Menus/properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Menus/properties.md @@ -11,8 +11,8 @@ title: メニュープロパティ メニューエディターを使って、テキストリテラルを直接、ラベルとして入力することができます。 または、変数参照、xliff参照を使用することもできます。これによりアプリケーションの翻訳が容易になります。 次のの参照タイプを使用できます: - - :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 - - `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 +- :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 +- `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 4Dランゲージを使う場合は、`APPEND MENU ITEM`、`INSERT MENU ITEM`、および `SET MENU ITEM` コマンドの *itemText* パラメーターでタイトルプロパティを設定します。 @@ -53,8 +53,8 @@ title: メニュープロパティ メニューエディターにて、標準アクション/プロジェクトメソッドをメニューに割り当てることができます: - - **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 - - **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 +- **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 +- **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 **macOS に関する注記:** macOS の場合、プラットフォームインタフェース標準に合わせるために、*quit* (終了) アクションが割り当てられたカスタムメニューコマンドは自動でアプリケーションメニュー内に置かれます。 4Dランゲージで割り当てをおこなう場合、プロジェクトメソッドには `SET MENU ITEM METHOD` コマンド、標準アクションには `SET MENU ITEM PROPERTY` コマンドを使います。 @@ -101,13 +101,13 @@ title: メニュープロパティ ショートカットには **Shift** や **Alt** (Windows) または **Option** (macOS) キーを追加できます。 これにより使用できるショートカットの数を増やすことができます。 以下のタイプのショートカットを定義できます: - - Windows: +- Windows: - Ctrl+文字 - Ctrl+Shift+文字 - Ctrl+Alt+文字 - Ctrl+Shift+Alt+文字 - - macOS: +- macOS: - Command+文字 - Command+Shift+文字 - Command+Option+文字 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md index df5c7f091c1341..05da7aab7a9570 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -9,17 +9,17 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. - - Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. - - 4Dランゲージ: +- The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. +- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. +- 4Dランゲージ: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). #### 動作の変更 - - Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. - - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). +- Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. +- Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. +- Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). ## 4D 20 R10 @@ -27,27 +27,27 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - [データ上のORDA イベント](../ORDA/orda-events.md) の管理。 - - [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) 関数の[`options`](../API/TCPConnectionClass.md#options-parameter) 引数に新しい`connectionTimeout` オプションが追加されました。 - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - 4Dランゲージ: +- [データ上のORDA イベント](../ORDA/orda-events.md) の管理。 +- [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) 関数の[`options`](../API/TCPConnectionClass.md#options-parameter) 引数に新しい`connectionTimeout` オプションが追加されました。 +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- 4Dランゲージ: - 統一性のため、[`Create entity selection`](../commands/create-entity-selection.md) コマンドおよび [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) コマンドは、["4D 環境"](../commands/theme/4D_Environment.md) テーマから ["Selection"](../commands/theme/Selection.md) テーマへと移動しました。 - 新しい [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) および [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) コマンドを使用して、フォームオブジェクトに対して`Formula` オブジェクトを割り当て、または読み出しができるようになります。 - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) および [`LISTBOX Get property`](../commands/listbox-get-property.md) は3つの新しい定数をサポートするようになりました: `lk current item`、`lk current item position`、および `lk selected items expression` です。 - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### 動作の変更 - - Windows 上では、印刷しか想定していない(つまりスクリーン上で使用不可能な)カレントプリンターフォントは、4D の起動時にはロードされないようになりました。 - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- Windows 上では、印刷しか想定していない(つまりスクリーン上で使用不可能な)カレントプリンターフォントは、4D の起動時にはロードされないようになりました。 +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -55,20 +55,20 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - [*MeCab* ライブラリー](../settings/database.md#mecab日本語版のサポート) は今後廃止予定となり、次のリリースでは削除される予定です。 - - [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 - - ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 - - 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 - - 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 - - インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 - - [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 - - 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 - - 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) - - Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 - - 4D Write Pro インターフェース: 新しい [統合されたAI](../WritePro/writeprointerface.md#integrated-ai) を使用して、4D Write Pro ドキュメントから**chatGTP** とやり取りすることができます。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 +- [*MeCab* ライブラリー](../settings/database.md#mecab日本語版のサポート) は今後廃止予定となり、次のリリースでは削除される予定です。 +- [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 +- ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 +- 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 +- 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 +- インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 +- [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 +- 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 +- 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) +- Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 +- 4D Write Pro インターフェース: 新しい [統合されたAI](../WritePro/writeprointerface.md#integrated-ai) を使用して、4D Write Pro ドキュメントから**chatGTP** とやり取りすることができます。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 ## 4D 20 R8 @@ -76,29 +76,29 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 - - [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 - - [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 - - [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 - - [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 - - Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) - - ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーション) することができるようになりました。 - - 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 - - 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 - - [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 - - 4D Write Pro: +- [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 +- [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 +- [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 +- [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 +- [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 +- Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) +- ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーション) することができるようになりました。 +- 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 +- 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 +- [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 +- 4D Write Pro: - 以下のコマンドが、引数としてオブジェクトまたはコレクションを受け取れるようになりました: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md)、[WP Get attributes](../WritePro/commands/wp-get-attributes.md)、[WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md)、[WP Table append row](../WritePro/commands/wp-table-append-row.md)、 [WP Import document](../WritePro/commands/wp-import-document.md)、 [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md)、 [WP Add picture](../WritePro/commands/wp-add-picture.md)、および [WP Insert picture](../WritePro/commands/wp-insert-picture.md) - [WP Insert formula](../WritePro/commands/wp-insert-formula.md)、 [WP Insert document body](../WritePro/commands/wp-insert-document-body.md)、および [WP Insert break](../WritePro/commands/wp-insert-break.md) はレンジを返す関数になりました(頭文字のみ大文字です)。 - ドキュメント属性に関連した新しい式: [This.sectionIndex](../WritePro/managing-formulas.md)、 [This.sectionName](../WritePro/managing-formulas.md) および[This.pageIndex](../WritePro/managing-formulas.md) - - 4Dランゲージ: +- 4Dランゲージ: - 変更されたコマンド: [`FORM EDIT`](../commands/form-edit.md) - [4D.CryptoKey class](../API/CryptoKeyClass.md) の[`.sign()`](../API/CryptoKeyClass.md#sign) および [`.verify()`](../API/CryptoKeyClass.md#verify) 関数は *message* 引数においてBlob をサポートするようになりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 #### 動作の変更 - - [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 - - [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 +- [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 +- [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 ## 4D 20 R7 @@ -106,31 +106,31 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 - - [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 - - [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 - - コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 - - [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 - - 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 - - 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 - - Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 - - 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の +- 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 +- [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 +- [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 +- コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 +- [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 +- 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 +- 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 +- Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 +- 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の 署名 や [ドメイン](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.ja.html) を検証するためのキーが追加されました。 - - [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 - - 4Dランゲージ: +- [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 +- 4Dランゲージ: - 新コマンド: [Process info](../commands/process-info.md)、 [Session info](../commands/session-info.md)、 [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - 変更されたコマンド: [Process activity](../commands/process-activity.md)、 [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*o\*". - - 4D Write Pro: +- 4D Write Pro: - 新コマンド: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - 変更されたコマンド: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) および [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 #### 動作の変更 - - [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 - - [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 - - [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 +- [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 +- [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 +- [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 ## 4D 20 R6 @@ -138,25 +138,25 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 - - [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs) を介して、ホストプロジェクトに読み込まれているすべてのコンポーネント間で自動的に共有されるようになりました。 - - コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 - - 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 - - セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 - - [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 - - 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 - - サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 - - 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 - - プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 - - [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 - - 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 - - PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 +- [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 +- [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs) を介して、ホストプロジェクトに読み込まれているすべてのコンポーネント間で自動的に共有されるようになりました。 +- コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 +- 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 +- セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 +- [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 +- 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 +- サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 +- 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 +- プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 +- [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 +- 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 +- PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 #### 動作の変更 - - フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 - - [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 +- フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 +- [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 ## 4D 20 R5 @@ -164,21 +164,21 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 - - [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 - - QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 - - [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 - - [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). - - [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 - - RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 - - 新しい [$format](../REST/$format.md) RESTパラメーター。 - - [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 +- 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 +- [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 +- QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 +- [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 +- [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). +- [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 +- RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 +- 新しい [$format](../REST/$format.md) RESTパラメーター。 +- [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 #### 動作の変更 - - *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 - - ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 +- *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 +- ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 ## 4D 20 R4 @@ -186,24 +186,24 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 - - クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 - - HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 - - 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 - - `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 - - [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート - - 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 - - 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 - - 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 - - データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 +- TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 +- クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 +- HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 +- 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 +- `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 +- [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート +- 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 +- 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 +- 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 +- データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 #### 動作の変更 - - 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 - - セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 - - 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 - - [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 +- 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 +- セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 +- 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 +- [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 ## 4D 20 R3 @@ -211,21 +211,21 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 - - Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). - - [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 - - データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 - - ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 - - [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 - - ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 - - [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 +- 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 +- Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). +- [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 +- データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 +- ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 +- [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 +- ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 +- [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 #### 動作の変更 - - いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 - - 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 +- いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 +- 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 ## 4D 20 R2 @@ -239,15 +239,15 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th #### ハイライト - - 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 - - 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 - - 4D Write Pro インターフェース: 新しい [表ウィザード](../WritePro/writeprointerface.md)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 +- 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 +- 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 +- 4D Write Pro インターフェース: 新しい [表ウィザード](../WritePro/writeprointerface.md)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 #### 動作の変更 - - **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 +- **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 ## 4D 20.x LTS diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md index d95ad27ca22a23..440d7232052353 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/global-stamp.md @@ -34,8 +34,8 @@ title: グローバルスタンプの使い方 また、本機能を適切に動作させるためには、以下の条件が必要です: - - `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 - - 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: +- `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 +- 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: | フィールド | 型 | 説明 | | ------------------------------------------------------- | --------------- | -------------------- | @@ -64,8 +64,8 @@ title: グローバルスタンプの使い方 すると、4D は次の変更をおこないます: - - 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 - - まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 +- 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 +- まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 データ変更追跡を無効化するには: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index 1994fea99cf1f0..d1961f5f8a43eb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class 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 ae528cae6cea46..2b7347d927405d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ title: リモートデータストア `localID` はリモートデータストアに接続しているマシンにおけるローカルな識別IDです: - - 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 - - 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 - - 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 +- 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 +- 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 +- 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 これらの原則を下図に示します: @@ -29,9 +29,9 @@ title: リモートデータストア データストアアクセスを管理しているセッションは 4D Server の管理ウィンドウに表示されます: - - プロセス名: "REST Handler: \" - - タイプ: HTTP Server Worker - - セッション: `Open datastore` コマンドに渡されたユーザー名 +- プロセス名: "REST Handler: \" +- タイプ: HTTP Server Worker +- セッション: `Open datastore` コマンドに渡されたユーザー名 次の例では、1つのセッション上で 2つのプロセスが実行中です: @@ -47,11 +47,11 @@ title: リモートデータストア エンティティロッキングやトランザクションに関連した ORDA 機能は、ORDA のクライアント / サーバーモードと同様に、リモートデータストアにおいてもプロセスレベルで管理されます: - - あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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`). +- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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/Preferences/general.md b/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/general.md index 80cf6ccf197bb5..ad50707a4c445f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/general.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/general.md @@ -11,12 +11,12 @@ title: 一般ページ このオプションは、ユーザーがアプリケーションのみを起動したとき、4D が起動時に提供するデフォルトの表示を設定することができます。 - - **何もしない**: アプリケーションウィンドウのみが表示されます。 - - **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 - - **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 +- **何もしない**: アプリケーションウィンドウのみが表示されます。 +- **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 +- **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 > このオプションが選択されているときに、ドキュメントを開くダイアログボックスを強制的に表示させるには、プロジェクトを起動する際に、**Alt** (Windows) または **Option** (macOS) キーを押します。 - - **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 - - **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 +- **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 +- **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 > **4D Server**: 4D Server アプリケーションは、このオプションを無視します。 この環境においては、**何もしない** モードが常に選択されます。 @@ -30,8 +30,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド この機能は、以下の環境において利用することができます (4D 64-bit版のみ): - - コードエディターウィンドウ - - フォームエディターウィンドウ +- コードエディターウィンドウ +- フォームエディターウィンドウ これらのエディターのウィンドウはすべて、タブ形式にすることができます: @@ -47,9 +47,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 - - **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 - - **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 +- **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 +- **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 +- **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 ### アピアランス (macOSのみ) @@ -59,9 +59,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 - - **Light**: ライトテーマを使用します。 - - **Dark**: ダークテーマを使用します。 +- **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 +- **Light**: ライトテーマを使用します。 +- **Dark**: ダークテーマを使用します。 > この設定は macOS でのみサポートされています。 Windows上では、"Light" テーマが常に使用されます。 @@ -73,8 +73,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド このオプションをチェックすると、**ファイル ＞ 新規** メニューと、ツールバーの **新規** ボタンに、2つの項目が追加されます: - - **データベース...** - - **ストラクチャー定義を使用したデータベース...** +- **データベース...** +- **ストラクチャー定義を使用したデータベース...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ These items allow you to create binary databases (see [Creating a new database]( このエリアでは、カレントブラウザーに表示される 4D HTMLドキュメントへのアクセスを設定します: - - コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき - - エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき +- コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき +- エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき ### ドキュメント言語 @@ -151,8 +151,8 @@ These items allow you to create binary databases (see [Creating a new database]( 4Dがドキュメントのページを探す場所を設定します。 - - チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 - - チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 +- チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 +- チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 ### ローカルフォルダー diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/methods.md b/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/methods.md index 147bbceec67f46..e212ca4cc11df1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Preferences/methods.md @@ -15,8 +15,8 @@ title: メソッドページ このリストでは、コードエディターに適用するテーマを選択します。 利用可能なテーマがすべて表示され、カスタムテーマがある場合はそれも表示されます。 4D はデフォルトで 2つのテーマを用意しています: - - **デフォルトのLightテーマ** - - **デフォルトのDarkテーマ** +- **デフォルトのLightテーマ** +- **デフォルトのDarkテーマ** > デフォルトのテーマは変更や削除ができません。 @@ -38,8 +38,8 @@ title: メソッドページ テーマを定義するとは、以下のことを意味します: - - コードエディター全体のグローバルフォントとフォントサイズを設定する。 - - 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 +- コードエディター全体のグローバルフォントとフォントサイズを設定する。 +- 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 異なる色やスタイルを組み合わせることは、コードのメンテナンス目的に特に便利です。 @@ -83,8 +83,8 @@ title: メソッドページ ローカル4Dアプリケーション用の "国際的な" コード設定を有効化/無効化することができます。 - - **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 - - **チェック有り**: リージョン設定が使用されます。 +- **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 +- **チェック有り**: リージョン設定が使用されます。 > このオプションを変更した場合、変更を反映するには 4Dアプリケーションを再起動する必要があります。 @@ -138,9 +138,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード入力中に () と、閉じるカッコを自動的に挿入するようにします。 このオプションでは 2つの自動機能を管理します: - - **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 +- **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 - - **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: +- **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,10 +150,10 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード中での対応する括弧を強調する方法を設定します。 この強調は、括弧 (大カッコ[]、中カッコ{}、小カッコ()) が選択されたときに表示されます。 次のオプションから選択することができます: - - **なし**: 強調なし - - **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) - - **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 - - **太字**: 括弧が太字で表示されます。 +- **なし**: 強調なし +- **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) +- **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 +- **太字**: 括弧が太字で表示されます。 #### 変数とフィールドを強調 @@ -161,9 +161,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip ![](../assets/en/Preferences/optionsVariables.png) - - **しない**(デフォルト): ハイライトなし - - **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 - - **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 +- **しない**(デフォルト): ハイライトなし +- **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 +- **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 ハイライトカラーは [テーマ](#テーマの定義) ページにて設定が可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/architecture.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/architecture.md index 40f1cf2574945a..65708193f932f0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/architecture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/architecture.md @@ -5,7 +5,7 @@ title: プロジェクトのアーキテクチャー 4D プロジェクトは、一つのプロジェクトルートフォルダー (パッケージフォルダー) に格納された、複数のファイルやフォルダーから構成されています。 例: - - MyPackage (*プロジェクトルートフォルダー*) +- MyPackage (*プロジェクトルートフォルダー*) - `Components` - `Data` - `Logs` @@ -27,23 +27,23 @@ title: プロジェクトのアーキテクチャー 典型的な Project フォルダーの構造です: - - `.4DProject` ファイル - - `Sources` +- `.4DProject` ファイル +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Forms` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (あれば) +- `DerivedData` +- `Trash` (あれば) ### `.4DProject` ファイル プロジェクトを定義し、起動するためのプロジェクト開発ファイルです。 このファイルを開くには次のいずれかが必要です: - - 4D - - 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) +- 4D +- 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) > 4D プロジェクトの開発は 4D によっておこない、マルチユーザー開発はソース管理ツールによって管理します。 4D Server は .4DProject ファイルを開くことができますが、クライアントからの開発はおこなえません。 @@ -121,9 +121,9 @@ title: プロジェクトのアーキテクチャー プロジェクトから削除されたメソッドやフォームがあれば、Trash フォルダーにはそれらが格納されます。 たとえば、つぎのフォルダーが格納されている場合があります: - - `Methods` - - `Forms` - - `TableForms` +- `Methods` +- `Forms` +- `TableForms` 削除された要素はファイル名に括弧が付いた形でフォルダー内に置かれます (例: "(myMethod).4dm")。 フォルダーの構成は [Sources](#sources) フォルダーと同じです。 @@ -176,11 +176,11 @@ Data フォルダーには、データファイルのほか、データに関わ Logs フォルダーには、プロジェクトが使用するすべてのログファイルが格納されます。 以下のログファイルが格納されます: - - データベース変換 - - Webサーバーリクエスト - - バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) - - コマンドデバッグ - - 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) +- データベース変換 +- Webサーバーリクエスト +- バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) +- コマンドデバッグ +- 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) > An additional Logs folder is available in the system user preferences folder (active 4D folder, see [Get 4D folder](../commands-legacy/get-4d-folder.md) command) for maintenance log files and in cases where data folder is read-only. 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 5406642cbae253..b2f18b378b40e4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md @@ -13,15 +13,15 @@ title: コンポーネント コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 - - インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 - - コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 +- インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 +- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 ### パッケージフォルダ コンポーネントのパッケージフォルダ(*MyComponent.4dbase* フォルダ) には以下のものを含めることができます: - - **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 - - **コンパイル版コンポーネント**の場合: +- **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 +- **コンパイル版コンポーネント**の場合: - .4DZ ファイル、*Resources* フォルダ、*Info.plist* ファイルを格納している"Contents" フォルダ(推奨されるアーキテクチャ) - *Resources* などの他のフォルダを格納している.4DZ ファイル。 @@ -37,8 +37,8 @@ title: コンポーネント このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: - - [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 - - 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 +- [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 +- 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 ::: @@ -46,14 +46,14 @@ title: コンポーネント 4Dプロジェクトにコンポーネントを読み込むには、以下の方法があります: - - コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 - - または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 +- コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 +- または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 **dependencies.json** ファイルで宣言されているコンポーネントは、異なる場所に保存できます: - - 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) - - マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) - - GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) +- 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) +- マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) +- GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) 同じコンポーネントが異なる場所にインストールされている場合、[優先順位](#優先順位) が適用されます。 @@ -69,8 +69,8 @@ title: コンポーネント このファイルには次の内容を含めることができます: - - [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 - - [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 +- [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 +- [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 #### environment4d.json @@ -78,8 +78,8 @@ title: コンポーネント このアーキテクチャーの主な利点は次のとおりです: - - **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 - - 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 +- **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 +- 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 ### 優先順位 @@ -187,9 +187,9 @@ GitHub に保存されているコンポーネントに関しては、[**depende GitHub に保存された 4Dコンポーネントを直接参照して使用するには、GitHubコンポーネントのリポジトリを設定する必要があります。 - - ZIP形式でコンポーネントファイルを圧縮します。 - - GitHubリポジトリと同じ名前をこのアーカイブに付けます。 - - このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 +- ZIP形式でコンポーネントファイルを圧縮します。 +- GitHubリポジトリと同じ名前をこのアーカイブに付けます。 +- このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 これらのステップは、4Dコードや GitHubアクションを使用することで簡単に自動化できます。 @@ -232,7 +232,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ ::: - - **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: +- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: ```json { @@ -245,7 +245,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ } ``` - - リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: +- リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: ```json { @@ -262,17 +262,17 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 以下にいくつかの例を示します: - - "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 - - "`*`": リリースされている最新バージョン。 - - "`1.*`": メジャーバージョン 1 の全バージョン。 - - "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 - - "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 - - "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 - - "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 - - "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 - - "`<=1.2.3`": 1.2.3 までの最新バージョン。 - - "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 - - "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 +- "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 +- "`*`": リリースされている最新バージョン。 +- "`1.*`": メジャーバージョン 1 の全バージョン。 +- "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 +- "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 +- "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 +- "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 +- "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 +- "`<=1.2.3`": 1.2.3 までの最新バージョン。 +- "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 +- "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 タグやバージョンを指定しない場合、4D は自動的に "latest" バージョンを取得します。 @@ -282,9 +282,9 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ [**4Dのバージョンに追随する**](#github依存関係バージョン範囲) 依存関係ルールを使用したい場合、GitHub レポジトリ上でのコンポーネントのリリースのタグは、特定の命名規則に従う必要があります。 - - **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 +- **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 - - **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 +- **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 :::note @@ -310,8 +310,8 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 参照された GitHubコンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます: - - macOs: `$HOME/Library/Caches//Dependencies` - - Windows: `C:\Users\\AppData\Local\\Dependencies` +- macOs: `$HOME/Library/Caches//Dependencies` +- Windows: `C:\Users\\AppData\Local\\Dependencies` ... 上記で `` は "4D"、"4D Server"、または "tool4D" となります。 @@ -319,12 +319,12 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. 構成には次の内容が含まれます: - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ The Dependency manager reads each component's own `dependencies.json` file and r 依存関係パネルを表示するには: - - 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
+- 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
![dependency-menu](../assets/en/Project/dependency-menu.png) - - 4D Server では、**ウインドウ/プロジェクト依存関係** メニューアイテムを選択します。
+- 4D Server では、**ウインドウ/プロジェクト依存関係** メニューアイテムを選択します。
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) 依存関係パネルが表示されます。 依存関係は ABC順にソートされます。 @@ -362,11 +362,11 @@ The Dependency manager reads each component's own `dependencies.json` file and r ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 - - **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 +- **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 ### Secondary dependencies @@ -384,16 +384,16 @@ When you hover over a secondary dependency, a tooltip displays the parent depend 使用されるステータスラベルは次のとおりです: - - **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 - - **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 - - **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 - - **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 - - **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 - - **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 - - **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 - - **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. - - **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. - - **Recent update**: A new version of the GitHub dependency has been loaded at startup. +- **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 +- **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 +- **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 +- **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 +- **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 +- **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 +- **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 +- **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. +- **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. +- **Recent update**: A new version of the GitHub dependency has been loaded at startup. 依存関係の行にマウスオーバーするとツールチップが表示され、ステータスに関する追加の情報を提供します: @@ -427,8 +427,8 @@ When you hover over a secondary dependency, a tooltip displays the parent depend コンポーネントアイコンとロケーションロゴが追加情報を提供します: - - コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 - - ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 +- コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 +- ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ When you hover over a secondary dependency, a tooltip displays the parent depend プロジェクトに依存関係を追加するには、**追加** をクリックします。 - - プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 - - プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 +- プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 +- プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 :::note @@ -489,11 +489,11 @@ The GitHub dependency is declared in the [**dependencies.json**](#dependenciesjs ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 - - **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 - - **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 - - **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 - - **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 +- **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 +- **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 +- **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 +- **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 +- **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 The current GitHub dependency version is displayed on the right side of the dependency item: @@ -509,8 +509,8 @@ Modifying the version range is useful for example if you use the automatic updat The Dependency manager provides an integrated handling of updates on GitHub. The following features are supported: - - Automatic and manual checking of available versions - - Automatic and manual updating of components +- Automatic and manual checking of available versions +- Automatic and manual updating of components Manual operations can be done **per dependency** or **for all dependencies**. @@ -526,11 +526,11 @@ If you provide an [access token](#providing-your-github-access-token), checks ar In addition, you can check for updates at any moment, for a single dependency or for all dependencies: - - To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. +- To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. ![check component](../assets/en/Project/check-component-one.png) - - To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. +- To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. ![check components](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ If you do not want to use a component update (for example you want to stay with You can update dependencies at any moment, for a single dependency or for all dependencies: - - To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: +- To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: ![check component](../assets/en/Project/update-component-one.png) - - To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: +- To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ In any cases, whatever the current dependency status, an automatic checking is d When you select an update command: - - a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. - - if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. +- a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. +- if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. #### Automatic update @@ -575,13 +575,13 @@ When this option is unchecked, a new component version matching your [component Registering your personal access token in the Dependency manager is: - - mandatory if the component is stored on a [private GitHub repository](#private-repositories), - - recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). +- mandatory if the component is stored on a [private GitHub repository](#private-repositories), +- recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). To provide your GitHub access token, you can either: - - "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 - - または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 +- "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 +- または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/documentation.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/documentation.md index 5ae69bd8026d8c..fc4e6fe69187b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/documentation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/documentation.md @@ -7,10 +7,10 @@ title: ドキュメンテーション ドキュメントすることができるプロジェクト要素は次のとおりです: - - メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) - - クラス - - Forms - - テーブルとフィールド +- メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) +- クラス +- Forms +- テーブルとフィールド ドキュメンテーションファイルは Markdown記法 (.md ファイル) で記述します。 これには、Markdown をサポートしている任意のエディターを使うことができます。 これらはそれぞれ独立したファイルとしてプロジェクトフォルダー内に格納されます。 @@ -34,7 +34,7 @@ title: ドキュメンテーション `Documentation` フォルダーのアーキテクチャーは次のとおりです: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ title: ドキュメンテーション - table1.md - ... - - プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 - - テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 > ドキュメントされているプロジェクト要素を名称変更したり、削除したりすると、その要素に紐づいている Markdown ファイルも自動で名称変更、または削除されます。 @@ -73,9 +73,9 @@ title: ドキュメンテーション ![](../assets/en/Project/comments-explo2.png) - - 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 +- 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 - - 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 +- 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 ### ドキュメンテーションファイルの編集 @@ -83,8 +83,8 @@ title: ドキュメンテーション 選択要素のドキュメンテーションファイルが存在しなければ: - - `Documentation` ペインにある **作成する** ボタンをクリックするか、 - - エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 +- `Documentation` ペインにある **作成する** ボタンをクリックするか、 +- エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ title: ドキュメンテーション `\.md` ファイルが `\/documentation` フォルダーに存在する場合、コードエディターは次の優先順位でヘルプTips を表示します: - - Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) +- Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) - - HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ +- HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ この場合、最初の文章には 4D コードパーサーによって自動生成されたメソッドの **プロトタイプ** が入ります。 :::note @@ -130,7 +130,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### サポートされている Markdown - - 見出しタグ: +- 見出しタグ: ```md # 見出し 1 @@ -138,7 +138,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### 見出し 3 ``` - - スタイルタグ (イタリック、太字、取り消し線) : +- スタイルタグ (イタリック、太字、取り消し線) : ```md _イタリック_ @@ -147,7 +147,7 @@ _イタリック_ ~~取り消し線~~ ``` - - 4D コードハイライトが付くコードブロックタグ (\`4d ... `): +- 4D コードハイライトが付くコードブロックタグ (\`4d ... `): ````md ```4d @@ -156,7 +156,7 @@ _イタリック_ ``` ```` - - テーブルタグ: +- テーブルタグ: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _イタリック_ | toolbar | Text |Toolbar name | ``` - - リンクタグ: +- リンクタグ: ```md // 例 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - 画像タグ: +- 画像タグ: ```md ![画像の説明](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - エクスプローラーの表示: +- エクスプローラーの表示: ![](../assets/en/Project/explorer_Doc.png) - - コードエディターの表示: +- コードエディターの表示: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$attributes.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$attributes.md index 3ae1f9e5ff3140..ce909e1666efa7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the `$attributes` はエンティティ (*例:* People(1)) またはエンティティセレクション (*例:* People/$entityset/0AF4679A5C394746BFEB68D2162A19FF) に対して適用できます。 - - クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 +- クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 - - **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntity`: リレートエンティティは簡単な形で返されます (`__KEY` (プライマリーキー) と `URI` プロパティを持つ deferred オブジェクト) - `$attributes=relatedEntity.*`: リレートエンティティの属性がすべて返されます。 - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: リレートエンティティの指定された属性だけが返されます。 - - **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntities.*`: リレートエンティティズの属性がすべて返されます。 - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: リレートエンティティズの指定された属性だけが返されます。 - - If `$attributes` is specified for **storage** attributes: +- If `$attributes` is specified for **storage** attributes: - `$attributes=attribute1, attribute2, ...`: only those attributes of the entities are returned. ## リレートエンティティズの例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$lock.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$lock.md index 1ded5dd7335092..d6a83ce65447f3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$lock.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$lock.md @@ -27,13 +27,13 @@ The locks triggered by the REST API are put at the [session](authUsers.md#sessio *ロック* されたエンティティは次のものから操作 (ロック / アンロック / 更新 / 削除) できません: - - 他の REST セッション - - RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 +- 他の REST セッション +- RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 REST API によってロックされたエンティティは、次の場合にのみアンロックされます: - - ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 - - ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 +- ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 +- ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 ### レスポンス diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$method.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$method.md index d1128f908f0860..722858ec7053d5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$method.md @@ -194,9 +194,9 @@ RESTリクエストで定義されたリレートエンティティのコレク :::note - - **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 - - **ブール** は true または false です。 - - `$upload` を使ってアップロードしたファイルは、`{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` のような形式で返されるオブジェクトを渡すことで、ピクチャー型やBLOB型の属性に適用できます。 +- **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 +- **ブール** は true または false です。 +- `$upload` を使ってアップロードしたファイルは、`{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` のような形式で返されるオブジェクトを渡すことで、ピクチャー型やBLOB型の属性に適用できます。 ### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md index e50b78e469b7f1..bf98fb587668af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md @@ -7,8 +7,8 @@ REST リクエストを使って、ORDA データモデルに定義されてい 関数は以下の2つの方法で呼び出すことができます: - - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 +- **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 +- **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。 一方で、GET リクエストは、URL をブラウザに入れるだけで関数を呼び出すことができるため、 よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 @@ -97,11 +97,11 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 次のルールが適用されます: - - POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 - - GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 - - 引数はコレクション (JSON形式) の中に格納する必要があります。 - - JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 - - エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 +- POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 +- GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 +- 引数はコレクション (JSON形式) の中に格納する必要があります。 +- JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 +- エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 [エンティティを引数として受け取る例題](#エンティティを引数として受け取る) と [エンティティセレクションを引数として受け取る例題](#エンティティセレクションを引数として受け取る) を参照ください。 @@ -135,8 +135,8 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 | __ENTITY | Boolean | 必須 - true は引数がエンティティであることをサーバーに通知します | | __KEY | 混合 (プライマリーキーと同じ型) | 任意 - エンティティのプライマリーキー | - - `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 - - `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 +- `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 +- `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 POST リクエストでエンティティを作成または更新する方法については以下の例題を参照して下さい。 GET リクエストとエンティティを使用してコンテンツをダウンロードする方法については以下の例題を参照して下さい。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/authUsers.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/authUsers.md index 24a5115b6e7e1a..9ac0e0f41fbe9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/authUsers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/authUsers.md @@ -43,9 +43,9 @@ When [scalable sessions are enabled](WebServer/sessions.md#enabling-web-sessions 記述的RESTリクエストは、ライセンスを必要としない Webユーザーセッション ("ゲスト" セッション) で処理することができます。 記述的RESTリクエストとは以下のものを指します: - - [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス - - `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 - - `/rest/$getWebForm` - Qodlyページのレンダリング +- [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス +- `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 +- `/rest/$getWebForm` - Qodlyページのレンダリング ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ exposed Function authentify({params : type}) {-> result : type} この関数は 2部構成で書かれる必要があります: - - RESTリクエストの送信元を識別し、認証するためのコード - - 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し +- RESTリクエストの送信元を識別し、認証するためのコード +- 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し 関数が [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) を呼び出さない場合、権限が割り当てられないため、ライセンスも消費されず、後続の記述的でない RESTリクエストは拒否されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/gettingStarted.md index 777d5af43f60d0..db67a21957bbe2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/gettingStarted.md @@ -9,8 +9,8 @@ RESTサーバーは 4D および 4D Server に含まれており、[設定完了 この章では、簡単な例題を使用して REST機能を紹介します。 これから、実際に次のことをしてみましょう: - - 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 - - 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 +- 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 +- 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 例題が複雑にならないよう、ここでは 4D とブラウザーを同じマシン上で使用します。 もちろん、リモートアーキテクチャーを使うことも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/processes.md b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/processes.md index 0ca173c609562f..4cb80f3b7efa91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/processes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/processes.md @@ -17,15 +17,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-buttons.png) - - **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 - - **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 - - **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 +- **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 +- **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 +- **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 **グループ毎にプロセスを表示** オプションを使用して、4D Server の内部プロセスやクライアントプロセスをグループ化できます。 このオプションをチェックすると: - - 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 - - "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 - - "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 +- 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 +- "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 +- "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 ウィンドウの下段には選択したプロセスの稼働状況がグラフィカルに表示されます。 @@ -33,16 +33,16 @@ title: プロセスページ プロセスの稼働状況は、4D Server がこのプロセスのために使用した時間のパーセンテージです。 ウィンドウにはプロセスごとに以下の情報が表示されます: - - プロセスタイプ (後述) - - セッション/情報: +- プロセスタイプ (後述) +- セッション/情報: - 4Dプロセス - 空白 - ユーザープロセス - 4Dユーザー名 - Webプロセス - URLパス - - プロセス名 - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 - - プロセスの現在の状況 - - 作成されてからのプロセスの実行時間 (秒) - - 4D Server がこのプロセスに使用した時間のパーセンテージ +- プロセス名 +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 +- プロセスの現在の状況 +- 作成されてからのプロセスの実行時間 (秒) +- 4D Server がこのプロセスに使用した時間のパーセンテージ ## プロセスタイプ @@ -83,15 +83,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-actions.png) - - **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 +- **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **プロセスを一時停止**: 選択したプロセスを一時停止します。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 - - **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 +- **プロセスを一時停止**: 選択したプロセスを一時停止します。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 > 確認ダイアログなしに選択したプロセスをデバッグするには、**Alt**キーを押しながらこのボタンをクリックします。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md index 6179dd1ed022bc..f822341cf0edcc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ title: リアルタイムモニターページ 各行について、以下の情報が表示されます: - - **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 - - **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 - - **情報**: 操作の説明。 - - **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: +- **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 +- **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 +- **情報**: 操作の説明。 +- **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: - **作成された場所**: そのオペレーションがクライアントアクションの結果か (クライアント上で作成)、ストアドプロシージャ―または "サーバー上で実行" オプションを使用した結果か (サーバー上で作成) を表示します。 - **オペレーション詳細**: オペレーションタイプと、(クエリオペレーションに対しては) クエリプランを表示します。 - **サブオペレーション** (あれば): 選択したオペレーションに従属するオペレーションを表示します (例:親レコードの前にリレートレコードを削除する) @@ -26,9 +26,9 @@ title: リアルタイムモニターページ このページは表示後すぐにアクティブになり、恒久的に更新され続けます。 ただし、この処理によって、アプリケーションの実行を極端に遅くさせる可能性があることに注意してください。 以下の方法を用いて更新を一時的に停止させることが可能です: - - **停止** ボタンをクリックする - - リストの中をクリックする - - スペースバーを押す +- **停止** ボタンをクリックする +- リストの中をクリックする +- スペースバーを押す ページを停止させると一時停止のメッセージが表示され、ボタンの表示が **再開** に変わります。 モニタリング停止操作と同じ操作をすることでモニタリングを再開させることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Users/overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/Users/overview.md index c9f97585e0b23e..18f88e2ba81165 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Users/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Users/overview.md @@ -7,8 +7,8 @@ title: アクセスコントロールの概要 運用環境によって、4D アクセスコントロールの方法は異なります: - - マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > 4Dのセキュリティ機能の概要については、[4D Security guide](https://blog.4d.com/4d-security-guide/) をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md index 70870aa1aea9a7..d7901194653d79 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ title: VP EXPORT DOCUMENT ドキュメント名に拡張子を付けることで、書き出すドキュメントの形式を指定することができます: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt" または ".csv") - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt" または ".csv") +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") ファイル名に拡張子が含まれていなくても、*paramObj* 引数によって形式が指定されている場合、書き出されたファイルには形式に対応する拡張子がつけられます。 ただし CSV形式の場合には拡張子がつきません。 @@ -88,25 +88,25 @@ title: VP EXPORT DOCUMENT **Excel 形式についての注意**: - - 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 - - ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 +- 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 **PDF 形式についての注意**: - - 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **CSV 形式についての注意**: - - 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 - - すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 +- すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **SpreadJS ファイル形式についての注意**: - - [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 書き出し操作が完了すると、`VP EXPORT DOCUMENT` は自動的に、*paramObj* オブジェクトの *formula* プロパティに設定されたメソッドをトリガーします (設定されていれば)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md index 4b85db02c19f3e..163d884fe9f6ea 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ title: VP Get stylesheets 任意の *sheet* 引数を使用することで、スタイルシートをどこから取得するかを指定することができます。シートインデックス (0 起点) か、以下の定数のいずれかを渡すことができます: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md index 7ac63c9deef533..a2c15488013851 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ title: VP Get value 返されるオブジェクトに日付または時間が含まれている場合、これは "日付時間"として扱われ、以下のように補完されます: - - 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 - - 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 +- 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 +- 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 *rangeObj* のレンジが複数セルあるいは複数レンジを含んでいる場合、最初のセルの値が返されます。 セルが空の場合には、コマンドは null オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md index d00f1cabd92020..5d069870ab5a4e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ title: VP IMPORT DOCUMENT *filePath* には読み込むドキュメントのパスとファイル名を渡します。 以下のフォーマットがサポートされています : - - 4D View Pro ドキュメント (拡張子 ".4vp") - - Microsoft Excel 形式 (拡張子 ".xlsx") - - テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") +- 4D View Pro ドキュメント (拡張子 ".4vp") +- Microsoft Excel 形式 (拡張子 ".xlsx") +- テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") ドキュメントの拡張子が認識される拡張子 (`.4vp` や `.xlsx` など) ではなかった場合、ドキュメントはテキスト形式であると見なされます。 ドキュメントが Project フォルダーと同階層に置かれている場合を除き、フルパスを渡す必要があります (同階層に置かれている場合にはファイル名のみを渡すことができます)。 @@ -73,11 +73,11 @@ title: VP IMPORT DOCUMENT :::note 注記 - - .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 - - Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 - - CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 +- Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 +- CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md index 392b3e5f084244..3e29b2a1d9721f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ title: VP RESIZE TABLE 次のルールが適用されます: - - ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 - - リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 - - 表組みを拡張した先にデータを含むセルが存在する場合には: +- ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 +- リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 +- 表組みを拡張した先にデータを含むセルが存在する場合には: - 行が追加された場合、データは削除されます。 - 列が追加された場合、データは保持され、新しい列に表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md index 320d57d260bc2c..37cce773edc7e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md @@ -38,20 +38,20 @@ title: はじめに ### セル、列、および行の選択 - - セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 +- セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 - - 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 +- 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 - - スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: +- スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - 列を選択するには、対応する文字 (アルファベット) をクリックします。 +- 列を選択するには、対応する文字 (アルファベット) をクリックします。 - - 行を選択するには、対応する番号をクリックします。 +- 行を選択するには、対応する番号をクリックします。 - - 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 +- 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 - - セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 +- セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 ### データの入力 @@ -77,8 +77,8 @@ title: はじめに クリックしたエリアに応じて、メニューには次の選択肢が表示されます: - - 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** - - セルあるいはセルレンジのクリック: +- 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** +- セルあるいはセルレンジのクリック: - **フィルタリング**: フィルタリングを使用して行を非表示にします ([SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/) の "Filtering rows" を参照ください) - **ソート**: 列のコンテンツを並べ替えます。 - **コメントの挿入**: ユーザーコメントを入力できます。 コメントが入力されているセルには、小さな赤い三角形が表示されます:\ @@ -129,8 +129,8 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro のレンジオブジェクトは、いくつかのプロパティで構成されます: - - area - 4D View Pro エリアの名称 - - ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 +- area - 4D View Pro エリアの名称 +- ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 | プロパティ | | 型 | 説明 | 利用可能な対象 | | ------ | ------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------- | -------------------------------------------------- | @@ -147,10 +147,10 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro は、複数のドキュメント形式のインポートおよびエクスポートに対応しています: - - .4vp - - .xlsx - - .txt と .csv - - .sjs - - .pdf (エクスポートのみ) +- .4vp +- .xlsx +- .txt と .csv +- .sjs +- .pdf (エクスポートのみ) 詳細については [VP IMPORT DOCUMENT](commands/vp-import-document.md) と [VP EXPORT DOCUMENT](commands/vp-export-document.md) の説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md index a66a66a3b6d4b3..89dfb36cb849a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ QodlyScript はローカル変数のみをサポートするため、QodlyScript QodlyScript のコマンドおよび定数名は、スペースを入れずにキャメルケースで記述されます。 また、QodlyScript の定数名は `k` 文字で始まります。 これらの QodlyScript の要素を 4Dランゲージに変換する必要があるかもしれません。 - - 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 - - しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 +- 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 +- しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 ### 例題 - - QodlyScript コード: +- QodlyScript コード: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript のコマンドおよび定数名は、スペースを入れずに end ``` - - 上に相当する 4Dランゲージのコード: +- 上に相当する 4Dランゲージのコード: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md index 8808b00ae70d46..af4c0e3ee6dd0d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ http://localhost/rest/Friends 4D Webサーバーにユーザーをログインさせる、もっともシンプルで安全な方法は、以下のシナリオに基づきます: - - ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 - - [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 +- ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 +- [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 1. いくつかのフィールドを持つテーブルを作成します。たとえば: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index cc26dc350cb0dc..7de1c63f722d09 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ title: HTTP Request handler カスタムのHTTP リクエストハンドラーを使用することで、以下のような用途に応えることができます: - - 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 - - コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする - - oAuth 2.0 経由での認証を管理する +- 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 +- コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする +- oAuth 2.0 経由での認証を管理する ## 要件 カスタムのHTTP リクエストハンドラーは以下の条件の元にサポートされます: - - [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること - - メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 +- [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること +- メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 :::warning @@ -62,9 +62,9 @@ title: HTTP Request handler ハンドラーは以下の3つの要素から定義されます: - - 聞くべきURL パターン - - 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 - - そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) +- 聞くべきURL パターン +- 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 +- そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) ハンドラーの識別子は、[パターン + 動詞のリストの中にある動詞]の組み合わせとなります。 @@ -72,10 +72,10 @@ title: HTTP Request handler URL パターンは**接頭辞** として、あるいは**正規表現** を使用して定義することできます。 - - 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ +- 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ Ex: `"pattern" : "docs"` または `"pattern" : "docs/invoices"` - - 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 +- 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 礼: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" と "regexPattern" プロパティは同じハンドラー定義内で同時に使用することはできません(使用した場合、"regexPattern" プロパティのみが有効となります)。 @@ -84,8 +84,8 @@ URL パターンは**接頭辞** として、あるいは**正規表現** を使 URL パターンは以下の指定された順番に基づいてトリガーされます: - - 最初に合致したパターンが実行されます。 - - それ以降のパターンは、URL に合致していたとしても実行されません。 +- 最初に合致したパターンが実行されます。 +- それ以降のパターンは、URL に合致していたとしても実行されません。 結果として、ハンドラーを作成する際には正確な戦略を適用する必要があります。つまり、もっとも詳細なパターンを先に、そして最も一般的なパターンを後に書く必要があります。 @@ -117,17 +117,17 @@ URL パターンは以下の指定された順番に基づいてトリガーさ カスタムの HTTP ハンドラーでは、4D ビルトインのHTTP 処理機能に合致するURL パターンは許可されていません。 例えば、以下のようなパターンは管理することができません: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### クラスとメソッド 定義されたURL パターンを検知して割り込んだときに実行されるべきコードを宣言するためには、"class" および "method" プロパティを使用します。 - - "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 - - "method": クラスに属性ているクラス関数 +- "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 +- "method": クラスに属性ているクラス関数 リクエストハンドラーコードについての情報に関しては、[後述の説明](#リクエストハンドラーコード) を参照してください。 @@ -208,11 +208,11 @@ HTTP 動詞はまた、[リクエストハンドラーコード内で`.verb` プ この例においては、以下の関数を実装する必要があります: - - *GeneralHandling* クラス内の*handle 関数* - - *UsersHandling* クラス内の *manageAccount* - - *FinancialHandling* クラス内の *handleInvoices* - - *DocsHandling* クラス内の *handleDocs* - - *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* +- *GeneralHandling* クラス内の*handle 関数* +- *UsersHandling* クラス内の *manageAccount* +- *FinancialHandling* クラス内の *handleInvoices* +- *DocsHandling* クラス内の *handleDocs* +- *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* 以下はハンドラーをトリガーするURL の一例です: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md index 67c3014902bd75..15b65fd334245f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ title: プリエンプティブWebプロセスの使用 | Web サーバー | コオペラティブ | *Web設定* | | Webサービスサーバー | コオペラティブ | *Web設定* | - - REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します - - Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します - - Web サービスサーバー: SOAPリクエストを処理します - - ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: +- REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します +- Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します +- Web サービスサーバー: SOAPリクエストを処理します +- ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: - if scalable sessions are enabled, the preemptive mode is automatically used for web and web service processes. - if scalable sessions are not enabled: - for web processes, the [**Use preemptive processes**](webServerConfig.md#use-preemptive-processes) option is taken into account. @@ -36,21 +36,21 @@ title: プリエンプティブWebプロセスの使用 Webプロセスをプリエンプティモードで実行するには、Webサーバーで実行されるすべての 4Dコードがスレッドセーフでなければなりません。 [プリエンプティブモードが有効化](#webプロセスにおけるプリエンプティブモードの使用可能状況) されている場合、アプリケーションの以下の部分が 4Dコンパイラーによって自動的に評価されます: - - すべての Web関連データベースメソッド: +- すべての Web関連データベースメソッド: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) と [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) +- `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) - - Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) +- Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) - - "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 +- "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 - - "RESTリソースとして公開" 属性が有効なテーブルのトリガー +- "RESTリソースとして公開" 属性が有効なテーブルのトリガー - - REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) +- REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) For each of these methods and code parts, the compiler will check if the [thread-safety rules are respected](../Develop/preemptive.md#writing-a-thread-safe-method), and will return errors in case of issues. @@ -62,8 +62,8 @@ Web関連のほとんどの 4Dコマンドや関数、データベースメソ すべての Web関連コマンドはスレッドセーフです: - - *Webサーバー* テーマの全コマンド - - *HTTPクライアント* テーマの全コマンド +- *Webサーバー* テーマの全コマンド +- *HTTPクライアント* テーマの全コマンド Web関連のデータベースメソッドもスレッドセーフであり、プリエンプティモードで使用することが可能です (前述参照): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...)。 @@ -73,15 +73,15 @@ Web関連のデータベースメソッドもスレッドセーフであり、 以下の 4D WebサーバーURLはスレッドセーフであり、プリエンプティモードで使用可能です: - - *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) - - *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) ### プリエンプティブWebプロセスアイコン diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md index fc3c38125b7464..257773f90f76f2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studioは、Webビジネスアプリケーションの開発に特化し Qodly Studio はフル機能の Web UI を提供し、以下のことを可能にします: - - キャンバス上にコンポーネントを配置して Qodlyページを作成する - - コンポーネントを Qodly Sources にマッピングする - - イベントを設定して 4Dコードをトリガーする - - さらに沢山のことが可能です +- キャンバス上にコンポーネントを配置して Qodlyページを作成する +- コンポーネントを Qodly Sources にマッピングする +- イベントを設定して 4Dコードをトリガーする +- さらに沢山のことが可能です ## 設定 @@ -24,19 +24,19 @@ Qodly Studio はフル機能の Web UI を提供し、以下のことを可能 Qodly Studio は、以下の Webブラウザーをサポートしています: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox 推奨解像度は 1920x1080 です。 #### 4Dアプリケーション - - 開発: 4D v20 R2 以上 - - 運用: 4D Server v20 R2 以上 - - Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 - - Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 - - Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 +- 開発: 4D v20 R2 以上 +- 運用: 4D Server v20 R2 以上 +- Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 +- Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 +- Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 ### Qodly Studio へのアクセスを有効化する @@ -46,8 +46,8 @@ Qodly Studioは、[WebAdmin Webサーバー](../Admin/webAdmin.md) によって Qodly Studio へのアクセスを有効化するには、2つのレベルで明示的に許可する必要があります: - - 4Dアプリケーションレベルで - - プロジェクトレベルで +- 4Dアプリケーションレベルで +- プロジェクトレベルで 2つのレベルのいずれか (または両方) が有効でない場合、Qodly Studio　へのアクセスは拒否されます (403ページが返されます)。 @@ -79,8 +79,8 @@ WebAdmin Webサーバーでの認証には、アクセスキーを使用しま 4Dプロジェクトの管理上、以下の使用法のみがサポートされます: - - Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 - - Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 +- Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 +- Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 :::warning @@ -94,10 +94,10 @@ Qodly Studio ページは、[WebAdmin Webサーバーが起動されており](. Qodly Studio にアクセスするには 2つの方法があります: - - **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 +- **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 WebAdmin Webサーバーがすでに起動されている場合は、その設定に応じて、デフォルトのブラウザーが `IPaddress:HTTPPort/studio` または `IPaddress:HTTPSPort/studio` を開きます。 それ以外の場合は、最初に WebAdmin Webサーバーを起動するかどうかを尋ねるメッセージが表示されます。 - - 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
+- 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
`IPaddress:HTTPPort/studio` または: @@ -145,24 +145,24 @@ Qodlyページを利用した Webアプリケーションを開発するには 以下のコマンドとクラスは、Qodlyページのサーバーサイド管理に特化しています: - - [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 - - [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 - - [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 - - [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 +- [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 +- [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 +- [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 +- [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 ### プロジェクトメソッドを使用する 推奨される方法は、プロジェクトメソッドではなく、クラス関数を使用することです。 コンポーネントから呼び出すことが可能なのは、クラス関数のみです。 それでも、次の 2つの方法で、Qodly Studio でもプロジェクトメソッドを使用できます: - - クラス関数からメソッドを呼び出すことができます。 - - Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 +- クラス関数からメソッドを呼び出すことができます。 +- Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 ### オフラインでの使用 コンピュータがインターネットに接続されていない状態でも、Qodly Studio を使って開発することができます。 ただしこの場合、以下の機能は使用できません: - - [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 - - UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 +- [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 +- UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 ## 運用 @@ -178,8 +178,8 @@ Qodly で Qodlyページをレンダリングする方法の詳細について Qodlyページのレンダリングを有効にするには、以下のオプションを設定する必要があります。 - - 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 - - [4D Webサーバー](webServer.md) を起動しておく必要があります。 +- 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 +- [4D Webサーバー](webServer.md) を起動しておく必要があります。 :::note @@ -309,9 +309,9 @@ End if Webユーザーセッションからログアウトアクションをトリガーすると、次のような効果があります: - - カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 - - 関連する 4Dライセンスが解放されます。 - - `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 +- カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 +- 関連する 4Dライセンスが解放されます。 +- `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 ## レンダリングのためのライセンス消費について @@ -363,7 +363,7 @@ Qodly Studio のユーザー設定で、レンダラーのポップオーバー 必要以上のライセンスを使用しないため、次のいずれかをお勧めします: - - 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 - - Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 - - プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 +- 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 +- Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 +- プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md index d2afc2319f0170..2b30a136bc6766 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md @@ -19,16 +19,16 @@ title: テンプレートページ 以下の 4Dタグを使用することができます: - - 4DTEXT: 4D変数および式をテキストとして挿入します。 - - 4DHTML: HTMLコードを挿入します。 - - 4DEVAL: 4D式を評価します。 - - 4DSCRIPT: 4Dメソッドを実行します。 - - 4DINCLUDE: ページを他のページに含めます。 - - 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 - - 4DCODE: 4Dコードを挿入します。 - - 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 - - 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 - - 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 +- 4DTEXT: 4D変数および式をテキストとして挿入します。 +- 4DHTML: HTMLコードを挿入します。 +- 4DEVAL: 4D式を評価します。 +- 4DSCRIPT: 4Dメソッドを実行します。 +- 4DINCLUDE: ページを他のページに含めます。 +- 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 +- 4DCODE: 4Dコードを挿入します。 +- 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 +- 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 +- 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 これらのタグについては、[変換タグ](../Tags/transformation-tags.md) のページで説明しています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md index 38e67795f1a74d..b619a12bbf322b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ title: 管理 4D Webサーバーは複数の方法で起動できます: - - ボタン/メニューコマンドの使用。 +- ボタン/メニューコマンドの使用。 - 4D: **実行 ＞ Webサーバー開始** メニュー
![](../assets/en/WebServer/start1.png) - 4D Server: HTTPサーバーページの **HTTPサーバー開始** ボタン
![](../assets/en/WebServer/start2.png) - - 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) +- 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) - - [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 +- [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して [`webServer.start()`](API/WebServerClass.md#start) 関数を呼び出すことで開始できます。 @@ -29,9 +29,9 @@ title: 管理 4D Webサーバーは複数の方法で停止できます: - - 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 +- 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 - - [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 +- [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して `webServer.stop()` 関数を呼び出すことで停止できます。 @@ -53,8 +53,8 @@ title: 管理 これをおこなうには: - - 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 - - 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 +- 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 +- 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 キャッシュは即座にクリアされます。 @@ -64,11 +64,11 @@ title: 管理 Webサーバーに関連する情報は、ランタイムエクスプローラーにある **ウォッチ** ページ (**Web** 項目内) に表示されます。 - - **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 +- **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 - - **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 - - **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 ## 管理用 URL @@ -123,8 +123,8 @@ Webサイト管理用の URL を使用して、サーバー上に公開してい 4Dでは、Webリクエストのログを2種類作成することができます: - - Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 - - おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 +- Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 +- おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 両方のログファイルは、アプリケーションプロジェクトの **Logs** フォルダーに自動的に作成されます。 @@ -223,15 +223,15 @@ logweb.txt の自動バックアップパラメーターは、ストラクチャ 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md index 73c47d2bdee187..57e4daafbdb3bb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ CORSサービスで許可されたホストとメソッドの一覧。 CORS を介したサーバーへのデータリクエスト送信が許可されている外部ページのドメイン名または IPアドレス。 複数のドメインを追加してホワイトリストを作成することができます。 複数のシンタックスがサポートされています: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### 許可された HTTPメソッド (methodsプロパティ) 対応する CORSホストに対して許可する HTTPメソッド。 以下の HTTPメソッドがサポートされます: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH メソッド名はセミコロン区切りで指定します(例: "post;get")。 methods が空、null、あるいは undefined の場合、すべてのメソッドが許可されます。 @@ -145,9 +145,9 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" デフォルトホームページを変更するには、パスを "デフォルトホームページ" エリアに入力します。 - - パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 +- パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 たとえば、デフォルトHTMLルートフォルダー内の "Web" サブフォルダーにある "MyHome.htm" をデフォルトホームページにする場合、"Web/MyHome.htm" と入力します。 @@ -318,15 +318,15 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。 デフォル #### IPv6 のサポートについて - - **TCPポートが使用済みでも警告は出ません**
+- **TCPポートが使用済みでも警告は出ません**
サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。 しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - - **IPv4-マップされた IPv6アドレス**
+- **IPv4-マップされた IPv6アドレス**
プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。 これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 - - **ポート番号の表記**
+- **ポート番号の表記**
IPv6 記法はコロン (:) を使用するので、ポート番号を追加するときには混乱を招く恐れがあることに注意が必要です。たとえば: ```code4d @@ -422,10 +422,10 @@ Webサーバーに処理を許可する HTTPリクエスト (POST) の最大サ とりうる値: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (デフォルト) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (デフォルト) +- 4 = TLSv1_3 変更した場合、設定を反映するには Webサーバーを再起動する必要があります。 @@ -492,10 +492,10 @@ User-Agent: Disallow: /GIFS/ ``` - - "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 - - "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 +- "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 +- "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 他の例題: @@ -520,15 +520,15 @@ User-Agent: デフォルトで、4D は **WebFolder** という名前のデフォルトHTMLルートフォルダーを定義します。 Webサーバーの初回起動時にこのフォルダーが存在しなければ、HTMLルートフォルダーは物理的にディスク上に作成されます。 ルートフォルダーは以下の場所に作成されます: - - 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 - - 4Dリモートモードでは、ローカルのリソースフォルダー内 +- 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 +- 4Dリモートモードでは、ローカルのリソースフォルダー内 デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 - - このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 - - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 +- パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 @@ -583,9 +583,9 @@ User-Agent: 次の値が提供されています: - - "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 - - "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 - - "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 +- "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 +- "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 +- "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 セッションcookie の `Secure` 属性値は、HTTPS接続の場合には (`SameSite` 属性値が何であれ)、自動的に "True" に設定されます。 @@ -625,8 +625,8 @@ User-Agent: Keep-Alive接続を設定する 2つのオプションがあります: - - **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 接続あたりのリクエスト数を制限することで、サーバーのリクエスト過多を避けることができます (攻撃者が使用するテクニック)。

4D Webサーバーをホストするマシンのリソースに応じて、デフォルト値 (100) を増減できます。

+- **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 接続あたりのリクエスト数を制限することで、サーバーのリクエスト過多を避けることができます (攻撃者が使用するテクニック)。

4D Webサーバーをホストするマシンのリソースに応じて、デフォルト値 (100) を増減できます。

- - **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 この秒数が経過すると、サーバーは接続を閉じます。

+- **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 この秒数が経過すると、サーバーは接続を閉じます。

接続が閉じられた後に Webブラウザーがリクエストを送信すると、新しい TCP接続が作成されます。 この動作はユーザーからは見えません。

diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md index 7547efe4bdb500..d2d2e6060b87d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md @@ -7,9 +7,9 @@ title: Webサーバーオブジェクト たとえば、メインアプリケーションに 2つのコンポーネントをインストールしている場合、アプリケーションから最大 3つの独立した Webサーバーを起動して監視することができます: - - ホストアプリケーションの Webサーバーを1つ - - コンポーネント#1 の Webサーバーを1つ - - コンポーネント#2 の Webサーバーを1つ +- ホストアプリケーションの Webサーバーを1つ +- コンポーネント#1 の Webサーバーを1つ +- コンポーネント#2 の Webサーバーを1つ 1つの 4Dアプリケーションプロジェクトに接続できるコンポーネントの数、つまり Webサーバーの数には、メモリ以外の制限はありません。 @@ -19,9 +19,9 @@ title: Webサーバーオブジェクト 各 Webサーバー (ホストアプリケーションまたはコンポーネント) は、個別のコンテキストで使用できます。これには、以下が含まれます: - - `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し - - 4Dタグの処理とメソッドの呼び出し - - Webセッションや TLSプロトコルの管理 +- `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し +- 4Dタグの処理とメソッドの呼び出し +- Webセッションや TLSプロトコルの管理 これにより、独自の Webインターフェースを備えた独立したコンポーネントや機能を開発することができます。 @@ -49,8 +49,8 @@ webServer:=WEB Server(Web server database) アプリケーションがコンポーネントを使用している場合に: - - コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や - - リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 +- コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や +- リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 次を使うこともできます: @@ -97,8 +97,8 @@ A web server object contains [various properties](API/WebServerClass.md../comman 2. 上を使用しない場合は、`WEB SET OPTION` コマンドを使用して定義します (ホストアプリケーションのみ)。 3. 上を使用しない場合は、ホストアプリケーションまたはコンポーネントの設定で定義します。 - - Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 - - Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 +- Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 +- Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 > *isRunning*、*name*、*openSSLVersion*、*perfectForwardSecrecy* は読み取り専用のプロパティで、[`start()`](API/WebServerClass.md#start)関数の `settings` オブジェクトパラメーターで事前に定義することはできません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md index 75a443b6172d1b..9de16429321acb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) +- 4D Write Pro ドキュメント *breakType* 引数には、*4D Write Pro 定数* テーマから以下の定数のどれか一つを渡し、挿入するブレークのタイプを定義します: @@ -47,7 +47,7 @@ displayed_sidebar: docs | wk prepend | Integer | 1 | コンテンツをターゲットの始めに挿入する | | wk replace | Integer | 0 | ターゲットのコンテンツを置き換える | - - *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: +- *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: | 定数 | 型 | 値 | 説明 | | --------------------- | ------- | - | ------------------------------------------------- | @@ -56,7 +56,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md index 7d89b03a109738..f0e5c9d984ab9e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) +- 4D Write Pro ドキュメント 挿入する*wpDoc* 引数のドキュメントには、 [WP New](../commands-legacy/wp-new.md) コマンドまたは [WP Import document](wp-import-document.md) コマンドを使用して作成した任意の4D Write Pro ドキュメントオブジェクトを指定可能です。 本文の子要素のみが挿入されます(つまり、ヘッダー、フッター、テキストボックスおよびアンカーされたピクチャーは挿入されません)。 指定されたレンジのセクションおよびブックマークは保存されます。 これに加え、要素はコピーされるので、*wpDoc* 引数の内容はその後再利用することが可能です。 @@ -54,7 +54,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/writeprointerface.md b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/writeprointerface.md index 85580bde44bd29..f6ecccc168c52c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/writeprointerface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/writeprointerface.md @@ -11,8 +11,8 @@ title: 4D WritePro インターフェース You will find below: - - the Table Wizard configuration documentation, - - the integrated A.I. ドキュメント. +- the Table Wizard configuration documentation, +- the integrated A.I. ドキュメント. ## 表ウィザード @@ -60,9 +60,9 @@ You will find below: テンプレートの設定には以下が含まれます: - - [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 - - [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 - - [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 +- [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 +- [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 +- [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 表ウィザードを設定するにあたって、これら 3種類のファイルにはそれぞれ明確な役割がありますが、いずれも必須ではありません。 @@ -70,10 +70,10 @@ You will find below: テンプレートファイルを使って、以下のことが定義できます: - - 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ - - ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) - - 表の列として使用できるデータクラス属性 - - ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ +- 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ +- ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) +- 表の列として使用できるデータクラス属性 +- ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ テンプレートファイルはプロジェクトの "[`Resources`](../Project/architecture.md#resources)/4DWP_Wizard/Templates" フォルダーに保存する必要があります。 @@ -318,11 +318,11 @@ The 4D Write Pro interface uses OpenAI, for which you need to provide your own k In the current implementation, the feature has the following limitations: - - use of a predefined AI provider and necessity to pass your OpenAI key - - basic chatting features - - no image handling - - non-configurable predefined action commands - - predefined translations English/French and French/English only +- use of a predefined AI provider and necessity to pass your OpenAI key +- basic chatting features +- no image handling +- non-configurable predefined action commands +- predefined translations English/French and French/English only ### Enabling the AI feature @@ -349,8 +349,8 @@ The **A.I.** button is then displayed: ![ai button](../assets/en/WritePro/ai-button.png) - - in the 4D Write Pro Toolbar, in the **Import Export** tab, - - in the 4D Write Pro Widget, in the **Font Style** tab. +- in the 4D Write Pro Toolbar, in the **Import Export** tab, +- in the 4D Write Pro Widget, in the **Font Style** tab. Click on the button to display the AI dialog box. @@ -388,8 +388,8 @@ These buttons propose basic interactions between the chat area, the underlying 4 ![ai interaction](../assets/en/WritePro/ai-interaction.png) - - **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. - - **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. +- **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. +- **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. In both cases, if the response was provided with styles, you can decide to copy the text with or without styles. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md index 890650dff4ae31..f21fd7a85be26c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md @@ -5,7 +5,7 @@ title: OpenAIEmbeddingsAPI # OpenAIEmbeddingsAPI -The `OpenAIEmbeddingsAPI` provides functionalities to create embeddings using OpenAI's API. +`OpenAIEmbeddingsAPI` はOpenAI のAPI を使用して埋め込みを作成する機能を提供します。 https://platform.openai.com/docs/api-reference/embeddings @@ -15,38 +15,38 @@ https://platform.openai.com/docs/api-reference/embeddings **create**(*input* : Text; *model*: Text; *parameters* : OpenAIEmbeddingsParameters) : OpenAIEmbeddingsResult -Creates an embeddings for the provided input, model and parameters. +提供された入力、モデル、パラメータに対する埋め込みを作成します。 -| 引数 | 型 | 説明 | -| ------------ | ----------------------------------------------------------- | --------------------------------------------------------------------------------------- | -| *input* | Text or Collection of Text | The input to vectorize. | -| *model* | Text | The [model to use](https://platform.openai.com/docs/guides/embeddings#embedding-models) | -| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | The parameters to customize the embeddings request. | -| 戻り値 | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | The embeddings. | +| 引数 | 型 | 説明 | +| ------------ | ----------------------------------------------------------- | --------------------------------------------------------------------- | +| *input* | テキストまたはテキストのコレクション | ベクター化する入力。 | +| *model* | Text | [使用するモデル](https://platform.openai.com/docs/guides/embeddings#埋め込みモデル) | +| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | 埋め込みリクエストをカスタマイズするための引数。 | +| 戻り値 | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | 埋め込み。 | -#### Example Usages +#### 使用例 -##### Get vector for a single text entry +##### 単一のテキスト入力に対するベクトルを取得 ```4d var $result:=$client.embeddings.create("it rains cats and dogs"; "text-embedding-ada-002") var $vector: 4D.Vector:=$result.vector -// or var $embedding: cs.AIKit.OpenAIEmbedding:=$result.embedding +// あるいは var $embedding: cs.AIKit.OpenAIEmbedding:=$result.embedding ``` -##### Get vectors for a collection of text entries +##### テキスト入力のコレクションに対するベクトルを取得 ```4d var $inputs:=["it rains cats and dogs"; "il pleut à boire debout"] var $result:=$client.embeddings.create($inputs; "text-embedding-ada-002") -var $vectors : Collection:=$result.vectors // collection of 4D.Vector +var $vectors : Collection:=$result.vectors // 4D.Vector のコレクション ``` -##### Using another service +##### 他のサービスを使用する -> Before using embeddings with a specific service, please check its documentation to see if embeddings are supported, and select the appropriate embedding model. +> 埋め込みを特定のサービスで使用する前に、そのドキュメンテーションをチェックして埋め込みがサポートされているかを確認し、適切な埋め込みモデルを選択するようにしてください。 -For example, for Mistral, use [mistral-embed or codestral-embed](https://docs.mistral.ai/capabilities/embeddings/) +例えば、Mistral に対しては、[mistral-埋め込みあるいはcodestral-埋め込み](https://docs.mistral.ai/capabilities/embeddings/) を使用してください ```4d var $result:=$client.embeddings.create($inputs; "mistral-embed") diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsParameters.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsParameters.md index 6c97341a628207..20b34c02ab6664 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsParameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsParameters.md @@ -5,7 +5,7 @@ title: OpenAIEmbeddingsParameters # OpenAIEmbeddingsParameters -The `OpenAIEmbeddingsParameters` class is designed to configure and manage the parameters used for creating embeddings through the OpenAI API. +`OpenAIEmbeddingsParameters` クラスは、OpenAI API を通して埋め込みを作成するのに使用する引数を設定して管理するために設計されています。 ## 継承元 @@ -13,10 +13,10 @@ The `OpenAIEmbeddingsParameters` class is designed to configure and manage the p ## プロパティ -| プロパティ名 | 型 | 説明 | -| ----------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `encoding_format` | Text | The format to return the embeddings in. Can be either `float` or `base64`. (default: `float`) | -| `dimensions` | Integer | The number of dimensions the resulting output embeddings should have. Only supported in text-embedding-3 and later models. | +| プロパティ名 | 型 | 説明 | +| ----------------- | ------- | ------------------------------------------------------------------------------------------------------ | +| `encoding_format` | Text | 埋め込みを返すフォーマット。 `float` あるいは `base64` のいずれかを指定できます。 (デフォルト: `float`) | +| `dimensions` | Integer | 出力結果の埋め込みが持つべき次元の数。 text-embedding-3 あるいはそれ以降のモデルでのみサポートされています。 | ## 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsResult.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsResult.md index 2d112d248a64a4..7b8589326bcd8e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsResult.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsResult.md @@ -13,7 +13,7 @@ title: OpenAIEmbeddingsResult | プロパティ | 型 | 説明 | | ------------ | ------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| `model` | Text | Returns the model used to compute the embedding | +| `model` | Text | 埋め込みを計算するのに使用されたモデルを返します | | `vector` | `4D.Vector` | Returns the first `4D.Vector` from the `vectors` collection. | | `vectors` | Collection | Returns a collection of `4D.Vector`. | | `embedding` | [OpenAIEmbedding](OpenAIEmbedding.md) | Returns the first [OpenAIEmbedding](OpenAIEmbedding.md) from the `embeddings` collection. | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Project/tab-component.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Project/tab-component.png index f1f37d41590038..87f2377dd62822 100644 Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Project/tab-component.png and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Project/tab-component.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/command-index.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/command-index.md index 15324f245bfde9..fefe8da5c05e25 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/command-index.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/command-index.md @@ -350,7 +350,7 @@ title: インデックス [`Generate digest`](../commands-legacy/generate-digest.md)
[`GENERATE ENCRYPTION KEYPAIR`](../commands-legacy/generate-encryption-keypair.md)
[`Generate password hash`](../commands-legacy/generate-password-hash.md)
-[`Generate UUID`](../commands-legacy/generate-uuid.md)
+[`Generate UUID`](generate-uuid.md) **modified 4D 20 R10**
[`Get 4D file`](../commands-legacy/get-4d-file.md)
[`Get 4D folder`](../commands-legacy/get-4d-folder.md)
[`Get adjusted blobs cache priority`](../commands-legacy/get-adjusted-blobs-cache-priority.md)
diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/form-event.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/form-event.md index 9991b3a1b720af..097eda5af0b378 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/form-event.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/form-event.md @@ -37,8 +37,8 @@ displayed_sidebar: docs イベントオブジェクトには、イベントが発生したオブジェクト によっては追加のプロパティが含まれていることがあります。 これは以下のオブジェクトで生成された *eventObj* オブジェクトが対象です: - - リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 - - 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 +- リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 +- 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 ***注意:*** カレントのイベントが何もない場合、**FORM Event** はnull オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/form.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/form.md index 38323dd54959e2..c948a4be91f314 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/form.md @@ -26,30 +26,30 @@ displayed_sidebar: docs The **Form** command returns the object associated with the current form (instantiated from the *formData* parameter or the user class assigned in the Form editor).**Form** コマンドはカレントフォームに割り当てられている( *formData* 引数、またはフォームエディターで割り当てられたユーザークラスによってインスタンス化された) オブジェクトを返します。 4D は以下の場合にはカレントフォームに自動的にオブジェクトを割り当てます: - - カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 - - カレントフォームがサブフォームである場合。 - - テーブルフォームが現在画面上に表示されている場合。 +- カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 +- カレントフォームがサブフォームである場合。 +- テーブルフォームが現在画面上に表示されている場合。 ### コマンド(DIALOGなど) カレントのフォームが[DIALOG](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドによって表示あるいはロードされていた場合、は以下のいずれかのものを返します: - - コマンドに引数として渡された*formData* オブジェクト(あれば)。 - - [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 - - または、空のオブジェクト。 +- コマンドに引数として渡された*formData* オブジェクト(あれば)。 +- [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 +- または、空のオブジェクト。 ### サブフォーム カレントフォームがサブフォームの場合、返されるオブジェクトは親コンテナ変数に依存します: - - 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ +- 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ この場合、**Form** から返されるオブジェクトは、以下の式から返されるものと同じになります : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 +- 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 より詳細な情報については、*サブフォームページ* の章を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/generate-uuid.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/generate-uuid.md new file mode 100644 index 00000000000000..0ee9b18e71c2e0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| 引数 | 型 | | 説明 | +| ------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| 戻り値 | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
履歴 + +| リリース | 内容 | +| ------ | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## 説明 + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form。 + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## 例題 + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## プロパティ + +| | | +| ------- | --------------------------- | +| コマンド番号 | 1066 | +| スレッドセーフ | ✓ | + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md index 9986b0a7644cfc..99d4d0ca7a8ace 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md @@ -39,14 +39,14 @@ displayed_sidebar: docs 以下のサポートされる型であれば、いくつでも値を渡すことができます: - - 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 - - text - - ブール - - 日付 - - 時間 (ミリ秒の数 (実数) として保存されます)。 - - null - - 共有オブジェクト - - 共有コレクション +- 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 +- text +- ブール +- 日付 +- 時間 (ミリ秒の数 (実数) として保存されます)。 +- null +- 共有オブジェクト +- 共有コレクション :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/print-form.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/print-form.md index bfdc231296e94e..62887e306c2f26 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/print-form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs *form* 引数には、以下のいづれかを渡すことができます: - - フォーム名 - - 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) - - フォームの詳細を格納しているオブジェクト +- フォーム名 +- 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) +- フォームの詳細を格納しているオブジェクト **Print form** は、 フォームの印刷後に改ページを行わないため、同じページに異なるフォームを容易に配置することができます。 したがって、**Print form** は、異なるテーブルや異なるフォームを含む複雑な印刷処理に最適です。 フォーム間で改ページを強制的に行うには[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用してください。 印刷可能領域を超える高さのフォームの印刷を次のページに持ち越すには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用する前に[CANCEL](../commands-legacy/cancel.md) コマンドを呼び出してください。 3つの異なるシンタックスを使用できます: - - **詳細エリアの印刷** +- **詳細エリアの印刷** シンタックス: @@ -43,7 +43,7 @@ displayed_sidebar: docs この場合、**Print form** はフォームの詳細エリア (ヘッダマーカと詳細マーカの間のエリア) だけを印刷します。 - - **フォームエリアの印刷** +- **フォームエリアの印刷** シンタックス: @@ -79,7 +79,7 @@ displayed_sidebar: docs | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **セクション印刷** +- **セクション印刷** シンタックス: @@ -101,8 +101,8 @@ form data オブジェクトについての詳細な情報については、[`DI **Print form** を使用する場合、印刷ダイアログボックス は表示されません。 レポート はデザインモードでフォームに割り当てられた用紙設定を使用しません。 **Print form** を呼び出す前に用紙設定を指定する方法は2通りあります: - - [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 - - [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 +- [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 +- [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 **Print form** は、印刷するページをそれぞれメモリ 中に作成します。 各ページはメモリ中のページがいっぱいになるか、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを実行すると印刷されます。 **Print form** の使用後、最後のページの印刷を確実に行うためには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドで終了しなければなりません(ただし [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md) のコンテキスト内の場合を除く、注意参照)。 そうでないと、最後のページが一杯にならないと、それはメモリ中に残り印刷されません。 @@ -116,8 +116,8 @@ form data オブジェクトについての詳細な情報については、[`DI **4D Server:** このコマンドは、ストアドプロシージャのフレームワークにおいて4D Server 上で実行することができます。 この状況では、次の制約があります: - - サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 - - プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 +- サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 +- プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/process-info.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/process-info.md index a9bafc2eb7a12a..6ba3012ac1915d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/process-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/process-info.md @@ -44,7 +44,7 @@ displayed_sidebar: docs | type | Integer | 実行中のプロセスタイプ。 取り得る値: 以下を参照のこと 取り得る値: 以下を参照のこと | | visible | Boolean | 表示であればTrue、それ以外はFalse | - - "state" の取り得る値: +- "state" の取り得る値: | 定数 | 値 | | ------------------------- | ---- | @@ -57,7 +57,7 @@ displayed_sidebar: docs | Waiting for internal flag | 4 | | Paused | 5 | - - "type" の取り得る値: +- "type" の取り得る値: | 定数 | 値 | | ----------------------------- | --- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/session.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/session.md index 1f014a7e3bac76..3a0c9b3473fb57 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/session.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### 参照 +## 参照 [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/string.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/string.md index da258462967ecb..f7b19774f41a34 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/string.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/string.md @@ -31,7 +31,7 @@ displayed_sidebar: docs **String** コマンドは、*expression* に渡した数値、日付、時間、文字列、またはブールを文字列に変換します。 -引数を何も渡さなかった場合、適切なデフォルトの形式の文字列で返されます。 *format* を指定すると、結果の文字列は指定した形式になります。 +If you do not pass any other parameter, the string is returned with the appropriate default format. *format* を指定すると、結果の文字列は指定した形式になります。 オプションの*addTime* 引数は、日付に時間を複合フォーマットで追加します。 この引数は *expression* 引数が日付型の時にのみ使用できます (後述)。 @@ -90,7 +90,7 @@ displayed_sidebar: docs :::info - このシンタックスは[基数の取扱に関する`toString` EcmaScript 仕様](https://tc39.es/ecma262/multipage/numbers-and-dates.html#sec-number.prototype.tostring) に厳密に従います。 -- *base*=10 のシンタックスを使用した場合、 *base* 引数を使用しなかったシンタックスと全く同じ結果は返しません。 例えば、指定された数値が数字でなかった場合、 "Nan" の文字列が返されます。 +- *base*=10 のシンタックスを使用した場合、 *base* 引数を使用しなかったシンタックスと全く同じ結果は返しません。 For example, if the specified number value is not a number, the "NaN" string is returned. ::: @@ -257,11 +257,11 @@ displayed_sidebar: docs ## 参照 -[Bool](bool.md)\ -[Date](date.md)\ +[Bool](../commands-legacy/bool.md)\ +[Date](../commands-legacy/date.md)\ [Num](num.md)\ -[Time string](time-string.md)\ -[Timestamp](timestamp.md) +[Time string](../commands-legacy/time-string.md)\ +[Timestamp](../commands-legacy/timestamp.md) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands/theme/Tools.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands/theme/Tools.md index a62147d8ec3ed3..61188207ee5d30 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands/theme/Tools.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands/theme/Tools.md @@ -12,7 +12,7 @@ slug: /commands/theme/Tools | [](../../commands-legacy/choose.md)
| | [](../../commands-legacy/generate-digest.md)
| | [](../../commands-legacy/generate-password-hash.md)
| -| [](../../commands-legacy/generate-uuid.md)
| +| [](../generate-uuid.md)
| | [](../../commands-legacy/get-macro-parameter.md)
| | [](../../commands-legacy/launch-external-process.md)
| | [](../../commands-legacy/load-4d-view-document.md)
| diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/client-server.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/client-server.md index 9e655afbe3bf37..2685d066293b71 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/client-server.md @@ -13,8 +13,8 @@ title: クライアント-サーバーページ このオプションを使用して、起動された 4D Server データベースが公開データベースのリストに表示されるかどうかを指定できます。 - - このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 - - このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 +- このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 +- このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 :::note @@ -49,10 +49,10 @@ TCPプロトコルを使用して、1台のマシン上で複数の 4Dアプリ 4D Server は 3つの TCPポートを使用して、内部サーバーとクライアントの通信をおこないます: - - **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 - - **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 - - **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 - - [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 +- **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 +- **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 +- **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 +- [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 #### ドメインサーバーによるユーザーの認証 @@ -66,9 +66,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 ここでは、ドロップダウンメニューにて 3つのネットワークオプションから選択できます: **Legacy**、**ServerNet** 、**QUIC** (プロジェクトモードのみ)。ネットワークレイヤーは、4D Server とリモートの 4Dマシン (クライアント) 間の通信を管理するのに使用されます。 - - **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. - - **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 - - **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 +- **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. +- **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 +- **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 **注**: @@ -108,9 +108,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 この設定は、データベースの **Resources** フォルダーがセッション中に更新された場合について、接続中のクライアントマシンにおける同フォルダーのローカルインスタンスの更新モードを包括的に指定します (**Resources** フォルダーは、セッションが開かれるたびにリモートマシン上で自動的に同期されます)。 3つの選択肢があります: - - **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 - - **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. +- **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 +- **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. ## IP設定ページ @@ -122,10 +122,10 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 設定表の動作は以下のとおりです: - - "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 - - "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 - - ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 - - セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: +- "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 +- "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 +- ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 +- セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: - 拒否 192.168.\* (192.168 で始まるアドレスを拒否) - 許可 \* (他のアドレスはすべて許可) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md index d30b7b374f9051..615332b6bd44c8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -8,10 +8,10 @@ title: 互換性ページ > 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。\ > このページでは、v18以降のバージョンから変換された 4Dデータベース/プロジェクトで利用可能な互換性オプションのみを説明します。 それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 - - **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 +- **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 **注:** このオプションは、`SET DATABASE PARAMETER` コマンドを使い、プログラミングによって管理することもできます。 - - **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: +- **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: - 最初の "/" はルートノードに限らない - "/" を XPath 式の最初の文字として使用しても、ルートノードからの絶対パスの宣言にはなりません。 - 暗示的なカレントノードはなし - カレントノードは XPath 式の中に含められていなければなりません。 @@ -19,12 +19,12 @@ title: 互換性ページ 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 +- **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 - - **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 +- **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 - - **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file +- **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/database.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/database.md index 6fdcedfc30f7ea..f046935095106c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/database.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/database.md @@ -17,10 +17,24 @@ title: データベースページ このオプションを選択しないかぎり、ロックされたデータファイルを開くことはできません (4Dデータベースのデフォルト動作)。 -#### ロックされたファイルについて +:::info ロックされたファイルについて ロックされたファイルは読むことはできても内容を変更することはできません。 たとえば (DVDのような) 編集不可のメディアに格納されたファイルや、このようなメディアからコピーされたファイルは、ロックされていることがあります。 DVDに格納されたプロジェクトを使用するような場合、ロックされたデータファイルを使用できるようアプリケーションを設定することができます。 しかしこの場合、データの追加・編集が保存されないロックされているデータファイルを不注意に使用してしまうリスクがあります。 このような状況にならないよう、4D ではデフォルトでロックされたデータファイルを開くことを禁止しています。 +::: + +#### Auto UUID version + +[UUID version](https://en.wikipedia.org/wiki/Universally_unique_identifier) to use for 4D fields with [automatic UUID generation option](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106195). Available values are **4** (default) and **7**. + +This setting only applies to UUIDs generated afterwards. Already saved auto UUIDs fields are not recomputed. + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + ### テンポラリフォルダーの場所 このエリアでは、4D 実行中に作成されるテンポラリーファイルの場所を設定できます。 テンポラリファイルのフォルダーは、一時的にメモリ中のデータをディスクに保存するために必要に応じてアプリケーションが使用します。 @@ -31,9 +45,9 @@ title: データベースページ 3つのオプションから選択できます: - - **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 - - **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 - - **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 +- **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 +- **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 +- **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +55,7 @@ title: データベースページ > これらのオプションのいずれかを変更した場合、新しい設定を反映するにはアプリケーションを終了し、再起動しなければなりません。 データベースが再び開かれると、すべてのインデックスが自動で再作成されます。 - - **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 +- **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). このオプションが選択されている場合、単語内にある "@" は普通の文字として扱われます。 この設定は、"@" が文字列内で使用される電子メールアドレスの検索などに有効です。 このオプションは検索、並び替え、文字列比較、およびテーブルに格納されるデータや配列などメモリ中のデータに影響を与えます。 (インデックス付きか否かにかかわらず) 文字型やテキスト型のフィールドおよび変数が、検索や並び替え時に "@" 文字がどのように解釈されるかの影響を受けます。 @@ -52,19 +66,19 @@ title: データベースページ - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - セキュリティの理由で、データベースの Administrator または Designer のみがこのパラメーターを変更できます。 - - **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 +- **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 つまり、4Dプロジェクトはシステム言語とは異なる言語で動作することができます。 プロジェクトが開かれるとき、4Dエンジンはデータファイルに使用されている言語を検知し、(インタープリターやコンパイルモードの) ランゲージに提供します。 データベースエンジン、あるいはランゲージのいずれがテキスト比較をおこなうかに関わらず、同じ言語が使用されます。 > 4D環境設定でも言語を設定できます ([一般ページ](../Preferences/general.md) 参照)。 この場合、その設定は新規に作成されるデータベースに適用されます。 - - **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 +- **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 このアルゴリズムは、文字列中をダブルクリックしたときに選択範囲を決定するためワープロソフトが使用するものと同じです。 このアルゴリズムに関する詳細は以下の Webページを参照ください: `http://userguide.icu-project.org/boundaryanalysis`。 このオプションが選択されている場合、4D は簡易的なアルゴリズムを使用します。 この設定では、文字でも数字でもない文字がキーワード区切り文字として扱われます。 この設定は日本語など特定の言語の要求に沿うものです。 - - **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 +- **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 #### MeCab のサポート (日本語版) @@ -82,7 +96,7 @@ title: データベースページ ### データベースキャッシュ設定 - - **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 +- **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 - **他のアプリケーションとシステムのために予約するメモリ**: システムや他のアプリケーションが使用するために取り置く RAMメモリ量。 4D が実行されるマシン上で他のアプリケーションも実行する場合、必要に応じてこの値を増やします。 - **利用可能なメモリからキャッシュに使用する率**: 残りのメモリからキャッシュに割り当てる量の率。\ デフォルトでキャッシュに割り当てるサイズを取得するためには、以下の計算式を適用します: (物理メモリ – 予約したメモリ) X キャッシュに使用するメモリのパーセンテージ。 動的に計算するモードの場合、キャッシュメモリのサイズはアプリケーションやシステムのニーズに応じて動的に変化します。 以下のオプションを使用して上限と下限を設定できます: @@ -93,11 +107,11 @@ title: データベースページ ![](../assets/en/settings/memory-maximum-size.png) - - **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 +- **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 入力されたキャッシュサイズは、マシンのリソース状況にかかわらず、4Dデータベース用に予約されます。 この設定は、メモリ搭載量が分かっているなど、特定の状況で使用できます。 ほとんどのケースで起動時計算モードのキャッシュで良いパフォーマンスが提供されます。 - - **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 +- **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 4D はキャッシュ中のデータを定期的に保存します。 この間隔を 1秒から 500分の範囲で設定できます。 デフォルトの設定値は 20秒です。 この保存は、キャッシュがいっぱいになった場合や、アプリケーションを終了する際にもおこなわれます。 You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. 大量のデータ入力が予期される場合は、この間隔を短くすることを検討してください。 停電などの理由でマシンが停止すると、前回の保存以降に入力されたデータが失われてしまいます (データログファイルをとっていれば復旧可能です)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md index f594bc8dd9dfce..541023abd9f72a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md @@ -23,9 +23,9 @@ title: インターフェースページ 他のオプションでは、アプリケーションモードでのさまざまなウィンドウの表示を設定します。 - - **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 +- **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 - - **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 +- **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 :::note @@ -33,9 +33,9 @@ title: インターフェースページ ::: - - **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 +- **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 - - **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: +- **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: ![](../assets/en/settings/sdi-mdi.png) @@ -53,16 +53,16 @@ title: インターフェースページ 以下のスキームが利用可能です: - - **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) - - **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) - - **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 +- **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) +- **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) +- **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 > デフォルトのテーマは CSS で管理可能です。 詳細については、[メディアクエリ](../FormEditor/createStylesheet.md#メディアクエリ) を参照してください。 メインアプリケーションスキームはデフォルトでフォームに適用されます。 その一方で、それを以下の方法で上書きすることもできます: - - by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; - - 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 +- by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; +- 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 ## ショートカット @@ -70,9 +70,9 @@ title: インターフェースページ デフォルトのショートカットは以下のとおりです: - - 入力フォーム確定: **Enter** - - 入力フォームキャンセル: **Esc** - - サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) +- 入力フォーム確定: **Enter** +- 入力フォームキャンセル: **Esc** +- サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) 操作のショートカットを変更するには、対応する **編集** ボタンをクリックします。 以下のダイアログボックスが表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md index 184f91d21ab268..1233c3e1338e45 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md @@ -11,7 +11,7 @@ title: セキュリティページ > これらの設定は、シングルユーザーモードで開かれたプロジェクトデータベースには適用されません。 - - **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 +- **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 注: @@ -19,21 +19,21 @@ title: セキュリティページ - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 +- **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 このオプションを使用することで、完全なデータコントロールシステムを維持しつつ、データベースへのアクセスをシンプルにすることができます。 - デフォルトユーザーにパスワードを割り当てた場合、データベースが開かれるときにダイアログが表示され、パスワードの入力を求められます。 - デフォルトユーザーにパスワードを割り当てない場合、上記のダイアログは表示されません。
**注:** "デフォルトユーザー" モードが有効になっているときでも、強制的にユーザー認証ダイアログを表示させることができます。これはたとえば Administrator や Designer としてログインするために必要となります。 これには、データベースを開いたり接続したりする際に **Shift**キーを押したままにします。 - - **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **ユーザーリストをABC順で表示する** (上記オプションが選択されているときのみ有効です): このオプションが選択されていると、ユーザー認証ダイアログボックスのユーザーリストは名前の ABC順に表示されます。 - - **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 +- **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 ## オプション - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. 以下のオプションを使用して、部分的あるいは全体的にこのフィルタリングを無効にできます。 - **すべてのユーザーを制限する** (デフォルトオプション): Designer と Administrator を含むすべてのユーザーに対し、コマンドや関数、プロジェクトメソッドへのアクセスを制限します。 - **DesignerとAdministratorは制限しない**: このオプションは Designer と Administrator のみに、4Dコマンドやメソッドへの完全なアクセスを与えます。 他のユーザーには制限をかけつつ、管理者に無制限のアクセスを与えたい場合に使用できます。 開発段階では、このモードを使用してすべてのフォーミュラやレポート等を自由にテストできます。 運用時には、一時的にコマンドやメソッドへのアクセスを与えるためなどに使用できます。 This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ title: セキュリティページ - **誰も制限しない**: このオプションはフォーミュラの制御を無効にします。 このオプションが選択されると、ユーザーはすべての 4Dコマンドおよびプラグインコマンド、さらにはプロジェクトメソッドを使用できます (非表示のものを除く)。 **Note:** This option takes priority over the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command. このオプションが選択されると、コマンドの効果はなくなります。 - - **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). +- **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 このオプションがチェックされていると: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/web.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/web.md index 53163f7db7251d..7790a478bd8e3a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/web.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/web.md @@ -78,9 +78,9 @@ Webページキャッシュを有効化します。 [キャッシュ](../WebServ このモードでは、以下の追加の Web サーバー設定を設定することができます: - - [最大同時Webプロセス](#最大同時webプロセス) - - [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) - - [Use preemptive processes](#use-preemptive-processes) +- [最大同時Webプロセス](#最大同時webプロセス) +- [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) +- [Use preemptive processes](#use-preemptive-processes) #### 旧式セッション (シングルプロセスセッション) @@ -162,9 +162,9 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 ログフォーマットメニューでは、次のオプションを提供します。 - - **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 +- **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 - - **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 +- **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 - host: クライアントの IPアドレス (例: 192.100.100.10) - rfc931: 4Dによって作成されない情報。 常に - (マイナス記号) です。 @@ -173,23 +173,23 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 > 日付と時間はサーバーのローカルタイム。 - - request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) - - state: サーバーの返答。 - - length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 +- request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) +- state: サーバーの返答。 +- length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 > **注:** パフォーマンス上の理由により、操作はメモリのバッファーに 1Kbのパケットで保存されてから、ディスクに書き込まれます。 5秒間リクエストが発生しなくても、操作はディスクに書き込まれます。 > state として取り得る値は以下の通り:
200: OK
204: No contents
302: Redirection
304: Not modified
400: Incorrect request
401: Authentication required
404: Not found
500: Internal error
CLFフォーマットはカスタマイズされません。 - - **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 +- **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 - Referer: リクエストされたドキュメントを指しているページの URL を含みます。 - User-agent: リクエストのオリジンにおけるクライアントのブラウザーまたはソフトウェアの名前とバージョンを含みます。 > DLFフォーマットはカスタマイズされません。 - - **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 +- **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 - - **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 +- **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 **フィールドの設定**
ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると、選択されたフォーマットに対して利用可能なフィールドが表示されます。 ログに含む各フィールドを選択する必要があります。 ログに含む各フィールドを選択する必要があります。 @@ -229,14 +229,14 @@ ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると リクエストログの自動バックアップ設定を指定します。 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 > スケジュールされたバックアップの場合で、バックアップが開始する予定となっているときに Webサーバーが起動していないと、次回の起動において 4D はバックアップが失敗したと見なし、データベース設定で示されている適切な設定を適用します。 @@ -250,9 +250,9 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは 4D を Webサービスサーバーとして使用する (つまり、Webサービスの形でプロジェクトメソッドを公開する) ための設定をおこないます。 - - **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 - - **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 - - **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 +- **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 +- **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 +- **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 > タグ名に関する XML標準に準拠するために、使用する文字には空白が含まれていてはなりません。また数字から始まっていてはなりません。 非互換性を避けるために、アクセント文字や日本語などの拡張文字は使用しないことを推奨します。 @@ -260,7 +260,7 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは Webサービスクライアントとして 4D を使用する (つまり、ネットワーク上に公開されているサービスにサブスクライブする) ための設定をおこないます。 - - **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 +- **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 ## Web機能 @@ -294,9 +294,9 @@ See [Users and sessions](../REST/authUsers.md) to know the recommended way to co このボタンは次のアップグレードシーケンスをトリガーします: - - **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 - - `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 - - プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 +- **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 +- `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 +- プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 このアップグレードをおこなった後は、プロジェクトを再起動することを忘れないでください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md index f17dade9988946..30be85fda23689 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md @@ -160,8 +160,8 @@ title: Class :::note 注記 - - すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 - - 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 +- すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 +- 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/Document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/Document.md index cb7edf57941cd8..1b71686ebb69e1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/Document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/Document.md @@ -320,8 +320,8 @@ title: Document クラス `.original` プロパティは、エイリアス、ショートカット、シンボリックリンクファイルのターゲット要素を返します。 ターゲット要素は以下のいずれかです: ターゲット要素は以下のいずれかです: - - File オブジェクト - - Folder オブジェクト +- File オブジェクト +- Folder オブジェクト エイリアスでないファイルについては、プロパティは同じファイルオブジェクトをファイルとして返します。 @@ -585,8 +585,8 @@ $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite) 任意で、コンテンツの読み取りに使用する文字セットを渡します。 これには、次の二つの方法があります: - - *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 - - *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 +- *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 +- *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 > 4D によってサポートされている文字セットの一覧については、`CONVERT FROM TEXT` コマンドを参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md index 1e1cbd8927b9c2..7ed93331603884 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage `.body` プロパティには送信されるメッセージ本文が格納されています。 `.body` プロパティでは以下のデータ型がサポートされます: - - text - - blob - - object - - image +- text +- blob +- object +- image `.body` プロパティは読み書き可能です。 @@ -108,17 +108,17 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage *body* 引数では以下のデータ型がサポートされています: - - Text - - BLOB - - Object - - ピクチャー +- Text +- BLOB +- Object +- ピクチャー この関数が使用された場合、content-type ヘッダーは*body* 引数の型に応じて自動的に設定されます: - - Content-Type: 本文がテキストの場合にはtext/plain - - Content-Type: 本文がBlob の場合にはapplication/octet-stream - - Content-Type: 本文がオブジェクトの場合にはapplication/json - - Content-Type: image/jpeg、image/gif... (本文が画像の場合) +- Content-Type: 本文がテキストの場合にはtext/plain +- Content-Type: 本文がBlob の場合にはapplication/octet-stream +- Content-Type: 本文がオブジェクトの場合にはapplication/json +- Content-Type: image/jpeg、image/gif... (本文が画像の場合) *body* がサポートされていない値の型だった場合、エラーが返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md index 6609af77779e06..7d998df44714c1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ SMTPステータスコードについての詳細は [こちらのページ](htt SMTP接続は、以下の場合に自動的に閉じられます: - - `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 - - `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 +- `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 +- `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md index a6ca6e513e7b29..e59f376e94bde5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Session オブジェクトは [`Session`](../commands/session.md) コマンドによって返されます。 このオブジェクトは、カレントユーザーセッションを管理するためのインターフェースをデベロッパーに対して提供し、コンテキストデータの保存、プロセス間の情報共有、セッションに関連したプリエンプティブプロセスの開始などのアクションの実行や、[アクセス権](../ORDA/privileges.md) の管理を可能にします。 +:::info To learn more + +Blog posts about this feature: + +- [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### セッションの種類 このクラスは以下の種類のセッションをサポートしています: @@ -308,6 +317,10 @@ Else End if ``` +#### 参照 + +[*Blog posts about this feature*](https://blog.4d.com/?s=hasPrivilege) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md index b0e89875e7e1f5..f7083647889e0a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md @@ -7,10 +7,10 @@ title: TCPEvent
履歴 -| リリース | 内容 | -| ----- | ---------------------- | -| 20 R9 | 新しい `ip` および `port` 属性 | -| 20 R8 | クラスを追加 | +| リリース | 内容 | +| ----- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | クラスを追加 |
@@ -20,12 +20,24 @@ title: TCPEvent 次のプロパティを利用することができます: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### 説明 + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ title: TCPEvent - - -## .ip - -**ip** : Text - -#### 説明 - -`.ip` プロパティには、リモートマシンのIP アドレスが格納されています。 - - - ## .port diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md index caf4ed6f86f534..2e865946757ebf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md @@ -19,34 +19,34 @@ title: UDPEvent 次のプロパティを利用することができます: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| - + -## .data +## .address -**data** : Blob +**address** : Text #### 説明 -`.data` プロパティには、イベントに関連づけられたデータ が格納されています。 これは"data" 型のイベントにおいてのみ有効です。 +The `.address` property contains the IP address of the remote machine. - + -## .ip +## .data -**ip** : Text +**data** : Blob #### 説明 -`.ip` プロパティにはリモートマシンの IP アドレス が格納されています。 +`.data` プロパティには、イベントに関連づけられたデータ が格納されています。 これは"data" 型のイベントにおいてのみ有効です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md index 4263a51c3caa38..5cab3d46d6789e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md @@ -56,8 +56,8 @@ Webフォームのコンポーネント (構成要素) とは、これらの Web この関数は、以下の場合には何もしません: - - Webフォーム上で *state* が現在有効ではない。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* が現在有効ではない。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を [有効化](#enablestate) または無効化した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 @@ -82,8 +82,8 @@ Webフォームの state に関する詳細については、[developer.qodly.co この関数は、以下の場合には何もしません: - - Webフォーム上で *state* がすでに有効である。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* がすでに有効である。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を有効化または [無効化](#disablestate)した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md index 9d18d3fe68048d..ac1a0c86299472 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md @@ -86,8 +86,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *url*には、WebSocketサーバーが応答する URL を渡します。 以下の URLパターンが使用できます: - - 標準接続用: `ws://host[:port]path[?query]` - - TLSセキュア接続用: `wss://host[:port]path[?query]` +- 標準接続用: `ws://host[:port]path[?query]` +- TLSセキュア接続用: `wss://host[:port]path[?query]` 接続できない場合、`null` オブジェクトが返され、エラーが生成されます (このエラーは `ON ERR CALL` で実装したメソッドによってインターセプトできます)。 @@ -95,8 +95,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *connectionHandler* には、接続イベントに応じて呼び出されるコールバック関数のほか、処理するデータ型やヘッダーを含むオブジェクトを渡すことができます。 - - コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 - - フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 +- コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 +- フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 | プロパティ | 型 | 説明 | | ----------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ This.headers.Cookie:="yummy_cookie=choco; tasty_cookie=strawberry" *code* には、接続を閉じる理由を説明するステータスコードを渡すことができます ([RFC6455 の WebSocket Connection Close Code](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5) も参照ください): - - 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 - - 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 +- 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 +- 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 *reason* には、接続を閉じる理由を説明するテキストを渡すことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md index 84edc11d112719..14752f7a1265e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ WebSocketプロトコルは、WebSocketサーバーとクライアント (Webブ 4D で WebSocketサーバーを作成し、扱うには、4Dビルトインクラスを 2つ使用する必要があります。 - - このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 - - [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 +- このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 +- [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 さらに、2つのユーザークラスを作成し、コールバック関数を定義する必要があります: - - サーバー接続を処理するためのユーザークラス - - メッセージを処理するためのユーザークラス +- サーバー接続を処理するためのユーザークラス +- メッセージを処理するためのユーザークラス 接続を維持するため、[WebSocketサーバーの作成](#4dwebsocketservernew) は [ワーカー](../Develop/processes.md#worker-プロセス) 内にて行う必要があります。 @@ -387,8 +387,8 @@ Function broadcast($ws : 4D.WebSocketConnection; $message:text) *timeout* 値が設定されている場合: - - 待機時間に達したら強制的にソケットを破棄します。 - - *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 +- 待機時間に達したら強制的にソケットを破棄します。 +- *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md index 657829ce598c98..81090d6fc2c115 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md @@ -17,7 +17,7 @@ WebAdmin 内部コンポーネントは、"WebAdmin" 権限を持つユーザー `WebAdmin` Webサーバーは、4D または 4D Server アプリケーションの起動時 (プロジェクトの読み込み前) に開始するように設定できます。 - - インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 +- インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Web管理設定ダイアログボックスで、**WebAdmin サーバーをスタ ![alt-text](../assets/en/Admin/waSettings.png) - - ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: +- ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Web管理の設定ダイアログボックスを開くには、**ファイル **注:** - - ローカルホスト以外による HTTP接続は受け付けません。 - - このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 +- ローカルホスト以外による HTTP接続は受け付けません。 +- このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 #### HTTP ポート @@ -94,11 +94,11 @@ TLS証明書ファイルが置かれているフォルダーのパスです。 HTTPリクエストログファイル (アプリケーションの "Logs" フォルダーに格納されている HTTPDebugLog_*nn*.txt (nn はファイル番号)) の状態やフォーマットを指定します。 次のオプションから選択することができます: - - **無効化** (デフォルト) - - **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 - - **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) - - **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 - - **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 +- **無効化** (デフォルト) +- **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 +- **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) +- **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 +- **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 #### アクセスキー @@ -108,9 +108,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ アクセスキーはパスワードに似ていますが、ログインとは関係ありません。 - - 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 - - アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 - - 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 +- 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 +- アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 +- 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 #### Qodly Studio へのアクセスを有効化する @@ -145,9 +145,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ ## 認証とセッション - - 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 +- 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 - - 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 +- 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 アクセスが許可されると、4Dアプリケーション上に "WebAdmin" 権限を持つ Web[セッション](WebServer/sessions.md) が作成されます。 カレントセッションが "WebAdmin" 権限を持っている限り、`WebAdmin` コンポーネントは要求されたページを提供します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md index 6986d96dadd991..3ab479d1071d65 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md @@ -5,12 +5,12 @@ title: 復元 問題が発生したときは、一連のアプリケーションファイル全体を復元することができます。 主に 2つのカテゴリの問題が発生する可能性があります: - - アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: +- アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: - キャッシュが空の場合、アプリケーションを問題なく開くことができます。 アプリケーションに対しておこなわれた変更はデータファイルに記録されています。 この場合には、特別な手順は必要ありません。 - キャッシュに未保存の処理が含まれている場合、データファイルは損傷していませんが、カレントのログファイルを統合する必要があります。 - キャッシュの内容をデータファイルに書き込み中だった場合、データファイルはおそらく損傷しています。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 - - アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 +- アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 > 問題発生後に、自動で 4Dのアプリケーション復旧処理を起動することができます。 このメカニズムは、ストラクチャー設定の **バックアップ/バックアップ＆復旧** ページで利用できるオプションを使用して管理します。 詳細は [自動復元](settings.md#自動復元とログの統合) を参照してください。\ > 問題が、データに対しておこなわれた不適切な処理の結果引き起こされた場合 (たとえば誤ってレコードを削除した等)、ログファイルの "ロールバック" 機能を使用してデータファイルを復旧できます。 この機能は MSC の [ロールバック](MSC/rollback.md) ページから利用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md index c28b98d4c1ef79..0b5e516ddd4702 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md @@ -5,9 +5,9 @@ title: バックアップ設定 バックアップ設定の定義は、[ストラクチャー設定ダイアログボックス](../settings/overview.md) 内で 3ページにわたっています。 次の設定がおこなえます: - - 自動バックアップ用のスケジューラー設定 - - 各バックアップに含めるファイル - - 自動タスクの実行を可能にする高度な設定 +- 自動バックアップ用のスケジューラー設定 +- 各バックアップに含めるファイル +- 自動タスクの実行を可能にする高度な設定 > このダイアログボックスで定義された設定は *Backup.4DSettings* ファイルに書き込まれ、[Settings フォルダー](Project/architecture.md#settings-ユーザー) に保存されます。 @@ -23,12 +23,12 @@ title: バックアップ設定 このページにあるオプションを使用して、アプリケーションの自動バックアップのスケジュールを設定できます。 標準のクイック設定、または完全なカスタマイズを選択できます。 **自動バックアップ** メニューでの選択に基づき、さまざまなオプションが表示されます: - - **しない**: スケジュールに基づくバックアップは無効となります。 - - **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 - - **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 - - **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 - - **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 - - **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: +- **しない**: スケジュールに基づくバックアップは無効となります。 +- **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 +- **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 +- **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 +- **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 +- **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: - **X 時間ごと**: 時間単位でバックアップの間隔をスケジュールできます。 1から24までの値を設定できます。 * **X 日ごと**: 日単位でバックアップの間隔をスケジュールできます。 たとえば、毎日バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップが開始される時刻を設定しなければなりません。 * **X 週ごと**: 週単位でバックアップの間隔をスケジュールできます。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップを開始する曜日と時刻を設定しなければなりません。 複数の曜日を選択することもできます。 たとえば、毎週水曜日と金曜日にバックアップをするようプログラムできます。 @@ -48,12 +48,12 @@ title: バックアップ設定 このエリアでは、次回のバックアップ時にコピー対象とするファイルやフォルダーを指定します。 - - **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: +- **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: - データベースのカレントログファイル (あれば) - [データファイルの隣に置かれた](../Project/architecture.md#settings-フォルダー) `Settings` フォルダー (あれば)。これは *データファイル用のユーザー設定* を格納しています。 - - **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 - - **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* - - **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 +- **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 +- **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* +- **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 - **削除**: 選択したファイルを添付エリアから取り除きます。 - **フォルダー追加...**: バックアップに追加するフォルダーを選択するダイアログボックスを表示します。 復元の場合、フォルダーがその内容物とともに復元されます。 アプリケーションファイルを含むフォルダーを除き、すべてのフォルダーやマシンに接続されたボリュームを選択できます。 - **ファイル追加...**: バックアップに追加するファイルを選択するダイアログボックスを表示します。 @@ -82,19 +82,19 @@ title: バックアップ設定 ### 一般設定 - - **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 +- **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 たとえば、3世代のファイルを保持するよう設定している場合、最初の 3回のバックアップで MyBase-0001、MyBase-0002、MyBase-0003 が作成され、 4回目のバックアップで MyBase-0004 が作成されたのちに MyBase-0001 が削除されます。 この設定はデフォルトで有効になっており、4D は 3世代のバックアップを保持します。 このメカニズムを無効にするには、チェックボックスの選択を外します。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 +- **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 +- **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 - - **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 +- **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 - **次回の予定された日付と時刻に再試行する**: このオプションは、定期的な自動バックアップを設定されている場合にのみ意味があります。 失敗したバックアップはキャンセルされます。 エラーが生成されます。 - **指定時間経過後に再試行**: このオプションが選択されていると、設定された待ち時間経過後にバックアップを再試行します。 このメカニズムを使用すると、バックアップをブロックするような特定の状況に対応することが可能となります。 秒、分、あるいは時間単位で待ち時間を設定できます。 次のバックアップ試行にも失敗するとエラーが生成され、ステータスエリアに失敗状況が表示され、バックアップジャーナルにも記録されます。 - **操作をキャンセル X 試行後**: このパラメーターを使用して、バックアップ試行の失敗最大数を設定できます。 この最大数に達してもバックアップが正しく実行できなかった場合、バックアップはキャンセルされ、エラー 1401 ("バックアップ試行の最大数に達しました。自動バックアップは無効になります") が生成されます。 この場合、データベースを再起動するか、手動バックアップが成功するまで自動バックアップはおこなわれません。 @@ -106,17 +106,17 @@ title: バックアップ設定 これらのオプションはメインのバックアップファイルとログバックアップファイルに適用されます。 - - **セグメントサイズ (MB)**: +- **セグメントサイズ (MB)**: 4D ではアーカイブをセグメントに分割することができます。 この振る舞いにより、たとえばバックアップファイルを複数の異なるディスク (DVDやUSBデバイス等) に格納できます。 復元時、4D はセグメントを自動的に統合します。 各セグメントには MyApplication[xxxx-yyyy].4BK といった名称がつけられます (xxxx はバックアップ番号、yyyy はセグメント番号)。 たとえば、MyApplication のバックアップが 3つのセグメントに分割されると、次のような名前になります: MyApplication[0006-0001].4BK、MyApplication[0006-0002].4BK、MyApplication[0006-0003].4BK **セグメントサイズ** はコンボボックスであり、各セグメントのサイズを MB単位で設定できます。 メニューから定義済み値を選択するか、0~2048 の値を入力できます。 0 を指定するとセグメント化はされません (**なし** を指定したのと同じ)。 - - **圧縮率**: +- **圧縮率**: デフォルトで 4D はバックアップファイルを圧縮してディスクスペースを節約します。 しかし大量のデータがある場合、ファイルの圧縮処理はバックアップにかかる時間を長くします。 **圧縮率** オプションを使用してファイルの圧縮モードを調整できます: - **なし**: ファイルの圧縮はおこなわれません。 バックアップは早くおこなわれますが、ファイルサイズは大きくなります。 - **速度** (デフォルト): このオプションはバックアップの速度とアーカイブサイズのバランスが考慮されたものです。 - **圧縮率**: アーカイブに最大の圧縮率が適用されます。 アーカイブファイルはディスク上で最小のサイズとなりますが、バックアップの速度は低下します。 - - **インターレース率と冗長率**: +- **インターレース率と冗長率**: 4D は、最適化 (インターレース) とセキュリティ (冗長) メカニズムに基づく特定のアルゴリズムを使用してアーカイブを生成します。 これらのメカニズムを必要に応じて設定できます。 これらのオプションのメニューには低・中・高・なし (デフォルト) の選択肢があります。 - **インターレース率**: インターレースとはデータを連続しない領域に書き込むことにより、セクター損傷の際のリスクを低減させるものです。 率を上げることでリスクがより低減されますが、データの処理により多くのメモリが必要となります。 - **冗長率**: 冗長は同じ情報を複数回繰り返すことで、ファイル中のデータを保護するものです。 冗長率を高くするとよりファイルが保護されます。しかし書き込みは遅くなり、ファイルサイズも増大します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md index b64738eed44277..6797c5d2ea76b5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: - - 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 - - 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -33,18 +33,18 @@ $col:=New collection // $col を空のコレクションで初期化します 演算の結果は、オペランドの **データ型** に依存します。4D はスカラーデータ型に対して様々な演算子をサポートしています。 詳細は、各データ型の項にて説明されています: - - [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) - - [**日付演算子**](dt_date.md#日付演算子) - - [**時間演算子**](dt_time.md#時間演算子) - - [**数値演算子**](dt_number.md#数値演算子) - - [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) - - [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) - - [**ポインター演算子**](dt_pointer.md#ポインター演算子) - - [**文字列演算子**](dt_string.md#文字列演算子) - - [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) - - [**コレクション参照演算子**](dt_collection.md#コレクション演算子) - - [**Null 演算子**](dt_null_undefined.md#null-演算子) - - [**未定義演算子**](dt_null_undefined.md#未定義演算子) +- [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) +- [**日付演算子**](dt_date.md#日付演算子) +- [**時間演算子**](dt_time.md#時間演算子) +- [**数値演算子**](dt_number.md#数値演算子) +- [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) +- [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) +- [**ポインター演算子**](dt_pointer.md#ポインター演算子) +- [**文字列演算子**](dt_string.md#文字列演算子) +- [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) +- [**コレクション参照演算子**](dt_collection.md#コレクション演算子) +- [**Null 演算子**](dt_null_undefined.md#null-演算子) +- [**未定義演算子**](dt_null_undefined.md#未定義演算子) ## 複合代入演算子 @@ -272,9 +272,9 @@ $name:=$person.maidenName || $person.name 三項演算子は 3つのオペランドを次の順序で受け取ります: - - 条件とクエスチョンマーク (?) - - 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) - - 条件が [falsy](#truthy-と-falsy) の場合に実行される式 +- 条件とクエスチョンマーク (?) +- 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) +- 条件が [falsy](#truthy-と-falsy) の場合に実行される式 ### シンタックス @@ -325,21 +325,21 @@ $fullname:=($person.firstname && $person.lastname) ? ($person.firstname+" "+$per 以下の値は **falsy** です: - - false - - Null - - undefined - - Null オブジェクト - - Null コレクション - - Null ポインター - - Null ピクチャー - - Null 日付 !00-00-00! - - "" - 空の文字列 - - [] - 空のコレクション - - {} - 空のオブジェクト +- false +- Null +- undefined +- Null オブジェクト +- Null コレクション +- Null ポインター +- Null ピクチャー +- Null 日付 !00-00-00! +- "" - 空の文字列 +- [] - 空のコレクション +- {} - 空のオブジェクト 上記以外の値はすべて **truthy** と評価されます。次の値も truthy です: - - 0 - 数値のゼロ (整数かどうかを問わず) +- 0 - 数値のゼロ (整数かどうかを問わず) 4Dでは、**truthy** と **falsy** の評価は値の **使用性** を反映します。つまり、truthy な値は存在し、エラーや予期せぬ結果を発生させずにコードによって処理できることを意味します。 その目的は、オブジェクトやコレクションにおける *undefined* や *null* 値を扱うための便利な方法を提供し、実行時エラーを回避するのに必要な [If...Else](flow-control.md#ifelseend-if) 文の数を少なくすることにあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md index c5099654e05cd7..bf38f56c24bd72 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md @@ -54,8 +54,8 @@ var $myVar // バリアント型変数 `varType` には次が指定できます: - - [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます - - [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます +- [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます +- [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます `varType` を省略すると、**variant** 型の変数が作成されます。 @@ -87,7 +87,7 @@ var $myVar // バリアント型変数 ### 例題 - - 基本のデータ型の、ローカル変数およびプロセス変数の宣言: +- 基本のデータ型の、ローカル変数およびプロセス変数の宣言: ```4d var $myText; myText; $vt : Text @@ -99,14 +99,14 @@ var $o : 4D.Object // C_OBJECT($o) とも同義です ``` - - 4Dクラス型のオブジェクト変数の宣言: +- 4Dクラス型のオブジェクト変数の宣言: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - ユーザークラス型のオブジェクト変数の宣言: +- ユーザークラス型のオブジェクト変数の宣言: ```4d var $myClass : cs.MyClass @@ -194,9 +194,9 @@ MyNumber:=3 ローカル変数は、以下のような目的のために使用されます: - - 他の変数名との重複を避ける。 - - データを一時的に使用する。 - - プロセス変数の数を減らす。 +- 他の変数名との重複を避ける。 +- データを一時的に使用する。 +- プロセス変数の数を減らす。 ローカル変数の名前は必ずドル記号 ($) で始め、この記号を除く31文字までの文字を指定できます。 これより長い名前を指定すると、4D は余分の32文字以降を切り捨てます。 @@ -225,9 +225,9 @@ MyNumber:=3 `GET PROCESS VARIABLE` や `SET PROCESS VARIABLE` を使用して、あるプロセスから他のプロセスのプロセス変数の値を取得したり、設定したりできます。 これらのコマンドの利用は、以下のような状況に限定することが、良いプログラミングの作法です: - - コード内の特定の箇所におけるプロセス間通信 - - プロセス間のドラッグ＆ドロップ処理 - - クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 +- コード内の特定の箇所におけるプロセス間通信 +- プロセス間のドラッグ＆ドロップ処理 +- クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 詳細については **プロセス** の章と、各コマンドの説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md index 9500d212469b2e..6f8747a80166fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md @@ -33,13 +33,13 @@ title: デバッガー 一般に、これらは発見が最も難しいタイプのエラーです。 これまでに説明しているエラーは、タイプミスを除いて、"設計またはロジックのエラー" という範疇に該当します。 これらを検知するには、[デバッガー](debugger.md) を使用します。 例: - - まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 - - 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 +- まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 +- 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 設計またはロジックのエラーには、次のような場合もあります: - - `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 - - オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 +- `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 +- オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 場合によって問題の原因は、実際に中断が発生しているコード部分ではなく、外部にあることもあります。 @@ -55,8 +55,8 @@ title: デバッガー メソッドの実行が停止されるとシンタックスエラーウィンドウが表示されます。 これは以下の理由で起こります: - - 以降のメソッド実行を妨げるエラーが発生した。 - - メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 +- 以降のメソッド実行を妨げるエラーが発生した。 +- メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ title: デバッガー シンタックスエラーウィンドウにはいくつかのオプションが用意されています: - - **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 +- **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 - - **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 +- **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 - - **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 +- **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 :::tip @@ -76,14 +76,14 @@ title: デバッガー ::: - - **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: +- **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: - イベントに対してフォームメソッドまたはオブジェクトメソッドが実行されている場合には、これらは停止され、フォームに戻ります。 - メソッドがアプリケーションモードから実行されている場合には、このモードに戻ります。 - - **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 +- **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 - - **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 +- **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 ## デバッガー diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md index 2662bf20994e15..64b0a5ee11b413 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md @@ -71,7 +71,7 @@ title: クライアント/サーバー管理 同じマシン上で 4D が 4D Server に接続すると、アプリケーションはシングルユーザーモードの 4D のようにふるまい、デザイン環境にてプロジェクトファイルの編集が可能です。 この機能により、クライアント/サーバーアプリケーションを運用時と同じコンテキストで開発することができます。 -> 同じマシン上で 4D Server に 4D を接続する場合には、 [接続時のオプション](#リモートプロジェクトを開く) の設定にかかわらず **開発モード** が自動的に有効化されます。 +> When 4D connects to a 4D Server on the same machine, the **development mode** is automatically activated, whatever the [Activate development mode](#opening-a-remote-project) option status. デザイン環境にて 4D が **すべてを保存** アクションを (**ファイル** メニューを使って明示的に、または、アプリケーションモードへの移行により暗示的に) おこなうと、4D Server は同期的にプロジェクトファイルをリロードします。 4D Server によるプロジェクトファイルのリロードが完了するのを待って、4D は続行します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md index 2c2c62dd381d89..342c7147a31749 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md @@ -15,10 +15,10 @@ title: On After Edit このイベントは、変更がおこなわれた方法に関係なく、入力可能オブジェクトの内容が変更されるたびに生成されます。*つまり*: - - ペーストやカット、削除、キャンセルなどの標準の編集アクション - - 値のドロップ (ペーストと同様のアクション) - - ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 - - ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 +- ペーストやカット、削除、キャンセルなどの標準の編集アクション +- 値のドロップ (ペーストと同様のアクション) +- ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 +- ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 `On After Edit` イベント内において、入力テキストは [`Get edited text`](../commands-legacy/get-edited-text.md) コマンドによって返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md index a71ad495fc74bf..6442cb5cb2fd76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ title: On Begin Drag Over `On Begin Drag Over` イベントは、ドラッグアクションの準備に役立ちます。 このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: - - `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 - - `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 - - ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 +- `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 +- `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 +- ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 - ドラッグアクションを受け入れるには、ソースオブジェクトのメソッドは 0 (ゼロ) を返さなければなりません。 - ドラッグアクションを拒否するには、ソースオブジェクトのメソッドは -1 (マイナス1) を返さなければなりません。 - 結果が返されない場合は、ドラッグアクションが受け入れられたと 4D は判断します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md index fb9943c47bf011..a0ee2f849bb5d4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md @@ -15,11 +15,11 @@ title: On Clicked `On Clicked` イベントは通常、マウスボタンが離されたときに生成されます。 しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: - - [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 - - [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 - - [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 - - [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 - - リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 +- [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 +- [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 +- [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 +- [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 +- リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 `On Clicked` イベントのコンテキストにおいては `Clickcount` コマンドを使うことによってユーザーがおこなったクリック数をテストすることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md index 18ab0753f5e4fa..7d6fbdfc0b4604 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ title: On Display Detail このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - レコードごとに: +- レコードごとに: - 詳細エリアのオブジェクトごとに: - オブジェクトメソッドの `On Display Detail` イベント - フォームメソッドの `On Display Detail` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md index 5816317910d07c..4cd0137a1c567d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over `On Drag Over` イベントは、マウスポインターがオブジェクトの上を移動する時に、繰り返しドロップ先オブジェクトに送られます。 このイベントの応答として、開発者は通常、以下のことをおこないます: - - ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 - - ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 +- ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 +- ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 ドラッグを **受け付ける** には、ドロップ先のオブジェクトメソッドが 0 (ゼロ) を返さなければなりません。 ドラッグを **拒否** するには、オブジェクトメソッドが -1 (マイナス1) を返さなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md index 823b0b85ca3b81..2beac18b7b5659 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md @@ -15,7 +15,7 @@ title: On Header このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - ヘッダーエリアのオブジェクトごとに: +- ヘッダーエリアのオブジェクトごとに: - オブジェクトメソッドの `On Header` イベント - フォームメソッドの `On Header` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md index 7120814e5d39cf..5317c52b286d9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md @@ -15,8 +15,8 @@ title: On Header Click リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されている場合、`$0` に 0 または -1 を渡して標準の並べ替えをおこなうかどうか指定できます: - - `$0 = 0` の場合、標準の並べ替えがおこなわれます。 - - `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 +- `$0 = 0` の場合、標準の並べ替えがおこなわれます。 +- `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されていない場合、`$0` は使用されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md index d5d31f0b890637..5ced8fbcb3e9a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md @@ -9,16 +9,16 @@ title: Forms また、以下の機能により、フォームは他のフォームを含むことができます: - - [サブフォームオブジェクト](FormObjects/subform_overview.md) - - [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) +- [サブフォームオブジェクト](FormObjects/subform_overview.md) +- [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) ## フォームを作成する 4Dフォームの追加や変更は、以下の要素を使っておこないます: - - **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 - - **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 - - **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: +- **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 +- **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 +- **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: ``` { @@ -70,9 +70,9 @@ title: Forms 2つのカテゴリーのフォームが存在します: - - **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 +- **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 - - **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 +- **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 フォームを作成する際にフォームカテゴリーを選択しますが、後から変更することも可能です。 @@ -80,15 +80,15 @@ title: Forms 各フォームは、少なくとも 2つのページで構成されています: - - ページ1: デフォルトで表示されるメインページ - - ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます +- ページ1: デフォルトで表示されるメインページ +- ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます 1つの入力フォームに複数のページを作成することができます。 一画面に納まりきらない数のフィールドや変数がある場合は、これらを表示するためにページを追加することができます。 複数のページを作成すると、以下のようなことが可能になります: - - もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 - - トピックごとに、専用ページにまとめる。 - - [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 - - フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 +- もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 +- トピックごとに、専用ページにまとめる。 +- [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 +- フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 複数ページは入力フォームとして使用する場合にのみ役立ちます。 印刷出力には向きません。 マルチページフォームを印刷すると、最初のページしか印刷されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md index 3b5a305a52788f..2957ab4f5948ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md @@ -7,11 +7,11 @@ title: フォームエディターマクロ たとえば、定期レポートに特定のフォーマットが指定されている場合 (例: テキストによってフォントカラーが赤や緑であるなど)、マクロを作成してフォントカラーの設定を自動でおこなうことができます。 4Dフォームエディターのマクロでは、次のことがおこなえます: - - 4Dコードを作成・実行する - - ダイアログを表示する - - オブジェクトを選択する - - フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する - - プロジェクトファイルを編集する (更新・削除) +- 4Dコードを作成・実行する +- ダイアログを表示する +- オブジェクトを選択する +- フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する +- プロジェクトファイルを編集する (更新・削除) フォームエディター用のカスタム機能を定義するため、マクロコードは [クラス関数](Concepts/classes.md) と [JSON のフォームオブジェクトプロパティ](FormObjects/properties_Reference.md) を使用できます。 @@ -237,9 +237,9 @@ Class constructor($macro : Object) フォームオブジェクトの `method` 属性を操作する場合、属性値は2通りの方法で定義できます: - - [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 +- [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 - - 次の構造を持つオブジェクトの使用: +- 次の構造を持つオブジェクトの使用: | プロパティ | 型 | 説明 | | ------ | ---- | ------- | @@ -251,9 +251,9 @@ Class constructor($macro : Object) `$4dId` プロパティは、現在のページにある各オブジェクトについて一意のIDを定義します。 このキーは`$result.currentPage` の変更を反映させるのに使用されます: - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 - - フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 +- フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 #### 例題 @@ -296,8 +296,8 @@ Function onInvoke($editor : Object)->$result : Object マクロの実行時に発生したエラーが、マクロの取り消しを不可能にする内容の場合、マクロは実行されません。 たとえば次のような場合が該当します: - - 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき - - 同じ内部ID を持つオブジェクトを複数作成しようとしたとき +- 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき +- 同じ内部ID を持つオブジェクトを複数作成しようとしたとき #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md index 802f09a55fede7..f99f6a4a11dc2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ title: オブジェクトライブラリ 4D では 2種類のオブジェクトライブラリを利用できます: - - 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます - - カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです +- 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます +- カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです ## 標準のオブジェクトライブラリの使用 @@ -21,10 +21,10 @@ title: オブジェクトライブラリ このウィンドウには次の主な機能があります: - - Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 - - 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: +- Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 +- 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: ![](../assets/en/FormEditor/library1.png) - - ライブラリのオブジェクトをフォーム上で使うには: +- ライブラリのオブジェクトをフォーム上で使うには: - オブジェクト上で右クリックし、コンテキストメニューから **コピー** を選択してフォーム上で同様に **ペースト** するか、 - ライブラリからフォーム上へと、オブジェクトをドラッグ＆ドロップします。 すると、フォームに当該オブジェクトが追加されます。 @@ -57,13 +57,13 @@ title: オブジェクトライブラリ カスタムのオブジェクトライブラリを開くには、**ファイル** メニューまたはツールバーから **開く > オブジェクトライブラリ...** コマンドを選択します。 標準のファイルを開くダイアログボックスが表示され、オブジェクトライブラリを選択できます。 次のファイルタイプが選択できます: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** カスタムオブジェクトライブラリは、実質的には標準の 4D プロジェクトです。 プロジェクトをライブラリとして開くと、次のものが公開されます: - - プロジェクトフォーム - - フォームのページ1 +- プロジェクトフォーム +- フォームのページ1 ### オブジェクトライブラリの構築 @@ -75,10 +75,10 @@ title: オブジェクトライブラリ ![](../assets/en/FormEditor/library5.png) - - ペーストボードへの **カット** または **コピー** - - ペーストボードからオブジェクトを **ペースト** - - **クリア** でライブラリからオブジェクトを削除 - - **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 +- ペーストボードへの **カット** または **コピー** +- ペーストボードからオブジェクトを **ペースト** +- **クリア** でライブラリからオブジェクトを削除 +- **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 オブジェクトライブラリには個々のオブジェクト (サブフォーム含む) やオブジェクトグループを格納できます。 それぞれのオブジェクトは1つのアイテムとしてグループ化されます: @@ -94,9 +94,9 @@ title: オブジェクトライブラリ メインのオブジェクトと一緒にライブラリに登録される依存オブジェクトは以下のとおりです: - - リスト - - フォーマット/フィルター - - ピクチャー - - ヘルプTips (フィールドにリンク) - - オブジェクトメソッド +- リスト +- フォーマット/フィルター +- ピクチャー +- ヘルプTips (フィールドにリンク) +- オブジェクトメソッド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md index a48b9606f1e4aa..7068adb59aaf88 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ title: フォームサイズ ## サイズを決めるもの - - **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 +- **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 自動サイズのウィンドウを用いて、オフスクリーンエリア (ウィンドウの矩形境界線の外側のエリア) に配置したアクティブオブジェクトを使用したい場合にこのオプションを選択することができます。 このオプションを選択すると、これらのオブジェクトによりウィンドウサイズが変更されなくなります。 - - **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 +- **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 - - `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 +- `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 > 出力フォームの場合は [**水平マージン**](#水平-マージン) または [**幅**](#幅) フィールドだけが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md index 5f5880a86f38e4..0482a54ca27094 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ title: フォームオブジェクト 4D フォームでは多くのビルトイン **アクティブ** オブジェクトおよび **スタティック** オブジェクトが提供されています: - - **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 - - **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 +- **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 +- **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 ## オブジェクトの操作 4D フォームオブジェクトの追加や編集は次の方法でおこなえます: - - **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 +- **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 - - **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 +- **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 - - **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 +- **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 次はボタンオブジェクトの例です: ```json diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md index 4d09df782992d4..275394a1dab283 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md @@ -50,6 +50,6 @@ title: 入力 フィールドや変数などの式は、フォーム内において入力オブジェクト以外を用いて表示することができます。具体的には以下の方法があります: - - データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 - - [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 - - ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 +- データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 +- [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 +- ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md index 46ec76d7d18ecf..c908ecfbd2ab1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md @@ -13,8 +13,8 @@ title: 階層リスト 階層リストの中身は次の方法で初期化することができます: - - 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 - - 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 +- 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 +- 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 どちらの場合においても、階層リストはランタイムでは *ListRef* の参照を通して、4D ランゲージの[階層リスト](../commands/theme/Hierarchical_Lists.md) のコマンドを使用して管理します。 @@ -34,9 +34,9 @@ mylist:=New list 特定のリストを使用している複数のフォームオブジェクトがある場合、それらにはそれぞれに固有の性質と、それらの間で共有される性質を持ちます。 以下の性質はリストフォームオブジェクトごとに固有のものです: - - 選択された項目 - - 項目の展開/折りたたみ状況 - - スクロールカーソルの位置 +- 選択された項目 +- 項目の展開/折りたたみ状況 +- スクロールカーソルの位置 それ以外の性質 (フォント、フォントサイズ、スタイル、入力制御、カラー、リストの内容、アイコン等) は他のリストフォームオブジェクトと共有され、個別に変更することはできません。 したがって、展開/折りたたみ状況に基づくコマンドやカレントの項目に関するコマンド、たとえば `Count list items` を (最後の `*` 引数を渡さずに) 使用するとき、どのフォームオブジェクトに対する処理なのかを明示的に指定することが重要です。 @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 他のオブジェクトプロパティ管理コマンドのように、`ListName` 引数で “@” 文字を使用できます。 このシンタックスは、フォーム上の複数のオブジェクトを指定するために使用されます。 しかし階層リストコマンドのコンテキストにおいては、これはすべての場合に適用されるわけではありません。 コマンドのタイプにより、このシンタックスは 2つの異なる効果があります: - - プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 +- プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: +- プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) いくつかの 4Dの汎用コマンドを使用して、フォーム上の階層リストオブジェクトの見た目を変更することができます。 これらのコマンドには、\* を用いたシンタックスを使用して階層リストのオブジェクト名を渡すか、あるいは標準シンタックスを使用して階層リストの ListRef 参照を格納している変数を渡します。 - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > 注記: `OBJECT SET SCROLL POSITION` コマンドを除き、これらのコマンドでオブジェクト名を指定したとしても、変更は同じリストを使うすべてのオブジェクトに反映されます。 @@ -107,8 +107,8 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 階層リストのコンテンツにアクセスするには、通常は位置または参照のいずれかを使用しておこないます。 - - 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 - - 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 +- 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 +- 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 ### 項目参照番号を使用する (itemRef) @@ -141,9 +141,9 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) ユーザーが階層リストの項目を変更できるかどうかを管理することができます。階層リストの項目が修正可能である場合、**Alt+クリック** (Windows) または **Optionキー+クリック** (macOS) ショートカットを使用するか、または項目のテキスト上でロングクリックすると、編集できるようになります。 - - データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 +- データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 - - また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 +- また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md index 799e77238bbea0..f40706e33fa2fb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ title: サブフォーム このプロパティを使用して、サブフォームで使用する詳細フォームを割り当てます。 以下のものを使用できます: - - ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ +- ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ コンポーネントで公開されていれば、コンポーネントフォーム名を選べます。 > サブフォームを介して追加の機能を提供する [コンポーネント](Concepts/components.md) を作成することが可能です。 - - [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 +- [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 #### JSON 文法 @@ -48,8 +48,8 @@ title: サブフォーム リストサブフォームの空行がダブルクリックされた際に実行されるアクションを指定します。 次のオプションから選択することができます: - - 何もしない: ダブルクリックを無視します。 - - レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 +- 何もしない: ダブルクリックを無視します。 +- レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 #### JSON 文法 @@ -73,9 +73,9 @@ title: サブフォーム ユーザーがリストサブフォームの行をダブルクリックした際に実行されるアクションを指定します。 選択可能なオプションは以下の通りです: - - **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 - - **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 - - **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 +- **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 +- **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 +- **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 選択されているアクションに関わらず、`On Double Clicked` フォームイベントが生成されます。 @@ -153,10 +153,10 @@ title: サブフォーム リストボックス行の選択モードを指定します: - - **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 - - **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ +- **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 +- **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ 上下キーを使うとリストの前後の行が選択されます。 その他のナビゲーションキーはリストをスクロールします。 カレントの行が変更されるたびに、`On Selection Change` フォームイベントが生成されます。 - - **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 +- **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 - 選択されたサブレコードは `GET HIGHLIGHTED RECORDS` で取得できます。 - レコードはクリックにより選択されますが、カレントレコードは変更されません。 - **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象レコードの選択状態 (選択・非選択) が切り替わります。 上下キーを使うとリストの前後のレコードが選択されます。 その他のナビゲーションキーはリストをスクロールします。 選択レコードが変更されるたびに、`On Selection Change` フォームイベントが生成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md index b5e6f8d3e97ef4..db4b8ddfb3586c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ title: 図形 次の基本の図形が提供されています: - - 四角 - - 線 - - 楕円 +- 四角 +- 線 +- 楕円 ## 四角 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md index 01b27f6fe5dd2a..89558aadffe1d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md @@ -11,10 +11,10 @@ title: スプリッター スプリッターの一般的な特徴をいくつか次に説明します: - - あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 - - スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 - - フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 - - スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 +- あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 +- スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 +- フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 +- スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 スプリッターは挿入されると線として表示されます。 その [線のスタイル](properties_BackgroundAndBorder.md#境界線スタイル) を変更してさらに細い線に設定したり、線の種類によっては [線の色](properties_BackgroundAndBorder.md#線カラー) を設定したりすることができます。 @@ -55,8 +55,8 @@ title: スプリッター 各スプリッターには *倍長整数* 型の [変数](properties_Object.md#変数あるいは式) が割り当てられます。 この変数はオブジェクトメソッドやフォームメソッドで使用することができます。 この変数の値により、スプリッターの最初の位置に対する現在位置がピクセル単位で示されます。 - - この値が負数の場合: スプリッターは上または左方向へ移動されました。 - - この値が正数の場合: スプリッターは下または右方向へ移動されました。 - - この値が 0 の場合: スプリッターは元の位置に移動されました。 +- この値が負数の場合: スプリッターは上または左方向へ移動されました。 +- この値が正数の場合: スプリッターは下または右方向へ移動されました。 +- この値が 0 の場合: スプリッターは元の位置に移動されました。 プログラムによってスプリッターを移動させることも可能です。これをおこなうには、関連付けた変数の値を設定します。 たとえば、垂直スプリッターに `split1` という名前の変数が関連付けられている場合、`split1:=-10` という命令を実行すると、ユーザーが手動で動かす場合と同じように、スプリッターは 10ピクセル左方向へ移動します。 移動が実際におこなわれるのは、この命令文が記述されているフォームメソッドまたはオブジェクトメソッドを実行しおわったときです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md index 2303c2289e500e..8f362edcb1ab32 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md @@ -13,11 +13,11 @@ title: ステッパー ステッパーには数値、時間、日付変数を割り当てることができます。 - - 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: +- 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: - [最小](properties_Scale.md#最小) = 28,800 (8\*60\*60) - [最大](properties_Scale.md#最大) = 64,800 (18\*60\*60) - [ステップ](properties_Scale.md#ステップ) = 600 (10\*60) - - 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 +- 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 > 時間や日付変数に対してステッパーを動作させるためには、プロパティリストで型を設定するだけでなく、`Time` または `Date` 型として [明示的に宣言](../Concepts/variables.md#変数の宣言) する必要があります。 @@ -29,8 +29,8 @@ title: ステッパー ## 参照 - - [進捗インジケーター](progressIndicator.md) - - [ルーラー](ruler.md) +- [進捗インジケーター](progressIndicator.md) +- [ルーラー](ruler.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md index 42924315d34a8a..140dd6f5bccbe0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ title: サブフォーム サブフォームに実装されたコンセプトを明確に説明するために、いくつかの用語についてここで定義します: - - **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 - - **親フォーム**: 1つ以上のサブフォームを含むフォーム。 - - **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 - - **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 - - **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 - - **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 +- **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 +- **親フォーム**: 1つ以上のサブフォームを含むフォーム。 +- **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 +- **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 +- **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 +- **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 ## リストサブフォーム @@ -43,8 +43,8 @@ title: サブフォーム デフォルトで、4D はサブフォームコンテナーに [オブジェクト型](properties_Object.md#式の型式タイプ) の変数あるいは式をバインドし、`Form` コマンドを使ってサブフォームのコンテキストで値を共有できるようにします。 しかし、単一の値のみを共有したい場合は、任意のスカラー型 (時間、整数など) の変数や式を使用することもできます。 - - バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 - - または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 +- バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 +- または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 ### 親フォームとサブフォームの同期 (単一値) @@ -58,8 +58,8 @@ title: サブフォーム 時間を静的に表示するには、適切な [データ型](properties_DataSource.md#データタイプ-式の型) を [変数または式](properties_Object.md#変数あるいは式) に使用する必要があります。 - - 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 - - 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 +- 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 +- 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 テキスト値のフォーマットは "hh:mm:ss" でなくてはなりません。 @@ -91,15 +91,15 @@ End if [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントは以下のときに生成されます: - - 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 - - サブフォームが 0ページまたはカレントフォームページに置かれているとき。 +- 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 +- サブフォームが 0ページまたはカレントフォームページに置かれているとき。 先の例のとおり、式を直接使用するのではなく、親フォームのサブフォームコンテナーの式の値を取得する `OBJECT Get subform container value` コマンドの利用が推奨されます。親フォームに同じサブフォームを複数配置することが可能だからです (たとえば、複数のタイムゾーンを表示するために時計を複数表示するウィンドウ)。 バインドされた変数あるいは式を変更すると、フォームイベントが発生し、親フォームとサブフォームの値を同期させることができます: - - 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 - - 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 +- 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 +- 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 #### 親フォームの内容を更新する @@ -177,8 +177,8 @@ End if このようなニーズにこたえるため、4Dは以下のメカニズムを実装しています: - - `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 - - `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 +- `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 +- `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 > `GOTO OBJECT` はサブフォームから実行されても、親フォーム内にて目的のオブジェクトを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md index e8e126265e682c..31fd406343928b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md @@ -42,9 +42,9 @@ macOSの場合、タブコントロールを標準位置 (上) だけでなく タブコントロールにラベルを設定するには、次のものを利用できます: - - オブジェクト - - 選択リスト - - 配列 +- オブジェクト +- 選択リスト +- 配列 ### オブジェクトの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md index cf3f24dced5d66..acd1812e9e7576 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md @@ -33,9 +33,9 @@ title: Text ![](../assets/en/FormObjects/staticText2.png) - - オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 - - オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 - - オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 +- オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 +- オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 +- オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md index c6ad7de797c35d..bc308e52b40ab0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md @@ -14,9 +14,9 @@ sidebar_label: ログ解析ページ この情報を使用して各操作のソースとコンテキストを識別できます: - - **操作**: ログファイル中での一連の操作番号 +- **操作**: ログファイル中での一連の操作番号 - - **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: +- **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: - データファイルを開く: データファイルを開いた - データファイルを閉じる: 開いたデータファイルを閉じた - コンテキストの作成する: 実行コンテキストを指定するプロセスを作成した @@ -30,24 +30,24 @@ sidebar_label: ログ解析ページ - トランザクションのキャンセル: トランザクションをキャンセルした - コンテキストの更新: 追加データを変更した (例: `CHANGE CURRENT USER` あるいは `SET USER ALIAS` の呼び出し) - - **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル +- **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル - - **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 +- **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 - - **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 +- **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 - - **サイズ**: 操作により処理されたデータのサイズ (バイト単位) +- **サイズ**: 操作により処理されたデータのサイズ (バイト単位) - - **日付と時刻**: 処理が実行された日付と時刻 +- **日付と時刻**: 処理が実行された日付と時刻 - - **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 +- **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 - - **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 +- **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 - - **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ +- **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ ***注**: データベースが暗号化されており、開かれたログファイルに対応する有効なデータキーが提供されていない場合、暗号化された値はこのカラムには表示されません。* - - **レコード**: レコード番号 +- **レコード**: レコード番号 選択したアプリケーションのカレントログファイル (デフォルトで "データファイル名.journal" というファイル名) の内容を更新するには **解析** をクリックします。 ブラウズボタンをクリックすると、アプリケーションの他のログファイルを選択できます。 **書き出し...** ボタンを使用してファイルの内容をテキストとして書き出せます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md index 24e5228e57e8c6..a95c87ac97d369 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md @@ -51,13 +51,13 @@ sidebar_label: 修復ページ "データファイル中で見つかったレコード" エリアには 2つのリストがあり、データスキャン結果の概要が表示されます。 - - 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: +- 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: - **順番** の列には、レコードグループの再生順が表示されます。 - **カウント** 列には、グループに含まれるレコード数が表示されます。 - **割当先テーブル** 列には、識別されたレコードのグループに割り当てられたテーブルの名前が表示されます。 割り当てられたテーブルの名前は自動で緑色で表示されます。 割り当てされなかったグループ、つまりどのレコードにも関連づけることができなかったテーブルは赤色で表示されます。 - **再生** 列では、レコードを再生するかどうかを各グループごとに指定できます。 デフォルトで、テーブルに割り当てられるすべてのグループが選択されています。 - - 右側のリストには、プロジェクトファイルのテーブルが表示されます。 +- 右側のリストには、プロジェクトファイルのテーブルが表示されます。 ### 手動による割り当て @@ -74,7 +74,7 @@ sidebar_label: 修復ページ 修復が完了すると、4D はプロジェクトの Logsフォルダーにログファイルを生成します。 このファイルを使用すると実行されたオペレーションをすべて閲覧することができます。 このファイルは XML形式で作成され、ApplicationName_Repair_Log_yyyy-mm-dd hh-mm-ss.xml というファイル名がつけられます。 - - *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) - - *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 +- *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) +- *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 **ログファイルを開く** ボタンをクリックすると、4Dはマシンのデフォルトブラウザーを使用して直近のログファイルを開きます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md index f04f9165350aaa..b751554c4bdddd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md @@ -11,8 +11,8 @@ title: メニュープロパティ メニューエディターを使って、テキストリテラルを直接、ラベルとして入力することができます。 または、変数参照、xliff参照を使用することもできます。これによりアプリケーションの翻訳が容易になります。 次のの参照タイプを使用できます: - - :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 - - `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 +- :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 +- `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 4Dランゲージを使う場合は、`APPEND MENU ITEM`、`INSERT MENU ITEM`、および `SET MENU ITEM` コマンドの *itemText* パラメーターでタイトルプロパティを設定します。 @@ -53,8 +53,8 @@ title: メニュープロパティ メニューエディターにて、標準アクション/プロジェクトメソッドをメニューに割り当てることができます: - - **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 - - **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 +- **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 +- **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 **macOS に関する注記:** macOS の場合、プラットフォームインタフェース標準に合わせるために、*quit* (終了) アクションが割り当てられたカスタムメニューコマンドは自動でアプリケーションメニュー内に置かれます。 4Dランゲージで割り当てをおこなう場合、プロジェクトメソッドには `SET MENU ITEM METHOD` コマンド、標準アクションには `SET MENU ITEM PROPERTY` コマンドを使います。 @@ -101,13 +101,13 @@ title: メニュープロパティ ショートカットには **Shift** や **Alt** (Windows) または **Option** (macOS) キーを追加できます。 これにより使用できるショートカットの数を増やすことができます。 以下のタイプのショートカットを定義できます: - - Windows: +- Windows: - Ctrl+文字 - Ctrl+Shift+文字 - Ctrl+Alt+文字 - Ctrl+Shift+Alt+文字 - - macOS: +- macOS: - Command+文字 - Command+Shift+文字 - Command+Option+文字 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md index b168976204f8df..2965daece5db59 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md @@ -9,27 +9,27 @@ title: リリースノート #### ハイライト - - [データ上のORDA イベント](../ORDA/orda-events.md) の管理。 - - [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) 関数の[`options`](../API/TCPConnectionClass.md#options-parameter) 引数に新しい`connectionTimeout` オプションが追加されました。 - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - 4D 内でのUUID は**バージョン7**で生成されるようになりました。 以前の4D のリリースでは、バージョン4で生成されていました。 - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - 4Dランゲージ: +- [データ上のORDA イベント](../ORDA/orda-events.md) の管理。 +- [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) 関数の[`options`](../API/TCPConnectionClass.md#options-parameter) 引数に新しい`connectionTimeout` オプションが追加されました。 +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- 4Dランゲージ: - 統一性のため、[`Create entity selection`](../commands/create-entity-selection.md) コマンドおよび [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) コマンドは、["4D 環境"](../commands/theme/4D_Environment.md) テーマから ["Selection"](../commands/theme/Selection.md) テーマへと移動しました。 - 新しい [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) および [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) コマンドを使用して、フォームオブジェクトに対して`Formula` オブジェクトを割り当て、または読み出しができるようになります。 - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) および [`LISTBOX Get property`](../commands/listbox-get-property.md) は3つの新しい定数をサポートするようになりました: `lk current item`、`lk current item position`、および `lk selected items expression` です。 - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### 動作の変更 - - Windows 上では、印刷しか想定していない(つまりスクリーン上で使用不可能な)カレントプリンターフォントは、4D の起動時にはロードされないようになりました。 - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- Windows 上では、印刷しか想定していない(つまりスクリーン上で使用不可能な)カレントプリンターフォントは、4D の起動時にはロードされないようになりました。 +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -37,20 +37,20 @@ title: リリースノート #### ハイライト - - [*MeCab* ライブラリー](../settings/database.md#mecab日本語版のサポート) は今後廃止予定となり、次のリリースでは削除される予定です。 - - [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 - - ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 - - 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 - - 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 - - インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 - - [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 - - 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 - - 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) - - Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 - - 4D Write Pro インターフェース: 新しい [統合されたAI](../WritePro/writeprointerface.md#integrated-ai) を使用して、4D Write Pro ドキュメントから**chatGTP** とやり取りすることができます。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 +- [*MeCab* ライブラリー](../settings/database.md#mecab日本語版のサポート) は今後廃止予定となり、次のリリースでは削除される予定です。 +- [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 +- ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 +- 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 +- 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 +- インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 +- [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 +- 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 +- 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) +- Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 +- 4D Write Pro インターフェース: 新しい [統合されたAI](../WritePro/writeprointerface.md#integrated-ai) を使用して、4D Write Pro ドキュメントから**chatGTP** とやり取りすることができます。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 ## 4D 20 R8 @@ -58,29 +58,29 @@ title: リリースノート #### ハイライト - - [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 - - [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 - - [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 - - [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 - - [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 - - Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) - - ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーション) することができるようになりました。 - - 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 - - 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 - - [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 - - 4D Write Pro: +- [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 +- [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 +- [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 +- [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 +- [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 +- Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) +- ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーション) することができるようになりました。 +- 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 +- 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 +- [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 +- 4D Write Pro: - 以下のコマンドが、引数としてオブジェクトまたはコレクションを受け取れるようになりました: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md)、[WP Get attributes](../WritePro/commands/wp-get-attributes.md)、[WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md)、[WP Table append row](../WritePro/commands/wp-table-append-row.md)、 [WP Import document](../WritePro/commands/wp-import-document.md)、 [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md)、 [WP Add picture](../WritePro/commands/wp-add-picture.md)、および [WP Insert picture](../WritePro/commands/wp-insert-picture.md) - [WP Insert formula](../WritePro/commands/wp-insert-formula.md)、 [WP Insert document body](../WritePro/commands/wp-insert-document-body.md)、および [WP Insert break](../WritePro/commands/wp-insert-break.md) はレンジを返す関数になりました(頭文字のみ大文字です)。 - ドキュメント属性に関連した新しい式: [This.sectionIndex](../WritePro/managing-formulas.md)、 [This.sectionName](../WritePro/managing-formulas.md) および[This.pageIndex](../WritePro/managing-formulas.md) - - 4Dランゲージ: +- 4Dランゲージ: - 変更されたコマンド: [`FORM EDIT`](../commands/form-edit.md) - [4D.CryptoKey class](../API/CryptoKeyClass.md) の[`.sign()`](../API/CryptoKeyClass.md#sign) および [`.verify()`](../API/CryptoKeyClass.md#verify) 関数は *message* 引数においてBlob をサポートするようになりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 #### 動作の変更 - - [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 - - [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 +- [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 +- [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 ## 4D 20 R7 @@ -88,31 +88,31 @@ title: リリースノート #### ハイライト - - 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 - - [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 - - [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 - - コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 - - [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 - - 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 - - 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 - - Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 - - 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の +- 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 +- [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 +- [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 +- コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 +- [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 +- 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 +- 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 +- Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 +- 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の 署名 や [ドメイン](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.ja.html) を検証するためのキーが追加されました。 - - [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 - - 4Dランゲージ: +- [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 +- 4Dランゲージ: - 新コマンド: [Process info](../commands/process-info.md)、 [Session info](../commands/session-info.md)、 [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - 変更されたコマンド: [Process activity](../commands/process-activity.md)、 [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - 新コマンド: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - 変更されたコマンド: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) および [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 #### 動作の変更 - - [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 - - [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 - - [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 +- [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 +- [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 +- [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 ## 4D 20 R6 @@ -120,25 +120,25 @@ title: リリースノート #### ハイライト - - [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 - - When a component has a [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), its classes are now automatically shared between all loaded components in the host project via [`cs.`](../Concepts/classes.md#cs). - - コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 - - 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 - - セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 - - [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 - - 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 - - サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 - - 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 - - プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 - - [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 - - 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 - - PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 +- [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 +- When a component has a [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), its classes are now automatically shared between all loaded components in the host project via [`cs.`](../Concepts/classes.md#cs). +- コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 +- 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 +- セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 +- [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 +- 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 +- サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 +- 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 +- プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 +- [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 +- 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 +- PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 #### 動作の変更 - - フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 - - [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 +- フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 +- [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 ## 4D 20 R5 @@ -146,21 +146,21 @@ title: リリースノート #### ハイライト - - 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 - - [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 - - QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 - - [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 - - [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). - - [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 - - RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 - - 新しい [$format](../REST/$format.md) RESTパラメーター。 - - [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 +- 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 +- [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 +- QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 +- [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 +- [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). +- [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 +- RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 +- 新しい [$format](../REST/$format.md) RESTパラメーター。 +- [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 #### 動作の変更 - - *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 - - ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 +- *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 +- ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 ## 4D 20 R4 @@ -168,24 +168,24 @@ title: リリースノート #### ハイライト - - TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 - - クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 - - HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 - - 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 - - `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 - - [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート - - 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 - - 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 - - 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 - - データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 +- TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 +- クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 +- HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 +- 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 +- `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 +- [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート +- 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 +- 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 +- 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 +- データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 #### 動作の変更 - - 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 - - セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 - - 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 - - [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 +- 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 +- セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 +- 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 +- [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 ## 4D 20 R3 @@ -193,21 +193,21 @@ title: リリースノート #### ハイライト - - 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 - - Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). - - [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 - - データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 - - ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 - - [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 - - ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 - - [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 +- 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 +- Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). +- [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 +- データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 +- ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 +- [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 +- ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 +- [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 #### 動作の変更 - - いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 - - 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 +- いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 +- 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 ## 4D 20 R2 @@ -221,15 +221,15 @@ title: リリースノート #### ハイライト - - 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 - - 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 - - 4D Write Pro インターフェース: 新しい [表ウィザード](../WritePro/writeprointerface.md)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 +- 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 +- 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 +- 4D Write Pro インターフェース: 新しい [表ウィザード](../WritePro/writeprointerface.md)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 #### 動作の変更 - - **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 +- **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 ## 4D 20.x LTS diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md index d95ad27ca22a23..440d7232052353 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md @@ -34,8 +34,8 @@ title: グローバルスタンプの使い方 また、本機能を適切に動作させるためには、以下の条件が必要です: - - `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 - - 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: +- `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 +- 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: | フィールド | 型 | 説明 | | ------------------------------------------------------- | --------------- | -------------------- | @@ -64,8 +64,8 @@ title: グローバルスタンプの使い方 すると、4D は次の変更をおこないます: - - 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 - - まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 +- 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 +- まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 データ変更追跡を無効化するには: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md index 1994fea99cf1f0..d1961f5f8a43eb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md index ae528cae6cea46..2b7347d927405d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ title: リモートデータストア `localID` はリモートデータストアに接続しているマシンにおけるローカルな識別IDです: - - 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 - - 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 - - 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 +- 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 +- 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 +- 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 これらの原則を下図に示します: @@ -29,9 +29,9 @@ title: リモートデータストア データストアアクセスを管理しているセッションは 4D Server の管理ウィンドウに表示されます: - - プロセス名: "REST Handler: \" - - タイプ: HTTP Server Worker - - セッション: `Open datastore` コマンドに渡されたユーザー名 +- プロセス名: "REST Handler: \" +- タイプ: HTTP Server Worker +- セッション: `Open datastore` コマンドに渡されたユーザー名 次の例では、1つのセッション上で 2つのプロセスが実行中です: @@ -47,11 +47,11 @@ title: リモートデータストア エンティティロッキングやトランザクションに関連した ORDA 機能は、ORDA のクライアント / サーバーモードと同様に、リモートデータストアにおいてもプロセスレベルで管理されます: - - あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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`). +- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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-R10/Preferences/general.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md index 80cf6ccf197bb5..ad50707a4c445f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md @@ -11,12 +11,12 @@ title: 一般ページ このオプションは、ユーザーがアプリケーションのみを起動したとき、4D が起動時に提供するデフォルトの表示を設定することができます。 - - **何もしない**: アプリケーションウィンドウのみが表示されます。 - - **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 - - **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 +- **何もしない**: アプリケーションウィンドウのみが表示されます。 +- **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 +- **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 > このオプションが選択されているときに、ドキュメントを開くダイアログボックスを強制的に表示させるには、プロジェクトを起動する際に、**Alt** (Windows) または **Option** (macOS) キーを押します。 - - **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 - - **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 +- **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 +- **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 > **4D Server**: 4D Server アプリケーションは、このオプションを無視します。 この環境においては、**何もしない** モードが常に選択されます。 @@ -30,8 +30,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド この機能は、以下の環境において利用することができます (4D 64-bit版のみ): - - コードエディターウィンドウ - - フォームエディターウィンドウ +- コードエディターウィンドウ +- フォームエディターウィンドウ これらのエディターのウィンドウはすべて、タブ形式にすることができます: @@ -47,9 +47,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 - - **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 - - **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 +- **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 +- **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 +- **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 ### アピアランス (macOSのみ) @@ -59,9 +59,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 - - **Light**: ライトテーマを使用します。 - - **Dark**: ダークテーマを使用します。 +- **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 +- **Light**: ライトテーマを使用します。 +- **Dark**: ダークテーマを使用します。 > この設定は macOS でのみサポートされています。 Windows上では、"Light" テーマが常に使用されます。 @@ -73,8 +73,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド このオプションをチェックすると、**ファイル ＞ 新規** メニューと、ツールバーの **新規** ボタンに、2つの項目が追加されます: - - **データベース...** - - **ストラクチャー定義を使用したデータベース...** +- **データベース...** +- **ストラクチャー定義を使用したデータベース...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ These items allow you to create binary databases (see [Creating a new database]( このエリアでは、カレントブラウザーに表示される 4D HTMLドキュメントへのアクセスを設定します: - - コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき - - エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき +- コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき +- エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき ### ドキュメント言語 @@ -151,8 +151,8 @@ These items allow you to create binary databases (see [Creating a new database]( 4Dがドキュメントのページを探す場所を設定します。 - - チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 - - チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 +- チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 +- チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 ### ローカルフォルダー diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md index 21dc1dbb73e9a1..24eb72f5868359 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md @@ -15,8 +15,8 @@ title: メソッドページ このリストでは、コードエディターに適用するテーマを選択します。 利用可能なテーマがすべて表示され、カスタムテーマがある場合はそれも表示されます。 4D はデフォルトで 2つのテーマを用意しています: - - **デフォルトのLightテーマ** - - **デフォルトのDarkテーマ** +- **デフォルトのLightテーマ** +- **デフォルトのDarkテーマ** > デフォルトのテーマは変更や削除ができません。 @@ -38,8 +38,8 @@ title: メソッドページ テーマを定義するとは、以下のことを意味します: - - コードエディター全体のグローバルフォントとフォントサイズを設定する。 - - 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 +- コードエディター全体のグローバルフォントとフォントサイズを設定する。 +- 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 異なる色やスタイルを組み合わせることは、コードのメンテナンス目的に特に便利です。 @@ -83,8 +83,8 @@ title: メソッドページ ローカル4Dアプリケーション用の "国際的な" コード設定を有効化/無効化することができます。 - - **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 - - **チェック有り**: リージョン設定が使用されます。 +- **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 +- **チェック有り**: リージョン設定が使用されます。 > このオプションを変更した場合、変更を反映するには 4Dアプリケーションを再起動する必要があります。 @@ -138,9 +138,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード入力中に () と、閉じるカッコを自動的に挿入するようにします。 このオプションでは 2つの自動機能を管理します: - - **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 +- **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 - - **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: +- **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,10 +150,10 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード中での対応する括弧を強調する方法を設定します。 この強調は、括弧 (大カッコ[]、中カッコ{}、小カッコ()) が選択されたときに表示されます。 次のオプションから選択することができます: - - **なし**: 強調なし - - **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) - - **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 - - **太字**: 括弧が太字で表示されます。 +- **なし**: 強調なし +- **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) +- **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 +- **太字**: 括弧が太字で表示されます。 #### 変数とフィールドを強調 @@ -161,9 +161,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip ![](../assets/en/Preferences/optionsVariables.png) - - **しない**(デフォルト): ハイライトなし - - **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 - - **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 +- **しない**(デフォルト): ハイライトなし +- **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 +- **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 ハイライトカラーは [テーマ](#テーマの定義) ページにて設定が可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md index 40f1cf2574945a..65708193f932f0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md @@ -5,7 +5,7 @@ title: プロジェクトのアーキテクチャー 4D プロジェクトは、一つのプロジェクトルートフォルダー (パッケージフォルダー) に格納された、複数のファイルやフォルダーから構成されています。 例: - - MyPackage (*プロジェクトルートフォルダー*) +- MyPackage (*プロジェクトルートフォルダー*) - `Components` - `Data` - `Logs` @@ -27,23 +27,23 @@ title: プロジェクトのアーキテクチャー 典型的な Project フォルダーの構造です: - - `.4DProject` ファイル - - `Sources` +- `.4DProject` ファイル +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Forms` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (あれば) +- `DerivedData` +- `Trash` (あれば) ### `.4DProject` ファイル プロジェクトを定義し、起動するためのプロジェクト開発ファイルです。 このファイルを開くには次のいずれかが必要です: - - 4D - - 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) +- 4D +- 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) > 4D プロジェクトの開発は 4D によっておこない、マルチユーザー開発はソース管理ツールによって管理します。 4D Server は .4DProject ファイルを開くことができますが、クライアントからの開発はおこなえません。 @@ -121,9 +121,9 @@ title: プロジェクトのアーキテクチャー プロジェクトから削除されたメソッドやフォームがあれば、Trash フォルダーにはそれらが格納されます。 たとえば、つぎのフォルダーが格納されている場合があります: - - `Methods` - - `Forms` - - `TableForms` +- `Methods` +- `Forms` +- `TableForms` 削除された要素はファイル名に括弧が付いた形でフォルダー内に置かれます (例: "(myMethod).4dm")。 フォルダーの構成は [Sources](#sources) フォルダーと同じです。 @@ -176,11 +176,11 @@ Data フォルダーには、データファイルのほか、データに関わ Logs フォルダーには、プロジェクトが使用するすべてのログファイルが格納されます。 以下のログファイルが格納されます: - - データベース変換 - - Webサーバーリクエスト - - バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) - - コマンドデバッグ - - 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) +- データベース変換 +- Webサーバーリクエスト +- バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) +- コマンドデバッグ +- 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) > An additional Logs folder is available in the system user preferences folder (active 4D folder, see [Get 4D folder](../commands-legacy/get-4d-folder.md) command) for maintenance log files and in cases where data folder is read-only. diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/components.md index 24a73e25f2bfc4..c8ddf549b65c4b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/components.md @@ -13,15 +13,15 @@ title: コンポーネント コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 - - インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 - - コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 +- インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 +- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 ### パッケージフォルダ コンポーネントのパッケージフォルダ(*MyComponent.4dbase* フォルダ) には以下のものを含めることができます: - - **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 - - **コンパイル版コンポーネント**の場合: +- **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 +- **コンパイル版コンポーネント**の場合: - .4DZ ファイル、*Resources* フォルダ、*Info.plist* ファイルを格納している"Contents" フォルダ(推奨されるアーキテクチャ) - *Resources* などの他のフォルダを格納している.4DZ ファイル。 @@ -37,8 +37,8 @@ title: コンポーネント このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: - - [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 - - 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 +- [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 +- 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 ::: @@ -46,14 +46,14 @@ title: コンポーネント 4Dプロジェクトにコンポーネントを読み込むには、以下の方法があります: - - コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 - - または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 +- コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 +- または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 **dependencies.json** ファイルで宣言されているコンポーネントは、異なる場所に保存できます: - - 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) - - マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) - - GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) +- 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) +- マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) +- GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) 同じコンポーネントが異なる場所にインストールされている場合、[優先順位](#優先順位) が適用されます。 @@ -69,8 +69,8 @@ title: コンポーネント このファイルには次の内容を含めることができます: - - [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 - - [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 +- [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 +- [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 #### environment4d.json @@ -78,8 +78,8 @@ title: コンポーネント このアーキテクチャーの主な利点は次のとおりです: - - **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 - - 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 +- **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 +- 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 ### 優先順位 @@ -187,9 +187,9 @@ GitHub に保存されているコンポーネントに関しては、[**depende GitHub に保存された 4Dコンポーネントを直接参照して使用するには、GitHubコンポーネントのリポジトリを設定する必要があります。 - - ZIP形式でコンポーネントファイルを圧縮します。 - - GitHubリポジトリと同じ名前をこのアーカイブに付けます。 - - このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 +- ZIP形式でコンポーネントファイルを圧縮します。 +- GitHubリポジトリと同じ名前をこのアーカイブに付けます。 +- このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 これらのステップは、4Dコードや GitHubアクションを使用することで簡単に自動化できます。 @@ -232,7 +232,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ ::: - - **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: +- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: ```json { @@ -245,7 +245,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ } ``` - - リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: +- リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: ```json { @@ -262,17 +262,17 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 以下にいくつかの例を示します: - - "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 - - "`*`": リリースされている最新バージョン。 - - "`1.*`": メジャーバージョン 1 の全バージョン。 - - "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 - - "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 - - "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 - - "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 - - "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 - - "`<=1.2.3`": 1.2.3 までの最新バージョン。 - - "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 - - "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 +- "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 +- "`*`": リリースされている最新バージョン。 +- "`1.*`": メジャーバージョン 1 の全バージョン。 +- "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 +- "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 +- "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 +- "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 +- "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 +- "`<=1.2.3`": 1.2.3 までの最新バージョン。 +- "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 +- "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 タグやバージョンを指定しない場合、4D は自動的に "latest" バージョンを取得します。 @@ -282,9 +282,9 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ [**4Dのバージョンに追随する**](#github依存関係バージョン範囲) 依存関係ルールを使用したい場合、GitHub レポジトリ上でのコンポーネントのリリースのタグは、特定の命名規則に従う必要があります。 - - **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 +- **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 - - **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 +- **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 :::note @@ -310,8 +310,8 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 参照された GitHubコンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます: - - macOs: `$HOME/Library/Caches//Dependencies` - - Windows: `C:\Users\\AppData\Local\\Dependencies` +- macOs: `$HOME/Library/Caches//Dependencies` +- Windows: `C:\Users\\AppData\Local\\Dependencies` ... 上記で `` は "4D"、"4D Server"、または "tool4D" となります。 @@ -319,12 +319,12 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. 構成には次の内容が含まれます: - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ The Dependency manager reads each component's own `dependencies.json` file and r 依存関係パネルを表示するには: - - 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
+- 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
![dependency-menu](../assets/en/Project/dependency-menu.png) - - with 4D Server, select the **Window/Project Dependencies** menu item.
+- with 4D Server, select the **Window/Project Dependencies** menu item.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) 依存関係パネルが表示されます。 依存関係は ABC順にソートされます。 @@ -362,11 +362,11 @@ The Dependency manager reads each component's own `dependencies.json` file and r ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 - - **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 +- **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 ### Secondary dependencies @@ -384,16 +384,16 @@ When you hover over a secondary dependency, a tooltip displays the parent depend 使用されるステータスラベルは次のとおりです: - - **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 - - **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 - - **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 - - **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 - - **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 - - **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 - - **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 - - **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. - - **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. - - **Recent update**: A new version of the GitHub dependency has been loaded at startup. +- **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 +- **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 +- **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 +- **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 +- **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 +- **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 +- **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 +- **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. +- **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. +- **Recent update**: A new version of the GitHub dependency has been loaded at startup. 依存関係の行にマウスオーバーするとツールチップが表示され、ステータスに関する追加の情報を提供します: @@ -427,8 +427,8 @@ When you hover over a secondary dependency, a tooltip displays the parent depend コンポーネントアイコンとロケーションロゴが追加情報を提供します: - - コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 - - ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 +- コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 +- ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ When you hover over a secondary dependency, a tooltip displays the parent depend プロジェクトに依存関係を追加するには、**追加** をクリックします。 - - プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 - - プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 +- プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 +- プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 :::note @@ -489,11 +489,11 @@ The GitHub dependency is declared in the [**dependencies.json**](#dependenciesjs ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 - - **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 - - **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 - - **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 - - **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 +- **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 +- **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 +- **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 +- **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 +- **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 The current GitHub dependency version is displayed on the right side of the dependency item: @@ -509,8 +509,8 @@ Modifying the version range is useful for example if you use the automatic updat The Dependency manager provides an integrated handling of updates on GitHub. The following features are supported: - - Automatic and manual checking of available versions - - Automatic and manual updating of components +- Automatic and manual checking of available versions +- Automatic and manual updating of components Manual operations can be done **per dependency** or **for all dependencies**. @@ -526,11 +526,11 @@ If you provide an [access token](#providing-your-github-access-token), checks ar In addition, you can check for updates at any moment, for a single dependency or for all dependencies: - - To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. +- To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. ![check component](../assets/en/Project/check-component-one.png) - - To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. +- To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. ![check components](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ If you do not want to use a component update (for example you want to stay with You can update dependencies at any moment, for a single dependency or for all dependencies: - - To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: +- To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: ![check component](../assets/en/Project/update-component-one.png) - - To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: +- To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ In any cases, whatever the current dependency status, an automatic checking is d When you select an update command: - - a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. - - if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. +- a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. +- if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. #### Automatic update @@ -575,13 +575,13 @@ When this option is unchecked, a new component version matching your [component Registering your personal access token in the Dependency manager is: - - mandatory if the component is stored on a [private GitHub repository](#private-repositories), - - recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). +- mandatory if the component is stored on a [private GitHub repository](#private-repositories), +- recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). To provide your GitHub access token, you can either: - - "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 - - または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 +- "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 +- または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md index 5ae69bd8026d8c..fc4e6fe69187b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md @@ -7,10 +7,10 @@ title: ドキュメンテーション ドキュメントすることができるプロジェクト要素は次のとおりです: - - メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) - - クラス - - Forms - - テーブルとフィールド +- メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) +- クラス +- Forms +- テーブルとフィールド ドキュメンテーションファイルは Markdown記法 (.md ファイル) で記述します。 これには、Markdown をサポートしている任意のエディターを使うことができます。 これらはそれぞれ独立したファイルとしてプロジェクトフォルダー内に格納されます。 @@ -34,7 +34,7 @@ title: ドキュメンテーション `Documentation` フォルダーのアーキテクチャーは次のとおりです: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ title: ドキュメンテーション - table1.md - ... - - プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 - - テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 > ドキュメントされているプロジェクト要素を名称変更したり、削除したりすると、その要素に紐づいている Markdown ファイルも自動で名称変更、または削除されます。 @@ -73,9 +73,9 @@ title: ドキュメンテーション ![](../assets/en/Project/comments-explo2.png) - - 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 +- 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 - - 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 +- 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 ### ドキュメンテーションファイルの編集 @@ -83,8 +83,8 @@ title: ドキュメンテーション 選択要素のドキュメンテーションファイルが存在しなければ: - - `Documentation` ペインにある **作成する** ボタンをクリックするか、 - - エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 +- `Documentation` ペインにある **作成する** ボタンをクリックするか、 +- エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ title: ドキュメンテーション `\.md` ファイルが `\/documentation` フォルダーに存在する場合、コードエディターは次の優先順位でヘルプTips を表示します: - - Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) +- Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) - - HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ +- HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ この場合、最初の文章には 4D コードパーサーによって自動生成されたメソッドの **プロトタイプ** が入ります。 :::note @@ -130,7 +130,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### サポートされている Markdown - - 見出しタグ: +- 見出しタグ: ```md # 見出し 1 @@ -138,7 +138,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### 見出し 3 ``` - - スタイルタグ (イタリック、太字、取り消し線) : +- スタイルタグ (イタリック、太字、取り消し線) : ```md _イタリック_ @@ -147,7 +147,7 @@ _イタリック_ ~~取り消し線~~ ``` - - 4D コードハイライトが付くコードブロックタグ (\`4d ... `): +- 4D コードハイライトが付くコードブロックタグ (\`4d ... `): ````md ```4d @@ -156,7 +156,7 @@ _イタリック_ ``` ```` - - テーブルタグ: +- テーブルタグ: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _イタリック_ | toolbar | Text |Toolbar name | ``` - - リンクタグ: +- リンクタグ: ```md // 例 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - 画像タグ: +- 画像タグ: ```md ![画像の説明](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - エクスプローラーの表示: +- エクスプローラーの表示: ![](../assets/en/Project/explorer_Doc.png) - - コードエディターの表示: +- コードエディターの表示: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md index 3ae1f9e5ff3140..ce909e1666efa7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the `$attributes` はエンティティ (*例:* People(1)) またはエンティティセレクション (*例:* People/$entityset/0AF4679A5C394746BFEB68D2162A19FF) に対して適用できます。 - - クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 +- クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 - - **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntity`: リレートエンティティは簡単な形で返されます (`__KEY` (プライマリーキー) と `URI` プロパティを持つ deferred オブジェクト) - `$attributes=relatedEntity.*`: リレートエンティティの属性がすべて返されます。 - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: リレートエンティティの指定された属性だけが返されます。 - - **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntities.*`: リレートエンティティズの属性がすべて返されます。 - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: リレートエンティティズの指定された属性だけが返されます。 - - If `$attributes` is specified for **storage** attributes: +- If `$attributes` is specified for **storage** attributes: - `$attributes=attribute1, attribute2, ...`: only those attributes of the entities are returned. ## リレートエンティティズの例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md index 1ded5dd7335092..d6a83ce65447f3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md @@ -27,13 +27,13 @@ The locks triggered by the REST API are put at the [session](authUsers.md#sessio *ロック* されたエンティティは次のものから操作 (ロック / アンロック / 更新 / 削除) できません: - - 他の REST セッション - - RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 +- 他の REST セッション +- RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 REST API によってロックされたエンティティは、次の場合にのみアンロックされます: - - ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 - - ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 +- ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 +- ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 ### レスポンス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md index defa6eec9b472d..157f1a674636d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md @@ -194,9 +194,9 @@ RESTリクエストで定義されたリレートエンティティのコレク :::note - - **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 - - **ブール** は true または false です。 - - Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 +- **ブール** は true または false です。 +- Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md index e50b78e469b7f1..bf98fb587668af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md @@ -7,8 +7,8 @@ REST リクエストを使って、ORDA データモデルに定義されてい 関数は以下の2つの方法で呼び出すことができます: - - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 +- **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 +- **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。 一方で、GET リクエストは、URL をブラウザに入れるだけで関数を呼び出すことができるため、 よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 @@ -97,11 +97,11 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 次のルールが適用されます: - - POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 - - GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 - - 引数はコレクション (JSON形式) の中に格納する必要があります。 - - JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 - - エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 +- POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 +- GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 +- 引数はコレクション (JSON形式) の中に格納する必要があります。 +- JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 +- エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 [エンティティを引数として受け取る例題](#エンティティを引数として受け取る) と [エンティティセレクションを引数として受け取る例題](#エンティティセレクションを引数として受け取る) を参照ください。 @@ -135,8 +135,8 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 | __ENTITY | Boolean | 必須 - true は引数がエンティティであることをサーバーに通知します | | __KEY | 混合 (プライマリーキーと同じ型) | 任意 - エンティティのプライマリーキー | - - `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 - - `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 +- `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 +- `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 POST リクエストでエンティティを作成または更新する方法については以下の例題を参照して下さい。 GET リクエストとエンティティを使用してコンテンツをダウンロードする方法については以下の例題を参照して下さい。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md index 24a5115b6e7e1a..9ac0e0f41fbe9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md @@ -43,9 +43,9 @@ When [scalable sessions are enabled](WebServer/sessions.md#enabling-web-sessions 記述的RESTリクエストは、ライセンスを必要としない Webユーザーセッション ("ゲスト" セッション) で処理することができます。 記述的RESTリクエストとは以下のものを指します: - - [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス - - `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 - - `/rest/$getWebForm` - Qodlyページのレンダリング +- [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス +- `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 +- `/rest/$getWebForm` - Qodlyページのレンダリング ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ exposed Function authentify({params : type}) {-> result : type} この関数は 2部構成で書かれる必要があります: - - RESTリクエストの送信元を識別し、認証するためのコード - - 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し +- RESTリクエストの送信元を識別し、認証するためのコード +- 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し 関数が [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) を呼び出さない場合、権限が割り当てられないため、ライセンスも消費されず、後続の記述的でない RESTリクエストは拒否されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md index 777d5af43f60d0..db67a21957bbe2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md @@ -9,8 +9,8 @@ RESTサーバーは 4D および 4D Server に含まれており、[設定完了 この章では、簡単な例題を使用して REST機能を紹介します。 これから、実際に次のことをしてみましょう: - - 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 - - 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 +- 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 +- 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 例題が複雑にならないよう、ここでは 4D とブラウザーを同じマシン上で使用します。 もちろん、リモートアーキテクチャーを使うことも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md index 4886dc8fdaca40..d961bc858e1130 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md @@ -19,7 +19,7 @@ REST API を使って、4D内と同等のデータ操作をおこなうことが [\{dataClass\}(\{key\})](dataClass.md#dataclasskey) でデータクラスのいちエンティティを取得する以外にも、エンティティセレクションやコレクションを返す [クラス関数](ClassFunctions.md#関数の呼び出し) を用意することもできます。 -戻り値としてセレクションを返す前に、[`$orderby`]($orderby.md) を使って一つ以上の属性 (リレーション属性も可) を基準に並べ替えることもできます。 +Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) on one or more attributes (even relation attributes). ## データのナビゲーション @@ -27,7 +27,7 @@ REST API を使って、4D内と同等のデータ操作をおこなうことが ## エンティティセットの作成と管理 -エンティティセットとは、*エンティティセレクション* と同等の意味で、RESTリクエストによって取得され、4D Server のキャッシュに保存されるエンティティのコレクションのことです。 エンティティセットを利用することで、同じ結果を得るためにアプリケーションを繰り返しクエリすることが避けられます。 エンティティセットへのアクセスはクエリするよりも速いため、アプリケーション速度の向上にもつながります。 +An entity set is a collection of entities obtained through a REST request that is stored in 4D Server's cache. エンティティセットを利用することで、同じ結果を得るためにアプリケーションを繰り返しクエリすることが避けられます。 エンティティセットへのアクセスはクエリするよりも速いため、アプリケーション速度の向上にもつながります。 エンティティセットを作成するには、RESTリクエスト内で [`$method=entityset`]($method.md#methodentityset) を呼び出します。 エンティティセットがタイムアウトした場合やサーバーから削除されてしまった場合への安全対策として、[`$filter`]($filter.md) や [`$orderby`]($orderby.md) を呼び出す際に [`$savedfilter`]($savedfilter.md) および [`$savedorderby`]($savedorderby.md) を使用することで、以前と同じ ID で再取得することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md index 0ca173c609562f..4cb80f3b7efa91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md @@ -17,15 +17,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-buttons.png) - - **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 - - **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 - - **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 +- **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 +- **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 +- **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 **グループ毎にプロセスを表示** オプションを使用して、4D Server の内部プロセスやクライアントプロセスをグループ化できます。 このオプションをチェックすると: - - 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 - - "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 - - "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 +- 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 +- "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 +- "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 ウィンドウの下段には選択したプロセスの稼働状況がグラフィカルに表示されます。 @@ -33,16 +33,16 @@ title: プロセスページ プロセスの稼働状況は、4D Server がこのプロセスのために使用した時間のパーセンテージです。 ウィンドウにはプロセスごとに以下の情報が表示されます: - - プロセスタイプ (後述) - - セッション/情報: +- プロセスタイプ (後述) +- セッション/情報: - 4Dプロセス - 空白 - ユーザープロセス - 4Dユーザー名 - Webプロセス - URLパス - - プロセス名 - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 - - プロセスの現在の状況 - - 作成されてからのプロセスの実行時間 (秒) - - 4D Server がこのプロセスに使用した時間のパーセンテージ +- プロセス名 +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 +- プロセスの現在の状況 +- 作成されてからのプロセスの実行時間 (秒) +- 4D Server がこのプロセスに使用した時間のパーセンテージ ## プロセスタイプ @@ -83,15 +83,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-actions.png) - - **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 +- **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **プロセスを一時停止**: 選択したプロセスを一時停止します。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 - - **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 +- **プロセスを一時停止**: 選択したプロセスを一時停止します。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 > 確認ダイアログなしに選択したプロセスをデバッグするには、**Alt**キーを押しながらこのボタンをクリックします。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md index 6179dd1ed022bc..f822341cf0edcc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ title: リアルタイムモニターページ 各行について、以下の情報が表示されます: - - **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 - - **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 - - **情報**: 操作の説明。 - - **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: +- **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 +- **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 +- **情報**: 操作の説明。 +- **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: - **作成された場所**: そのオペレーションがクライアントアクションの結果か (クライアント上で作成)、ストアドプロシージャ―または "サーバー上で実行" オプションを使用した結果か (サーバー上で作成) を表示します。 - **オペレーション詳細**: オペレーションタイプと、(クエリオペレーションに対しては) クエリプランを表示します。 - **サブオペレーション** (あれば): 選択したオペレーションに従属するオペレーションを表示します (例:親レコードの前にリレートレコードを削除する) @@ -26,9 +26,9 @@ title: リアルタイムモニターページ このページは表示後すぐにアクティブになり、恒久的に更新され続けます。 ただし、この処理によって、アプリケーションの実行を極端に遅くさせる可能性があることに注意してください。 以下の方法を用いて更新を一時的に停止させることが可能です: - - **停止** ボタンをクリックする - - リストの中をクリックする - - スペースバーを押す +- **停止** ボタンをクリックする +- リストの中をクリックする +- スペースバーを押す ページを停止させると一時停止のメッセージが表示され、ボタンの表示が **再開** に変わります。 モニタリング停止操作と同じ操作をすることでモニタリングを再開させることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md index c9f97585e0b23e..18f88e2ba81165 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md @@ -7,8 +7,8 @@ title: アクセスコントロールの概要 運用環境によって、4D アクセスコントロールの方法は異なります: - - マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > 4Dのセキュリティ機能の概要については、[4D Security guide](https://blog.4d.com/4d-security-guide/) をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md index 70870aa1aea9a7..d7901194653d79 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ title: VP EXPORT DOCUMENT ドキュメント名に拡張子を付けることで、書き出すドキュメントの形式を指定することができます: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt" または ".csv") - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt" または ".csv") +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") ファイル名に拡張子が含まれていなくても、*paramObj* 引数によって形式が指定されている場合、書き出されたファイルには形式に対応する拡張子がつけられます。 ただし CSV形式の場合には拡張子がつきません。 @@ -88,25 +88,25 @@ title: VP EXPORT DOCUMENT **Excel 形式についての注意**: - - 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 - - ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 +- 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 **PDF 形式についての注意**: - - 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **CSV 形式についての注意**: - - 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 - - すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 +- すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **SpreadJS ファイル形式についての注意**: - - [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 書き出し操作が完了すると、`VP EXPORT DOCUMENT` は自動的に、*paramObj* オブジェクトの *formula* プロパティに設定されたメソッドをトリガーします (設定されていれば)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md index 2288d71beadfef..b589bd67a50a0f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md @@ -5,7 +5,7 @@ title: VP Find -**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object } ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object +**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md index 4b85db02c19f3e..163d884fe9f6ea 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ title: VP Get stylesheets 任意の *sheet* 引数を使用することで、スタイルシートをどこから取得するかを指定することができます。シートインデックス (0 起点) か、以下の定数のいずれかを渡すことができます: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md index 7ac63c9deef533..a2c15488013851 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ title: VP Get value 返されるオブジェクトに日付または時間が含まれている場合、これは "日付時間"として扱われ、以下のように補完されます: - - 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 - - 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 +- 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 +- 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 *rangeObj* のレンジが複数セルあるいは複数レンジを含んでいる場合、最初のセルの値が返されます。 セルが空の場合には、コマンドは null オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md index cdb5b87c53d7ee..fb5d194e51221b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ title: VP IMPORT DOCUMENT *filePath* には読み込むドキュメントのパスとファイル名を渡します。 以下のフォーマットがサポートされています : - - 4D View Pro ドキュメント (拡張子 ".4vp") - - Microsoft Excel 形式 (拡張子 ".xlsx") - - テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") +- 4D View Pro ドキュメント (拡張子 ".4vp") +- Microsoft Excel 形式 (拡張子 ".xlsx") +- テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") ドキュメントの拡張子が認識される拡張子 (`.4vp` や `.xlsx` など) ではなかった場合、ドキュメントはテキスト形式であると見なされます。 ドキュメントが Project フォルダーと同階層に置かれている場合を除き、フルパスを渡す必要があります (同階層に置かれている場合にはファイル名のみを渡すことができます)。 @@ -73,11 +73,11 @@ title: VP IMPORT DOCUMENT :::note 注記 - - .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 - - Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 - - CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 +- Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 +- CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md index dbce5f598859fd..9aff390b955ca6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md @@ -13,7 +13,7 @@ title: VP REMOVE TABLE COLUMNS -**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }}} ) +**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }} ) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md index 392b3e5f084244..3e29b2a1d9721f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ title: VP RESIZE TABLE 次のルールが適用されます: - - ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 - - リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 - - 表組みを拡張した先にデータを含むセルが存在する場合には: +- ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 +- リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 +- 表組みを拡張した先にデータを含むセルが存在する場合には: - 行が追加された場合、データは削除されます。 - 列が追加された場合、データは保持され、新しい列に表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md index 320d57d260bc2c..37cce773edc7e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md @@ -38,20 +38,20 @@ title: はじめに ### セル、列、および行の選択 - - セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 +- セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 - - 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 +- 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 - - スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: +- スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - 列を選択するには、対応する文字 (アルファベット) をクリックします。 +- 列を選択するには、対応する文字 (アルファベット) をクリックします。 - - 行を選択するには、対応する番号をクリックします。 +- 行を選択するには、対応する番号をクリックします。 - - 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 +- 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 - - セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 +- セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 ### データの入力 @@ -77,8 +77,8 @@ title: はじめに クリックしたエリアに応じて、メニューには次の選択肢が表示されます: - - 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** - - セルあるいはセルレンジのクリック: +- 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** +- セルあるいはセルレンジのクリック: - **フィルタリング**: フィルタリングを使用して行を非表示にします ([SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/) の "Filtering rows" を参照ください) - **ソート**: 列のコンテンツを並べ替えます。 - **コメントの挿入**: ユーザーコメントを入力できます。 コメントが入力されているセルには、小さな赤い三角形が表示されます:\ @@ -129,8 +129,8 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro のレンジオブジェクトは、いくつかのプロパティで構成されます: - - area - 4D View Pro エリアの名称 - - ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 +- area - 4D View Pro エリアの名称 +- ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 | プロパティ | | 型 | 説明 | 利用可能な対象 | | ------ | ------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------- | -------------------------------------------------- | @@ -147,10 +147,10 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro は、複数のドキュメント形式のインポートおよびエクスポートに対応しています: - - .4vp - - .xlsx - - .txt と .csv - - .sjs - - .pdf (エクスポートのみ) +- .4vp +- .xlsx +- .txt と .csv +- .sjs +- .pdf (エクスポートのみ) 詳細については [VP IMPORT DOCUMENT](commands/vp-import-document.md) と [VP EXPORT DOCUMENT](commands/vp-export-document.md) の説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md index a66a66a3b6d4b3..89dfb36cb849a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ QodlyScript はローカル変数のみをサポートするため、QodlyScript QodlyScript のコマンドおよび定数名は、スペースを入れずにキャメルケースで記述されます。 また、QodlyScript の定数名は `k` 文字で始まります。 これらの QodlyScript の要素を 4Dランゲージに変換する必要があるかもしれません。 - - 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 - - しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 +- 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 +- しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 ### 例題 - - QodlyScript コード: +- QodlyScript コード: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript のコマンドおよび定数名は、スペースを入れずに end ``` - - 上に相当する 4Dランゲージのコード: +- 上に相当する 4Dランゲージのコード: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md index 8808b00ae70d46..af4c0e3ee6dd0d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ http://localhost/rest/Friends 4D Webサーバーにユーザーをログインさせる、もっともシンプルで安全な方法は、以下のシナリオに基づきます: - - ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 - - [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 +- ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 +- [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 1. いくつかのフィールドを持つテーブルを作成します。たとえば: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md index cc26dc350cb0dc..7de1c63f722d09 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ title: HTTP Request handler カスタムのHTTP リクエストハンドラーを使用することで、以下のような用途に応えることができます: - - 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 - - コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする - - oAuth 2.0 経由での認証を管理する +- 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 +- コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする +- oAuth 2.0 経由での認証を管理する ## 要件 カスタムのHTTP リクエストハンドラーは以下の条件の元にサポートされます: - - [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること - - メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 +- [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること +- メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 :::warning @@ -62,9 +62,9 @@ title: HTTP Request handler ハンドラーは以下の3つの要素から定義されます: - - 聞くべきURL パターン - - 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 - - そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) +- 聞くべきURL パターン +- 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 +- そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) ハンドラーの識別子は、[パターン + 動詞のリストの中にある動詞]の組み合わせとなります。 @@ -72,10 +72,10 @@ title: HTTP Request handler URL パターンは**接頭辞** として、あるいは**正規表現** を使用して定義することできます。 - - 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ +- 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ Ex: `"pattern" : "docs"` または `"pattern" : "docs/invoices"` - - 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 +- 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 礼: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" と "regexPattern" プロパティは同じハンドラー定義内で同時に使用することはできません(使用した場合、"regexPattern" プロパティのみが有効となります)。 @@ -84,8 +84,8 @@ URL パターンは**接頭辞** として、あるいは**正規表現** を使 URL パターンは以下の指定された順番に基づいてトリガーされます: - - 最初に合致したパターンが実行されます。 - - それ以降のパターンは、URL に合致していたとしても実行されません。 +- 最初に合致したパターンが実行されます。 +- それ以降のパターンは、URL に合致していたとしても実行されません。 結果として、ハンドラーを作成する際には正確な戦略を適用する必要があります。つまり、もっとも詳細なパターンを先に、そして最も一般的なパターンを後に書く必要があります。 @@ -117,17 +117,17 @@ URL パターンは以下の指定された順番に基づいてトリガーさ カスタムの HTTP ハンドラーでは、4D ビルトインのHTTP 処理機能に合致するURL パターンは許可されていません。 例えば、以下のようなパターンは管理することができません: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### クラスとメソッド 定義されたURL パターンを検知して割り込んだときに実行されるべきコードを宣言するためには、"class" および "method" プロパティを使用します。 - - "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 - - "method": クラスに属性ているクラス関数 +- "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 +- "method": クラスに属性ているクラス関数 リクエストハンドラーコードについての情報に関しては、[後述の説明](#リクエストハンドラーコード) を参照してください。 @@ -208,11 +208,11 @@ HTTP 動詞はまた、[リクエストハンドラーコード内で`.verb` プ この例においては、以下の関数を実装する必要があります: - - *GeneralHandling* クラス内の*handle 関数* - - *UsersHandling* クラス内の *manageAccount* - - *FinancialHandling* クラス内の *handleInvoices* - - *DocsHandling* クラス内の *handleDocs* - - *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* +- *GeneralHandling* クラス内の*handle 関数* +- *UsersHandling* クラス内の *manageAccount* +- *FinancialHandling* クラス内の *handleInvoices* +- *DocsHandling* クラス内の *handleDocs* +- *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* 以下はハンドラーをトリガーするURL の一例です: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md index fc43b1c77918f6..7ca46c9483d525 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ title: プリエンプティブWebプロセスの使用 | Web サーバー | コオペラティブ | *Web設定* | | Webサービスサーバー | コオペラティブ | *Web設定* | - - REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します - - Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します - - Web サービスサーバー: SOAPリクエストを処理します - - ***Web設定*** とは、プリエンプティブモード実行が設定によることを表します: +- REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します +- Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します +- Web サービスサーバー: SOAPリクエストを処理します +- ***Web設定*** とは、プリエンプティブモード実行が設定によることを表します: - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - それ以外の場合は、[**プリエンプティブプロセスを使用**](webServerConfig.md#プリエンプティブプロセスを使用) オプションが考慮されます。 - Webサービスプロセス (サーバーまたはクライアント) のプリエンプティブモードは、メソッドレベルでサポートされています。 公開済みの SOAPサーバーメソッド ([4Dで Web サービスを公開する](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.ja.html) 参照) あるいはプロキシクライアントメソッド ([4Dから Web サービスへサブスクライブする](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.ja.html) 参照) の "プリエンプティブプロセスで実行可能" プロパティをチェックし、メソッドがコンパイラーによってスレッドセーフと確認されるようにします。 @@ -35,21 +35,21 @@ title: プリエンプティブWebプロセスの使用 Webプロセスをプリエンプティモードで実行するには、Webサーバーで実行されるすべての 4Dコードがスレッドセーフでなければなりません。 [プリエンプティブモードが有効化](#webプロセスにおけるプリエンプティブモードの使用可能状況) されている場合、アプリケーションの以下の部分が 4Dコンパイラーによって自動的に評価されます: - - すべての Web関連データベースメソッド: +- すべての Web関連データベースメソッド: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) と [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) +- `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) - - Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) +- Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) - - "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 +- "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 - - "RESTリソースとして公開" 属性が有効なテーブルのトリガー +- "RESTリソースとして公開" 属性が有効なテーブルのトリガー - - REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) +- REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) これらそれぞれのメソッドとコードの部分について、スレッドセーフのルールが遵守されているかをコンパイラーがチェックし、問題があった場合にはエラーを返します。 スレッドセーフルールについての詳細は、[4Dランゲージリファレンス](https://doc.4d.com) マニュアルの *プロセス* の章の *スレッドセーフなメソッドの書き方* の段落を参照ください。 @@ -61,8 +61,8 @@ Web関連のほとんどの 4Dコマンドや関数、データベースメソ すべての Web関連コマンドはスレッドセーフです: - - *Webサーバー* テーマの全コマンド - - *HTTPクライアント* テーマの全コマンド +- *Webサーバー* テーマの全コマンド +- *HTTPクライアント* テーマの全コマンド Web関連のデータベースメソッドもスレッドセーフであり、プリエンプティモードで使用することが可能です (前述参照): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...)。 @@ -72,16 +72,16 @@ Web関連のデータベースメソッドもスレッドセーフであり、 以下の 4D WebサーバーURLはスレッドセーフであり、プリエンプティモードで使用可能です: - - *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) - - *4dcgi/* (呼び出されるデータベースメソッドもまたスレッドセーフでなければいけません) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) - - *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) +- *4dcgi/* (呼び出されるデータベースメソッドもまたスレッドセーフでなければいけません) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) ### プリエンプティブWebプロセスアイコン diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md index e29b9f3971684f..c0eb41ba981ab5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studioは、Webビジネスアプリケーションの開発に特化し Qodly Studio はフル機能の Web UI を提供し、以下のことを可能にします: - - キャンバス上にコンポーネントを配置して Qodlyページを作成する - - コンポーネントを Qodly Sources にマッピングする - - イベントを設定して 4Dコードをトリガーする - - さらに沢山のことが可能です +- キャンバス上にコンポーネントを配置して Qodlyページを作成する +- コンポーネントを Qodly Sources にマッピングする +- イベントを設定して 4Dコードをトリガーする +- さらに沢山のことが可能です ## 設定 @@ -24,19 +24,19 @@ Qodly Studio はフル機能の Web UI を提供し、以下のことを可能 Qodly Studio は、以下の Webブラウザーをサポートしています: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox 推奨解像度は 1920x1080 です。 #### 4Dアプリケーション - - 開発: 4D v20 R2 以上 - - 運用: 4D Server v20 R2 以上 - - Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 - - Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 - - Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 +- 開発: 4D v20 R2 以上 +- 運用: 4D Server v20 R2 以上 +- Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 +- Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 +- Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 ### Qodly Studio へのアクセスを有効化する @@ -46,8 +46,8 @@ Qodly Studioは、[WebAdmin Webサーバー](../Admin/webAdmin.md) によって Qodly Studio へのアクセスを有効化するには、2つのレベルで明示的に許可する必要があります: - - 4Dアプリケーションレベルで - - プロジェクトレベルで +- 4Dアプリケーションレベルで +- プロジェクトレベルで 2つのレベルのいずれか (または両方) が有効でない場合、Qodly Studio　へのアクセスは拒否されます (403ページが返されます)。 @@ -79,8 +79,8 @@ WebAdmin Webサーバーでの認証には、アクセスキーを使用しま 4Dプロジェクトの管理上、以下の使用法のみがサポートされます: - - Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 - - Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 +- Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 +- Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 :::warning @@ -94,10 +94,10 @@ Qodly Studio ページは、[WebAdmin Webサーバーが起動されており](. Qodly Studio にアクセスするには 2つの方法があります: - - **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 +- **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 WebAdmin Webサーバーがすでに起動されている場合は、その設定に応じて、デフォルトのブラウザーが `IPaddress:HTTPPort/studio` または `IPaddress:HTTPSPort/studio` を開きます。 それ以外の場合は、最初に WebAdmin Webサーバーを起動するかどうかを尋ねるメッセージが表示されます。 - - 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
+- 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
`IPaddress:HTTPPort/studio` または: @@ -145,24 +145,24 @@ Qodlyページを利用した Webアプリケーションを開発するには 以下のコマンドとクラスは、Qodlyページのサーバーサイド管理に特化しています: - - [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 - - [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 - - [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 - - [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 +- [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 +- [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 +- [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 +- [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 ### プロジェクトメソッドを使用する 推奨される方法は、プロジェクトメソッドではなく、クラス関数を使用することです。 コンポーネントから呼び出すことが可能なのは、クラス関数のみです。 それでも、次の 2つの方法で、Qodly Studio でもプロジェクトメソッドを使用できます: - - クラス関数からメソッドを呼び出すことができます。 - - Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 +- クラス関数からメソッドを呼び出すことができます。 +- Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 ### オフラインでの使用 コンピュータがインターネットに接続されていない状態でも、Qodly Studio を使って開発することができます。 ただしこの場合、以下の機能は使用できません: - - [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 - - UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 +- [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 +- UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 ## 運用 @@ -178,8 +178,8 @@ Qodly で Qodlyページをレンダリングする方法の詳細について Qodlyページのレンダリングを有効にするには、以下のオプションを設定する必要があります。 - - 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 - - [4D Webサーバー](webServer.md) を起動しておく必要があります。 +- 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 +- [4D Webサーバー](webServer.md) を起動しておく必要があります。 :::note @@ -309,9 +309,9 @@ End if Webユーザーセッションからログアウトアクションをトリガーすると、次のような効果があります: - - カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 - - 関連する 4Dライセンスが解放されます。 - - `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 +- カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 +- 関連する 4Dライセンスが解放されます。 +- `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 ## レンダリングのためのライセンス消費について @@ -363,7 +363,7 @@ Qodly Studio のユーザー設定で、レンダラーのポップオーバー 必要以上のライセンスを使用しないため、次のいずれかをお勧めします: - - 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 - - Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 - - プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 +- 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 +- Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 +- プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md index d2afc2319f0170..2b30a136bc6766 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md @@ -19,16 +19,16 @@ title: テンプレートページ 以下の 4Dタグを使用することができます: - - 4DTEXT: 4D変数および式をテキストとして挿入します。 - - 4DHTML: HTMLコードを挿入します。 - - 4DEVAL: 4D式を評価します。 - - 4DSCRIPT: 4Dメソッドを実行します。 - - 4DINCLUDE: ページを他のページに含めます。 - - 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 - - 4DCODE: 4Dコードを挿入します。 - - 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 - - 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 - - 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 +- 4DTEXT: 4D変数および式をテキストとして挿入します。 +- 4DHTML: HTMLコードを挿入します。 +- 4DEVAL: 4D式を評価します。 +- 4DSCRIPT: 4Dメソッドを実行します。 +- 4DINCLUDE: ページを他のページに含めます。 +- 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 +- 4DCODE: 4Dコードを挿入します。 +- 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 +- 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 +- 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 これらのタグについては、[変換タグ](../Tags/transformation-tags.md) のページで説明しています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md index 38e67795f1a74d..b619a12bbf322b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ title: 管理 4D Webサーバーは複数の方法で起動できます: - - ボタン/メニューコマンドの使用。 +- ボタン/メニューコマンドの使用。 - 4D: **実行 ＞ Webサーバー開始** メニュー
![](../assets/en/WebServer/start1.png) - 4D Server: HTTPサーバーページの **HTTPサーバー開始** ボタン
![](../assets/en/WebServer/start2.png) - - 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) +- 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) - - [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 +- [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して [`webServer.start()`](API/WebServerClass.md#start) 関数を呼び出すことで開始できます。 @@ -29,9 +29,9 @@ title: 管理 4D Webサーバーは複数の方法で停止できます: - - 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 +- 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 - - [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 +- [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して `webServer.stop()` 関数を呼び出すことで停止できます。 @@ -53,8 +53,8 @@ title: 管理 これをおこなうには: - - 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 - - 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 +- 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 +- 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 キャッシュは即座にクリアされます。 @@ -64,11 +64,11 @@ title: 管理 Webサーバーに関連する情報は、ランタイムエクスプローラーにある **ウォッチ** ページ (**Web** 項目内) に表示されます。 - - **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 +- **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 - - **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 - - **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 ## 管理用 URL @@ -123,8 +123,8 @@ Webサイト管理用の URL を使用して、サーバー上に公開してい 4Dでは、Webリクエストのログを2種類作成することができます: - - Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 - - おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 +- Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 +- おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 両方のログファイルは、アプリケーションプロジェクトの **Logs** フォルダーに自動的に作成されます。 @@ -223,15 +223,15 @@ logweb.txt の自動バックアップパラメーターは、ストラクチャ 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md index 99dc96b95b64e9..1329d256534062 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ CORSサービスで許可されたホストとメソッドの一覧。 CORS を介したサーバーへのデータリクエスト送信が許可されている外部ページのドメイン名または IPアドレス。 複数のドメインを追加してホワイトリストを作成することができます。 複数のシンタックスがサポートされています: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### 許可された HTTPメソッド (methodsプロパティ) 対応する CORSホストに対して許可する HTTPメソッド。 以下の HTTPメソッドがサポートされます: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH メソッド名はセミコロン区切りで指定します(例: "post;get")。 methods が空、null、あるいは undefined の場合、すべてのメソッドが許可されます。 @@ -145,9 +145,9 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" デフォルトホームページを変更するには、パスを "デフォルトホームページ" エリアに入力します。 - - パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 +- パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 たとえば、デフォルトHTMLルートフォルダー内の "Web" サブフォルダーにある "MyHome.htm" をデフォルトホームページにする場合、"Web/MyHome.htm" と入力します。 @@ -318,15 +318,15 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。 デフォル #### IPv6 のサポートについて - - **TCPポートが使用済みでも警告は出ません**
+- **TCPポートが使用済みでも警告は出ません**
サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。 しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - - **IPv4-マップされた IPv6アドレス**
+- **IPv4-マップされた IPv6アドレス**
プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。 これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 - - **ポート番号の表記**
+- **ポート番号の表記**
IPv6 記法はコロン (:) を使用するので、ポート番号を追加するときには混乱を招く恐れがあることに注意が必要です。たとえば: ```code4d @@ -422,10 +422,10 @@ Webサーバーに処理を許可する HTTPリクエスト (POST) の最大サ とりうる値: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (デフォルト) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (デフォルト) +- 4 = TLSv1_3 変更した場合、設定を反映するには Webサーバーを再起動する必要があります。 @@ -492,10 +492,10 @@ User-Agent: Disallow: /GIFS/ ``` - - "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 - - "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 +- "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 +- "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 他の例題: @@ -520,15 +520,15 @@ User-Agent: デフォルトで、4D は **WebFolder** という名前のデフォルトHTMLルートフォルダーを定義します。 Webサーバーの初回起動時にこのフォルダーが存在しなければ、HTMLルートフォルダーは物理的にディスク上に作成されます。 ルートフォルダーは以下の場所に作成されます: - - 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 - - 4Dリモートモードでは、ローカルのリソースフォルダー内 +- 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 +- 4Dリモートモードでは、ローカルのリソースフォルダー内 デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 - - このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 - - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 +- パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 @@ -583,9 +583,9 @@ User-Agent: 次の値が提供されています: - - "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 - - "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 - - "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 +- "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 +- "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 +- "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 セッションcookie の `Secure` 属性値は、HTTPS接続の場合には (`SameSite` 属性値が何であれ)、自動的に "True" に設定されます。 @@ -629,9 +629,9 @@ User-Agent: Keep-Alive接続を設定する 2つのオプションがあります: - - **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

+- **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 Once this period is over, the server closes the connection.

+- **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 Once this period is over, the server closes the connection.

接続が閉じられた後に Webブラウザーがリクエストを送信すると、新しい TCP接続が作成されます。 この動作はユーザーからは見えません。

diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md index 7547efe4bdb500..d2d2e6060b87d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md @@ -7,9 +7,9 @@ title: Webサーバーオブジェクト たとえば、メインアプリケーションに 2つのコンポーネントをインストールしている場合、アプリケーションから最大 3つの独立した Webサーバーを起動して監視することができます: - - ホストアプリケーションの Webサーバーを1つ - - コンポーネント#1 の Webサーバーを1つ - - コンポーネント#2 の Webサーバーを1つ +- ホストアプリケーションの Webサーバーを1つ +- コンポーネント#1 の Webサーバーを1つ +- コンポーネント#2 の Webサーバーを1つ 1つの 4Dアプリケーションプロジェクトに接続できるコンポーネントの数、つまり Webサーバーの数には、メモリ以外の制限はありません。 @@ -19,9 +19,9 @@ title: Webサーバーオブジェクト 各 Webサーバー (ホストアプリケーションまたはコンポーネント) は、個別のコンテキストで使用できます。これには、以下が含まれます: - - `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し - - 4Dタグの処理とメソッドの呼び出し - - Webセッションや TLSプロトコルの管理 +- `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し +- 4Dタグの処理とメソッドの呼び出し +- Webセッションや TLSプロトコルの管理 これにより、独自の Webインターフェースを備えた独立したコンポーネントや機能を開発することができます。 @@ -49,8 +49,8 @@ webServer:=WEB Server(Web server database) アプリケーションがコンポーネントを使用している場合に: - - コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や - - リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 +- コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や +- リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 次を使うこともできます: @@ -97,8 +97,8 @@ A web server object contains [various properties](API/WebServerClass.md../comman 2. 上を使用しない場合は、`WEB SET OPTION` コマンドを使用して定義します (ホストアプリケーションのみ)。 3. 上を使用しない場合は、ホストアプリケーションまたはコンポーネントの設定で定義します。 - - Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 - - Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 +- Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 +- Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 > *isRunning*、*name*、*openSSLVersion*、*perfectForwardSecrecy* は読み取り専用のプロパティで、[`start()`](API/WebServerClass.md#start)関数の `settings` オブジェクトパラメーターで事前に定義することはできません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md index 75a443b6172d1b..9de16429321acb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) +- 4D Write Pro ドキュメント *breakType* 引数には、*4D Write Pro 定数* テーマから以下の定数のどれか一つを渡し、挿入するブレークのタイプを定義します: @@ -47,7 +47,7 @@ displayed_sidebar: docs | wk prepend | Integer | 1 | コンテンツをターゲットの始めに挿入する | | wk replace | Integer | 0 | ターゲットのコンテンツを置き換える | - - *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: +- *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: | 定数 | 型 | 値 | 説明 | | --------------------- | ------- | - | ------------------------------------------------- | @@ -56,7 +56,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md index 7d89b03a109738..f0e5c9d984ab9e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) +- 4D Write Pro ドキュメント 挿入する*wpDoc* 引数のドキュメントには、 [WP New](../commands-legacy/wp-new.md) コマンドまたは [WP Import document](wp-import-document.md) コマンドを使用して作成した任意の4D Write Pro ドキュメントオブジェクトを指定可能です。 本文の子要素のみが挿入されます(つまり、ヘッダー、フッター、テキストボックスおよびアンカーされたピクチャーは挿入されません)。 指定されたレンジのセクションおよびブックマークは保存されます。 これに加え、要素はコピーされるので、*wpDoc* 引数の内容はその後再利用することが可能です。 @@ -54,7 +54,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/writeprointerface.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/writeprointerface.md index 85580bde44bd29..f6ecccc168c52c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/writeprointerface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WritePro/writeprointerface.md @@ -11,8 +11,8 @@ title: 4D WritePro インターフェース You will find below: - - the Table Wizard configuration documentation, - - the integrated A.I. ドキュメント. +- the Table Wizard configuration documentation, +- the integrated A.I. ドキュメント. ## 表ウィザード @@ -60,9 +60,9 @@ You will find below: テンプレートの設定には以下が含まれます: - - [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 - - [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 - - [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 +- [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 +- [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 +- [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 表ウィザードを設定するにあたって、これら 3種類のファイルにはそれぞれ明確な役割がありますが、いずれも必須ではありません。 @@ -70,10 +70,10 @@ You will find below: テンプレートファイルを使って、以下のことが定義できます: - - 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ - - ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) - - 表の列として使用できるデータクラス属性 - - ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ +- 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ +- ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) +- 表の列として使用できるデータクラス属性 +- ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ テンプレートファイルはプロジェクトの "[`Resources`](../Project/architecture.md#resources)/4DWP_Wizard/Templates" フォルダーに保存する必要があります。 @@ -318,11 +318,11 @@ The 4D Write Pro interface uses OpenAI, for which you need to provide your own k In the current implementation, the feature has the following limitations: - - use of a predefined AI provider and necessity to pass your OpenAI key - - basic chatting features - - no image handling - - non-configurable predefined action commands - - predefined translations English/French and French/English only +- use of a predefined AI provider and necessity to pass your OpenAI key +- basic chatting features +- no image handling +- non-configurable predefined action commands +- predefined translations English/French and French/English only ### Enabling the AI feature @@ -349,8 +349,8 @@ The **A.I.** button is then displayed: ![ai button](../assets/en/WritePro/ai-button.png) - - in the 4D Write Pro Toolbar, in the **Import Export** tab, - - in the 4D Write Pro Widget, in the **Font Style** tab. +- in the 4D Write Pro Toolbar, in the **Import Export** tab, +- in the 4D Write Pro Widget, in the **Font Style** tab. Click on the button to display the AI dialog box. @@ -388,8 +388,8 @@ These buttons propose basic interactions between the chat area, the underlying 4 ![ai interaction](../assets/en/WritePro/ai-interaction.png) - - **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. - - **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. +- **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. +- **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. In both cases, if the response was provided with styles, you can decide to copy the text with or without styles. diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsAPI.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsAPI.md index 890650dff4ae31..f21fd7a85be26c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsAPI.md @@ -5,7 +5,7 @@ title: OpenAIEmbeddingsAPI # OpenAIEmbeddingsAPI -The `OpenAIEmbeddingsAPI` provides functionalities to create embeddings using OpenAI's API. +`OpenAIEmbeddingsAPI` はOpenAI のAPI を使用して埋め込みを作成する機能を提供します。 https://platform.openai.com/docs/api-reference/embeddings @@ -15,38 +15,38 @@ https://platform.openai.com/docs/api-reference/embeddings **create**(*input* : Text; *model*: Text; *parameters* : OpenAIEmbeddingsParameters) : OpenAIEmbeddingsResult -Creates an embeddings for the provided input, model and parameters. +提供された入力、モデル、パラメータに対する埋め込みを作成します。 -| 引数 | 型 | 説明 | -| ------------ | ----------------------------------------------------------- | --------------------------------------------------------------------------------------- | -| *input* | Text or Collection of Text | The input to vectorize. | -| *model* | Text | The [model to use](https://platform.openai.com/docs/guides/embeddings#embedding-models) | -| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | The parameters to customize the embeddings request. | -| 戻り値 | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | The embeddings. | +| 引数 | 型 | 説明 | +| ------------ | ----------------------------------------------------------- | --------------------------------------------------------------------- | +| *input* | テキストまたはテキストのコレクション | ベクター化する入力。 | +| *model* | Text | [使用するモデル](https://platform.openai.com/docs/guides/embeddings#埋め込みモデル) | +| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | 埋め込みリクエストをカスタマイズするための引数。 | +| 戻り値 | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | 埋め込み。 | -#### Example Usages +#### 使用例 -##### Get vector for a single text entry +##### 単一のテキスト入力に対するベクトルを取得 ```4d var $result:=$client.embeddings.create("it rains cats and dogs"; "text-embedding-ada-002") var $vector: 4D.Vector:=$result.vector -// or var $embedding: cs.AIKit.OpenAIEmbedding:=$result.embedding +// あるいは var $embedding: cs.AIKit.OpenAIEmbedding:=$result.embedding ``` -##### Get vectors for a collection of text entries +##### テキスト入力のコレクションに対するベクトルを取得 ```4d var $inputs:=["it rains cats and dogs"; "il pleut à boire debout"] var $result:=$client.embeddings.create($inputs; "text-embedding-ada-002") -var $vectors : Collection:=$result.vectors // collection of 4D.Vector +var $vectors : Collection:=$result.vectors // 4D.Vector のコレクション ``` -##### Using another service +##### 他のサービスを使用する -> Before using embeddings with a specific service, please check its documentation to see if embeddings are supported, and select the appropriate embedding model. +> 埋め込みを特定のサービスで使用する前に、そのドキュメンテーションをチェックして埋め込みがサポートされているかを確認し、適切な埋め込みモデルを選択するようにしてください。 -For example, for Mistral, use [mistral-embed or codestral-embed](https://docs.mistral.ai/capabilities/embeddings/) +例えば、Mistral に対しては、[mistral-埋め込みあるいはcodestral-埋め込み](https://docs.mistral.ai/capabilities/embeddings/) を使用してください ```4d var $result:=$client.embeddings.create($inputs; "mistral-embed") diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsParameters.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsParameters.md index 6c97341a628207..20b34c02ab6664 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsParameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsParameters.md @@ -5,7 +5,7 @@ title: OpenAIEmbeddingsParameters # OpenAIEmbeddingsParameters -The `OpenAIEmbeddingsParameters` class is designed to configure and manage the parameters used for creating embeddings through the OpenAI API. +`OpenAIEmbeddingsParameters` クラスは、OpenAI API を通して埋め込みを作成するのに使用する引数を設定して管理するために設計されています。 ## 継承元 @@ -13,10 +13,10 @@ The `OpenAIEmbeddingsParameters` class is designed to configure and manage the p ## プロパティ -| プロパティ名 | 型 | 説明 | -| ----------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `encoding_format` | Text | The format to return the embeddings in. Can be either `float` or `base64`. (default: `float`) | -| `dimensions` | Integer | The number of dimensions the resulting output embeddings should have. Only supported in text-embedding-3 and later models. | +| プロパティ名 | 型 | 説明 | +| ----------------- | ------- | ------------------------------------------------------------------------------------------------------ | +| `encoding_format` | Text | 埋め込みを返すフォーマット。 `float` あるいは `base64` のいずれかを指定できます。 (デフォルト: `float`) | +| `dimensions` | Integer | 出力結果の埋め込みが持つべき次元の数。 text-embedding-3 あるいはそれ以降のモデルでのみサポートされています。 | ## 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsResult.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsResult.md index 2d112d248a64a4..7b8589326bcd8e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsResult.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIEmbeddingsResult.md @@ -13,7 +13,7 @@ title: OpenAIEmbeddingsResult | プロパティ | 型 | 説明 | | ------------ | ------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| `model` | Text | Returns the model used to compute the embedding | +| `model` | Text | 埋め込みを計算するのに使用されたモデルを返します | | `vector` | `4D.Vector` | Returns the first `4D.Vector` from the `vectors` collection. | | `vectors` | Collection | Returns a collection of `4D.Vector`. | | `embedding` | [OpenAIEmbedding](OpenAIEmbedding.md) | Returns the first [OpenAIEmbedding](OpenAIEmbedding.md) from the `embeddings` collection. | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/command-index.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/command-index.md index 2e6fdc648d5d0f..205bf7a83d636f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/command-index.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/command-index.md @@ -350,7 +350,7 @@ title: インデックス [`Generate digest`](../commands-legacy/generate-digest.md)
[`GENERATE ENCRYPTION KEYPAIR`](../commands-legacy/generate-encryption-keypair.md)
[`Generate password hash`](../commands-legacy/generate-password-hash.md)
-[`Generate UUID`](../commands-legacy/generate-uuid.md)
+[`Generate UUID`](./generate-uuid.md) **modified 4D 20 R10**
[`Get 4D file`](../commands-legacy/get-4d-file.md)
[`Get 4D folder`](../commands-legacy/get-4d-folder.md)
[`Get adjusted blobs cache priority`](../commands-legacy/get-adjusted-blobs-cache-priority.md)
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md index 833421870ace19..e92524d0ba8f15 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form-event.md @@ -37,8 +37,8 @@ displayed_sidebar: docs イベントオブジェクトには、イベントが発生したオブジェクト によっては追加のプロパティが含まれていることがあります。 これは以下のオブジェクトで生成された *eventObj* オブジェクトが対象です: - - リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 - - 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 +- リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 +- 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 ***注意:*** カレントのイベントが何もない場合、**FORM Event** はnull オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form.md index d81d577a43755d..dca05da91f65e4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/form.md @@ -26,30 +26,30 @@ displayed_sidebar: docs **Form** コマンドはカレントフォームに割り当てられている( *formData* 引数、またはフォームエディターで割り当てられたユーザークラスによってインスタンス化された) オブジェクトを返します。 4D は以下の場合にはカレントフォームに自動的にオブジェクトを割り当てます: - - カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 - - カレントフォームがサブフォームである場合。 - - テーブルフォームが現在画面上に表示されている場合。 +- カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 +- カレントフォームがサブフォームである場合。 +- テーブルフォームが現在画面上に表示されている場合。 ### コマンド(DIALOGなど) カレントのフォームが[DIALOG](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドによって表示あるいはロードされていた場合、は以下のいずれかのものを返します: - - コマンドに引数として渡された*formData* オブジェクト(あれば)。 - - [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 - - または、空のオブジェクト。 +- コマンドに引数として渡された*formData* オブジェクト(あれば)。 +- [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 +- または、空のオブジェクト。 ### サブフォーム カレントフォームがサブフォームの場合、返されるオブジェクトは親コンテナ変数に依存します: - - 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ +- 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ この場合、**Form** から返されるオブジェクトは、以下の式から返されるものと同じになります : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 +- 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 より詳細な情報については、*サブフォームページ* の章を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md new file mode 100644 index 00000000000000..0ee9b18e71c2e0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| 引数 | 型 | | 説明 | +| ------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| 戻り値 | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
履歴 + +| リリース | 内容 | +| ------ | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## 説明 + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form。 + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## 例題 + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## プロパティ + +| | | +| ------- | --------------------------- | +| コマンド番号 | 1066 | +| スレッドセーフ | ✓ | + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md index 352fff791b636b..7b6bd571dad62d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md @@ -39,14 +39,14 @@ displayed_sidebar: docs 以下のサポートされる型であれば、いくつでも値を渡すことができます: - - 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 - - text - - boolean - - date - - 時間 (ミリ秒の数 (実数) として保存されます)。 - - null - - 共有オブジェクト - - 共有コレクション +- 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 +- text +- boolean +- date +- 時間 (ミリ秒の数 (実数) として保存されます)。 +- null +- 共有オブジェクト +- 共有コレクション :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md index cdb231ed9fe273..f80d1bd1b2f9c9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs *form* 引数には、以下のいづれかを渡すことができます: - - フォーム名 - - 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) - - フォームの詳細を格納しているオブジェクト +- フォーム名 +- 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) +- フォームの詳細を格納しているオブジェクト **Print form** は、 フォームの印刷後に改ページを行わないため、同じページに異なるフォームを容易に配置することができます。 したがって、**Print form** は、異なるテーブルや異なるフォームを含む複雑な印刷処理に最適です。 フォーム間で改ページを強制的に行うには[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用してください。 印刷可能領域を超える高さのフォームの印刷を次のページに持ち越すには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用する前に[CANCEL](../commands-legacy/cancel.md) コマンドを呼び出してください。 3つの異なるシンタックスを使用できます: - - **詳細エリアの印刷** +- **詳細エリアの印刷** シンタックス: @@ -43,7 +43,7 @@ displayed_sidebar: docs この場合、**Print form** はフォームの詳細エリア (ヘッダマーカと詳細マーカの間のエリア) だけを印刷します。 - - **フォームエリアの印刷** +- **フォームエリアの印刷** シンタックス: @@ -79,7 +79,7 @@ displayed_sidebar: docs | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **セクション印刷** +- **セクション印刷** シンタックス: @@ -101,8 +101,8 @@ form data オブジェクトについての詳細な情報については、[`DI **Print form** を使用する場合、印刷ダイアログボックス は表示されません。 レポート はデザインモードでフォームに割り当てられた用紙設定を使用しません。 **Print form** を呼び出す前に用紙設定を指定する方法は2通りあります: - - [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 - - [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 +- [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 +- [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 **Print form** は、印刷するページをそれぞれメモリ 中に作成します。 各ページはメモリ中のページがいっぱいになるか、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを実行すると印刷されます。 **Print form** の使用後、最後のページの印刷を確実に行うためには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドで終了しなければなりません(ただし [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md) のコンテキスト内の場合を除く、注意参照)。 そうでないと、最後のページが一杯にならないと、それはメモリ中に残り印刷されません。 @@ -116,8 +116,8 @@ form data オブジェクトについての詳細な情報については、[`DI **4D Server:** このコマンドは、ストアドプロシージャのフレームワークにおいて4D Server 上で実行することができます。 この状況では、次の制約があります: - - サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 - - プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 +- サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 +- プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md index a9bafc2eb7a12a..6ba3012ac1915d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md @@ -44,7 +44,7 @@ displayed_sidebar: docs | type | Integer | 実行中のプロセスタイプ。 取り得る値: 以下を参照のこと 取り得る値: 以下を参照のこと | | visible | Boolean | 表示であればTrue、それ以外はFalse | - - "state" の取り得る値: +- "state" の取り得る値: | 定数 | 値 | | ------------------------- | ---- | @@ -57,7 +57,7 @@ displayed_sidebar: docs | Waiting for internal flag | 4 | | Paused | 5 | - - "type" の取り得る値: +- "type" の取り得る値: | 定数 | 値 | | ----------------------------- | --- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/session.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/session.md index 1f014a7e3bac76..3a0c9b3473fb57 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/session.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### 参照 +## 参照 [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md index a62147d8ec3ed3..61188207ee5d30 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md @@ -12,7 +12,7 @@ slug: /commands/theme/Tools | [](../../commands-legacy/choose.md)
| | [](../../commands-legacy/generate-digest.md)
| | [](../../commands-legacy/generate-password-hash.md)
| -| [](../../commands-legacy/generate-uuid.md)
| +| [](../generate-uuid.md)
| | [](../../commands-legacy/get-macro-parameter.md)
| | [](../../commands-legacy/launch-external-process.md)
| | [](../../commands-legacy/load-4d-view-document.md)
| diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md index 9e655afbe3bf37..2685d066293b71 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md @@ -13,8 +13,8 @@ title: クライアント-サーバーページ このオプションを使用して、起動された 4D Server データベースが公開データベースのリストに表示されるかどうかを指定できます。 - - このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 - - このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 +- このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 +- このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 :::note @@ -49,10 +49,10 @@ TCPプロトコルを使用して、1台のマシン上で複数の 4Dアプリ 4D Server は 3つの TCPポートを使用して、内部サーバーとクライアントの通信をおこないます: - - **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 - - **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 - - **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 - - [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 +- **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 +- **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 +- **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 +- [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 #### ドメインサーバーによるユーザーの認証 @@ -66,9 +66,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 ここでは、ドロップダウンメニューにて 3つのネットワークオプションから選択できます: **Legacy**、**ServerNet** 、**QUIC** (プロジェクトモードのみ)。ネットワークレイヤーは、4D Server とリモートの 4Dマシン (クライアント) 間の通信を管理するのに使用されます。 - - **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. - - **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 - - **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 +- **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. +- **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 +- **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 **注**: @@ -108,9 +108,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 この設定は、データベースの **Resources** フォルダーがセッション中に更新された場合について、接続中のクライアントマシンにおける同フォルダーのローカルインスタンスの更新モードを包括的に指定します (**Resources** フォルダーは、セッションが開かれるたびにリモートマシン上で自動的に同期されます)。 3つの選択肢があります: - - **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 - - **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. +- **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 +- **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. ## IP設定ページ @@ -122,10 +122,10 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 設定表の動作は以下のとおりです: - - "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 - - "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 - - ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 - - セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: +- "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 +- "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 +- ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 +- セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: - 拒否 192.168.\* (192.168 で始まるアドレスを拒否) - 許可 \* (他のアドレスはすべて許可) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md index d30b7b374f9051..615332b6bd44c8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md @@ -8,10 +8,10 @@ title: 互換性ページ > 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。\ > このページでは、v18以降のバージョンから変換された 4Dデータベース/プロジェクトで利用可能な互換性オプションのみを説明します。 それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 - - **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 +- **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 **注:** このオプションは、`SET DATABASE PARAMETER` コマンドを使い、プログラミングによって管理することもできます。 - - **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: +- **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: - 最初の "/" はルートノードに限らない - "/" を XPath 式の最初の文字として使用しても、ルートノードからの絶対パスの宣言にはなりません。 - 暗示的なカレントノードはなし - カレントノードは XPath 式の中に含められていなければなりません。 @@ -19,12 +19,12 @@ title: 互換性ページ 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 +- **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 - - **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 +- **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 - - **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file +- **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/database.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/database.md index 6fdcedfc30f7ea..f046935095106c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/database.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/database.md @@ -17,10 +17,24 @@ title: データベースページ このオプションを選択しないかぎり、ロックされたデータファイルを開くことはできません (4Dデータベースのデフォルト動作)。 -#### ロックされたファイルについて +:::info ロックされたファイルについて ロックされたファイルは読むことはできても内容を変更することはできません。 たとえば (DVDのような) 編集不可のメディアに格納されたファイルや、このようなメディアからコピーされたファイルは、ロックされていることがあります。 DVDに格納されたプロジェクトを使用するような場合、ロックされたデータファイルを使用できるようアプリケーションを設定することができます。 しかしこの場合、データの追加・編集が保存されないロックされているデータファイルを不注意に使用してしまうリスクがあります。 このような状況にならないよう、4D ではデフォルトでロックされたデータファイルを開くことを禁止しています。 +::: + +#### Auto UUID version + +[UUID version](https://en.wikipedia.org/wiki/Universally_unique_identifier) to use for 4D fields with [automatic UUID generation option](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106195). Available values are **4** (default) and **7**. + +This setting only applies to UUIDs generated afterwards. Already saved auto UUIDs fields are not recomputed. + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + ### テンポラリフォルダーの場所 このエリアでは、4D 実行中に作成されるテンポラリーファイルの場所を設定できます。 テンポラリファイルのフォルダーは、一時的にメモリ中のデータをディスクに保存するために必要に応じてアプリケーションが使用します。 @@ -31,9 +45,9 @@ title: データベースページ 3つのオプションから選択できます: - - **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 - - **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 - - **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 +- **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 +- **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 +- **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +55,7 @@ title: データベースページ > これらのオプションのいずれかを変更した場合、新しい設定を反映するにはアプリケーションを終了し、再起動しなければなりません。 データベースが再び開かれると、すべてのインデックスが自動で再作成されます。 - - **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 +- **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). このオプションが選択されている場合、単語内にある "@" は普通の文字として扱われます。 この設定は、"@" が文字列内で使用される電子メールアドレスの検索などに有効です。 このオプションは検索、並び替え、文字列比較、およびテーブルに格納されるデータや配列などメモリ中のデータに影響を与えます。 (インデックス付きか否かにかかわらず) 文字型やテキスト型のフィールドおよび変数が、検索や並び替え時に "@" 文字がどのように解釈されるかの影響を受けます。 @@ -52,19 +66,19 @@ title: データベースページ - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - セキュリティの理由で、データベースの Administrator または Designer のみがこのパラメーターを変更できます。 - - **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 +- **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 つまり、4Dプロジェクトはシステム言語とは異なる言語で動作することができます。 プロジェクトが開かれるとき、4Dエンジンはデータファイルに使用されている言語を検知し、(インタープリターやコンパイルモードの) ランゲージに提供します。 データベースエンジン、あるいはランゲージのいずれがテキスト比較をおこなうかに関わらず、同じ言語が使用されます。 > 4D環境設定でも言語を設定できます ([一般ページ](../Preferences/general.md) 参照)。 この場合、その設定は新規に作成されるデータベースに適用されます。 - - **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 +- **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 このアルゴリズムは、文字列中をダブルクリックしたときに選択範囲を決定するためワープロソフトが使用するものと同じです。 このアルゴリズムに関する詳細は以下の Webページを参照ください: `http://userguide.icu-project.org/boundaryanalysis`。 このオプションが選択されている場合、4D は簡易的なアルゴリズムを使用します。 この設定では、文字でも数字でもない文字がキーワード区切り文字として扱われます。 この設定は日本語など特定の言語の要求に沿うものです。 - - **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 +- **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 #### MeCab のサポート (日本語版) @@ -82,7 +96,7 @@ title: データベースページ ### データベースキャッシュ設定 - - **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 +- **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 - **他のアプリケーションとシステムのために予約するメモリ**: システムや他のアプリケーションが使用するために取り置く RAMメモリ量。 4D が実行されるマシン上で他のアプリケーションも実行する場合、必要に応じてこの値を増やします。 - **利用可能なメモリからキャッシュに使用する率**: 残りのメモリからキャッシュに割り当てる量の率。\ デフォルトでキャッシュに割り当てるサイズを取得するためには、以下の計算式を適用します: (物理メモリ – 予約したメモリ) X キャッシュに使用するメモリのパーセンテージ。 動的に計算するモードの場合、キャッシュメモリのサイズはアプリケーションやシステムのニーズに応じて動的に変化します。 以下のオプションを使用して上限と下限を設定できます: @@ -93,11 +107,11 @@ title: データベースページ ![](../assets/en/settings/memory-maximum-size.png) - - **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 +- **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 入力されたキャッシュサイズは、マシンのリソース状況にかかわらず、4Dデータベース用に予約されます。 この設定は、メモリ搭載量が分かっているなど、特定の状況で使用できます。 ほとんどのケースで起動時計算モードのキャッシュで良いパフォーマンスが提供されます。 - - **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 +- **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 4D はキャッシュ中のデータを定期的に保存します。 この間隔を 1秒から 500分の範囲で設定できます。 デフォルトの設定値は 20秒です。 この保存は、キャッシュがいっぱいになった場合や、アプリケーションを終了する際にもおこなわれます。 You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. 大量のデータ入力が予期される場合は、この間隔を短くすることを検討してください。 停電などの理由でマシンが停止すると、前回の保存以降に入力されたデータが失われてしまいます (データログファイルをとっていれば復旧可能です)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md index f594bc8dd9dfce..541023abd9f72a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md @@ -23,9 +23,9 @@ title: インターフェースページ 他のオプションでは、アプリケーションモードでのさまざまなウィンドウの表示を設定します。 - - **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 +- **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 - - **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 +- **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 :::note @@ -33,9 +33,9 @@ title: インターフェースページ ::: - - **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 +- **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 - - **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: +- **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: ![](../assets/en/settings/sdi-mdi.png) @@ -53,16 +53,16 @@ title: インターフェースページ 以下のスキームが利用可能です: - - **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) - - **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) - - **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 +- **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) +- **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) +- **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 > デフォルトのテーマは CSS で管理可能です。 詳細については、[メディアクエリ](../FormEditor/createStylesheet.md#メディアクエリ) を参照してください。 メインアプリケーションスキームはデフォルトでフォームに適用されます。 その一方で、それを以下の方法で上書きすることもできます: - - by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; - - 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 +- by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; +- 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 ## ショートカット @@ -70,9 +70,9 @@ title: インターフェースページ デフォルトのショートカットは以下のとおりです: - - 入力フォーム確定: **Enter** - - 入力フォームキャンセル: **Esc** - - サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) +- 入力フォーム確定: **Enter** +- 入力フォームキャンセル: **Esc** +- サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) 操作のショートカットを変更するには、対応する **編集** ボタンをクリックします。 以下のダイアログボックスが表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/security.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/security.md index 184f91d21ab268..1233c3e1338e45 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/security.md @@ -11,7 +11,7 @@ title: セキュリティページ > これらの設定は、シングルユーザーモードで開かれたプロジェクトデータベースには適用されません。 - - **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 +- **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 注: @@ -19,21 +19,21 @@ title: セキュリティページ - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 +- **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 このオプションを使用することで、完全なデータコントロールシステムを維持しつつ、データベースへのアクセスをシンプルにすることができます。 - デフォルトユーザーにパスワードを割り当てた場合、データベースが開かれるときにダイアログが表示され、パスワードの入力を求められます。 - デフォルトユーザーにパスワードを割り当てない場合、上記のダイアログは表示されません。
**注:** "デフォルトユーザー" モードが有効になっているときでも、強制的にユーザー認証ダイアログを表示させることができます。これはたとえば Administrator や Designer としてログインするために必要となります。 これには、データベースを開いたり接続したりする際に **Shift**キーを押したままにします。 - - **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **ユーザーリストをABC順で表示する** (上記オプションが選択されているときのみ有効です): このオプションが選択されていると、ユーザー認証ダイアログボックスのユーザーリストは名前の ABC順に表示されます。 - - **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 +- **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 ## オプション - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. 以下のオプションを使用して、部分的あるいは全体的にこのフィルタリングを無効にできます。 - **すべてのユーザーを制限する** (デフォルトオプション): Designer と Administrator を含むすべてのユーザーに対し、コマンドや関数、プロジェクトメソッドへのアクセスを制限します。 - **DesignerとAdministratorは制限しない**: このオプションは Designer と Administrator のみに、4Dコマンドやメソッドへの完全なアクセスを与えます。 他のユーザーには制限をかけつつ、管理者に無制限のアクセスを与えたい場合に使用できます。 開発段階では、このモードを使用してすべてのフォーミュラやレポート等を自由にテストできます。 運用時には、一時的にコマンドやメソッドへのアクセスを与えるためなどに使用できます。 This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ title: セキュリティページ - **誰も制限しない**: このオプションはフォーミュラの制御を無効にします。 このオプションが選択されると、ユーザーはすべての 4Dコマンドおよびプラグインコマンド、さらにはプロジェクトメソッドを使用できます (非表示のものを除く)。 **Note:** This option takes priority over the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command. このオプションが選択されると、コマンドの効果はなくなります。 - - **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). +- **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 このオプションがチェックされていると: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/web.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/web.md index 74b5c4214c82d5..47065f87834426 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/web.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/settings/web.md @@ -82,9 +82,9 @@ Webページキャッシュを有効化します。 [キャッシュ](../WebServ このモードでは、以下の追加の Web サーバー設定を設定することができます: - - [最大同時Webプロセス](#最大同時webプロセス) - - [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) - - [Use preemptive processes](#use-preemptive-processes) +- [最大同時Webプロセス](#最大同時webプロセス) +- [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) +- [Use preemptive processes](#use-preemptive-processes) #### 旧式セッション (シングルプロセスセッション) @@ -166,9 +166,9 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 ログフォーマットメニューでは、次のオプションを提供します。 - - **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 +- **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 - - **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 +- **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 - host: クライアントの IPアドレス (例: 192.100.100.10) - rfc931: 4Dによって作成されない情報。 常に - (マイナス記号) です。 @@ -177,23 +177,23 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 > 日付と時間はサーバーのローカルタイム。 - - request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) - - state: サーバーの返答。 - - length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 +- request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) +- state: サーバーの返答。 +- length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 > **注:** パフォーマンス上の理由により、操作はメモリのバッファーに 1Kbのパケットで保存されてから、ディスクに書き込まれます。 5秒間リクエストが発生しなくても、操作はディスクに書き込まれます。 > state として取り得る値は以下の通り:
200: OK
204: No contents
302: Redirection
304: Not modified
400: Incorrect request
401: Authentication required
404: Not found
500: Internal error
CLFフォーマットはカスタマイズされません。 - - **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 +- **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 - Referer: リクエストされたドキュメントを指しているページの URL を含みます。 - User-agent: リクエストのオリジンにおけるクライアントのブラウザーまたはソフトウェアの名前とバージョンを含みます。 > DLFフォーマットはカスタマイズされません。 - - **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 +- **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 - - **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 +- **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 **フィールドの設定**
ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると、選択されたフォーマットに対して利用可能なフィールドが表示されます。 ログに含む各フィールドを選択する必要があります。 ログに含む各フィールドを選択する必要があります。 @@ -233,14 +233,14 @@ ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると リクエストログの自動バックアップ設定を指定します。 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 > スケジュールされたバックアップの場合で、バックアップが開始する予定となっているときに Webサーバーが起動していないと、次回の起動において 4D はバックアップが失敗したと見なし、データベース設定で示されている適切な設定を適用します。 @@ -254,9 +254,9 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは 4D を Webサービスサーバーとして使用する (つまり、Webサービスの形でプロジェクトメソッドを公開する) ための設定をおこないます。 - - **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 - - **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 - - **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 +- **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 +- **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 +- **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 > タグ名に関する XML標準に準拠するために、使用する文字には空白が含まれていてはなりません。また数字から始まっていてはなりません。 非互換性を避けるために、アクセント文字や日本語などの拡張文字は使用しないことを推奨します。 @@ -264,7 +264,7 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは Webサービスクライアントとして 4D を使用する (つまり、ネットワーク上に公開されているサービスにサブスクライブする) ための設定をおこないます。 - - **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 +- **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 ## Web機能 @@ -298,9 +298,9 @@ See [Users and sessions](../REST/authUsers.md) to know the recommended way to co このボタンは次のアップグレードシーケンスをトリガーします: - - **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 - - `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 - - プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 +- **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 +- `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 +- プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 このアップグレードをおこなった後は、プロジェクトを再起動することを忘れないでください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md index f17dade9988946..30be85fda23689 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md @@ -160,8 +160,8 @@ title: Class :::note 注記 - - すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 - - 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 +- すでにインスタンス化されている [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) に対して `.new()` を呼び出すと、新しいインスタンスではなくシングルトンインスタンスが返されます。 +- 存在しないクラスを対象に `.new()` を呼び出した場合、エラーが返されます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/Document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/Document.md index cb7edf57941cd8..1b71686ebb69e1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/Document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/Document.md @@ -320,8 +320,8 @@ title: Document クラス `.original` プロパティは、エイリアス、ショートカット、シンボリックリンクファイルのターゲット要素を返します。 ターゲット要素は以下のいずれかです: ターゲット要素は以下のいずれかです: - - File オブジェクト - - Folder オブジェクト +- File オブジェクト +- Folder オブジェクト エイリアスでないファイルについては、プロパティは同じファイルオブジェクトをファイルとして返します。 @@ -585,8 +585,8 @@ $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite) 任意で、コンテンツの読み取りに使用する文字セットを渡します。 これには、次の二つの方法があります: - - *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 - - *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 +- *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 +- *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 > 4D によってサポートされている文字セットの一覧については、`CONVERT FROM TEXT` コマンドを参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md index 1e1cbd8927b9c2..7ed93331603884 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage `.body` プロパティには送信されるメッセージ本文が格納されています。 `.body` プロパティでは以下のデータ型がサポートされます: - - text - - blob - - object - - image +- text +- blob +- object +- image `.body` プロパティは読み書き可能です。 @@ -108,17 +108,17 @@ exposed onHTTPGet Function getFile() : 4D.OutgoingMessage *body* 引数では以下のデータ型がサポートされています: - - Text - - BLOB - - Object - - ピクチャー +- Text +- BLOB +- Object +- ピクチャー この関数が使用された場合、content-type ヘッダーは*body* 引数の型に応じて自動的に設定されます: - - Content-Type: 本文がテキストの場合にはtext/plain - - Content-Type: 本文がBlob の場合にはapplication/octet-stream - - Content-Type: 本文がオブジェクトの場合にはapplication/json - - Content-Type: image/jpeg、image/gif... (本文が画像の場合) +- Content-Type: 本文がテキストの場合にはtext/plain +- Content-Type: 本文がBlob の場合にはapplication/octet-stream +- Content-Type: 本文がオブジェクトの場合にはapplication/json +- Content-Type: image/jpeg、image/gif... (本文が画像の場合) *body* がサポートされていない値の型だった場合、エラーが返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md index 6609af77779e06..7d998df44714c1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ SMTPステータスコードについての詳細は [こちらのページ](htt SMTP接続は、以下の場合に自動的に閉じられます: - - `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 - - `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 +- `.keepAlive` プロパティが true (デフォルト) の場合には、`transporter` オブジェクトが消去された時。 +- `.keepAlive` プロパティが false の場合には、各 `.send( )` 関数が実行された後。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md index a6ca6e513e7b29..e59f376e94bde5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Session オブジェクトは [`Session`](../commands/session.md) コマンドによって返されます。 このオブジェクトは、カレントユーザーセッションを管理するためのインターフェースをデベロッパーに対して提供し、コンテキストデータの保存、プロセス間の情報共有、セッションに関連したプリエンプティブプロセスの開始などのアクションの実行や、[アクセス権](../ORDA/privileges.md) の管理を可能にします。 +:::info To learn more + +Blog posts about this feature: + +- [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### セッションの種類 このクラスは以下の種類のセッションをサポートしています: @@ -308,6 +317,10 @@ Else End if ``` +#### 参照 + +[*Blog posts about this feature*](https://blog.4d.com/?s=hasPrivilege) + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md index 0ab97f49662ad1..c6672cca43fefd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md @@ -149,18 +149,18 @@ TCPConnection オブジェクトは以下のプロパティと関数を提供し -| 引数 | 型 | | 説明 | -| ------------- | ------------- | --------------------------- | ------------------------- | -| serverAddress | Text | -> | サーバーのドメイン名またはIP アドレス | -| serverPort | Integer | -> | サーバーのポート番号 | -| options | Object | -> | 接続の設定[オプション](#options-引数) | -| 戻り値 | TCPConnection | <- | 新しいTCPConnection オブジェクト | +| 引数 | 型 | | 説明 | +| ------------- | -------------------------------- | --------------------------- | ------------------------- | +| serverAddress | Text | -> | サーバーのドメイン名またはIP アドレス | +| serverPort | Integer | -> | サーバーのポート番号 | +| options | Object | -> | 接続の設定[オプション](#options-引数) | +| 戻り値 | 4D.TCPConnection | <- | 新しいTCPConnection オブジェクト | #### 説明 -`4D.TCPConnection.new()` 関数は、*serverAddress* および *serverPort* 引数で接続したサーバーへ、*options* 引数で定義されたオプションを使用して、新規のTCP 接続を作成し、`4D.HTTPRequest` オブジェクトを返します。 +The `4D.TCPConnection.new()` function creates a new TCP connection to the specified *serverAddress* and *serverPort*, using the defined *options*, and returns a `4D.TCPConnection` object. #### `options` 引数 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md index b0e89875e7e1f5..f7083647889e0a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md @@ -7,10 +7,10 @@ title: TCPEvent
履歴 -| リリース | 内容 | -| ----- | ---------------------- | -| 20 R9 | 新しい `ip` および `port` 属性 | -| 20 R8 | クラスを追加 | +| リリース | 内容 | +| ----- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | クラスを追加 |
@@ -20,12 +20,24 @@ title: TCPEvent 次のプロパティを利用することができます: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### 説明 + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ title: TCPEvent - - -## .ip - -**ip** : Text - -#### 説明 - -`.ip` プロパティには、リモートマシンのIP アドレスが格納されています。 - - - ## .port diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md index 4263a51c3caa38..5cab3d46d6789e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md @@ -56,8 +56,8 @@ Webフォームのコンポーネント (構成要素) とは、これらの Web この関数は、以下の場合には何もしません: - - Webフォーム上で *state* が現在有効ではない。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* が現在有効ではない。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を [有効化](#enablestate) または無効化した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 @@ -82,8 +82,8 @@ Webフォームの state に関する詳細については、[developer.qodly.co この関数は、以下の場合には何もしません: - - Webフォーム上で *state* がすでに有効である。 - - Webフォーム上で *state* が存在しない。 +- Webフォーム上で *state* がすでに有効である。 +- Webフォーム上で *state* が存在しない。 同じユーザー関数内で複数の state を有効化または [無効化](#disablestate)した場合、すべての変更は関数の終了時に一括してクライアントに送信されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md index fde54ce68e3b01..eacb93bd59f35f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md @@ -86,8 +86,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *url*には、WebSocketサーバーが応答する URL を渡します。 以下の URLパターンが使用できます: - - 標準接続用: `ws://host[:port]path[?query]` - - TLSセキュア接続用: `wss://host[:port]path[?query]` +- 標準接続用: `ws://host[:port]path[?query]` +- TLSセキュア接続用: `wss://host[:port]path[?query]` 接続できない場合、`null` オブジェクトが返され、エラーが生成されます (このエラーは `ON ERR CALL` で実装したメソッドによってインターセプトできます)。 @@ -95,8 +95,8 @@ WebSocketオブジェクトは、以下のプロパティと機能を提供し *connectionHandler* には、接続イベントに応じて呼び出されるコールバック関数のほか、処理するデータ型やヘッダーを含むオブジェクトを渡すことができます。 - - コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 - - フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 +- コールバックは、接続を開始したフォームまたはワーカーのコンテキストで自動的に呼び出されます。 +- フォームまたはワーカーが閉じられていない限り、WebSocket は有効です。 | プロパティ | 型 | 説明 | | ----------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ This.headers.Cookie:="yummy_cookie=choco; tasty_cookie=strawberry" *code* には、接続を閉じる理由を説明するステータスコードを渡すことができます ([RFC6455 の WebSocket Connection Close Code](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5) も参照ください): - - 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 - - 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 +- 指定しなかった場合、接続のクローズコードは自動的に設定されます: 通常終了の場合は 1000、そうでない場合は、接続が切断された実際の理由を示す 1001〜1015 の標準値。 +- 指定された場合、この code パラメーターの値は自動設定の値をオーバーライドします。 値は整数でなくてはなりません。 1000、または 3000-4999 の範囲のカスタムコードが利用できます。 *code* を指定する場合は、*reason* の値も指定する必要があります。 *reason* には、接続を閉じる理由を説明するテキストを渡すことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md index 84edc11d112719..14752f7a1265e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ WebSocketプロトコルは、WebSocketサーバーとクライアント (Webブ 4D で WebSocketサーバーを作成し、扱うには、4Dビルトインクラスを 2つ使用する必要があります。 - - このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 - - [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 +- このクラス (`4D.WebSocketServer`) は、サーバー自体を管理するためのものです。 +- [`4D.WebSocketConnection`](WebSocketConnectionClass.md) クラスを使用して、接続とメッセージを管理します。 さらに、2つのユーザークラスを作成し、コールバック関数を定義する必要があります: - - サーバー接続を処理するためのユーザークラス - - メッセージを処理するためのユーザークラス +- サーバー接続を処理するためのユーザークラス +- メッセージを処理するためのユーザークラス 接続を維持するため、[WebSocketサーバーの作成](#4dwebsocketservernew) は [ワーカー](../Develop/processes.md#worker-プロセス) 内にて行う必要があります。 @@ -387,8 +387,8 @@ Function broadcast($ws : 4D.WebSocketConnection; $message:text) *timeout* 値が設定されている場合: - - 待機時間に達したら強制的にソケットを破棄します。 - - *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 +- 待機時間に達したら強制的にソケットを破棄します。 +- *timeout* = 0 の場合、クローズフレームや、FINパケットの交換なしで、強制的かつ即座にソケットを破棄します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md index 657829ce598c98..81090d6fc2c115 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md @@ -17,7 +17,7 @@ WebAdmin 内部コンポーネントは、"WebAdmin" 権限を持つユーザー `WebAdmin` Webサーバーは、4D または 4D Server アプリケーションの起動時 (プロジェクトの読み込み前) に開始するように設定できます。 - - インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 +- インターフェースを持つ 4Dアプリケーションを使用している場合は、**ファイル ＞ Web管理 ＞ 設定...** メニュー項目を選択します。 ![alt-text](../assets/en/Admin/waMenu1.png) @@ -25,7 +25,7 @@ Web管理設定ダイアログボックスで、**WebAdmin サーバーをスタ ![alt-text](../assets/en/Admin/waSettings.png) - - ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: +- ヘッドレスの 4Dアプリケーションを使用しているかにかかわらず、以下の *コマンドライン・インターフェース* の引数を使用して、自動スタートアップを有効にすることができます: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -71,8 +71,8 @@ Web管理の設定ダイアログボックスを開くには、**ファイル **注:** - - ローカルホスト以外による HTTP接続は受け付けません。 - - このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 +- ローカルホスト以外による HTTP接続は受け付けません。 +- このオプションがチェックされていても、[HTTPSを受け入れる](#httpsを受け入れる) がチェックされていて、TLS の設定が有効な場合、ローカルホストの接続は HTTPS を使用します。 #### HTTP ポート @@ -94,11 +94,11 @@ TLS証明書ファイルが置かれているフォルダーのパスです。 HTTPリクエストログファイル (アプリケーションの "Logs" フォルダーに格納されている HTTPDebugLog_*nn*.txt (nn はファイル番号)) の状態やフォーマットを指定します。 次のオプションから選択することができます: - - **無効化** (デフォルト) - - **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 - - **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) - - **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 - - **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 +- **無効化** (デフォルト) +- **bodyパーツを全て** - レスポンスおよびリクエストのボディパーツを含める形で有効化。 +- **bodyパーツを含めない** - ボディパーツを含めない形で有効化 (ボディザイズは提供されます) +- **リクエストのbody** - リクエストのボディパーツのみを含める形で有効化。 +- **レスポンスのbody** - レスポンスのボディパーツのみを含める形で有効化。 #### アクセスキー @@ -108,9 +108,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ アクセスキーはパスワードに似ていますが、ログインとは関係ありません。 - - 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 - - アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 - - 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 +- 新しいアクセスキーを定義するには、**定義** ボタンをクリックし、ダイアログボックスにアクセスキーの文字列を入力して **OK** をクリックします。 すると、ボタンラベルが **編集** に変わります。 +- アクセスキーを編集するには、**編集** ボタンをクリックし、ダイアログボックスに新しいアクセスキーの文字列を入力して **OK** をクリックします。 +- 新しいアクセスキーを削除するには、**編集** ボタンをクリックし、ダイアログボックスのアクセスキー欄を空にして **OK** をクリックします。 #### Qodly Studio へのアクセスを有効化する @@ -145,9 +145,9 @@ HTTPリクエストログファイル (アプリケーションの "Logs" フォ ## 認証とセッション - - 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 +- 事前に本人確認せずに URL経由で Web管理ページにアクセスした場合、認証が必要になります。 ユーザーは、認証ダイアログボックスに [アクセスキー](#アクセスキー) を入力する必要があります。 `WebAdmin` 設定でアクセスキーが定義されていない場合には、URL経由のアクセスはできません。 - - 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 +- 4D または 4D Server のメニュー項目 (**レコード ＞ データエクスプローラー** または **ウィンドウ ＞ データエクスプローラー** (4D Server) など) から Web管理ページに直接アクセスした場合、アクセスは認証なしで許可され、ユーザーは自動的に認証されます。 アクセスが許可されると、4Dアプリケーション上に "WebAdmin" 権限を持つ Web[セッション](WebServer/sessions.md) が作成されます。 カレントセッションが "WebAdmin" 権限を持っている限り、`WebAdmin` コンポーネントは要求されたページを提供します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md index 6986d96dadd991..3ab479d1071d65 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md @@ -5,12 +5,12 @@ title: 復元 問題が発生したときは、一連のアプリケーションファイル全体を復元することができます。 主に 2つのカテゴリの問題が発生する可能性があります: - - アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: +- アプリケーションが使用中に予期せず終了された。 この問題は電力の切断、システムのエラー等により発生する可能性があります。 この場合、問題が発生した瞬間のデータキャッシュの状態により、アプリケーションの復旧には異なる手順が必要となります: - キャッシュが空の場合、アプリケーションを問題なく開くことができます。 アプリケーションに対しておこなわれた変更はデータファイルに記録されています。 この場合には、特別な手順は必要ありません。 - キャッシュに未保存の処理が含まれている場合、データファイルは損傷していませんが、カレントのログファイルを統合する必要があります。 - キャッシュの内容をデータファイルに書き込み中だった場合、データファイルはおそらく損傷しています。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 - - アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 +- アプリケーションファイルを失った。 この問題はアプリケーションが配置されたディスク上のセクターが読み書き不能になった、あるいはウィルス、操作ミス等により発生します。 最新のバックアップから復元をおこない、カレントのログファイルを統合する必要があります。 問題発生後にアプリケーションが損傷しているかどうかを見分けるには、4D でアプリケーションを起動します。 4Dは自己検証をおこない、必要な復元処理手順を示します。 自動モードの場合、この処理はユーザーのアクションなしで直接実行されます。 定期的なバックアップがおこなわれていれば、4D の復元ツールを使用して (ほとんどの場合) 問題が発生する直前の状態までアプリケーションを復旧することができます。 > 問題発生後に、自動で 4Dのアプリケーション復旧処理を起動することができます。 このメカニズムは、ストラクチャー設定の **バックアップ/バックアップ＆復旧** ページで利用できるオプションを使用して管理します。 詳細は [自動復元](settings.md#自動復元とログの統合) を参照してください。\ > 問題が、データに対しておこなわれた不適切な処理の結果引き起こされた場合 (たとえば誤ってレコードを削除した等)、ログファイルの "ロールバック" 機能を使用してデータファイルを復旧できます。 この機能は MSC の [ロールバック](MSC/rollback.md) ページから利用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md index c28b98d4c1ef79..0b5e516ddd4702 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md @@ -5,9 +5,9 @@ title: バックアップ設定 バックアップ設定の定義は、[ストラクチャー設定ダイアログボックス](../settings/overview.md) 内で 3ページにわたっています。 次の設定がおこなえます: - - 自動バックアップ用のスケジューラー設定 - - 各バックアップに含めるファイル - - 自動タスクの実行を可能にする高度な設定 +- 自動バックアップ用のスケジューラー設定 +- 各バックアップに含めるファイル +- 自動タスクの実行を可能にする高度な設定 > このダイアログボックスで定義された設定は *Backup.4DSettings* ファイルに書き込まれ、[Settings フォルダー](Project/architecture.md#settings-ユーザー) に保存されます。 @@ -23,12 +23,12 @@ title: バックアップ設定 このページにあるオプションを使用して、アプリケーションの自動バックアップのスケジュールを設定できます。 標準のクイック設定、または完全なカスタマイズを選択できます。 **自動バックアップ** メニューでの選択に基づき、さまざまなオプションが表示されます: - - **しない**: スケジュールに基づくバックアップは無効となります。 - - **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 - - **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 - - **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 - - **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 - - **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: +- **しない**: スケジュールに基づくバックアップは無効となります。 +- **毎時**: 次の時間以降、毎時間ごとに自動バックアップをおこないます。 +- **毎日**: 日に一回自動バックアップをおこないます。 バックアップを何時に開始するかを設定します。 +- **毎週**: 週に一回自動バックアップをおこないます。 バックアップを開始する曜日と時刻を入力するエリアが表示されます。 +- **毎月**: 月に一回自動バックアップをおこないます。 バックアップを開始する日付と時刻を入力するエリアが表示されます。 +- **カスタマイズ**: 自動バックアップを詳細にスケジュールする場合に使用します。 このオプションを選択すると、複数の入力エリアが表示されます: - **X 時間ごと**: 時間単位でバックアップの間隔をスケジュールできます。 1から24までの値を設定できます。 * **X 日ごと**: 日単位でバックアップの間隔をスケジュールできます。 たとえば、毎日バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップが開始される時刻を設定しなければなりません。 * **X 週ごと**: 週単位でバックアップの間隔をスケジュールできます。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションを選択した場合、バックアップを開始する曜日と時刻を設定しなければなりません。 複数の曜日を選択することもできます。 たとえば、毎週水曜日と金曜日にバックアップをするようプログラムできます。 @@ -48,12 +48,12 @@ title: バックアップ設定 このエリアでは、次回のバックアップ時にコピー対象とするファイルやフォルダーを指定します。 - - **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: +- **データ**: アプリケーションのデータファイル。 このオプションが選択されている場合、次のものがデータとともにバックアップされます: - データベースのカレントログファイル (あれば) - [データファイルの隣に置かれた](../Project/architecture.md#settings-フォルダー) `Settings` フォルダー (あれば)。これは *データファイル用のユーザー設定* を格納しています。 - - **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 - - **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* - - **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 +- **ストラクチャー**: アプリケーションの Project フォルダーとファイル。 プロジェクトがコンパイルされている場合には、このオプションは .4dz ファイルをバックアップします。 このオプションがチェックされていると、[Project フォルダーと同階層に置かれた](../Project/architecture.mdsettings-ユーザー) `Settings` フォルダーが自動でバックアップされます。これは、*ユーザー設定* を格納しています。 +- **ユーザーストラクチャー(バイナリデータベースのみ)**: *廃止予定* +- **添付**: このエリアでは、アプリケーションと同時にバックアップの対象とするファイルやフォルダーを指定します。 ここではどのようなタイプのファイル (ドキュメントやプラグイン、テンプレート、ラベル、レポート、ピクチャーなど) でも指定できます。 個々のファイル、または丸ごとバックアップするフォルダーを個々に設定できます。 添付エリアには、設定されたファイルのパスが表示されます。 - **削除**: 選択したファイルを添付エリアから取り除きます。 - **フォルダー追加...**: バックアップに追加するフォルダーを選択するダイアログボックスを表示します。 復元の場合、フォルダーがその内容物とともに復元されます。 アプリケーションファイルを含むフォルダーを除き、すべてのフォルダーやマシンに接続されたボリュームを選択できます。 - **ファイル追加...**: バックアップに追加するファイルを選択するダイアログボックスを表示します。 @@ -82,19 +82,19 @@ title: バックアップ設定 ### 一般設定 - - **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 +- **最新のバックアップのみ保存 X バックアップファイル**: このパラメーターを有効にすると、指定された数の最新バックアップファイルだけが保持され、古いバックアップファイルは削除されます。 この機能は以下のように動作します: バックアップ処理が完了したら、アーカイブが作成されたのと同じ場所、同じ名前のもっとも古いアーカイブを削除します。ディスクスペースを確保するため、バックアップ前に削除するよう、削除のタイミングを変更することもできます。 たとえば、3世代のファイルを保持するよう設定している場合、最初の 3回のバックアップで MyBase-0001、MyBase-0002、MyBase-0003 が作成され、 4回目のバックアップで MyBase-0004 が作成されたのちに MyBase-0001 が削除されます。 この設定はデフォルトで有効になっており、4D は 3世代のバックアップを保持します。 このメカニズムを無効にするには、チェックボックスの選択を外します。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 +- **データファイルが更新された場合のみバックアップを行う**: このオプションが選択された場合、前回のバックアップ以降にデータが追加・変更・削除された場合のみ、4D は定期的なバックアップを開始します。 そうでない場合、定期的なバックアップはキャンセルされ、次回のスケジュールまで延期されます。 エラーは生成されませんが、バックアップジャーナルにはバックアップが延期された旨記録されます。 このオプションを使用すれば、主に参照目的で使用されているアプリケーションのバックアップに消費されるマシン時間を節約できます。 ストラクチャーや添付ファイルに対して変更がおこなわれていても、データファイルの更新としては扱われない旨注意してください。 > このパラメーターは、アプリケーションおよびログファイル両方のバックアップに影響します。 - - **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 +- **最も古いバックアップファイルを削除**: このオプションは "最新のバックアップのみ保存 X バックアップファイル" が有効になっている場合のみ使用されます。 このオプションを使用して、最も古いバックアップファイルを削除するタイミングを設定します。選択肢は **バックアップ前**、あるいは **バックアップ後** です。 このオプションが機能するには、バックアップファイルが名称変更されたり、移動されたりしていてはなりません。 - - **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 +- **バックアップ失敗時**: このオプションを使用して、バックアップ失敗時の処理を設定できます。 バックアップが実行できなかった場合、4D では再試行することが可能です。 - **次回の予定された日付と時刻に再試行する**: このオプションは、定期的な自動バックアップを設定されている場合にのみ意味があります。 失敗したバックアップはキャンセルされます。 エラーが生成されます。 - **指定時間経過後に再試行**: このオプションが選択されていると、設定された待ち時間経過後にバックアップを再試行します。 このメカニズムを使用すると、バックアップをブロックするような特定の状況に対応することが可能となります。 秒、分、あるいは時間単位で待ち時間を設定できます。 次のバックアップ試行にも失敗するとエラーが生成され、ステータスエリアに失敗状況が表示され、バックアップジャーナルにも記録されます。 - **操作をキャンセル X 試行後**: このパラメーターを使用して、バックアップ試行の失敗最大数を設定できます。 この最大数に達してもバックアップが正しく実行できなかった場合、バックアップはキャンセルされ、エラー 1401 ("バックアップ試行の最大数に達しました。自動バックアップは無効になります") が生成されます。 この場合、データベースを再起動するか、手動バックアップが成功するまで自動バックアップはおこなわれません。 @@ -106,17 +106,17 @@ title: バックアップ設定 これらのオプションはメインのバックアップファイルとログバックアップファイルに適用されます。 - - **セグメントサイズ (MB)**: +- **セグメントサイズ (MB)**: 4D ではアーカイブをセグメントに分割することができます。 この振る舞いにより、たとえばバックアップファイルを複数の異なるディスク (DVDやUSBデバイス等) に格納できます。 復元時、4D はセグメントを自動的に統合します。 各セグメントには MyApplication[xxxx-yyyy].4BK といった名称がつけられます (xxxx はバックアップ番号、yyyy はセグメント番号)。 たとえば、MyApplication のバックアップが 3つのセグメントに分割されると、次のような名前になります: MyApplication[0006-0001].4BK、MyApplication[0006-0002].4BK、MyApplication[0006-0003].4BK **セグメントサイズ** はコンボボックスであり、各セグメントのサイズを MB単位で設定できます。 メニューから定義済み値を選択するか、0~2048 の値を入力できます。 0 を指定するとセグメント化はされません (**なし** を指定したのと同じ)。 - - **圧縮率**: +- **圧縮率**: デフォルトで 4D はバックアップファイルを圧縮してディスクスペースを節約します。 しかし大量のデータがある場合、ファイルの圧縮処理はバックアップにかかる時間を長くします。 **圧縮率** オプションを使用してファイルの圧縮モードを調整できます: - **なし**: ファイルの圧縮はおこなわれません。 バックアップは早くおこなわれますが、ファイルサイズは大きくなります。 - **速度** (デフォルト): このオプションはバックアップの速度とアーカイブサイズのバランスが考慮されたものです。 - **圧縮率**: アーカイブに最大の圧縮率が適用されます。 アーカイブファイルはディスク上で最小のサイズとなりますが、バックアップの速度は低下します。 - - **インターレース率と冗長率**: +- **インターレース率と冗長率**: 4D は、最適化 (インターレース) とセキュリティ (冗長) メカニズムに基づく特定のアルゴリズムを使用してアーカイブを生成します。 これらのメカニズムを必要に応じて設定できます。 これらのオプションのメニューには低・中・高・なし (デフォルト) の選択肢があります。 - **インターレース率**: インターレースとはデータを連続しない領域に書き込むことにより、セクター損傷の際のリスクを低減させるものです。 率を上げることでリスクがより低減されますが、データの処理により多くのメモリが必要となります。 - **冗長率**: 冗長は同じ情報を複数回繰り返すことで、ファイル中のデータを保護するものです。 冗長率を高くするとよりファイルが保護されます。しかし書き込みは遅くなり、ファイルサイズも増大します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md index b64738eed44277..6797c5d2ea76b5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: - - 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 - - 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: 三項条件演算子 (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -33,18 +33,18 @@ $col:=New collection // $col を空のコレクションで初期化します 演算の結果は、オペランドの **データ型** に依存します。4D はスカラーデータ型に対して様々な演算子をサポートしています。 詳細は、各データ型の項にて説明されています: - - [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) - - [**日付演算子**](dt_date.md#日付演算子) - - [**時間演算子**](dt_time.md#時間演算子) - - [**数値演算子**](dt_number.md#数値演算子) - - [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) - - [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) - - [**ポインター演算子**](dt_pointer.md#ポインター演算子) - - [**文字列演算子**](dt_string.md#文字列演算子) - - [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) - - [**コレクション参照演算子**](dt_collection.md#コレクション演算子) - - [**Null 演算子**](dt_null_undefined.md#null-演算子) - - [**未定義演算子**](dt_null_undefined.md#未定義演算子) +- [**論理演算子**](dt_boolean.md#論理演算子) (**ブール** 式に使用) +- [**日付演算子**](dt_date.md#日付演算子) +- [**時間演算子**](dt_time.md#時間演算子) +- [**数値演算子**](dt_number.md#数値演算子) +- [**ビットワイズ演算子**](dt_number.md#ビットワイズ演算子) (**倍長整数** 式に使用) +- [**ピクチャー演算子**](dt_picture.md#ピクチャー演算子) +- [**ポインター演算子**](dt_pointer.md#ポインター演算子) +- [**文字列演算子**](dt_string.md#文字列演算子) +- [**オブジェクト参照演算子**](dt_object.md#オブジェクト演算子) +- [**コレクション参照演算子**](dt_collection.md#コレクション演算子) +- [**Null 演算子**](dt_null_undefined.md#null-演算子) +- [**未定義演算子**](dt_null_undefined.md#未定義演算子) ## 複合代入演算子 @@ -272,9 +272,9 @@ $name:=$person.maidenName || $person.name 三項演算子は 3つのオペランドを次の順序で受け取ります: - - 条件とクエスチョンマーク (?) - - 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) - - 条件が [falsy](#truthy-と-falsy) の場合に実行される式 +- 条件とクエスチョンマーク (?) +- 条件が [truthy](#truthy-と-falsy) である場合に実行される式、その後にコロン (:) +- 条件が [falsy](#truthy-と-falsy) の場合に実行される式 ### シンタックス @@ -325,21 +325,21 @@ $fullname:=($person.firstname && $person.lastname) ? ($person.firstname+" "+$per 以下の値は **falsy** です: - - false - - Null - - undefined - - Null オブジェクト - - Null コレクション - - Null ポインター - - Null ピクチャー - - Null 日付 !00-00-00! - - "" - 空の文字列 - - [] - 空のコレクション - - {} - 空のオブジェクト +- false +- Null +- undefined +- Null オブジェクト +- Null コレクション +- Null ポインター +- Null ピクチャー +- Null 日付 !00-00-00! +- "" - 空の文字列 +- [] - 空のコレクション +- {} - 空のオブジェクト 上記以外の値はすべて **truthy** と評価されます。次の値も truthy です: - - 0 - 数値のゼロ (整数かどうかを問わず) +- 0 - 数値のゼロ (整数かどうかを問わず) 4Dでは、**truthy** と **falsy** の評価は値の **使用性** を反映します。つまり、truthy な値は存在し、エラーや予期せぬ結果を発生させずにコードによって処理できることを意味します。 その目的は、オブジェクトやコレクションにおける *undefined* や *null* 値を扱うための便利な方法を提供し、実行時エラーを回避するのに必要な [If...Else](flow-control.md#ifelseend-if) 文の数を少なくすることにあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md index c5099654e05cd7..bf38f56c24bd72 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md @@ -54,8 +54,8 @@ var $myVar // バリアント型変数 `varType` には次が指定できます: - - [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます - - [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます +- [基本のデータ型](Concepts/data-types.md): 変数には、宣言された型の値が格納されます +- [クラス参照](Concepts/classes.md) (4Dクラスまたはユーザークラス): 変数には、定義されたクラスのオブジェクトへの参照が格納されます `varType` を省略すると、**variant** 型の変数が作成されます。 @@ -87,7 +87,7 @@ var $myVar // バリアント型変数 ### 例題 - - 基本のデータ型の、ローカル変数およびプロセス変数の宣言: +- 基本のデータ型の、ローカル変数およびプロセス変数の宣言: ```4d var $myText; myText; $vt : Text @@ -99,14 +99,14 @@ var $o : 4D.Object // C_OBJECT($o) とも同義です ``` - - 4Dクラス型のオブジェクト変数の宣言: +- 4Dクラス型のオブジェクト変数の宣言: ```4d var $myFolder : 4D.Folder var $myFile : 4D.File ``` - - ユーザークラス型のオブジェクト変数の宣言: +- ユーザークラス型のオブジェクト変数の宣言: ```4d var $myClass : cs.MyClass @@ -194,9 +194,9 @@ MyNumber:=3 ローカル変数は、以下のような目的のために使用されます: - - 他の変数名との重複を避ける。 - - データを一時的に使用する。 - - プロセス変数の数を減らす。 +- 他の変数名との重複を避ける。 +- データを一時的に使用する。 +- プロセス変数の数を減らす。 ローカル変数の名前は必ずドル記号 ($) で始め、この記号を除く31文字までの文字を指定できます。 これより長い名前を指定すると、4D は余分の32文字以降を切り捨てます。 @@ -225,9 +225,9 @@ MyNumber:=3 `GET PROCESS VARIABLE` や `SET PROCESS VARIABLE` を使用して、あるプロセスから他のプロセスのプロセス変数の値を取得したり、設定したりできます。 これらのコマンドの利用は、以下のような状況に限定することが、良いプログラミングの作法です: - - コード内の特定の箇所におけるプロセス間通信 - - プロセス間のドラッグ＆ドロップ処理 - - クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 +- コード内の特定の箇所におけるプロセス間通信 +- プロセス間のドラッグ＆ドロップ処理 +- クライアント/サーバーにおいて、クライアントマシン上のプロセスとサーバーマシン上のストアドプロシージャー間の通信 詳細については **プロセス** の章と、各コマンドの説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md index 9500d212469b2e..6f8747a80166fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md @@ -33,13 +33,13 @@ title: デバッガー 一般に、これらは発見が最も難しいタイプのエラーです。 これまでに説明しているエラーは、タイプミスを除いて、"設計またはロジックのエラー" という範疇に該当します。 これらを検知するには、[デバッガー](debugger.md) を使用します。 例: - - まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 - - 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 +- まだ初期化されていない変数を用いようとしたため、*シンタックスエラー* が発生する場合があります。 +- 間違った引数を受け取ったサブルーチンが、その間違った名前によりドキュメントを開こうとしたため、*環境エラー* が発生している場合があります。 設計またはロジックのエラーには、次のような場合もあります: - - `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 - - オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 +- `SAVE RECORD` コマンドを呼び出す際に、対象となるレコードがロックされているかどうかを最初にテストしなかったために、レコードが正しく更新されない。 +- オプション引数を追加した状態がテストされていないため、メソッドが想定通りに動作しない。 場合によって問題の原因は、実際に中断が発生しているコード部分ではなく、外部にあることもあります。 @@ -55,8 +55,8 @@ title: デバッガー メソッドの実行が停止されるとシンタックスエラーウィンドウが表示されます。 これは以下の理由で起こります: - - 以降のメソッド実行を妨げるエラーが発生した。 - - メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 +- 以降のメソッド実行を妨げるエラーが発生した。 +- メソッドが False の表明を生成した (`ASSERT` コマンド参照)。 ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ title: デバッガー シンタックスエラーウィンドウにはいくつかのオプションが用意されています: - - **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 +- **編集**: すべてのメソッド実行が中断されます。 4D はデザインモードに切り替わり、エラーが発生したメソッドがコードエディターで表示され、エラーを修正することができます。 原因に心当たりがあり、これ以上調査しなくても修正できる場合にこのオプションを使用します。 - - **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 +- **トレース**: トレース/デバッガーモードに入ります。 [デバッガー](debugger.md) ウィンドウが表示されます。 該当行の一部が未実行の場合には、**トレース** ボタンを数回クリックする必要があるかもしれません。 - - **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 +- **続ける**: 実行が継続されます。 エラーが発生した行は、エラーの位置によっては一部のみ実行済みである場合があります。 慎重に実行を継続してください: エラーが原因で、メソッドの残り部分が正常に実行できない場合があります。 `SET WINDOW TITLE` のように、コードの残りの部分の実行やテストの妨げにならない単純な呼び出しでエラーが発生している場合にのみ、**続ける** ボタンをクリックすることを推奨します。 :::tip @@ -76,14 +76,14 @@ title: デバッガー ::: - - **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: +- **閉じる**: メソッドが中断され、メソッドの実行を開始する前の状態に戻ります: - イベントに対してフォームメソッドまたはオブジェクトメソッドが実行されている場合には、これらは停止され、フォームに戻ります。 - メソッドがアプリケーションモードから実行されている場合には、このモードに戻ります。 - - **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 +- **コピー**: デバッグ情報をクリップボードにコピーします。 この情報はエラーの内部環境 (番号や内部コンポーネント等) を説明します。 情報はタブ区切り形式で記述されます。 - - **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 +- **保存...**: シンタックスエラーウィンドウの内容とコールチェーンを `.txt` ファイルに保存します。 ## デバッガー diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md index 2662bf20994e15..64b0a5ee11b413 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md @@ -71,7 +71,7 @@ title: クライアント/サーバー管理 同じマシン上で 4D が 4D Server に接続すると、アプリケーションはシングルユーザーモードの 4D のようにふるまい、デザイン環境にてプロジェクトファイルの編集が可能です。 この機能により、クライアント/サーバーアプリケーションを運用時と同じコンテキストで開発することができます。 -> 同じマシン上で 4D Server に 4D を接続する場合には、 [接続時のオプション](#リモートプロジェクトを開く) の設定にかかわらず **開発モード** が自動的に有効化されます。 +> When 4D connects to a 4D Server on the same machine, the **development mode** is automatically activated, whatever the [Activate development mode](#opening-a-remote-project) option status. デザイン環境にて 4D が **すべてを保存** アクションを (**ファイル** メニューを使って明示的に、または、アプリケーションモードへの移行により暗示的に) おこなうと、4D Server は同期的にプロジェクトファイルをリロードします。 4D Server によるプロジェクトファイルのリロードが完了するのを待って、4D は続行します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md index 804217b5d17516..e37db10b0ae5a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md @@ -15,10 +15,10 @@ title: On After Edit このイベントは、変更がおこなわれた方法に関係なく、入力可能オブジェクトの内容が変更されるたびに生成されます。*つまり*: - - ペーストやカット、削除、キャンセルなどの標準の編集アクション - - 値のドロップ (ペーストと同様のアクション) - - ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 - - ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 +- ペーストやカット、削除、キャンセルなどの標準の編集アクション +- 値のドロップ (ペーストと同様のアクション) +- ユーザーがおこなったキーボードからの入力。この場合、`On After Edit` イベントは [`On Before Keystroke`](onBeforeKeystroke.md) と [`On After Keystroke`](onAfterKeystroke.md) イベントの後に生成されます。 +- ユーザーアクションをシミュレートするランゲージコマンドによる変更 (例: `POST KEY`)。 `On After Edit` イベント内において、入力テキストは [`Get edited text`](../commands-legacy/get-edited-text.md) コマンドによって返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md index a71ad495fc74bf..6442cb5cb2fd76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ title: On Begin Drag Over `On Begin Drag Over` イベントは、ドラッグアクションの準備に役立ちます。 このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: このイベントは以下のように使用できます: - - `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 - - `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 - - ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 +- `APPEND DATA TO PASTEBOARD` コマンドを使って、ペーストボードにデータや署名を追加する。 +- `SET DRAG ICON` コマンドを使って、ドラッグアクション中にカスタムアイコンを表示する。 +- ドラッグされたオブジェクトのメソッドの戻り値を使用して、ドラッグを許可/拒否する。 - ドラッグアクションを受け入れるには、ソースオブジェクトのメソッドは 0 (ゼロ) を返さなければなりません。 - ドラッグアクションを拒否するには、ソースオブジェクトのメソッドは -1 (マイナス1) を返さなければなりません。 - 結果が返されない場合は、ドラッグアクションが受け入れられたと 4D は判断します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md index fb9943c47bf011..a0ee2f849bb5d4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md @@ -15,11 +15,11 @@ title: On Clicked `On Clicked` イベントは通常、マウスボタンが離されたときに生成されます。 しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: しかし、いくつか例外があります: - - [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 - - [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 - - [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 - - [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 - - リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 +- [非表示ボタン](FormObjects/properties_Display.md#レンダリングしない): マウスがクリックされると、ボタンが離されるのを待たずに `On Clicked` イベントが生成されます。 +- [ルーラー](FormObjects/ruler.md): [オブジェクトメソッド実行](FormObjects/properties_Action.md#オブジェクトメソッド実行) オプションが **true** に設定されていると、`On Clicked` イベントはクリックがおこなわれるとすぐに生成されます。 +- [コンボボックス](FormObjects/comboBox_overview.md): `On Clicked`イベントは、割り当てられたメニューでユーザーが別の値を選択した場合にのみ発生します。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 [コンボボックス](FormObjects/comboBox_overview.md) は、割り当てられたドロップダウンリストにデフォルト値が提供された、入力可能なテキストエリアとして扱われます。 つまり、コンボボックス内におけるデータ入力処理は、`On Before Keystroke` や `On After Keystroke`、`On Data Change` イベントを使用しておこなう必要があります。 +- [ドロップダウンリスト](FormObjects/dropdownList_Overview.md): `On Clicked` イベントは、 ユーザーがメニューで別の値を選択した場合にのみ発生します。 `On Data Change` イベントは、現在の値とは異なる値が選択されたときに、オブジェクトが操作されたことを検出することができます。 +- リストボックスの入力セルが [編集中](FormObjects/listbox_overview.md#入力の管理) のとき、マウスボタンが押されると `On Clicked` イベントが発生するので、`Contextual click` コマンドなどを使用することができます。 `On Clicked` イベントのコンテキストにおいては `Clickcount` コマンドを使うことによってユーザーがおこなったクリック数をテストすることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md index 18ab0753f5e4fa..7d6fbdfc0b4604 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ title: On Display Detail このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - レコードごとに: +- レコードごとに: - 詳細エリアのオブジェクトごとに: - オブジェクトメソッドの `On Display Detail` イベント - フォームメソッドの `On Display Detail` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md index 5816317910d07c..4cd0137a1c567d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over `On Drag Over` イベントは、マウスポインターがオブジェクトの上を移動する時に、繰り返しドロップ先オブジェクトに送られます。 このイベントの応答として、開発者は通常、以下のことをおこないます: - - ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 - - ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 +- ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 +- ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 ドラッグを **受け付ける** には、ドロップ先のオブジェクトメソッドが 0 (ゼロ) を返さなければなりません。 ドラッグを **拒否** するには、オブジェクトメソッドが -1 (マイナス1) を返さなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md index 823b0b85ca3b81..2beac18b7b5659 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md @@ -15,7 +15,7 @@ title: On Header このコンテキストにおいて、メソッドやフォームイベントが呼び出される順序は以下のとおりです: - - ヘッダーエリアのオブジェクトごとに: +- ヘッダーエリアのオブジェクトごとに: - オブジェクトメソッドの `On Header` イベント - フォームメソッドの `On Header` イベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md index 7120814e5d39cf..5317c52b286d9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md @@ -15,8 +15,8 @@ title: On Header Click リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されている場合、`$0` に 0 または -1 を渡して標準の並べ替えをおこなうかどうか指定できます: - - `$0 = 0` の場合、標準の並べ替えがおこなわれます。 - - `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 +- `$0 = 0` の場合、標準の並べ替えがおこなわれます。 +- `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されていない場合、`$0` は使用されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md index d5d31f0b890637..5ced8fbcb3e9a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md @@ -9,16 +9,16 @@ title: Forms また、以下の機能により、フォームは他のフォームを含むことができます: - - [サブフォームオブジェクト](FormObjects/subform_overview.md) - - [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) +- [サブフォームオブジェクト](FormObjects/subform_overview.md) +- [継承されたフォーム](./properties_FormProperties.md#継承するフォーム名) ## フォームを作成する 4Dフォームの追加や変更は、以下の要素を使っておこないます: - - **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 - - **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 - - **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: +- **4D Developer インターフェース:** **ファイル** メニューまたは **エクスプローラ** ウィンドウから新規フォームを作成できます。 +- **フォームエディター**: フォームの編集は **[フォームエディター](FormEditor/formEditor.md)** を使っておこないます。 +- **JSON コード:** JSON を使ってフォームを作成・設計し、フォーム ファイルを [適切な場所](Project/architecture.md#sources) に保存します。 例: ``` { @@ -70,9 +70,9 @@ title: Forms 2つのカテゴリーのフォームが存在します: - - **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 +- **プロジェクトフォーム** - テーブルに属さない独立したフォームです。 このタイプのフォームは、おもにインターフェースダイアログボックスやコンポーネントを作成するのに使用されます。 プロジェクトフォームを使用してより簡単に OS標準に準拠するインターフェースを作成できます。 - - **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 +- **テーブルフォーム** - 特定のテーブルに属していて、それによりデータベースに基づくアプリケーションの開発に便利な自動機能の恩恵を得ることができます。 通常、テーブルには入力フォームと出力フォームが別々に存在します。 フォームを作成する際にフォームカテゴリーを選択しますが、後から変更することも可能です。 @@ -80,15 +80,15 @@ title: Forms 各フォームは、少なくとも 2つのページで構成されています: - - ページ1: デフォルトで表示されるメインページ - - ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます +- ページ1: デフォルトで表示されるメインページ +- ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます 1つの入力フォームに複数のページを作成することができます。 一画面に納まりきらない数のフィールドや変数がある場合は、これらを表示するためにページを追加することができます。 複数のページを作成すると、以下のようなことが可能になります: - - もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 - - トピックごとに、専用ページにまとめる。 - - [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 - - フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 +- もっとも重要な情報を最初のページに配置し、他の情報を後ろのページに配置する。 +- トピックごとに、専用ページにまとめる。 +- [入力順](formEditor.md#データの入力順)を設定して、データ入力中のスクロール動作を少なくしたり、または不要にする。 +- フォーム要素の周りの空間を広げ、洗練された画面をデザインする。 複数ページは入力フォームとして使用する場合にのみ役立ちます。 印刷出力には向きません。 マルチページフォームを印刷すると、最初のページしか印刷されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md index 3b5a305a52788f..2957ab4f5948ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md @@ -7,11 +7,11 @@ title: フォームエディターマクロ たとえば、定期レポートに特定のフォーマットが指定されている場合 (例: テキストによってフォントカラーが赤や緑であるなど)、マクロを作成してフォントカラーの設定を自動でおこなうことができます。 4Dフォームエディターのマクロでは、次のことがおこなえます: - - 4Dコードを作成・実行する - - ダイアログを表示する - - オブジェクトを選択する - - フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する - - プロジェクトファイルを編集する (更新・削除) +- 4Dコードを作成・実行する +- ダイアログを表示する +- オブジェクトを選択する +- フォームやフォームオブジェクトおよびそれらのプロパティを追加・編集・削除する +- プロジェクトファイルを編集する (更新・削除) フォームエディター用のカスタム機能を定義するため、マクロコードは [クラス関数](Concepts/classes.md) と [JSON のフォームオブジェクトプロパティ](FormObjects/properties_Reference.md) を使用できます。 @@ -237,9 +237,9 @@ Class constructor($macro : Object) フォームオブジェクトの `method` 属性を操作する場合、属性値は2通りの方法で定義できます: - - [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 +- [メソッドファイル名あるいはパスを指定する文字列](FormObjects/properties_Action.md#メソッド) の使用 - - 次の構造を持つオブジェクトの使用: +- 次の構造を持つオブジェクトの使用: | プロパティ | 型 | 説明 | | ------ | ---- | ------- | @@ -251,9 +251,9 @@ Class constructor($macro : Object) `$4dId` プロパティは、現在のページにある各オブジェクトについて一意のIDを定義します。 このキーは`$result.currentPage` の変更を反映させるのに使用されます: - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 - - フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 - - フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在しない場合、そのオブジェクトは作成されます。 +- フォーム上で存在する `$4dId` キーが、`$result` 内には存在しない場合、当該オブジェクトは削除されます。 +- フォーム上および `$result` 内のオブジェクトの両方で `$4dId` キーが存在する場合、そのオブジェクトは変更されます。 #### 例題 @@ -296,8 +296,8 @@ Function onInvoke($editor : Object)->$result : Object マクロの実行時に発生したエラーが、マクロの取り消しを不可能にする内容の場合、マクロは実行されません。 たとえば次のような場合が該当します: - - 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき - - 同じ内部ID を持つオブジェクトを複数作成しようとしたとき +- 読み取り専用ファイルのスクリプトを変更・削除しようとしたとき +- 同じ内部ID を持つオブジェクトを複数作成しようとしたとき #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md index 802f09a55fede7..f99f6a4a11dc2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ title: オブジェクトライブラリ 4D では 2種類のオブジェクトライブラリを利用できます: - - 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます - - カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです +- 標準の設定済みオブジェクトライブラリはすべてのプロジェクトに利用できます +- カスタムオブジェクトライブラリは、開発者自身がお気に入りのフォームオブジェクトや、あるいはプロジェクトフォームそのものをとっておくためのものです ## 標準のオブジェクトライブラリの使用 @@ -21,10 +21,10 @@ title: オブジェクトライブラリ このウィンドウには次の主な機能があります: - - Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 - - 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: +- Tips 付きプレビューエリア: 中央のエリアには各オブジェクトのプレビューが表示されます。 オブジェクトにマウスオーバーすると、オブジェクトに関する情報が Tips として表示されます。 +- 表示オブジェクトは **カテゴリ** メニューを使って絞り込むことができます: ![](../assets/en/FormEditor/library1.png) - - ライブラリのオブジェクトをフォーム上で使うには: +- ライブラリのオブジェクトをフォーム上で使うには: - オブジェクト上で右クリックし、コンテキストメニューから **コピー** を選択してフォーム上で同様に **ペースト** するか、 - ライブラリからフォーム上へと、オブジェクトをドラッグ＆ドロップします。 すると、フォームに当該オブジェクトが追加されます。 @@ -57,13 +57,13 @@ title: オブジェクトライブラリ カスタムのオブジェクトライブラリを開くには、**ファイル** メニューまたはツールバーから **開く > オブジェクトライブラリ...** コマンドを選択します。 標準のファイルを開くダイアログボックスが表示され、オブジェクトライブラリを選択できます。 次のファイルタイプが選択できます: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** カスタムオブジェクトライブラリは、実質的には標準の 4D プロジェクトです。 プロジェクトをライブラリとして開くと、次のものが公開されます: - - プロジェクトフォーム - - フォームのページ1 +- プロジェクトフォーム +- フォームのページ1 ### オブジェクトライブラリの構築 @@ -75,10 +75,10 @@ title: オブジェクトライブラリ ![](../assets/en/FormEditor/library5.png) - - ペーストボードへの **カット** または **コピー** - - ペーストボードからオブジェクトを **ペースト** - - **クリア** でライブラリからオブジェクトを削除 - - **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 +- ペーストボードへの **カット** または **コピー** +- ペーストボードからオブジェクトを **ペースト** +- **クリア** でライブラリからオブジェクトを削除 +- **名称変更** でダイアログが開き、オブジェクトの名前を変更することができます。 ライブラリ内のオブジェクト名は一意のものでなくてはなりません。 オブジェクトライブラリには個々のオブジェクト (サブフォーム含む) やオブジェクトグループを格納できます。 それぞれのオブジェクトは1つのアイテムとしてグループ化されます: @@ -94,9 +94,9 @@ title: オブジェクトライブラリ メインのオブジェクトと一緒にライブラリに登録される依存オブジェクトは以下のとおりです: - - リスト - - フォーマット/フィルター - - ピクチャー - - ヘルプTips (フィールドにリンク) - - オブジェクトメソッド +- リスト +- フォーマット/フィルター +- ピクチャー +- ヘルプTips (フィールドにリンク) +- オブジェクトメソッド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md index a48b9606f1e4aa..7068adb59aaf88 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ title: フォームサイズ ## サイズを決めるもの - - **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 +- **自動サイズ**: フォームサイズは、すべてのオブジェクトを表示するために必要なサイズと、[**水平マージン**](#水平-マージン) および [**垂直マージン**](#垂直-マージン) フィールドへ入力されたマージン値 (ピクセル単位) を合計したものになります。 自動サイズのウィンドウを用いて、オフスクリーンエリア (ウィンドウの矩形境界線の外側のエリア) に配置したアクティブオブジェクトを使用したい場合にこのオプションを選択することができます。 このオプションを選択すると、これらのオブジェクトによりウィンドウサイズが変更されなくなります。 - - **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 +- **サイズを設定**: フォームサイズは [**幅**](#幅) および [**高さ**](#高さ) フィールドに入力された値 (ピクセル単位) により決まります 。 - - `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 +- `<オブジェクト名>`: フォームサイズは、選択したフォームオブジェクトの位置により決まります。 たとえば、表示されるエリアの右下部分に置かれているオブジェクトを選択した場合は、左上端が起点であり、右下端が選択したオブジェクトの右下端となる矩形にマージン値を加算したものがフォームサイズになります。 > 出力フォームの場合は [**水平マージン**](#水平-マージン) または [**幅**](#幅) フィールドだけが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md index 5f5880a86f38e4..0482a54ca27094 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ title: フォームオブジェクト 4D フォームでは多くのビルトイン **アクティブ** オブジェクトおよび **スタティック** オブジェクトが提供されています: - - **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 - - **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 +- **アクティブオブジェクト** はインターフェース機能やデータベースタスクを実行します。 アクティブオブジェクトの種類は、 入力フィールド、コンボボックス、ドロップダウンリスト、ピクチャーボタンなど様々ですが、いずれもデータを表示したり、メモリに一時保存したり、ダイアログボックスを開く・レポートを印刷する・バックグラウンドプロセスを開始するなどの動作を実行したりします。 +- **スタティックオブジェクト** (線、枠、背景ピクチャー等) は一般的に、フォームのアピアランスやラベル、グラフィックインターフェースを設定するために使用されます。 アクティブオブジェクトと異なり、スタティックオブジェクトには変数や式が割り当てられません。 しかし、スタティックオブジェクトにダイナミックオブジェクトを挿入することは可能です。 ## オブジェクトの操作 4D フォームオブジェクトの追加や編集は次の方法でおこなえます: - - **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 +- **[フォームエディター](FormEditor/formEditor.md):** ツールバーからオブジェクトをフォーム上にドラッグ＆ドロップします。 次に、プロパティリストでオブジェクトのプロパティを指定します。 - - **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 +- **4D ランゲージ**: [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) or [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md) などの、`Objects (Forms)` テーマのコマンドを使用することでフォームオブジェクトを作成し、定義することができます。 - - **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 +- **ダイナミックフォーム内の JSON コード:** JSON を使ってプロパティを定義します。 [type](properties_Object.md#type) プロパティでオブジェクトタイプを定義し、提供されている他の [プロパティ](properties_Reference.md) のうち必要なものを設定します。 次はボタンオブジェクトの例です: ```json diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md index 446a08b9f47cbb..437a55aac5db68 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md @@ -44,6 +44,6 @@ title: 入力 フィールドや変数などの式は、フォーム内において入力オブジェクト以外を用いて表示することができます。具体的には以下の方法があります: - - データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 - - [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 - - ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 \ No newline at end of file +- データベースのフィールドから [セレクション型のリストボックス](listbox_overview.md) へと、データを直接表示・入力することができます。 +- [ポップアップメニュー/ドロップダウンリスト](dropdownList_Overview.md) と [コンボボックス](comboBox_overview.md) オブジェクトを使用することによって、リストフィールドまたは変数をフォーム内にて直接表示することができます。 +- ブール型の式は [チェックボックス](checkbox_overview.md) や [ラジオボタン](radio_overview.md) オブジェクトを用いて提示することができます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md index 46ec76d7d18ecf..c908ecfbd2ab1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md @@ -13,8 +13,8 @@ title: 階層リスト 階層リストの中身は次の方法で初期化することができます: - - 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 - - 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 +- 既存の [選択リスト](properties_DataSource.md#選択リスト) を関連づけます。 選択リストはあらかじめデザインモードにてリストエディターを使って定義します。 +- 階層リスト参照を直接 [変数あるいは式](properties_Object.md#変数あるいは式) に設定します。 どちらの場合においても、階層リストはランタイムでは *ListRef* の参照を通して、4D ランゲージの[階層リスト](../commands/theme/Hierarchical_Lists.md) のコマンドを使用して管理します。 @@ -34,9 +34,9 @@ mylist:=New list 特定のリストを使用している複数のフォームオブジェクトがある場合、それらにはそれぞれに固有の性質と、それらの間で共有される性質を持ちます。 以下の性質はリストフォームオブジェクトごとに固有のものです: - - 選択された項目 - - 項目の展開/折りたたみ状況 - - スクロールカーソルの位置 +- 選択された項目 +- 項目の展開/折りたたみ状況 +- スクロールカーソルの位置 それ以外の性質 (フォント、フォントサイズ、スタイル、入力制御、カラー、リストの内容、アイコン等) は他のリストフォームオブジェクトと共有され、個別に変更することはできません。 したがって、展開/折りたたみ状況に基づくコマンドやカレントの項目に関するコマンド、たとえば `Count list items` を (最後の `*` 引数を渡さずに) 使用するとき、どのフォームオブジェクトに対する処理なのかを明示的に指定することが重要です。 @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 他のオブジェクトプロパティ管理コマンドのように、`ListName` 引数で “@” 文字を使用できます。 このシンタックスは、フォーム上の複数のオブジェクトを指定するために使用されます。 しかし階層リストコマンドのコンテキストにおいては、これはすべての場合に適用されるわけではありません。 コマンドのタイプにより、このシンタックスは 2つの異なる効果があります: - - プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 +- プロパティ設定用のコマンドにおいて、このシンタックスは該当する名前のオブジェクトを対象とします (標準の動作)。 たとえば、引数 "LH@" は、オブジェクト名が "LH" で始まる階層リストを指定します。 - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: +- プロパティ取得用のコマンドにおいて、このシンタックスは該当する名前を持つ最初のオブジェクトを対象とします: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) いくつかの 4Dの汎用コマンドを使用して、フォーム上の階層リストオブジェクトの見た目を変更することができます。 これらのコマンドには、\* を用いたシンタックスを使用して階層リストのオブジェクト名を渡すか、あるいは標準シンタックスを使用して階層リストの ListRef 参照を格納している変数を渡します。 - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > 注記: `OBJECT SET SCROLL POSITION` コマンドを除き、これらのコマンドでオブジェクト名を指定したとしても、変更は同じリストを使うすべてのオブジェクトに反映されます。 @@ -107,8 +107,8 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) 階層リストのコンテンツにアクセスするには、通常は位置または参照のいずれかを使用しておこないます。 - - 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 - - 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 +- 位置を使用する場合には、4D は画面上に表示されているリスト項目の位置に基づいて項目を特定します。 つまり、結果は階層項目が展開されているか折りたたまれているかにより異なります。 複数のフォームオブジェクトで同一のリストを使用している場合、オブジェクトごとに展開/折りたたみの状態が異なることに注意が必要です。 +- 参照を使用する場合には、リスト項目の *itemRef* IDを参照します。 これにより、それぞれの項目を階層リスト中での位置や表示状態に関わらず特定できます。 ### 項目参照番号を使用する (itemRef) @@ -141,9 +141,9 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) ユーザーが階層リストの項目を変更できるかどうかを管理することができます。階層リストの項目が修正可能である場合、**Alt+クリック** (Windows) または **Optionキー+クリック** (macOS) ショートカットを使用するか、または項目のテキスト上でロングクリックすると、編集できるようになります。 - - データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 +- データソースに関わらず、階層リストフォームオブジェクト全体を [入力可](properties_Entry.md#入力可) プロパティで管理することができます。 - - また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 +- また、リストエディターで作成したリストを用いて階層リストを生成する場合は、リストエディターの **編集可能項目** オプションを使用して、階層リストの項目の修正が可能かどうかを管理することができます。 詳細については [リストプロパティの設定](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.ja.html#1350157) を参照してください。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md index 799e77238bbea0..f40706e33fa2fb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md @@ -25,12 +25,12 @@ title: サブフォーム このプロパティを使用して、サブフォームで使用する詳細フォームを割り当てます。 以下のものを使用できます: - - ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ +- ウィジェット (ページタイプのサブフォームで、特定の機能を実現するために作成されています)。 この場合、[リストフォーム](#リストフォーム) および [ソース](#ソース) プロパティは存在しないか、空でなくてはいけません。\ コンポーネントで公開されていれば、コンポーネントフォーム名を選べます。 > サブフォームを介して追加の機能を提供する [コンポーネント](Concepts/components.md) を作成することが可能です。 - - [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 +- [リストサブフォーム](#リストフォーム) に関連づける詳細フォーム。 詳細フォームはサブレコードを入力したり表示したりするために使用します。 通常、詳細フォームにはリストサブフォームより多くの情報が含まれています。 詳細フォームは、サブフォームと同じテーブルに属していなければなりません。 典型的には、出力フォームをリストフォーム に、入力フォームを詳細フォームに指定します。 詳細フォームを指定しない場合、4Dは自動でテーブルのデフォルト入力フォームを使用します。 #### JSON 文法 @@ -48,8 +48,8 @@ title: サブフォーム リストサブフォームの空行がダブルクリックされた際に実行されるアクションを指定します。 次のオプションから選択することができます: - - 何もしない: ダブルクリックを無視します。 - - レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 +- 何もしない: ダブルクリックを無視します。 +- レコード追加: サブフォーム中に新規レコードを作成し、編集モードにします。 [リスト更新可](#リスト更新可) オプションが選択されている場合、レコードは直接リスト内に作成されます。 選択されていない場合、レコードはサブフォームに割り当てられた [詳細フォーム](#詳細フォーム) 上に作成されます。 #### JSON 文法 @@ -73,9 +73,9 @@ title: サブフォーム ユーザーがリストサブフォームの行をダブルクリックした際に実行されるアクションを指定します。 選択可能なオプションは以下の通りです: - - **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 - - **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 - - **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 +- **何もしない** (デフォルト): 行をダブルクリックしても自動アクションは発動しません。 +- **レコード編集**: 行をダブルクリックすると、リストサブフォームに設定された [詳細フォーム](#詳細フォーム) に当該レコードが表示されます。 レコードは読み書き可能モードで開かれるので、編集が可能です。 +- **レコード表示**: レコード編集と同様の挙動をしますが、レコードは読み取り専用モードで開かれるため、編集はできません。 選択されているアクションに関わらず、`On Double Clicked` フォームイベントが生成されます。 @@ -153,10 +153,10 @@ title: サブフォーム リストボックス行の選択モードを指定します: - - **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 - - **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ +- **なし**: 行を選択することはできません。 [リスト更新可](#リスト更新可) オプションがチェックされている場合を除き、リストをクリックしても効果はありません。 ナビゲーションキーを使用しても、リストをスクロールするだけとなり、その際に `On Selection Change` フォームイベントは生成されません。 +- **単一**: 一度に一行のみ選択できます。 クリックすることで、行を選択できます。 **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象行の選択状態 (選択・非選択) が切り替わります。\ 上下キーを使うとリストの前後の行が選択されます。 その他のナビゲーションキーはリストをスクロールします。 カレントの行が変更されるたびに、`On Selection Change` フォームイベントが生成されます。 - - **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 +- **複数**: 標準のショートカットを使用して複数行を同時に選択できます。 - 選択されたサブレコードは `GET HIGHLIGHTED RECORDS` で取得できます。 - レコードはクリックにより選択されますが、カレントレコードは変更されません。 - **Ctrl+クリック** (Windows) や **Command+クリック** (macOS) を使うと、対象レコードの選択状態 (選択・非選択) が切り替わります。 上下キーを使うとリストの前後のレコードが選択されます。 その他のナビゲーションキーはリストをスクロールします。 選択レコードが変更されるたびに、`On Selection Change` フォームイベントが生成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md index b5e6f8d3e97ef4..db4b8ddfb3586c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ title: 図形 次の基本の図形が提供されています: - - 四角 - - 線 - - 楕円 +- 四角 +- 線 +- 楕円 ## 四角 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md index 01b27f6fe5dd2a..89558aadffe1d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md @@ -11,10 +11,10 @@ title: スプリッター スプリッターの一般的な特徴をいくつか次に説明します: - - あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 - - スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 - - フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 - - スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 +- あらゆるタイプのフォーム上にスプリッターを必要なだけ設置可能であり、一つのフォーム上で水平と垂直のスプリッターを一緒に使用することができます。 +- スプリッターはオブジェクトを横切ることができます (オーバーラップ)。 スプリッターを動かすと、このオブジェクトのサイズが変更されます。 +- フォーム上で移動されたオブジェクトが完全に表示されたままになるように、また別のスプリッターを超えないように、スプリッターの停止位置が計算されます。 [以降のオブジェクトを移動する](properties_ResizingOptions.md#以降のオブジェクトを移動する) (プッシャー) プロパティをスプリッターに割り当てると、スプリッターを右方向または下方向へ動かしても停止することはありません。 +- スプリッターを使用するフォームのサイズを変更すると、フォームが表示されている間だけ、フォームの新しいサイズが保存されます。 フォームを閉じると、最初の大きさに戻ります。 スプリッターは挿入されると線として表示されます。 その [線のスタイル](properties_BackgroundAndBorder.md#境界線スタイル) を変更してさらに細い線に設定したり、線の種類によっては [線の色](properties_BackgroundAndBorder.md#線カラー) を設定したりすることができます。 @@ -55,8 +55,8 @@ title: スプリッター 各スプリッターには *倍長整数* 型の [変数](properties_Object.md#変数あるいは式) が割り当てられます。 この変数はオブジェクトメソッドやフォームメソッドで使用することができます。 この変数の値により、スプリッターの最初の位置に対する現在位置がピクセル単位で示されます。 - - この値が負数の場合: スプリッターは上または左方向へ移動されました。 - - この値が正数の場合: スプリッターは下または右方向へ移動されました。 - - この値が 0 の場合: スプリッターは元の位置に移動されました。 +- この値が負数の場合: スプリッターは上または左方向へ移動されました。 +- この値が正数の場合: スプリッターは下または右方向へ移動されました。 +- この値が 0 の場合: スプリッターは元の位置に移動されました。 プログラムによってスプリッターを移動させることも可能です。これをおこなうには、関連付けた変数の値を設定します。 たとえば、垂直スプリッターに `split1` という名前の変数が関連付けられている場合、`split1:=-10` という命令を実行すると、ユーザーが手動で動かす場合と同じように、スプリッターは 10ピクセル左方向へ移動します。 移動が実際におこなわれるのは、この命令文が記述されているフォームメソッドまたはオブジェクトメソッドを実行しおわったときです。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md index 2303c2289e500e..8f362edcb1ab32 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md @@ -13,11 +13,11 @@ title: ステッパー ステッパーには数値、時間、日付変数を割り当てることができます。 - - 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: +- 時間型の値では最小、最大、ステップ プロパティは秒を表します。 たとえば、ステッパーを 8:00 から 18:00 まで 10分のステップで設定するには: - [最小](properties_Scale.md#最小) = 28,800 (8\*60\*60) - [最大](properties_Scale.md#最大) = 64,800 (18\*60\*60) - [ステップ](properties_Scale.md#ステップ) = 600 (10\*60) - - 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 +- 日付タイプの値では [ステップ](properties_Scale.md#ステップ) プロパティに入力された値が日数を表します。 最小と最大プロパティは無視されます。 > 時間や日付変数に対してステッパーを動作させるためには、プロパティリストで型を設定するだけでなく、`Time` または `Date` 型として [明示的に宣言](../Concepts/variables.md#変数の宣言) する必要があります。 @@ -29,8 +29,8 @@ title: ステッパー ## 参照 - - [進捗インジケーター](progressIndicator.md) - - [ルーラー](ruler.md) +- [進捗インジケーター](progressIndicator.md) +- [ルーラー](ruler.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md index 42924315d34a8a..140dd6f5bccbe0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ title: サブフォーム サブフォームに実装されたコンセプトを明確に説明するために、いくつかの用語についてここで定義します: - - **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 - - **親フォーム**: 1つ以上のサブフォームを含むフォーム。 - - **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 - - **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 - - **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 - - **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 +- **サブフォーム**: 他のフォームに組み込まれることを意図したフォーム。 +- **親フォーム**: 1つ以上のサブフォームを含むフォーム。 +- **サブフォームコンテナー**: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。 +- **サブフォームインスタンス**: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。 +- **リストフォーム**: データをリストとして表示するサブフォームインスタンス。 +- **詳細フォーム**: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。 ## リストサブフォーム @@ -43,8 +43,8 @@ title: サブフォーム デフォルトで、4D はサブフォームコンテナーに [オブジェクト型](properties_Object.md#式の型式タイプ) の変数あるいは式をバインドし、`Form` コマンドを使ってサブフォームのコンテキストで値を共有できるようにします。 しかし、単一の値のみを共有したい場合は、任意のスカラー型 (時間、整数など) の変数や式を使用することもできます。 - - バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 - - または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 +- バインドするスカラー型の変数あるいは式を定義し、[On Bound Variable Change](../Events/onBoundVariableChange.md) や [On Data Change](../Events/onDataChange.md) フォームイベントが発生したときに、`OBJECT Get subform container value` や `OBJECT SET SUBFORM CONTAINER VALUE` コマンドを呼び出して値を共有します。 この方法は、単一の値を同期させるのに推奨されます。 +- または、バインドされた **オブジェクト** 型の変数あるいは式を定義し、`Form` コマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。 ### 親フォームとサブフォームの同期 (単一値) @@ -58,8 +58,8 @@ title: サブフォーム 時間を静的に表示するには、適切な [データ型](properties_DataSource.md#データタイプ-式の型) を [変数または式](properties_Object.md#変数あるいは式) に使用する必要があります。 - - 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 - - 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 +- 変数 (例: `parisTime`) を使用する場合は、`text` または `time` 型である必要があります。 +- 式 (例: `Form.myValue`) を使用する場合は、`text` 値である必要があります。 テキスト値のフォーマットは "hh:mm:ss" でなくてはなりません。 @@ -91,15 +91,15 @@ End if [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントは以下のときに生成されます: - - 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 - - サブフォームが 0ページまたはカレントフォームページに置かれているとき。 +- 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、 +- サブフォームが 0ページまたはカレントフォームページに置かれているとき。 先の例のとおり、式を直接使用するのではなく、親フォームのサブフォームコンテナーの式の値を取得する `OBJECT Get subform container value` コマンドの利用が推奨されます。親フォームに同じサブフォームを複数配置することが可能だからです (たとえば、複数のタイムゾーンを表示するために時計を複数表示するウィンドウ)。 バインドされた変数あるいは式を変更すると、フォームイベントが発生し、親フォームとサブフォームの値を同期させることができます: - - 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 - - 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 +- 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの [On Bound Variable Change](../Events/onBoundVariableChange.md) フォームイベントを使用します。 +- 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの [On Data Change](../Events/onDataChange.md) フォームイベントを使用します。 #### 親フォームの内容を更新する @@ -177,8 +177,8 @@ End if このようなニーズにこたえるため、4Dは以下のメカニズムを実装しています: - - `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 - - `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 +- `CALL SUBFORM CONTAINER` コマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、 +- `EXECUTE METHOD IN SUBFORM` コマンドを使用してサブフォームのコンテキストでメソッドを実行する。 > `GOTO OBJECT` はサブフォームから実行されても、親フォーム内にて目的のオブジェクトを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md index e8e126265e682c..31fd406343928b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md @@ -42,9 +42,9 @@ macOSの場合、タブコントロールを標準位置 (上) だけでなく タブコントロールにラベルを設定するには、次のものを利用できます: - - オブジェクト - - 選択リスト - - 配列 +- オブジェクト +- 選択リスト +- 配列 ### オブジェクトの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md index cf3f24dced5d66..acd1812e9e7576 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md @@ -33,9 +33,9 @@ title: Text ![](../assets/en/FormObjects/staticText2.png) - - オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 - - オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 - - オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 +- オブジェクトが A 方向にリサイズされるとき、変更されるのは [幅](properties_CoordinatesAndSizing.md#幅) です。 +- オブジェクトが C 方向にリサイズされるとき、変更されるのは [高さ](properties_CoordinatesAndSizing.md#高さ) です。 +- オブジェクトが B 方向にリサイズされるとき、[幅](properties_CoordinatesAndSizing.md#幅) と [高さ](properties_CoordinatesAndSizing.md#高さ) の両方が同時に変更されます。 ## プロパティ一覧 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md index c6ad7de797c35d..bc308e52b40ab0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md @@ -14,9 +14,9 @@ sidebar_label: ログ解析ページ この情報を使用して各操作のソースとコンテキストを識別できます: - - **操作**: ログファイル中での一連の操作番号 +- **操作**: ログファイル中での一連の操作番号 - - **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: +- **アクション**: データに対しておこなわれた操作のタイプ。 この列には以下の操作のいずれかが記録されます: - データファイルを開く: データファイルを開いた - データファイルを閉じる: 開いたデータファイルを閉じた - コンテキストの作成する: 実行コンテキストを指定するプロセスを作成した @@ -30,24 +30,24 @@ sidebar_label: ログ解析ページ - トランザクションのキャンセル: トランザクションをキャンセルした - コンテキストの更新: 追加データを変更した (例: `CHANGE CURRENT USER` あるいは `SET USER ALIAS` の呼び出し) - - **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル +- **テーブル**: 追加/削除/更新されたレコードまたは BLOB の所属テーブル - - **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 +- **プライマリーキー/BLOB**: 各レコードのプライマリーキーのコンテンツ (プライマリーキーが複数のフィールドから構成されているときには、値はセミコロンで区切られています)、またはオペレーションに関連した BLOB のシーケンス番号 - - **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 +- **プロセス**: 処理が実行された内部プロセス番号。 この内部番号は処理のコンテキストに対応します。 - - **サイズ**: 操作により処理されたデータのサイズ (バイト単位) +- **サイズ**: 操作により処理されたデータのサイズ (バイト単位) - - **日付と時刻**: 処理が実行された日付と時刻 +- **日付と時刻**: 処理が実行された日付と時刻 - - **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 +- **システムユーザー**: 操作を実行したユーザーのシステム名。 クライアント/サーバーモードでは、クライアントマシン名が表示されます。シングルユーザーモードでは、ユーザーのセッション名が表示されます。 - - **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 +- **4Dユーザー**: 操作を実行したユーザーの 4Dユーザー名。 ユーザーに対してエイリアスが設定されていた場合、4Dユーザー名の代わりのそのエイリアスが表示されます。 - - **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ +- **値**: レコードの追加や更新の場合、フィールドの値。 値はセミコロン “;” で区切られます。 文字形式に表現できる値のみを表示します。\ ***注**: データベースが暗号化されており、開かれたログファイルに対応する有効なデータキーが提供されていない場合、暗号化された値はこのカラムには表示されません。* - - **レコード**: レコード番号 +- **レコード**: レコード番号 選択したアプリケーションのカレントログファイル (デフォルトで "データファイル名.journal" というファイル名) の内容を更新するには **解析** をクリックします。 ブラウズボタンをクリックすると、アプリケーションの他のログファイルを選択できます。 **書き出し...** ボタンを使用してファイルの内容をテキストとして書き出せます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md index 24e5228e57e8c6..a95c87ac97d369 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md @@ -51,13 +51,13 @@ sidebar_label: 修復ページ "データファイル中で見つかったレコード" エリアには 2つのリストがあり、データスキャン結果の概要が表示されます。 - - 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: +- 左のリストには、データファイルスキャンの情報が表示されます。 各行には、データファイル中の再生可能なレコードのグループが表示されます: - **順番** の列には、レコードグループの再生順が表示されます。 - **カウント** 列には、グループに含まれるレコード数が表示されます。 - **割当先テーブル** 列には、識別されたレコードのグループに割り当てられたテーブルの名前が表示されます。 割り当てられたテーブルの名前は自動で緑色で表示されます。 割り当てされなかったグループ、つまりどのレコードにも関連づけることができなかったテーブルは赤色で表示されます。 - **再生** 列では、レコードを再生するかどうかを各グループごとに指定できます。 デフォルトで、テーブルに割り当てられるすべてのグループが選択されています。 - - 右側のリストには、プロジェクトファイルのテーブルが表示されます。 +- 右側のリストには、プロジェクトファイルのテーブルが表示されます。 ### 手動による割り当て @@ -74,7 +74,7 @@ sidebar_label: 修復ページ 修復が完了すると、4D はプロジェクトの Logsフォルダーにログファイルを生成します。 このファイルを使用すると実行されたオペレーションをすべて閲覧することができます。 このファイルは XML形式で作成され、ApplicationName_Repair_Log_yyyy-mm-dd hh-mm-ss.xml というファイル名がつけられます。 - - *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) - - *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 +- *ApplicationName* は拡張子を除いたプロジェクトファイルの名前です (例: "Invoices" 等) +- *yyyy-mm-dd hh-mm-ss* はファイルのタイムスタンプです。これはローカルのシステム時間でメンテナンスオペレーションが開始された時刻に基づいています (例: "2019-02-11 15-20-45")。 **ログファイルを開く** ボタンをクリックすると、4Dはマシンのデフォルトブラウザーを使用して直近のログファイルを開きます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md index f04f9165350aaa..b751554c4bdddd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md @@ -11,8 +11,8 @@ title: メニュープロパティ メニューエディターを使って、テキストリテラルを直接、ラベルとして入力することができます。 または、変数参照、xliff参照を使用することもできます。これによりアプリケーションの翻訳が容易になります。 次のの参照タイプを使用できます: - - :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 - - `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 +- :xliff:MyLabel という形の XLIFFリソース参照。 XLIFF参照についての詳細は、*4D デザインリファレンス* の [XLIFF アーキテクチャー](https://doc.4d.com/4Dv18/4D/18/Appendix-B-XLIFF-architecture.300-4575737.ja.html) の章を参照ください。 +- `:<>vlang,3` という形のインタープロセス変数名と、それに続く数値。 この変数の内容を変更すると、メニューが表示される際にラベルも変更されます。 この場合、ラベルは XLIFFリソースを呼び出します。 `<>vlang` 変数に含まれる値は *group* 要素の *id* 属性値に対応します。 二つ目の値 (例では3) は *trans-unit* 要素の *id* 属性の値を指定します。 4Dランゲージを使う場合は、`APPEND MENU ITEM`、`INSERT MENU ITEM`、および `SET MENU ITEM` コマンドの *itemText* パラメーターでタイトルプロパティを設定します。 @@ -53,8 +53,8 @@ title: メニュープロパティ メニューエディターにて、標準アクション/プロジェクトメソッドをメニューに割り当てることができます: - - **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 - - **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 +- **メソッド名**: 既存のプロジェクトメソッドをコンボボックスで選択します。 プロジェクトメソッドがまだ存在しない場合、"メソッド名" コンボボックスにメソッド名を入力し、[...] ボタンをクリックします。 すると、4D はメソッド作成ダイアログボックスを表示し、コードエディターを開きます。 +- **標準アクション**: 割り当てたいアクションを "標準アクション" コンボボックスから選択するか、記述します。 サポートされているアクションと引数 (任意) であれば、エリア内に入力することができます。 標準アクションの一覧については、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv18/4D/18/Standard-actions.300-4575620.ja.html) を参照してください。 **macOS に関する注記:** macOS の場合、プラットフォームインタフェース標準に合わせるために、*quit* (終了) アクションが割り当てられたカスタムメニューコマンドは自動でアプリケーションメニュー内に置かれます。 4Dランゲージで割り当てをおこなう場合、プロジェクトメソッドには `SET MENU ITEM METHOD` コマンド、標準アクションには `SET MENU ITEM PROPERTY` コマンドを使います。 @@ -101,13 +101,13 @@ title: メニュープロパティ ショートカットには **Shift** や **Alt** (Windows) または **Option** (macOS) キーを追加できます。 これにより使用できるショートカットの数を増やすことができます。 以下のタイプのショートカットを定義できます: - - Windows: +- Windows: - Ctrl+文字 - Ctrl+Shift+文字 - Ctrl+Alt+文字 - Ctrl+Shift+Alt+文字 - - macOS: +- macOS: - Command+文字 - Command+Shift+文字 - Command+Option+文字 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md index af533d8087f8d1..8e895c30695377 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md @@ -9,19 +9,19 @@ title: リリースノート #### ハイライト - - [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 - - ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 - - 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 - - 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 - - インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 - - [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 - - 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 - - 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) - - Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 - - [*MeCab* ライブラリー](../settings/database.md#support-of-mecab-japanese-version) (日本語言語における並べ替え/検索に使用) は廃止予定となり、そのサポートは次のリリースにおいて削除される予定です。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 +- [`Session.createOTP()`](../API/SessionClass.md#createotp) および[`Session.restore()`](../API/SessionClass.md#restore) の新関数を使用して管理することで、[セッショントークン](../WebServer/sessions.md#session-token-otp) がサポートされるようになりました。 +- ラベルウィザードは、[ラベルデザインエリア](../Desktop/labels.md#ラベルプレビューエリア) においてフォーミュラを追加または編集する際にフォーミュラエディターを使用するようになりました。 +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- [ライブチェッカーとコンパイラー](../code-editor/write-class-method.md#warnings-and-errors).において、廃止予定のコマンドと定数は、特定の警告を生成するようになりました。 [`Command name`](../commands/command-name.md) コマンドを使用することで、コマンドが廃止予定かどうかを知ることができます。 +- 新しいコマンド[WA SET CONTEXT](../commands/wa-set-context.md) および [WA Get context](../commands/wa-get-context.md) を使用して、Web エリア内の[$4d](../FormObjects/webArea_overview.md#4d-object) コンテンツを管理することができるようになります。 +- 新しい[`RDP optimization` データベースパラメーター](../commands-legacy/set-database-parameter.md#rdp-optimization-133) を使用して、例えば4D をリモートデスクトッププロトコルを使用している場合の共有クリップボードを最適化することができます。 +- インタープリタ版のコンポーネントは[ホストプロジェクトから編集する](../Extensions/develop-components.md#コンポーネントをホストから編集する) ことが可能になりました。 +- [ライセンス](../Admin/licenses.md) は起動時に自動的に更新されるようになりました。 +- 新しい[4D AIKit コンポーネント](../aikit/overview.md) を使用することでサードパーティAI のAPI とやり取りをすることが可能になります。 +- 以下のVP コマンドのコールバックは、4D カスタム関数がその計算を全て終えるのを待つようになりました: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md)、[VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md)、および [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md) +- Google およびMicrosoft 365 カレンダーを管理するための新しい[4D Netkit](https://developer.4d.com/4D-NetKit/) 機能。OAuth 2.0 認証のためのホストWeb サーバーを使用する機能。 +- [*MeCab* ライブラリー](../settings/database.md#support-of-mecab-japanese-version) (日本語言語における並べ替え/検索に使用) は廃止予定となり、そのサポートは次のリリースにおいて削除される予定です。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R9): 4D 20 R9 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2025/99/release-note-version-20r9//))。 ## 4D 20 R8 @@ -29,29 +29,29 @@ title: リリースノート #### ハイライト - - [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 - - [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 - - [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 - - [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 - - [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 - - Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) - - ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーションをビルド) することができるようになりました。 - - 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 - - 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 - - [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 - - 4D Write Pro: +- [`4D.IncomingMessage`](../API/IncomingMessageClass.md) class を使用して独自の[**HTTP request handlers**](../WebServer/http-request-handler.md) を実装することができます。 +- [フォームオブジェクトプロパティ](../FormObjects/propertiesReference.md) は、[プロパティリスト](../FormEditor/formEditor.md#プロパティリスト) と[コンパイラー](../Project/compiler.md#シンタックスチェック)においてシンタックスチェックの恩恵を受けることができるようになりました。 +- [フォームにクラスを割り当てる](../FormEditor/properties_FormProperties.md#フォームクラス) ことで、[`Form`](../commands/form.md) コマンドを使用しているときにタイプアヘッドとフォームデータの自動インスタンス化を有効化することができるようになります。 +- [スタンドアロンセッション](../API/SessionClass.md) のサポート。これによりクライアント/サーバーアプリケーションのローカルなコーディングが単純化されます。 +- [4D デバッガ](../Debugging/debugger.md): 新デザイン、自動保存、表示モードなどの新機能 +- Apple 公証ガイドラインにより合致する[新しくビルトされたコンポーネントアーキテクチャ](../Desktop/building.md#build-component) +- ビルドアプリケーションダイアログボックスから、簡単に[評価版アプリケーションをビルド](../Desktop/building.md#評価版アプリケーションをビルド) することができるようになりました。 +- 依存関係: 依存関係マネージャーを使用して、GitHub 上のコンポーネントの[新バージョンをチェック](../Project/components.md#新バージョンをチェック) したり[更新する](../Project/components.md#依存関係の更新) ことができます。 +- 新しい [`TCPConnection`](../API/TCPConnectionClass.md) および [`TCPEvent`](../API/TCPEventClass.md) クラスを使用してTCP クライアント接続を管理したり、イベントを管理したり、データ転送のコントロールを改善することができます。 追加された[`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) を使用することでTCP イベントの詳細なログを取ることができます。 +- [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) および [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) の新しいオプションを使用して、スタイル、フォーミュラ、データ整合性、そしてパスワードによる保護などを管理することができます。 +- 4D Write Pro: - 以下のコマンドが、引数としてオブジェクトまたはコレクションを受け取れるようになりました: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md)、[WP Get attributes](../WritePro/commands/wp-get-attributes.md)、[WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md)、[WP Table append row](../WritePro/commands/wp-table-append-row.md)、 [WP Import document](../WritePro/commands/wp-import-document.md)、 [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md)、 [WP Add picture](../WritePro/commands/wp-add-picture.md)、および [WP Insert picture](../WritePro/commands/wp-insert-picture.md) - [WP Insert formula](../WritePro/commands/wp-insert-formula.md)、 [WP Insert document body](../WritePro/commands/wp-insert-document-body.md)、および [WP Insert break](../WritePro/commands/wp-insert-break.md) はレンジを返す関数になりました(頭文字のみ大文字です)。 - ドキュメント属性に関連した新しい式: [This.sectionIndex](../WritePro/managing-formulas.md)、 [This.sectionName](../WritePro/managing-formulas.md) および[This.pageIndex](../WritePro/managing-formulas.md) - - 4Dランゲージ: +- 4Dランゲージ: - 変更されたコマンド: [`FORM EDIT`](../commands/form-edit.md) - [4D.CryptoKey class](../API/CryptoKeyClass.md) の[`.sign()`](../API/CryptoKeyClass.md#sign) および [`.verify()`](../API/CryptoKeyClass.md#verify) 関数は *message* 引数においてBlob をサポートするようになりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R8): 4D 20 R8 で修正されたバグのリストです(日本語版は [こちら](https://4d-jp.github.io/2024/360/release-note-version-20r8/))。 #### 動作の変更 - - [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 - - [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 +- [`SELECT LOG FILE`](../commands/select-log-file.md) コマンドあるいは [バックアップ設定](../Backup/settings.md#ログ管理) を使用してログファイルを変更したあと、[`New log file`](../commands/new-log-file.md) コマンドは、バックアップを待たずに変更を検証するようになりました。 エラー -4447 (バックアップが必要です) は発生しなくなりました。 +- [新アーキテクチャ](../Desktop/building.md#build-component) 導入の影響により、4D 20 R8 以降でビルドされたコンポーネントはそれ以前の4D リリースへとインストールすることはできません。 ## 4D 20 R7 @@ -59,31 +59,31 @@ title: リリースノート #### ハイライト - - 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 - - [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 - - [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 - - コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 - - [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 - - 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 - - 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 - - Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 - - 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の +- 時間型のリストボックスの列とヘッダーは、["blankIfNull" オプション](../FormObjects/properties_Display.md#時間フォーマット) をサポートするようになりました。 +- [`.getBoxInfo()`](../API/IMAPTransporterClass.md#getboxinfo) and [`.getBoxList()`](../API/IMAPTransporterClass.md#getboxlist) に新しいプロパティが追加されました。 +- [コンポーネントマネージャーのインターフェースを使用してコンポーネントを追加および削除](../Project/components.md#プロジェクトの依存関係のモニタリング) できるようになりました。 +- コンパイラー設定の新しい [**直接型指定モード**](../Project/compiler.md#直接型指定の有効化): コード内のすべての変数および引数を `var` と `#DECLARE`/`Function` キーワードで宣言します (新規プロジェクトではこのモードのみサポートされます)。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 これに伴い、[シンタックスチェック機能](../Project/compiler.md#シンタックスチェック) が強化されました。 +- [セッションシングルトン](../Concepts/classes.md#シングルトンクラス) と、新しい [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) クラスプロパティをサポート。 +- 新しい[`onHTTPGet` 関数キーワード](../ORDA/ordaClasses.md#onhttpget-keyword) を使用して[HTTP REST GET requests](../REST/ClassFunctions.md#function-calls) 経由で呼び出し可能なシングルトンまたはORDA 関数を定義できるようになりました。 +- 新しい [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) クラスを使用してREST サーバーがあらゆるWeb コンテンツを返すようになりました。 +- Qodly Studio: [Qodly Studio デバッガーを 4D Server で有効化](../WebServer/qodly-studio.md#4d-server-で-qodlyデバッガーを使用する) できるようになりました。 +- 4Dクライアントアプリケーション用の新しいアプリケーションビルド XMLキー: 接続時にサーバーから送信される証明書について、認証局の 署名 や [ドメイン](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.ja.html) を検証するためのキーが追加されました。 - - [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 - - 4Dランゲージ: +- [埋め込みライセンスなしでスタンドアロンアプリケーションをビルドすること](../Desktop/building.md#licenses) が可能になりました。 +- 4Dランゲージ: - 新コマンド: [Process info](../commands/process-info.md)、 [Session info](../commands/session-info.md)、 [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - 変更されたコマンド: [Process activity](../commands/process-activity.md)、 [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands-legacy/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - 新コマンド: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - 変更されたコマンド: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) および [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R7): 4D 20 R7 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/274/release-note-version-20r7/))。 #### 動作の変更 - - [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 - - [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 - - [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 +- [4Dランゲージ](../commands/command-index.md) よび [4D Write Pro ランゲージ](../WritePro/commands/command-index.md) のドキュメントが、developer.4d.com で利用できるようになりました。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 これらのドキュメントに関する新機能と変更点については、このリリースノートを参照ください。 +- [`File`](../commands/file.md) コマンド (および [`4D.File.new()`](../API/FileClass.md#4dfilenew) コマンド) は、引数として与えられた *path* のシンタックスをより厳しくチェックする様になりました。 +- [permission](../ORDA/privileges.md#permission-actions) の利用可能なアクションから、**describe** アクションが削除されました。 [`/rest/$catalog`](../REST/$catalog.md) URL へのアクセスは制御されなくなりました。 Session の *describe* 権限は今後は無視されます。 ## 4D 20 R6 @@ -91,25 +91,25 @@ title: リリースノート #### ハイライト - - [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 - - [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs) を介して、ホストプロジェクトに読み込まれているすべてのコンポーネント間で自動的に共有されるようになりました。 - - コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 - - 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 - - セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 - - [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 - - 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 - - サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 - - 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 - - プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 - - [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 - - 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 - - PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 +- [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 +- [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs) を介して、ホストプロジェクトに読み込まれているすべてのコンポーネント間で自動的に共有されるようになりました。 +- コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 +- 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 +- セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 +- [4DCEFParameters.jsonファイル](../FormObjects/webArea_overview.md#4dcefparametersjson) が新しく追加されました。これにより、4D埋め込みWebエリアをカスタマイズすることができます。 +- 新しい [HTTPAgent](../API/HTTPAgentClass.md) クラスと、HTTPRequest クラスの新しい [`agent`](../API/HTTPRequestClass.md#options-引数) プロパティ。 +- サーバーから Qodlyのページの状態を監視するための新しい [`enableState()`](../API/WebFormClass.md) と [`disableState()`](../API/WebFormClass.md) 関数。 +- 公開されたシングルトン関数を REST で呼び出すための新しい [`$singleton` API](../REST/$singleton.md) と、それに伴う新しい [権限](../ORDA/privileges.md) が追加されました。 +- プロジェクトを "強制ログイン" RESTモードにアップグレードするための [新しい設定ボタン](../settings/web.md#dsauthentify-関数によって-rest認証を有効化する) が追加されました (`On REST Authentication`データベースメソッドは非推奨となりました)。 +- [新しい設定タブ](../Project/compiler.md#警告) を使用して、警告の生成をグローバルに定義できます。 +- 主に"4D 環境"テーマからのコマンドを含めたいくつかのコマンドがスレッドセーフになったとともに、[`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) コマンドのいくつかもセレクターもスレッドセーフとなりました。 +- PDF/A3 ドキュメントから添付ファイルを抽出する `PDF Get attachments` コマンドを提供する新しい [4D-QPDF コンポーネント](https://github.com/4d/4D-QPDF)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R6): 4D 20 R6 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/178/release-note-version-20r6/))。 #### 動作の変更 - - フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 - - [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 +- フォーム内のスクロールチェーンをサポート: 埋め込まれたスクロール可能なオブジェクト ([縦スクロールバー](../FormObjects/properties_Appearance.md#縦スクロールバー)・[横スクロールバー](../FormObjects/properties_Appearance.md#横スクロールバー)) がスクロール境界に達しても、マウスやトラックパッドを使用してユーザーがスクロールを続ける場合、親サブフォームは自動的にスクロールします (オーバースクロール)。 +- [`$catalog` REST API](../REST/$catalog.md) は、シングルトンを返すようになりました (あれば)。 ## 4D 20 R5 @@ -117,21 +117,21 @@ title: リリースノート #### ハイライト - - 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 - - [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 - - QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 - - [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 - - [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). - - [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 - - RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 - - 新しい [$format](../REST/$format.md) RESTパラメーター。 - - [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 +- 新しい [コンポーネントマネージャー](../Project/components.md) は、`dependencies.json` ファイルを介してコンポーネントを管理します。 +- [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try) エラー処理構文のサポート。 +- QUICネットワークレイヤーは [ブロードキャスト](../Desktop/clientServer.md#リモートプロジェクトを開く)、[SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.ja.html)、および [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.ja.html) に対応しました。 +- [制限付エンティティセレクション](../ORDA/entities.md#制限付エンティティセレクション) をサポート。 +- [共有クラス](../Concepts/classes.md#共有クラス) と [シングルトンクラス](../Concepts/classes.md#シングルトンクラス) をサポート。 新しいクラスプロパティ: [`.isShared`](../API/ClassClass.md#isshared), [`.isSingleton`](../API/ClassClass.md#issingleton), [`.me`](../API/ClassClass.md#me). +- [クラスプロパティを宣言の行において初期化すること](../Concepts/classes.md#initializing-the-property-in-the-declaration-line) がサポートされるようになりました。 +- RESTリクエスト用の新しい [強制ログインモード](../REST/authUsers.md#強制ログインモード) と、[Qodly Studio for 4D での専用サポート](../WebServer/qodly-studio.md#強制ログイン)。 +- 新しい [$format](../REST/$format.md) RESTパラメーター。 +- [`Session`](../commands/session.md) オブジェクトはリモートユーザーセッションおよびすトアドプロシージャーセッションにおいても利用可能になりました。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R5): 4D 20 R5 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/122/release-note-version-20r5/))。 #### 動作の変更 - - *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 - - ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 +- *4D Internet Commands* および *4D for OCI* プラグインは、4Dインストーラーに含まれなくなりました。 これらのプラグインを入手するには、[**4D製品ダウンロードポータル**](https://product-download.4d.com/) に接続する必要があります。 +- ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、`catalog_editor.json` という個別ファイルに保存されるようになりました。このファイルはプロジェクトの [`Sources`フォルダー](../Project/architecture.md#sources) に保存されます。 ## 4D 20 R4 @@ -139,24 +139,24 @@ title: リリースノート #### ハイライト - - TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 - - クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 - - HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 - - 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 - - `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 - - [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート - - 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 - - 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 - - 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 - - データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 +- TLS証明書の [`ECDSA` 暗号化形式](../Admin/tls.md#暗号化) をサポート。 +- クライアント/サーバーおよび SQLサーバーの TLS接続は、[動的に設定](../Admin/tls.md#他のサーバーで-tls-を有効にする) されるようになりました (証明書ファイルは必要ありません)。 +- HTML への直接の [ストラクチャー定義の書き出し](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.ja.html) をサポート。 +- 実行エラーを防ぐため、コード入力、シンタックスチェック、およびコンパイルステップにおけるコード管理を強化する新しい [コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー)。 +- `#DECLARE` プロトタイプ内で宣言されたメソッド引数は["Compiler_" メソッドでは不要になりました](../Concepts/parameters.md)。 +- [日付・時間のカスタムフォーマット](../Project/date-time-formats.md) をサポート +- 新しい [`Try(expression)` キーワード](../Concepts/error-handling.md#tryexpression) で単純なエラーケースを処理できます。 +- 新しい[`HTTP Parse message`](../commands/http-parse-message.md) コマンド。 +- 新しい [ノンブロッキング印刷](../settings/compatibility.md) 互換性オプション。 +- データエクスプローラーの新しい [編集モード](../Admin/dataExplorer.md#データの編集)。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R4): 4D 20 R4 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2024/4/release-note-version-20r4/))。 #### 動作の変更 - - 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 - - セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 - - 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 - - [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 +- 引数を宣言するための従来のシンタックス (例: `C_TEXT($1)` や `var $1 : Text`) は非推奨となり、コードの入力時、シンタックスチェック、コンパイル時に警告が生成されます。 +- セレクション内レコードの削除後に、別レコードが新規作成された場合でも、セレクションの一貫性が保持されるようになりました ([このブログ記事](https://blog.4d.com/ja/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/) を参照ください)。 +- 更新された [OpenSSL ライブラリ](#ライブラリの一覧) では、デフォルトの SSL/TLS セキュリティレベルが 1 から 2 に変更されました。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 1024ビット以上2048ビット未満のRSA、DSA、DH鍵、および 160ビット以上224ビット未満の ECC鍵は使用できなくなりました。 デフォルトでは、以前の OpenSSLバージョンですでに TLS圧縮が無効にされていました。 セキュリティレベル2では、これを有効化できません。 +- [4D ユーザーがbcrypt アルゴリズムを使用できる](https://blog.4d.com/bcrypt-support-for-passwords/) ようにするため、[`Open datastore`](../commands/open-datastore.md) コマンドの*connectionInfo* 引数内の"password" の値はデフォルトでは平文で送信されるようになりました。 そのため、"On REST authentication" データベースメソッドがパスワードを平文で扱えるようにすること(そのため第3引数は**False** となります)と、`Open datastore` の*connectionInfo* の"tls" オプションに**True** を渡すことで接続を暗号化するようにすることを忘れないようにして下さい。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../commands/open-datastore.md) コマンド参照)。 ## 4D 20 R3 @@ -164,21 +164,21 @@ title: リリースノート #### ハイライト - - 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 - - Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). - - [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 - - データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 - - ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 - - [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 - - ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 - - [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 +- 新しい [`collection.multiSort()`](../API/CollectionClass.md#multisort) 関数を追加しました。 +- Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). +- [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew) の *connectionHandler* パラメーターで `headers` プロパティをサポート。 +- データ同期モジュールの実装に役立つ [グローバル変更スタンプ](../ORDA/global-stamp.md)。 新しい [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) と [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp) 関数が追加されました。 +- ピクチャー/BLOB 属性にファイル参照を代入することが、[ORDA でサポートされるようになりました](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes)。 +- [宣言と同時に変数のデータ型と値を初期化](../Concepts/variables/#宣言と同時に変数を初期化する) できるようになりました。 +- ログファイルの設定は、[カレントデータファイル](../Backup/settings.md#ログ管理) とともに保存されるようになりました。 +- [可変長引数を宣言するための新しいシンタックス](../Concepts/parameters.md#可変長引数の宣言) +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-from-blob) および [エクスポート](../ViewPro/commands/vp-export-to-blob) で Blob形式をサポート。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R3): 4D 20 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 #### 動作の変更 - - いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 - - 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 +- いくつかのエラーは、[エラー処理メソッド](../Concepts/error-handling.md) によってインタプリタモードのみでキャッチ可能でした。 この問題の修正後、以下のエラーがコンパイルモードでも検出されるようになりました: *範囲外のインデックス*、*互換性のない型*、*Null ポインターの逆参照*。 ただし、Intelプロセッサーでは、このようなエラーによって以前と同様に処理が中断されますが、Apple Siliconプロセッサーでは、[`ABORT`](../commands-legacy/abort.md) コマンドを呼び出さない限り、処理は中断されません。 +- 4D は内部的な PHPインタプリターを実装しなくなりました。 PHPコマンドを使用するには、[別途PHPインタプリターをセットアップして実行する](https://blog.4d.com/ja/deprecation-of-php-commands-removal-of-4d-built-in-php-interpreter) 必要があります。 ## 4D 20 R2 @@ -192,15 +192,15 @@ title: リリースノート #### ハイライト - - 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 - - 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 - - 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 - - 4Dランゲージコマンド: doc.4d.com の [新着](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.ja.html) ページ。 - - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 +- 4D から WebSocketクライアント接続を作成および管理するための、新しい [WebSocket](../API/WebSocketClass.md) クラス。 +- 新しい QUICネットワークレイヤー [インタフェース設定](../settings/client-server.md#ネットワークレイヤー)。 +- 4D View Pro:ドキュメントの [インポート](../ViewPro/commands/vp-import-document) および [エクスポート](../ViewPro/commands/vp-export-document) で **.sjs** ファイル形式をサポート。 +- 4Dランゲージコマンド: doc.4d.com の [新着](https://doc.4d.com/4Dv20R2/4D/20-R2/What-s-new.901-6398284.ja.html) ページ。 +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R2): 4D 20 R2 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/178/release-note-version-20r2/))。 #### 動作の変更 - - **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 +- **警告**: [4D.FileHandle](../API/FileHandleClass.md) オブジェクトの [`offset`](../API/FileHandleClass.md#offset) の開始値が誤って 0 ではなく 1 に設定されていました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 **20.1 HF1** および **20 R2** のバージョンで 4D が修正され、この値が 0 になりました。 ## 4D 20.x LTS diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md index d95ad27ca22a23..440d7232052353 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md @@ -34,8 +34,8 @@ title: グローバルスタンプの使い方 また、本機能を適切に動作させるためには、以下の条件が必要です: - - `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 - - 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: +- `__GlobalStamp` フィールドは、*自動インデックス*、*RESTリソースとして公開*、および *非表示* プロパティが選択された、*64ビット整数* である必要があります。 +- 次のフィールドを含む `__DeletedRecords` テーブルを追加する必要があります: | フィールド | 型 | 説明 | | ------------------------------------------------------- | --------------- | -------------------- | @@ -64,8 +64,8 @@ title: グローバルスタンプの使い方 すると、4D は次の変更をおこないます: - - 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 - - まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 +- 設定済みの `__GlobalStamp __01` フィールドがテーブルに追加されます。 +- まだ存在していなければ、`__DeletedRecords` テーブルがストラクチャーに追加されます。 データ変更追跡を無効化するには: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md index ae528cae6cea46..2b7347d927405d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ title: リモートデータストア `localID` はリモートデータストアに接続しているマシンにおけるローカルな識別IDです: - - 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 - - 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 - - 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 +- 同じアプリケーションの別プロセスが同じリモートデータストアに接続する場合、`localID` とセッションは共有することができます。 +- 同じアプリケーションの別プロセスが別の `localID` を使って同じデータストアに接続した場合、リモートデータストアでは新しいセッションが開始されます。 +- 他のマシンが同じ `localID` を使って同じデータストアに接続した場合、新しいセッションが新しい cookie で開始されます。 これらの原則を下図に示します: @@ -29,9 +29,9 @@ title: リモートデータストア データストアアクセスを管理しているセッションは 4D Server の管理ウィンドウに表示されます: - - プロセス名: "REST Handler: \" - - タイプ: HTTP Server Worker - - セッション: `Open datastore` コマンドに渡されたユーザー名 +- プロセス名: "REST Handler: \" +- タイプ: HTTP Server Worker +- セッション: `Open datastore` コマンドに渡されたユーザー名 次の例では、1つのセッション上で 2つのプロセスが実行中です: @@ -47,11 +47,11 @@ title: リモートデータストア エンティティロッキングやトランザクションに関連した ORDA 機能は、ORDA のクライアント / サーバーモードと同様に、リモートデータストアにおいてもプロセスレベルで管理されます: - - あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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`). +- あるプロセスがリモートデータストアのエンティティをロックした場合、セッションの共有如何に関わらず、他のすべてのプロセスに対してそのエンティティはロックされた状態です ([エンティティロッキング](entities.md#エンティティロッキング) 参照)。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 1つのプロセスによってロックされている場合、同プロセス内でそれらがすべてアンロックされないと、ロックは解除されません。 なお、ロックされたエンティティに対する参照がメモリ上に存在しなくなった場合にも、ロックは解除されます。 同一のレコードに対応する複数のエンティティが 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-R9/Preferences/general.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md index 80cf6ccf197bb5..ad50707a4c445f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md @@ -11,12 +11,12 @@ title: 一般ページ このオプションは、ユーザーがアプリケーションのみを起動したとき、4D が起動時に提供するデフォルトの表示を設定することができます。 - - **何もしない**: アプリケーションウィンドウのみが表示されます。 - - **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 - - **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 +- **何もしない**: アプリケーションウィンドウのみが表示されます。 +- **ローカルプロジェクトを開くダイアログ**: 4Dは標準のドキュメントを開くダイアログボックスを表示し、ローカルのプロジェクトを選択することができます。 +- **最後に使用したプロジェクトを開く**: 4D は最後に使用されたプロジェクトスを直接開きます。ドキュメントを開くダイアログボックスは表示されません。 > このオプションが選択されているときに、ドキュメントを開くダイアログボックスを強制的に表示させるには、プロジェクトを起動する際に、**Alt** (Windows) または **Option** (macOS) キーを押します。 - - **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 - - **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 +- **リモートプロジェクトを開くダイアログ**: 4D は 4D Server にログオンする標準のダイアログボックスを表示し、ネットワークに公開されたプロジェクトを指定することができます。 +- **Welcomeウィザードを開くダイアログ** (初期設定): 4D は Welcomeウィザードダイアログボックスを表示します。 > **4D Server**: 4D Server アプリケーションは、このオプションを無視します。 この環境においては、**何もしない** モードが常に選択されます。 @@ -30,8 +30,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド この機能は、以下の環境において利用することができます (4D 64-bit版のみ): - - コードエディターウィンドウ - - フォームエディターウィンドウ +- コードエディターウィンドウ +- フォームエディターウィンドウ これらのエディターのウィンドウはすべて、タブ形式にすることができます: @@ -47,9 +47,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 - - **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 - - **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 +- **システム設定に従う** (デフォルト): 4D のウィンドウは、macOSシステム環境設定で定義されているように振る舞います (フルスクリーン時のみ、常に、あるいは手動)。 +- **しない**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいウィンドウを作成します (タブは作成されません)。 +- **常にする**: 4Dフォームエディターあるいはコードエディターで開かれた新しいドキュメントは常に新しいタブを作成します。 ### アピアランス (macOSのみ) @@ -59,9 +59,9 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド 次の値が提供されています: - - **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 - - **Light**: ライトテーマを使用します。 - - **Dark**: ダークテーマを使用します。 +- **システムのカラースキーム設定に合わせる** (デフォルト): macOSシステム環境設定で定義されているカラースキームを使用します。 +- **Light**: ライトテーマを使用します。 +- **Dark**: ダークテーマを使用します。 > この設定は macOS でのみサポートされています。 Windows上では、"Light" テーマが常に使用されます。 @@ -73,8 +73,8 @@ macOS Sierra 以降、Mac のアプリケーションは、複数のウィンド このオプションをチェックすると、**ファイル ＞ 新規** メニューと、ツールバーの **新規** ボタンに、2つの項目が追加されます: - - **データベース...** - - **ストラクチャー定義を使用したデータベース...** +- **データベース...** +- **ストラクチャー定義を使用したデータベース...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ These items allow you to create binary databases (see [Creating a new database]( このエリアでは、カレントブラウザーに表示される 4D HTMLドキュメントへのアクセスを設定します: - - コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき - - エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき +- コードエディターで、4Dクラス関数またはコマンド名にカーソルがあるときに、**F1**キーを押したとき +- エクスプローラーの **コマンドページ** 上の 4Dコマンドをダブルクリックしたとき ### ドキュメント言語 @@ -151,8 +151,8 @@ These items allow you to create binary databases (see [Creating a new database]( 4Dがドキュメントのページを探す場所を設定します。 - - チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 - - チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 +- チェックされている場合 (デフォルト)、4D はまずローカルフォルダーでページを探します (後述参照)。 ページが見つかれば、4D はそのページをカレントブラウザーで表示します。 見つからない場合、4D は自動でオンラインドキュメントの Webサイトを参照します。 この場合インターネットに接続されていない環境でも、ローカルのドキュメントが参照できます。 +- チェックされていない場合、4D はオンラインドキュメントの Webサイトに直接アクセスし、カレントブラウザーでページを表示します。 ページが見つからない場合、4D はブラウザーにエラーメッセージを表示します。 ### ローカルフォルダー diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md index 147bbceec67f46..e212ca4cc11df1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md @@ -15,8 +15,8 @@ title: メソッドページ このリストでは、コードエディターに適用するテーマを選択します。 利用可能なテーマがすべて表示され、カスタムテーマがある場合はそれも表示されます。 4D はデフォルトで 2つのテーマを用意しています: - - **デフォルトのLightテーマ** - - **デフォルトのDarkテーマ** +- **デフォルトのLightテーマ** +- **デフォルトのDarkテーマ** > デフォルトのテーマは変更や削除ができません。 @@ -38,8 +38,8 @@ title: メソッドページ テーマを定義するとは、以下のことを意味します: - - コードエディター全体のグローバルフォントとフォントサイズを設定する。 - - 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 +- コードエディター全体のグローバルフォントとフォントサイズを設定する。 +- 4D のランゲージ要素 (フィールド、テーブル、変数、引数、SQL など)、SQL のランゲージ要素 (キーワード、関数など)、そして背景色のそれぞれにスタイルと色を割り当てる。 異なる色やスタイルを組み合わせることは、コードのメンテナンス目的に特に便利です。 @@ -83,8 +83,8 @@ title: メソッドページ ローカル4Dアプリケーション用の "国際的な" コード設定を有効化/無効化することができます。 - - **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 - - **チェック有り**: リージョン設定が使用されます。 +- **チェック無し** (デフォルト): 4Dメソッドにおいて English-US設定と英語でのプログラミングランゲージが使用されます。 +- **チェック有り**: リージョン設定が使用されます。 > このオプションを変更した場合、変更を反映するには 4Dアプリケーションを再起動する必要があります。 @@ -138,9 +138,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード入力中に () と、閉じるカッコを自動的に挿入するようにします。 このオプションでは 2つの自動機能を管理します: - - **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 +- **()カッコのペア**: 4Dコマンド、キーワード、プロジェクトメソッドが提案リストあるいは補完リストから挿入される時、その挿入要素が一つ以上の引数を必須としている場合に追加されます。 たとえば、"C_OB" と入力して Tabキーを押すと、4D は自動的に "C_OBJECT()" と表示し、カーソルを () の内部に設定します。 - - **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: +- **閉じる }, ), ], "**: {, (, [, あるいは " などの開くカッコを入力した時に、対応する閉じるカッコが追加されます。 この機能により、カーソル位置に、あるいは選択されたテキストを囲むように、対応するカッコ記号を挿入できるようになります。 たとえば、文字列をハイライトして単一の " を入力すると、選択された文字列全体が "" で囲まれます: ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,10 +150,10 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip コード中での対応する括弧を強調する方法を設定します。 この強調は、括弧 (大カッコ[]、中カッコ{}、小カッコ()) が選択されたときに表示されます。 次のオプションから選択することができます: - - **なし**: 強調なし - - **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) - - **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 - - **太字**: 括弧が太字で表示されます。 +- **なし**: 強調なし +- **四角** (デフォルト): 括弧が黒い四角で囲まれます。![](../assets/en/Preferences/optionsRectangle.png) +- **背景色**: 括弧がハイライトされます (色は [テーマ](#テーマの定義) ページで設定します)。 +- **太字**: 括弧が太字で表示されます。 #### 変数とフィールドを強調 @@ -161,9 +161,9 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip ![](../assets/en/Preferences/optionsVariables.png) - - **しない**(デフォルト): ハイライトなし - - **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 - - **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 +- **しない**(デフォルト): ハイライトなし +- **カーソル上のみ**: テキストがクリックされた際にのみハイライトされます。 +- **選択範囲上のみ**: テキストが選択された際にのみハイライトされます。 ハイライトカラーは [テーマ](#テーマの定義) ページにて設定が可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md index 40f1cf2574945a..65708193f932f0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md @@ -5,7 +5,7 @@ title: プロジェクトのアーキテクチャー 4D プロジェクトは、一つのプロジェクトルートフォルダー (パッケージフォルダー) に格納された、複数のファイルやフォルダーから構成されています。 例: - - MyPackage (*プロジェクトルートフォルダー*) +- MyPackage (*プロジェクトルートフォルダー*) - `Components` - `Data` - `Logs` @@ -27,23 +27,23 @@ title: プロジェクトのアーキテクチャー 典型的な Project フォルダーの構造です: - - `.4DProject` ファイル - - `Sources` +- `.4DProject` ファイル +- `Sources` - `Classes` - `DatabaseMethods` - `Methods` - `Forms` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (あれば) +- `DerivedData` +- `Trash` (あれば) ### `.4DProject` ファイル プロジェクトを定義し、起動するためのプロジェクト開発ファイルです。 このファイルを開くには次のいずれかが必要です: - - 4D - - 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) +- 4D +- 4D Server (読み取り専用；[リモートプロジェクトを開く](Desktop/clientServer.md#リモートプロジェクトを開く) 参照) > 4D プロジェクトの開発は 4D によっておこない、マルチユーザー開発はソース管理ツールによって管理します。 4D Server は .4DProject ファイルを開くことができますが、クライアントからの開発はおこなえません。 @@ -121,9 +121,9 @@ title: プロジェクトのアーキテクチャー プロジェクトから削除されたメソッドやフォームがあれば、Trash フォルダーにはそれらが格納されます。 たとえば、つぎのフォルダーが格納されている場合があります: - - `Methods` - - `Forms` - - `TableForms` +- `Methods` +- `Forms` +- `TableForms` 削除された要素はファイル名に括弧が付いた形でフォルダー内に置かれます (例: "(myMethod).4dm")。 フォルダーの構成は [Sources](#sources) フォルダーと同じです。 @@ -176,11 +176,11 @@ Data フォルダーには、データファイルのほか、データに関わ Logs フォルダーには、プロジェクトが使用するすべてのログファイルが格納されます。 以下のログファイルが格納されます: - - データベース変換 - - Webサーバーリクエスト - - バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) - - コマンドデバッグ - - 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) +- データベース変換 +- Webサーバーリクエスト +- バックアップ/復元アクションのジャーナル (*Backup Journal\[xxx].txt*、[バックアップジャーナル](Backup/backup.md#backup-journal) 参照) +- コマンドデバッグ +- 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成) > An additional Logs folder is available in the system user preferences folder (active 4D folder, see [Get 4D folder](../commands-legacy/get-4d-folder.md) command) for maintenance log files and in cases where data folder is read-only. diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/components.md index fa4a93333a485b..5e252a1e5f4e9d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/components.md @@ -13,15 +13,15 @@ title: コンポーネント コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 - - インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 - - コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 +- インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 +- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 ### パッケージフォルダ コンポーネントのパッケージフォルダ(*MyComponent.4dbase* フォルダ) には以下のものを含めることができます: - - **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 - - **コンパイル版コンポーネント**の場合: +- **インタープリタ版コンポーネント**の場合: 標準の[Project フォルダ](../Project/architecture.md)。 [プロジェクトの**Components** フォルダ](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダ名の末尾を **.4dbase** にする必要があります。 +- **コンパイル版コンポーネント**の場合: - .4DZ ファイル、*Resources* フォルダ、*Info.plist* ファイルを格納している"Contents" フォルダ(推奨されるアーキテクチャ) - *Resources* などの他のフォルダを格納している.4DZ ファイル。 @@ -37,8 +37,8 @@ title: コンポーネント このページでは、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: - - [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 - - 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 +- [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 +- 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 ::: @@ -46,14 +46,14 @@ title: コンポーネント 4Dプロジェクトにコンポーネントを読み込むには、以下の方法があります: - - コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 - - または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 +- コンポーネントファイルを[プロジェクトの**Components**フォルダ](architecture.md#components)内にコピーする(インタープリタ版コンポーネントパッケージフォルダはフォルダ名の末尾が".4dbase" になっている必要があります、上記参照)。 +- または、プロジェクトの **dependencies.json** ファイルでコンポーネントを宣言します。これは、[**依存関係インターフェースを使用して依存関係を追加**](#github依存関係の追加) するときに、ローカルファイルに対して自動的におこなわれます。 **dependencies.json** ファイルで宣言されているコンポーネントは、異なる場所に保存できます: - - 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) - - マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) - - GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) +- 4Dプロジェクトのパッケージフォルダーと同じ階層 (デフォルトの場所です) +- マシン上の任意の場所 (コンポーネントパスは **environment4d.json** ファイル内で宣言する必要があります) +- GitHubリポジトリ (コンポーネントパスは、**dependencies.json** ファイルまたは **environment4d.json** ファイル、あるいはその両方で宣言できます) 同じコンポーネントが異なる場所にインストールされている場合、[優先順位](#優先順位) が適用されます。 @@ -69,8 +69,8 @@ title: コンポーネント このファイルには次の内容を含めることができます: - - [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 - - [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 +- [ローカル保存されている](#ローカルコンポーネント) コンポーネントの名前(デフォルトパス、または **environment4d.json** ファイルで定義されたパス)。 +- [GitHubリポジトリ](#github-に保存されたコンポーネント) に保存されているコンポーネントの名前 (パスはこのファイルまたは **environment4d.json** ファイルで定義できます)。 #### environment4d.json @@ -78,8 +78,8 @@ title: コンポーネント このアーキテクチャーの主な利点は次のとおりです: - - **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 - - 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 +- **environment4d.json** ファイルをプロジェクトの親フォルダーに保存することで、コミットしないように選択できることです。これにより、ローカルでのコンポーネントの管理が可能になります。 +- 複数のプロジェクトで同じ GitHubリポジトリを使用したい場合は、**dependencies.json** ファイルでそれを宣言し、**environment4d.json** ファイルで参照することができます。 ### 優先順位 @@ -187,9 +187,9 @@ GitHub に保存されているコンポーネントに関しては、[**depende GitHub に保存された 4Dコンポーネントを直接参照して使用するには、GitHubコンポーネントのリポジトリを設定する必要があります。 - - ZIP形式でコンポーネントファイルを圧縮します。 - - GitHubリポジトリと同じ名前をこのアーカイブに付けます。 - - このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 +- ZIP形式でコンポーネントファイルを圧縮します。 +- GitHubリポジトリと同じ名前をこのアーカイブに付けます。 +- このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 これらのステップは、4Dコードや GitHubアクションを使用することで簡単に自動化できます。 @@ -232,7 +232,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ ::: - - **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: +- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: ```json { @@ -245,7 +245,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ } ``` - - リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: +- リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: ```json { @@ -262,17 +262,17 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 以下にいくつかの例を示します: - - "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 - - "`*`": リリースされている最新バージョン。 - - "`1.*`": メジャーバージョン 1 の全バージョン。 - - "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 - - "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 - - "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 - - "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 - - "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 - - "`<=1.2.3`": 1.2.3 までの最新バージョン。 - - "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 - - "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 +- "`latest`": GitHubリリースで "latest" バッジを持つバージョン。 +- "`*`": リリースされている最新バージョン。 +- "`1.*`": メジャーバージョン 1 の全バージョン。 +- "`1.2.*`": マイナーバージョン 1.2 のすべてのパッチ。 +- "`>=1.2.3`": 1.2.3 を含む、以降の最新バージョン。 +- "`>1.2.3`": 1.2.3 を含まない、以降の最新バージョン。 +- "`^1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン1 (バージョン2未満であること)。 +- "`~1.2.3`": バージョン 1.2.3 を含む、以降の最新のバージョン 1.2 (バージョン1.3未満であること)。 +- "`<=1.2.3`": 1.2.3 までの最新バージョン。 +- "`1.0.0 – 1.2.3`" または ">=1.0.0 <=1.2.3": 1.0.0 から 1.2.3 までのバージョン。 +- "`<1.2.3 ||>=2`": 1.2.3 から 2.0.0 未満までを除いたバージョン。 タグやバージョンを指定しない場合、4D は自動的に "latest" バージョンを取得します。 @@ -282,9 +282,9 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ [**4Dのバージョンに追随する**](#github依存関係バージョン範囲) 依存関係ルールを使用したい場合、GitHub レポジトリ上でのコンポーネントのリリースのタグは、特定の命名規則に従う必要があります。 - - **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 +- **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 - - **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 +- **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 :::note @@ -310,8 +310,8 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 参照された GitHubコンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます: - - macOs: `$HOME/Library/Caches//Dependencies` - - Windows: `C:\Users\\AppData\Local\\Dependencies` +- macOs: `$HOME/Library/Caches//Dependencies` +- Windows: `C:\Users\\AppData\Local\\Dependencies` ... 上記で `` は "4D"、"4D Server"、または "tool4D" となります。 @@ -327,10 +327,10 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 依存関係パネルを表示するには: - - 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
+- 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
![dependency-menu](../assets/en/Project/dependency-menu.png) - - with 4D Server, select the **Window/Project Dependencies** menu item.
+- with 4D Server, select the **Window/Project Dependencies** menu item.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) 依存関係パネルが表示されます。 依存関係は ABC順にソートされます。 @@ -345,9 +345,9 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 - - **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… - - **コンフリクト**: プロジェクトに読み込まれてはいるものの、先に読み込まれた [優先度](#優先順位) の高い依存関係と競合している依存関係。 *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 +- **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 +- **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… +- **コンフリクト**: プロジェクトに読み込まれてはいるものの、先に読み込まれた [優先度](#優先順位) の高い依存関係と競合している依存関係。 *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 ### 依存関係のステータス @@ -357,16 +357,16 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ 使用されるステータスラベルは次のとおりです: - - **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 - - **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 - - **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 - - **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 - - **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 - - **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 - - **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 - - **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. - - **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. - - **Recent update**: A new version of the GitHub dependency has been loaded at startup. +- **Overloaded**: 依存関係は読み込まれていません。より上位の [優先順位](#優先順位) において、同じ名前の依存関係がすでに読み込まれています。 +- **Overloading**: 依存関係は読み込まれていますが、下位の [優先順位](#優先順位) において読み込まれなかった同じ名前の依存関係が存在します。 +- **Not found**: dependencies.jsonファイルで依存関係が宣言されていますが、見つかりません。 +- **Inactive**: プロジェクトと互換性がないため、依存関係は読み込まれていません (例: 現在のプラットフォーム用にコンポーネントがコンパイルされていない、など)。 +- **Duplicated**: 依存関係は読み込まれていません。同じ名前を持つ別の依存関係が同じ場所に存在し、すでに読み込まれています。 +- **Available after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が追加・更新されました。この依存関係は、アプリケーションの再起動後に読み込まれます。 +- **Unloaded after restart**: [インターフェースによって](#プロジェクトの依存関係の監視) 依存関係の参照が削除されました。この依存関係は、アプリケーションの再起動時にアンロードされます。 +- **Update available \**: A new version of the GitHub dependency matching your [component version configuration](#defining-a-github-dependency-version-range) has been detected. +- **Refreshed after restart**: The [component version configuration](#defining-a-github-dependency-version-range) of the GitHub dependency has been modified, it will be adjusted the next startup. +- **Recent update**: A new version of the GitHub dependency has been loaded at startup. 依存関係の行にマウスオーバーするとツールチップが表示され、ステータスに関する追加の情報を提供します: @@ -399,8 +399,8 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ コンポーネントアイコンとロケーションロゴが追加情報を提供します: - - コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 - - ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 +- コンポーネントロゴは、それが 4D またはサードパーティーによる提供かを示します。 +- ローカルコンポーネントと GitHubコンポーネントは、小さなアイコンで区別できます。 ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -420,8 +420,8 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ プロジェクトに依存関係を追加するには、**追加** をクリックします。 - - プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 - - プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 +- プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 +- プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 :::note @@ -461,11 +461,11 @@ The GitHub dependency is declared in the [**dependencies.json**](#dependenciesjs ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 - - **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 - - **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 - - **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 - - **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 +- **自動更新する(latest)**: デフォルトで選択され、最新の(安定)バージョンとしてタグ付けされたリリースをダウンロードできるようにします。 +- **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 +- **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 +- **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 +- **4Dのバージョンに追随する**: 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 The current GitHub dependency version is displayed on the right side of the dependency item: @@ -481,8 +481,8 @@ Modifying the version range is useful for example if you use the automatic updat The Dependency manager provides an integrated handling of updates on GitHub. The following features are supported: - - Automatic and manual checking of available versions - - Automatic and manual updating of components +- Automatic and manual checking of available versions +- Automatic and manual updating of components Manual operations can be done **per dependency** or **for all dependencies**. @@ -498,11 +498,11 @@ If you provide an [access token](#providing-your-github-access-token), checks ar In addition, you can check for updates at any moment, for a single dependency or for all dependencies: - - To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. +- To check for updates of a single dependency, right-click on the dependency and select **Check for updates** in the contextual menu. ![check component](../assets/en/Project/check-component-one.png) - - To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. +- To check for updates of all dependencies, click on the **options** menu at the bottom of the Dependency manager window and select **Check for updates**. ![check components](../assets/en/Project/check-component-all.png) @@ -520,11 +520,11 @@ If you do not want to use a component update (for example you want to stay with You can update dependencies at any moment, for a single dependency or for all dependencies: - - To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: +- To update a single dependency, right-click on the dependency and select **Update \ on next startup** in the contextual menu or in the **options** menu at the bottom of the Dependency manager window: ![check component](../assets/en/Project/update-component-one.png) - - To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: +- To update all dependencies at once, click on the **options** menu at the bottom of the Dependency manager window and select **Update all remote dependencies on next startup**: ![check components](../assets/en/Project/update-component-all.png) @@ -532,8 +532,8 @@ In any cases, whatever the current dependency status, an automatic checking is d When you select an update command: - - a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. - - if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. +- a dialog box is displayed and proposes to **restart the project**, so that the updated dependencies are immediately available. It is usually recommended to restart the project to evaluate updated dependencies. +- if you click Later, the update command is no longer available in the menu, meaning the action has been planned for the next startup. #### Automatic update @@ -547,13 +547,13 @@ When this option is unchecked, a new component version matching your [component Registering your personal access token in the Dependency manager is: - - mandatory if the component is stored on a [private GitHub repository](#private-repositories), - - recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). +- mandatory if the component is stored on a [private GitHub repository](#private-repositories), +- recommended for a more frequent [checking of dependency updates](#updating-github-dependencies). To provide your GitHub access token, you can either: - - "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 - - または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 +- "依存関係を追加..." ダイアログボックスで、GitHub のプライベートリポジトリパスを入力した後に表示される \*\*パーソナルアクセストークンを追加... \*\* ボタンをクリックします。 +- または、依存関係マネージャーのメニューで、**GitHubパーソナルアクセストークンを追加...** をいつでも選択できます。 ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md index 5ae69bd8026d8c..fc4e6fe69187b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md @@ -7,10 +7,10 @@ title: ドキュメンテーション ドキュメントすることができるプロジェクト要素は次のとおりです: - - メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) - - クラス - - Forms - - テーブルとフィールド +- メソッド (データベースメソッド、コンポーネントメソッド、プロジェクトメソッド、フォームメソッド、4D Mobile メソッド、トリガー) +- クラス +- Forms +- テーブルとフィールド ドキュメンテーションファイルは Markdown記法 (.md ファイル) で記述します。 これには、Markdown をサポートしている任意のエディターを使うことができます。 これらはそれぞれ独立したファイルとしてプロジェクトフォルダー内に格納されます。 @@ -34,7 +34,7 @@ title: ドキュメンテーション `Documentation` フォルダーのアーキテクチャーは次のとおりです: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ title: ドキュメンテーション - table1.md - ... - - プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- プロジェクトフォームとそのプロジェクトフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 - - テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 +- テーブルフォームとそのテーブルフォームメソッドは、同じドキュメンテーションファイルをフォームとメソッドの両方について共有します。 > ドキュメントされているプロジェクト要素を名称変更したり、削除したりすると、その要素に紐づいている Markdown ファイルも自動で名称変更、または削除されます。 @@ -73,9 +73,9 @@ title: ドキュメンテーション ![](../assets/en/Project/comments-explo2.png) - - 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 +- 選択要素のドキュメンテーションファイルが見つからなかった場合には、**作成する** ボタンが表示されます。 - - 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 +- 選択要素のドキュメンテーションファイルが存在すれば、その内容がエリア内に表示されます。 なお、エリアに表示されている内容は直接編集することはできません。 ### ドキュメンテーションファイルの編集 @@ -83,8 +83,8 @@ title: ドキュメンテーション 選択要素のドキュメンテーションファイルが存在しなければ: - - `Documentation` ペインにある **作成する** ボタンをクリックするか、 - - エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 +- `Documentation` ペインにある **作成する** ボタンをクリックするか、 +- エクスプローラーのオプションメニューまたはコンテキストメニューより **ドキュメンテーションを編集...** を選択します。 ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ title: ドキュメンテーション `\.md` ファイルが `\/documentation` フォルダーに存在する場合、コードエディターは次の優先順位でヘルプTips を表示します: - - Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) +- Markdown ファイルの先頭に設置した、HTML コメントタグで囲まれたテキスト (``) - - HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ +- HTML のコメントタグが使用されていなければ、Markdown ファイルの `## Description` タグ後の最初の文章。\ この場合、最初の文章には 4D コードパーサーによって自動生成されたメソッドの **プロトタイプ** が入ります。 :::note @@ -130,7 +130,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### サポートされている Markdown - - 見出しタグ: +- 見出しタグ: ```md # 見出し 1 @@ -138,7 +138,7 @@ Otherwise, the code editor displays [the block comment at the top of the method ### 見出し 3 ``` - - スタイルタグ (イタリック、太字、取り消し線) : +- スタイルタグ (イタリック、太字、取り消し線) : ```md _イタリック_ @@ -147,7 +147,7 @@ _イタリック_ ~~取り消し線~~ ``` - - 4D コードハイライトが付くコードブロックタグ (\`4d ... `): +- 4D コードハイライトが付くコードブロックタグ (\`4d ... `): ````md ```4d @@ -156,7 +156,7 @@ _イタリック_ ``` ```` - - テーブルタグ: +- テーブルタグ: ```md | Parameter | Type | Description | @@ -165,7 +165,7 @@ _イタリック_ | toolbar | Text |Toolbar name | ``` - - リンクタグ: +- リンクタグ: ```md // 例 1 @@ -177,7 +177,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - 画像タグ: +- 画像タグ: ```md ![画像の説明](pictures/image.png) @@ -224,10 +224,10 @@ $logo:=GetLogo(5) ``` ```` - - エクスプローラーの表示: +- エクスプローラーの表示: ![](../assets/en/Project/explorer_Doc.png) - - コードエディターの表示: +- コードエディターの表示: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md index 3ae1f9e5ff3140..ce909e1666efa7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the `$attributes` はエンティティ (*例:* People(1)) またはエンティティセレクション (*例:* People/$entityset/0AF4679A5C394746BFEB68D2162A19FF) に対して適用できます。 - - クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 +- クエリに `$attributes` が指定されていない場合、または "\*" が渡された場合、すべての取得可能な属性が取得されます。 **リレートエンティティ** 属性は、`__KEY` (プライマリーキー) と `URI` プロパティを持つオブジェクトという簡単な形で抽出されます。 **リレートエンティティズ** 属性は抽出されません。 - - **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntity`: リレートエンティティは簡単な形で返されます (`__KEY` (プライマリーキー) と `URI` プロパティを持つ deferred オブジェクト) - `$attributes=relatedEntity.*`: リレートエンティティの属性がすべて返されます。 - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: リレートエンティティの指定された属性だけが返されます。 - - **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: +- **リレートエンティティズ** 属性を対象に `$attributes` が指定された場合: - `$attributes=relatedEntities.*`: リレートエンティティズの属性がすべて返されます。 - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: リレートエンティティズの指定された属性だけが返されます。 - - If `$attributes` is specified for **storage** attributes: +- If `$attributes` is specified for **storage** attributes: - `$attributes=attribute1, attribute2, ...`: only those attributes of the entities are returned. ## リレートエンティティズの例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md index 1ded5dd7335092..d6a83ce65447f3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md @@ -27,13 +27,13 @@ The locks triggered by the REST API are put at the [session](authUsers.md#sessio *ロック* されたエンティティは次のものから操作 (ロック / アンロック / 更新 / 削除) できません: - - 他の REST セッション - - RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 +- 他の REST セッション +- RESTサーバー上で実行されている 4D プロセス (クライアント/サーバー, リモートデータストア, スタンドアロン)。 REST API によってロックされたエンティティは、次の場合にのみアンロックされます: - - ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 - - ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 +- ロック元の (`/?$lock=true` をおこなった) RESTセッションが `/?$lock=false` をリクエストしたとき。 +- ロック元セッションの [非アクティブタイムアウト]($directory.md) に達したとき (セッションは閉じられます)。 ### レスポンス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md index defa6eec9b472d..157f1a674636d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md @@ -194,9 +194,9 @@ RESTリクエストで定義されたリレートエンティティのコレク :::note - - **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 - - **ブール** は true または false です。 - - Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 +- **ブール** は true または false です。 +- Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md index e50b78e469b7f1..bf98fb587668af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md @@ -7,8 +7,8 @@ REST リクエストを使って、ORDA データモデルに定義されてい 関数は以下の2つの方法で呼び出すことができます: - - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 +- **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 +- **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。 一方で、GET リクエストは、URL をブラウザに入れるだけで関数を呼び出すことができるため、 よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 @@ -97,11 +97,11 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 次のルールが適用されます: - - POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 - - GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 - - 引数はコレクション (JSON形式) の中に格納する必要があります。 - - JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 - - エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 +- POST リクエストを通して呼び出された関数内では、引数は **POST リクエストの本文内** に渡さなければなりません。 +- GET リクエストを通して呼び出された関数内では、引数は **URL 内に"?$params=" シンタックスで** 渡さなければなりません。 +- 引数はコレクション (JSON形式) の中に格納する必要があります。 +- JSON コレクションがサポートしているスカラーなデータ型はすべて引数として渡せます。 +- エンティティやエンティティセレクションも引数として受け渡せます。 この際、対応する ORDA オブジェクトにデータを割り当てるために REST サーバーが使用する専用の属性 (`__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`) を 引数のリストに含めなくてはなりません。 [エンティティを引数として受け取る例題](#エンティティを引数として受け取る) と [エンティティセレクションを引数として受け取る例題](#エンティティセレクションを引数として受け取る) を参照ください。 @@ -135,8 +135,8 @@ ORDA ユーザークラスやシングルトン内で定義されている関数 | __ENTITY | Boolean | 必須 - true は引数がエンティティであることをサーバーに通知します | | __KEY | 混合 (プライマリーキーと同じ型) | 任意 - エンティティのプライマリーキー | - - `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 - - `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 +- `__KEY` が省略された場合、指定した属性を持つ新規エンティティがサーバー上で作成されます。 +- `__KEY` が提供された場合、`__KEY` が合致するエンティティが指定した属性とともにサーバー上に読み込まれます。 POST リクエストでエンティティを作成または更新する方法については以下の例題を参照して下さい。 GET リクエストとエンティティを使用してコンテンツをダウンロードする方法については以下の例題を参照して下さい。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md index 24a5115b6e7e1a..9ac0e0f41fbe9f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md @@ -43,9 +43,9 @@ When [scalable sessions are enabled](WebServer/sessions.md#enabling-web-sessions 記述的RESTリクエストは、ライセンスを必要としない Webユーザーセッション ("ゲスト" セッション) で処理することができます。 記述的RESTリクエストとは以下のものを指します: - - [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス - - `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 - - `/rest/$getWebForm` - Qodlyページのレンダリング +- [`/rest/$catalog`]($catalog.md) リクエスト (例: `/rest/$catalog/$all`) - 利用可能なデータクラスへのアクセス +- `/rest/$catalog/authentify` - ユーザーログインに使用されるデータストア関数 +- `/rest/$getWebForm` - Qodlyページのレンダリング ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -73,8 +73,8 @@ exposed Function authentify({params : type}) {-> result : type} この関数は 2部構成で書かれる必要があります: - - RESTリクエストの送信元を識別し、認証するためのコード - - 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し +- RESTリクエストの送信元を識別し、認証するためのコード +- 認証が成功した場合、セッションに適切な権限を割り当てる [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) の呼び出し 関数が [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) を呼び出さない場合、権限が割り当てられないため、ライセンスも消費されず、後続の記述的でない RESTリクエストは拒否されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md index 777d5af43f60d0..db67a21957bbe2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md @@ -9,8 +9,8 @@ RESTサーバーは 4D および 4D Server に含まれており、[設定完了 この章では、簡単な例題を使用して REST機能を紹介します。 これから、実際に次のことをしてみましょう: - - 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 - - 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 +- 簡単な 4Dアプリケーションプロジェクトを作成し、設定します。 +- 標準のブラウザーを開き、REST を介して 4Dプロジェクトのデータにアクセスします。 例題が複雑にならないよう、ここでは 4D とブラウザーを同じマシン上で使用します。 もちろん、リモートアーキテクチャーを使うことも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md index 4886dc8fdaca40..d961bc858e1130 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md @@ -19,7 +19,7 @@ REST API を使って、4D内と同等のデータ操作をおこなうことが [\{dataClass\}(\{key\})](dataClass.md#dataclasskey) でデータクラスのいちエンティティを取得する以外にも、エンティティセレクションやコレクションを返す [クラス関数](ClassFunctions.md#関数の呼び出し) を用意することもできます。 -戻り値としてセレクションを返す前に、[`$orderby`]($orderby.md) を使って一つ以上の属性 (リレーション属性も可) を基準に並べ替えることもできます。 +Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) on one or more attributes (even relation attributes). ## データのナビゲーション @@ -27,7 +27,7 @@ REST API を使って、4D内と同等のデータ操作をおこなうことが ## エンティティセットの作成と管理 -エンティティセットとは、*エンティティセレクション* と同等の意味で、RESTリクエストによって取得され、4D Server のキャッシュに保存されるエンティティのコレクションのことです。 エンティティセットを利用することで、同じ結果を得るためにアプリケーションを繰り返しクエリすることが避けられます。 エンティティセットへのアクセスはクエリするよりも速いため、アプリケーション速度の向上にもつながります。 +An entity set is a collection of entities obtained through a REST request that is stored in 4D Server's cache. エンティティセットを利用することで、同じ結果を得るためにアプリケーションを繰り返しクエリすることが避けられます。 エンティティセットへのアクセスはクエリするよりも速いため、アプリケーション速度の向上にもつながります。 エンティティセットを作成するには、RESTリクエスト内で [`$method=entityset`]($method.md#methodentityset) を呼び出します。 エンティティセットがタイムアウトした場合やサーバーから削除されてしまった場合への安全対策として、[`$filter`]($filter.md) や [`$orderby`]($orderby.md) を呼び出す際に [`$savedfilter`]($savedfilter.md) および [`$savedorderby`]($savedorderby.md) を使用することで、以前と同じ ID で再取得することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md index 0ca173c609562f..4cb80f3b7efa91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md @@ -17,15 +17,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-buttons.png) - - **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 - - **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 - - **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 +- **ユーザープロセス**: ユーザーセッションにより、またユーザーセッションのために作成されたプロセス。 このプロセスには人のアイコンが表示されます。 +- **4D プロセス**: 4D Server エンジンが生成したプロセス。 このプロセスには歯車のアイコンが表示されます。 +- **予備プロセス**: 使用されていないが一時的に保持され、いつでも再利用が可能なプロセス。 このメカニズムは 4D Server の反応性を向上させます。 このプロセスには薄暗い人のアイコンが表示されます。 **グループ毎にプロセスを表示** オプションを使用して、4D Server の内部プロセスやクライアントプロセスをグループ化できます。 このオプションをチェックすると: - - 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 - - "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 - - "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 +- 4Dクライアントのプロセス (メインの 4Dクライアントプロセスや 4Dクライアントの基本プロセス。 [プロセスタイプ](#プロセスタイプ) 参照) は 1つにグループ化されます。 +- "タスクマネージャー" グループが作成され、タスクを分割するための内部プロセス (共有バランサー、ネットセッションマネージャー、Exclusive pool worker) がグループ化されます。 +- "クライアントマネージャー" グループが作成され、これにはクライアントのさまざまな内部プロセスが含まれます。 ウィンドウの下段には選択したプロセスの稼働状況がグラフィカルに表示されます。 @@ -33,16 +33,16 @@ title: プロセスページ プロセスの稼働状況は、4D Server がこのプロセスのために使用した時間のパーセンテージです。 ウィンドウにはプロセスごとに以下の情報が表示されます: - - プロセスタイプ (後述) - - セッション/情報: +- プロセスタイプ (後述) +- セッション/情報: - 4Dプロセス - 空白 - ユーザープロセス - 4Dユーザー名 - Webプロセス - URLパス - - プロセス名 - - Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 - - プロセスの現在の状況 - - 作成されてからのプロセスの実行時間 (秒) - - 4D Server がこのプロセスに使用した時間のパーセンテージ +- プロセス名 +- Number of the process (as returned by the [`New process`](../commands-legacy/new-process.md) command for example). プロセス番号はサーバー上で割り当てられる番号です。 グローバルプロセスの場合、この番号はクライアントマシン上で割り当てられた番号と異なる場合があります。 +- プロセスの現在の状況 +- 作成されてからのプロセスの実行時間 (秒) +- 4D Server がこのプロセスに使用した時間のパーセンテージ ## プロセスタイプ @@ -83,15 +83,15 @@ title: プロセスページ ![](../assets/en/Admin/server-process-actions.png) - - **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 +- **プロセスを中断**: 選択したプロセスをアボートします。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **プロセスを一時停止**: 選択したプロセスを一時停止します。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 - - **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 +- **プロセスを一時停止**: 選択したプロセスを一時停止します。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **プロセスをデバッグ**: 選択したプロセスのデバッガーをサーバーマシン上で開きます。 このボタンをクリックすると警告ダイアログが表示され、操作を続行またはキャンセルできます。 4Dコードが実際にサーバーマシン上で実行されている場合にのみ、デバッガーウィンドウが表示される点に注意してください (たとえば、トリガーや "サーバー上で実行" 属性を持つメソッドの実行時など)。 > 確認ダイアログなしに選択したプロセスをデバッグするには、**Alt**キーを押しながらこのボタンをクリックします。 - - **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 +- **ユーザーを表示**: 選択されたプロセスのユーザーを管理ウィンドウの [ユーザーページ](users.md) に直接表示させることができます。 1つ以上のユーザープロセスが選択されている場合にこのボタンは有効になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md index 6179dd1ed022bc..f822341cf0edcc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ title: リアルタイムモニターページ 各行について、以下の情報が表示されます: - - **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 - - **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 - - **情報**: 操作の説明。 - - **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: +- **開始時刻**: 操作の開始時刻が、"dd/mm/yyyy - hh:mm:ss" というフォーマットで表示されます。 +- **経過時間** (秒): 進行中の操作の経過時間が秒単位で表示されます。 +- **情報**: 操作の説明。 +- **詳細**: このエリアには、選択したオペレーションのタイプに応じて、その詳細な情報が表示されます。 具体的には以下の情報が表示されます: - **作成された場所**: そのオペレーションがクライアントアクションの結果か (クライアント上で作成)、ストアドプロシージャ―または "サーバー上で実行" オプションを使用した結果か (サーバー上で作成) を表示します。 - **オペレーション詳細**: オペレーションタイプと、(クエリオペレーションに対しては) クエリプランを表示します。 - **サブオペレーション** (あれば): 選択したオペレーションに従属するオペレーションを表示します (例:親レコードの前にリレートレコードを削除する) @@ -26,9 +26,9 @@ title: リアルタイムモニターページ このページは表示後すぐにアクティブになり、恒久的に更新され続けます。 ただし、この処理によって、アプリケーションの実行を極端に遅くさせる可能性があることに注意してください。 以下の方法を用いて更新を一時的に停止させることが可能です: - - **停止** ボタンをクリックする - - リストの中をクリックする - - スペースバーを押す +- **停止** ボタンをクリックする +- リストの中をクリックする +- スペースバーを押す ページを停止させると一時停止のメッセージが表示され、ボタンの表示が **再開** に変わります。 モニタリング停止操作と同じ操作をすることでモニタリングを再開させることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md index c9f97585e0b23e..18f88e2ba81165 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md @@ -7,8 +7,8 @@ title: アクセスコントロールの概要 運用環境によって、4D アクセスコントロールの方法は異なります: - - マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- マルチユーザーアプリケーションでは、4D のユーザー＆グループ機能を利用することができます。 +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > 4Dのセキュリティ機能の概要については、[4D Security guide](https://blog.4d.com/4d-security-guide/) をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md index 70870aa1aea9a7..d7901194653d79 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ title: VP EXPORT DOCUMENT ドキュメント名に拡張子を付けることで、書き出すドキュメントの形式を指定することができます: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt" または ".csv") - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt" または ".csv") +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") ファイル名に拡張子が含まれていなくても、*paramObj* 引数によって形式が指定されている場合、書き出されたファイルには形式に対応する拡張子がつけられます。 ただし CSV形式の場合には拡張子がつきません。 @@ -88,25 +88,25 @@ title: VP EXPORT DOCUMENT **Excel 形式についての注意**: - - 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 - - ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 +- 4D View Pro ドキュメントを Microsoft Excel 形式のファイルに書き出す場合、一部の設定が失われる可能性があります。 たとえば、4Dメソッドとフォーミュラは Excel ではサポートされません。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、その他の設定を確認することができます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- ".xlsx" フォーマットで書き出す際には*excelOptions* オブジェクトの使用が推奨されています。 このオブジェクトを旧式の第一レベルプロパティ(*password*、*includeBindingSource*...)と混在させないように注意して下さい。 混在させた場合には問題が起きる可能性があります。 **PDF 形式についての注意**: - - 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを PDF 形式に書き出す場合、ドキュメントで使用されているフォントは自動的に PDF ファイルに埋め込まれます。 ただし、埋め込み可能なのは Unicode マップを持つ OpenType フォント (.OTF または .TTF ファイル) のみです。 フォントに対して有効なフォントファイルが見つからない場合、デフォルトのフォントが代用されます。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **CSV 形式についての注意**: - - 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 - - すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- 4D View Pro ドキュメントを CSV 形式に書き出す場合、テキストと値のみが保存されるため、一部の設定が失われる可能性があります。 +- すべての値は二重引用符で括られた形で保存されます。 ユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 **SpreadJS ファイル形式についての注意**: - - [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 - - このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 +- [SpreadJS ファイル](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) は zipファイルです。 +- このフォーマットへの書き出しは非同期に実行されるため、書き出し後にコードを実行するには、*paramObj* 引数の `formula` プロパティを使用します。 書き出し操作が完了すると、`VP EXPORT DOCUMENT` は自動的に、*paramObj* オブジェクトの *formula* プロパティに設定されたメソッドをトリガーします (設定されていれば)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md index f36b0aad301c2f..70ceccbf7b40d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md @@ -5,7 +5,7 @@ title: VP Find -**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object } ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object +**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md index 4b85db02c19f3e..163d884fe9f6ea 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ title: VP Get stylesheets 任意の *sheet* 引数を使用することで、スタイルシートをどこから取得するかを指定することができます。シートインデックス (0 起点) か、以下の定数のいずれかを渡すことができます: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md index 7ac63c9deef533..a2c15488013851 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ title: VP Get value 返されるオブジェクトに日付または時間が含まれている場合、これは "日付時間"として扱われ、以下のように補完されます: - - 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 - - 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 +- 時間値 - 日付部分は DD/MM/YYYY フォーマットの、1899年12月30日 (30/12/1899) として補完されます。 +- 日付値 - 時間部分は HH:MM:SS フォーマットの、真夜中 (00:00:00) として補完されます。 *rangeObj* のレンジが複数セルあるいは複数レンジを含んでいる場合、最初のセルの値が返されます。 セルが空の場合には、コマンドは null オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md index d00f1cabd92020..5d069870ab5a4e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ title: VP IMPORT DOCUMENT *filePath* には読み込むドキュメントのパスとファイル名を渡します。 以下のフォーマットがサポートされています : - - 4D View Pro ドキュメント (拡張子 ".4vp") - - Microsoft Excel 形式 (拡張子 ".xlsx") - - テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) - - [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") +- 4D View Pro ドキュメント (拡張子 ".4vp") +- Microsoft Excel 形式 (拡張子 ".xlsx") +- テキスト形式のドキュメント (拡張子 ".txt", ".csv", ドキュメントは UTF-8 形式である必要あり) +- [SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (拡張子 ".sjs") ドキュメントの拡張子が認識される拡張子 (`.4vp` や `.xlsx` など) ではなかった場合、ドキュメントはテキスト形式であると見なされます。 ドキュメントが Project フォルダーと同階層に置かれている場合を除き、フルパスを渡す必要があります (同階層に置かれている場合にはファイル名のみを渡すことができます)。 @@ -73,11 +73,11 @@ title: VP IMPORT DOCUMENT :::note 注記 - - .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 - - Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 - - CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 - - Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- .xslx、.csv、.sjs 形式のファイルの読み込みは、**非同期** でおこなわれます。 これらの形式で、ドキュメント処理の最後にアクションを実行したい場合には、`formula` プロパティを使用する必要があります。 +- Microsoft Excel 形式のファイルを 4D View Pro ドキュメントに読み込む場合、一部の設定が失われる可能性があります。 [SpreadJS にある一覧](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport) にて、設定を確認することができます。 +- CSV形式およびユーザー定義区切りの値 (DSV) に関する詳細については、こちらの [Wikipedia の記事](https://en.wikipedia.org/wiki/Delimiter-separated_values) (英文) を参照ください。 +- Using *excelOptions* object is recommended when importing ".xlsx" format. Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- The callback function specified in the `formula` attribute is triggered after all [4D custom functions](../formulas.md#4d-functions) within the imported content have completed their calculations. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md index dbce5f598859fd..9aff390b955ca6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md @@ -13,7 +13,7 @@ title: VP REMOVE TABLE COLUMNS -**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }}} ) +**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }} ) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md index 392b3e5f084244..3e29b2a1d9721f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ title: VP RESIZE TABLE 次のルールが適用されます: - - ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 - - リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 - - 表組みを拡張した先にデータを含むセルが存在する場合には: +- ヘッダーは同じ行のまま残り、結果の表範囲は元の表範囲と重なっている必要があります。 +- リサイズされた表組みの行数がリサイズ前より少ない場合、切り取られた行や列内の値は、それらが [データコンテキスト](vp-set-data-context.md) にバインドされていなければ保持され、そうでなければ削除されます。 +- 表組みを拡張した先にデータを含むセルが存在する場合には: - 行が追加された場合、データは削除されます。 - 列が追加された場合、データは保持され、新しい列に表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md index 320d57d260bc2c..37cce773edc7e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md @@ -38,20 +38,20 @@ title: はじめに ### セル、列、および行の選択 - - セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 +- セルを選択するには、単にセルをクリックするか、キーボードの矢印キーを使用します。 その中身 (あるいは式) がセル内に表示されます。 - - 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 +- 複数の連続したセルを選択するには、マウスをセレクションの端から端へとドラッグします。 また、Shiftキーを押しながらセレクションの二つの端をクリックすることでも選択可能です。 - - スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: +- スプレッドシート内のセルをすべて選択するには、エリアの左上端にあるセルをクリックします: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - 列を選択するには、対応する文字 (アルファベット) をクリックします。 +- 列を選択するには、対応する文字 (アルファベット) をクリックします。 - - 行を選択するには、対応する番号をクリックします。 +- 行を選択するには、対応する番号をクリックします。 - - 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 +- 連続していないセルを複数選択するには、**Ctrl**キー (Windows) あるいは **Command**キー (macOS) を押しながら、選択したいセルをそれぞれクリックします。 - - セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 +- セルの選択を解除するには、スプレッドシート内のどこかをクリックすれば選択解除されます。 ### データの入力 @@ -77,8 +77,8 @@ title: はじめに クリックしたエリアに応じて、メニューには次の選択肢が表示されます: - - 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** - - セルあるいはセルレンジのクリック: +- 列や行のヘッダーをクリックした場合: コンテンツの **挿入**、**削除**、**非表示**、**再表示** +- セルあるいはセルレンジのクリック: - **フィルタリング**: フィルタリングを使用して行を非表示にします ([SpreadJS ドキュメント](https://developer.mescius.com/spreadjs/docs/) の "Filtering rows" を参照ください) - **ソート**: 列のコンテンツを並べ替えます。 - **コメントの挿入**: ユーザーコメントを入力できます。 コメントが入力されているセルには、小さな赤い三角形が表示されます:\ @@ -129,8 +129,8 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro のレンジオブジェクトは、いくつかのプロパティで構成されます: - - area - 4D View Pro エリアの名称 - - ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 +- area - 4D View Pro エリアの名称 +- ranges - レンジオブジェクトのコレクション。 各レンジオブジェクトで利用できるプロパティは、レンジオブジェクトの種類によって異なります。 たとえば、列のレンジオブジェクトには、*.column* と *.sheet* プロパティしか含まれません。 | プロパティ | | 型 | 説明 | 利用可能な対象 | | ------ | ------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------- | -------------------------------------------------- | @@ -147,10 +147,10 @@ $myRange:=VP Cells("ViewProArea";2;4;2;3) // C5 から D7 4D View Pro は、複数のドキュメント形式のインポートおよびエクスポートに対応しています: - - .4vp - - .xlsx - - .txt と .csv - - .sjs - - .pdf (エクスポートのみ) +- .4vp +- .xlsx +- .txt と .csv +- .sjs +- .pdf (エクスポートのみ) 詳細については [VP IMPORT DOCUMENT](commands/vp-import-document.md) と [VP EXPORT DOCUMENT](commands/vp-export-document.md) の説明を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md index a66a66a3b6d4b3..89dfb36cb849a2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ QodlyScript はローカル変数のみをサポートするため、QodlyScript QodlyScript のコマンドおよび定数名は、スペースを入れずにキャメルケースで記述されます。 また、QodlyScript の定数名は `k` 文字で始まります。 これらの QodlyScript の要素を 4Dランゲージに変換する必要があるかもしれません。 - - 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 - - しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 +- 通常は、単に名前を変換するだけで十分です。 たとえば、QodlyScript の `newCollection` は 4Dランゲージの `New collection` です。 +- しかし、いくつかのコマンドは改名されています。たとえば、4Dランゲージの `Arctan` と `Square root` コマンドは、QodlyScript では `atan` および `sqrt` です。 ### 例題 - - QodlyScript コード: +- QodlyScript コード: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript のコマンドおよび定数名は、スペースを入れずに end ``` - - 上に相当する 4Dランゲージのコード: +- 上に相当する 4Dランゲージのコード: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md index 8808b00ae70d46..af4c0e3ee6dd0d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ http://localhost/rest/Friends 4D Webサーバーにユーザーをログインさせる、もっともシンプルで安全な方法は、以下のシナリオに基づきます: - - ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 - - [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 +- ユーザーは、専用の非公開テーブル (例: *WebUsers*) に保存されます。 +- [暗号化](MSC/encrypt.md) することも可能な *WebUsers* テーブルには、ユーザーのログイン名とパスワードのハッシュが保存されています。 1. いくつかのフィールドを持つテーブルを作成します。たとえば: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md index cc26dc350cb0dc..7de1c63f722d09 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ title: HTTP Request handler カスタムのHTTP リクエストハンドラーを使用することで、以下のような用途に応えることができます: - - 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 - - コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする - - oAuth 2.0 経由での認証を管理する +- 与えられたURL をリソースプロバイダやファイルアップロードボックスとして使用する(これにより様々なファイルのダウンロード/アップロードが可能になります)。 +- コンテキスト(認証されたユーザー、与えられた権限など)に応じて、特定のページへとリダイレクトする +- oAuth 2.0 経由での認証を管理する ## 要件 カスタムのHTTP リクエストハンドラーは以下の条件の元にサポートされます: - - [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること - - メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 +- [スケーラブルセッション](./sessions.md#enabling-web-sessions) が有効化されていること +- メインのWeb サーバーでのみ利用可能です([コンポーネントのWeb サーバー](../WebServer/webServerObject.md) で定義されていたHTTP リクエストハンドラーがあったとしてもそれは無視されます)。 :::warning @@ -62,9 +62,9 @@ title: HTTP Request handler ハンドラーは以下の3つの要素から定義されます: - - 聞くべきURL パターン - - 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 - - そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) +- 聞くべきURL パターン +- 受信したURL パターンを処理するためのコードが実装されているクラスとその関数 +- そのURL とともに使用することでハンドラーをトリガーする動詞(メソッド) ハンドラーの識別子は、[パターン + 動詞のリストの中にある動詞]の組み合わせとなります。 @@ -72,10 +72,10 @@ title: HTTP Request handler URL パターンは**接頭辞** として、あるいは**正規表現** を使用して定義することできます。 - - 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ +- 接頭辞パターンを宣言するためには、HTTPHandlers.json ファイル内の"pattern" プロパティ名を使用します。 接頭辞は `/` の開始と終了をすでに含んでいる正規表現とみなされます。\ Ex: `"pattern" : "docs"` または `"pattern" : "docs/invoices"` - - 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 +- 正規表現パターンを宣言するためには、HTTPHandlers.json ファイル内において"regexPattern" プロパティ名を使用します。 正規表現パターンは直接管理されます。 礼: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" と "regexPattern" プロパティは同じハンドラー定義内で同時に使用することはできません(使用した場合、"regexPattern" プロパティのみが有効となります)。 @@ -84,8 +84,8 @@ URL パターンは**接頭辞** として、あるいは**正規表現** を使 URL パターンは以下の指定された順番に基づいてトリガーされます: - - 最初に合致したパターンが実行されます。 - - それ以降のパターンは、URL に合致していたとしても実行されません。 +- 最初に合致したパターンが実行されます。 +- それ以降のパターンは、URL に合致していたとしても実行されません。 結果として、ハンドラーを作成する際には正確な戦略を適用する必要があります。つまり、もっとも詳細なパターンを先に、そして最も一般的なパターンを後に書く必要があります。 @@ -117,17 +117,17 @@ URL パターンは以下の指定された順番に基づいてトリガーさ カスタムの HTTP ハンドラーでは、4D ビルトインのHTTP 処理機能に合致するURL パターンは許可されていません。 例えば、以下のようなパターンは管理することができません: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### クラスとメソッド 定義されたURL パターンを検知して割り込んだときに実行されるべきコードを宣言するためには、"class" および "method" プロパティを使用します。 - - "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 - - "method": クラスに属性ているクラス関数 +- "class": `cs.` を除いたクラス名。例: `cs.UsersHandling` ユーザークラスの場合は、"UsersHandling" 。 このクラスは[**共有**](../Concepts/classes.md#共有シングルトン) クラスかつ[**シングルトン**](../Concepts/classes.md#シングルトンクラス) クラスである必要があります。 +- "method": クラスに属性ているクラス関数 リクエストハンドラーコードについての情報に関しては、[後述の説明](#リクエストハンドラーコード) を参照してください。 @@ -208,11 +208,11 @@ HTTP 動詞はまた、[リクエストハンドラーコード内で`.verb` プ この例においては、以下の関数を実装する必要があります: - - *GeneralHandling* クラス内の*handle 関数* - - *UsersHandling* クラス内の *manageAccount* - - *FinancialHandling* クラス内の *handleInvoices* - - *DocsHandling* クラス内の *handleDocs* - - *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* +- *GeneralHandling* クラス内の*handle 関数* +- *UsersHandling* クラス内の *manageAccount* +- *FinancialHandling* クラス内の *handleInvoices* +- *DocsHandling* クラス内の *handleDocs* +- *InvoicesHandling* クラス内の *handleTheInvoice* / *handleDetails* / *handleInvoices* 以下はハンドラーをトリガーするURL の一例です: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md index fc43b1c77918f6..7ca46c9483d525 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ title: プリエンプティブWebプロセスの使用 | Web サーバー | コオペラティブ | *Web設定* | | Webサービスサーバー | コオペラティブ | *Web設定* | - - REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します - - Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します - - Web サービスサーバー: SOAPリクエストを処理します - - ***Web設定*** とは、プリエンプティブモード実行が設定によることを表します: +- REST サーバー: REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) を処理します +- Web サーバー: [Web テンプレート](templates.md)、[4DACTION とデータベースメソッド](httpRequests.md) を処理します +- Web サービスサーバー: SOAPリクエストを処理します +- ***Web設定*** とは、プリエンプティブモード実行が設定によることを表します: - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - それ以外の場合は、[**プリエンプティブプロセスを使用**](webServerConfig.md#プリエンプティブプロセスを使用) オプションが考慮されます。 - Webサービスプロセス (サーバーまたはクライアント) のプリエンプティブモードは、メソッドレベルでサポートされています。 公開済みの SOAPサーバーメソッド ([4Dで Web サービスを公開する](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.ja.html) 参照) あるいはプロキシクライアントメソッド ([4Dから Web サービスへサブスクライブする](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.ja.html) 参照) の "プリエンプティブプロセスで実行可能" プロパティをチェックし、メソッドがコンパイラーによってスレッドセーフと確認されるようにします。 @@ -35,21 +35,21 @@ title: プリエンプティブWebプロセスの使用 Webプロセスをプリエンプティモードで実行するには、Webサーバーで実行されるすべての 4Dコードがスレッドセーフでなければなりません。 [プリエンプティブモードが有効化](#webプロセスにおけるプリエンプティブモードの使用可能状況) されている場合、アプリケーションの以下の部分が 4Dコンパイラーによって自動的に評価されます: - - すべての Web関連データベースメソッド: +- すべての Web関連データベースメソッド: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) と [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) +- `compiler_web` プロジェクトメソッド (実際の "実行モード" プロパティに関わらず評価されます) - - Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) +- Webコンテキストにおいて [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) コマンドによって処理される基本的にすべてのコード (.shtmlページを通して実行されるものなど) - - "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 +- "公開オプション: 4DタグとURL (`4DACTION`)..." 属性が有効なプロジェクトメソッド。 - - "RESTリソースとして公開" 属性が有効なテーブルのトリガー +- "RESTリソースとして公開" 属性が有効なテーブルのトリガー - - REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) +- REST で呼び出された [ORDA データモデルクラス関数](../REST/ClassFunctions.md) これらそれぞれのメソッドとコードの部分について、スレッドセーフのルールが遵守されているかをコンパイラーがチェックし、問題があった場合にはエラーを返します。 スレッドセーフルールについての詳細は、[4Dランゲージリファレンス](https://doc.4d.com) マニュアルの *プロセス* の章の *スレッドセーフなメソッドの書き方* の段落を参照ください。 @@ -61,8 +61,8 @@ Web関連のほとんどの 4Dコマンドや関数、データベースメソ すべての Web関連コマンドはスレッドセーフです: - - *Webサーバー* テーマの全コマンド - - *HTTPクライアント* テーマの全コマンド +- *Webサーバー* テーマの全コマンド +- *HTTPクライアント* テーマの全コマンド Web関連のデータベースメソッドもスレッドセーフであり、プリエンプティモードで使用することが可能です (前述参照): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...)。 @@ -72,16 +72,16 @@ Web関連のデータベースメソッドもスレッドセーフであり、 以下の 4D WebサーバーURLはスレッドセーフであり、プリエンプティモードで使用可能です: - - *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) - - *4dcgi/* (呼び出されるデータベースメソッドもまたスレッドセーフでなければいけません) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) - - *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4daction/* (呼び出されるプロジェクトメソッドもまたスレッドセーフでなければいけません) +- *4dcgi/* (呼び出されるデータベースメソッドもまたスレッドセーフでなければいけません) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (ピクチャーフィールドの Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) +- *4dimg/* (ピクチャー変数の Webリクエストに対し `PROCESS 4D TAGS` によって生成されます) ### プリエンプティブWebプロセスアイコン diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md index e29b9f3971684f..c0eb41ba981ab5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studioは、Webビジネスアプリケーションの開発に特化し Qodly Studio はフル機能の Web UI を提供し、以下のことを可能にします: - - キャンバス上にコンポーネントを配置して Qodlyページを作成する - - コンポーネントを Qodly Sources にマッピングする - - イベントを設定して 4Dコードをトリガーする - - さらに沢山のことが可能です +- キャンバス上にコンポーネントを配置して Qodlyページを作成する +- コンポーネントを Qodly Sources にマッピングする +- イベントを設定して 4Dコードをトリガーする +- さらに沢山のことが可能です ## 設定 @@ -24,19 +24,19 @@ Qodly Studio はフル機能の Web UI を提供し、以下のことを可能 Qodly Studio は、以下の Webブラウザーをサポートしています: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox 推奨解像度は 1920x1080 です。 #### 4Dアプリケーション - - 開発: 4D v20 R2 以上 - - 運用: 4D Server v20 R2 以上 - - Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 - - Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 - - Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 +- 開発: 4D v20 R2 以上 +- 運用: 4D Server v20 R2 以上 +- Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。 +- Web セッション (スケーラブルセッション) が [有効](sessions.md#webセッションの有効化) である必要があります。 +- Qodlyフォームによって呼び出される 4Dコードは [スレッドセーフ](preemptiveWeb.md) でなければなりません。 ### Qodly Studio へのアクセスを有効化する @@ -46,8 +46,8 @@ Qodly Studioは、[WebAdmin Webサーバー](../Admin/webAdmin.md) によって Qodly Studio へのアクセスを有効化するには、2つのレベルで明示的に許可する必要があります: - - 4Dアプリケーションレベルで - - プロジェクトレベルで +- 4Dアプリケーションレベルで +- プロジェクトレベルで 2つのレベルのいずれか (または両方) が有効でない場合、Qodly Studio　へのアクセスは拒否されます (403ページが返されます)。 @@ -79,8 +79,8 @@ WebAdmin Webサーバーでの認証には、アクセスキーを使用しま 4Dプロジェクトの管理上、以下の使用法のみがサポートされます: - - Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 - - Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 +- Qodly Studio での開発は **4D** (シングルユーザー) でおこなう必要があります。 +- Qodlyページを利用した 4Dアプリケーションの運用は、**4D Server** でおこなう必要があります。 :::warning @@ -94,10 +94,10 @@ Qodly Studio ページは、[WebAdmin Webサーバーが起動されており](. Qodly Studio にアクセスするには 2つの方法があります: - - **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 +- **デザイン** メニュー (4Dシングルユーザー) または **ウィンドウ** メニュー (4D Server) から **Qodly Studio...** メニューコマンドを選択します。 WebAdmin Webサーバーがすでに起動されている場合は、その設定に応じて、デフォルトのブラウザーが `IPaddress:HTTPPort/studio` または `IPaddress:HTTPSPort/studio` を開きます。 それ以外の場合は、最初に WebAdmin Webサーバーを起動するかどうかを尋ねるメッセージが表示されます。 - - 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
+- 4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:
`IPaddress:HTTPPort/studio` または: @@ -145,24 +145,24 @@ Qodlyページを利用した Webアプリケーションを開発するには 以下のコマンドとクラスは、Qodlyページのサーバーサイド管理に特化しています: - - [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 - - [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 - - [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 - - [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 +- [`Web Form`](../API/WebFormClass.md#web-form) コマンド: Qodlyページをオブジェクトとして返します。 +- [`Web Event`](../API/WebFormClass.md#web-event) コマンド: Qodlyページのコンポーネント内でトリガーされたイベントを返します。 +- [`WebForm`](../API/WebFormClass.md) クラス: レンダリングされた Qodlyページを管理する関数とプロパティを持ちます。 +- [`WebFormItem`](../API/WebFormItemClass.md) クラス: Qodlyページのコンポーネントを管理する関数とプロパティを持ちます。 ### プロジェクトメソッドを使用する 推奨される方法は、プロジェクトメソッドではなく、クラス関数を使用することです。 コンポーネントから呼び出すことが可能なのは、クラス関数のみです。 それでも、次の 2つの方法で、Qodly Studio でもプロジェクトメソッドを使用できます: - - クラス関数からメソッドを呼び出すことができます。 - - Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 +- クラス関数からメソッドを呼び出すことができます。 +- Qodly Explorer から直接 [メソッドを実行](https://developer.qodly.com/docs/studio/coding#methods-and-classes) できます。 ### オフラインでの使用 コンピュータがインターネットに接続されていない状態でも、Qodly Studio を使って開発することができます。 ただしこの場合、以下の機能は使用できません: - - [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 - - UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 +- [テンプレート](https://developer.qodly.com/docs/studio/pageLoaders/templates): テンプレートライブラリは空です。 +- UI Tips: ![alt-text](../assets/en/WebServer/tips.png)アイコンをクリックしても表示されません。 ## 運用 @@ -178,8 +178,8 @@ Qodly で Qodlyページをレンダリングする方法の詳細について Qodlyページのレンダリングを有効にするには、以下のオプションを設定する必要があります。 - - 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 - - [4D Webサーバー](webServer.md) を起動しておく必要があります。 +- 4Dプロジェクトの **設定** > **Web** > **Web機能** > [**RESTサーバーとして公開**](../settings/web.md#restサーバーとして公開) オプションを有効にする必要があります。 +- [4D Webサーバー](webServer.md) を起動しておく必要があります。 :::note @@ -309,9 +309,9 @@ End if Webユーザーセッションからログアウトアクションをトリガーすると、次のような効果があります: - - カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 - - 関連する 4Dライセンスが解放されます。 - - `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 +- カレントWebユーザーセッションは権限を失い、[記述的RESTリクエスト](../REST/authUsers.md#記述的restリクエスト) のみが許可されます。 +- 関連する 4Dライセンスが解放されます。 +- `Session.storage` は、Webセッションの非アクティブタイムアウトまで (少なくとも 1時間) 保持されます。 ログアウト後のこの期間にユーザーが再ログインすると、同じセッションが使用され、`Session.storage` 共有オブジェクトが現在の内容とともに利用可能になります。 ## レンダリングのためのライセンス消費について @@ -363,7 +363,7 @@ Qodly Studio のユーザー設定で、レンダラーのポップオーバー 必要以上のライセンスを使用しないため、次のいずれかをお勧めします: - - 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 - - Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 - - プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 +- 別のブラウザータブでレンダラーを実行します (Qodlyページがレンダリングされた URL `IP:port/$lib/renderer/?w=QodlyPageName` を入力します)。 +- Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。 +- プロジェクトデータベースの Webサーバーの [セッションcookie](webServerConfig.md#セッションcookie-samesite) には、`Lax` の値を使用してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md index d2afc2319f0170..2b30a136bc6766 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md @@ -19,16 +19,16 @@ title: テンプレートページ 以下の 4Dタグを使用することができます: - - 4DTEXT: 4D変数および式をテキストとして挿入します。 - - 4DHTML: HTMLコードを挿入します。 - - 4DEVAL: 4D式を評価します。 - - 4DSCRIPT: 4Dメソッドを実行します。 - - 4DINCLUDE: ページを他のページに含めます。 - - 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 - - 4DCODE: 4Dコードを挿入します。 - - 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 - - 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 - - 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 +- 4DTEXT: 4D変数および式をテキストとして挿入します。 +- 4DHTML: HTMLコードを挿入します。 +- 4DEVAL: 4D式を評価します。 +- 4DSCRIPT: 4Dメソッドを実行します。 +- 4DINCLUDE: ページを他のページに含めます。 +- 4DBASE: 4DINCLUDE タグが使用するデフォルトフォルダーを変更します。 +- 4DCODE: 4Dコードを挿入します。 +- 4DIF, 4DELSE, 4DELSEIF, 4DENDIF: HTMLコードに条件式を挿入します。 +- 4DLOOP, 4DENDLOOP: HTMLコードにループを挿入します。 +- 4DEACH, 4DENDEACH: コレクション内、エンティティセレクション内、またはオブジェクトのプロパティをループします。 これらのタグについては、[変換タグ](../Tags/transformation-tags.md) のページで説明しています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md index 38e67795f1a74d..b619a12bbf322b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ title: 管理 4D Webサーバーは複数の方法で起動できます: - - ボタン/メニューコマンドの使用。 +- ボタン/メニューコマンドの使用。 - 4D: **実行 ＞ Webサーバー開始** メニュー
![](../assets/en/WebServer/start1.png) - 4D Server: HTTPサーバーページの **HTTPサーバー開始** ボタン
![](../assets/en/WebServer/start2.png) - - 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) +- 4Dアプリケーション開始時に Webサーバーを自動起動。 これには、ストラクチャー設定の **Web/設定**ページを表示し、**開始時にWebサーバーを起動** オプションを有効にします:
![](../assets/en/WebServer/config.png) - - [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 +- [`webServer.start()`](API/WebServerClass.md#start) 関数または `WEB START SERVER` コマンドを呼び出してプログラムで開始。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して [`webServer.start()`](API/WebServerClass.md#start) 関数を呼び出すことで開始できます。 @@ -29,9 +29,9 @@ title: 管理 4D Webサーバーは複数の方法で停止できます: - - 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 +- 4D の **実行 ＞ Webサーバー停止** メニューを使用するか、 4D Server にて HTTPサーバーページの **HTTPサーバー停止** ボタンを使用する (いずれも、サーバー開始前は **…開始** と表示されています)。 - - [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 +- [`webServer.stop()`](API/WebServerClass.md#stop) 関数または `WEB STOP SERVER` コマンドを呼び出してプログラムで停止。 コンポーネントの Webサーバーは、コンポーネントの WebServer オブジェクトに対して `webServer.stop()` 関数を呼び出すことで停止できます。 @@ -53,8 +53,8 @@ title: 管理 これをおこなうには: - - 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 - - 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 +- 4D: ストラクチャー設定の [Web / オプション (I) ページ](../settings/web.md) の **キャッシュクリア** ボタンをクリックします。 +- 4D Server: 4D Server 管理ウィンドウ の HTTPサーバーページにて、**キャッシュクリア** ボタンをクリックします。 キャッシュは即座にクリアされます。 @@ -64,11 +64,11 @@ title: 管理 Webサーバーに関連する情報は、ランタイムエクスプローラーにある **ウォッチ** ページ (**Web** 項目内) に表示されます。 - - **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 +- **Webキャッシュ使用**: Webキャッシュに存在するページ数とその使用率を示します。 Webサーバーがアクティブでキャッシュサイズが 0 より大きい場合のみ、この情報が利用できます。 - - **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webサーバー経過時間**: Webサーバーの使用時間を (時間 : 分: 秒 フォーマットで) 示します。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 - - **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 +- **Webヒット数**: Webサーバーが起動してから受け取った HTTPリクエストの総数と、毎秒のリクエスト数を示します (ランタイムエクスプローラーの更新の間で測定) 。 Webサーバーがアクティブである場合のみ、この情報が利用できます。 ## 管理用 URL @@ -123,8 +123,8 @@ Webサイト管理用の URL を使用して、サーバー上に公開してい 4Dでは、Webリクエストのログを2種類作成することができます: - - Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 - - おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 +- Webサーバーの開発段階で有用なデバッグログ (*HTTPDebugLog.txt*)。 +- おもに統計目的で使用される、標準化された Webリクエストログ (*logweb.txt*)。 両方のログファイルは、アプリケーションプロジェクトの **Logs** フォルダーに自動的に作成されます。 @@ -223,15 +223,15 @@ logweb.txt の自動バックアップパラメーターは、ストラクチャ 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md index 99dc96b95b64e9..1329d256534062 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ CORSサービスで許可されたホストとメソッドの一覧。 CORS を介したサーバーへのデータリクエスト送信が許可されている外部ページのドメイン名または IPアドレス。 複数のドメインを追加してホワイトリストを作成することができます。 複数のシンタックスがサポートされています: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### 許可された HTTPメソッド (methodsプロパティ) 対応する CORSホストに対して許可する HTTPメソッド。 以下の HTTPメソッドがサポートされます: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH メソッド名はセミコロン区切りで指定します(例: "post;get")。 methods が空、null、あるいは undefined の場合、すべてのメソッドが許可されます。 @@ -145,9 +145,9 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" デフォルトホームページを変更するには、パスを "デフォルトホームページ" エリアに入力します。 - - パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 +- パスは、[デフォルトHTMLルート](#ルートフォルダー) からの相対パスで設定しなければなりません。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- パスはスラッシュ ("/") で始まったり終わったりしてはいけません。 たとえば、デフォルトHTMLルートフォルダー内の "Web" サブフォルダーにある "MyHome.htm" をデフォルトホームページにする場合、"Web/MyHome.htm" と入力します。 @@ -318,15 +318,15 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。 デフォル #### IPv6 のサポートについて - - **TCPポートが使用済みでも警告は出ません**
+- **TCPポートが使用済みでも警告は出ません**
サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。 しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - - **IPv4-マップされた IPv6アドレス**
+- **IPv4-マップされた IPv6アドレス**
プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。 これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 - - **ポート番号の表記**
+- **ポート番号の表記**
IPv6 記法はコロン (:) を使用するので、ポート番号を追加するときには混乱を招く恐れがあることに注意が必要です。たとえば: ```code4d @@ -422,10 +422,10 @@ Webサーバーに処理を許可する HTTPリクエスト (POST) の最大サ とりうる値: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (デフォルト) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (デフォルト) +- 4 = TLSv1_3 変更した場合、設定を反映するには Webサーバーを再起動する必要があります。 @@ -492,10 +492,10 @@ User-Agent: Disallow: /GIFS/ ``` - - "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 - - "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 - - "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 +- "User-Agent: \*" は、すべてのクローラーが対象であることを示します。 +- "Disallow: /4D" は、/4D から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /%23%23" は、/%23%23 から始まる URL へのアクセスを許可しないことをクローラーに通知します。 +- "Disallow: /GIFS/" は、/GIFS/ フォルダーおよびそのサブフォルダーへのアクセスを許可しないことをクローラーに通知します。 他の例題: @@ -520,15 +520,15 @@ User-Agent: デフォルトで、4D は **WebFolder** という名前のデフォルトHTMLルートフォルダーを定義します。 Webサーバーの初回起動時にこのフォルダーが存在しなければ、HTMLルートフォルダーは物理的にディスク上に作成されます。 ルートフォルダーは以下の場所に作成されます: - - 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 - - 4Dリモートモードでは、ローカルのリソースフォルダー内 +- 4D (ローカル) および 4D Server では、[Project フォルダー](Project/architecture.md#project-フォルダー) と同階層。 +- 4Dリモートモードでは、ローカルのリソースフォルダー内 デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 - - このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 - - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 - - フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 - - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 置きます。 +- パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 @@ -583,9 +583,9 @@ User-Agent: 次の値が提供されています: - - "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 - - "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 - - "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 +- "Strict" (4Dセッションcookie の `SameSite` 属性のデフォルト値): ファーストパーティーのコンテキスト、すなわち現在のサイトのドメインに一致するコンテキストでのみ cookie は送信され、サードパーティーの Webサイトには決して送信されません。 +- "Lax": クロスサイトのサブリクエストでは cookie は送信されませんが (たとえば、画像やフレームをサードパーティーのサイトにロードする場合など)、ユーザーがオリジンのサイトに移動するとき (つまり、リンクを辿っているとき) には送信されます。 +- "None": ファーストパーティーやオリジン間リクエストにかかわらず、すべてのコンテキストにおいて cookie が送信されます。 "None" を使用する場合は、cookie の `Secure` 属性も設定する必要があります (設定しないと、cookie がブロックされます)。 セッションcookie の `Secure` 属性値は、HTTPS接続の場合には (`SameSite` 属性値が何であれ)、自動的に "True" に設定されます。 @@ -629,9 +629,9 @@ User-Agent: Keep-Alive接続を設定する 2つのオプションがあります: - - **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

+- **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 Once this period is over, the server closes the connection.

+- **タイムアウト**: この値を使用して、Webブラウザーからリクエストがおこなわれない状態で、Webサーバーが開かれた接続を保守する最大の待ち秒数を設定します。 Once this period is over, the server closes the connection.

接続が閉じられた後に Webブラウザーがリクエストを送信すると、新しい TCP接続が作成されます。 この動作はユーザーからは見えません。

diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md index 7547efe4bdb500..d2d2e6060b87d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md @@ -7,9 +7,9 @@ title: Webサーバーオブジェクト たとえば、メインアプリケーションに 2つのコンポーネントをインストールしている場合、アプリケーションから最大 3つの独立した Webサーバーを起動して監視することができます: - - ホストアプリケーションの Webサーバーを1つ - - コンポーネント#1 の Webサーバーを1つ - - コンポーネント#2 の Webサーバーを1つ +- ホストアプリケーションの Webサーバーを1つ +- コンポーネント#1 の Webサーバーを1つ +- コンポーネント#2 の Webサーバーを1つ 1つの 4Dアプリケーションプロジェクトに接続できるコンポーネントの数、つまり Webサーバーの数には、メモリ以外の制限はありません。 @@ -19,9 +19,9 @@ title: Webサーバーオブジェクト 各 Webサーバー (ホストアプリケーションまたはコンポーネント) は、個別のコンテキストで使用できます。これには、以下が含まれます: - - `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し - - 4Dタグの処理とメソッドの呼び出し - - Webセッションや TLSプロトコルの管理 +- `On Web Authentication` および `On Web Connection` データベースメソッドの呼び出し +- 4Dタグの処理とメソッドの呼び出し +- Webセッションや TLSプロトコルの管理 これにより、独自の Webインターフェースを備えた独立したコンポーネントや機能を開発することができます。 @@ -49,8 +49,8 @@ webServer:=WEB Server(Web server database) アプリケーションがコンポーネントを使用している場合に: - - コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や - - リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 +- コンポーネントからホストアプリケーションの Webサーバーを呼び出す場合や +- リクエストを受け取ったサーバー (どのサーバーでも) を呼び出す場合 次を使うこともできます: @@ -97,8 +97,8 @@ A web server object contains [various properties](API/WebServerClass.md../comman 2. 上を使用しない場合は、`WEB SET OPTION` コマンドを使用して定義します (ホストアプリケーションのみ)。 3. 上を使用しない場合は、ホストアプリケーションまたはコンポーネントの設定で定義します。 - - Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 - - Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 +- Webサーバーを起動していない場合、プロパティには Webサーバーの次回起動時に使用される値が含まれています。 +- Webサーバーが起動されている場合、プロパティには Webサーバーで使用される実際の値が含まれます (デフォルトの定は [`.start()`](API/WebServerClass.md#start) 関数の `settings` パラメーターによって上書きされている可能性があります)。 > *isRunning*、*name*、*openSSLVersion*、*perfectForwardSecrecy* は読み取り専用のプロパティで、[`start()`](API/WebServerClass.md#start)関数の `settings` オブジェクトパラメーターで事前に定義することはできません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md index 75a443b6172d1b..9de16429321acb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション) +- 4D Write Pro ドキュメント *breakType* 引数には、*4D Write Pro 定数* テーマから以下の定数のどれか一つを渡し、挿入するブレークのタイプを定義します: @@ -47,7 +47,7 @@ displayed_sidebar: docs | wk prepend | Integer | 1 | コンテンツをターゲットの始めに挿入する | | wk replace | Integer | 0 | ターゲットのコンテンツを置き換える | - - *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: +- *targetObj* がレンジである場合、オプションの*rangeUpdate* 引数に以下の定数のいづれか一つを渡すことで挿入されたコンテンツが結果のレンジに含まれるかどうかを指定することができます: | 定数 | 型 | 値 | 説明 | | --------------------- | ------- | - | ------------------------------------------------- | @@ -56,7 +56,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md index 7d89b03a109738..f0e5c9d984ab9e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ displayed_sidebar: docs *targetObj* 引数には、以下のいずれかを渡すことができます: - - レンジ - - 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) - - 4D Write Pro ドキュメント +- レンジ +- 要素(表組 / 行 / 段落 / 本文 / ヘッダー / フッター / インラインピクチャー / セクション / サブセクション / テキストボックス) +- 4D Write Pro ドキュメント 挿入する*wpDoc* 引数のドキュメントには、 [WP New](../commands-legacy/wp-new.md) コマンドまたは [WP Import document](wp-import-document.md) コマンドを使用して作成した任意の4D Write Pro ドキュメントオブジェクトを指定可能です。 本文の子要素のみが挿入されます(つまり、ヘッダー、フッター、テキストボックスおよびアンカーされたピクチャーは挿入されません)。 指定されたレンジのセクションおよびブックマークは保存されます。 これに加え、要素はコピーされるので、*wpDoc* 引数の内容はその後再利用することが可能です。 @@ -54,7 +54,7 @@ displayed_sidebar: docs *rangeUpdate* 引数を渡さなかった場合、デフォルトでは挿入されたコンテンツは結果のレンジに含まれます。 - - *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 +- *targetObj* がレンジではない場合、*rangeUpdate* は無視されます。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/writeprointerface.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/writeprointerface.md index 85580bde44bd29..f6ecccc168c52c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/writeprointerface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/WritePro/writeprointerface.md @@ -11,8 +11,8 @@ title: 4D WritePro インターフェース You will find below: - - the Table Wizard configuration documentation, - - the integrated A.I. ドキュメント. +- the Table Wizard configuration documentation, +- the integrated A.I. ドキュメント. ## 表ウィザード @@ -60,9 +60,9 @@ You will find below: テンプレートの設定には以下が含まれます: - - [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 - - [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 - - [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 +- [テンプレートファイル](#テンプレートファイル): テーブルとフィールドを定義し、アプリケーションに適合したフォーミュラを用意します。 +- [トランスレーションファイル](#トランスレーションファイル): テーブル、フィールド、フォーミュラの翻訳名を指定します。 +- [テーマファイル](#テーマファイル): グラフィックスタイルとテーマをデザインしカスタマイズします。 表ウィザードを設定するにあたって、これら 3種類のファイルにはそれぞれ明確な役割がありますが、いずれも必須ではありません。 @@ -70,10 +70,10 @@ You will find below: テンプレートファイルを使って、以下のことが定義できます: - - 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ - - ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) - - 表の列として使用できるデータクラス属性 - - ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ +- 表のデータソースとして使用されるエンティティセレクションを返すフォーミュラ +- ブレーク行のフォーミュラ (ブレーク行を挿入できる場合) +- 表の列として使用できるデータクラス属性 +- ブレーク行、キャリーオーバー行、プレースホルダー行、追加の行において、コンテキストメニューから選択可能なフォーミュラ テンプレートファイルはプロジェクトの "[`Resources`](../Project/architecture.md#resources)/4DWP_Wizard/Templates" フォルダーに保存する必要があります。 @@ -318,11 +318,11 @@ The 4D Write Pro interface uses OpenAI, for which you need to provide your own k In the current implementation, the feature has the following limitations: - - use of a predefined AI provider and necessity to pass your OpenAI key - - basic chatting features - - no image handling - - non-configurable predefined action commands - - predefined translations English/French and French/English only +- use of a predefined AI provider and necessity to pass your OpenAI key +- basic chatting features +- no image handling +- non-configurable predefined action commands +- predefined translations English/French and French/English only ### Enabling the AI feature @@ -349,8 +349,8 @@ The **A.I.** button is then displayed: ![ai button](../assets/en/WritePro/ai-button.png) - - in the 4D Write Pro Toolbar, in the **Import Export** tab, - - in the 4D Write Pro Widget, in the **Font Style** tab. +- in the 4D Write Pro Toolbar, in the **Import Export** tab, +- in the 4D Write Pro Widget, in the **Font Style** tab. Click on the button to display the AI dialog box. @@ -388,8 +388,8 @@ These buttons propose basic interactions between the chat area, the underlying 4 ![ai interaction](../assets/en/WritePro/ai-interaction.png) - - **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. - - **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. +- **Return raw text**/**Return styled text**: Copy the latest response or the selected response from the AI to the 4D Write Pro document at the current insertion point, replacing the selected text if any. +- **Copy raw text**/**Copy styled text**: Copy the latest response or the selected response from the AI in the clipboard. In both cases, if the response was provided with styles, you can decide to copy the text with or without styles. diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form-event.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form-event.md index 833421870ace19..e92524d0ba8f15 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form-event.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form-event.md @@ -37,8 +37,8 @@ displayed_sidebar: docs イベントオブジェクトには、イベントが発生したオブジェクト によっては追加のプロパティが含まれていることがあります。 これは以下のオブジェクトで生成された *eventObj* オブジェクトが対象です: - - リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 - - 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 +- リストボックスまたはリストボックスカラムオブジェクト。詳細は[こちらの章](../FormObjects/listbox_overview.md#追加プロパティ)を参照してください。 +- 4D View Pro エリア。詳細は[On VP Ready フォームイベント](../Events/onVpReady.md) を参照してください。 ***注意:*** カレントのイベントが何もない場合、**FORM Event** はnull オブジェクトを返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form.md index d81d577a43755d..dca05da91f65e4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/form.md @@ -26,30 +26,30 @@ displayed_sidebar: docs **Form** コマンドはカレントフォームに割り当てられている( *formData* 引数、またはフォームエディターで割り当てられたユーザークラスによってインスタンス化された) オブジェクトを返します。 4D は以下の場合にはカレントフォームに自動的にオブジェクトを割り当てます: - - カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 - - カレントフォームがサブフォームである場合。 - - テーブルフォームが現在画面上に表示されている場合。 +- カレントフォームが、[`DIALOG`](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドのいずれか一つによってロードされた場合。 +- カレントフォームがサブフォームである場合。 +- テーブルフォームが現在画面上に表示されている場合。 ### コマンド(DIALOGなど) カレントのフォームが[DIALOG](dialog.md)、[`Print form`](print-form.md) あるいは [`FORM LOAD`](form-load.md) コマンドによって表示あるいはロードされていた場合、は以下のいずれかのものを返します: - - コマンドに引数として渡された*formData* オブジェクト(あれば)。 - - [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 - - または、空のオブジェクト。 +- コマンドに引数として渡された*formData* オブジェクト(あれば)。 +- [フォームに割り当てられているユーザークラス](../FormEditor/properties_FormProperties.md#form-class) のインスタンス化されたオブジェクト(あれば)。 +- または、空のオブジェクト。 ### サブフォーム カレントフォームがサブフォームの場合、返されるオブジェクトは親コンテナ変数に依存します: - - 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ +- 親コンテナに割り当てられている変数がオブジェクト型であった場合、 **Form** はその変数の値を返します。\ この場合、**Form** から返されるオブジェクトは、以下の式から返されるものと同じになります : ```4d (OBJECT Get pointer(Object subform container))-> ``` - - 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 +- 親コンテナに割り当てられている変数がオブジェクト型として型指定されていない場合、**Form** は、サブフォームのコンテキストで4D によって維持される、空のオブジェクトを返します。 より詳細な情報については、*サブフォームページ* の章を参照してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md index 352fff791b636b..7b6bd571dad62d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md @@ -39,14 +39,14 @@ displayed_sidebar: docs 以下のサポートされる型であれば、いくつでも値を渡すことができます: - - 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 - - text - - boolean - - date - - 時間 (ミリ秒の数 (実数) として保存されます)。 - - null - - 共有オブジェクト - - 共有コレクション +- 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 +- text +- boolean +- date +- 時間 (ミリ秒の数 (実数) として保存されます)。 +- null +- 共有オブジェクト +- 共有コレクション :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md index cdb231ed9fe273..f80d1bd1b2f9c9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs *form* 引数には、以下のいづれかを渡すことができます: - - フォーム名 - - 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) - - フォームの詳細を格納しているオブジェクト +- フォーム名 +- 使用するフォームの詳細を格納している有効な.josn ファイルへのパス(POSIX シンタックス、*Form file path* 参照) +- フォームの詳細を格納しているオブジェクト **Print form** は、 フォームの印刷後に改ページを行わないため、同じページに異なるフォームを容易に配置することができます。 したがって、**Print form** は、異なるテーブルや異なるフォームを含む複雑な印刷処理に最適です。 フォーム間で改ページを強制的に行うには[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用してください。 印刷可能領域を超える高さのフォームの印刷を次のページに持ち越すには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを使用する前に[CANCEL](../commands-legacy/cancel.md) コマンドを呼び出してください。 3つの異なるシンタックスを使用できます: - - **詳細エリアの印刷** +- **詳細エリアの印刷** シンタックス: @@ -43,7 +43,7 @@ displayed_sidebar: docs この場合、**Print form** はフォームの詳細エリア (ヘッダマーカと詳細マーカの間のエリア) だけを印刷します。 - - **フォームエリアの印刷** +- **フォームエリアの印刷** シンタックス: @@ -79,7 +79,7 @@ displayed_sidebar: docs | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **セクション印刷** +- **セクション印刷** シンタックス: @@ -101,8 +101,8 @@ form data オブジェクトについての詳細な情報については、[`DI **Print form** を使用する場合、印刷ダイアログボックス は表示されません。 レポート はデザインモードでフォームに割り当てられた用紙設定を使用しません。 **Print form** を呼び出す前に用紙設定を指定する方法は2通りあります: - - [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 - - [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 +- [PRINT SETTINGS](../commands-legacy/print-settings.md) コマンドを使用する。 この場合、ユーザが設定を行います。 +- [SET PRINT OPTION](../commands-legacy/set-print-option.md) と [GET PRINT OPTION](../commands-legacy/get-print-option.md) コマンドを使用する。 この場合、用紙設定はプログラムで指定します。 **Print form** は、印刷するページをそれぞれメモリ 中に作成します。 各ページはメモリ中のページがいっぱいになるか、[PAGE BREAK](../commands-legacy/page-break.md) コマンドを実行すると印刷されます。 **Print form** の使用後、最後のページの印刷を確実に行うためには、[PAGE BREAK](../commands-legacy/page-break.md) コマンドで終了しなければなりません(ただし [OPEN PRINTING JOB](../commands-legacy/open-printing-job.md) のコンテキスト内の場合を除く、注意参照)。 そうでないと、最後のページが一杯にならないと、それはメモリ中に残り印刷されません。 @@ -116,8 +116,8 @@ form data オブジェクトについての詳細な情報については、[`DI **4D Server:** このコマンドは、ストアドプロシージャのフレームワークにおいて4D Server 上で実行することができます。 この状況では、次の制約があります: - - サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 - - プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 +- サーバマシン上ではダイアログボックスを一切表示しないでください (特定の必要性がある場合を除く)。 +- プリンタ関連の問題が発生しても (用紙切れ、プリンタ接続切断等) 、エラーメッセージは生成されません。 ## 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md index a9bafc2eb7a12a..6ba3012ac1915d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md @@ -44,7 +44,7 @@ displayed_sidebar: docs | type | Integer | 実行中のプロセスタイプ。 取り得る値: 以下を参照のこと 取り得る値: 以下を参照のこと | | visible | Boolean | 表示であればTrue、それ以外はFalse | - - "state" の取り得る値: +- "state" の取り得る値: | 定数 | 値 | | ------------------------- | ---- | @@ -57,7 +57,7 @@ displayed_sidebar: docs | Waiting for internal flag | 4 | | Paused | 5 | - - "type" の取り得る値: +- "type" の取り得る値: | 定数 | 値 | | ----------------------------- | --- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/session.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/session.md index 1f014a7e3bac76..3a0c9b3473fb57 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/session.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### 参照 +## 参照 [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md index 9e655afbe3bf37..2685d066293b71 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md @@ -13,8 +13,8 @@ title: クライアント-サーバーページ このオプションを使用して、起動された 4D Server データベースが公開データベースのリストに表示されるかどうかを指定できます。 - - このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 - - このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 +- このオプションが選択されていると (デフォルト)、データベースは公開され、公開データベースの一覧に表示されます (リモート4D の **利用可能**タブ)。 +- このオプションがチェックされていないと、データベースは公開されず、公開データベースの一覧に表示されません。 接続するには、接続ダイアログボックスの **カスタム** タブにデータベースのアドレスを手入力しなければなりません。 :::note @@ -49,10 +49,10 @@ TCPプロトコルを使用して、1台のマシン上で複数の 4Dアプリ 4D Server は 3つの TCPポートを使用して、内部サーバーとクライアントの通信をおこないます: - - **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 - - **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 - - **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 - - [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 +- **SQLサーバー**: デフォルトで 19812 (設定の "SQL" ページで変更可)。 +- **アプリケーションサーバー**: デフォルトで 19813 (設定の "クライアント-サーバー" ページで変更可)。 +- **DB4Dサーバー** (データベースサーバー): デフォルトで 19814。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+1 です。\ 4Dクライアントが 4D Server に接続するとき、アプリケーションサーバーのポート番号 (19813 または接続ダイアログボックスの IPアドレス欄でコロンの後ろに指定された番号) を使用して接続します。 その後の、それぞれ対応するポートを介した他のサーバーへの接続は自動です。再度ポート番号を指定する必要はありません。\ ルーターやファイアウォール越しに接続する場合には、この 3つのポートを明示的に開く必要があります。 +- [**リモートデバッガー**](../Debugging/debugging-remote.md): デフォルトで 19815。 このポート番号は直接変更できませんが、常にアプリケーションサーバーのポート番号+2 です。 #### ドメインサーバーによるユーザーの認証 @@ -66,9 +66,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 ここでは、ドロップダウンメニューにて 3つのネットワークオプションから選択できます: **Legacy**、**ServerNet** 、**QUIC** (プロジェクトモードのみ)。ネットワークレイヤーは、4D Server とリモートの 4Dマシン (クライアント) 間の通信を管理するのに使用されます。 - - **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. - - **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 - - **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 +- **旧式**: v15以前に作成されたデータベースとの互換性を確保するため、この旧式ネットワークレイヤーは引き続きサポートされています。 This network layer can also be enabled by programming using the [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) command. +- **ServerNet** (デフォルト): サーバーの ServerNet ネットワークレイヤーを有効にします (4D 15 以降で利用可能)。 +- **QUIC** (プロジェクトモードでのみ利用可能): サーバー上で QUICネットワークレイヤーを有効にします。 **注**: @@ -108,9 +108,9 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 この設定は、データベースの **Resources** フォルダーがセッション中に更新された場合について、接続中のクライアントマシンにおける同フォルダーのローカルインスタンスの更新モードを包括的に指定します (**Resources** フォルダーは、セッションが開かれるたびにリモートマシン上で自動的に同期されます)。 3つの選択肢があります: - - **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 - - **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. +- **しない**: ローカルの **Resources** フォルダーはセッション中に更新されません。 サーバーから送信される通知は無視されます。 The local **Resources** folder may be updated manually using the **Update Local Resources** action menu command (see [Using the Resources explorer](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **常に**: セッション中にサーバーから通知が送信されると、ローカルの **Resources** フォルダーは自動で同期されます。 +- **その都度指定**: サーバーから通知を受け取ると、クライアントマシン上でダイアログボックスが表示されます。 ユーザーはローカルの **Resources** フォルダーの同期を受け入れ、あるいは拒否できます。\ **Resources** フォルダーは、データベースインタフェースで使用されるカスタムファイルを格納しています (翻訳ファイルやピクチャーなど)。 このフォルダーの内容が更新されたときには、自動又は手動メカニズムを使用して各クライアントに通知できます。 For more information, please refer to the [Managing the Resources folder](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html) section. ## IP設定ページ @@ -122,10 +122,10 @@ Single Sign On (SSO) が有効になっている場合 (上述参照)、認証 設定表の動作は以下のとおりです: - - "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 - - "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 - - ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 - - セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: +- "許可-拒否" 列では、ポップアップメニューを使用して適用するルールを選択します (許可または拒否)。 ルールを追加するには、追加ボタンをクリックします。 すると、新しい行が表に追加されます。 **削除** ボタンで選択した行を削除できます。 +- "IPアドレス" 列で、ルールに関連する IPアドレスを指定します。 アドレスを指定するには、選択した行のセルをクリックし、以下の形式でアドレスを入力します: 123.45.67.89 (IPv4) または 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (IPv6)。 \* (アスタリスク) 文字をアドレスの末尾に使用して、範囲を指定することもできます。 たとえば、192.168.\* は 192.168 で始まるすべてのアドレスを示します。 +- ルールの適用は、表中の表示順に基づきます。 2つのルールが矛盾する設定の場合、より上に設定されているルールが優先されます。 行の順番を変更するには、列のヘッダーをクリックしてソートをおこなったり、 ドラッグ＆ドロップで移動したりすることができます。 +- セキュリティのため、ルールにより明示的に許可されたアドレスのみが接続を許可されます。 言い換えれば、表に拒否ルールしか定義されていない場合、許可ルールに適合するアドレスがないため、すべてのアドレスからの接続が拒否されます。 特定のアドレスからの接続のみを拒否したい場合 (そして他を許可したい場合)、許可 \* ルールを表の最後に追加します。 例: - 拒否 192.168.\* (192.168 で始まるアドレスを拒否) - 許可 \* (他のアドレスはすべて許可) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md index d30b7b374f9051..615332b6bd44c8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md @@ -8,10 +8,10 @@ title: 互換性ページ > 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。\ > このページでは、v18以降のバージョンから変換された 4Dデータベース/プロジェクトで利用可能な互換性オプションのみを説明します。 それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 - - **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 +- **旧式ネットワークレイヤーを使用する**: 4D v15 のリリース以降、4Dアプリケーションは 4D Server とリモートの 4Dマシン (クライアント) 間の通信に、*ServerNet* という新しいネットワークレイヤーを使い始めました。 以前のネットワークレイヤーは廃止予定となりますが、既存のデータベースとの互換性を保つために保持されます。 このオプションを使用すると、4D Serverアプリケーションにおいて、必要に応じていつでも以前のネットワークレイヤーを有効化することができます。 *ServerNet* は新規に作成されたデータベースおよび v15 以降から変換されたデータベースにおいては自動的に使用されます (このオプションがチェックされます)。 この設定を変更する場合、変更を反映するにはアプリケーションを再起動する必要があります。 接続していたクライアントアプリケーションも、新しいネットワークレイヤーで接続するため再起動しなければなりません。 **注:** このオプションは、`SET DATABASE PARAMETER` コマンドを使い、プログラミングによって管理することもできます。 - - **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: +- **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: - 最初の "/" はルートノードに限らない - "/" を XPath 式の最初の文字として使用しても、ルートノードからの絶対パスの宣言にはなりません。 - 暗示的なカレントノードはなし - カレントノードは XPath 式の中に含められていなければなりません。 @@ -19,12 +19,12 @@ title: 互換性ページ 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 On the other hand, if your code does not rely on the non-standard implementation and if you want to benefit from the extended XPath features in your databases (as described in the [`DOM Find XML element`](../commands-legacy/dom-find-xml-element.md) command), make sure the **Use standard XPath** option is *checked*. - - **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 See [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md), and [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 +- **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 - - **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 +- **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 - - **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file +- **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/database.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/database.md index 6fdcedfc30f7ea..9e0d20e5e66198 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/database.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/database.md @@ -31,9 +31,9 @@ title: データベースページ 3つのオプションから選択できます: - - **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 - - **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 - - **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 +- **システム**: このオプションが選択されると、4D のテンポラリファイルは Windows または macOS が指定する場所に配置されたフォルダーに作成されます。 You can find out the current location defined by your system using the [`Temporary folder`](../commands-legacy/temporary-folder.md) 4D command. ファイルは、データベース名とユニークな識別子からなるサブフォルダーに置かれます。 +- **データファイルフォルダー** (デフォルト): このオプションが選択されると、4D のテンポラリファイルはデータベースのデータファイルと同階層に配置される "temporary files" フォルダーに作成されます。 +- **ユーザー指定**: このオプションは、場所をカスタマイズするのに使用します。 場所のオプションを変更した場合、新しい設定を反映するにはデータベースを再起動する必要があります。 4D は選択されたフォルダーに書き込みアクセス権があるかを確認します。 アクセス権がなければ、使用できるフォルダーが見つかるまで 4D は他のオプションを試します。 > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +41,7 @@ title: データベースページ > これらのオプションのいずれかを変更した場合、新しい設定を反映するにはアプリケーションを終了し、再起動しなければなりません。 データベースが再び開かれると、すべてのインデックスが自動で再作成されます。 - - **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 +- **文字列の途中に含まれる＠はワイルドカードとして扱わない**: クエリ条件や文字列比較の際に "@" をどのように解釈するかを設定します。 When this option is not checked (default value), the at sign is used as the wildcard character, in other words, it replaces any character (see [Wildcard character (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). このオプションが選択されている場合、単語内にある "@" は普通の文字として扱われます。 この設定は、"@" が文字列内で使用される電子メールアドレスの検索などに有効です。 このオプションは検索、並び替え、文字列比較、およびテーブルに格納されるデータや配列などメモリ中のデータに影響を与えます。 (インデックス付きか否かにかかわらず) 文字型やテキスト型のフィールドおよび変数が、検索や並び替え時に "@" 文字がどのように解釈されるかの影響を受けます。 @@ -52,19 +52,19 @@ title: データベースページ - This option can also have an influence on the behavior of the commands in the [Objects (Forms)](../commands/theme/Objects_Forms.md) theme that accept the wildcard character ("@") in the object parameter. - セキュリティの理由で、データベースの Administrator または Designer のみがこのパラメーターを変更できます。 - - **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 +- **現在のデータ言語**: 文字列の処理と比較に使用する言語を設定します。 言語の選択は、テキストの並べ替えや検索、文字の大小などの比較ルール等に直接影響を与えます。ただし、テキストの翻訳や日付・時刻・通貨のフォーマットはシステムの言語設定が使用され、この設定には影響されません。 デフォルトで 4D はシステム言語を使用します。 つまり、4Dプロジェクトはシステム言語とは異なる言語で動作することができます。 プロジェクトが開かれるとき、4Dエンジンはデータファイルに使用されている言語を検知し、(インタープリターやコンパイルモードの) ランゲージに提供します。 データベースエンジン、あるいはランゲージのいずれがテキスト比較をおこなうかに関わらず、同じ言語が使用されます。 > 4D環境設定でも言語を設定できます ([一般ページ](../Preferences/general.md) 参照)。 この場合、その設定は新規に作成されるデータベースに適用されます。 - - **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 +- **非文字・非数字のみをキーワード区切り文字とする**: 4D が使用するキーワード区切り文字の設定を変更し、その結果、作成されるキーワードインデックスに影響を与えます。 このオプションが選択されていない場合、4D は言語上の特質を考慮する洗練されたアルゴリズムを使用します。 このアルゴリズムは、文字列中をダブルクリックしたときに選択範囲を決定するためワープロソフトが使用するものと同じです。 このアルゴリズムに関する詳細は以下の Webページを参照ください: `http://userguide.icu-project.org/boundaryanalysis`。 このオプションが選択されている場合、4D は簡易的なアルゴリズムを使用します。 この設定では、文字でも数字でもない文字がキーワード区切り文字として扱われます。 この設定は日本語など特定の言語の要求に沿うものです。 - - **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 +- **テキスト検索用の文字列比較を使用する**: このオプションは日本語が選択されている場合にのみ表示されます。 このオプションは "カタカナ-ひらがなでの長音記号" および、"ゝ" または "ゞ" などの繰り返し記号 (踊り字) などの文字の解釈を変更します。 一般的には、この設定が有効化されている方が日本語話者にとって望ましい結果が得られます。 #### MeCab のサポート (日本語版) @@ -82,7 +82,7 @@ title: データベースページ ### データベースキャッシュ設定 - - **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 +- **起動時にキャッシュサイズを計算**: このオプションが選択されている場合、キャッシュメモリの管理は、設定された制限に基づき、4D起動時にキャッシュサイズが計算されます。 これにより、ほとんどのケースで高パフォーマンスのメモリ設定がおこなわれます。 キャッシュメモリのサイズは設定されたパラメーターに基づき動的に計算されます。 デフォルトで提案される値は標準の 4D の使用状況に対応します。 - **他のアプリケーションとシステムのために予約するメモリ**: システムや他のアプリケーションが使用するために取り置く RAMメモリ量。 4D が実行されるマシン上で他のアプリケーションも実行する場合、必要に応じてこの値を増やします。 - **利用可能なメモリからキャッシュに使用する率**: 残りのメモリからキャッシュに割り当てる量の率。\ デフォルトでキャッシュに割り当てるサイズを取得するためには、以下の計算式を適用します: (物理メモリ – 予約したメモリ) X キャッシュに使用するメモリのパーセンテージ。 動的に計算するモードの場合、キャッシュメモリのサイズはアプリケーションやシステムのニーズに応じて動的に変化します。 以下のオプションを使用して上限と下限を設定できます: @@ -93,11 +93,11 @@ title: データベースページ ![](../assets/en/settings/memory-maximum-size.png) - - **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 +- **起動時にキャッシュサイズを計算オプションがチェックされていない場合**: このモードでは、データベースのキャッシュメモリサイズを開発者が決定します。 4D はキャッシュメモリを設定する入力エリアと、物理メモリに関する情報 (マシンに実装されたRAM)、現在のキャッシュ、そして再起動後のキャッシュサイズを表示します。 入力されたキャッシュサイズは、マシンのリソース状況にかかわらず、4Dデータベース用に予約されます。 この設定は、メモリ搭載量が分かっているなど、特定の状況で使用できます。 ほとんどのケースで起動時計算モードのキャッシュで良いパフォーマンスが提供されます。 - - **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 +- **キャッシュをディスクに保存 ... 秒/分**: キャッシュ中のデータを自動的に保存する間隔を設定します。 4D はキャッシュ中のデータを定期的に保存します。 この間隔を 1秒から 500分の範囲で設定できます。 デフォルトの設定値は 20秒です。 この保存は、キャッシュがいっぱいになった場合や、アプリケーションを終了する際にもおこなわれます。 You can also call the [FLUSH CACHE](../commands-legacy/flush-cache.md) command to trigger the flush at any moment. 大量のデータ入力が予期される場合は、この間隔を短くすることを検討してください。 停電などの理由でマシンが停止すると、前回の保存以降に入力されたデータが失われてしまいます (データログファイルをとっていれば復旧可能です)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md index f594bc8dd9dfce..541023abd9f72a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md @@ -23,9 +23,9 @@ title: インターフェースページ 他のオプションでは、アプリケーションモードでのさまざまなウィンドウの表示を設定します。 - - **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 +- **スプラッシュスクリーン**: このオプションが選択解除されていると、アプリケーションモードにおいて、[カレントメニューバーのスプラッシュスクリーン](Menus/bars.md#スプラッシュスクリーン) は表示されません。 このウィンドウを非表示にした場合、ウィンドウの表示は、たとえば `On Startup` データベースメソッドによってプログラムで管理しなければなりません。 - - **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 +- **フラッシュの進捗状況**: このオプションがチェックされていると、キャッシュデータがフラッシュされる際、4D は画面左下にウィンドウを表示します。 この処理はユーザー操作を一時的にブロックするため、ウィンドウを表示することでフラッシュがおこなわれていることをユーザーに通知することができます。 :::note @@ -33,9 +33,9 @@ title: インターフェースページ ::: - - **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 +- **印刷の進捗状況**: 印刷時の印刷進捗状況を表示するダイアログを有効または無効にします。 - - **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: +- **WindowsでSDIモードを使用する**: このオプションが選択されていると、[対応している環境](../Menus/sdi.md#SDIモード利用条件) で組み込みアプリが実行された場合に、4D は自動で [SDIモード (Single-Document Interface)](../Menus/sdi.md) を有効にします。 このオプションを選択すると、Windows では、4D メニューバーの **実行** メニューからアプリケーションの実行モードが選択できます: ![](../assets/en/settings/sdi-mdi.png) @@ -53,16 +53,16 @@ title: インターフェースページ 以下のスキームが利用可能です: - - **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) - - **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) - - **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 +- **ライト**: アプリケーションはデフォルトのライトテーマを使用します。![](../assets/en/settings/light-appearance.png) +- **ダーク**: アプリケーションはデフォルトのダークテーマを使用します。![](../assets/en/settings/dark-appearance.png) +- **継承する** (デフォルト): アプリケーションは次の優先レベル (例: OSユーザー設定) のテーマを継承します。 > デフォルトのテーマは CSS で管理可能です。 詳細については、[メディアクエリ](../FormEditor/createStylesheet.md#メディアクエリ) を参照してください。 メインアプリケーションスキームはデフォルトでフォームに適用されます。 その一方で、それを以下の方法で上書きすることもできます: - - by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; - - 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 +- by the [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) command at the working session level; +- 各フォームレベル (最優先レベル) では、[カラースキーム](../FormEditor/propertiesForm.html#カラースキーム) プロパティを使用できます。 **注記**: 印刷時には、フォームは常に "ライト" スキームを使用します。 ## ショートカット @@ -70,9 +70,9 @@ title: インターフェースページ デフォルトのショートカットは以下のとおりです: - - 入力フォーム確定: **Enter** - - 入力フォームキャンセル: **Esc** - - サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) +- 入力フォーム確定: **Enter** +- 入力フォームキャンセル: **Esc** +- サブフォームに追加: **Ctrl+Shift+/** (Windows) または **Command+Shift+/** (macOS) 操作のショートカットを変更するには、対応する **編集** ボタンをクリックします。 以下のダイアログボックスが表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/security.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/security.md index 184f91d21ab268..1233c3e1338e45 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/security.md @@ -11,7 +11,7 @@ title: セキュリティページ > これらの設定は、シングルユーザーモードで開かれたプロジェクトデータベースには適用されません。 - - **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 +- **デザインおよびランタイムエクスプローラーアクセス権**: データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 注: @@ -19,21 +19,21 @@ title: セキュリティページ - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 +- **デフォルトユーザー**: デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 このオプションを使用することで、完全なデータコントロールシステムを維持しつつ、データベースへのアクセスをシンプルにすることができます。 - デフォルトユーザーにパスワードを割り当てた場合、データベースが開かれるときにダイアログが表示され、パスワードの入力を求められます。 - デフォルトユーザーにパスワードを割り当てない場合、上記のダイアログは表示されません。
**注:** "デフォルトユーザー" モードが有効になっているときでも、強制的にユーザー認証ダイアログを表示させることができます。これはたとえば Administrator や Designer としてログインするために必要となります。 これには、データベースを開いたり接続したりする際に **Shift**キーを押したままにします。 - - **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). +- **パスワードダイアログにユーザーリストを表示する**: このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。 オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 For more information about the two versions of the password dialog box, see the section "Access system overview" in [Access system overview](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html). - **ユーザーリストをABC順で表示する** (上記オプションが選択されているときのみ有効です): このオプションが選択されていると、ユーザー認証ダイアログボックスのユーザーリストは名前の ABC順に表示されます。 - - **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 +- **ユーザーは自分のパスワードを変更可能**: このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。 This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 ## オプション - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. 以下のオプションを使用して、部分的あるいは全体的にこのフィルタリングを無効にできます。 - **すべてのユーザーを制限する** (デフォルトオプション): Designer と Administrator を含むすべてのユーザーに対し、コマンドや関数、プロジェクトメソッドへのアクセスを制限します。 - **DesignerとAdministratorは制限しない**: このオプションは Designer と Administrator のみに、4Dコマンドやメソッドへの完全なアクセスを与えます。 他のユーザーには制限をかけつつ、管理者に無制限のアクセスを与えたい場合に使用できます。 開発段階では、このモードを使用してすべてのフォーミュラやレポート等を自由にテストできます。 運用時には、一時的にコマンドやメソッドへのアクセスを与えるためなどに使用できます。 This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ title: セキュリティページ - **誰も制限しない**: このオプションはフォーミュラの制御を無効にします。 このオプションが選択されると、ユーザーはすべての 4Dコマンドおよびプラグインコマンド、さらにはプロジェクトメソッドを使用できます (非表示のものを除く)。 **Note:** This option takes priority over the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command. このオプションが選択されると、コマンドの効果はなくなります。 - - **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). +- **外部ファイルのユーザー設定を有効にする**: 外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。 このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 For more information, refer to [User settings](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 このオプションがチェックされていると: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/web.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/web.md index 74b5c4214c82d5..47065f87834426 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/web.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R9/settings/web.md @@ -82,9 +82,9 @@ Webページキャッシュを有効化します。 [キャッシュ](../WebServ このモードでは、以下の追加の Web サーバー設定を設定することができます: - - [最大同時Webプロセス](#最大同時webプロセス) - - [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) - - [Use preemptive processes](#use-preemptive-processes) +- [最大同時Webプロセス](#最大同時webプロセス) +- [一時的なコンテキストを再利用する (リモートモード)](#一時的なコンテキストを再利用する) +- [Use preemptive processes](#use-preemptive-processes) #### 旧式セッション (シングルプロセスセッション) @@ -166,9 +166,9 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 ログフォーマットメニューでは、次のオプションを提供します。 - - **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 +- **ログファイルなし**: このオプションが選択されると、4D はリクエストのログファイルを作成しません。 - - **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 +- **CLF (Common Log Format)**: このオプションが選択されると、リクエストのログが CLFフォーマットで作成されます。 CLFフォーマットでは、それぞれのリクエストが行単位でファイル内に表示されます:\host rfc931 user [DD/MMM/YYYY:HH:MM:SS] "request" state length\ 各フィールドはスペースによって区切られ、各行は CR/LF シーケンス (character 13、character 10) で終わります。 - host: クライアントの IPアドレス (例: 192.100.100.10) - rfc931: 4Dによって作成されない情報。 常に - (マイナス記号) です。 @@ -177,23 +177,23 @@ CORSサービスで許可されたホストとメソッドの一覧。 [CORS設 > 日付と時間はサーバーのローカルタイム。 - - request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) - - state: サーバーの返答。 - - length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 +- request: クライアントによって送られたリクエスト (例: GET /index.htm HTTP/1.0) +- state: サーバーの返答。 +- length: 返されたデータ (HTTPヘッダー以外) のサイズまたは 0。 > **注:** パフォーマンス上の理由により、操作はメモリのバッファーに 1Kbのパケットで保存されてから、ディスクに書き込まれます。 5秒間リクエストが発生しなくても、操作はディスクに書き込まれます。 > state として取り得る値は以下の通り:
200: OK
204: No contents
302: Redirection
304: Not modified
400: Incorrect request
401: Authentication required
404: Not found
500: Internal error
CLFフォーマットはカスタマイズされません。 - - **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 +- **DLF (Combined Log Format)**: このオプションが選択されると、リクエストログが DLFフォーマットで作成されます。 DLFフォーマットは CLFフォーマットと類似していて、まったく同じ構造を使用します。 さらに、各リクエストの最後に2つのHTTPフィールド、Referer と User-agent を追加します。 - Referer: リクエストされたドキュメントを指しているページの URL を含みます。 - User-agent: リクエストのオリジンにおけるクライアントのブラウザーまたはソフトウェアの名前とバージョンを含みます。 > DLFフォーマットはカスタマイズされません。 - - **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 +- **ELF (Extended Log Format)**: このオプションが選択されると、リクエストログが ELFフォーマットで作成されます。 ELFフォーマットは HTTPブラウザー界で広く普及しています。 そして、特別なニーズに応える洗練されたログを構築します。 この理由により、ELFフォーマットはカスタマイズされます。 記録するフィールドやそのフィールドをファイルへ挿入する順番を選択することが可能です。 - - **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 +- **WLF (WebStar Log Format)**: このオプションが選択されると、リクエストログが WLFフォーマットで作成されます。 WLFフォーマットは 4D WebSTAR サーバー用として特別に開発されました。 いくつかの追加フィールドを持つ以外、EFLフォーマットと似ています。 EFLフォーマットと同様、 カスタマイズされます。 **フィールドの設定**
ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると、選択されたフォーマットに対して利用可能なフィールドが表示されます。 ログに含む各フィールドを選択する必要があります。 ログに含む各フィールドを選択する必要があります。 @@ -233,14 +233,14 @@ ELF (Extended Log Format) または WLF (WebStar Log Format) を選択すると リクエストログの自動バックアップ設定を指定します。 最初に、頻度 (日、週などの単位) またはファイルサイズの上限に対応するラジオボタンをクリックして選択します。 必要に応じて、バックアップする正確な時間を指定します。 - - **バックアップしない**: 周期的なバックアップ機能が無効になっています。 - - **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 +- **バックアップしない**: 周期的なバックアップ機能が無効になっています。 +- **X 時間ごと**: 1時間単位でバックアップをプログラムする際、このオプションを使用します。 1 から 24 の値を入力します。 - **開始時刻**: 最初のバックアップ開始時間の設定に使用します。 - - **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 - - **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 - - **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 - - **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 +- **X 日ごと**: 1日単位でバックアップをプログラムする際、このオプションを使用します。 バックアップを毎日実行するには、1を入力します。 このオプションをチェックすると、バックアップの開始時間を指定しなければなりません。 +- **X 週ごと**: 1週間単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 たとえば、毎週バックアップをおこなうには 1 と設定します。 このオプションをチェックすると、バックアップを開始する曜日と時間を指定しなければなりません。 複数の曜日を選択することもできます。 +- **X 月ごと**: 1ヶ月単位でバックアップをプログラムする際、このオプションを使用します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 たとえば、毎月バックアップをおこなうには 1 と設定します。 +- **X MB** (サイズ指定): カレントのリクエストログのファイルサイズに基づいてバックアップをプログラムする際、このオプションを使用します。 ファイルが指定サイズに達すると、バックアップが自動的に起動します。 サイズ制限は 1、10、100 または 1000MB ごとに設定可能です。 > スケジュールされたバックアップの場合で、バックアップが開始する予定となっているときに Webサーバーが起動していないと、次回の起動において 4D はバックアップが失敗したと見なし、データベース設定で示されている適切な設定を適用します。 @@ -254,9 +254,9 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは 4D を Webサービスサーバーとして使用する (つまり、Webサービスの形でプロジェクトメソッドを公開する) ための設定をおこないます。 - - **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 - - **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 - - **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 +- **Webサービスリクエストを許可する**: このオプションを使用して Webサービスクライアントからのリクエストを受け付けるかどうかを設定します。 このオプションが選択されていない場合、4D は SOAPリクエストを拒否し、メソッドが*WSDLを公開* 属性を設定されていても WSDL を生成しません。 このオプションを選択すると、4D はメソッドプロパティに基づき WSDLファイルを生成します。 +- **Webサービス名:** このエリアでは Webサービスの "包括的な名称" を変更できます。 この名前は、SOAPサーバーレベルでサービスを識別するために使用されます。 デフォルトで 4D は "A_WebService" を使用します。 +- **Webサービス名前空間**: このエリアは 4D が公開する Webサービスの名前空間を設定するのに使用します。 インターネットに公開される各 Webサービスはユニークでなければなりません。 Webサービス名をユニークにするために XML名前空間が使用されます。 名前空間は任意の文字列で、XMLタグをユニークに識別するために使用されます。 典型的には、名前空間は会社の URL で始まります (http://mycompany.com/mynamespace)。 指定された文字列がユニークである限り、指定した URL に何か付け加える必要はありません。 デフォルトで 4D は以下の名前空間を使用します: http://www.4d.com/namespace/default。 > タグ名に関する XML標準に準拠するために、使用する文字には空白が含まれていてはなりません。また数字から始まっていてはなりません。 非互換性を避けるために、アクセント文字や日本語などの拡張文字は使用しないことを推奨します。 @@ -264,7 +264,7 @@ For more information about the support of Web Services in 4D, refer to the [Publ このエリアでは Webサービスクライアントとして 4D を使用する (つまり、ネットワーク上に公開されているサービスにサブスクライブする) ための設定をおこないます。 - - **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 +- **ウィザードメソッドプリフィクス**: このエリアでは、Webサービスウィザードを使用して 4D が自動生成するプロキシメソッドの接頭辞を設定します。 プロキシプロジェクトメソッドは 4Dアプリケーションと Webサービスサーバーとのリンクを形成します。 デフォルトで "proxy_" が使用されます。 ## Web機能 @@ -298,9 +298,9 @@ See [Users and sessions](../REST/authUsers.md) to know the recommended way to co このボタンは次のアップグレードシーケンスをトリガーします: - - **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 - - `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 - - プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 +- **読み込み/書き出し** メニューで設定されている REST API ユーザーグループが削除されます。 +- `On REST Authentication` データベースメソッドが削除されます (システムのゴミ箱に移動されます)。 +- プロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に ["roles.jsonファイル"](../ORDA/privileges.md#rolesjson-ファイル) が存在しない場合、`forceLogin` 属性が `True` に設定された状態でデフォルトのファイルが作成されます。 このアップグレードをおこなった後は、プロジェクトを再起動することを忘れないでください。 diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/ClassClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/ClassClass.md index ff6661f192e020..51b288575d7208 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/ClassClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/ClassClass.md @@ -160,8 +160,8 @@ Você pode passar um ou mais parâmetros *param* opcionais, que serão passados :::note Notas - - Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. - - Se `.new()` for chamado em uma classe inexistente, será retornado um erro. +- Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. +- Se `.new()` for chamado em uma classe inexistente, será retornado um erro. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/Document.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/Document.md index e7f4dff58d6d8f..d474fd0e038e34 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/Document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/Document.md @@ -320,8 +320,8 @@ Essa propriedade é **somente leitura**. A propriedade `.original` retorna o elemento de destino para um alias, um atalho ou um arquivo de link simbólico. O elemento alvo pode ser: - - um objeto File - - um objeto folder +- um objeto File +- um objeto folder Para arquivos não-alias, a propriedade retorna o mesmo objeto de arquivo que o arquivo. @@ -585,8 +585,8 @@ A função `.getText()` retorna o conte Opcionalmente, você pode designar o conjunto de caracteres a ser usado na leitura do conteúdo. Você pode passar também: - - em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), - - ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. +- em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), +- ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. > Para a lista de conjuntos de caracteres suportados por 4D, consulte a descrição do comando `CONVERT FROM TEXT`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index d97d156a01306b..b0cd758b8cf48d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Um objeto 4D.OutgoingMessage é um objeto [não compartilhável](../Concepts/sha A propriedade `.body` contém o corpo da mensagem enviada. Os seguintes tipos de dados são suportados na propriedade `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image A propriedade `.body` é de leitura e gravação. @@ -108,17 +108,17 @@ A função `.setBody()` defi Os seguintes tipos de dados são suportados no *corpo*: - - Text - - Blob - - Object - - Imagem +- Text +- Blob +- Object +- Imagem Quando essa função é usada, o cabeçalho do tipo de conteúdo é definido automaticamente dependendo do tipo *corpo*: - - Content-Type:text/plain se o corpo é um Texto - - Content-Type:application/octet-stream se o corpo é um Blob - - Content-Type:application/json se o corpo é um objeto - - Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem +- Content-Type:text/plain se o corpo é um Texto +- Content-Type:application/octet-stream se o corpo é um Blob +- Content-Type:application/json se o corpo é um objeto +- Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem Se *body* não for de um tipo de valor suportado, um erro é retornado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md index 293adb31fe2f7b..6e63bfc3fc3252 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ A propriedade `.keepAlive` contém diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/SessionClass.md index 33e5eed896ecc7..7d86bc766ac97b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Os objetos de sessão são retornados pelo comando [`Session`](../commands/session.md). Esses objetos fornecem ao desenvolvedor uma interface que permite gerenciar a sessão atual do usuário e executar ações como armazenar dados contextuais, compartilhar informações entre processos de sessão, iniciar processos preemptivos relacionados à sessão ou (somente na Web) gerenciar [privilégios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sessão Os seguintes tipos de sessões são suportados por essa classe: @@ -38,11 +47,6 @@ A disponibilidade de propriedades e funções no objeto `Session` depende do tip | [](#storage)
| | [](#username)
| -### To learn more - -[**Scalable sessions for advanced web applications**](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) (blog post)
-[**Permissions: Inspect Session Privileges for Easy Debugging**](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) (blog post) - ## .clearPrivileges() @@ -268,7 +272,7 @@ $privileges := Session.getPrivileges() #### Veja também [.setPrivileges()](#setprivileges)
-[Permissions – Inspect the privileges in the session for an easy debugging (blog post)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) +[*Permissions – Inspect the privileges in the session for an easy debugging* (blog post)](https://blog.4d.com/permissions-inspect-the-privileges-in-the-session-for-an-easy-debugging) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/TCPEventClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/TCPEventClass.md index 0852197a4c1aa0..49c6900a526827 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/TCPEventClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/TCPEventClass.md @@ -7,10 +7,10 @@ A classe `TCPEvent` fornece informações sobre os eventos que ocorrem durante o
História -| Release | Mudanças | -| ------- | ----------------------------- | -| 20 R9 | Novos atributos `ip` e `port` | -| 20 R8 | Classe adicionada | +| Release | Mudanças | +| ------- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | Classe adicionada |
@@ -20,12 +20,24 @@ Um objeto `TCPEvent` é imutável e não pode ser transmitido. As seguintes propriedades estão disponíveis: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### Descrição + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ Ao trabalhar com conexões TCP/IP de baixo nível, lembre-se de que não há gar - - -## .ip - -**ip** : Text - -#### Descrição - -A propriedade `.ip` contém o endereço IP da máquina remota. - - - ## .port diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/UDPEventClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/UDPEventClass.md index 333d72bec7ef58..a34ae91a606702 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/UDPEventClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/UDPEventClass.md @@ -19,34 +19,34 @@ A `UDPEvent` object is immutable and non-streamable. As seguintes propriedades estão disponíveis: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| - + -## .data +## .address -**data**: Blob +**address** : Text #### Descrição -The `.data` property contains the data associated with the event. It is only valid for events of type "data". +The `.address` property contains the IP address of the remote machine. - + -## .ip +## .data -**ip** : Text +**data**: Blob #### Descrição -The `.ip` property contains the IP address of the remote machine. +The `.data` property contains the data associated with the event. It is only valid for events of type "data". diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebFormClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebFormClass.md index 4b46b5c6dcc890..72094b45cc78fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebFormClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebFormClass.md @@ -55,8 +55,8 @@ A função `.disableState()` de Essa função não faz nada se: - - o *estado* não está habilitado no momento no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* não está habilitado no momento no formulário Web, +- o *estado* não existe para o formulário Web. Se você [enable](#enablestate) ou desativar vários estados na mesma função de usuário, todas as modificações são enviadas em simultâneo, para o cliente quando a função termina. @@ -80,8 +80,8 @@ A função `.enableState()` ativ Essa função não faz nada se: - - o *estado* já foi ativado no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* já foi ativado no formulário Web, +- o *estado* não existe para o formulário Web. Se você ativar ou [desativar](#disablestate) vários estados dentro da mesma função de usuário, todas as modificações serão enviadas ao mesmo tempo, para o cliente quando a função terminar. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketClass.md index ca94ba2f4d4146..e6033ed940d735 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketClass.md @@ -86,8 +86,8 @@ A função `4D.WebSocket.new()` cria e Em *url*, passe o URL ao qual o servidor WebSocket responderá. Podem ser utilizados os seguintes padrões de URL: - - `ws://host[:port]path[?query]` para ligações padrão - - `wss://host[:port]path[?query]` para conexões TLS seguras +- `ws://host[:port]path[?query]` para ligações padrão +- `wss://host[:port]path[?query]` para conexões TLS seguras Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um erro (que pode ser intersetado através de um método instalado com `ON ERR CALL`). @@ -95,8 +95,8 @@ Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um Em *connectionHandler*, você pode passar um objeto que contém funções de callback a serem chamadas de acordo com eventos de conexão, bem como o tipo de dados e os cabeçalhos a serem tratados. - - As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. - - O WebSocket será válido enquanto o formulário ou o worker não for fechado. +- As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. +- O WebSocket será válido enquanto o formulário ou o worker não for fechado. | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -236,8 +236,8 @@ A função `.terminate()` fecha Em *code*, você pode passar um código de estado explicando porque a conexão está sendo fechada (consulte também [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. - - Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. +- Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. +- Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. Em *reason*, você pode passar uma frase descrevendo porque a conexão está sendo fechada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md index 50a87f6cc1943a..4fd51bb7b34faa 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Consulte também [esta postagem no blog](https://blog.4d.com/new-built-in-websoc Para criar e manipular seu servidor WebSocket em 4D, é preciso usar duas classes embutidas em 4D: - - essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, - - a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. +- essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, +- a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. Além disso, terá de criar duas classes de utilizador que conterão funções de retorno de chamada: - - uma classe de usuário para tratar as ligações ao servidor, - - uma classe de usuário para tratar as mensagens. +- uma classe de usuário para tratar as ligações ao servidor, +- uma classe de usuário para tratar as mensagens. Você deve [criar o servidor WebSocket](#4dwebsocketservernew) em um [worker](../Develop/processes.md#worker-processes) para manter a conexão ativa. @@ -387,8 +387,8 @@ Por padrão, se nenhum valor de *timeout* for definido, a função inicializa o Se um valor *timeout* for definido: - - quando o tempo de espera é alcançado, a força destrói o meio. - - se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. +- quando o tempo de espera é alcançado, a força destrói o meio. +- se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Admin/webAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/current/Admin/webAdmin.md index 8f64054f66540e..9264cf9add7935 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Admin/webAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Precisa configurar o lançamento ao início Pode configurar o servidor web `WebAdmin` para que se lance ao início da aplicação 4D ou 4D Server (antes de que se carregue qualquer projeto). - - Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. +- Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Selecione a opção **Iniciar WebAdmin ao iniciar** na caixa de diálogo de par ![alt-text](../assets/en/Admin/waSettings.png) - - Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: +- Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Quando esta opção for marcada, pode conectar ao servidor web `WebAdmin` atrav **Notas:** - - Conexões com HTTP outras que localhost nunca são aceitas. - - Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. +- Conexões com HTTP outras que localhost nunca são aceitas. +- Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. #### Porta HTTP @@ -95,11 +95,11 @@ Rota da pasta onde o certificado TLS está localizado. Como padrão, a rota da p O estado ou formato do arquivo de registro da petição HTTP (HTTPDebugLog_*nn*.txt, armazenada na pasta "Logs" da aplicação -- *nn* é o número do arquivo). As opções abaixo estão disponíveis: - - **Desactivado** (por defecto) - - **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas - - **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) - - **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições - - **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas +- **Desactivado** (por defecto) +- **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas +- **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) +- **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições +- **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas #### Chave de acesso @@ -109,10 +109,10 @@ A configuração de uma chave de acesso é obrigatória para desbloquear o acess Uma chave de acesso é parecida a uma senha, mas não está associada com um login. - - Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del +- Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. - - Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. +- Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. +- Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. #### Ativar o acesso a Qodly Studio @@ -147,9 +147,9 @@ Exemplo: ## Autenticação e sessão - - Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. +- Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. - - Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente +- Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente Quando o acesso é concedido, uma [sessão web](WebServer/sessions.md) com o privilégio "WebAdmin" é criado na aplicação 4D. Enquanto a sessão atual tiver o privilégio "WebAdmin", o componente `WebAdmin` entrega páginas solicitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Backup/restore.md b/i18n/pt/docusaurus-plugin-content-docs/current/Backup/restore.md index 038ecc03e9654f..101480c4497149 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Backup/restore.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar um backup 4D lhe permite restaurar conjuntos inteiros de dados de um banco de dados no caso de que se apresente um incidente, independentemente da causa do mesmo. Podem ocorrer dois tipos principais de incidentes: - - A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: +- A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: - Se a cache estiver vazia, o banco de dados abre normalmente. Quaisquer mudanças feitas no banco de dados foram registradas. Este caso não exige nenhuma operação particular - Se a cache conter operações, o arquivo de dados está intacto mas exige integrar o arquivo de histórico atual. - Se a cache estiver no processo de ser escrita, o arquivo de dados está provavelmente danificado. When restoring a backup and integrating the current log file in a encrypted database: - - A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. +- A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. > 4D pode lançar procedimentos automaticamente para recuperar os bancos de dados depois de um incidente. Esses mecanismos são gerenciados usando duas opções disponíveis na página **Backup/Backup & Restore** das Configurações. Para obter mais informações, consulte o parágrafo [Restaurador automático](settings.md#automatic-restore-and-log-integration).\ > Se o incidente for resultado de uma operação inadequada realizada nos dados (eliminação de um registro, por exemplo), você pode tentar reparar o arquivo de dados usando a função "rollback" no arquivo de log. Esta função está disponível na página [Rollback](MSC/rollback.md) do MSC. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Backup/settings.md b/i18n/pt/docusaurus-plugin-content-docs/current/Backup/settings.md index e2a56805ae3b0f..d735cf33ca5f90 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Backup/settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Backup/settings.md @@ -5,9 +5,9 @@ title: Backups periódicos As configurações de backup são definidas através de três páginas na [caixa de diálogo Configurações](../settings/overview.md). Pode estabelecer: - - a periodicidade das cópias de segurança automáticas - - os arquivos a incluir em cada backup - - as funcionalidades avançadas que permitem executar tarefas automáticas +- a periodicidade das cópias de segurança automáticas +- os arquivos a incluir em cada backup +- as funcionalidades avançadas que permitem executar tarefas automáticas > As propriedades definidas nesta caixa de diálogo são escritas no arquivo *Backup.4DSettings*, guardado na pasta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ As configurações de backup do agendador são definidas na página **Backup/Per As opções encontradas nessa aba permitem estabelecer e configurar as cópias de segurança automáticas programadas do banco de dados. Pode escolher uma configuração rápida padrão ou pode personalizá-la completamente. Várias opções aparecem dependendo da escolha feita no menu **Backup automático**: - - **Nunca**: A função de cópia de segurança agendada está inativa. - - **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. - - **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. - - **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. - - **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: +- **Nunca**: A função de cópia de segurança agendada está inativa. +- **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. +- **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. +- **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. +- **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: - **Cada X hora(s)**: Permite programar as cópias de segurança com frequência horária. Pode digitar um valor entre 1 e 24. * **Todos os X dia(s) no x**: permite backups de programação diariamente. Por exemplo, introduza 1 se quiser realizar uma cópia de segurança diária. Quando esta opção estiver marcada, deve digitar a hora quando o backup deve começar. * **A cada X semana(s) no x**: permite backups de programação semanais. Digite 1 se quiser realizar o backup 1 vez por semana. Quando essa opção estiver marcada, deve digitar o dia da semana e a hora em que quer começar o backup. Pode selecionar vários dias da semana se quiser. Por exemplo. pode usar essa opção para estabelecer dois backups por semana: um nas quartas feiras e outro nas sextas. @@ -48,12 +48,12 @@ A página Cópia de segurança| Configuração das propriedades do banco de dado Essa área lhe permite determinar quais os arquivos ou pastas que devem ser copiados durante o backup. - - **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. +- **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. - o arquivo de histórico atual da aplicação (se houver), - a pasta `Settings` completa localizada [ao lado do arquivo de dados](../Project/architecture.md#settings-user-data) (se existir), ou seja, os *parâmetros usuário para os dados*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. - - **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* - - **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". +- **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. +- **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* +- **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". - **Eliminar**: retira o arquivo selecionado da lista de arquivos anexos. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar uma pasta para adicionar à cópia de segurança. No caso de uma restauração, a pasta vai recuperar sua estrutura interna. Pode selecionar toda pasta ou volume conectado à máquina, exceto a pasta que conter os arquivos do banco de dados. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar um arquivo para adicionar à cópia de segurança. @@ -82,19 +82,19 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus ### Parâmetros gerais - - **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). +- **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). Se, por exemplo, o número de conjuntos se definir como 3, as três primeiras cópias de segurança criam os arquivos MyBase-0001, MyBase-0002 e MyBase-0003 respectivamente. Durante o quarto backup, o arquivo MyBase-0004 é criado e MyBase-0001 é apagado. Como padrão, o mecanismo de eliminação de conjuntos está ativado e 4D salva 3 conjuntos de cópias de segurança. Para desativar o mecanismo, simplesmente desmarque a opção. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. +- **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. +- **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. - - **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. +- **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. - **Tente novamente na próxima data e hora agendadas**: essa opção só faz sentido quando trabalhar com backups automáticos programados. Equivale a anular a cópia de segurança que falhou. Um erro é gerado. - **Tentar novamente após X segundo(s), minuto(s) ou hora(s)**: Quando esta opção é marcada, uma nova tentativa de backup é executada após o período de espera. Este mecanismo permite antecipar certas circunstancias que possam bloquear a cópia de segurança. Pode estabelecer um período de espera em segundos, minutos ou horas utilizando o menu correspondente. Se a nova tentativa também falhar, um erro é gerado e a falha é notada na área de status do último backup e no arquivo de histórico de backup. - **Cancele a operação após X tentativas**: Este parâmetro é usado para definir o número máximo de tentativas de backup falhadas. Se o backup não tiver sido realizado com sucesso depois do número máximo de tentativas estabelecido tiver sido alcançado, ele será cancelado e o erro 1401 é gerado ("Número máximo de tentativas de backup foi alcançado; backup automático foi desativado temporariamente"). Nesse caso, não se fará mais backups automáticos até que a aplicação seja reiniciada ou um backup manual se realize com sucesso. @@ -106,17 +106,17 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus Essas opções se aplicam aos arquivos de cópia de segurança principais e aos arquivos de cópia de segurança do histórico. - - **Tamanho do Segmento (Mb)** +- **Tamanho do Segmento (Mb)** 4D permite que você segmente arquivos, ou seja, para cortá-lo em tamanhos menores. Esse funcionamento permite, por exemplo, armazenar uma cópia de segurança em vários discos diferentes (DVD, dispositivos usb pendrive, etc). Durante a restauração, 4D vai fusionar automaticamente os segmentos. Segment Size (Mb) 4D allows you to segment archives, i.e., to cut it up into smaller sizes. This behavior allows, for example, the storing of a backup on several different disks (DVDs, usb devices, etc.). O menu **Tamanho do Segmento** é uma caixa de combinação que permite que você defina o tamanho em MB para cada segmento do backup. Pode escolher um dos tamanhos pré-estabelecidos ou digitar um tamanho específico entre 0 e 2048. Se você passar 0, nenhum segmento ocorre (isso é o equivalente a passar **Nenhum**). - - **Taxa de Compressão** +- **Taxa de Compressão** Por padrão, o 4D comprime os backups para ajudar a economizar espaço em disco. Entretanto, a fase de compressão de arquivo pode retardar o processo de backup quando lidar com grandes volumes de dados. A opção **Taxa de Compressão** permite ajustar a compressão de arquivo: - **Nenhum:** Não se aplica compressão de arquivos. O backup é mais rápido, mas os arquivos são bem maiores. - **Rápido** (padrão): Essa opção é um compromisso entre a velocidade de backup e tamanho de arquivo. - **Compact**: A taxa máxima de compressão é aplicada aos arquivos. Os arquivos ocupam o mínimo espaço possível no disco, mas o backup é mais lento. - - **Taxa de Interlúção e Taxa de Redundância** +- **Taxa de Interlúção e Taxa de Redundância** 4D gera arquivos usando algoritmos específicos que são baseados nos mecanismos de otimização (intercrição) e segurança (redundância). Pode estabelecer esses mecanismos de acordo com suas necessidades. Os menus para essas opções contêm as taxas **Baixo**, **Médio**, **Alto** e **Nenhum** (padrão). - **Taxa de Entrelaçamento**: O Interlacing consiste de armazenar dados em setores não adjacentes para limitar riscos no caso de danos de setor. Quanto maior a taxa, maior a segurança; entretanto, o processamento de dados usa mais memória. - **Taxa de redundância**: Redundância permite a segurança de dados presentes em um arquivo ao repetir a mesma informação várias vezes. Quanto maior a taxa de redundância, melhor a segurança, mas o armazenamento é mais lento e o tamanho dos arquivos aumenta. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/operators.md b/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/operators.md index 76c18a41d5c4ea..5dbb7ed4bddc3f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/operators.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/operators.md @@ -11,8 +11,8 @@ A linguagem 4D suporta os operadores que talvez já conheça de outras linguagen A linguagem 4D suporta operadores **binários** e **ternários**: - - Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. - - os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). +- Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. +- os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). Os valores que os operadores afectam são os operandos. Na expressão `1 + 2`, o símbolo + é um operador binário e seus dois operandos são os valores 1 e 2. @@ -33,18 +33,18 @@ $col:=New collection //$col é inicializado com uma coleção vazia Os resultados do operador dependem dos **tipos de dados** aos quais são aplicados. 4D suporta diferentes operadores em tipos de dados escalares. São descritos com os tipos de dados, nas secções seguintes: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) - - [**Operadores de data**](dt_date.md#operadores-de-data) - - [**Operadores de tempo**](dt_time.md#operadores-de-tempo) - - [**Operadores de números**](dt_number.md#number-operators) - - [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) - - [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) - - [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) - - [**Operadores de string**](dt_string.md#string-operators) - - [**Operadores nas referências de objetos**](dt_object.md#object-operators) - - [**Operadores de referência de coleção**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) +- [**Operadores de data**](dt_date.md#operadores-de-data) +- [**Operadores de tempo**](dt_time.md#operadores-de-tempo) +- [**Operadores de números**](dt_number.md#number-operators) +- [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) +- [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) +- [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) +- [**Operadores de string**](dt_string.md#string-operators) +- [**Operadores nas referências de objetos**](dt_object.md#object-operators) +- [**Operadores de referência de coleção**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) ## Operadores de atribuição compostos @@ -272,9 +272,9 @@ O operador condicional ternário permite-lhe escrever expressões condicionais d Aceita três operandos na seguinte ordem: - - uma condição seguida de um ponto de interrogação (?) - - uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) - - uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) +- uma condição seguida de um ponto de interrogação (?) +- uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) +- uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) ### Sintaxe @@ -325,21 +325,21 @@ Para além de um tipo, cada valor tem também um valor booliano inerente, geralm Os seguintes valores são falsy\*\*: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Empty strings - - [] - Colecções vazias - - {} - Objectos vazios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Empty strings +- [] - Colecções vazias +- {} - Objectos vazios Todos os outros valores são considerados **verdadeiros**, inclusive: - - 0 - zero numérico (inteiro ou não) +- 0 - zero numérico (inteiro ou não) Em 4D, a avaliação **verdadeira** e **falsa** reflete a **utilização** de um valor, o que significa que um valor verdadeiro existe e pode ser processado pelo código sem gerar erros ou resultados inesperados. A lógica por trás disso é fornecer uma maneira conveniente de lidar com valores *undefined* e *null* em objetos e coleções, de modo que um número reduzido de instruções [If…Else](flow-control.md#ifelseend-if) seja necessário para evitar erros de tempo de execução. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/variables.md index af79891afd9132..9ffc9beea3d801 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -53,8 +53,8 @@ Essa sintaxe só é compatível com declarações de [variáveis locais e de pro `varType` pode ser: - - um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, - - uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. +- um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, +- uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. Se `varType` for omitido, será criada uma variável do tipo **variant**. @@ -86,7 +86,7 @@ A sintaxe legada usando comandos `C_XXX` está obsoleta a partir de 4D 20 R7. ### Exemplos - - Para declarar variáveis básicas locais e de processo: +- Para declarar variáveis básicas locais e de processo: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D. Object //also equivalent to C_OBJECT($o) ``` - - Para declarar variáveis objeto da classe 4D: +- Para declarar variáveis objeto da classe 4D: ```4d var $myFolder : 4D. Folder var $myFile : 4D. File ``` - - Para declarar as variáveis objeto da classe usuário: +- Para declarar as variáveis objeto da classe usuário: ```4d var $myClass : cs. MyClass @@ -193,9 +193,9 @@ Uma variável local é, como o seu nome indica, local para um método - apenas a Poderá querer utilizar uma variável local para: - - Evitar conflitos com os nomes de outras variáveis - - Utilizar dados temporariamente - - Reduzir o número de variáveis do processo +- Evitar conflitos com os nomes de outras variáveis +- Utilizar dados temporariamente +- Reduzir o número de variáveis do processo O nome de uma variável local começa sempre com um sinal de dólar ($) e pode conter até 31 caracteres adicionais. Se introduzir um nome mais longo, 4D trunca o nome com o comprimento apropriado. @@ -224,9 +224,9 @@ No modo interpretado, as variáveis são mantidas dinamicamente; são criadas e Um processo pode "espiar e cutucar" as variáveis de processo de outro processo usando os comandos `GET PROCESS VARIABLE` e `SET PROCESS VARIABLE`. É boa prática de programação restringir a utilização destes comandos à situação para a qual foram adicionados à 4D: - - Comunicação interprocessada em locais específicos ou o seu código - - Gestão de arrastar e soltar entre processos - - Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor +- Comunicação interprocessada em locais específicos ou o seu código +- Gestão de arrastar e soltar entre processos +- Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor Para obter mais informações, consulte o capítulo **Processos** e a descrição desses comandos. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Debugging/basics.md b/i18n/pt/docusaurus-plugin-content-docs/current/Debugging/basics.md index b9adc187e15af2..a363bac2f9beb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Debugging/basics.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, pode não haver memória suficiente para criar um BLOB. Ou, quan Estes são geralmente o tipo de erro mais difícil de encontrar. Com exceção dos erros de digitação, todos os tipos de erros acima enumerados são, em certa medida, abrangidos pela expressão "erro de conceção ou de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por exemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Os erros de concepção ou lógicos incluem também situações como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. Por vezes, a parte do código que apresenta o erro pode ser diferente do código que está efetivamente na origem do problema. @@ -55,8 +55,8 @@ Para encontrar rapidamente a origem do problema, reabrir a versão interpretada A janela erro de sintaxe aparece automaticamente quando a execução de um método é interrompida. Isto pode acontecer quando: - - um erro impede a continuação da execução do código - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- um erro impede a continuação da execução do código +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ A área de texto superior apresenta uma mensagem que descreve o erro. A área de A janela de erro de sintaxe propõe várias opções: - - **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. +- **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. +- **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. :::tip @@ -76,14 +76,14 @@ Para ignorar um erro que ocorre repetidamente (por exemplo, em loops), você pod ::: - - **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: +- **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: - Se um método formulário ou um método objeto estiver a ser executado em resposta a um evento, é interrompido e o usuário regressa ao formulário. - Se o método estiver sendo executado a partir do ambiente Application, o usuário regressa a esse ambiente. - - **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. +- **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. - - **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. +- **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. ## Depurador diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md index 4b80f44d529a0b..58ac0e31a2c1ba 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento pode ser usado para filtrar a entrada de dados nos objetos digitáve Quando é usado, este evento é gerado após cada alteração feita no conteúdo de um objeto inserível, independentemente da ação que causou a alteração, *ou seja*: - - Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; - - Eliminar um valor (ação semelhante a colar); - - Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. - - Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). +- Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; +- Eliminar um valor (ação semelhante a colar); +- Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. +- Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). No evento `No After Edit`, os dados de texto sendo inseridos são retornados pelo comando [`Obter texto editado`](../commands-legacy/get-edited-text.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md index ad1fefab5585b6..6bee42c9714cb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ O evento `Ao Começar Arrastar Novo` pode ser selecionado para quaisquer objetos O evento `On Begin Drag Over` é útil para preparar a ação de arrastar. Pode ser usado para: - - Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). - - Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). - - Accept or refuse dragging via the result of the method of the dragged object. +- Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). +- Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). +- Accept or refuse dragging via the result of the method of the dragged object. - To indicate that drag actions are accepted, the method of the source object must return 0 (zero). - To indicate that drag actions are refused, the method of the source object must return -1 (minus one). - Se nenhum resultado for retornado, 4D considera que as ações de arrastar são aceitas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onClicked.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onClicked.md index 1360748863f4b4..7584b63ca7234e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onClicked.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. No entanto, há várias excepções: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md index e6e64421975ec5..2f5c15447aacbe 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Um registro está prestes a ser exibido em um formulário de lista exibido via ` Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada registo: +- Para cada registo: - Para cada objecto na área de detalhes: - Método objecto com o evento `On Display Detail` - Método formulário com o evento `On Display Detail` diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDragOver.md index e91261464d1b11..3e97f1006409be 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over O evento `Ao Arrastar Para` é repetidamente enviado para o objeto de destino quando o ponteiro do mouse é movido sobre o objeto. Em resposta a este evento, normalmente: - - Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). - - Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. +- Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). +- Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. Para **aceitar** a arraste, o método objeto de destino deve retornar 0 (zero). Para **rejeitar** o arraste, o método objeto deve retornar -1 (menos um). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeader.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeader.md index e5dad3403346ed..b45956f76b1c66 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeader.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada objecto na área do cabeçalho: +- Para cada objecto na área do cabeçalho: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md index 8539316186b800..8fb9d7da298645 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Esse evento é gerado quando ocorre um clique no cabeçalho de uma coluna de lis Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) tiver sido selecionada para o list box, você poderá decidir se autoriza ou não uma classificação padrão da coluna passando o valor 0, ou -1 na variável `$0`: - - Se `$0` for igual a 0, é efetuada uma ordenação padrão. - - Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. +- Se `$0` for igual a 0, é efetuada uma ordenação padrão. +- Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) não estiver selecionada para o list box, a variável `$0` não será usada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Extensions/develop-components.md b/i18n/pt/docusaurus-plugin-content-docs/current/Extensions/develop-components.md index ff7621ab2260c9..46eeddd1fdbf4d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Extensions/develop-components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Extensions/develop-components.md @@ -179,14 +179,18 @@ Select **Edit...** item is available when you right-click on the component name ![edit-component](../assets/en/Project/Edit-component.png) -When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the component code is editable in the following pages: +When you select it, a dedicated tab is added (or highlighted if already added) in the Explorer. In this tab, the following standard pages are available and give access to the component contents: ![tab-component](../assets/en/Project/tab-component.png) +- Home, including folders, methods, classes and (preview only) forms - Project Methods - Database Methods ([On Web Connection](../commands-legacy/on-web-connection-database-method.md), [On Web Authentication](../commands-legacy/on-web-authentication-database-method.md), [On Host Database Event](../commands-legacy/on-host-database-event-database-method.md)) - Classes - Project Form Methods +- Commands and Constants +- Plug-ins +- Trash ![tab-component](../assets/en/Project/tab-component.gif) @@ -194,7 +198,8 @@ Standard 4D IDE features are available for the component. You can execute the fo - add, duplicate, delete, edit/save [methods and classes](../Project/code-overview.md) - preview code, show/edit [documentation](../Project/documentation.md), display/edit [method properties](../Project/code-overview.md#project-method-properties), -- run methods. +- run methods, +- restore from trash or empty trash. ## Completar o código dos componentes compilados diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md index f98382730ba66b..67a39c8d81d25d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -9,16 +9,16 @@ Os formulários constituem a interface através da qual a informação é introd Os formulários também podem conter outros formulários através das seguintes funcionalidades: - - [objetos de subformulário](FormObjects/subform_overview.md) - - [formulários herdados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulário](FormObjects/subform_overview.md) +- [formulários herdados](./properties_FormProperties.md#inherited-form-name) ## Criar formulários É possível adicionar ou modificar formulários 4D usando os seguintes elementos: - - **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. - - **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. - - **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: +- **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. +- **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. +- **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: ``` { @@ -70,9 +70,9 @@ Os formulários também podem conter outros formulários através das seguintes Existem duas categorias de formulários: - - **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. +- **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. - - **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. +- **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. Normalmente, você seleciona a categoria do formulário quando o cria, mas pode alterá-la posteriormente. @@ -80,15 +80,15 @@ Normalmente, você seleciona a categoria do formulário quando o cria, mas pode Cada formulário é composto por, pelo menos, duas páginas: - - uma página 1: uma página principal, exibida por defeito - - uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. +- uma página 1: uma página principal, exibida por defeito +- uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. É possível criar várias páginas para um formulário de entrada. Se você tiver mais campos ou variáveis do que cabem em uma tela, você pode querer criar páginas adicionais para exibi-los. As páginas múltiplas permitem-lhe fazer o seguinte: - - Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. - - Organize cada tópico na sua própria página. - - Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). - - Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. +- Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. +- Organize cada tópico na sua própria página. +- Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). +- Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. As páginas múltiplas são uma conveniência utilizada apenas para formulários de introdução. Não são para produção impressa. Quando um formulário de várias páginas é impresso, apenas a primeira página é impressa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/macros.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/macros.md index 1976dfab5cc6e9..50c036cfa4e172 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/macros.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/macros.md @@ -7,11 +7,11 @@ O editor de formulários 4D suporta macros. Uma macro é um conjunto de instruç Por exemplo, se você tiver um relatório recorrente com formatação específica (por exemplo, determinado texto deve aparecer em vermelho e determinado texto deve aparecer em verde), poderá criar uma macro para definir automaticamente a cor. É possível criar macros para o editor de 4D Form que podem: - - Criar e executar código 4D - - Exibir diálogos - - Seleccionar objectos do formulário - - Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades - - Modificar ficheiros de projeto (atualizar, apagar) +- Criar e executar código 4D +- Exibir diálogos +- Seleccionar objectos do formulário +- Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades +- Modificar ficheiros de projeto (atualizar, apagar) O código de macros suporta [funções de classe](Concepts/classes.md) e [propriedades de objeto de formulário em JSON](FormObjects/properties_Reference.md) para permitir que você defina qualquer recurso personalizado no editor de formulários. @@ -237,9 +237,9 @@ Por exemplo, se objectos da página actual e grupos tiverem sido modificados, po Ao lidar com o atributo 'método' de objetos de formulário, você pode definir o valor do atributo de duas maneiras nas macros: - - Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). +- Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). - - Utilizar um objeto com a seguinte estrutura: +- Utilizar um objeto com a seguinte estrutura: | Propriedade | Tipo | Descrição | | ----------- | ---- | ---------------- | @@ -251,9 +251,9 @@ O 4D criará um arquivo usando o nome do objeto na pasta "objectMethods" com o c A propriedade `$4dId` define um ID exclusivo para cada objeto na página atual. Essa chave é usada pelo processador de macro para controlar as alterações em `$result.currentPage`: - - Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. - - Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. - - Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. +- Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. +- Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. +- Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. #### Exemplo @@ -296,8 +296,8 @@ A função `onError` é executada quando o processador de macros encontra um err Ao executar uma macro, se a 4D encontrar um erro que impeça a macro de ser cancelada, ela não executa o macro. É o caso, por exemplo, se a execução de uma macro resultar em: - - eliminar ou modificar um script cujo ficheiro é só de leitura. - - criar dois objectos com o mesmo ID interno. +- eliminar ou modificar um script cujo ficheiro é só de leitura. +- criar dois objectos com o mesmo ID interno. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md index f342d25344016c..a1d843a0e5ce70 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Pode utilizar bibliotecas de objectos nos seus formulários. Uma biblioteca de o 4D propõe dois tipos de bibliotecas de objetos: - - uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. - - as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. +- uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. +- as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. ## Criar e utilizar bibliotecas de objetos personalizadas @@ -21,10 +21,10 @@ A biblioteca é apresentada numa janela separada: A janela tem as seguintes características principais: - - Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. - - Você pode filtrar o conteúdo da janela usando o menu **Categorias**: +- Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. +- Você pode filtrar o conteúdo da janela usando o menu **Categorias**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar um objeto da biblioteca no seu formulário, pode: +- Para utilizar um objeto da biblioteca no seu formulário, pode: - clicar com o botão direito do rato num objeto e selecionar **Copiar** no menu contextual - ou arraste e solte o objeto da biblioteca. O objeto é então adicionado ao formulário. @@ -57,13 +57,13 @@ Uma determinada biblioteca de objetos só pode ser aberta por um m banco de dado Para abrir uma biblioteca de objetos personalizada, selecione o comando **Open>Object Library...** no menu 4D **File** ou na barra de ferramentas. Aparece uma caixa de diálogo padrão de ficheiro aberto, que lhe permite seleccionar a biblioteca de objectos a abrir. Pode seleccionar os seguintes tipos de ficheiros: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Na realidade, as bibliotecas de objectos personalizados são projectos 4D clássicos. Apenas as seguintes partes de um projecto são expostas quando este é aberto como biblioteca: - - formulários projecto - - páginas formulário 1 +- formulários projecto +- páginas formulário 1 ### Construir uma biblioteca de objectos @@ -75,10 +75,10 @@ As operações básicas estão disponíveis no menu de contexto ou no menu de op ![](../assets/en/FormEditor/library5.png) - - **Cortar** ou **Copiar** para a área de transferência - - **Colar** um objeto da área de transferência - - **Clear** - exclui o objeto da biblioteca - - **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. +- **Cortar** ou **Copiar** para a área de transferência +- **Colar** um objeto da área de transferência +- **Clear** - exclui o objeto da biblioteca +- **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. Pode colocar objectos individuais (incluindo subformulários) ou conjuntos de objectos numa biblioteca de objectos. Cada objecto ou conjunto é agrupado num único item: @@ -94,9 +94,9 @@ A utilização de copiar-colar ou arrastar-e-soltar com determinados objetos de Segue-se uma lista de objetos dependentes que serão colados na biblioteca enquanto o objeto principal que os utiliza (quando aplicável): - - Listas - - Formatos/Filtros - - Imagens - - Dicas de ajuda (ligadas a um campo) - - Métodos objecto +- Listas +- Formatos/Filtros +- Imagens +- Dicas de ajuda (ligadas a um campo) +- Métodos objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md index a969e5a70ca62e..b3dda5c2e818e6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ As opções de tamanho dependem do valor da opção **Tamanho baseado em**. ## Tamanho baseado em - - **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). +- **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). Você pode escolher essa opção quando quiser usar objetos ativos colocados em uma área fora da tela (ou seja, fora do retângulo delimitador da janela) com uma janela de tamanho automático. Graças a essa opção, a presença desses objetos não modificará o tamanho da janela. - - **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). +- **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). - - ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. +- ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. > Para formulários de saída, somente os campos [**Margem Hor**](#hor-margin) ou [**Largura**](#width) estão disponíveis. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md index a5176f940c12c9..a0fb905fcb3032 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ O usuário constrói e personaliza os seus formulários de aplicação manipulan Os formulários 4D suportam um grande número de objetos **ativos** e **estáticos** incorporados: - - Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. - - Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. +- Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. +- Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. ## Manipulação de objectos de formulário Pode adicionar ou modificar objetos de formulários 4D das seguintes formas: - - **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. +- **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. - - **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. +- **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. - - **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). +- **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). Exemplo de um objeto botão: ```json diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md index d96e75a9aee559..5562a804e07ab3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md @@ -50,6 +50,6 @@ For security reasons, in [multi-style](./properties_Text.md#multi-style) input a Também pode representar expressões de campo e variáveis nos seus formulários utilizando objectos alternativos, mais particularmente: - - Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). - - Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). - - Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). +- Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). +- Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). +- Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index 903e223d25ed2f..f00c816642e524 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Quando apropriado, o ícone de expansão/colapso é automaticamente apresentado O conteúdo de um objeto formulário lista hierárquica pode ser inicializado de uma das seguintes formas: - - Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. - - Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. +- Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. +- Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. Em ambos os casos, você gerencia uma lista hierárquica em tempo de execução através de sua referência *ListRef*, usando os comandos de [lista hierárquica](../commands/theme/Hierarchical_Lists.md) na linguagem 4D. @@ -34,9 +34,9 @@ $mylist:=New list Cada representação da lista tem suas próprias características específicas e compartilha características comuns com todas as outras representações. As características a seguir são específicas de cada representação da lista: - - A selecção, - - O estado expandido/recolhido dos seus itens, - - A posição do cursor de rolagem. +- A selecção, +- O estado expandido/recolhido dos seus itens, +- A posição do cursor de rolagem. As outras características (fonte, tamanho da fonte, estilo, controle de entrada, cor, conteúdo da lista, ícones, etc.) são comuns a todas as representações e não podem ser modificados separadamente. Consequentemente, quando você usa comandos com base na configuração expandida/colapsada ou no item atual, por exemplo, `Count list items` (quando o parâmetro final `*` não é passado), é importante poder especificar a representação a ser usada sem nenhuma ambiguidade. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Assim como em outros comandos de gerenciamento de propriedades de objetos, é possível usar o caractere "@" no parâmetro `ListName`. Regra geral, esta sintaxe é utilizada para designar um conjunto de objetos no formulário. No entanto, no contexto dos comandos de lista hierárquica, isso não se aplica em todos os casos. Essa sintaxe tem dois efeitos diferentes, dependendo do comando: - - Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." +- Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: +- Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po É possível modificar a aparência de uma lista hierárquica de objetos usando vários comandos 4D genéricos. Você pode passar para esses comandos o nome do objeto da lista hierárquica (usando o parâmetro \*) ou o nome da variável (contendo o valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Lembrete: exceto `OBJECT SET SCROLL POSIÇÃO`, esses comandos modificam todas as representações da mesma lista, mesmo que você especifique apenas uma lista usando seu nome de objeto. @@ -107,8 +107,8 @@ Esse princípio é aplicado independentemente da ordem em que os comandos são c Normalmente, você pode trabalhar de duas maneiras com o conteúdo das listas hierárquicas: por posição ou por referência. - - Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. - - Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. +- Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. +- Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. ### Utilização de números de referência dos items (itemRef) @@ -141,9 +141,9 @@ Basicamente, você precisa lidar com números de referência de itens quando qui Pode controlar se os itens da lista hierárquica podem ser modificados pelo usuário, utilizando o atalho **Alt+click**(Windows) / **Option+click** (macOS), ou fazendo um clique longo no texto do item. - - Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). +- Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). - - Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md index 169faeb10bc531..07bf9d928721bb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Subform.md @@ -25,13 +25,13 @@ Especifica se o utilizador pode eliminar sub-registos num subformulário lista. Esta propriedade é utilizada para declarar o formulário detalhado a utilizar no subformulário. Pode ser: - - um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ You can select a component form name when it is published in the component. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. #### Gramática JSON @@ -53,8 +53,8 @@ Esta propriedade é utilizada para declarar o formulário detalhado a utilizar n Ação a ser executada no caso de um clique duplo em uma linha vazia de um subformulário lista. As opções abaixo estão disponíveis: - - Não fazer nada: Ignora o duplo clique. - - Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- Não fazer nada: Ignora o duplo clique. +- Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -78,9 +78,9 @@ Ação a ser executada no caso de um clique duplo em uma linha vazia de um subfo Define a ação a ser executada quando um usuário clica duas vezes em uma linha no subformulário lista. As opções disponíveis são: - - **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. - - **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. +- **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. +- **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. Independentemente da ação selecionada/escolhida, o evento de formulário `On Double clicked` é gerado. @@ -162,10 +162,10 @@ Especifica a tabela a que pertence o subformulário Lista (se existir). Designa a opção que permite aos utilizadores selecionar linhas: - - **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. - - **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ +- **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. +- **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ As teclas de seta para cima e para baixo selecionam a linha anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. O evento de formulário `On Selection Change` é gerado sempre que a linha atual é alterada. - - **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. +- **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Clicar no registro o selecionará, mas não modificará o registro atual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). As teclas de seta para cima e para baixo selecionam o registo anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md index 5e6535494a6135..befe7cdd72f1fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ As formas são [objetos estáticos](formObjects_overview.md#active-and-static-ob As formas 4D suportam as seguintes formas básicas: - - retângulos - - linhas - - ovals +- retângulos +- linhas +- ovals ## Retângulo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/splitters.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/splitters.md index 00c8677749a98a..c624643b6ed698 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/splitters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/splitters.md @@ -11,10 +11,10 @@ O divisor é usado, por exemplo, em formulários de saída para que as colunas p Algumas das características gerais do repartidor: - - Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. - - Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. - - As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. +- Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. +- Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. +- As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. Uma vez inserido, o separador aparece como uma linha. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variável pode ser utilizada nos seus métodos objeto e/ou formulário. Seu valor indica a posição atual do divisor, em píxeis, em relação à sua posição inicial. - - Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, - - Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, - - Se o valor for 0: o divisor foi movido para a sua posição original. +- Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, +- Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, +- Se o valor for 0: o divisor foi movido para a sua posição original. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. A movimentação é de fato realizada no final da execução do formulário ou método objeto que contém a declaração. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/stepper.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/stepper.md index 6f384dcc2668c5..05d1da390e99f9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/stepper.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/stepper.md @@ -13,11 +13,11 @@ Você pode atribuir a variável associada ao objeto a uma área de entrada (camp Um stepper pode ser associado diretamente a uma variável número, hora ou data. - - Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: +- Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. +- Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. > For the stepper to work with a time or date variable, it is imperative to set its type in the form AND to [declare it explicitly](../Concepts/variables.md#declaring-variables) as `Time` or `Date`. @@ -29,8 +29,8 @@ Para mais informações, consulte [Usando indicadores](progressIndicator.md#usin ## Veja também - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md index b472d374fe88ba..e1f1d4853cf367 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Um subformulário é um formulário incluído noutro formulário. Para definir claramente os conceitos implementados com subformulários, aqui estão algumas definições para certos termos utilizados: - - **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. - - **Formulário pai**: um formulário que contém um ou mais subformulários. - - **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. - - **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. - - **Formulário lista**: instância do subformulário exibido como uma lista. - - **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. +- **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. +- **Formulário pai**: um formulário que contém um ou mais subformulários. +- **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. +- **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. +- **Formulário lista**: instância do subformulário exibido como uma lista. +- **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. ## Sub formulários lista @@ -43,8 +43,8 @@ Você pode vincular [uma variável ou uma expressão](properties_Object.md#varia Por padrão, 4D cria uma variável ou expressão de [tipo de objeto](properties_Object.md#expression-type) para um contêiner de subformulário, que lhe permite compartilhar valores no contexto do subformulário usando o comando `Form`. No entanto, você pode usar uma variável ou expressão de qualquer tipo escalar (tempo, inteiro, etc.) especialmente se você só precisa compartilhar um único valor: - - Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. +- Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. ### Sincronização do formulário principal e do subformulário (valor único) @@ -58,8 +58,8 @@ No formulário pai, ambos os objetos (área de entrada e contêiner de subformul To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. O valor do texto deve ter o formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído - - se o subformulário pertence à página formulário atual ou à página 0. +- assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído +- se o subformulário pertence à página formulário atual ou à página 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). Modificar a variável ou expressão vinculada aciona eventos de formulário que permitem sincronizar os valores do formulário pai e do subformulário: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Atualização do conteúdo de um formulário pai @@ -169,8 +169,8 @@ A comunicação entre o formulário pai e as instâncias do subformulário pode 4D implementou os seguintes mecanismos para atender a essas necessidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md index f63a09ee25c6a1..ddfbf5182f546a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/tabControl.md @@ -42,9 +42,9 @@ No macOS, além da posição padrão (superior), os controles de aba também pod Para fornecer as etiquetas para o controle de abas, você pode usar: - - um objeto - - uma lista de escolha - - um array +- um objeto +- uma lista de escolha +- um array ### Utilização de um objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/text.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/text.md index 1874c230c87282..b46a43a9cb707f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/text.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/text.md @@ -33,9 +33,9 @@ Quando um texto é rodado, pode continuar a alterar o seu tamanho ou posição, ![](../assets/en/FormObjects/staticText2.png) - - Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; - - Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; - - Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. +- Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; +- Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; +- Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/MSC/analysis.md b/i18n/pt/docusaurus-plugin-content-docs/current/MSC/analysis.md index 0db70ea8c41d72..b580086cf8714d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/MSC/analysis.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operação registada no ficheiro de registo aparece como uma linha. As colu Essas informações permitem que você identifique a origem e o contexto de cada operação: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: +- **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: - Abertura de ficheiro de dados: abertura de um ficheiro de dados. - Encerramento do ficheiro de dados: encerramento de um ficheiro de dados aberto. - Criação de um contexto: criação de um processo que especifica um contexto de execução. @@ -30,21 +30,21 @@ Essas informações permitem que você identifique a origem e o contexto de cada - Cancelamento da transação: transação cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ @@ -56,7 +56,7 @@ Essas informações permitem que você identifique a origem e o contexto de cada Only values represented in alphanumeric form are displayed.\ ***Note:** If the database is encrypted and no valid data key corresponding to the open log file has been provided, encrypted values are not displayed in this column.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). O botão Navegar pode ser usado para selecionar e abrir outro arquivo de histórico para o banco de dados. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/MSC/repair.md b/i18n/pt/docusaurus-plugin-content-docs/current/MSC/repair.md index 9e41edffd4dc64..09310d45b91db1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/MSC/repair.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del A área "Registros encontrados no arquivo de dados" inclui duas tabelas que resumem as informações da varredura do arquivo de dados. - - A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: +- A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Os nomes das tabelas atribuídas aparecem automaticamente a verde. Os grupos que não foram atribuídos, ou seja, as tabelas que não puderam ser associadas a nenhum registro, aparecem em vermelho. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por padrão, essa opção é marcada para todos os grupos com registros que podem ser associados a uma tabela. - - A segunda tabela lista as tabelas do ficheiro de projeto. +- A segunda tabela lista as tabelas do ficheiro de projeto. ### Atribuição manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Depois que a reparação terminar, 4D gera um arquivo de histórico na pasta Logs do banco de dados. Este arquivo permite visualizar todas as operações efectuadas. É criado no formato XML e chamado: *DatabaseName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" onde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Menus/properties.md b/i18n/pt/docusaurus-plugin-content-docs/current/Menus/properties.md index 8f021dcc8bfb44..f40f48cfb91711 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Menus/properties.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal No editor do Menu, pode introduzir directamente a etiqueta como "hard coded". Ou, pode introduzir uma referência para uma variável ou um elemento XLIFF, o que facilitará a manutenção e tradução das aplicações. Pode utilizar os seguintes tipos de referências: - - Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. A alteração do conteúdo desta variável modificará a etiqueta do menu quando esta for exibida. Neste caso, a etiqueta chamará um recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ A escolha entre associar uma ação padrão ou um método de projecto a um coman É possível atribuir um método de projecto e/ou uma acção padrão a um comando de menu seleccionado no editor de Menu: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Pode adicionar atalhos de teclado a qualquer comando de menu. Se um comando de m También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Isto multiplica o número de atalhos que podem ser utilizados. Os seguintes tipos de atalhos de teclado podem, portanto, ser definidos: - - Em Windows: +- Em Windows: - Ctrl+caractere - Ctrl+Shift+caracter - Ctrl+Alt+caractere - Ctrl+Shift+Alt+caractere - - Em macOS: +- Em macOS: - Comando+caractere - Comando+Shift+caracter - Comando+Opção+característica 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 26f679d274b65f..4116f9344beb93 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -9,17 +9,17 @@ Leia [**O que há de novo no 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/ #### Destaques - - The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. - - Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. - - Línguagem 4D: +- The code of a loaded, interpreted component can now be [edited from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer. +- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. +- Línguagem 4D: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). #### Mudanças de comportamento - - Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. - - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). +- Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. +- Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. +- Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). ## 4D 20 R10 @@ -27,27 +27,27 @@ Leia [**O que há de novo no 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Handling of [ORDA events on data](../ORDA/orda-events.md). - - Nova opção `connectionTimeout` no parâmetro [`options`](../API/TCPConnectionClass.md#options-parameter) da função [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Línguagem 4D: +- Handling of [ORDA events on data](../ORDA/orda-events.md). +- Nova opção `connectionTimeout` no parâmetro [`options`](../API/TCPConnectionClass.md#options-parameter) da função [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Línguagem 4D: - For consistency, [`Create entity selection`](../commands/create-entity-selection.md) and [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) commands have been moved from the ["4D Environment"](../commands/theme/4D_Environment.md) to the ["Selection"](../commands/theme/Selection.md) themes. - New [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) and [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) commands to assign and read `Formula` objects as data sources for form objects. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) e [`LISTBOX Get property`](../commands/listbox-get-property.md) suporta três novas constantes: `lk current item`, `lk current item position` e `lk selected items expression`. - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### Mudanças de comportamento - - On Windows, current printer fonts intended only for printing (i.e. not usable on screen) are no longer loaded by 4D at startup. - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- On Windows, current printer fonts intended only for printing (i.e. not usable on screen) are no longer loaded by 4D at startup. +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -55,20 +55,20 @@ Leia [**O que há de novo no 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - The [*MeCab* library](../settings/database.md#support-of-mecab-japanese-version) is now deprecated and will be removed in the next release. - - Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). - - O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). - - Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. - - Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. - - Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. - - Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. - - Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. - - 4D Write Pro Interface: New [integrated AI](../WritePro/writeprointerface.md#integrated-ai) to interact with **chatGTP** from your 4D Write Pro documents. - - [**Lista de bugs corrigidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs que foram corrigidos no 4D 20 R9. +- The [*MeCab* library](../settings/database.md#support-of-mecab-japanese-version) is now deprecated and will be removed in the next release. +- Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). +- O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). +- Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. +- Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. +- Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. +- Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. +- Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. +- 4D Write Pro Interface: New [integrated AI](../WritePro/writeprointerface.md#integrated-ai) to interact with **chatGTP** from your 4D Write Pro documents. +- [**Lista de bugs corrigidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs que foram corrigidos no 4D 20 R9. ## 4D 20 R8 @@ -76,29 +76,29 @@ Leia [**O que há de novo no 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). - - Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). - - Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. - - [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. - - Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#evaluation-application) na caixa de diálogo Criar aplicativo. - - Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. - - Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para registro detalhado de eventos TCP. - - Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. - - 4D Write Pro: +- Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). +- Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). +- Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. +- [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. +- Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#evaluation-application) na caixa de diálogo Criar aplicativo. +- Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. +- Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para registro detalhado de eventos TCP. +- Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. +- 4D Write Pro: - Os seguintes comandos agora permitem parâmetros, como objetos ou coleções: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Obter atributos](../WritePro/commands/wp-get-attributes.md), [WP REDEFINIR ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [Tabela WP anexa linha](../WritePro/commands/wp-table-append-row.md), [documento de importação do WP](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), e [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md) e [WP Insert break](../WritePro/commands/wp-insert-break.md), agora são funções que retornam intervalos. - Novas expressões relacionadas a atributos de documentos: [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) e [This.pageIndex](../WritePro/managing-formulas.md). - - Línguagem 4D: +- Línguagem 4D: - 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. #### Mudanças de comportamento - - After a log file modification using [`SELECT LOG FILE`](../commands/select-log-file.md) or the [Backup settings](../Backup/settings.md#log-management), the [`New log file`](../commands/new-log-file.md) command now validates the change, without waiting for a backup. The error -4447 (backup required) is no longer raised. - - Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. +- After a log file modification using [`SELECT LOG FILE`](../commands/select-log-file.md) or the [Backup settings](../Backup/settings.md#log-management), the [`New log file`](../commands/new-log-file.md) command now validates the change, without waiting for a backup. The error -4447 (backup required) is no longer raised. +- Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. ## 4D 20 R7 @@ -106,30 +106,30 @@ 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). - - 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#monitoring-project-dependencies). - - Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. - - Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - 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). - - Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. - - Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). - - Línguagem 4D: +- As colunas e cabeçalhos da list box de tipo tempo agora suportam a opção ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- 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#monitoring-project-dependencies). +- Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. +- Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- 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). +- Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. +- Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). +- Línguagem 4D: - Novos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*o\*". - - 4D Write Pro: +- 4D Write Pro: - Novo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) e [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. #### Mudanças de comportamento - - As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. - - 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. - - A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session *describe* privileges are now ignored. +- As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. +- 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. +- A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -137,25 +137,25 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) now supports [object and collection references as query values](../API/CollectionClass.md#object-or-collection-reference-as-value). - - When a component has a [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), its classes are now automatically shared between all loaded components in the host project via [`cs.`](../Concepts/classes.md#cs). - - Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). - - Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. - - Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. - - Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. - - Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. - - Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. - - Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). - - 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, as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. +- Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) now supports [object and collection references as query values](../API/CollectionClass.md#object-or-collection-reference-as-value). +- When a component has a [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), its classes are now automatically shared between all loaded components in the host project via [`cs.`](../Concepts/classes.md#cs). +- Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). +- Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. +- Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. +- Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. +- Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. +- Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. +- Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). +- 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, as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) 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. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. #### Mudanças de comportamento - - Suporte para perseguir a rolagem nos formulários: subformas pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingiram os limites e o usuário continua rolando usando o mouse ou rastreador (overscrolling). - - A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). +- Suporte para perseguir a rolagem nos formulários: subformas pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingiram os limites e o usuário continua rolando usando o mouse ou rastreador (overscrolling). +- A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). ## 4D 20 R5 @@ -163,21 +163,21 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. - - Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - QUIC network layer now supports [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), and [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). - - Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - 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). - - Novo parâmetro REST [$format](../REST/$format.md). - - O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. +- Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. +- Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- QUIC network layer now supports [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), and [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). +- Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- 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). +- Novo parâmetro REST [$format](../REST/$format.md). +- O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. #### 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...) agora são salvas em um arquivo separado chamado `catalog_editor.json` armazenado na pasta [`Sources`](../Project/architecture.md#sources) do projeto. +- 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...) 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 @@ -185,24 +185,24 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. - - As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). - - Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. - - Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). - - Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) - - Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. - - Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. +- Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. +- As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). +- Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. +- Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). +- Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) +- Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. +- Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- 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. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. #### Mudanças de comportamento - - 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/)). - - Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. - - 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. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). +- 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/)). +- Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. +- 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. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -210,21 +210,21 @@ Leia [**O que há de novo no 4D v20 R3**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). - - Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Support for [initializing the variable's value and data type in the declaration line](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) - - Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. +- Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). +- Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Support for [initializing the variable's value and data type in the declaration line](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) +- Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. #### Mudanças de comportamento - - Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. A fix has been done, so that the following errors will now be caught also in compiled mode: *Indice out of range*, *Type incompatible*, and *Dereferencing a Null pointer*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). - - 4D não inclui mais um interpretador PHP interno. You need to [set up and run your own PHP interpreter](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) to use PHP commands. +- Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. A fix has been done, so that the following errors will now be caught also in compiled mode: *Indice out of range*, *Type incompatible*, and *Dereferencing a Null pointer*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). +- 4D não inclui mais um interpretador PHP interno. You need to [set up and run your own PHP interpreter](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) to use PHP commands. ## 4D 20 R2 @@ -238,15 +238,15 @@ Se suas aplicações 4D utilizam conexões TLS, é recomendado que você faça a #### Destaques - - Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. - - 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. - - 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. +- Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. +- 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. +- 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 - - **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. +- **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. ## 4D 20.x LTS 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 e27c3f1f6ae59f..819c0908dd1497 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 @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci In addition, to ensure proper operation of the feature, the following conditions are required: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descrição | | ------------------------------------------------------- | --------------- | ------------------------------------- | @@ -64,8 +64,8 @@ Para ativar o rastreamento de alterações de dados: Em seguida, 4D faz as seguintes alterações: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desativar o rastreamento de alterações de dados: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index 301229e0669247..019679ca0f66a5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class 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 e389c2e02f27d6..ca01609ba19ce8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ The web session created on the remote datastore is identified using a internal s El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estes princípios são ilustrados nos gráficos seguintes: @@ -29,9 +29,9 @@ Estes princípios são ilustrados nos gráficos seguintes: Os processos que gerenciam sessões para acesso ao armazenamento de dados são mostrados na janela de administração do 4D Server: - - nombre: "REST Handler: \" - - type: type Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- type: type Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. No exemplo a seguir, dois processos estão sendo executados na mesma sessão: @@ -47,11 +47,11 @@ Se uma solicitação for enviada ao repositório de dados remoto depois que a se Os recursos do ORDA relacionados ao bloqueio de entidades e à transação são gerenciados no nível do processo em repositórios de dados remotos, assim como no modo cliente/servidor do ORDA: - - 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. - - 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`). +- 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. +- 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: +- Os bloqueios nas entidades são removidos e as transações são anuladas: - quando o processo é eliminado. - quando a sessão é encerrada no servidor - quando a sessão é encerrada na janela de administração do servidor. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/general.md b/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/general.md index bb7415cd78e27b..df8b713e81450d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/general.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contém várias opções para configurar o funcionamento geral da s Esta opção permite configurar o ecrã 4D por padrão no arranque, quando o usuário inicia apenas a aplicação. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forçar a apresentação da caixa de diálogo de abertura quando esta opção é selecionada, mantenha premida a tecla **Alt** (Windows) ou **Opção** (macOS) enquanto inicia o projeto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir do macOS Sierra, os aplicativos Mac podem se beneficiar do recurso Auto Você pode se beneficiar desse recurso nos seguintes ambientes (somente com versões 4D de 64 bits): - - Method Editor windows - - Janelas do editor de formulários +- Method Editor windows +- Janelas do editor de formulários Todas as janelas destes editores podem ser colocadas no formulário de tabulação: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Estão disponíveis três opções: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Aparência (somente macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Estão disponíveis três opções: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferência só é suportada no macOS. No Windows, é sempre utilizado o esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de dados...** - - **Base de dados a partir da definição da estrutura...** +- **Base de dados...** +- **Base de dados a partir da definição da estrutura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Ao criar um novo arquivo de dados, o 4D usa o idioma previamente definido nesse Esta área configura o acesso à documentação HTML 4D exibida no seu navegador atual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Língua da documentação @@ -151,8 +151,8 @@ Linguaje da documentação HTML a apresentar. É possível selecionar uma docume Define onde 4D irá procurar por páginas de documentação. - - Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. - - Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. +- Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. +- Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. ### Pasta local diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/methods.md b/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/methods.md index 43a2cc3d6b2cf8..604ff1d4e250d5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/methods.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite selecionar, criar ou configurar temas do Editor de código. Nesta lista, seleciona o tema a aplicar ao editor de código. São apresentados todos os temas disponíveis, incluindo os temas personalizados (se existirem). 4D fornece dois temas por padrão: - - **Tema Light predefinido** - - **Tema escuro predefinido** +- **Tema Light predefinido** +- **Tema escuro predefinido** > Os temas padrão não podem ser modificados ou eliminados. @@ -38,8 +38,8 @@ Cada tema personalizado se almacena en un único archivo JSON llamado *themeName Definir um tema significa: - - definir um tipo de letra e um tamanho de letra globais para todo o editor de código, - - atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. +- definir um tipo de letra e um tamanho de letra globais para todo o editor de código, +- atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. A combinação de cores e estilos diferentes é particularmente útil para manutenção do código. @@ -83,8 +83,8 @@ Esta página configura as opções de exibição do Editor de código. Permite-lhe desativar/ativar os parâmetros do código "internacional" para a aplicação 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Se modificar esta opção, tem de reiniciar a aplicação 4D para que a alteração seja tida em conta. @@ -138,9 +138,9 @@ Permite-lhe ocultar todos os ícones de expansão/recolhimento por padrão ao ap Permite a inserção automática de () e de chaves de fecho durante a escrita de código. Esta opção controla duas funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Permite a inserção automática de () e de chaves de fecho durante a escrita de Define a sinalização gráfica das chaves correspondentes no código. Esta sinalização aparece sempre que é selecionado um parêntese quadrado, parêntese ou parêntese curvo. As opções abaixo estão disponíveis: - - **Ninguno**: sin señales - - **Retângulo** (padrão): braces cercadas por uma linha preta\ +- **Ninguno**: sin señales +- **Retângulo** (padrão): braces cercadas por uma linha preta\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Destaque de variáveis e campos @@ -162,9 +162,9 @@ Permite destacar todas as ocorrências da mesma variável ou campo numa janela d ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). 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 9cebe6d8a23301..cf3a0cd2bfe120 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitetura de um projeto 4D Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta raiz do projeto (pasta de pacotes). Por exemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta A pasta Project contém normalmente a seguinte hierarquia: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Página Métodos` - `Formulários` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` Arquivo de desenvolvimento do projeto, utilizado para designar e lançar o projeto. Esse arquivo pode ser aberto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > Nota: nos projetos 4D, o desenvolvimento se realiza com 4D Developer e o desenvolvimento multiusuários se gerencia através das ferramentas de controle de versão. 4D Server pode abrir arquivos .4DProject para fins de teste. @@ -120,9 +120,9 @@ Esse arquivo de texto também pode conter chaves de configuração, em particula A pasta Trash contém métodos e formulários eliminados do projeto (se existirem). Pode conter as seguintes pastas: - - `Página Métodos` - - `Formulários` - - `TableForms` +- `Página Métodos` +- `Formulários` +- `TableForms` Dentro destas pastas, os nomes dos elementos eliminados estão entre parênteses, por exemplo, "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Essa pasta contém [**configurações de usuário para os dados**](../Desktop/us A pasta Logs contém todos os arquivos de registo utilizados pelo projeto. Os arquivos de registro incluem, em particular: - - conversão da base de dados, - - pedidos do servidor Web, - - backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) - - depuração de comandos, - - 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). +- conversão da base de dados, +- pedidos do servidor Web, +- backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) +- depuração de comandos, +- 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). > Uma pasta adicional de Logs está disponível na pasta de preferências sistema do usuário (pasta 4D ativa, consulte o comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para arquivos de log de manutenção e nos casos em que a pasta de dados é somente leitura. 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 081622b164af64..a5418d99f57e4f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/components.md @@ -13,15 +13,15 @@ Ao desenvolver em 4D, os arquivos de componentes podem ser armazenados de forma Componentes podem ser interpretados ou [compilados](../Desktop/building.md). - - Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. - - Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. +- Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. +- Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. ### Pasta do pacote The package folder of a component (*MyComponent.4dbase* folder) can contain: - - para **componentes interpretados**: uma [pasta Project](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: uma [pasta Project](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). +- para **componentes compilados**: - uma pasta "Contents" contendo um arquivo .4DZ, uma pasta *Resources*, um arquivo *Info.plist* (arquitetura recomendada) - ou diretamente um arquivo .4DZ com outras pastas como *Recursos*. @@ -37,8 +37,8 @@ A arquitetura da pasta "Contents" é recomendada para componentes, se você dese Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Server**. Em outros ambientes, os componentes são geridos de forma diferente: - - em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto. - - em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). +- em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto. +- em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Para carregar um componente no seu projeto 4D, você pode: - - copie os arquivos de componentes na pasta [**Components** do seu projeto](architecture.md#components) (as pastas de pacotes de componentes interpretados devem ser sufixadas com ".4dbase", veja acima), - - ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). +- copie os arquivos de componentes na pasta [**Components** do seu projeto](architecture.md#components) (as pastas de pacotes de componentes interpretados devem ser sufixadas com ".4dbase", veja acima), +- ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). Os componentes declarados no arquivo **dependencies.json** podem ser armazenados em locais diferentes: - - no mesmo nível da pasta do pacote do seu projeto 4D: esse é o local padrão, - - 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. +- no mesmo nível da pasta do pacote do seu projeto 4D: esse é o local padrão, +- 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. Se o mesmo componente for instalado em locais diferentes, uma [ordem de prioridade](#prioridade) é aplicada. @@ -69,8 +69,8 @@ O arquivo **dependencies.json** faz referência a todos os componentes necessár Pode conter: - - nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), - - nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). +- nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), +- nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ O arquivo **environment4d.json** é opcional. Ele permite que você defina **cam Os principais benefícios desta arquitetura são os seguintes: - - você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. - - se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. +- você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. +- se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. ### Prioridade @@ -187,9 +187,9 @@ Em relação aos componentes armazenados no GitHub, ambos os arquivos [**depende Para ser capaz de fazer referência direta e usar um componente 4D armazenado no GitHub, você precisa configurar o repositório do componente GitHub: - - Compacte os arquivos de componentes no formato ZIP. - - Nomeie este arquivo com o mesmo nome do repositório do GitHub. - - Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. +- Compacte os arquivos de componentes no formato ZIP. +- Nomeie este arquivo com o mesmo nome do repositório do GitHub. +- Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. Essas etapas podem ser facilmente automatizadas, com o código 4D ou usando o GitHub Actions, por exemplo. @@ -232,7 +232,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers ::: - - **Etiquetas** são textos que fazem referência exclusiva a uma versão. Nos arquivos [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson), você pode indicar a tag de versão que deseja usar em seu projeto. Por exemplo : +- **Etiquetas** são textos que fazem referência exclusiva a uma versão. Nos arquivos [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson), você pode indicar a tag de versão que deseja usar em seu projeto. Por exemplo : ```json { @@ -245,7 +245,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers } ``` - - Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: +- Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: ```json { @@ -262,17 +262,17 @@ Um intervalo é definido por duas versões semânticas, um mínimo e um máximo, Eis alguns exemplos: - - "latest": a versão com o selo "latest" nas versões GitHub. - - "\*": a versão mais recente lançada. - - "1.\*": todas as versões da versão principal 1. - - "1.2.\*": todos os patches da versão menor 1.2. - - ">=1.2.3": a última versão, começando com a versão 1.2.3. - - ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. - - "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. - - "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. - - "<=1.2.3": a versão mais recente até a 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. - - "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. +- "latest": a versão com o selo "latest" nas versões GitHub. +- "\*": a versão mais recente lançada. +- "1.\*": todas as versões da versão principal 1. +- "1.2.\*": todos os patches da versão menor 1.2. +- ">=1.2.3": a última versão, começando com a versão 1.2.3. +- ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. +- "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. +- "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. +- "<=1.2.3": a versão mais recente até a 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. +- "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. Se você não especificar uma tag ou uma versão, 4D recupera automaticamente a "versão mais recente". @@ -282,9 +282,9 @@ O gerenciador de dependências verifica periodicamente se as atualizações do c Se quiser usar a [**Seguir 4D Version**](#defining-a-github-dependency-version-range) regra de dependência, os marcadores de versões de componentes no repositório do Github devem obedecer a convenções específicas. - - **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". +- **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". - - **Versões R-Release**: padrão `xRy. `, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para a versão *xRy*, o Gerenciador de Dependências a resolverá para a "versão mais recente abaixo de xR(y+1)", se disponível. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". +- **Versões R-Release**: padrão `xRy. `, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para a versão *xRy*, o Gerenciador de Dependências a resolverá para a "versão mais recente abaixo de xR(y+1)", se disponível. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". :::note @@ -310,8 +310,8 @@ Em seguida, você precisa [fornecer seu token de conexão](#providing-your-githu Os componentes GitHub referenciados são baixados em uma pasta de cache local e carregados em seu ambiente. A pasta de cache local é armazenada na seguinte localização: - - en macOs: `$HOME/Library/Caches//Dependencies` - - no Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- no Windows: `C:\Users\\AppData\Local\\Dependencies` ...onde `` pode ser "4D", "4D Server" ou "tool4D". @@ -319,12 +319,12 @@ Os componentes GitHub referenciados são baixados em uma pasta de cache local e When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Isto inclui: - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ Em um projeto aberto, você pode adicionar, remover, atualizar e obter informaç Para exibir o painel Dependências: - - Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
+- Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - com o servidor 4D, selecione o item de menu **dependência do Window/Projeto**.
+- com o servidor 4D, selecione o item de menu **dependência do Window/Projeto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) O painel de Dependências é exibido em seguida. Dependências são classificadas por nome em ordem alfabética: @@ -362,11 +362,11 @@ Por padrão, todas as dependências identificadas pelo gerenciador de dependênc ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. - - **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. +- **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. ### Secondary dependencies @@ -384,16 +384,16 @@ As dependências que exigem a atenção do desenvolvedor são indicadas por um * Estão disponíveis as seguintes etiquetas de status: - - **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). - - **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). - - **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. - - **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). - - **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. - - **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). - - **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. - - **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. +- **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). +- **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). +- **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. +- **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). +- **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. +- **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). +- **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. +- **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. Uma dica é exibida quando você passa o mouse sobre a linha de dependência, provando informações adicionais sobre o status: @@ -427,8 +427,8 @@ Este item não é exibido se a dependência estiver inativa porque seus arquivos O ícone do componente e o logotipo da localização fornecem informações adicionais: - - O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. - - Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. +- O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. +- Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Se o item selecionado não for válido, será exibida uma mensagem de erro. Clique em **Adicionar** para adicionar a dependência ao projeto. - - Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). - - Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). +- Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). +- Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Você pode definir a opção [tag ou versão](#tags-and-versions) para uma depen ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). - - **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. - - **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. - - **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. - - **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). +- **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). +- **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. +- **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. +- **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. +- **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). A versão atual da dependência do GitHub é exibida no lado direito do item de dependência: @@ -509,8 +509,8 @@ Modificar o intervalo de versão é útil, por exemplo, se você usar o recurso O gerenciador de dependências fornece um tratamento integrado de atualizações no GitHub. Os seguintes recursos são suportados: - - Verificação automática e manual das versões disponíveis - - Atualização automática e manual de componentes +- Verificação automática e manual das versões disponíveis +- Atualização automática e manual de componentes As operações manuais podem ser feitas **por dependência** ou **para todas as dependências**. @@ -526,11 +526,11 @@ Se você fornecer um [token de acesso](#providing-your-github-access-token), as Além disso, você pode verificar se há atualizações a qualquer momento, para uma única dependência ou para todas as dependências: - - Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. +- Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. ![componente de verificação](../assets/en/Project/check-component-one.png) - - Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. +- Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. ![componentes de verificação](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Se não quiser usar uma atualização de componente (por exemplo, se quiser perm Você pode atualizar as dependências a qualquer momento, para uma única dependência ou para todas as dependências: - - Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: +- Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: ![componente de verificação](../assets/en/Project/update-component-one.png) - - Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: +- Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ Em qualquer caso, independentemente do status atual da dependência, é feita um Quando você seleciona um comando de atualização: - - uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. - - Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. +- uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. +- Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. #### Atualização automática @@ -575,13 +575,13 @@ Quando essa opção estiver desmarcada, uma nova versão de componente que corre O registro do seu token de acesso pessoal no Gerenciador de dependências é: - - obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), - - recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). +- obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), +- recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). Para fornecer seu token de acesso ao GitHub, você pode: - - clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. - - ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. +- clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. +- ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Project/documentation.md b/i18n/pt/docusaurus-plugin-content-docs/current/Project/documentation.md index 7e2af09f175ed8..7c695109cfa85e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Project/documentation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Project/documentation.md @@ -7,10 +7,10 @@ Nos projetos de aplicação, você pode documentar seus métodos e suas classes, Os seguintes elementos do projeto aceitam documentação: - - 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 +- 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 Seus arquivos de documentação são escritos na sintaxe Markdown (arquivos .md) usando qualquer editor compatível com Markdown. São armazenados como ficheiros independentes na pasta do seu projeto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. +- Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. - - Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. +- Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. > Renomear ou excluir um elemento documentado em seu projeto também renomeará ou excluirá o arquivo Markdown associado ao elemento. @@ -73,9 +73,9 @@ Para visualizar a documentação na janela do Explorer: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. +- Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. ### Editar o ficheiro de documentação @@ -83,8 +83,8 @@ Você pode criar e/ou editar um arquivo de documentação Markdown na janela Exp Se não houver um arquivo de documentação para o elemento selecionado, você poderá: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ O editor de código 4D exibe uma parte da documentação de um método em sua di Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ +- Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ @@ -134,7 +134,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Markdown suportado - - A etiqueta de título é suportada: +- A etiqueta de título é suportada: ```md # Title 1 @@ -142,7 +142,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Title 3 ``` - - As etiquetas de estilo (itálico, negrito, riscado) são suportadas: +- As etiquetas de estilo (itálico, negrito, riscado) são suportadas: ```md _italic_ @@ -151,7 +151,7 @@ _italic_ ~~strikethrough~~ ``` - - A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: +- A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: ````md ```4d @@ -160,7 +160,7 @@ _italic_ ``` ```` - - A etiqueta de tabela é suportada: +- A etiqueta de tabela é suportada: ```md | Parâmetro | Tipo | Descrição | @@ -169,7 +169,7 @@ _italic_ | toolbar | Text |Nome da barra de ferramentas | ``` - - A etiqueta de ligação é suportada: +- A etiqueta de ligação é suportada: ```md // Case 1 @@ -181,7 +181,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - As etiquetas de imagem são suportadas: +- As etiquetas de imagem são suportadas: ```md ![image info](pictures/image.png) @@ -228,10 +228,10 @@ $logo:=GetLogo(5) ``` ```` - - Explorer view: +- Explorer view: ![](../assets/en/Project/explorer_Doc.png) - - Code editor view: +- Code editor view: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$attributes.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$attributes.md index 400ee19c74fa0d..5b7b18c85907f6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Se `$attributes` for especificado para os atributos **storage**: +- Se `$attributes` for especificado para os atributos **storage**: - `$attributes=attribute1, attribute2, ...`: somente os atributos das entidades são retornados. ## Exemplo com entidades relacionadas diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$lock.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$lock.md index dd48476a7fcfe5..6e2dfde4a12fb3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$lock.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - outras sessões REST - - Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. +- outras sessões REST +- Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. Uma entidade bloqueada pela API REST só pode ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Resposta diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$method.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$method.md index 61aa1e6d319a20..d21437b56a1f5a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/$method.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/$method.md @@ -193,9 +193,9 @@ Se surgir um problema ao adicionar ou modificar uma entidade, ser-lhe-á enviado :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). - - **Booleanos** son true o false. - - Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). +- **Booleanos** son true o false. +- Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: ### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md index 206f046a875fa3..3c9932bb4f93c7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md @@ -7,8 +7,8 @@ You can call [data model class functions](ORDA/ordaClasses.md) defined for the O Functions can be called in two ways: - - usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. - - usando solicitações **GET**, com parâmetros passados diretamente no URL. +- usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. +- usando solicitações **GET**, com parâmetros passados diretamente no URL. POST requests provide a better security level because they avoid running sensitive code through an action as simple as clicking on a link. However, GET requests can be more compliant with user experience, allowing to call functions by entering an URL in a browser (note: the developer must ensure no sensitive action is done in such functions). @@ -96,11 +96,11 @@ You can send parameters to functions defined in ORDA user classes or singletons. As regras abaixo são válidas: - - Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. - - In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. - - Os parâmetros devem ser incluídos numa coleção (formato JSON). - - Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. - - A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. +- In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. +- Os parâmetros devem ser incluídos numa coleção (formato JSON). +- Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. +- A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Veja [este exemplo](#using-an-entity-to-be-created-on-the-server) e [este exemplo](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Também é possível transmitir valores para quaisquer atributos da entidade. Es | __ENTITY | Parâmetros | Obrigatório - Verdadeiro para indicar ao servidor que o parâmetro é uma entidade | | __KEY | misto (do mesmo tipo que a chave primária) | Facultativo - Chave primária da entidade | - - Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. - - Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos +- Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. +- Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos See examples below for creating or updating entities with POST requests. See an example of contents downloading using an entity with a GET request. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/authUsers.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/authUsers.md index 191f72de779ce4..82fda214ca94dc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/authUsers.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/authUsers.md @@ -43,9 +43,9 @@ All other REST requests (handling data or executing a function) will only be pro As solicitações REST descritivas podem ser processadas em sessões de usuário Web que não exigem licenças (sessões "guest"). Essas solicitações são: - - Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - Renderização de uma página Qodly +- Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - Renderização de uma página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -72,8 +72,8 @@ A função pode receber qualquer autenticação ou informação contextual como Esta função deve conter duas partes: - - some code to identify and authenticate the REST request sender, - - se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. +- some code to identify and authenticate the REST request sender, +- se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. Se a função não chamar [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), nenhum privilégio será atribuído, nenhuma licença será consumida e solicitações REST subsequentes não descritivas serão rejeitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/REST/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/current/REST/gettingStarted.md index 3404d6817ab487..716363373e907b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/REST/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta seção tem o objetivo de familiarizar com as funcionalidades REST com um exemplo simples. Nós vamos: - - criar e configurar um banco de dados 4D simples - - acessar aos dados do banco 4D através de REST usando um navegador padrão. +- criar e configurar um banco de dados 4D simples +- acessar aos dados do banco 4D através de REST usando um navegador padrão. Para simplificar o exemplo, vamos usar uma aplicação 4D e um navegador que são executados na mesma máquina. Também poderia usar uma arquitetura remota. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/processes.md b/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/processes.md index b12baafbf2032e..0e677360751766 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/processes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/processes.md @@ -17,15 +17,15 @@ Existem também três botões de atalho que podem ser utilizados para filtrar o ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Quando você marcar essa opção: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), - - é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), +- é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. A área inferior da janela é utilizada para apresentar a representação gráfica da atividade do(s) processo(s) selecionado(s). @@ -33,16 +33,16 @@ A área inferior da janela é utilizada para apresentar a representação gráfi A atividade do processo é a percentagem de tempo que 4D Server dedicou a este processo (proporção). A janela fornece as seguintes informações para cada processo: - - Tipo de processo (ver abaixo), - - Sessão/Info: +- Tipo de processo (ver abaixo), +- Sessão/Info: - Processo 4D - em branco, - Processo usuário - nome do usuário 4D, - Processo web - caminho URL, - - Nome do processo, - - Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. - - Estado atual do processo, - - Tempo de execução (em segundos) do processo desde a sua criação, - - Percentagem de tempo que 4D Server dedicou a este processo (rácio). +- Nome do processo, +- Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. +- Estado atual do processo, +- Tempo de execução (em segundos) do processo desde a sua criação, +- Percentagem de tempo que 4D Server dedicou a este processo (rácio). ## Tipo de processo @@ -83,15 +83,15 @@ A página também tem cinco botões de controle que atuam nos processos selecion ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Pausar processo**: pode ser usado para pausar os processos selecionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). +- **Pausar processo**: pode ser usado para pausar os processos selecionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md b/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md index 5ad406eb40bfc1..08aef35634f4df 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ A página do Monitor em Tempo Real monitora o progresso de operações "longas" As informações seguintes são fornecidas para cada linha: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ As informações seguintes são fornecidas para cada linha: A página está ativa e é atualizada permanentemente assim que é exibida. Note-se que o seu funcionamento pode atrasar significativamente a execução da aplicação. É possível suspender a atualização desta página de uma das seguintes maneiras: - - haciendo clic en el botón **Pausa**, - - clicando na lista, - - premindo a barra de espaços. +- haciendo clic en el botón **Pausa**, +- clicando na lista, +- premindo a barra de espaços. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Você pode retomar o monitoramento das operações realizando a mesma ação que realizar a pausa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Users/overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/Users/overview.md index fdcd6e21619131..608710e42261c0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Users/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Users/overview.md @@ -7,8 +7,8 @@ Se mais de uma pessoa usar uma aplicação, que geralmente é o caso em arquitet A estratégia de controle de acesso 4D depende da configuração de sua implementação: - - em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md index e283eb9cf3a573..667ae23ab125a4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Em filePath, passe o caminho de destino e o nome do documento a ser importado. S Você pode especificar o formato do arquivo exportado incluindo uma extensão após o nome do documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", ou ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", ou ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Se a extensão não for incluída, mas o formato for especificado em *paramObj*, o arquivo exportado terá a extensão que corresponde ao formato, exceto para o formato CSV (nenhuma extensão é adicionada nesse caso). @@ -88,25 +88,25 @@ O parâmetro opcional *paramObj* permite que você defina várias propriedades p **Notas sobre o formato Excel**: - - Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. +- Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. **Notas sobre o formato PDF**: - - Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato CSV**: - - Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. - - Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. +- Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato de arquivo SpreadJS**: - - Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Once the export operation is finished, `VP EXPORT DOCUMENT` automatically triggers the execution of the method set in the *formula* property of the *paramObj*, if used. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md index 3a6361ba1ce077..fc90cc04ccc72f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Em *vpAreaName*, passe o nome da propriedade da área 4D View Pro. Se passar um You can define where to get the style sheets in the optional *sheet* parameter using the sheet index (counting begins at 0) or with the following constants: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md index 47e8cd97ce06bf..40e8f143e18c79 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ The object returned will contain the `value` property, and, in case of a js date Se o objetivo retornado incluir uma data ou hora, é tratado como uma datetime e completado como abaixo: - - valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy - - valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) +- valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy +- valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) Se *rangeObj* contiver várias células ou vários intervalos, o valor da primeira célula é retornado. O comando retorna um objeto null se a célula estiver vazia. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md index 950f0b3fadd449..89009c2424490e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Em *vpAreaName*, passe o nome da área 4D View Pro. Se passar um nome que não e Em *filePath*, passe o caminho de destino e o nome do documento a ser importado. São suportados os seguintes formatos: - - Os documentos 4D View Pro (extensão ".4vp") - - Microsoft Excel (extensão ".xlsx") - - documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) - - [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") +- Os documentos 4D View Pro (extensão ".4vp") +- Microsoft Excel (extensão ".xlsx") +- documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) +- [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") If the document extension is not a recognized extension, such as `.4vp` or `.xlsx`, the document is considered a text document. Deve passar uma rota completa, a não ser que o documento esteja localizado no mesmo nível que a pasta Project, em cujo caso pode passar apenas seu nome. @@ -73,11 +73,11 @@ O parâmetro opcional *paramObj* permite definir as propriedades do documento im :::note Notas - - Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md index 1a2476003ae825..b6dc6b4e3461cc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ O comando `VP RESIZE TABLE` alter As regras abaixo são válidas: - - Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. - - Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. - - Se a tabela se expandir nas células que contêm dados: +- Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. +- Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. +- Se a tabela se expandir nas células que contêm dados: - se as linhas forem adicionadas, os dados serão excluídos, - se colunas forem adicionadas, dados serão mantidos e exibidos em novas colunas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md index 0ea24e8c6c0966..fa56a40ec2ede4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md @@ -37,20 +37,20 @@ As folhas de cálculo são compostas por linhas e colunas. A cada linha está as ### Seleção de células, colunas e linhas - - Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. +- Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. - - Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. +- Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. - - To select all cells in the spreadsheet, click on the cell at the top left of the area: +- To select all cells in the spreadsheet, click on the cell at the top left of the area: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). +- Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). - - Para selecionar uma linha, clique no número correspondente. +- Para selecionar uma linha, clique no número correspondente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. +- Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. ### Introdução de dados @@ -76,8 +76,8 @@ As áreas do 4D View Pro se beneficiam de um menu de contexto automático que of Dependendo da área clicada, as seguintes opções também estão disponíveis: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - clique numa célula ou num intervalo de células: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- clique numa célula ou num intervalo de células: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. When a comment has been entered for an area, the top left cell of the area displays a small red triangle:\ @@ -128,8 +128,8 @@ Você pode então passar `$myRange` para outro método 4D View Pro para modifica Os objectos intervalo 4D View Pro são compostos por várias propriedades: - - área - O nome da área 4D View Pro - - intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- área - O nome da área 4D View Pro +- intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propriedade | | Tipo | Descrição | Disponível para | | ----------- | ------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | @@ -146,10 +146,10 @@ Os objectos intervalo 4D View Pro são compostos por várias propriedades: 4D View Pro suporta a importação e exportação de vários formatos de documentos: - - .4vp - - .xlsx - - .txt e .csv - - .sjs - - .pdf (apenas para exportação) +- .4vp +- .xlsx +- .txt e .csv +- .sjs +- .pdf (apenas para exportação) Para obter mais detalhes, confira a descrição de [VP IMPORT DOCUMENT](commands/vp-import-document.md) e [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md index 217af63b46f897..836441d9b6ee0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Some other items have a different case (ex: `this` vs `This`) but can be pasted QodlyScript command and constant names are written in camel case without spaces. Além disso, os nomes das constantes QodlyScript começam com a letra `k`. You might need to adapt these QodlyScript items to the 4D Language. - - Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. - - However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. +- Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. +- However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. ### Exemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript command and constant names are written in camel case without spaces. end ``` - - Código 4D equivalente no linguajem: +- Código 4D equivalente no linguajem: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md index 2e41224923c456..9e0085b73e83d1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Nas seções acima, nós temos acesso gratuito à aplicação através de solici A maneira mais simples e segura para registrar um usuário no servidor da Web 4D é baseada no seguinte cenário: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Criar uma tabela com alguns campos, por exemplo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index 2da5339aaf5bbb..4070c3ace6f83b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Requisitos Custom HTTP Request handlers are supported: - - quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressões regulares**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/**/index.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressõe URL patterns are triggered in the given order: - - the first matching pattern is executed - - the following patterns are not executed even if they match the URL +- the first matching pattern is executed +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Classe e método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Veja abaixo](#request-handler-code) para informações sobre o código do manipulador de pedidos. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* na classe *UsersHandling* - - *handleInvoices* na classe \*FinancialHandling - - *handleDocs* na classe *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* +- *handle function* in the *GeneralHandling* class +- *manageAccount* na classe *UsersHandling* +- *handleInvoices* na classe \*FinancialHandling +- *handleDocs* na classe *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* Examples of URLs triggering the handlers: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md index 722ca324f149d0..83d3dbf6767651 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív | Servidor Web | cooperativo | *configuração web* | | Servidor Web Services | cooperativo | *configuração web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de serviços Web: trata dos pedidos SOAP - - ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de serviços Web: trata dos pedidos SOAP +- ***web setting*** means that the preemptive mode depends on the [**scalable sessions**](sessions.md#enabling-web-sessions) status: - if scalable sessions are enabled, the preemptive mode is automatically used for web and web service processes. - if scalable sessions are not enabled: - for web processes, the [**Use preemptive processes**](webServerConfig.md#use-preemptive-processes) option is taken into account. @@ -36,21 +36,21 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív Todo o código 4D executado pelo servidor deve ser hilo seguro se você quiser que seus processos web sejam executados em modo preventivo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos os métodos bases relacionados com a Web: +- Todos os métodos bases relacionados com a Web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) e [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml +- Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para as tabelas com o atributo "Expor como recurso REST" +- Triggers para as tabelas com o atributo "Expor como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST For each of these methods and code parts, the compiler will check if the [thread-safety rules are respected](../Develop/preemptive.md#writing-a-thread-safe-method), and will return errors in case of issues. @@ -62,8 +62,8 @@ A maioria dos comandos 4D relacionados à Web e funções, métodos de banco de Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -73,15 +73,15 @@ Obviamente, o código executado por esses métodos também deve ser hilo seguro. As seguintes URLs Web Server 4D são hilo seguro e podem ser usadas em modo preventivo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Ícone de processo web preemptivo diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md index d9a7ab5399474a..3bc531d075b1c1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio can also be used in the [**Qodly Cloud platform**](https://qodly.co Qodly Studio proposes a full-featured web UI, allowing you to: - - create Qodly pages by placing components on a canvas - - map components to Qodly Sources - - acionar o código 4D configurando eventos - - e muito mais. +- create Qodly pages by placing components on a canvas +- map components to Qodly Sources +- acionar o código 4D configurando eventos +- e muito mais. ## Configuração @@ -24,19 +24,19 @@ Qodly Studio proposes a full-featured web UI, allowing you to: Qodly Studio suporta os seguintes navegadores Web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox A resolução recomendada é 1920x1080. #### Aplicação 4D - - Desenvolvimento: 4D v20 R2 ou superior - - Desenvolvimento: 4D Server v20 R2 ou superior - - Qodly Studio only works with 4D projects (binary databases are not supported). - - Web sessions (*aka* Scalable sessions) must [be enabled](sessions.md#enabling-web-sessions). - - O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). +- Desenvolvimento: 4D v20 R2 ou superior +- Desenvolvimento: 4D Server v20 R2 ou superior +- Qodly Studio only works with 4D projects (binary databases are not supported). +- Web sessions (*aka* Scalable sessions) must [be enabled](sessions.md#enabling-web-sessions). +- O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). ### Habilitando o acesso a Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio é servido pelo [servidor web WebAdmin](../Admin/webAdmin.md) e exi Para permitir o acesso ao Qodly Studio, você deve permiti-lo explicitamente em dois níveis: - - ao nível da aplicação 4D - - a nível do projeto +- ao nível da aplicação 4D +- a nível do projeto If one of the two levels (or both) are not enabled, access to Qodly Studio is denied (a 403 page is returned). @@ -79,8 +79,8 @@ Authentication on the WebAdmin web server is granted using an access key. Para m In accordance with the management of 4D projects, only the following usages are supported: - - o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). - - implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. +- o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). +- implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. :::warning @@ -94,10 +94,10 @@ A página Qodly Studio está disponível quando o [servidor web WebAdmin](../Adm Há duas maneiras de acessar Qodly Studio: - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). If the WebAdmin web server is already running, depending on its configuration, your default browser opens at `IPaddress:HTTPPort/studio` or `IPaddress:HTTPSPort/studio`. Otherwise, you will be prompted if you want to start the WebAdmin web server first. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` ou : @@ -145,24 +145,24 @@ Note that in 4D single-user, if you open some 4D code with the Qodly Studio code The following commands and classes are dedicated to the server-side management of Qodly pages: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. - - comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. - - clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. - - Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. +- comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. +- clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. +- Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. ### Uso de métodos projeto Recomendamos o uso de funções classe em vez de métodos projeto. Apenas as funções de classe podem ser chamadas a partir de componentes. No entanto, você ainda pode usar seus métodos projeto no Qodly Studio de duas maneiras: - - Você pode chamar seus métodos a partir de funções classe. - - Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. +- Você pode chamar seus métodos a partir de funções classe. +- Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. ### Uso fora de linha You can develop with Qodly Studio while your computer is not connected to the internet. Nesse caso, entretanto, os seguintes recursos não estão disponíveis: - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): the Template library is empty - - Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): the Template library is empty +- Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). ## Implantação @@ -178,8 +178,8 @@ See [this page](https://developer.qodly.com/docs/studio/rendering) for detailed Para ativar a renderização das páginas Qodly, as seguintes opções devem ser definidas. - - A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. - - O [servidor Web 4D](webServer.md) deve estar em execução. +- A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. +- O [servidor Web 4D](webServer.md) deve estar em execução. :::note @@ -309,9 +309,9 @@ Para fazer o logout do usuário, basta executar a ação padrão **Logout** na p Triggering the logout action from a web user session has the following effects: - - a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, - - a licença associada ao 4D é liberada, - - the `Session.storage` is kept until the web session inactivity timeout is reached (at least one hour). During this period after a logout, if the user logs in again, the same session is used and the `Session.storage` shared object is available with its current contents. +- a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, +- a licença associada ao 4D é liberada, +- the `Session.storage` is kept until the web session inactivity timeout is reached (at least one hour). During this period after a logout, if the user logs in again, the same session is used and the `Session.storage` shared object is available with its current contents. ## Sobre o uso da licença para renderização @@ -363,7 +363,7 @@ For more information on the `SameSite` attribute, check out [this blog post](htt To avoid using more licenses than necessary, we recommend doing one of the following: - - Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. - - Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. +- Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. +- Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/templates.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/templates.md index 48f067b2f19148..db7782b67a1684 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/templates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Estão disponíveis as seguintes etiquetas 4D: - - 4DTEXT, para inserir variáveis e expressões 4D como texto, - - 4DHTML, para inserir código HTML, - - 4DEVAL, para avaliar qualquer expressão 4D, - - 4DSCRIPT, para executar um método 4D, - - 4DINCLUDE, para incluir uma página dentro de outra, - - 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, - - 4DCODE, para inserir o código 4D, - - 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, - - 4DLOOP e 4DENDLOOP, para criar loops no código HTML, - - 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. +- 4DTEXT, para inserir variáveis e expressões 4D como texto, +- 4DHTML, para inserir código HTML, +- 4DEVAL, para avaliar qualquer expressão 4D, +- 4DSCRIPT, para executar um método 4D, +- 4DINCLUDE, para incluir uma página dentro de outra, +- 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, +- 4DCODE, para inserir o código 4D, +- 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, +- 4DLOOP e 4DENDLOOP, para criar loops no código HTML, +- 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md index 079d8c87b483bd..06758b9824340d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) O servidor web principal de 4D pode ser iniciado de diferentes maneiras: - - Utilizar um botão/comando de menu. +- Utilizar um botão/comando de menu. - 4D: menu **Executar\>Iniciar o servidor Web**
![](../assets/en/WebServer/start1.png) - 4D Server: botão **Iniciar servidor HTTP** da página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) +- Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) - - Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. +- Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. O servidor Web de qualquer componente pode ser iniciado com a chamada da função [`webServer.start()`](API/WebServerClass.md#start) no objeto do servidor Web do componente. @@ -29,9 +29,9 @@ O servidor Web de qualquer componente pode ser iniciado com a chamada da funçã O servidor web principal de 4D pode ser parado de diferentes maneiras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. +- Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ A qualquer momento, você pode limpar o cache das páginas e imagens que ele con Para o fazer, pode: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. A cache é então imediatamente limpa. @@ -64,11 +64,11 @@ A cache é então imediatamente limpa. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. ## URLs de administração @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Quando esse UR 4D permite gerar dois logs de pedidos web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md index 51b23f84fc7778..835c154a309971 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts e métodos permitidos para o serviço CORS. Nome de domínio ou endereço IP de onde as páginas externas têm permissão para enviar solicitações de dados ao servidor via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Várias sintaxes são suportadas: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propriedade methods) Método(s) HTTP aceite(s) para o host CORS correspondente. São suportados os seguintes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separar cada método com um ";" (por exemplo: "post;get"). Se methods estiver vazio, null ou indefinido, todos os métodos serão ativados. @@ -145,9 +145,9 @@ Por padrão, quando o servidor web é iniciado pela primeira vez, 4D cria uma p Você pode designar outra página inicial padrão inserindo seu nome de caminho. - - La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - O caminho não deve começar nem terminar com uma barra. +- La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- O caminho não deve começar nem terminar com uma barra. Por exemplo, se você quiser que a página inicial padrão seja "MyHome. tm", e está localizado na pasta "Web" (ela própria localizada na pasta raiz padrão HTML), use "Web/MyHome.htm". @@ -318,14 +318,14 @@ Valores possíveis: Cadeia de endereços IP. Ambos os formatos de string IPv6 (p #### Acerca do suporte IPv6 - - **No warning when TCP port is occupied**
+- **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. Na verdade, o servidor 4D não detecta nenhum erro neste caso porque a porta permanece gratuita no endereço IPv6. No entanto, não é possível acessá-lo usando o endereço IPv4 da máquina, nem através do endereço local: 127.0.0.1. Se o seu servidor 4D não parecer responder na porta definida, pode testar o endereço [::1] na máquina do servidor (equivalente a 127.0.0.1 para IPv6, adicionar [:portNum] para testar outro número de porta). Se 4D responder, é provável que outro aplicativo esteja usando a porta em IPv4. - - **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Esses endereços são escritos com um prefixo de 96 bits no formato IPv6, seguido de 32 bits escritos na notação ponto-decimal do IPv4. Por exemplo, ::ffff:192.168.2.34 representa o endereço IPv4 192.168.2.34. +- **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Esses endereços são escritos com um prefixo de 96 bits no formato IPv6, seguido de 32 bits escritos na notação ponto-decimal do IPv4. Por exemplo, ::ffff:192.168.2.34 representa o endereço IPv4 192.168.2.34. - - **Indication of port numbers**
+- **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: ```code4d @@ -419,10 +419,10 @@ Versão mínima de TLS aceita para ligações. As tentativas de ligação de cli Valores possíveis: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (padrão) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (padrão) +- 4 = TLSv1_3 Se modificado, o servidor deve ser reiniciado para utilizar o novo valor. @@ -488,10 +488,10 @@ Por exemplo: Disallow: /GIFS/ ``` - - "User-Agent: \*" - todos os robôs são afetados. - - "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. - - "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. - - "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. +- "User-Agent: \*" - todos os robôs são afetados. +- "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. +- "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. +- "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. Outro exemplo @@ -516,15 +516,15 @@ Além disso, a pasta raiz do HTML define, no disco rígido do servidor da Web, o Por defecto, 4D define una carpeta raíz HTML llamada **WebFolder**. Se ela ainda não existir, a pasta raiz HTML será fisicamente criada no disco no momento em que o servidor Web for iniciado pela primeira vez. A pasta raiz é criada: - - con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). - - com 4D em modo remoto, na pasta de recursos locais. +- con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). +- com 4D em modo remoto, na pasta de recursos locais. Você pode designar outra pasta raiz HTML padrão inserindo seu caminho. - - La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta - - O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). +- La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta +- O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). Por exemplo, se você quiser que a pasta raiz HTML seja a subpasta "Web" na pasta "MyWebApp", digite "MyWebApp/Web". @@ -579,9 +579,9 @@ Valor del atributo `SameSite` de la cookie de sesión. Este atributo le permite Há três valores disponíveis: - - "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. - - "Laxos": Os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). - - "None": Cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. +- "Laxos": Os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). +- "None": Cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). El valor del atributo `Secure` de la cookie de sesión se define automáticamente en "True" si la conexión es HTTPS (sea cual sea el valor del atributo `SameSite`). @@ -621,9 +621,9 @@ Em alguns casos, outras funções internas otimizadas podem ser invocadas. As li Duas opções permitem que você defina como funcionam as conexões persistentes: - - **Number of requests by connection**: Allows you to set the maximum number of requests and responses able to travel over a connection keep alive. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

+- **Number of requests by connection**: Allows you to set the maximum number of requests and responses able to travel over a connection keep alive. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **Timeout**: This value defines the maximum wait period (in seconds) during which the web server maintains an open TCP connection without receiving any requests from the web browser. Once this period is over, the server closes the connection.

+- **Timeout**: This value defines the maximum wait period (in seconds) during which the web server maintains an open TCP connection without receiving any requests from the web browser. Once this period is over, the server closes the connection.

If the web browser sends a request after the connection is closed, a new TCP connection is automatically created. Esta operação não é visível para o usuário.

diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md index 89dc823399d8ab..f5027f1adccc0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) Por exemplo, se você instalou dois componentes em sua aplicação principal, você pode iniciar e monitorar até três servidores web independentes em sua aplicação: - - um servidor web para a aplicação local, - - um servidor Web para o componente #1, - - um servidor Web para o componente #2. +- um servidor web para a aplicação local, +- um servidor Web para o componente #1, +- um servidor Web para o componente #2. Além da memória, não há limite para o número de componentes e, assim, de servidores web, que podem ser anexados a um único projeto de aplicação 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicação host ou componente) pode ser usado em seu próprio contexto separado, incluindo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - o processamento das etiquetas 4D e das chamadas de métodos, - - sessões Web e gestão do protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- o processamento das etiquetas 4D e das chamadas de métodos, +- sessões Web e gestão do protocolo TLS. Isso permite que você desenvolva componentes e recursos independentes que vêm com suas próprias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Se a aplicação utilizar componentes e o usuário pretender chamar: - - o servidor Web da aplicação host a partir de um componente ou - - o servidor que recebeu o pedido (qualquer que seja o servidor), +- o servidor Web da aplicação host a partir de um componente ou +- o servidor que recebeu o pedido (qualquer que seja o servidor), também pode ser utilizado: @@ -94,8 +94,8 @@ Estas propriedades são definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. se não for usado, nos parâmetros da aplicação host ou do componente. - - Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. - - If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. +- Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. +- If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. > *isRunning*, *name*, *openSSLVersion*, and *perfectForwardSecrecy* are read-only properties that cannot be predefined in the `settings` object parameter for the [`start()`](API/WebServerClass.md#start) function. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md b/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md index 9f57b41f63b0af..ae118bb3c8a11f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ The **WP Insert break** command ins Em *targetObj*, passe: - - um intervalo, ou - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - um documento 4D Write Pro +- um intervalo, ou +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- um documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insert contents at beginning of target | | wk replace | Integer | 0 | Replace target contents | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Parâmetros | Tipo | Valor | Comentário | | --------------------- | ------- | ----- | ------------------------------------------------------------------------ | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. +- Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md b/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md index 491bc78f5d2554..23587c8ed23223 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandThe **Form** command returns the object associated with the current form (instantiated from the *formData* parameter or the user class assigned in the Form editor).O comando **Form** retorna o objeto associado ao formulário atual (instanciado a partir do parâmetro *formData* ou da classe usuário atribuída no editor de formulários). O 4D associa automaticamente um objeto ao formulário atual nos seguintes casos: - - o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), - - o formulário atual é um subformulário, - - um formulário de tabela é exibido na tela no momento. +- o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), +- o formulário atual é um subformulário, +- um formulário de tabela é exibido na tela no momento. ### Comandos (DIALOG...) Se o formulário atual estiver sendo exibido ou carregado por uma chamada aos comandos [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** retornará um dos dois: - - o objeto *formData* passado como parâmetro para esse comando, se houver, - - ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, - - ou um objeto vazio. +- o objeto *formData* passado como parâmetro para esse comando, se houver, +- ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, +- ou um objeto vazio. ### Subformulário Se o formulário atual for um subformulário, o objeto retornado dependerá da variável do contêiner pai: - - **Form** returns the object associated with the table form displayed on screen.\ +- **Form** returns the object associated with the table form displayed on screen.\ **Form** returns the object associated with the table form displayed on screen.\ In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: @@ -50,7 +50,7 @@ Se o formulário atual for um subformulário, o objeto retornado dependerá da v (OBJECT Get pointer(Object subform container))-> ``` - - Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. +- Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. Para mais informações, consulte a seção *Subformulários de Páginas*. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/generate-uuid.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/generate-uuid.md new file mode 100644 index 00000000000000..af82ba45385d73 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| Parâmetro | Tipo | | Descrição | +| --------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| Resultado | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
História + +| Release | Mudanças | +| ------- | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## Descrição + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form. + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## Exemplo + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## Propriedades + +| | | +| ----------------- | --------------------------- | +| Número de comando | 1066 | +| Thread safe | ✓ | + + diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md index 2128ff99f847fc..2ffe7e88a60ae7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Se o novo índice elemento for além do último elemento existente da coleção Pode passar qualquer número de valores dos tipos compatíveis abaixo: - - número (real, longint....). Valores numéricos são sempre armazenados como reais. - - text - - boolean - - date - - hora (armazenada como número de milissegundos - real) - - null - - objeto compartido - - coleção compartilhada +- número (real, longint....). Valores numéricos são sempre armazenados como reais. +- text +- boolean +- date +- hora (armazenada como número de milissegundos - real) +- null +- objeto compartido +- coleção compartilhada :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/print-form.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/print-form.md index f92975731a6d8c..5a7b84e56d29c0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/print-form.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs No parâmetro *form*, você pode passar: - - o nome de um formulário, ou - - o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou - - um objeto contendo uma descrição do formulário. +- o nome de um formulário, ou +- o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou +- um objeto contendo uma descrição do formulário. Como **Imprimir formulário** não emite uma quebra de página após a impressão do formulário, é fácil combinar diferentes formulários na mesma página. Portanto, o **Print form** é perfeito para tarefas de impressão complexas que envolvam diferentes tabelas e diferentes formulários. Para forçar uma quebra de página entre os formulários, use o comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir a impressão para a próxima página em um formulário cuja altura seja maior que o espaço disponível, chame o comando [CANCEL](../commands-legacy/cancel.md) antes do comando [PAGE BREAK](../commands-legacy/page-break.md). Três sintaxes diferentes podem ser usadas: - - **Impressão da área de detalhe** +- **Impressão da área de detalhe** Sintaxe: @@ -43,7 +43,7 @@ Sintaxe: Nesse caso, **Imprimir formulário** imprime apenas a área de detalhes (a área entre a linha do cabeçalho e a linha de detalhes) do formulário. - - **Impressão da área do formulário** +- **Impressão da área do formulário** Sintaxe: @@ -79,7 +79,7 @@ Nesse caso, o comando imprimirá a seção designada pelo *marker*. Passe uma da | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impressão da seção** +- **Impressão da seção** Sintaxe: @@ -101,8 +101,8 @@ O valor retornado por **Print form** indica a altura da área impressa. Esse val As caixas de diálogo da impressora não são exibidas quando você usa **Print form**. O relatório não usa as configurações de impressão que foram atribuídas ao formulário no ambiente Design. Há duas maneiras de especificar as configurações de impressão antes de emitir uma série de chamadas para **Print form**: - - Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. - - Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. +- Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. +- Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. **Print form**\* cria cada página impressa na memória. Cada página é impressa quando a página na memória está cheia ou quando você chama [PAGE BREAK] (../commands-legacy/page-break.md). Para garantir a impressão da última página após qualquer uso de **formulário de impressão**, você deve concluir com o comando [PAGE BREAK](../commands-legacy/page-break.md) (exceto no contexto de um [ABERTO PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). Caso contrário, se a última página não estiver cheia, ela permanecerá na memória e não será impressa. @@ -116,8 +116,8 @@ Esse comando imprime áreas e objetos externos (por exemplo, áreas 4D Write ou **4D Server:** Esse comando pode ser executado no 4D Server dentro da estrutura de um procedimento armazenado. Neste contexto: - - Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). - - No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. +- Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). +- No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/process-info.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/process-info.md index 8ef8463555262b..c35abaaaa85ce5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/process-info.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/process-info.md @@ -44,7 +44,7 @@ O objeto retornado contém as propriedades abaixo: | type | Integer | Tipo de processo em execução. Valores possíveis: veja abaixo | | visible | Parâmetros | True if visible, false otherwise | - - Valores possíveis para "state": +- Valores possíveis para "state": | Parâmetros | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ O objeto retornado contém as propriedades abaixo: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores possíveis para "type": +- Valores possíveis para "type": | Parâmetros | Valor | | ----------------------------- | ----- | diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/session.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/session.md index 6bbf9889f0877e..79545be3842d19 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/session.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Veja também +## Veja também [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/string.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/string.md index 2bf10c9f6369cf..fc6655651c4c93 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/string.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/string.md @@ -31,7 +31,7 @@ displayed_sidebar: docs The **String** command returns the string form of the numeric, Date, Time, string or Boolean expression you pass in *expression*. -If you do not pass any parameter, the string is returned with the appropriate default format. If you pass *format*, you can force the result string to be of a specific format. +If you do not pass any other parameter, the string is returned with the appropriate default format. If you pass *format*, you can force the result string to be of a specific format. The optional *addTime* parameter adds a time to a date in a combined format. It can only be used when the *expression* parameter is a date (see below). @@ -90,7 +90,7 @@ If you pass 0 in *base*, the command determines the radix depending on the *expr :::info - This syntax strictly follows the [`toString` EcmaScript specification regarding radix handling](https://tc39.es/ecma262/multipage/numbers-and-dates.html#sec-number.prototype.tostring). -- Using this syntax with *base*=10 will not give exactly the same results as using the syntax without *base* parameter. For example, if the specified number value is not a number, the "Nan" string is returned. +- Using this syntax with *base*=10 will not give exactly the same results as using the syntax without *base* parameter. For example, if the specified number value is not a number, the "NaN" string is returned. ::: @@ -257,11 +257,11 @@ If *expression* is evaluated to Null, the command returns the "null" string. Thi ## Veja também -[Bool](bool.md)\ -[Date](date.md)\ +[Bool](../commands-legacy/bool.md)\ +[Date](../commands-legacy/date.md)\ [Num](num.md)\ -[Time string](time-string.md)\ -[Timestamp](timestamp.md) +[Time string](../commands-legacy/time-string.md)\ +[Timestamp](../commands-legacy/timestamp.md) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/theme/Tools.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/theme/Tools.md index d9c2da5e6ff54a..76ff3d453b8a0a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/theme/Tools.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/theme/Tools.md @@ -12,7 +12,7 @@ slug: /commands/theme/Tools | [](../../commands-legacy/choose.md)
| | [](../../commands-legacy/generate-digest.md)
| | [](../../commands-legacy/generate-password-hash.md)
| -| [](../../commands-legacy/generate-uuid.md)
| +| [](../generate-uuid.md)
| | [](../../commands-legacy/get-macro-parameter.md)
| | [](../../commands-legacy/launch-external-process.md)
| | [](../../commands-legacy/load-4d-view-document.md)
| diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/client-server.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/client-server.md index be108f33fb31e9..66461efc27a1eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/client-server.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/client-server.md @@ -13,8 +13,8 @@ As páginas Cliente-servidor agrupam parâmetros relacionados ao uso do banco de Essa opção permite que você indique se o banco de dados do 4D Server aparecerá ou não na lista de bancos de dados publicados. - - When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). - - Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. +- When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). +- Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. :::note @@ -49,12 +49,12 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con O 4D Server usa três portas TCP para comunicações entre servidores internos e clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). - - **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). +- **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ When a 4D client connects to 4D Server, it uses the TCP port of the application server (19813 or the port indicated after the colon ':' in the IP address shown in the connection dialog box). Connection to other servers via their respective ports is then automatic; it is no longer necessary to specify them.\ Note that in the case of access via a router or a firewall, the three TCP ports must be opened explicitly. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. #### Autenticação do usuário com o servidor de domínio @@ -68,9 +68,9 @@ Quando o Single Sign On (SSO) estiver ativado (veja acima), você deverá preenc This drop-down box contains 3 network layer options to choose between: **legacy**, **ServerNet** and **QUIC** (only in project mode), which are used to handle communications between 4D Server and remote 4D machines (clients). - - **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -110,9 +110,9 @@ Essa opção permite que você ative o modo seguro para comunicações entre a m This setting can be used to globally set the updating mode for the local instance of the **Resources** folder on the connected 4D machines when the **Resources** folder of the database is modified during the session (the **Resources** folder is automatically synchronized on the remote machine each time a session is opened). Estão disponíveis três parâmetros: - - **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. - - **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ +- **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. +- **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ The **Resources** folder centralizes the custom files required for the database interface (translation files, pictures, etc.). Mecanismos automáticos ou manuais podem ser usados para notificar cada cliente quando o conteúdo dessa pasta tiver sido modificado. Para mais informações, por favor consulte a seção [Gerenciando da pasta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuração IP @@ -125,10 +125,10 @@ Essa tabela permite definir regras de controle de acesso para o banco de dados, O comportamento da tabela de configuração é o seguinte: - - A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. - - A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. - - A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. - - Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: +- A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. +- A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. +- A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. +- Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: - Negar 192.168.\* (negar todos os endereços que comecem por 192.168) - Autorizar \* (e autorizar outros) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md index f5dc235cc5c47d..7a47cabf23f216 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -8,10 +8,10 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m > The number of options displayed depends on the version of 4D with which the original database/project was created, as well as the settings modified in this database/project.\ > This page lists the compatibility options available for database/projects converted from 4D v18 onwards. Para opções de compatibilidade mais antigas, consulte a [Página de compatibilidade](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) em **doc.4d.com**. - - **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. +- **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. **Nota:** esta opção também pode ser gerenciada programando usando o comando `SET DATABASE PARAMETER`. - - **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: +- **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: - inicial "/" não é apenas o nó raiz - usar um / como primeiro caractere em uma expressão XPath não declara um caminho absoluto do nó raiz - não há nó atual implícito - o nó atual tem que ser incluído na expressão XPath @@ -19,12 +19,12 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m Although not standard, you might want to keep using these features so that your code continues to work as before -- in this case, just set the option *unchecked*. Por outro lado, se seu código não depender da implementação não padrão e se você quiser se beneficiar dos recursos estendidos do XPath em seus bancos de dados (como descrito no [`elemento DOM Find XML`](../commands-legacy/dom-find-xml-element.md) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. - - **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). +- **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). - - **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). +- **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). - - **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/database.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/database.md index c9b9a2923920be..e72f5a23911f93 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/database.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/database.md @@ -17,10 +17,24 @@ Essa opção permite a configuração da operação do aplicativo ao abrir um ar A menos que essa opção esteja marcada, não é possível abrir um banco de dados quando seu arquivo de dados estiver bloqueado (operação padrão para bancos de dados 4D). -#### Sobre arquivos bloqueados +:::info Sobre arquivos bloqueados Os arquivos bloqueados podem ser lidos, mas seu conteúdo não pode ser modificado. Por exemplo, os arquivos são bloqueados quando são armazenados em um suporte não regravável (tipo DVD) ou quando são copiados deste tipo de suporte. 4D pode trabalhar de forma transparente com arquivos de dados bloqueados, o que permite, mais particularmente, o uso de projetos armazenados em DVD. No entanto, esta operação corre o risco de usar inadvertidamente um arquivo de dados bloqueado no qual as modificações não serão salvas. É por isso que por padrão 4D não permite que bancos de dados com arquivo de dados bloqueado sejam abertos. +::: + +#### Auto UUID version + +[UUID version](https://en.wikipedia.org/wiki/Universally_unique_identifier) to use for 4D fields with [automatic UUID generation option](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106195). Available values are **4** (default) and **7**. + +This setting only applies to UUIDs generated afterwards. Already saved auto UUIDs fields are not recomputed. + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + ### Localização da pasta temporária Essa área permite que você altere o local dos arquivos temporários criados enquanto o 4D está em execução. A pasta de arquivos temporários é usada pelo aplicativo, quando necessário, para salvar temporariamente os dados da memória no disco. @@ -31,9 +45,9 @@ A localização atual desta pasta é exibida na área "Atual:". Você pode clica São oferecidos três opções de localização: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +55,7 @@ São oferecidos três opções de localização: > Se você alterar uma dessas opções, é preciso sair e reabrir o banco de dados para tornar a alteração eficaz. Quando a base de dados for reaberta, todos os índices da base de dados são automaticamente reindexados. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Quando a opção estiver marcada, o sinal de arroba é considerado um caractere simples se estiver localizado em uma palavra. Essa configuração é especialmente útil quando se procura por endereços de e-mail, onde o sinal @ é usado internamente. Esta opção tem influência em pesquisas, ordenações, comparações de string, bem como em dados armazenados em tabelas e dados encontrados na memória, como arrays. Campos e variáveis do alfa (indexado ou não) e tipo de texto estão preocupados com a forma como o caractere @ é interpretado em pesquisas e tipos de caracteres. @@ -52,19 +66,19 @@ São oferecidos três opções de localização: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razões de segurança, apenas o Administrador ou Designer da base de dados podem modificar este parâmetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. Um projeto 4D pode, portanto, operar em uma linguagem diferente da do sistema. Quando um projeto for aberto, o mecanismo 4D detecta o idioma usado pelo arquivo de dados e o fornece ao idioma (modo interpretador ou compilado). As comparações de texto, independentemente de serem realizadas pelo mecanismo de projeto ou pelo idioma, são feitas no mesmo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). Neste caso, a configuração aplica-se a todas as novas bases de dados criadas pela 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. Este algoritmo é semelhante ao usado pelo software de processamento de palavras para determinar os limites ao selecionar uma palavra que é clicada duplo. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Quando esta opção está selecionada, 4D utiliza um algoritmo simplificado. Nessa configuração, qualquer caractere não alfanumérico (ou seja, que não seja uma letra ou um número) é considerado um separador de palavras-chave. Essa configuração atende a requisitos específicos associados a determinados idiomas, como o japonês. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. #### Compatibilidade do MeCab (versão japonesa) @@ -82,7 +96,7 @@ Você usa as configurações nesta aba para configurar a memória em cache para ### Parâmetros da cache do banco de dados - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Esse valor é aumentado para otimização quando outros aplicativos são executados na mesma máquina que a 4D. - **Percentage of available memory used for cache**: Percentage of the remaining memory allocated to the cache by default.\ @@ -98,11 +112,11 @@ Você usa as configurações nesta aba para configurar a memória em cache para ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). O tamanho do cache de memória que você inserir será reservado para o banco de dados 4D, independentemente do estado dos recursos da máquina. Esta configuração pode ser usada em certas configurações específicas, ou quando a base de dados é projetada para ser usada em sistemas diferentes em termos de memória. Geralmente, a cache adaptativa oferece um melhor desempenho. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D salva os dados colocados no cache em intervalos regulares. Você pode especificar qualquer intervalo de tempo entre 1 segundo e 500 minutos. Por padrão, 4D salva seus dados a cada 20 segundos. O aplicativo também salva seus dados em disco toda vez que você alterar para outro ambiente ou sair do aplicativo. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Quando você antecipar uma entrada de dados pesada, considere definir um curto intervalo de tempo entre saves. Em caso de falha de poder, você só perderá os dados inseridos desde o salvamento anterior (se o banco de dados estiver sendo executado sem um arquivo de log). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/interface.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/interface.md index 98a3fb3bb2f38d..d2a30f191995bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/interface.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/interface.md @@ -23,9 +23,9 @@ A fonte padrão e seu tamanho dependem da plataforma onde 4D está sendo executa Outras opções configuram a exibição de várias janelas no modo Aplicativo. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Esse menu permite que você selecione o esquema de cores a ser usado no nível d Os seguintes esquemas estão disponíveis: - - **Light**: the application will use the Default Light Theme +- **Light**: the application will use the Default Light Theme ![](../assets/en/settings/light-appearance.png) - - **Escuro**: o aplicativo irá usar o Tema Escuro Padrão +- **Escuro**: o aplicativo irá usar o Tema Escuro Padrão ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Os temas predefinidos podem ser tratados com CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). O esquema de aplicação principal será aplicado aos formulários por defeito. No entanto, ele pode ser substituído: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atalhos @@ -72,9 +72,9 @@ Você usa a área de atalhos para visualizar e modificar atalhos padrão para tr Os atalhos predefinidos são os seguintes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece a seguinte caixa de diálogo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/security.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/security.md index 5dc652ca0b495d..eb49da34e62255 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/security.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/security.md @@ -11,7 +11,7 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa > Essas configurações não se aplicam às bases de dados do projeto abertas no modo de usuário único. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. Esta opção simplifica o acesso ao banco de dados, mantendo um sistema completo de controle de dados. - Se você associou uma senha ao usuário padrão, uma caixa de diálogo aparece quando o banco de dados está aberto e os usuários devem inserir uma senha. - If you haven't associated a password with the Default User, the User Identification dialog box will not appear.**Note:** You can "force" the display of the User Identification dialog box when the "Default User" mode is active, for instance in order to connect as Administrator or Designer. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. ## Opções - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. Você pode remover completamente ou parcialmente esta filtragem usando as seguintes opções. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Ele pode ser usado para definir um modo de acesso ilimitado para comandos e métodos, enquanto permanece no controle das operações realizadas. Durante a fase de desenvolvimento, este modo pode ser usado para testar livremente todas as fórmulas, relatórios e assim por diante. Durante a operação, pode ser usado para configurar soluções seguras que permitam o acesso a comandos e métodos temporários. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Quando esta opção estiver marcada, os usuários terão acesso a todos os comandos 4D e plug-ins, bem como a todos os métodos do projeto (exceto para os invisíveis). **Nota:** esta opção tem prioridade sobre o comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Quando está selecionado, este comando não faz nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. Quando esta opção está seleccionada: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/settings/web.md b/i18n/pt/docusaurus-plugin-content-docs/current/settings/web.md index cbd30411c50f52..b168ac370a8300 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/web.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/web.md @@ -78,9 +78,9 @@ Quando esta opção é selecionada, o servidor web não fornece nenhum suporte e Neste modo, pode configurar parâmetros do servidor Web adicionais: - - [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) - - [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) - - [Usar processos preemptivos](#use-preemptive-processes) +- [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) +- [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) +- [Usar processos preemptivos](#use-preemptive-processes) #### Sessões herdadas (sessões de processo único) @@ -160,9 +160,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D O menu de formato do histórico oferece as seguintes opções: - - **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. +- **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. - - **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ +- **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ host rfc931 usuário [DD/MMM/AAAA:HH:MM:SS] "solicitação" estado tamanho\ Cada campo é separado por um espaço e cada linha termina com a sequência CR/LF (caractere 13, caractere 10). @@ -173,9 +173,9 @@ O menu de formato do histórico oferece as seguintes opções: > A data e a hora são locais para o servidor. - - petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) - - estado: resposta dada pelo servidor. - - length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. +- petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) +- estado: resposta dada pelo servidor. +- length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. > **Nota:** Por razões de desempenho, as operações são salvas em um buffer de memória em pacotes de 1Kb antes de serem escritas em disco. As operações também são gravadas no disco se nenhuma solicitação tiver sido enviada a cada 5 segundos. > Os valores possíveis de estado são os seguintes: @@ -189,16 +189,16 @@ O menu de formato do histórico oferece as seguintes opções: > 500: Internal error > O formato CLF não pode ser personalizado. - - **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. +- **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. - Referer: contém o URL da página que aponta para o documento solicitado. - User-agent: contém o nome e a versão do navegador ou software cliente que origina a solicitação. > O formato DLF não pode ser personalizado. - - **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. +- **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. - - **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. +- **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. **Configuração dos campos** Quando você escolhe o formato ELF (Extended Log Format) ou WLF (WebStar Log Format), a área "Weg Log Token Selection" exibe os campos disponíveis para o formato escolhido. Você precisará selecionar cada campo a ser incluído no registro. You will need to select each field to be included in the log. To do so, check the desired fields. @@ -238,14 +238,14 @@ A tabela a seguir lista os campos disponíveis para cada formato (em ordem alfab Configure the automatic backup parameters for the request log. Configure the automatic backup parameters for the request log. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. > No caso de backups programados, se o servidor Web não foi iniciado quando o backup estava programado para ocorrer, na próxima inicialização o 4D considera o backup como falho e aplica as configurações apropriadas, definidas nas Propriedades. @@ -259,9 +259,9 @@ Para obter mais informações sobre o suporte de serviços da Web em 4D, consult Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" de serviços da Web, ou seja, a publicação de métodos projeto na forma de serviços Web. - - **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. - - **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. - - **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. +- **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. +- **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. > Em conformidade com o padrão XML para nomes de etiquetas, as cadeias de caracteres usadas não devem conter espaços nem começar com um número. Além disso, para evitar qualquer risco de incompatibilidade, recomendamos que você não use nenhum caractere estendido (como caracteres acentuados). @@ -269,7 +269,7 @@ Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" Essa área contém várias opções relacionadas ao uso de 4D como um "cliente" de serviços Web, ou seja, a assinatura de serviços publicados na rede. - - **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". +- **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". ## Funcionalidades Web @@ -303,9 +303,9 @@ Esse botão só está disponível em projetos abertos com a aplicação 4D (usu O botão aciona a seguinte sequência de atualização: - - O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. - - O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). - - Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. +- O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. +- O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). +- Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. Lembre-se de reiniciar seu projeto após realizar essa atualização. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md index ff6661f192e020..51b288575d7208 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/ClassClass.md @@ -160,8 +160,8 @@ Você pode passar um ou mais parâmetros *param* opcionais, que serão passados :::note Notas - - Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. - - Se `.new()` for chamado em uma classe inexistente, será retornado um erro. +- Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. +- Se `.new()` for chamado em uma classe inexistente, será retornado um erro. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/Document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/Document.md index e7f4dff58d6d8f..d474fd0e038e34 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/Document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/Document.md @@ -320,8 +320,8 @@ Essa propriedade é **somente leitura**. A propriedade `.original` retorna o elemento de destino para um alias, um atalho ou um arquivo de link simbólico. O elemento alvo pode ser: - - um objeto File - - um objeto folder +- um objeto File +- um objeto folder Para arquivos não-alias, a propriedade retorna o mesmo objeto de arquivo que o arquivo. @@ -585,8 +585,8 @@ A função `.getText()` retorna o conte Opcionalmente, você pode designar o conjunto de caracteres a ser usado na leitura do conteúdo. Você pode passar também: - - em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), - - ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. +- em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), +- ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. > Para a lista de conjuntos de caracteres suportados por 4D, consulte a descrição do comando `CONVERT FROM TEXT`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md index d97d156a01306b..b0cd758b8cf48d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Um objeto 4D.OutgoingMessage é um objeto [não compartilhável](../Concepts/sha A propriedade `.body` contém o corpo da mensagem enviada. Os seguintes tipos de dados são suportados na propriedade `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image A propriedade `.body` é de leitura e gravação. @@ -108,17 +108,17 @@ A função `.setBody()` defi Os seguintes tipos de dados são suportados no *corpo*: - - Text - - Blob - - Object - - Imagem +- Text +- Blob +- Object +- Imagem Quando essa função é usada, o cabeçalho do tipo de conteúdo é definido automaticamente dependendo do tipo *corpo*: - - Content-Type:text/plain se o corpo é um Texto - - Content-Type:application/octet-stream se o corpo é um Blob - - Content-Type:application/json se o corpo é um objeto - - Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem +- Content-Type:text/plain se o corpo é um Texto +- Content-Type:application/octet-stream se o corpo é um Blob +- Content-Type:application/json se o corpo é um objeto +- Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem Se *body* não for de um tipo de valor suportado, um erro é retornado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md index 293adb31fe2f7b..6e63bfc3fc3252 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ A propriedade `.keepAlive` contém diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md index dd7aafb18a323c..2a60234db4134e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Os objetos de sessão são retornados pelo comando [`Session`](../commands/session.md). Esses objetos fornecem ao desenvolvedor uma interface que permite gerenciar a sessão atual do usuário e executar ações como armazenar dados contextuais, compartilhar informações entre processos de sessão, iniciar processos preemptivos relacionados à sessão ou (somente na Web) gerenciar [privilégios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sessão Os seguintes tipos de sessões são suportados por essa classe: @@ -309,6 +318,10 @@ Else End if ``` +#### Veja também + +[*Blog posts about this feature*](https://blog.4d.com/?s=hasPrivilege) + diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md index 99a9c151fa74fa..99994c494a1953 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md @@ -7,10 +7,10 @@ A classe `TCPEvent` fornece informações sobre os eventos que ocorrem durante o
História -| Release | Mudanças | -| ------- | ----------------------------- | -| 20 R9 | Novos atributos `ip` e `port` | -| 20 R8 | Classe adicionada | +| Release | Mudanças | +| ------- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | Classe adicionada |
@@ -20,12 +20,24 @@ Um objeto `TCPEvent` é imutável e não pode ser transmitido. As seguintes propriedades estão disponíveis: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### Descrição + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ Ao trabalhar com conexões TCP/IP de baixo nível, lembre-se de que não há gar - - -## .ip - -**ip** : Text - -#### Descrição - -A propriedade `.ip` contém o endereço IP da máquina remota. - - - ## .port diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md index 333d72bec7ef58..a34ae91a606702 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/UDPEventClass.md @@ -19,34 +19,34 @@ A `UDPEvent` object is immutable and non-streamable. As seguintes propriedades estão disponíveis: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| - + -## .data +## .address -**data**: Blob +**address** : Text #### Descrição -The `.data` property contains the data associated with the event. It is only valid for events of type "data". +The `.address` property contains the IP address of the remote machine. - + -## .ip +## .data -**ip** : Text +**data**: Blob #### Descrição -The `.ip` property contains the IP address of the remote machine. +The `.data` property contains the data associated with the event. It is only valid for events of type "data". diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md index 4b46b5c6dcc890..72094b45cc78fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebFormClass.md @@ -55,8 +55,8 @@ A função `.disableState()` de Essa função não faz nada se: - - o *estado* não está habilitado no momento no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* não está habilitado no momento no formulário Web, +- o *estado* não existe para o formulário Web. Se você [enable](#enablestate) ou desativar vários estados na mesma função de usuário, todas as modificações são enviadas em simultâneo, para o cliente quando a função termina. @@ -80,8 +80,8 @@ A função `.enableState()` ativ Essa função não faz nada se: - - o *estado* já foi ativado no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* já foi ativado no formulário Web, +- o *estado* não existe para o formulário Web. Se você ativar ou [desativar](#disablestate) vários estados dentro da mesma função de usuário, todas as modificações serão enviadas ao mesmo tempo, para o cliente quando a função terminar. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md index f145ad3f0030a5..c63253d649fce3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketClass.md @@ -86,8 +86,8 @@ A função `4D.WebSocket.new()` cria e Em *url*, passe o URL ao qual o servidor WebSocket responderá. Podem ser utilizados os seguintes padrões de URL: - - `ws://host[:port]path[?query]` para ligações padrão - - `wss://host[:port]path[?query]` para conexões TLS seguras +- `ws://host[:port]path[?query]` para ligações padrão +- `wss://host[:port]path[?query]` para conexões TLS seguras Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um erro (que pode ser intersetado através de um método instalado com `ON ERR CALL`). @@ -95,8 +95,8 @@ Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um Em *connectionHandler*, você pode passar um objeto que contém funções de callback a serem chamadas de acordo com eventos de conexão, bem como o tipo de dados e os cabeçalhos a serem tratados. - - As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. - - O WebSocket será válido enquanto o formulário ou o worker não for fechado. +- As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. +- O WebSocket será válido enquanto o formulário ou o worker não for fechado. | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -236,8 +236,8 @@ A função `.terminate()` fecha Em *code*, você pode passar um código de estado explicando porque a conexão está sendo fechada (consulte também [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. - - Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. +- Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. +- Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. Em *reason*, você pode passar uma frase descrevendo porque a conexão está sendo fechada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md index 50a87f6cc1943a..4fd51bb7b34faa 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Consulte também [esta postagem no blog](https://blog.4d.com/new-built-in-websoc Para criar e manipular seu servidor WebSocket em 4D, é preciso usar duas classes embutidas em 4D: - - essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, - - a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. +- essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, +- a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. Além disso, terá de criar duas classes de utilizador que conterão funções de retorno de chamada: - - uma classe de usuário para tratar as ligações ao servidor, - - uma classe de usuário para tratar as mensagens. +- uma classe de usuário para tratar as ligações ao servidor, +- uma classe de usuário para tratar as mensagens. Você deve [criar o servidor WebSocket](#4dwebsocketservernew) em um [worker](../Develop/processes.md#worker-processes) para manter a conexão ativa. @@ -387,8 +387,8 @@ Por padrão, se nenhum valor de *timeout* for definido, a função inicializa o Se um valor *timeout* for definido: - - quando o tempo de espera é alcançado, a força destrói o meio. - - se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. +- quando o tempo de espera é alcançado, a força destrói o meio. +- se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md index 8f64054f66540e..9264cf9add7935 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Precisa configurar o lançamento ao início Pode configurar o servidor web `WebAdmin` para que se lance ao início da aplicação 4D ou 4D Server (antes de que se carregue qualquer projeto). - - Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. +- Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Selecione a opção **Iniciar WebAdmin ao iniciar** na caixa de diálogo de par ![alt-text](../assets/en/Admin/waSettings.png) - - Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: +- Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Quando esta opção for marcada, pode conectar ao servidor web `WebAdmin` atrav **Notas:** - - Conexões com HTTP outras que localhost nunca são aceitas. - - Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. +- Conexões com HTTP outras que localhost nunca são aceitas. +- Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. #### Porta HTTP @@ -95,11 +95,11 @@ Rota da pasta onde o certificado TLS está localizado. Como padrão, a rota da p O estado ou formato do arquivo de registro da petição HTTP (HTTPDebugLog_*nn*.txt, armazenada na pasta "Logs" da aplicação -- *nn* é o número do arquivo). As opções abaixo estão disponíveis: - - **Desactivado** (por defecto) - - **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas - - **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) - - **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições - - **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas +- **Desactivado** (por defecto) +- **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas +- **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) +- **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições +- **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas #### Chave de acesso @@ -109,10 +109,10 @@ A configuração de uma chave de acesso é obrigatória para desbloquear o acess Uma chave de acesso é parecida a uma senha, mas não está associada com um login. - - Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del +- Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. - - Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. +- Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. +- Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. #### Ativar o acesso a Qodly Studio @@ -147,9 +147,9 @@ Exemplo: ## Autenticação e sessão - - Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. +- Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. - - Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente +- Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente Quando o acesso é concedido, uma [sessão web](WebServer/sessions.md) com o privilégio "WebAdmin" é criado na aplicação 4D. Enquanto a sessão atual tiver o privilégio "WebAdmin", o componente `WebAdmin` entrega páginas solicitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md index 038ecc03e9654f..101480c4497149 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar um backup 4D lhe permite restaurar conjuntos inteiros de dados de um banco de dados no caso de que se apresente um incidente, independentemente da causa do mesmo. Podem ocorrer dois tipos principais de incidentes: - - A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: +- A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: - Se a cache estiver vazia, o banco de dados abre normalmente. Quaisquer mudanças feitas no banco de dados foram registradas. Este caso não exige nenhuma operação particular - Se a cache conter operações, o arquivo de dados está intacto mas exige integrar o arquivo de histórico atual. - Se a cache estiver no processo de ser escrita, o arquivo de dados está provavelmente danificado. When restoring a backup and integrating the current log file in a encrypted database: - - A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. +- A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. > 4D pode lançar procedimentos automaticamente para recuperar os bancos de dados depois de um incidente. Esses mecanismos são gerenciados usando duas opções disponíveis na página **Backup/Backup & Restore** das Configurações. Para obter mais informações, consulte o parágrafo [Restaurador automático](settings.md#automatic-restore-and-log-integration).\ > Se o incidente for resultado de uma operação inadequada realizada nos dados (eliminação de um registro, por exemplo), você pode tentar reparar o arquivo de dados usando a função "rollback" no arquivo de log. Esta função está disponível na página [Rollback](MSC/rollback.md) do MSC. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md index e2a56805ae3b0f..d735cf33ca5f90 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Backup/settings.md @@ -5,9 +5,9 @@ title: Backups periódicos As configurações de backup são definidas através de três páginas na [caixa de diálogo Configurações](../settings/overview.md). Pode estabelecer: - - a periodicidade das cópias de segurança automáticas - - os arquivos a incluir em cada backup - - as funcionalidades avançadas que permitem executar tarefas automáticas +- a periodicidade das cópias de segurança automáticas +- os arquivos a incluir em cada backup +- as funcionalidades avançadas que permitem executar tarefas automáticas > As propriedades definidas nesta caixa de diálogo são escritas no arquivo *Backup.4DSettings*, guardado na pasta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ As configurações de backup do agendador são definidas na página **Backup/Per As opções encontradas nessa aba permitem estabelecer e configurar as cópias de segurança automáticas programadas do banco de dados. Pode escolher uma configuração rápida padrão ou pode personalizá-la completamente. Várias opções aparecem dependendo da escolha feita no menu **Backup automático**: - - **Nunca**: A função de cópia de segurança agendada está inativa. - - **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. - - **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. - - **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. - - **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: +- **Nunca**: A função de cópia de segurança agendada está inativa. +- **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. +- **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. +- **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. +- **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: - **Cada X hora(s)**: Permite programar as cópias de segurança com frequência horária. Pode digitar um valor entre 1 e 24. * **Todos os X dia(s) no x**: permite backups de programação diariamente. Por exemplo, introduza 1 se quiser realizar uma cópia de segurança diária. Quando esta opção estiver marcada, deve digitar a hora quando o backup deve começar. * **A cada X semana(s) no x**: permite backups de programação semanais. Digite 1 se quiser realizar o backup 1 vez por semana. Quando essa opção estiver marcada, deve digitar o dia da semana e a hora em que quer começar o backup. Pode selecionar vários dias da semana se quiser. Por exemplo. pode usar essa opção para estabelecer dois backups por semana: um nas quartas feiras e outro nas sextas. @@ -48,12 +48,12 @@ A página Cópia de segurança| Configuração das propriedades do banco de dado Essa área lhe permite determinar quais os arquivos ou pastas que devem ser copiados durante o backup. - - **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. +- **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. - o arquivo de histórico atual da aplicação (se houver), - a pasta `Settings` completa localizada [ao lado do arquivo de dados](../Project/architecture.md#settings-user-data) (se existir), ou seja, os *parâmetros usuário para os dados*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. - - **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* - - **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". +- **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. +- **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* +- **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". - **Eliminar**: retira o arquivo selecionado da lista de arquivos anexos. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar uma pasta para adicionar à cópia de segurança. No caso de uma restauração, a pasta vai recuperar sua estrutura interna. Pode selecionar toda pasta ou volume conectado à máquina, exceto a pasta que conter os arquivos do banco de dados. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar um arquivo para adicionar à cópia de segurança. @@ -82,19 +82,19 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus ### Parâmetros gerais - - **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). +- **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). Se, por exemplo, o número de conjuntos se definir como 3, as três primeiras cópias de segurança criam os arquivos MyBase-0001, MyBase-0002 e MyBase-0003 respectivamente. Durante o quarto backup, o arquivo MyBase-0004 é criado e MyBase-0001 é apagado. Como padrão, o mecanismo de eliminação de conjuntos está ativado e 4D salva 3 conjuntos de cópias de segurança. Para desativar o mecanismo, simplesmente desmarque a opção. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. +- **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. +- **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. - - **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. +- **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. - **Tente novamente na próxima data e hora agendadas**: essa opção só faz sentido quando trabalhar com backups automáticos programados. Equivale a anular a cópia de segurança que falhou. Um erro é gerado. - **Tentar novamente após X segundo(s), minuto(s) ou hora(s)**: Quando esta opção é marcada, uma nova tentativa de backup é executada após o período de espera. Este mecanismo permite antecipar certas circunstancias que possam bloquear a cópia de segurança. Pode estabelecer um período de espera em segundos, minutos ou horas utilizando o menu correspondente. Se a nova tentativa também falhar, um erro é gerado e a falha é notada na área de status do último backup e no arquivo de histórico de backup. - **Cancele a operação após X tentativas**: Este parâmetro é usado para definir o número máximo de tentativas de backup falhadas. Se o backup não tiver sido realizado com sucesso depois do número máximo de tentativas estabelecido tiver sido alcançado, ele será cancelado e o erro 1401 é gerado ("Número máximo de tentativas de backup foi alcançado; backup automático foi desativado temporariamente"). Nesse caso, não se fará mais backups automáticos até que a aplicação seja reiniciada ou um backup manual se realize com sucesso. @@ -106,17 +106,17 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus Essas opções se aplicam aos arquivos de cópia de segurança principais e aos arquivos de cópia de segurança do histórico. - - **Tamanho do Segmento (Mb)** +- **Tamanho do Segmento (Mb)** 4D permite que você segmente arquivos, ou seja, para cortá-lo em tamanhos menores. Esse funcionamento permite, por exemplo, armazenar uma cópia de segurança em vários discos diferentes (DVD, dispositivos usb pendrive, etc). Durante a restauração, 4D vai fusionar automaticamente os segmentos. Segment Size (Mb) 4D allows you to segment archives, i.e., to cut it up into smaller sizes. This behavior allows, for example, the storing of a backup on several different disks (DVDs, usb devices, etc.). O menu **Tamanho do Segmento** é uma caixa de combinação que permite que você defina o tamanho em MB para cada segmento do backup. Pode escolher um dos tamanhos pré-estabelecidos ou digitar um tamanho específico entre 0 e 2048. Se você passar 0, nenhum segmento ocorre (isso é o equivalente a passar **Nenhum**). - - **Taxa de Compressão** +- **Taxa de Compressão** Por padrão, o 4D comprime os backups para ajudar a economizar espaço em disco. Entretanto, a fase de compressão de arquivo pode retardar o processo de backup quando lidar com grandes volumes de dados. A opção **Taxa de Compressão** permite ajustar a compressão de arquivo: - **Nenhum:** Não se aplica compressão de arquivos. O backup é mais rápido, mas os arquivos são bem maiores. - **Rápido** (padrão): Essa opção é um compromisso entre a velocidade de backup e tamanho de arquivo. - **Compact**: A taxa máxima de compressão é aplicada aos arquivos. Os arquivos ocupam o mínimo espaço possível no disco, mas o backup é mais lento. - - **Taxa de Interlúção e Taxa de Redundância** +- **Taxa de Interlúção e Taxa de Redundância** 4D gera arquivos usando algoritmos específicos que são baseados nos mecanismos de otimização (intercrição) e segurança (redundância). Pode estabelecer esses mecanismos de acordo com suas necessidades. Os menus para essas opções contêm as taxas **Baixo**, **Médio**, **Alto** e **Nenhum** (padrão). - **Taxa de Entrelaçamento**: O Interlacing consiste de armazenar dados em setores não adjacentes para limitar riscos no caso de danos de setor. Quanto maior a taxa, maior a segurança; entretanto, o processamento de dados usa mais memória. - **Taxa de redundância**: Redundância permite a segurança de dados presentes em um arquivo ao repetir a mesma informação várias vezes. Quanto maior a taxa de redundância, melhor a segurança, mas o armazenamento é mais lento e o tamanho dos arquivos aumenta. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md index 76c18a41d5c4ea..5dbb7ed4bddc3f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/operators.md @@ -11,8 +11,8 @@ A linguagem 4D suporta os operadores que talvez já conheça de outras linguagen A linguagem 4D suporta operadores **binários** e **ternários**: - - Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. - - os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). +- Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. +- os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). Os valores que os operadores afectam são os operandos. Na expressão `1 + 2`, o símbolo + é um operador binário e seus dois operandos são os valores 1 e 2. @@ -33,18 +33,18 @@ $col:=New collection //$col é inicializado com uma coleção vazia Os resultados do operador dependem dos **tipos de dados** aos quais são aplicados. 4D suporta diferentes operadores em tipos de dados escalares. São descritos com os tipos de dados, nas secções seguintes: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) - - [**Operadores de data**](dt_date.md#operadores-de-data) - - [**Operadores de tempo**](dt_time.md#operadores-de-tempo) - - [**Operadores de números**](dt_number.md#number-operators) - - [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) - - [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) - - [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) - - [**Operadores de string**](dt_string.md#string-operators) - - [**Operadores nas referências de objetos**](dt_object.md#object-operators) - - [**Operadores de referência de coleção**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) +- [**Operadores de data**](dt_date.md#operadores-de-data) +- [**Operadores de tempo**](dt_time.md#operadores-de-tempo) +- [**Operadores de números**](dt_number.md#number-operators) +- [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) +- [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) +- [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) +- [**Operadores de string**](dt_string.md#string-operators) +- [**Operadores nas referências de objetos**](dt_object.md#object-operators) +- [**Operadores de referência de coleção**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) ## Operadores de atribuição compostos @@ -272,9 +272,9 @@ O operador condicional ternário permite-lhe escrever expressões condicionais d Aceita três operandos na seguinte ordem: - - uma condição seguida de um ponto de interrogação (?) - - uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) - - uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) +- uma condição seguida de um ponto de interrogação (?) +- uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) +- uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) ### Sintaxe @@ -325,21 +325,21 @@ Para além de um tipo, cada valor tem também um valor booliano inerente, geralm Os seguintes valores são falsy\*\*: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Empty strings - - [] - Colecções vazias - - {} - Objectos vazios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Empty strings +- [] - Colecções vazias +- {} - Objectos vazios Todos os outros valores são considerados **verdadeiros**, inclusive: - - 0 - zero numérico (inteiro ou não) +- 0 - zero numérico (inteiro ou não) Em 4D, a avaliação **verdadeira** e **falsa** reflete a **utilização** de um valor, o que significa que um valor verdadeiro existe e pode ser processado pelo código sem gerar erros ou resultados inesperados. A lógica por trás disso é fornecer uma maneira conveniente de lidar com valores *undefined* e *null* em objetos e coleções, de modo que um número reduzido de instruções [If…Else](flow-control.md#ifelseend-if) seja necessário para evitar erros de tempo de execução. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md index af79891afd9132..9ffc9beea3d801 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Concepts/variables.md @@ -53,8 +53,8 @@ Essa sintaxe só é compatível com declarações de [variáveis locais e de pro `varType` pode ser: - - um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, - - uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. +- um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, +- uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. Se `varType` for omitido, será criada uma variável do tipo **variant**. @@ -86,7 +86,7 @@ A sintaxe legada usando comandos `C_XXX` está obsoleta a partir de 4D 20 R7. ### Exemplos - - Para declarar variáveis básicas locais e de processo: +- Para declarar variáveis básicas locais e de processo: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D. Object //also equivalent to C_OBJECT($o) ``` - - Para declarar variáveis objeto da classe 4D: +- Para declarar variáveis objeto da classe 4D: ```4d var $myFolder : 4D. Folder var $myFile : 4D. File ``` - - Para declarar as variáveis objeto da classe usuário: +- Para declarar as variáveis objeto da classe usuário: ```4d var $myClass : cs. MyClass @@ -193,9 +193,9 @@ Uma variável local é, como o seu nome indica, local para um método - apenas a Poderá querer utilizar uma variável local para: - - Evitar conflitos com os nomes de outras variáveis - - Utilizar dados temporariamente - - Reduzir o número de variáveis do processo +- Evitar conflitos com os nomes de outras variáveis +- Utilizar dados temporariamente +- Reduzir o número de variáveis do processo O nome de uma variável local começa sempre com um sinal de dólar ($) e pode conter até 31 caracteres adicionais. Se introduzir um nome mais longo, 4D trunca o nome com o comprimento apropriado. @@ -224,9 +224,9 @@ No modo interpretado, as variáveis são mantidas dinamicamente; são criadas e Um processo pode "espiar e cutucar" as variáveis de processo de outro processo usando os comandos `GET PROCESS VARIABLE` e `SET PROCESS VARIABLE`. É boa prática de programação restringir a utilização destes comandos à situação para a qual foram adicionados à 4D: - - Comunicação interprocessada em locais específicos ou o seu código - - Gestão de arrastar e soltar entre processos - - Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor +- Comunicação interprocessada em locais específicos ou o seu código +- Gestão de arrastar e soltar entre processos +- Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor Para obter mais informações, consulte o capítulo **Processos** e a descrição desses comandos. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md index b9adc187e15af2..a363bac2f9beb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, pode não haver memória suficiente para criar um BLOB. Ou, quan Estes são geralmente o tipo de erro mais difícil de encontrar. Com exceção dos erros de digitação, todos os tipos de erros acima enumerados são, em certa medida, abrangidos pela expressão "erro de conceção ou de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por exemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Os erros de concepção ou lógicos incluem também situações como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. Por vezes, a parte do código que apresenta o erro pode ser diferente do código que está efetivamente na origem do problema. @@ -55,8 +55,8 @@ Para encontrar rapidamente a origem do problema, reabrir a versão interpretada A janela erro de sintaxe aparece automaticamente quando a execução de um método é interrompida. Isto pode acontecer quando: - - um erro impede a continuação da execução do código - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- um erro impede a continuação da execução do código +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ A área de texto superior apresenta uma mensagem que descreve o erro. A área de A janela de erro de sintaxe propõe várias opções: - - **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. +- **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. +- **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. :::tip @@ -76,14 +76,14 @@ Para ignorar um erro que ocorre repetidamente (por exemplo, em loops), você pod ::: - - **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: +- **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: - Se um método formulário ou um método objeto estiver a ser executado em resposta a um evento, é interrompido e o usuário regressa ao formulário. - Se o método estiver sendo executado a partir do ambiente Application, o usuário regressa a esse ambiente. - - **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. +- **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. - - **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. +- **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. ## Depurador diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md index 1d355a3f174921..e3bee4751d7585 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Desktop/clientServer.md @@ -71,7 +71,7 @@ Quando uma atualização . versão dz do projeto foi produzida em 4D Server, má Quando o 4D se conectar a um Servidor 4D na mesma máquina, a aplicação se comporta como 4D em modo de usuário único e o ambiente de design permite que você edite os arquivos do projeto. Esse recurso permite que você desenvolva uma aplicação de cliente/servidor no mesmo contexto que o contexto de implantação. -> Quando o 4D se conecta a um 4D Server na mesma máquina, o **modo de desenvolvimento** é ativado automaticamente, independentemente do status da [opção de abertura](#opening-a-remote-project). +> When 4D connects to a 4D Server on the same machine, the **development mode** is automatically activated, whatever the [Activate development mode](#opening-a-remote-project) option status. Cada vez que o 4D realiza uma ação **Salvar tudo** no ambiente de design (explicitamente no menu **Arquivo** ou implicitamente ao alternar para o modo de aplicativo, por exemplo), o 4D Server recarrega sincronizadamente os arquivos do projeto. O 4D espera o servidor 4D terminar de recarregar os arquivos do projeto antes de continuar. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md index 704ebdc0162f49..556bb6af1296b0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento pode ser usado para filtrar a entrada de dados nos objetos digitáve Quando é usado, este evento é gerado após cada alteração feita no conteúdo de um objeto inserível, independentemente da ação que causou a alteração, *ou seja*: - - Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; - - Eliminar um valor (ação semelhante a colar); - - Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. - - Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). +- Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; +- Eliminar um valor (ação semelhante a colar); +- Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. +- Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). No evento `No After Edit`, os dados de texto sendo inseridos são retornados pelo comando [`Obter texto editado`](../commands-legacy/get-edited-text.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md index ad1fefab5585b6..6bee42c9714cb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ O evento `Ao Começar Arrastar Novo` pode ser selecionado para quaisquer objetos O evento `On Begin Drag Over` é útil para preparar a ação de arrastar. Pode ser usado para: - - Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). - - Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). - - Accept or refuse dragging via the result of the method of the dragged object. +- Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). +- Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). +- Accept or refuse dragging via the result of the method of the dragged object. - To indicate that drag actions are accepted, the method of the source object must return 0 (zero). - To indicate that drag actions are refused, the method of the source object must return -1 (minus one). - Se nenhum resultado for retornado, 4D considera que as ações de arrastar são aceitas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md index 1360748863f4b4..7584b63ca7234e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. No entanto, há várias excepções: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md index e6e64421975ec5..2f5c15447aacbe 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Um registro está prestes a ser exibido em um formulário de lista exibido via ` Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada registo: +- Para cada registo: - Para cada objecto na área de detalhes: - Método objecto com o evento `On Display Detail` - Método formulário com o evento `On Display Detail` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md index e91261464d1b11..3e97f1006409be 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over O evento `Ao Arrastar Para` é repetidamente enviado para o objeto de destino quando o ponteiro do mouse é movido sobre o objeto. Em resposta a este evento, normalmente: - - Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). - - Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. +- Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). +- Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. Para **aceitar** a arraste, o método objeto de destino deve retornar 0 (zero). Para **rejeitar** o arraste, o método objeto deve retornar -1 (menos um). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md index e5dad3403346ed..b45956f76b1c66 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada objecto na área do cabeçalho: +- Para cada objecto na área do cabeçalho: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md index 8539316186b800..8fb9d7da298645 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Esse evento é gerado quando ocorre um clique no cabeçalho de uma coluna de lis Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) tiver sido selecionada para o list box, você poderá decidir se autoriza ou não uma classificação padrão da coluna passando o valor 0, ou -1 na variável `$0`: - - Se `$0` for igual a 0, é efetuada uma ordenação padrão. - - Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. +- Se `$0` for igual a 0, é efetuada uma ordenação padrão. +- Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) não estiver selecionada para o list box, a variável `$0` não será usada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md index f98382730ba66b..67a39c8d81d25d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/forms.md @@ -9,16 +9,16 @@ Os formulários constituem a interface através da qual a informação é introd Os formulários também podem conter outros formulários através das seguintes funcionalidades: - - [objetos de subformulário](FormObjects/subform_overview.md) - - [formulários herdados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulário](FormObjects/subform_overview.md) +- [formulários herdados](./properties_FormProperties.md#inherited-form-name) ## Criar formulários É possível adicionar ou modificar formulários 4D usando os seguintes elementos: - - **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. - - **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. - - **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: +- **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. +- **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. +- **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: ``` { @@ -70,9 +70,9 @@ Os formulários também podem conter outros formulários através das seguintes Existem duas categorias de formulários: - - **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. +- **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. - - **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. +- **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. Normalmente, você seleciona a categoria do formulário quando o cria, mas pode alterá-la posteriormente. @@ -80,15 +80,15 @@ Normalmente, você seleciona a categoria do formulário quando o cria, mas pode Cada formulário é composto por, pelo menos, duas páginas: - - uma página 1: uma página principal, exibida por defeito - - uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. +- uma página 1: uma página principal, exibida por defeito +- uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. É possível criar várias páginas para um formulário de entrada. Se você tiver mais campos ou variáveis do que cabem em uma tela, você pode querer criar páginas adicionais para exibi-los. As páginas múltiplas permitem-lhe fazer o seguinte: - - Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. - - Organize cada tópico na sua própria página. - - Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). - - Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. +- Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. +- Organize cada tópico na sua própria página. +- Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). +- Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. As páginas múltiplas são uma conveniência utilizada apenas para formulários de introdução. Não são para produção impressa. Quando um formulário de várias páginas é impresso, apenas a primeira página é impressa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md index 1976dfab5cc6e9..50c036cfa4e172 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/macros.md @@ -7,11 +7,11 @@ O editor de formulários 4D suporta macros. Uma macro é um conjunto de instruç Por exemplo, se você tiver um relatório recorrente com formatação específica (por exemplo, determinado texto deve aparecer em vermelho e determinado texto deve aparecer em verde), poderá criar uma macro para definir automaticamente a cor. É possível criar macros para o editor de 4D Form que podem: - - Criar e executar código 4D - - Exibir diálogos - - Seleccionar objectos do formulário - - Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades - - Modificar ficheiros de projeto (atualizar, apagar) +- Criar e executar código 4D +- Exibir diálogos +- Seleccionar objectos do formulário +- Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades +- Modificar ficheiros de projeto (atualizar, apagar) O código de macros suporta [funções de classe](Concepts/classes.md) e [propriedades de objeto de formulário em JSON](FormObjects/properties_Reference.md) para permitir que você defina qualquer recurso personalizado no editor de formulários. @@ -237,9 +237,9 @@ Por exemplo, se objectos da página actual e grupos tiverem sido modificados, po Ao lidar com o atributo 'método' de objetos de formulário, você pode definir o valor do atributo de duas maneiras nas macros: - - Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). +- Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). - - Utilizar um objeto com a seguinte estrutura: +- Utilizar um objeto com a seguinte estrutura: | Propriedade | Tipo | Descrição | | ----------- | ---- | ---------------- | @@ -251,9 +251,9 @@ O 4D criará um arquivo usando o nome do objeto na pasta "objectMethods" com o c A propriedade `$4dId` define um ID exclusivo para cada objeto na página atual. Essa chave é usada pelo processador de macro para controlar as alterações em `$result.currentPage`: - - Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. - - Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. - - Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. +- Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. +- Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. +- Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. #### Exemplo @@ -296,8 +296,8 @@ A função `onError` é executada quando o processador de macros encontra um err Ao executar uma macro, se a 4D encontrar um erro que impeça a macro de ser cancelada, ela não executa o macro. É o caso, por exemplo, se a execução de uma macro resultar em: - - eliminar ou modificar um script cujo ficheiro é só de leitura. - - criar dois objectos com o mesmo ID interno. +- eliminar ou modificar um script cujo ficheiro é só de leitura. +- criar dois objectos com o mesmo ID interno. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md index f342d25344016c..a1d843a0e5ce70 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Pode utilizar bibliotecas de objectos nos seus formulários. Uma biblioteca de o 4D propõe dois tipos de bibliotecas de objetos: - - uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. - - as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. +- uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. +- as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. ## Criar e utilizar bibliotecas de objetos personalizadas @@ -21,10 +21,10 @@ A biblioteca é apresentada numa janela separada: A janela tem as seguintes características principais: - - Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. - - Você pode filtrar o conteúdo da janela usando o menu **Categorias**: +- Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. +- Você pode filtrar o conteúdo da janela usando o menu **Categorias**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar um objeto da biblioteca no seu formulário, pode: +- Para utilizar um objeto da biblioteca no seu formulário, pode: - clicar com o botão direito do rato num objeto e selecionar **Copiar** no menu contextual - ou arraste e solte o objeto da biblioteca. O objeto é então adicionado ao formulário. @@ -57,13 +57,13 @@ Uma determinada biblioteca de objetos só pode ser aberta por um m banco de dado Para abrir uma biblioteca de objetos personalizada, selecione o comando **Open>Object Library...** no menu 4D **File** ou na barra de ferramentas. Aparece uma caixa de diálogo padrão de ficheiro aberto, que lhe permite seleccionar a biblioteca de objectos a abrir. Pode seleccionar os seguintes tipos de ficheiros: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Na realidade, as bibliotecas de objectos personalizados são projectos 4D clássicos. Apenas as seguintes partes de um projecto são expostas quando este é aberto como biblioteca: - - formulários projecto - - páginas formulário 1 +- formulários projecto +- páginas formulário 1 ### Construir uma biblioteca de objectos @@ -75,10 +75,10 @@ As operações básicas estão disponíveis no menu de contexto ou no menu de op ![](../assets/en/FormEditor/library5.png) - - **Cortar** ou **Copiar** para a área de transferência - - **Colar** um objeto da área de transferência - - **Clear** - exclui o objeto da biblioteca - - **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. +- **Cortar** ou **Copiar** para a área de transferência +- **Colar** um objeto da área de transferência +- **Clear** - exclui o objeto da biblioteca +- **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. Pode colocar objectos individuais (incluindo subformulários) ou conjuntos de objectos numa biblioteca de objectos. Cada objecto ou conjunto é agrupado num único item: @@ -94,9 +94,9 @@ A utilização de copiar-colar ou arrastar-e-soltar com determinados objetos de Segue-se uma lista de objetos dependentes que serão colados na biblioteca enquanto o objeto principal que os utiliza (quando aplicável): - - Listas - - Formatos/Filtros - - Imagens - - Dicas de ajuda (ligadas a um campo) - - Métodos objecto +- Listas +- Formatos/Filtros +- Imagens +- Dicas de ajuda (ligadas a um campo) +- Métodos objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md index a969e5a70ca62e..b3dda5c2e818e6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ As opções de tamanho dependem do valor da opção **Tamanho baseado em**. ## Tamanho baseado em - - **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). +- **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). Você pode escolher essa opção quando quiser usar objetos ativos colocados em uma área fora da tela (ou seja, fora do retângulo delimitador da janela) com uma janela de tamanho automático. Graças a essa opção, a presença desses objetos não modificará o tamanho da janela. - - **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). +- **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). - - ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. +- ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. > Para formulários de saída, somente os campos [**Margem Hor**](#hor-margin) ou [**Largura**](#width) estão disponíveis. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md index a5176f940c12c9..a0fb905fcb3032 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ O usuário constrói e personaliza os seus formulários de aplicação manipulan Os formulários 4D suportam um grande número de objetos **ativos** e **estáticos** incorporados: - - Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. - - Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. +- Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. +- Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. ## Manipulação de objectos de formulário Pode adicionar ou modificar objetos de formulários 4D das seguintes formas: - - **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. +- **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. - - **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. +- **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. - - **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). +- **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). Exemplo de um objeto botão: ```json diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md index d96e75a9aee559..5562a804e07ab3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/input_overview.md @@ -50,6 +50,6 @@ For security reasons, in [multi-style](./properties_Text.md#multi-style) input a Também pode representar expressões de campo e variáveis nos seus formulários utilizando objectos alternativos, mais particularmente: - - Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). - - Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). - - Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). +- Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). +- Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). +- Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md index 903e223d25ed2f..f00c816642e524 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Quando apropriado, o ícone de expansão/colapso é automaticamente apresentado O conteúdo de um objeto formulário lista hierárquica pode ser inicializado de uma das seguintes formas: - - Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. - - Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. +- Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. +- Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. Em ambos os casos, você gerencia uma lista hierárquica em tempo de execução através de sua referência *ListRef*, usando os comandos de [lista hierárquica](../commands/theme/Hierarchical_Lists.md) na linguagem 4D. @@ -34,9 +34,9 @@ $mylist:=New list Cada representação da lista tem suas próprias características específicas e compartilha características comuns com todas as outras representações. As características a seguir são específicas de cada representação da lista: - - A selecção, - - O estado expandido/recolhido dos seus itens, - - A posição do cursor de rolagem. +- A selecção, +- O estado expandido/recolhido dos seus itens, +- A posição do cursor de rolagem. As outras características (fonte, tamanho da fonte, estilo, controle de entrada, cor, conteúdo da lista, ícones, etc.) são comuns a todas as representações e não podem ser modificados separadamente. Consequentemente, quando você usa comandos com base na configuração expandida/colapsada ou no item atual, por exemplo, `Count list items` (quando o parâmetro final `*` não é passado), é importante poder especificar a representação a ser usada sem nenhuma ambiguidade. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Assim como em outros comandos de gerenciamento de propriedades de objetos, é possível usar o caractere "@" no parâmetro `ListName`. Regra geral, esta sintaxe é utilizada para designar um conjunto de objetos no formulário. No entanto, no contexto dos comandos de lista hierárquica, isso não se aplica em todos os casos. Essa sintaxe tem dois efeitos diferentes, dependendo do comando: - - Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." +- Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: +- Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po É possível modificar a aparência de uma lista hierárquica de objetos usando vários comandos 4D genéricos. Você pode passar para esses comandos o nome do objeto da lista hierárquica (usando o parâmetro \*) ou o nome da variável (contendo o valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Lembrete: exceto `OBJECT SET SCROLL POSIÇÃO`, esses comandos modificam todas as representações da mesma lista, mesmo que você especifique apenas uma lista usando seu nome de objeto. @@ -107,8 +107,8 @@ Esse princípio é aplicado independentemente da ordem em que os comandos são c Normalmente, você pode trabalhar de duas maneiras com o conteúdo das listas hierárquicas: por posição ou por referência. - - Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. - - Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. +- Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. +- Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. ### Utilização de números de referência dos items (itemRef) @@ -141,9 +141,9 @@ Basicamente, você precisa lidar com números de referência de itens quando qui Pode controlar se os itens da lista hierárquica podem ser modificados pelo usuário, utilizando o atalho **Alt+click**(Windows) / **Option+click** (macOS), ou fazendo um clique longo no texto do item. - - Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). +- Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). - - Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md index 22d15fa2ac696a..e77d521325fee9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/properties_Subform.md @@ -25,13 +25,13 @@ Especifica se o utilizador pode eliminar sub-registos num subformulário lista. Esta propriedade é utilizada para declarar o formulário detalhado a utilizar no subformulário. Pode ser: - - um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ You can select a component form name when it is published in the component. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. #### Gramática JSON @@ -49,8 +49,8 @@ Esta propriedade é utilizada para declarar o formulário detalhado a utilizar n Ação a ser executada no caso de um clique duplo em uma linha vazia de um subformulário lista. As opções abaixo estão disponíveis: - - Não fazer nada: Ignora o duplo clique. - - Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- Não fazer nada: Ignora o duplo clique. +- Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -74,9 +74,9 @@ Ação a ser executada no caso de um clique duplo em uma linha vazia de um subfo Define a ação a ser executada quando um usuário clica duas vezes em uma linha no subformulário lista. As opções disponíveis são: - - **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. - - **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. +- **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. +- **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. Independentemente da ação selecionada/escolhida, o evento de formulário `On Double clicked` é gerado. @@ -154,10 +154,10 @@ Especifica a tabela a que pertence o subformulário Lista (se existir). Designa a opção que permite aos utilizadores selecionar linhas: - - **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. - - **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ +- **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. +- **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ As teclas de seta para cima e para baixo selecionam a linha anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. O evento de formulário `On Selection Change` é gerado sempre que a linha atual é alterada. - - **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. +- **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Clicar no registro o selecionará, mas não modificará o registro atual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). As teclas de seta para cima e para baixo selecionam o registo anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md index 5e6535494a6135..befe7cdd72f1fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ As formas são [objetos estáticos](formObjects_overview.md#active-and-static-ob As formas 4D suportam as seguintes formas básicas: - - retângulos - - linhas - - ovals +- retângulos +- linhas +- ovals ## Retângulo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md index 00c8677749a98a..c624643b6ed698 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/splitters.md @@ -11,10 +11,10 @@ O divisor é usado, por exemplo, em formulários de saída para que as colunas p Algumas das características gerais do repartidor: - - Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. - - Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. - - As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. +- Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. +- Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. +- As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. Uma vez inserido, o separador aparece como uma linha. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variável pode ser utilizada nos seus métodos objeto e/ou formulário. Seu valor indica a posição atual do divisor, em píxeis, em relação à sua posição inicial. - - Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, - - Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, - - Se o valor for 0: o divisor foi movido para a sua posição original. +- Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, +- Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, +- Se o valor for 0: o divisor foi movido para a sua posição original. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. A movimentação é de fato realizada no final da execução do formulário ou método objeto que contém a declaração. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md index 6f384dcc2668c5..05d1da390e99f9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/stepper.md @@ -13,11 +13,11 @@ Você pode atribuir a variável associada ao objeto a uma área de entrada (camp Um stepper pode ser associado diretamente a uma variável número, hora ou data. - - Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: +- Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. +- Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. > For the stepper to work with a time or date variable, it is imperative to set its type in the form AND to [declare it explicitly](../Concepts/variables.md#declaring-variables) as `Time` or `Date`. @@ -29,8 +29,8 @@ Para mais informações, consulte [Usando indicadores](progressIndicator.md#usin ## Veja também - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md index b472d374fe88ba..e1f1d4853cf367 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Um subformulário é um formulário incluído noutro formulário. Para definir claramente os conceitos implementados com subformulários, aqui estão algumas definições para certos termos utilizados: - - **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. - - **Formulário pai**: um formulário que contém um ou mais subformulários. - - **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. - - **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. - - **Formulário lista**: instância do subformulário exibido como uma lista. - - **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. +- **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. +- **Formulário pai**: um formulário que contém um ou mais subformulários. +- **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. +- **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. +- **Formulário lista**: instância do subformulário exibido como uma lista. +- **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. ## Sub formulários lista @@ -43,8 +43,8 @@ Você pode vincular [uma variável ou uma expressão](properties_Object.md#varia Por padrão, 4D cria uma variável ou expressão de [tipo de objeto](properties_Object.md#expression-type) para um contêiner de subformulário, que lhe permite compartilhar valores no contexto do subformulário usando o comando `Form`. No entanto, você pode usar uma variável ou expressão de qualquer tipo escalar (tempo, inteiro, etc.) especialmente se você só precisa compartilhar um único valor: - - Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. +- Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. ### Sincronização do formulário principal e do subformulário (valor único) @@ -58,8 +58,8 @@ No formulário pai, ambos os objetos (área de entrada e contêiner de subformul To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. O valor do texto deve ter o formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído - - se o subformulário pertence à página formulário atual ou à página 0. +- assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído +- se o subformulário pertence à página formulário atual ou à página 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). Modificar a variável ou expressão vinculada aciona eventos de formulário que permitem sincronizar os valores do formulário pai e do subformulário: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Atualização do conteúdo de um formulário pai @@ -169,8 +169,8 @@ A comunicação entre o formulário pai e as instâncias do subformulário pode 4D implementou os seguintes mecanismos para atender a essas necessidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md index f63a09ee25c6a1..ddfbf5182f546a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/tabControl.md @@ -42,9 +42,9 @@ No macOS, além da posição padrão (superior), os controles de aba também pod Para fornecer as etiquetas para o controle de abas, você pode usar: - - um objeto - - uma lista de escolha - - um array +- um objeto +- uma lista de escolha +- um array ### Utilização de um objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md index 1874c230c87282..b46a43a9cb707f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/FormObjects/text.md @@ -33,9 +33,9 @@ Quando um texto é rodado, pode continuar a alterar o seu tamanho ou posição, ![](../assets/en/FormObjects/staticText2.png) - - Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; - - Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; - - Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. +- Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; +- Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; +- Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md index 0db70ea8c41d72..b580086cf8714d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operação registada no ficheiro de registo aparece como uma linha. As colu Essas informações permitem que você identifique a origem e o contexto de cada operação: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: +- **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: - Abertura de ficheiro de dados: abertura de um ficheiro de dados. - Encerramento do ficheiro de dados: encerramento de um ficheiro de dados aberto. - Criação de um contexto: criação de um processo que especifica um contexto de execução. @@ -30,21 +30,21 @@ Essas informações permitem que você identifique a origem e o contexto de cada - Cancelamento da transação: transação cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ @@ -56,7 +56,7 @@ Essas informações permitem que você identifique a origem e o contexto de cada Only values represented in alphanumeric form are displayed.\ ***Note:** If the database is encrypted and no valid data key corresponding to the open log file has been provided, encrypted values are not displayed in this column.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). O botão Navegar pode ser usado para selecionar e abrir outro arquivo de histórico para o banco de dados. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md index 9e41edffd4dc64..09310d45b91db1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del A área "Registros encontrados no arquivo de dados" inclui duas tabelas que resumem as informações da varredura do arquivo de dados. - - A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: +- A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Os nomes das tabelas atribuídas aparecem automaticamente a verde. Os grupos que não foram atribuídos, ou seja, as tabelas que não puderam ser associadas a nenhum registro, aparecem em vermelho. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por padrão, essa opção é marcada para todos os grupos com registros que podem ser associados a uma tabela. - - A segunda tabela lista as tabelas do ficheiro de projeto. +- A segunda tabela lista as tabelas do ficheiro de projeto. ### Atribuição manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Depois que a reparação terminar, 4D gera um arquivo de histórico na pasta Logs do banco de dados. Este arquivo permite visualizar todas as operações efectuadas. É criado no formato XML e chamado: *DatabaseName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" onde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md index 8f021dcc8bfb44..f40f48cfb91711 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal No editor do Menu, pode introduzir directamente a etiqueta como "hard coded". Ou, pode introduzir uma referência para uma variável ou um elemento XLIFF, o que facilitará a manutenção e tradução das aplicações. Pode utilizar os seguintes tipos de referências: - - Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. A alteração do conteúdo desta variável modificará a etiqueta do menu quando esta for exibida. Neste caso, a etiqueta chamará um recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ A escolha entre associar uma ação padrão ou um método de projecto a um coman É possível atribuir um método de projecto e/ou uma acção padrão a um comando de menu seleccionado no editor de Menu: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Pode adicionar atalhos de teclado a qualquer comando de menu. Se um comando de m También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Isto multiplica o número de atalhos que podem ser utilizados. Os seguintes tipos de atalhos de teclado podem, portanto, ser definidos: - - Em Windows: +- Em Windows: - Ctrl+caractere - Ctrl+Shift+caracter - Ctrl+Alt+caractere - Ctrl+Shift+Alt+caractere - - Em macOS: +- Em macOS: - Comando+caractere - Comando+Shift+caracter - Comando+Opção+característica diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md index f6333f40c722fd..3a5496f09339bc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Notes/updates.md @@ -9,27 +9,27 @@ Leia [**O que há de novo no 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Handling of [ORDA events on data](../ORDA/orda-events.md). - - Nova opção `connectionTimeout` no parâmetro [`options`](../API/TCPConnectionClass.md#options-parameter) da função [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). - - New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. - - Os UUIDs em 4D agora são gerados na **versão 7**. In previous 4D releases, they were generated in version 4. - - New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). - - [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. - - Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. - - 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. - - You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. - - Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). - - Línguagem 4D: +- Handling of [ORDA events on data](../ORDA/orda-events.md). +- Nova opção `connectionTimeout` no parâmetro [`options`](../API/TCPConnectionClass.md#options-parameter) da função [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. +- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. +- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). +- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. +- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. +- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. +- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. +- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- Línguagem 4D: - For consistency, [`Create entity selection`](../commands/create-entity-selection.md) and [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) commands have been moved from the ["4D Environment"](../commands/theme/4D_Environment.md) to the ["Selection"](../commands/theme/Selection.md) themes. - New [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) and [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) commands to assign and read `Formula` objects as data sources for form objects. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) e [`LISTBOX Get property`](../commands/listbox-get-property.md) suporta três novas constantes: `lk current item`, `lk current item position` e `lk selected items expression`. - - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. #### Mudanças de comportamento - - On Windows, current printer fonts intended only for printing (i.e. not usable on screen) are no longer loaded by 4D at startup. - - The *MeCab* library has been removed. This change only affects the processing of Japanese text. - - When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. +- On Windows, current printer fonts intended only for printing (i.e. not usable on screen) are no longer loaded by 4D at startup. +- The *MeCab* library has been removed. This change only affects the processing of Japanese text. +- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. ## 4D 20 R9 @@ -37,20 +37,20 @@ Leia [**O que há de novo no 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - The [*MeCab* library](../settings/database.md#support-of-mecab-japanese-version) is now deprecated and will be removed in the next release. - - Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). - - O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). - - Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. - - Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. - - Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. - - Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. - - Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. - - 4D Write Pro Interface: New [integrated AI](../WritePro/writeprointerface.md#integrated-ai) to interact with **chatGTP** from your 4D Write Pro documents. - - [**Lista de bugs corrigidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs que foram corrigidos no 4D 20 R9. +- The [*MeCab* library](../settings/database.md#support-of-mecab-japanese-version) is now deprecated and will be removed in the next release. +- Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). +- O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). +- Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. +- Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. +- Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. +- Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. +- Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. +- 4D Write Pro Interface: New [integrated AI](../WritePro/writeprointerface.md#integrated-ai) to interact with **chatGTP** from your 4D Write Pro documents. +- [**Lista de bugs corrigidos**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs que foram corrigidos no 4D 20 R9. ## 4D 20 R8 @@ -58,29 +58,29 @@ Leia [**O que há de novo no 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). - - Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). - - Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. - - [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. - - Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#evaluation-application) na caixa de diálogo Criar aplicativo. - - Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. - - Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para registro detalhado de eventos TCP. - - Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. - - 4D Write Pro: +- Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). +- Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). +- Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. +- [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. +- Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#evaluation-application) na caixa de diálogo Criar aplicativo. +- Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. +- Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) para registro detalhado de eventos TCP. +- Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. +- 4D Write Pro: - Os seguintes comandos agora permitem parâmetros, como objetos ou coleções: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Obter atributos](../WritePro/commands/wp-get-attributes.md), [WP REDEFINIR ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [Tabela WP anexa linha](../WritePro/commands/wp-table-append-row.md), [documento de importação do WP](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), e [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md) e [WP Insert break](../WritePro/commands/wp-insert-break.md), agora são funções que retornam intervalos. - Novas expressões relacionadas a atributos de documentos: [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) e [This.pageIndex](../WritePro/managing-formulas.md). - - Línguagem 4D: +- Línguagem 4D: - 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. #### Mudanças de comportamento - - After a log file modification using [`SELECT LOG FILE`](../commands/select-log-file.md) or the [Backup settings](../Backup/settings.md#log-management), the [`New log file`](../commands/new-log-file.md) command now validates the change, without waiting for a backup. The error -4447 (backup required) is no longer raised. - - Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. +- After a log file modification using [`SELECT LOG FILE`](../commands/select-log-file.md) or the [Backup settings](../Backup/settings.md#log-management), the [`New log file`](../commands/new-log-file.md) command now validates the change, without waiting for a backup. The error -4447 (backup required) is no longer raised. +- Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. ## 4D 20 R7 @@ -88,30 +88,30 @@ 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). - - 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#monitoring-project-dependencies). - - Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. - - Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - 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). - - Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. - - Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). - - Línguagem 4D: +- As colunas e cabeçalhos da list box de tipo tempo agora suportam a opção ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- 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#monitoring-project-dependencies). +- Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. +- Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- 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). +- Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. +- Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). +- Línguagem 4D: - Novos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - Novo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) e [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. #### Mudanças de comportamento - - As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. - - 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. - - A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session *describe* privileges are now ignored. +- As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. +- 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. +- A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Session *describe* privileges are now ignored. ## 4D 20 R6 @@ -119,25 +119,25 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) now supports [object and collection references as query values](../API/CollectionClass.md#object-or-collection-reference-as-value). - - Quando um componente tiver um [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), suas classes agora são automaticamente compartilhadas entre todos os componentes carregados no projeto host por meio de [`cs.`](../Concepts/classes.md#cs). - - Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). - - Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. - - Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. - - Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. - - Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. - - Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. - - Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). - - 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, as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. +- Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) now supports [object and collection references as query values](../API/CollectionClass.md#object-or-collection-reference-as-value). +- Quando um componente tiver um [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), suas classes agora são automaticamente compartilhadas entre todos os componentes carregados no projeto host por meio de [`cs.`](../Concepts/classes.md#cs). +- Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). +- Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. +- Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. +- Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. +- Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. +- Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. +- Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). +- 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, as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) 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. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. #### Mudanças de comportamento - - Suporte para perseguir a rolagem nos formulários: subformas pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingiram os limites e o usuário continua rolando usando o mouse ou rastreador (overscrolling). - - A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). +- Suporte para perseguir a rolagem nos formulários: subformas pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingiram os limites e o usuário continua rolando usando o mouse ou rastreador (overscrolling). +- A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). ## 4D 20 R5 @@ -145,21 +145,21 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. - - Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - QUIC network layer now supports [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), and [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). - - Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - 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). - - Novo parâmetro REST [$format](../REST/$format.md). - - O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. +- Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. +- Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- QUIC network layer now supports [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), and [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Soporte de [selecciones de entidades restringidas](../ORDA/entities.md#restricting-entity-selections). +- Soporte de [clases compartidas](../Concepts/classes.md#shared-classes) y de [clases singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- 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). +- Novo parâmetro REST [$format](../REST/$format.md). +- O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. #### 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...) agora são salvas em um arquivo separado chamado `catalog_editor.json` armazenado na pasta [`Sources`](../Project/architecture.md#sources) do projeto. +- 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...) 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 @@ -167,24 +167,24 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. - - As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). - - Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. - - Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). - - Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) - - Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. - - Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. +- Suporte do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. +- As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). +- Direct HTML format for [structure definition exports](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. +- Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). +- Suporte de [formatos personalizados de data e hora](../Project/date-time-formats.md) +- Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. +- Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- 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. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. #### Mudanças de comportamento - - 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/)). - - Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. - - 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. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). +- 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/)). +- Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. +- 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. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -192,21 +192,21 @@ Leia [**O que há de novo no 4D v20 R3**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). - - Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Support for [initializing the variable's value and data type in the declaration line](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) - - Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. +- Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Support of *context* parameter in [`Formula from string`](../commands/formula-from-string.md). +- Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Support for [initializing the variable's value and data type in the declaration line](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) +- Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- 4D View Pro: soporte de la [importación](../ViewPro/commands/vp-import-from-blob) y de la [exportación](../ViewPro/commands/vp-export-to-blob) de documentos 4D View Pro al formato Blob. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. #### Mudanças de comportamento - - Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. A fix has been done, so that the following errors will now be caught also in compiled mode: *Indice out of range*, *Type incompatible*, and *Dereferencing a Null pointer*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). - - 4D não inclui mais um interpretador PHP interno. You need to [set up and run your own PHP interpreter](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) to use PHP commands. +- Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. A fix has been done, so that the following errors will now be caught also in compiled mode: *Indice out of range*, *Type incompatible*, and *Dereferencing a Null pointer*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). +- 4D não inclui mais um interpretador PHP interno. You need to [set up and run your own PHP interpreter](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) to use PHP commands. ## 4D 20 R2 @@ -220,15 +220,15 @@ Se suas aplicações 4D utilizam conexões TLS, é recomendado que você faça a #### Destaques - - Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. - - 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. - - 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. +- Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. +- 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. +- 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 - - **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. +- **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. ## 4D 20.x LTS diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md index e27c3f1f6ae59f..819c0908dd1497 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci In addition, to ensure proper operation of the feature, the following conditions are required: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descrição | | ------------------------------------------------------- | --------------- | ------------------------------------- | @@ -64,8 +64,8 @@ Para ativar o rastreamento de alterações de dados: Em seguida, 4D faz as seguintes alterações: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desativar o rastreamento de alterações de dados: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md index 301229e0669247..019679ca0f66a5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md @@ -87,17 +87,17 @@ Event functions accept a single *event* object as parameter. When the function i This event is triggered each time a value is modified in the entity. - - if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. - - if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. +- if you defined the function at the entity level (first syntax), it is triggered for modifications on any attribute of the entity. +- if you defined the function at the attribute level (second syntax), it is triggered only for modifications on this attribute. This event is triggered as soon as the 4D Server / 4D engine can detect a modification of attribute value which can be due to the following actions: - - in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: +- in **client/server with the [`local` keyword](../ORDA/ordaClasses.md#local-functions)** or in **4D single-user**: - the user sets a value on a 4D form, - the 4D code makes an assignment with the `:=` operator. The event is also triggered in case of self-assignment (`$entity.attribute:=$entity.attribute`). - - in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). - - in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. - - with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) +- in **client/server without the `local` keyword**: some 4D code that makes an assignment with the `:=` operator is [executed on the server](../commands-legacy/execute-on-server.md). +- in **client/server without the `local` keyword**, in **[Qodly application](https://developer.qodly.com/docs)** and **[remote datastore](../commands/open-datastore.md)**: the entity is received on 4D Server while calling an ORDA function (on the entity or with the entity as parameter). It means that you might have to implement a *refresh* or *preview* function on the remote application that sends an ORDA request to the server and triggers the event. +- with the REST server: the value is received on the REST server with a [REST request](../REST/$method.md#methodupdate) (`$method=update`) The function receives an [*event* object](#event-parameter) as parameter. @@ -107,8 +107,8 @@ If this event [throws](../commands-legacy/throw.md) an error, it will not stop t This event is also triggered: - - when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, - - when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). +- when attributes are assigned by the [`constructor()`](./ordaClasses.md#class-constructor-1) event, +- when attributes are edited through the [Data Explorer](../Admin/dataExplorer.md). ::: @@ -143,7 +143,7 @@ Function get sameDay() : Boolean Even though they are very similar, these functions cannot be associated with identical queries because they do not compare the same types of values. The first compares attributes to a given value, while the second compares attributes to each other. - - For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: +- For the *onGoing* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function is simple to write and uses indexed attributes: ```4d Function query onGoing($event : Object) : Object @@ -169,7 +169,7 @@ Function query onGoing($event : Object) : Object return {query: $myQuery; parameters: $parameters} ``` - - For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: +- For the *sameDay* attribute, the [`query`](./ordaClasses.md#function-query-attributename) function requires an ORDA query based on formulas and will be sequential: ```4d Function query sameDay($event : Object) : Text @@ -191,7 +191,7 @@ Function query sameDay($event : Object) : Text ``` - - Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: +- Using a **scalar** *sameDay* attribute updated when other attributes are "touched" will save time: ```4d //BookingEntity class diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md index e389c2e02f27d6..ca01609ba19ce8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ The web session created on the remote datastore is identified using a internal s El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estes princípios são ilustrados nos gráficos seguintes: @@ -29,9 +29,9 @@ Estes princípios são ilustrados nos gráficos seguintes: Os processos que gerenciam sessões para acesso ao armazenamento de dados são mostrados na janela de administração do 4D Server: - - nombre: "REST Handler: \" - - type: type Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- type: type Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. No exemplo a seguir, dois processos estão sendo executados na mesma sessão: @@ -47,11 +47,11 @@ Se uma solicitação for enviada ao repositório de dados remoto depois que a se Os recursos do ORDA relacionados ao bloqueio de entidades e à transação são gerenciados no nível do processo em repositórios de dados remotos, assim como no modo cliente/servidor do ORDA: - - 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. - - 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`). +- 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. +- 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: +- Os bloqueios nas entidades são removidos e as transações são anuladas: - quando o processo é eliminado. - quando a sessão é encerrada no servidor - quando a sessão é encerrada na janela de administração do servidor. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md index bb7415cd78e27b..df8b713e81450d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contém várias opções para configurar o funcionamento geral da s Esta opção permite configurar o ecrã 4D por padrão no arranque, quando o usuário inicia apenas a aplicação. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forçar a apresentação da caixa de diálogo de abertura quando esta opção é selecionada, mantenha premida a tecla **Alt** (Windows) ou **Opção** (macOS) enquanto inicia o projeto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir do macOS Sierra, os aplicativos Mac podem se beneficiar do recurso Auto Você pode se beneficiar desse recurso nos seguintes ambientes (somente com versões 4D de 64 bits): - - Method Editor windows - - Janelas do editor de formulários +- Method Editor windows +- Janelas do editor de formulários Todas as janelas destes editores podem ser colocadas no formulário de tabulação: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Estão disponíveis três opções: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Aparência (somente macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Estão disponíveis três opções: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferência só é suportada no macOS. No Windows, é sempre utilizado o esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de dados...** - - **Base de dados a partir da definição da estrutura...** +- **Base de dados...** +- **Base de dados a partir da definição da estrutura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Ao criar um novo arquivo de dados, o 4D usa o idioma previamente definido nesse Esta área configura o acesso à documentação HTML 4D exibida no seu navegador atual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Língua da documentação @@ -151,8 +151,8 @@ Linguaje da documentação HTML a apresentar. É possível selecionar uma docume Define onde 4D irá procurar por páginas de documentação. - - Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. - - Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. +- Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. +- Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. ### Pasta local diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md index 43a2cc3d6b2cf8..604ff1d4e250d5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite selecionar, criar ou configurar temas do Editor de código. Nesta lista, seleciona o tema a aplicar ao editor de código. São apresentados todos os temas disponíveis, incluindo os temas personalizados (se existirem). 4D fornece dois temas por padrão: - - **Tema Light predefinido** - - **Tema escuro predefinido** +- **Tema Light predefinido** +- **Tema escuro predefinido** > Os temas padrão não podem ser modificados ou eliminados. @@ -38,8 +38,8 @@ Cada tema personalizado se almacena en un único archivo JSON llamado *themeName Definir um tema significa: - - definir um tipo de letra e um tamanho de letra globais para todo o editor de código, - - atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. +- definir um tipo de letra e um tamanho de letra globais para todo o editor de código, +- atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. A combinação de cores e estilos diferentes é particularmente útil para manutenção do código. @@ -83,8 +83,8 @@ Esta página configura as opções de exibição do Editor de código. Permite-lhe desativar/ativar os parâmetros do código "internacional" para a aplicação 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Se modificar esta opção, tem de reiniciar a aplicação 4D para que a alteração seja tida em conta. @@ -138,9 +138,9 @@ Permite-lhe ocultar todos os ícones de expansão/recolhimento por padrão ao ap Permite a inserção automática de () e de chaves de fecho durante a escrita de código. Esta opção controla duas funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Permite a inserção automática de () e de chaves de fecho durante a escrita de Define a sinalização gráfica das chaves correspondentes no código. Esta sinalização aparece sempre que é selecionado um parêntese quadrado, parêntese ou parêntese curvo. As opções abaixo estão disponíveis: - - **Ninguno**: sin señales - - **Retângulo** (padrão): braces cercadas por uma linha preta\ +- **Ninguno**: sin señales +- **Retângulo** (padrão): braces cercadas por uma linha preta\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Destaque de variáveis e campos @@ -162,9 +162,9 @@ Permite destacar todas as ocorrências da mesma variável ou campo numa janela d ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md index 9cebe6d8a23301..cf3a0cd2bfe120 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitetura de um projeto 4D Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta raiz do projeto (pasta de pacotes). Por exemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta A pasta Project contém normalmente a seguinte hierarquia: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Página Métodos` - `Formulários` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` Arquivo de desenvolvimento do projeto, utilizado para designar e lançar o projeto. Esse arquivo pode ser aberto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > Nota: nos projetos 4D, o desenvolvimento se realiza com 4D Developer e o desenvolvimento multiusuários se gerencia através das ferramentas de controle de versão. 4D Server pode abrir arquivos .4DProject para fins de teste. @@ -120,9 +120,9 @@ Esse arquivo de texto também pode conter chaves de configuração, em particula A pasta Trash contém métodos e formulários eliminados do projeto (se existirem). Pode conter as seguintes pastas: - - `Página Métodos` - - `Formulários` - - `TableForms` +- `Página Métodos` +- `Formulários` +- `TableForms` Dentro destas pastas, os nomes dos elementos eliminados estão entre parênteses, por exemplo, "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Essa pasta contém [**configurações de usuário para os dados**](../Desktop/us A pasta Logs contém todos os arquivos de registo utilizados pelo projeto. Os arquivos de registro incluem, em particular: - - conversão da base de dados, - - pedidos do servidor Web, - - backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) - - depuração de comandos, - - 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). +- conversão da base de dados, +- pedidos do servidor Web, +- backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) +- depuração de comandos, +- 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). > Uma pasta adicional de Logs está disponível na pasta de preferências sistema do usuário (pasta 4D ativa, consulte o comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para arquivos de log de manutenção e nos casos em que a pasta de dados é somente leitura. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/components.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/components.md index fa2d5d81516248..c08f332d453a13 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/components.md @@ -13,15 +13,15 @@ Ao desenvolver em 4D, os arquivos de componentes podem ser armazenados de forma Componentes podem ser interpretados ou [compilados](../Desktop/building.md). - - Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. - - Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. +- Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. +- Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. ### Pasta do pacote The package folder of a component (*MyComponent.4dbase* folder) can contain: - - para **componentes interpretados**: uma [pasta Project](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: uma [pasta Project](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). +- para **componentes compilados**: - uma pasta "Contents" contendo um arquivo .4DZ, uma pasta *Resources*, um arquivo *Info.plist* (arquitetura recomendada) - ou diretamente um arquivo .4DZ com outras pastas como *Recursos*. @@ -37,8 +37,8 @@ A arquitetura da pasta "Contents" é recomendada para componentes, se você dese Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Server**. Em outros ambientes, os componentes são geridos de forma diferente: - - em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto. - - em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). +- em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto. +- em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Para carregar um componente no seu projeto 4D, você pode: - - copie os arquivos de componentes na pasta [**Components** do seu projeto](architecture.md#components) (as pastas de pacotes de componentes interpretados devem ser sufixadas com ".4dbase", veja acima), - - ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). +- copie os arquivos de componentes na pasta [**Components** do seu projeto](architecture.md#components) (as pastas de pacotes de componentes interpretados devem ser sufixadas com ".4dbase", veja acima), +- ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). Os componentes declarados no arquivo **dependencies.json** podem ser armazenados em locais diferentes: - - no mesmo nível da pasta do pacote do seu projeto 4D: esse é o local padrão, - - 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. +- no mesmo nível da pasta do pacote do seu projeto 4D: esse é o local padrão, +- 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. Se o mesmo componente for instalado em locais diferentes, uma [ordem de prioridade](#prioridade) é aplicada. @@ -69,8 +69,8 @@ O arquivo **dependencies.json** faz referência a todos os componentes necessár Pode conter: - - nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), - - nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). +- nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), +- nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ O arquivo **environment4d.json** é opcional. Ele permite que você defina **cam Os principais benefícios desta arquitetura são os seguintes: - - você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. - - se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. +- você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. +- se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. ### Prioridade @@ -187,9 +187,9 @@ Em relação aos componentes armazenados no GitHub, ambos os arquivos [**depende Para ser capaz de fazer referência direta e usar um componente 4D armazenado no GitHub, você precisa configurar o repositório do componente GitHub: - - Compacte os arquivos de componentes no formato ZIP. - - Nomeie este arquivo com o mesmo nome do repositório do GitHub. - - Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. +- Compacte os arquivos de componentes no formato ZIP. +- Nomeie este arquivo com o mesmo nome do repositório do GitHub. +- Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. Essas etapas podem ser facilmente automatizadas, com o código 4D ou usando o GitHub Actions, por exemplo. @@ -232,7 +232,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers ::: - - **Etiquetas** são textos que fazem referência exclusiva a uma versão. Nos arquivos [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson), você pode indicar a tag de versão que deseja usar em seu projeto. Por exemplo : +- **Etiquetas** são textos que fazem referência exclusiva a uma versão. Nos arquivos [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson), você pode indicar a tag de versão que deseja usar em seu projeto. Por exemplo : ```json { @@ -245,7 +245,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers } ``` - - Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: +- Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: ```json { @@ -262,17 +262,17 @@ Um intervalo é definido por duas versões semânticas, um mínimo e um máximo, Eis alguns exemplos: - - "latest": a versão com o selo "latest" nas versões GitHub. - - "\*": a versão mais recente lançada. - - "1.\*": todas as versões da versão principal 1. - - "1.2.\*": todos os patches da versão menor 1.2. - - ">=1.2.3": a última versão, começando com a versão 1.2.3. - - ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. - - "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. - - "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. - - "<=1.2.3": a versão mais recente até a 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. - - "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. +- "latest": a versão com o selo "latest" nas versões GitHub. +- "\*": a versão mais recente lançada. +- "1.\*": todas as versões da versão principal 1. +- "1.2.\*": todos os patches da versão menor 1.2. +- ">=1.2.3": a última versão, começando com a versão 1.2.3. +- ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. +- "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. +- "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. +- "<=1.2.3": a versão mais recente até a 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. +- "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. Se você não especificar uma tag ou uma versão, 4D recupera automaticamente a "versão mais recente". @@ -282,9 +282,9 @@ O gerenciador de dependências verifica periodicamente se as atualizações do c Se quiser usar a [**Seguir 4D Version**](#defining-a-github-dependency-version-range) regra de dependência, os marcadores de versões de componentes no repositório do Github devem obedecer a convenções específicas. - - **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". +- **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". - - **Versões R-Release**: padrão `xRy. `, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para a versão *xRy*, o Gerenciador de Dependências a resolverá para a "versão mais recente abaixo de xR(y+1)", se disponível. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". +- **Versões R-Release**: padrão `xRy. `, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para a versão *xRy*, o Gerenciador de Dependências a resolverá para a "versão mais recente abaixo de xR(y+1)", se disponível. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". :::note @@ -310,8 +310,8 @@ Em seguida, você precisa [fornecer seu token de conexão](#providing-your-githu Os componentes GitHub referenciados são baixados em uma pasta de cache local e carregados em seu ambiente. A pasta de cache local é armazenada na seguinte localização: - - en macOs: `$HOME/Library/Caches//Dependencies` - - no Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- no Windows: `C:\Users\\AppData\Local\\Dependencies` ...onde `` pode ser "4D", "4D Server" ou "tool4D". @@ -319,12 +319,12 @@ Os componentes GitHub referenciados são baixados em uma pasta de cache local e When you add or update a component (whether [local](#local-components) or [from GitHub](#components-stored-on-github)), 4D automatically resolves and installs all dependencies required by that component. Isto inclui: - - **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file - - **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed +- **Primary dependencies**: Components you explicitly declare in your `dependencies.json` file +- **Secondary dependencies**: Components required by primary dependencies or other secondary dependencies, which are automatically resolved and installed The Dependency manager reads each component's own `dependencies.json` file and recursively installs all required dependencies, respecting version specifications whenever possible. This eliminates the need to manually identify and add nested dependencies one by one. - - **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. +- **Conflict resolution**: When multiple dependencies require [different versions](#) of the same component, the Dependency manager automatically attempts to resolve conflicts by finding a version that satisfies all overlapping version ranges. If a primary dependency conflicts with secondary dependencies, the primary dependency takes precedence. :::note @@ -344,10 +344,10 @@ Em um projeto aberto, você pode adicionar, remover, atualizar e obter informaç Para exibir o painel Dependências: - - Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
+- Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - com 4D Server, selecione o item de menu **Janela/Dependências do projeto**.
+- com 4D Server, selecione o item de menu **Janela/Dependências do projeto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) O painel de Dependências é exibido em seguida. Dependências são classificadas por nome em ordem alfabética: @@ -362,11 +362,11 @@ Por padrão, todas as dependências identificadas pelo gerenciador de dependênc ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. - - **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). - - **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. - - **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... - - **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. +- **All**: All dependencies including both primary (declared) and secondary (automatically resolved) dependencies in a flat list view. +- **Declared**: Primary dependencies that are explicitly declared in the `dependencies.json` file. This tab helps you distinguish between dependencies you've directly added and those that were [automatically resolved](#automatic-dependency-resolution). +- **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. +- **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... +- **Conflicts**: Dependencies that are loaded but that overloads at least one other dependency at a lower [priority level](#priority). As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. ### Secondary dependencies @@ -384,16 +384,16 @@ As dependências que exigem a atenção do desenvolvedor são indicadas por um * Estão disponíveis as seguintes etiquetas de status: - - **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). - - **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). - - **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. - - **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). - - **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. - - **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). - - **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. - - **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. +- **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). +- **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). +- **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. +- **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). +- **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. +- **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). +- **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. +- **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. Uma dica é exibida quando você passa o mouse sobre a linha de dependência, provando informações adicionais sobre o status: @@ -427,8 +427,8 @@ Este item não é exibido se a dependência estiver inativa porque seus arquivos O ícone do componente e o logotipo da localização fornecem informações adicionais: - - O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. - - Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. +- O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. +- Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -448,8 +448,8 @@ Se o item selecionado não for válido, será exibida uma mensagem de erro. Clique em **Adicionar** para adicionar a dependência ao projeto. - - Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). - - Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). +- Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). +- Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). :::note @@ -489,11 +489,11 @@ Você pode definir a opção [tag ou versão](#tags-and-versions) para uma depen ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). - - **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. - - **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. - - **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. - - **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). +- **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). +- **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. +- **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. +- **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. +- **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). A versão atual da dependência do GitHub é exibida no lado direito do item de dependência: @@ -509,8 +509,8 @@ Modificar o intervalo de versão é útil, por exemplo, se você usar o recurso O gerenciador de dependências fornece um tratamento integrado de atualizações no GitHub. Os seguintes recursos são suportados: - - Verificação automática e manual das versões disponíveis - - Atualização automática e manual de componentes +- Verificação automática e manual das versões disponíveis +- Atualização automática e manual de componentes As operações manuais podem ser feitas **por dependência** ou **para todas as dependências**. @@ -526,11 +526,11 @@ Se você fornecer um [token de acesso](#providing-your-github-access-token), as Além disso, você pode verificar se há atualizações a qualquer momento, para uma única dependência ou para todas as dependências: - - Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. +- Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. ![componente de verificação](../assets/en/Project/check-component-one.png) - - Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. +- Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. ![componentes de verificação](../assets/en/Project/check-component-all.png) @@ -548,11 +548,11 @@ Se não quiser usar uma atualização de componente (por exemplo, se quiser perm Você pode atualizar as dependências a qualquer momento, para uma única dependência ou para todas as dependências: - - Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: +- Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: ![componente de verificação](../assets/en/Project/update-component-one.png) - - Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: +- Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: ![check components](../assets/en/Project/update-component-all.png) @@ -560,8 +560,8 @@ Em qualquer caso, independentemente do status atual da dependência, é feita um Quando você seleciona um comando de atualização: - - uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. - - Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. +- uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. +- Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. #### Atualização automática @@ -575,13 +575,13 @@ Quando essa opção estiver desmarcada, uma nova versão de componente que corre O registro do seu token de acesso pessoal no Gerenciador de dependências é: - - obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), - - recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). +- obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), +- recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). Para fornecer seu token de acesso ao GitHub, você pode: - - clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. - - ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. +- clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. +- ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md index 7e2af09f175ed8..7c695109cfa85e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Project/documentation.md @@ -7,10 +7,10 @@ Nos projetos de aplicação, você pode documentar seus métodos e suas classes, Os seguintes elementos do projeto aceitam documentação: - - 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 +- 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 Seus arquivos de documentação são escritos na sintaxe Markdown (arquivos .md) usando qualquer editor compatível com Markdown. São armazenados como ficheiros independentes na pasta do seu projeto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. +- Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. - - Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. +- Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. > Renomear ou excluir um elemento documentado em seu projeto também renomeará ou excluirá o arquivo Markdown associado ao elemento. @@ -73,9 +73,9 @@ Para visualizar a documentação na janela do Explorer: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. +- Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. ### Editar o ficheiro de documentação @@ -83,8 +83,8 @@ Você pode criar e/ou editar um arquivo de documentação Markdown na janela Exp Se não houver um arquivo de documentação para o elemento selecionado, você poderá: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ O editor de código 4D exibe uma parte da documentação de um método em sua di Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ +- Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ @@ -134,7 +134,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Markdown suportado - - A etiqueta de título é suportada: +- A etiqueta de título é suportada: ```md # Title 1 @@ -142,7 +142,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Title 3 ``` - - As etiquetas de estilo (itálico, negrito, riscado) são suportadas: +- As etiquetas de estilo (itálico, negrito, riscado) são suportadas: ```md _italic_ @@ -151,7 +151,7 @@ _italic_ ~~strikethrough~~ ``` - - A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: +- A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: ````md ```4d @@ -160,7 +160,7 @@ _italic_ ``` ```` - - A etiqueta de tabela é suportada: +- A etiqueta de tabela é suportada: ```md | Parâmetro | Tipo | Descrição | @@ -169,7 +169,7 @@ _italic_ | toolbar | Text |Nome da barra de ferramentas | ``` - - A etiqueta de ligação é suportada: +- A etiqueta de ligação é suportada: ```md // Case 1 @@ -181,7 +181,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - As etiquetas de imagem são suportadas: +- As etiquetas de imagem são suportadas: ```md ![image info](pictures/image.png) @@ -228,10 +228,10 @@ $logo:=GetLogo(5) ``` ```` - - Explorer view: +- Explorer view: ![](../assets/en/Project/explorer_Doc.png) - - Code editor view: +- Code editor view: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md index 400ee19c74fa0d..5b7b18c85907f6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Se `$attributes` for especificado para os atributos **storage**: +- Se `$attributes` for especificado para os atributos **storage**: - `$attributes=attribute1, attribute2, ...`: somente os atributos das entidades são retornados. ## Exemplo com entidades relacionadas diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md index dd48476a7fcfe5..6e2dfde4a12fb3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - outras sessões REST - - Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. +- outras sessões REST +- Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. Uma entidade bloqueada pela API REST só pode ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Resposta diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md index 4709c79923afc9..92195929e4c718 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/$method.md @@ -193,9 +193,9 @@ Se surgir um problema ao adicionar ou modificar uma entidade, ser-lhe-á enviado :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). - - **Booleanos** son true o false. - - Arquivos carregados usando `$upload` podem ser aplicados a um atributo do tipo Imagem ou BLOB passando o objeto retornado no seguinte formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). +- **Booleanos** son true o false. +- Arquivos carregados usando `$upload` podem ser aplicados a um atributo do tipo Imagem ou BLOB passando o objeto retornado no seguinte formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md index 206f046a875fa3..3c9932bb4f93c7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/ClassFunctions.md @@ -7,8 +7,8 @@ You can call [data model class functions](ORDA/ordaClasses.md) defined for the O Functions can be called in two ways: - - usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. - - usando solicitações **GET**, com parâmetros passados diretamente no URL. +- usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. +- usando solicitações **GET**, com parâmetros passados diretamente no URL. POST requests provide a better security level because they avoid running sensitive code through an action as simple as clicking on a link. However, GET requests can be more compliant with user experience, allowing to call functions by entering an URL in a browser (note: the developer must ensure no sensitive action is done in such functions). @@ -96,11 +96,11 @@ You can send parameters to functions defined in ORDA user classes or singletons. As regras abaixo são válidas: - - Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. - - In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. - - Os parâmetros devem ser incluídos numa coleção (formato JSON). - - Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. - - A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. +- In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. +- Os parâmetros devem ser incluídos numa coleção (formato JSON). +- Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. +- A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Veja [este exemplo](#using-an-entity-to-be-created-on-the-server) e [este exemplo](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Também é possível transmitir valores para quaisquer atributos da entidade. Es | __ENTITY | Parâmetros | Obrigatório - Verdadeiro para indicar ao servidor que o parâmetro é uma entidade | | __KEY | misto (do mesmo tipo que a chave primária) | Facultativo - Chave primária da entidade | - - Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. - - Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos +- Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. +- Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos See examples below for creating or updating entities with POST requests. See an example of contents downloading using an entity with a GET request. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md index 191f72de779ce4..82fda214ca94dc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/authUsers.md @@ -43,9 +43,9 @@ All other REST requests (handling data or executing a function) will only be pro As solicitações REST descritivas podem ser processadas em sessões de usuário Web que não exigem licenças (sessões "guest"). Essas solicitações são: - - Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - Renderização de uma página Qodly +- Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - Renderização de uma página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -72,8 +72,8 @@ A função pode receber qualquer autenticação ou informação contextual como Esta função deve conter duas partes: - - some code to identify and authenticate the REST request sender, - - se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. +- some code to identify and authenticate the REST request sender, +- se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. Se a função não chamar [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), nenhum privilégio será atribuído, nenhuma licença será consumida e solicitações REST subsequentes não descritivas serão rejeitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md index 3404d6817ab487..716363373e907b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta seção tem o objetivo de familiarizar com as funcionalidades REST com um exemplo simples. Nós vamos: - - criar e configurar um banco de dados 4D simples - - acessar aos dados do banco 4D através de REST usando um navegador padrão. +- criar e configurar um banco de dados 4D simples +- acessar aos dados do banco 4D através de REST usando um navegador padrão. Para simplificar o exemplo, vamos usar uma aplicação 4D e um navegador que são executados na mesma máquina. Também poderia usar uma arquitetura remota. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md index fef98a2592ccb2..87fc0baf1a4bb2 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/REST/manData.md @@ -19,7 +19,7 @@ Para adicionar e modificar entidades, você pode chamar [`$method=update`]($meth 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). -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). +Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) on one or more attributes (even relation attributes). ## Navegando dados @@ -27,7 +27,7 @@ Add the [`$skip`]($skip.md) (to define with which entity to start) and [`$top/$l ## Criar e gerenciar conjuntos de entidades -Un conjunto de entidades (también conocido como *selección de entidades*) es una colección de entidades obtenidas a través de una petición REST que se almacena en la caché de 4D Server. Usar um conjunto de entidades previne que pesquise continuamente sua aplicação pelos mesmos resultados. Acessar um conjunto de entidades é mais rápido e pode melhorar a velocidade de sua aplicação. +An entity set is a collection of entities obtained through a REST request that is stored in 4D Server's cache. Usar um conjunto de entidades previne que pesquise continuamente sua aplicação pelos mesmos resultados. Acessar um conjunto de entidades é mais rápido e pode melhorar a velocidade de sua aplicação. Para criar um conjunto de entidades, chame [`$method=entityset`]($method.md#methodentityset) em sua solicitação REST. As a measure of security, you can also use [`$savedfilter`]($savedfilter.md) and/or [`$savedorderby`]($savedorderby.md) when you call [`$filter`]($filter.md) and/or [`$orderby`]($orderby.md) so that if ever the entity set timed out or was removed from the server, it can be quickly retrieved with the same ID as before. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md index b12baafbf2032e..0e677360751766 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/processes.md @@ -17,15 +17,15 @@ Existem também três botões de atalho que podem ser utilizados para filtrar o ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Quando você marcar essa opção: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), - - é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), +- é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. A área inferior da janela é utilizada para apresentar a representação gráfica da atividade do(s) processo(s) selecionado(s). @@ -33,16 +33,16 @@ A área inferior da janela é utilizada para apresentar a representação gráfi A atividade do processo é a percentagem de tempo que 4D Server dedicou a este processo (proporção). A janela fornece as seguintes informações para cada processo: - - Tipo de processo (ver abaixo), - - Sessão/Info: +- Tipo de processo (ver abaixo), +- Sessão/Info: - Processo 4D - em branco, - Processo usuário - nome do usuário 4D, - Processo web - caminho URL, - - Nome do processo, - - Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. - - Estado atual do processo, - - Tempo de execução (em segundos) do processo desde a sua criação, - - Percentagem de tempo que 4D Server dedicou a este processo (rácio). +- Nome do processo, +- Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. +- Estado atual do processo, +- Tempo de execução (em segundos) do processo desde a sua criação, +- Percentagem de tempo que 4D Server dedicou a este processo (rácio). ## Tipo de processo @@ -83,15 +83,15 @@ A página também tem cinco botões de controle que atuam nos processos selecion ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Pausar processo**: pode ser usado para pausar os processos selecionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). +- **Pausar processo**: pode ser usado para pausar os processos selecionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md index 5ad406eb40bfc1..08aef35634f4df 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ A página do Monitor em Tempo Real monitora o progresso de operações "longas" As informações seguintes são fornecidas para cada linha: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ As informações seguintes são fornecidas para cada linha: A página está ativa e é atualizada permanentemente assim que é exibida. Note-se que o seu funcionamento pode atrasar significativamente a execução da aplicação. É possível suspender a atualização desta página de uma das seguintes maneiras: - - haciendo clic en el botón **Pausa**, - - clicando na lista, - - premindo a barra de espaços. +- haciendo clic en el botón **Pausa**, +- clicando na lista, +- premindo a barra de espaços. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Você pode retomar o monitoramento das operações realizando a mesma ação que realizar a pausa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md index fdcd6e21619131..608710e42261c0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/Users/overview.md @@ -7,8 +7,8 @@ Se mais de uma pessoa usar uma aplicação, que geralmente é o caso em arquitet A estratégia de controle de acesso 4D depende da configuração de sua implementação: - - em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md index e283eb9cf3a573..667ae23ab125a4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Em filePath, passe o caminho de destino e o nome do documento a ser importado. S Você pode especificar o formato do arquivo exportado incluindo uma extensão após o nome do documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", ou ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", ou ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Se a extensão não for incluída, mas o formato for especificado em *paramObj*, o arquivo exportado terá a extensão que corresponde ao formato, exceto para o formato CSV (nenhuma extensão é adicionada nesse caso). @@ -88,25 +88,25 @@ O parâmetro opcional *paramObj* permite que você defina várias propriedades p **Notas sobre o formato Excel**: - - Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. +- Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. **Notas sobre o formato PDF**: - - Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato CSV**: - - Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. - - Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. +- Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato de arquivo SpreadJS**: - - Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Once the export operation is finished, `VP EXPORT DOCUMENT` automatically triggers the execution of the method set in the *formula* property of the *paramObj*, if used. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md index 9f8db97da06cb1..a69e8faeea2a78 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-find.md @@ -5,7 +5,7 @@ title: VP Find -**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object } ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object +**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md index 3a6361ba1ce077..fc90cc04ccc72f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Em *vpAreaName*, passe o nome da propriedade da área 4D View Pro. Se passar um You can define where to get the style sheets in the optional *sheet* parameter using the sheet index (counting begins at 0) or with the following constants: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md index 47e8cd97ce06bf..40e8f143e18c79 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ The object returned will contain the `value` property, and, in case of a js date Se o objetivo retornado incluir uma data ou hora, é tratado como uma datetime e completado como abaixo: - - valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy - - valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) +- valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy +- valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) Se *rangeObj* contiver várias células ou vários intervalos, o valor da primeira célula é retornado. O comando retorna um objeto null se a célula estiver vazia. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md index 950f0b3fadd449..89009c2424490e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Em *vpAreaName*, passe o nome da área 4D View Pro. Se passar um nome que não e Em *filePath*, passe o caminho de destino e o nome do documento a ser importado. São suportados os seguintes formatos: - - Os documentos 4D View Pro (extensão ".4vp") - - Microsoft Excel (extensão ".xlsx") - - documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) - - [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") +- Os documentos 4D View Pro (extensão ".4vp") +- Microsoft Excel (extensão ".xlsx") +- documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) +- [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") If the document extension is not a recognized extension, such as `.4vp` or `.xlsx`, the document is considered a text document. Deve passar uma rota completa, a não ser que o documento esteja localizado no mesmo nível que a pasta Project, em cujo caso pode passar apenas seu nome. @@ -73,11 +73,11 @@ O parâmetro opcional *paramObj* permite definir as propriedades do documento im :::note Notas - - Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md index 042bb9c8815ff4..3095815f840351 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-remove-table-columns.md @@ -13,7 +13,7 @@ title: VP REMOVE TABLE COLUMNS -**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }}} ) +**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }} ) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md index 1a2476003ae825..b6dc6b4e3461cc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ O comando `VP RESIZE TABLE` alter As regras abaixo são válidas: - - Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. - - Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. - - Se a tabela se expandir nas células que contêm dados: +- Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. +- Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. +- Se a tabela se expandir nas células que contêm dados: - se as linhas forem adicionadas, os dados serão excluídos, - se colunas forem adicionadas, dados serão mantidos e exibidos em novas colunas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md index 0ea24e8c6c0966..fa56a40ec2ede4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/ViewPro/getting-started.md @@ -37,20 +37,20 @@ As folhas de cálculo são compostas por linhas e colunas. A cada linha está as ### Seleção de células, colunas e linhas - - Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. +- Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. - - Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. +- Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. - - To select all cells in the spreadsheet, click on the cell at the top left of the area: +- To select all cells in the spreadsheet, click on the cell at the top left of the area: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). +- Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). - - Para selecionar uma linha, clique no número correspondente. +- Para selecionar uma linha, clique no número correspondente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. +- Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. ### Introdução de dados @@ -76,8 +76,8 @@ As áreas do 4D View Pro se beneficiam de um menu de contexto automático que of Dependendo da área clicada, as seguintes opções também estão disponíveis: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - clique numa célula ou num intervalo de células: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- clique numa célula ou num intervalo de células: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. When a comment has been entered for an area, the top left cell of the area displays a small red triangle:\ @@ -128,8 +128,8 @@ Você pode então passar `$myRange` para outro método 4D View Pro para modifica Os objectos intervalo 4D View Pro são compostos por várias propriedades: - - área - O nome da área 4D View Pro - - intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- área - O nome da área 4D View Pro +- intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propriedade | | Tipo | Descrição | Disponível para | | ----------- | ------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | @@ -146,10 +146,10 @@ Os objectos intervalo 4D View Pro são compostos por várias propriedades: 4D View Pro suporta a importação e exportação de vários formatos de documentos: - - .4vp - - .xlsx - - .txt e .csv - - .sjs - - .pdf (apenas para exportação) +- .4vp +- .xlsx +- .txt e .csv +- .sjs +- .pdf (apenas para exportação) Para obter mais detalhes, confira a descrição de [VP IMPORT DOCUMENT](commands/vp-import-document.md) e [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md index 217af63b46f897..836441d9b6ee0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Some other items have a different case (ex: `this` vs `This`) but can be pasted QodlyScript command and constant names are written in camel case without spaces. Além disso, os nomes das constantes QodlyScript começam com a letra `k`. You might need to adapt these QodlyScript items to the 4D Language. - - Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. - - However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. +- Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. +- However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. ### Exemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript command and constant names are written in camel case without spaces. end ``` - - Código 4D equivalente no linguajem: +- Código 4D equivalente no linguajem: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md index 2e41224923c456..9e0085b73e83d1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Nas seções acima, nós temos acesso gratuito à aplicação através de solici A maneira mais simples e segura para registrar um usuário no servidor da Web 4D é baseada no seguinte cenário: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Criar uma tabela com alguns campos, por exemplo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md index 2da5339aaf5bbb..4070c3ace6f83b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Requisitos Custom HTTP Request handlers are supported: - - quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressões regulares**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/**/index.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressõe URL patterns are triggered in the given order: - - the first matching pattern is executed - - the following patterns are not executed even if they match the URL +- the first matching pattern is executed +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Classe e método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Veja abaixo](#request-handler-code) para informações sobre o código do manipulador de pedidos. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* na classe *UsersHandling* - - *handleInvoices* na classe \*FinancialHandling - - *handleDocs* na classe *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* +- *handle function* in the *GeneralHandling* class +- *manageAccount* na classe *UsersHandling* +- *handleInvoices* na classe \*FinancialHandling +- *handleDocs* na classe *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* Examples of URLs triggering the handlers: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md index a7055195bb0913..beb6ef24af4677 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív | Servidor Web | cooperativo | *configuração web* | | Servidor Web Services | cooperativo | *configuração web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de serviços Web: trata dos pedidos SOAP - - ***web setting*** significa que el modo apropiativo depende de un valor de configuración: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de serviços Web: trata dos pedidos SOAP +- ***web setting*** significa que el modo apropiativo depende de un valor de configuración: - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - caso contrário, a opção [**Usar processos preventivos**](webServerConfig.md#use-preemptive-processes) é tida em conta. - sobre processos de serviço Web (servidor ou cliente), modo preventivo é suportado no nível do método. You just have to select "Can be run in preemptive processes" property for published SOAP server methods (see [Publishing a Web Service with 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) or proxy client methods (see [Subscribing to a Web Service in 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) and make sure they are confirmed thread-safe by the compiler. @@ -35,21 +35,21 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív Todo o código 4D executado pelo servidor deve ser hilo seguro se você quiser que seus processos web sejam executados em modo preventivo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos os métodos bases relacionados com a Web: +- Todos os métodos bases relacionados com a Web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) e [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml +- Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para as tabelas com o atributo "Expor como recurso REST" +- Triggers para as tabelas com o atributo "Expor como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST Para cada um desses métodos e partes de código, o compilador irá verificar se as regras de segurança de threads são respeitadas, e retornará erros em caso de problemas. Para más información sobre las reglas hilo seguro, consulte el párrafo *Escribir un método hilo seguro* en el capítulo *Procesos* del manual de [Lenguaje 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ A maioria dos comandos 4D relacionados à Web e funções, métodos de banco de Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Obviamente, o código executado por esses métodos também deve ser hilo seguro. As seguintes URLs Web Server 4D são hilo seguro e podem ser usadas em modo preventivo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dcgi/* (los métodos base llamados también deben ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dcgi/* (los métodos base llamados también deben ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Ícone de processo web preemptivo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md index 2754efb59a2bca..20e6201f442828 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio can also be used in the [**Qodly Cloud platform**](https://qodly.co Qodly Studio proposes a full-featured web UI, allowing you to: - - create Qodly pages by placing components on a canvas - - map components to Qodly Sources - - acionar o código 4D configurando eventos - - e muito mais. +- create Qodly pages by placing components on a canvas +- map components to Qodly Sources +- acionar o código 4D configurando eventos +- e muito mais. ## Configuração @@ -24,19 +24,19 @@ Qodly Studio proposes a full-featured web UI, allowing you to: Qodly Studio suporta os seguintes navegadores Web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox A resolução recomendada é 1920x1080. #### Aplicação 4D - - Desenvolvimento: 4D v20 R2 ou superior - - Desenvolvimento: 4D Server v20 R2 ou superior - - Qodly Studio only works with 4D projects (binary databases are not supported). - - Web sessions (*aka* Scalable sessions) must [be enabled](sessions.md#enabling-web-sessions). - - O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). +- Desenvolvimento: 4D v20 R2 ou superior +- Desenvolvimento: 4D Server v20 R2 ou superior +- Qodly Studio only works with 4D projects (binary databases are not supported). +- Web sessions (*aka* Scalable sessions) must [be enabled](sessions.md#enabling-web-sessions). +- O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). ### Habilitando o acesso a Qodly Studio @@ -46,8 +46,8 @@ Qodly Studio é servido pelo [servidor web WebAdmin](../Admin/webAdmin.md) e exi Para permitir o acesso ao Qodly Studio, você deve permiti-lo explicitamente em dois níveis: - - ao nível da aplicação 4D - - a nível do projeto +- ao nível da aplicação 4D +- a nível do projeto If one of the two levels (or both) are not enabled, access to Qodly Studio is denied (a 403 page is returned). @@ -79,8 +79,8 @@ Authentication on the WebAdmin web server is granted using an access key. Para m In accordance with the management of 4D projects, only the following usages are supported: - - o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). - - implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. +- o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). +- implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. :::warning @@ -94,10 +94,10 @@ A página Qodly Studio está disponível quando o [servidor web WebAdmin](../Adm Há duas maneiras de acessar Qodly Studio: - - by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). +- by selecting the **Qodly Studio...** menu command from the **Design** menu (4D single-user) or the **Window** menu (4D Server). If the WebAdmin web server is already running, depending on its configuration, your default browser opens at `IPaddress:HTTPPort/studio` or `IPaddress:HTTPSPort/studio`. Otherwise, you will be prompted if you want to start the WebAdmin web server first. - - on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
+- on a browser, with the WebAdmin web server running (launched from 4D or 4D Server), enter the following address:
`IPaddress:HTTPPort/studio` ou : @@ -146,24 +146,24 @@ There is no direct compatibility between apps implemented with 4D and apps imple The following commands and classes are dedicated to the server-side management of Qodly pages: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. - - comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. - - clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. - - Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. +- comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. +- clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. +- Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. ### Uso de métodos projeto Recomendamos o uso de funções classe em vez de métodos projeto. Apenas as funções de classe podem ser chamadas a partir de componentes. No entanto, você ainda pode usar seus métodos projeto no Qodly Studio de duas maneiras: - - Você pode chamar seus métodos a partir de funções classe. - - Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. +- Você pode chamar seus métodos a partir de funções classe. +- Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. ### Uso fora de linha You can develop with Qodly Studio while your computer is not connected to the internet. Nesse caso, entretanto, os seguintes recursos não estão disponíveis: - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): the Template library is empty - - Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): the Template library is empty +- Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). ## Implantação @@ -179,8 +179,8 @@ See [this page](https://developer.qodly.com/docs/studio/rendering) for detailed Para ativar a renderização das páginas Qodly, as seguintes opções devem ser definidas. - - A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. - - O [servidor Web 4D](webServer.md) deve estar em execução. +- A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. +- O [servidor Web 4D](webServer.md) deve estar em execução. :::note @@ -310,9 +310,9 @@ Para fazer o logout do usuário, basta executar a ação padrão **Logout** na p Triggering the logout action from a web user session has the following effects: - - a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, - - a licença associada ao 4D é liberada, - - the `Session.storage` is kept until the web session inactivity timeout is reached (at least one hour). During this period after a logout, if the user logs in again, the same session is used and the `Session.storage` shared object is available with its current contents. +- a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, +- a licença associada ao 4D é liberada, +- the `Session.storage` is kept until the web session inactivity timeout is reached (at least one hour). During this period after a logout, if the user logs in again, the same session is used and the `Session.storage` shared object is available with its current contents. ## Sobre o uso da licença para renderização @@ -364,7 +364,7 @@ For more information on the `SameSite` attribute, check out [this blog post](htt To avoid using more licenses than necessary, we recommend doing one of the following: - - Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. - - Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. +- Run the renderer on another browser tab (by entering the rendered URL of your Qodly page: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. +- Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md index 48f067b2f19148..db7782b67a1684 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Estão disponíveis as seguintes etiquetas 4D: - - 4DTEXT, para inserir variáveis e expressões 4D como texto, - - 4DHTML, para inserir código HTML, - - 4DEVAL, para avaliar qualquer expressão 4D, - - 4DSCRIPT, para executar um método 4D, - - 4DINCLUDE, para incluir uma página dentro de outra, - - 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, - - 4DCODE, para inserir o código 4D, - - 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, - - 4DLOOP e 4DENDLOOP, para criar loops no código HTML, - - 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. +- 4DTEXT, para inserir variáveis e expressões 4D como texto, +- 4DHTML, para inserir código HTML, +- 4DEVAL, para avaliar qualquer expressão 4D, +- 4DSCRIPT, para executar um método 4D, +- 4DINCLUDE, para incluir uma página dentro de outra, +- 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, +- 4DCODE, para inserir o código 4D, +- 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, +- 4DLOOP e 4DENDLOOP, para criar loops no código HTML, +- 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md index 079d8c87b483bd..06758b9824340d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) O servidor web principal de 4D pode ser iniciado de diferentes maneiras: - - Utilizar um botão/comando de menu. +- Utilizar um botão/comando de menu. - 4D: menu **Executar\>Iniciar o servidor Web**
![](../assets/en/WebServer/start1.png) - 4D Server: botão **Iniciar servidor HTTP** da página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) +- Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) - - Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. +- Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. O servidor Web de qualquer componente pode ser iniciado com a chamada da função [`webServer.start()`](API/WebServerClass.md#start) no objeto do servidor Web do componente. @@ -29,9 +29,9 @@ O servidor Web de qualquer componente pode ser iniciado com a chamada da funçã O servidor web principal de 4D pode ser parado de diferentes maneiras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. +- Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ A qualquer momento, você pode limpar o cache das páginas e imagens que ele con Para o fazer, pode: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. A cache é então imediatamente limpa. @@ -64,11 +64,11 @@ A cache é então imediatamente limpa. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. ## URLs de administração @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Quando esse UR 4D permite gerar dois logs de pedidos web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md index 06ab3d4e86811d..2dfd24327c1b4f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts e métodos permitidos para o serviço CORS. Nome de domínio ou endereço IP de onde as páginas externas têm permissão para enviar solicitações de dados ao servidor via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Várias sintaxes são suportadas: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propriedade methods) Método(s) HTTP aceite(s) para o host CORS correspondente. São suportados os seguintes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separar cada método com um ";" (por exemplo: "post;get"). Se methods estiver vazio, null ou indefinido, todos os métodos serão ativados. @@ -145,9 +145,9 @@ Por padrão, quando o servidor web é iniciado pela primeira vez, 4D cria uma p Você pode designar outra página inicial padrão inserindo seu nome de caminho. - - La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - O caminho não deve começar nem terminar com uma barra. +- La ruta es relativa a la [carpeta HTML raíz ](#root-folder),. +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- O caminho não deve começar nem terminar com uma barra. Por exemplo, se você quiser que a página inicial padrão seja "MyHome. tm", e está localizado na pasta "Web" (ela própria localizada na pasta raiz padrão HTML), use "Web/MyHome.htm". @@ -318,14 +318,14 @@ Valores possíveis: Cadeia de endereços IP. Ambos os formatos de string IPv6 (p #### Acerca do suporte IPv6 - - **No warning when TCP port is occupied**
+- **No warning when TCP port is occupied**
When the server is set to respond on "Any" IP addresses, if the TCP port is being used by another application, this is not indicated when the server is started. Na verdade, o servidor 4D não detecta nenhum erro neste caso porque a porta permanece gratuita no endereço IPv6. No entanto, não é possível acessá-lo usando o endereço IPv4 da máquina, nem através do endereço local: 127.0.0.1. Se o seu servidor 4D não parecer responder na porta definida, pode testar o endereço [::1] na máquina do servidor (equivalente a 127.0.0.1 para IPv6, adicionar [:portNum] para testar outro número de porta). Se 4D responder, é provável que outro aplicativo esteja usando a porta em IPv4. - - **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Esses endereços são escritos com um prefixo de 96 bits no formato IPv6, seguido de 32 bits escritos na notação ponto-decimal do IPv4. Por exemplo, ::ffff:192.168.2.34 representa o endereço IPv4 192.168.2.34. +- **IPv4-mapped IPv6 addresses**
To standardize processing, 4D provides a standard hybrid representation of IPv4 addresses in IPv6. Esses endereços são escritos com um prefixo de 96 bits no formato IPv6, seguido de 32 bits escritos na notação ponto-decimal do IPv4. Por exemplo, ::ffff:192.168.2.34 representa o endereço IPv4 192.168.2.34. - - **Indication of port numbers**
+- **Indication of port numbers**
Since IPv6 notation uses colons (:), adding port numbers may lead to some confusion, for example: ```code4d @@ -419,10 +419,10 @@ Versão mínima de TLS aceita para ligações. As tentativas de ligação de cli Valores possíveis: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (padrão) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (padrão) +- 4 = TLSv1_3 Se modificado, o servidor deve ser reiniciado para utilizar o novo valor. @@ -488,10 +488,10 @@ Por exemplo: Disallow: /GIFS/ ``` - - "User-Agent: \*" - todos os robôs são afetados. - - "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. - - "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. - - "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. +- "User-Agent: \*" - todos os robôs são afetados. +- "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. +- "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. +- "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. Outro exemplo @@ -516,15 +516,15 @@ Além disso, a pasta raiz do HTML define, no disco rígido do servidor da Web, o Por defecto, 4D define una carpeta raíz HTML llamada **WebFolder**. Se ela ainda não existir, a pasta raiz HTML será fisicamente criada no disco no momento em que o servidor Web for iniciado pela primeira vez. A pasta raiz é criada: - - con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). - - com 4D em modo remoto, na pasta de recursos locais. +- con 4D (local) y 4D Server, en el mismo nivel de la [carpeta del proyecto](Project/architecture.md#project-folder). +- com 4D em modo remoto, na pasta de recursos locais. Você pode designar outra pasta raiz HTML padrão inserindo seu caminho. - - La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta - - O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). +- La ruta es relativa a la [carpeta del proyecto](Project/architecture.md#project-folder) (4D local y 4D Server) o a la carpeta que contiene la aplicación 4D o el paquete de software (4D en modo remoto). +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta +- O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). Por exemplo, se você quiser que a pasta raiz HTML seja a subpasta "Web" na pasta "MyWebApp", digite "MyWebApp/Web". @@ -579,9 +579,9 @@ Valor del atributo `SameSite` de la cookie de sesión. Este atributo le permite Há três valores disponíveis: - - "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. - - "Laxos": Os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). - - "None": Cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Estricto" (valor predeterminado del atributo `SameSite` para las cookies de sesión de 4D): las cookies sólo se enviarán en el contexto de primera parte, es decir, el contexto correspondiente al dominio del sitio y nunca a sitios web de terceros. +- "Laxos": Os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). +- "None": Cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). El valor del atributo `Secure` de la cookie de sesión se define automáticamente en "True" si la conexión es HTTPS (sea cual sea el valor del atributo `SameSite`). @@ -625,9 +625,9 @@ Em alguns casos, outras funções internas otimizadas podem ser invocadas. As li Duas opções permitem que você defina como funcionam as conexões persistentes: - - **Number of requests by connection**: Allows you to set the maximum number of requests and responses able to travel over a connection keep alive. Limitar o número de solicitações por conexão permite que você evite a inundação do servidor devido a um grande número de solicitações recebidas (uma técnica usada por hackers).

+- **Number of requests by connection**: Allows you to set the maximum number of requests and responses able to travel over a connection keep alive. Limitar o número de solicitações por conexão permite que você evite a inundação do servidor devido a um grande número de solicitações recebidas (uma técnica usada por hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **Timeout**: This value defines the maximum wait period (in seconds) during which the web server maintains an open TCP connection without receiving any requests from the web browser. Quando este período acabar, o servidor fecha a conexão.

+- **Timeout**: This value defines the maximum wait period (in seconds) during which the web server maintains an open TCP connection without receiving any requests from the web browser. Quando este período acabar, o servidor fecha a conexão.

Se o navegador da web enviar um pedido depois que a conexão for fechada, uma nova conexão TCP será criada automaticamente. Esta operação não é visível para o usuário.

diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md index 89dc823399d8ab..f5027f1adccc0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) Por exemplo, se você instalou dois componentes em sua aplicação principal, você pode iniciar e monitorar até três servidores web independentes em sua aplicação: - - um servidor web para a aplicação local, - - um servidor Web para o componente #1, - - um servidor Web para o componente #2. +- um servidor web para a aplicação local, +- um servidor Web para o componente #1, +- um servidor Web para o componente #2. Além da memória, não há limite para o número de componentes e, assim, de servidores web, que podem ser anexados a um único projeto de aplicação 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicação host ou componente) pode ser usado em seu próprio contexto separado, incluindo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - o processamento das etiquetas 4D e das chamadas de métodos, - - sessões Web e gestão do protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- o processamento das etiquetas 4D e das chamadas de métodos, +- sessões Web e gestão do protocolo TLS. Isso permite que você desenvolva componentes e recursos independentes que vêm com suas próprias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Se a aplicação utilizar componentes e o usuário pretender chamar: - - o servidor Web da aplicação host a partir de um componente ou - - o servidor que recebeu o pedido (qualquer que seja o servidor), +- o servidor Web da aplicação host a partir de um componente ou +- o servidor que recebeu o pedido (qualquer que seja o servidor), também pode ser utilizado: @@ -94,8 +94,8 @@ Estas propriedades são definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. se não for usado, nos parâmetros da aplicação host ou do componente. - - Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. - - If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. +- Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. +- If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. > *isRunning*, *name*, *openSSLVersion*, and *perfectForwardSecrecy* are read-only properties that cannot be predefined in the `settings` object parameter for the [`start()`](API/WebServerClass.md#start) function. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md index 241cf8f08802d9..8279b68a3320eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ The **WP Insert break** command ins Em *targetObj*, passe: - - um intervalo, ou - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - um documento 4D Write Pro +- um intervalo, ou +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- um documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insert contents at beginning of target | | wk replace | Integer | 0 | Replace target contents | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Parâmetros | Tipo | Valor | Comentário | | --------------------- | ------- | ----- | ------------------------------------------------------------------------ | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. +- Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md index 491bc78f5d2554..23587c8ed23223 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandO comando **Form** retorna o objeto associado ao formulário atual (instanciado a partir do parâmetro *formData* ou da classe usuário atribuída no editor de formulários). O 4D associa automaticamente um objeto ao formulário atual nos seguintes casos: - - o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), - - o formulário atual é um subformulário, - - um formulário de tabela é exibido na tela no momento. +- o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), +- o formulário atual é um subformulário, +- um formulário de tabela é exibido na tela no momento. ### Comandos (DIALOG...) Se o formulário atual estiver sendo exibido ou carregado por uma chamada aos comandos [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** retornará um dos dois: - - o objeto *formData* passado como parâmetro para esse comando, se houver, - - ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, - - ou um objeto vazio. +- o objeto *formData* passado como parâmetro para esse comando, se houver, +- ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, +- ou um objeto vazio. ### Subformulário Se o formulário atual for um subformulário, o objeto retornado dependerá da variável do contêiner pai: - - **Form** returns the object associated with the table form displayed on screen.\ +- **Form** returns the object associated with the table form displayed on screen.\ **Form** returns the object associated with the table form displayed on screen.\ In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: @@ -50,7 +50,7 @@ Se o formulário atual for um subformulário, o objeto retornado dependerá da v (OBJECT Get pointer(Object subform container))-> ``` - - Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. +- Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. Para mais informações, consulte a seção *Subformulários de Páginas*. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md new file mode 100644 index 00000000000000..af82ba45385d73 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/generate-uuid.md @@ -0,0 +1,62 @@ +--- +id: generate-uuid +title: Generate UUID +slug: /commands/generate-uuid +displayed_sidebar: docs +--- + +**Generate UUID** : Text
**Generate UUID**( *version* ) : Text + + + +| Parâmetro | Tipo | | Descrição | +| --------- | ------- | --------------------------- | ----------------------------------------------------------------- | +| version | Integer | → | UUID version: 4 (default) or 7 | +| Resultado | Text | ← | New UUID as non-canonical text (32 characters) | + + + +
História + +| Release | Mudanças | +| ------- | ------------------------------ | +| 20 R10 | Support of *version* parameter | + +
+ +## Descrição + +The Generate UUID returns a new 32-character UUID identifier in non-canonical form. + +An UUID is a 16-byte number (128 bits). It contains 32 hexadecimal characters. It can be expressed either in non-canonical form (series of 32 letters \[A-F, a-f\] and/or numbers \[0-9\], for example 550e8400e29b41d4a716446655440000) or in canonical form (groups of 8,4,4,4,12, for example 550e8400-e29b-41d4-a716-446655440000). + +You can use the optional *version* parameter to set the **UUID version** to generate. The following values are accepted: + +- **4** (default if omitted), for fully random UUIDs +- **7**, for random and timestamp UUIDs (chronological order matches lexical order). + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + +In 4D, UUID numbers can be stored in fields (see [UUID Format](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106190). A [4D settings option](../settings/database.md#auto-uuid-version) allows generating version 7 UUIDs in automatic fields. + +## Exemplo + +Generation of a UUID in a variable: + +```4d + var MyUUID : Text + MyUUID:=Generate UUID +``` + +## Propriedades + +| | | +| ----------------- | --------------------------- | +| Número de comando | 1066 | +| Thread safe | ✓ | + + diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md index 2128ff99f847fc..2ffe7e88a60ae7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Se o novo índice elemento for além do último elemento existente da coleção Pode passar qualquer número de valores dos tipos compatíveis abaixo: - - número (real, longint....). Valores numéricos são sempre armazenados como reais. - - text - - boolean - - date - - hora (armazenada como número de milissegundos - real) - - null - - objeto compartido - - coleção compartilhada +- número (real, longint....). Valores numéricos são sempre armazenados como reais. +- text +- boolean +- date +- hora (armazenada como número de milissegundos - real) +- null +- objeto compartido +- coleção compartilhada :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md index 9932777fa589eb..06e4be9e27340c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs No parâmetro *form*, você pode passar: - - o nome de um formulário, ou - - o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou - - um objeto contendo uma descrição do formulário. +- o nome de um formulário, ou +- o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou +- um objeto contendo uma descrição do formulário. Como **Imprimir formulário** não emite uma quebra de página após a impressão do formulário, é fácil combinar diferentes formulários na mesma página. Portanto, o **Print form** é perfeito para tarefas de impressão complexas que envolvam diferentes tabelas e diferentes formulários. Para forçar uma quebra de página entre os formulários, use o comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir a impressão para a próxima página em um formulário cuja altura seja maior que o espaço disponível, chame o comando [CANCEL](../commands-legacy/cancel.md) antes do comando [PAGE BREAK](../commands-legacy/page-break.md). Três sintaxes diferentes podem ser usadas: - - **Impressão da área de detalhe** +- **Impressão da área de detalhe** Sintaxe: @@ -43,7 +43,7 @@ Sintaxe: Nesse caso, **Imprimir formulário** imprime apenas a área de detalhes (a área entre a linha do cabeçalho e a linha de detalhes) do formulário. - - **Impressão da área do formulário** +- **Impressão da área do formulário** Sintaxe: @@ -79,7 +79,7 @@ Nesse caso, o comando imprimirá a seção designada pelo *marker*. Passe uma da | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impressão da seção** +- **Impressão da seção** Sintaxe: @@ -101,8 +101,8 @@ O valor retornado por **Print form** indica a altura da área impressa. Esse val As caixas de diálogo da impressora não são exibidas quando você usa **Print form**. O relatório não usa as configurações de impressão que foram atribuídas ao formulário no ambiente Design. Há duas maneiras de especificar as configurações de impressão antes de emitir uma série de chamadas para **Print form**: - - Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. - - Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. +- Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. +- Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. **Print form**\* cria cada página impressa na memória. Cada página é impressa quando a página na memória está cheia ou quando você chama [PAGE BREAK] (../commands-legacy/page-break.md). Para garantir a impressão da última página após qualquer uso de **formulário de impressão**, você deve concluir com o comando [PAGE BREAK](../commands-legacy/page-break.md) (exceto no contexto de um [ABERTO PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). Caso contrário, se a última página não estiver cheia, ela permanecerá na memória e não será impressa. @@ -116,8 +116,8 @@ Esse comando imprime áreas e objetos externos (por exemplo, áreas 4D Write ou **4D Server:** Esse comando pode ser executado no 4D Server dentro da estrutura de um procedimento armazenado. Neste contexto: - - Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). - - No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. +- Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). +- No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md index 8ef8463555262b..c35abaaaa85ce5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/process-info.md @@ -44,7 +44,7 @@ O objeto retornado contém as propriedades abaixo: | type | Integer | Tipo de processo em execução. Valores possíveis: veja abaixo | | visible | Parâmetros | True if visible, false otherwise | - - Valores possíveis para "state": +- Valores possíveis para "state": | Parâmetros | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ O objeto retornado contém as propriedades abaixo: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores possíveis para "type": +- Valores possíveis para "type": | Parâmetros | Valor | | ----------------------------- | ----- | diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/session.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/session.md index 6bbf9889f0877e..79545be3842d19 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/session.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Veja também +## Veja também [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md index d9c2da5e6ff54a..76ff3d453b8a0a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/commands/theme/Tools.md @@ -12,7 +12,7 @@ slug: /commands/theme/Tools | [](../../commands-legacy/choose.md)
| | [](../../commands-legacy/generate-digest.md)
| | [](../../commands-legacy/generate-password-hash.md)
| -| [](../../commands-legacy/generate-uuid.md)
| +| [](../generate-uuid.md)
| | [](../../commands-legacy/get-macro-parameter.md)
| | [](../../commands-legacy/launch-external-process.md)
| | [](../../commands-legacy/load-4d-view-document.md)
| diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md index be108f33fb31e9..66461efc27a1eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/client-server.md @@ -13,8 +13,8 @@ As páginas Cliente-servidor agrupam parâmetros relacionados ao uso do banco de Essa opção permite que você indique se o banco de dados do 4D Server aparecerá ou não na lista de bancos de dados publicados. - - When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). - - Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. +- When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). +- Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. :::note @@ -49,12 +49,12 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con O 4D Server usa três portas TCP para comunicações entre servidores internos e clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). - - **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). +- **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ When a 4D client connects to 4D Server, it uses the TCP port of the application server (19813 or the port indicated after the colon ':' in the IP address shown in the connection dialog box). Connection to other servers via their respective ports is then automatic; it is no longer necessary to specify them.\ Note that in the case of access via a router or a firewall, the three TCP ports must be opened explicitly. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. #### Autenticação do usuário com o servidor de domínio @@ -68,9 +68,9 @@ Quando o Single Sign On (SSO) estiver ativado (veja acima), você deverá preenc This drop-down box contains 3 network layer options to choose between: **legacy**, **ServerNet** and **QUIC** (only in project mode), which are used to handle communications between 4D Server and remote 4D machines (clients). - - **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -110,9 +110,9 @@ Essa opção permite que você ative o modo seguro para comunicações entre a m This setting can be used to globally set the updating mode for the local instance of the **Resources** folder on the connected 4D machines when the **Resources** folder of the database is modified during the session (the **Resources** folder is automatically synchronized on the remote machine each time a session is opened). Estão disponíveis três parâmetros: - - **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. - - **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ +- **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. +- **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ The **Resources** folder centralizes the custom files required for the database interface (translation files, pictures, etc.). Mecanismos automáticos ou manuais podem ser usados para notificar cada cliente quando o conteúdo dessa pasta tiver sido modificado. Para mais informações, por favor consulte a seção [Gerenciando da pasta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuração IP @@ -125,10 +125,10 @@ Essa tabela permite definir regras de controle de acesso para o banco de dados, O comportamento da tabela de configuração é o seguinte: - - A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. - - A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. - - A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. - - Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: +- A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. +- A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. +- A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. +- Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: - Negar 192.168.\* (negar todos os endereços que comecem por 192.168) - Autorizar \* (e autorizar outros) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md index f5dc235cc5c47d..7a47cabf23f216 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/compatibility.md @@ -8,10 +8,10 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m > The number of options displayed depends on the version of 4D with which the original database/project was created, as well as the settings modified in this database/project.\ > This page lists the compatibility options available for database/projects converted from 4D v18 onwards. Para opções de compatibilidade mais antigas, consulte a [Página de compatibilidade](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) em **doc.4d.com**. - - **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. +- **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. **Nota:** esta opção também pode ser gerenciada programando usando o comando `SET DATABASE PARAMETER`. - - **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: +- **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: - inicial "/" não é apenas o nó raiz - usar um / como primeiro caractere em uma expressão XPath não declara um caminho absoluto do nó raiz - não há nó atual implícito - o nó atual tem que ser incluído na expressão XPath @@ -19,12 +19,12 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m Although not standard, you might want to keep using these features so that your code continues to work as before -- in this case, just set the option *unchecked*. Por outro lado, se seu código não depender da implementação não padrão e se você quiser se beneficiar dos recursos estendidos do XPath em seus bancos de dados (como descrito no [`elemento DOM Find XML`](../commands-legacy/dom-find-xml-element.md) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. - - **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). +- **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). - - **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). +- **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). - - **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/database.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/database.md index c9b9a2923920be..e72f5a23911f93 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/database.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/database.md @@ -17,10 +17,24 @@ Essa opção permite a configuração da operação do aplicativo ao abrir um ar A menos que essa opção esteja marcada, não é possível abrir um banco de dados quando seu arquivo de dados estiver bloqueado (operação padrão para bancos de dados 4D). -#### Sobre arquivos bloqueados +:::info Sobre arquivos bloqueados Os arquivos bloqueados podem ser lidos, mas seu conteúdo não pode ser modificado. Por exemplo, os arquivos são bloqueados quando são armazenados em um suporte não regravável (tipo DVD) ou quando são copiados deste tipo de suporte. 4D pode trabalhar de forma transparente com arquivos de dados bloqueados, o que permite, mais particularmente, o uso de projetos armazenados em DVD. No entanto, esta operação corre o risco de usar inadvertidamente um arquivo de dados bloqueado no qual as modificações não serão salvas. É por isso que por padrão 4D não permite que bancos de dados com arquivo de dados bloqueado sejam abertos. +::: + +#### Auto UUID version + +[UUID version](https://en.wikipedia.org/wiki/Universally_unique_identifier) to use for 4D fields with [automatic UUID generation option](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.en.html#106195). Available values are **4** (default) and **7**. + +This setting only applies to UUIDs generated afterwards. Already saved auto UUIDs fields are not recomputed. + +:::note + +For more information on UUID version 7, please read [this blog post](https://blog.4d.com/sort-uuids-with-version-7). + +::: + ### Localização da pasta temporária Essa área permite que você altere o local dos arquivos temporários criados enquanto o 4D está em execução. A pasta de arquivos temporários é usada pelo aplicativo, quando necessário, para salvar temporariamente os dados da memória no disco. @@ -31,9 +45,9 @@ A localização atual desta pasta é exibida na área "Atual:". Você pode clica São oferecidos três opções de localização: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +55,7 @@ São oferecidos três opções de localização: > Se você alterar uma dessas opções, é preciso sair e reabrir o banco de dados para tornar a alteração eficaz. Quando a base de dados for reaberta, todos os índices da base de dados são automaticamente reindexados. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Quando a opção estiver marcada, o sinal de arroba é considerado um caractere simples se estiver localizado em uma palavra. Essa configuração é especialmente útil quando se procura por endereços de e-mail, onde o sinal @ é usado internamente. Esta opção tem influência em pesquisas, ordenações, comparações de string, bem como em dados armazenados em tabelas e dados encontrados na memória, como arrays. Campos e variáveis do alfa (indexado ou não) e tipo de texto estão preocupados com a forma como o caractere @ é interpretado em pesquisas e tipos de caracteres. @@ -52,19 +66,19 @@ São oferecidos três opções de localização: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razões de segurança, apenas o Administrador ou Designer da base de dados podem modificar este parâmetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. Um projeto 4D pode, portanto, operar em uma linguagem diferente da do sistema. Quando um projeto for aberto, o mecanismo 4D detecta o idioma usado pelo arquivo de dados e o fornece ao idioma (modo interpretador ou compilado). As comparações de texto, independentemente de serem realizadas pelo mecanismo de projeto ou pelo idioma, são feitas no mesmo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). Neste caso, a configuração aplica-se a todas as novas bases de dados criadas pela 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. Este algoritmo é semelhante ao usado pelo software de processamento de palavras para determinar os limites ao selecionar uma palavra que é clicada duplo. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Quando esta opção está selecionada, 4D utiliza um algoritmo simplificado. Nessa configuração, qualquer caractere não alfanumérico (ou seja, que não seja uma letra ou um número) é considerado um separador de palavras-chave. Essa configuração atende a requisitos específicos associados a determinados idiomas, como o japonês. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. #### Compatibilidade do MeCab (versão japonesa) @@ -82,7 +96,7 @@ Você usa as configurações nesta aba para configurar a memória em cache para ### Parâmetros da cache do banco de dados - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Esse valor é aumentado para otimização quando outros aplicativos são executados na mesma máquina que a 4D. - **Percentage of available memory used for cache**: Percentage of the remaining memory allocated to the cache by default.\ @@ -98,11 +112,11 @@ Você usa as configurações nesta aba para configurar a memória em cache para ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). O tamanho do cache de memória que você inserir será reservado para o banco de dados 4D, independentemente do estado dos recursos da máquina. Esta configuração pode ser usada em certas configurações específicas, ou quando a base de dados é projetada para ser usada em sistemas diferentes em termos de memória. Geralmente, a cache adaptativa oferece um melhor desempenho. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D salva os dados colocados no cache em intervalos regulares. Você pode especificar qualquer intervalo de tempo entre 1 segundo e 500 minutos. Por padrão, 4D salva seus dados a cada 20 segundos. O aplicativo também salva seus dados em disco toda vez que você alterar para outro ambiente ou sair do aplicativo. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Quando você antecipar uma entrada de dados pesada, considere definir um curto intervalo de tempo entre saves. Em caso de falha de poder, você só perderá os dados inseridos desde o salvamento anterior (se o banco de dados estiver sendo executado sem um arquivo de log). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md index 98a3fb3bb2f38d..d2a30f191995bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/interface.md @@ -23,9 +23,9 @@ A fonte padrão e seu tamanho dependem da plataforma onde 4D está sendo executa Outras opções configuram a exibição de várias janelas no modo Aplicativo. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Esse menu permite que você selecione o esquema de cores a ser usado no nível d Os seguintes esquemas estão disponíveis: - - **Light**: the application will use the Default Light Theme +- **Light**: the application will use the Default Light Theme ![](../assets/en/settings/light-appearance.png) - - **Escuro**: o aplicativo irá usar o Tema Escuro Padrão +- **Escuro**: o aplicativo irá usar o Tema Escuro Padrão ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Os temas predefinidos podem ser tratados com CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). O esquema de aplicação principal será aplicado aos formulários por defeito. No entanto, ele pode ser substituído: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atalhos @@ -72,9 +72,9 @@ Você usa a área de atalhos para visualizar e modificar atalhos padrão para tr Os atalhos predefinidos são os seguintes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece a seguinte caixa de diálogo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/security.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/security.md index 5dc652ca0b495d..eb49da34e62255 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/security.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/security.md @@ -11,7 +11,7 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa > Essas configurações não se aplicam às bases de dados do projeto abertas no modo de usuário único. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. Esta opção simplifica o acesso ao banco de dados, mantendo um sistema completo de controle de dados. - Se você associou uma senha ao usuário padrão, uma caixa de diálogo aparece quando o banco de dados está aberto e os usuários devem inserir uma senha. - If you haven't associated a password with the Default User, the User Identification dialog box will not appear.**Note:** You can "force" the display of the User Identification dialog box when the "Default User" mode is active, for instance in order to connect as Administrator or Designer. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. ## Opções - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. Você pode remover completamente ou parcialmente esta filtragem usando as seguintes opções. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Ele pode ser usado para definir um modo de acesso ilimitado para comandos e métodos, enquanto permanece no controle das operações realizadas. Durante a fase de desenvolvimento, este modo pode ser usado para testar livremente todas as fórmulas, relatórios e assim por diante. Durante a operação, pode ser usado para configurar soluções seguras que permitam o acesso a comandos e métodos temporários. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Quando esta opção estiver marcada, os usuários terão acesso a todos os comandos 4D e plug-ins, bem como a todos os métodos do projeto (exceto para os invisíveis). **Nota:** esta opção tem prioridade sobre o comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Quando está selecionado, este comando não faz nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. Quando esta opção está seleccionada: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/web.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/web.md index c055e23b8f2766..74c4681da956be 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/web.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/settings/web.md @@ -82,9 +82,9 @@ Quando esta opção é selecionada, o servidor web não fornece nenhum suporte e Neste modo, pode configurar parâmetros do servidor Web adicionais: - - [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) - - [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) - - [Usar processos preemptivos](#use-preemptive-processes) +- [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) +- [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) +- [Usar processos preemptivos](#use-preemptive-processes) #### Sessões herdadas (sessões de processo único) @@ -164,9 +164,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D O menu de formato do histórico oferece as seguintes opções: - - **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. +- **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. - - **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ +- **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ host rfc931 usuário [DD/MMM/AAAA:HH:MM:SS] "solicitação" estado tamanho\ Cada campo é separado por um espaço e cada linha termina com a sequência CR/LF (caractere 13, caractere 10). @@ -177,9 +177,9 @@ O menu de formato do histórico oferece as seguintes opções: > A data e a hora são locais para o servidor. - - petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) - - estado: resposta dada pelo servidor. - - length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. +- petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) +- estado: resposta dada pelo servidor. +- length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. > **Nota:** Por razões de desempenho, as operações são salvas em um buffer de memória em pacotes de 1Kb antes de serem escritas em disco. As operações também são gravadas no disco se nenhuma solicitação tiver sido enviada a cada 5 segundos. > Os valores possíveis de estado são os seguintes: @@ -193,16 +193,16 @@ O menu de formato do histórico oferece as seguintes opções: > 500: Internal error > O formato CLF não pode ser personalizado. - - **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. +- **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. - Referer: contém o URL da página que aponta para o documento solicitado. - User-agent: contém o nome e a versão do navegador ou software cliente que origina a solicitação. > O formato DLF não pode ser personalizado. - - **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. +- **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. - - **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. +- **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. **Configuração dos campos** Quando você escolhe o formato ELF (Extended Log Format) ou WLF (WebStar Log Format), a área "Weg Log Token Selection" exibe os campos disponíveis para o formato escolhido. Você precisará selecionar cada campo a ser incluído no registro. You will need to select each field to be included in the log. To do so, check the desired fields. @@ -242,14 +242,14 @@ A tabela a seguir lista os campos disponíveis para cada formato (em ordem alfab Configure the automatic backup parameters for the request log. Configure the automatic backup parameters for the request log. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. > No caso de backups programados, se o servidor Web não foi iniciado quando o backup estava programado para ocorrer, na próxima inicialização o 4D considera o backup como falho e aplica as configurações apropriadas, definidas nas Propriedades. @@ -263,9 +263,9 @@ Para obter mais informações sobre o suporte de serviços da Web em 4D, consult Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" de serviços da Web, ou seja, a publicação de métodos projeto na forma de serviços Web. - - **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. - - **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. - - **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. +- **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. +- **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. > Em conformidade com o padrão XML para nomes de etiquetas, as cadeias de caracteres usadas não devem conter espaços nem começar com um número. Além disso, para evitar qualquer risco de incompatibilidade, recomendamos que você não use nenhum caractere estendido (como caracteres acentuados). @@ -273,7 +273,7 @@ Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" Essa área contém várias opções relacionadas ao uso de 4D como um "cliente" de serviços Web, ou seja, a assinatura de serviços publicados na rede. - - **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". +- **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". ## Funcionalidades Web @@ -307,9 +307,9 @@ Esse botão só está disponível em projetos abertos com a aplicação 4D (usu O botão aciona a seguinte sequência de atualização: - - O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. - - O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). - - Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. +- O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. +- O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). +- Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. Lembre-se de reiniciar seu projeto após realizar essa atualização. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md index ff6661f192e020..51b288575d7208 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/ClassClass.md @@ -160,8 +160,8 @@ Você pode passar um ou mais parâmetros *param* opcionais, que serão passados :::note Notas - - Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. - - Se `.new()` for chamado em uma classe inexistente, será retornado um erro. +- Se `.new()` for chamado em uma [singleton class](../Concepts/classes.md#singleton-classes) que já tenha sido instanciada, a instância singleton será retornada, e não uma nova instância. +- Se `.new()` for chamado em uma classe inexistente, será retornado um erro. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/Document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/Document.md index e7f4dff58d6d8f..d474fd0e038e34 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/Document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/Document.md @@ -320,8 +320,8 @@ Essa propriedade é **somente leitura**. A propriedade `.original` retorna o elemento de destino para um alias, um atalho ou um arquivo de link simbólico. O elemento alvo pode ser: - - um objeto File - - um objeto folder +- um objeto File +- um objeto folder Para arquivos não-alias, a propriedade retorna o mesmo objeto de arquivo que o arquivo. @@ -585,8 +585,8 @@ A função `.getText()` retorna o conte Opcionalmente, você pode designar o conjunto de caracteres a ser usado na leitura do conteúdo. Você pode passar também: - - em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), - - ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. +- em *charSetName*, uma string que contém o nome padrão definido (por exemplo "ISO-8859-1" ou "UTF-8"), +- ou em *charSetNum*, o MIBEnum ID (número) do nome de configuração padrão. > Para a lista de conjuntos de caracteres suportados por 4D, consulte a descrição do comando `CONVERT FROM TEXT`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md index d97d156a01306b..b0cd758b8cf48d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/OutgoingMessageClass.md @@ -63,10 +63,10 @@ Um objeto 4D.OutgoingMessage é um objeto [não compartilhável](../Concepts/sha A propriedade `.body` contém o corpo da mensagem enviada. Os seguintes tipos de dados são suportados na propriedade `.body`: - - text - - blob - - object - - image +- text +- blob +- object +- image A propriedade `.body` é de leitura e gravação. @@ -108,17 +108,17 @@ A função `.setBody()` defi Os seguintes tipos de dados são suportados no *corpo*: - - Text - - Blob - - Object - - Imagem +- Text +- Blob +- Object +- Imagem Quando essa função é usada, o cabeçalho do tipo de conteúdo é definido automaticamente dependendo do tipo *corpo*: - - Content-Type:text/plain se o corpo é um Texto - - Content-Type:application/octet-stream se o corpo é um Blob - - Content-Type:application/json se o corpo é um objeto - - Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem +- Content-Type:text/plain se o corpo é um Texto +- Content-Type:application/octet-stream se o corpo é um Blob +- Content-Type:application/json se o corpo é um objeto +- Conteúdo-Tipo:image/jpeg, imagem/gif... se o corpo for uma imagem Se *body* não for de um tipo de valor suportado, um erro é retornado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md index 293adb31fe2f7b..6e63bfc3fc3252 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SMTPTransporterClass.md @@ -100,8 +100,8 @@ A propriedade `.keepAlive` contém diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md index dd7aafb18a323c..2a60234db4134e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/SessionClass.md @@ -5,6 +5,15 @@ title: Session Os objetos de sessão são retornados pelo comando [`Session`](../commands/session.md). Esses objetos fornecem ao desenvolvedor uma interface que permite gerenciar a sessão atual do usuário e executar ações como armazenar dados contextuais, compartilhar informações entre processos de sessão, iniciar processos preemptivos relacionados à sessão ou (somente na Web) gerenciar [privilégios](../ORDA/privileges.md). +:::info To learn more + +Blog posts about this feature: + +- [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) +- [Permissions: Inspect Session Privileges for Easy Debugging](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) + +::: + ### Tipos de sessão Os seguintes tipos de sessões são suportados por essa classe: @@ -309,6 +318,10 @@ Else End if ``` +#### Veja também + +[*Blog posts about this feature*](https://blog.4d.com/?s=hasPrivilege) + diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md index 6b00fdb84edc82..63da7637c1defc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPConnectionClass.md @@ -149,18 +149,18 @@ Os objetos TCPConnection fornecem as seguintes propriedades e funções: -| Parâmetro | Tipo | | Descrição | -| ------------- | ------------- | --------------------------- | -------------------------------------------------------- | -| serverAddress | Text | -> | Nome de domínio ou endereço IP do servidor | -| serverPort | Integer | -> | Número da porta do servidor | -| options | Object | -> | Configuração [opções](#options-parameter) para a conexão | -| Resultados | TCPConnection | <- | Novo objeto TCPConnection | +| Parâmetro | Tipo | | Descrição | +| ------------- | -------------------------------- | --------------------------- | -------------------------------------------------------- | +| serverAddress | Text | -> | Nome de domínio ou endereço IP do servidor | +| serverPort | Integer | -> | Número da porta do servidor | +| options | Object | -> | Configuração [opções](#options-parameter) para a conexão | +| Resultados | 4D.TCPConnection | <- | Novo objeto TCPConnection | #### Descrição -A função `4D.TCPConnection.new()` cria uma nova conexão TCP com o *serverAddress* e a *serverPort* especificados, usando as *opções* definidas, e retorna um objeto `4D.HTTPRequest`. +The `4D.TCPConnection.new()` function creates a new TCP connection to the specified *serverAddress* and *serverPort*, using the defined *options*, and returns a `4D.TCPConnection` object. #### `options` parameter diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md index 99a9c151fa74fa..99994c494a1953 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/TCPEventClass.md @@ -7,10 +7,10 @@ A classe `TCPEvent` fornece informações sobre os eventos que ocorrem durante o
História -| Release | Mudanças | -| ------- | ----------------------------- | -| 20 R9 | Novos atributos `ip` e `port` | -| 20 R8 | Classe adicionada | +| Release | Mudanças | +| ------- | ----------------------------------- | +| 20 R9 | New `address` and `port` attributes | +| 20 R8 | Classe adicionada |
@@ -20,12 +20,24 @@ Um objeto `TCPEvent` é imutável e não pode ser transmitido. As seguintes propriedades estão disponíveis: -| | -| ------------------------------------------------------------------------------------------- | -| [](#data)
| -| [](#ip)
| -| [](#port)
| -| [](#type)
| +| | +| ---------------------------------------------------------------------------------------------------- | +| [](#address)
| +| [](#data)
| +| [](#port)
| +| [](#type)
| + + + +## .address + +**address** : Text + +#### Descrição + +The `.address` property contains the IP address of the remote machine. + + @@ -45,18 +57,6 @@ Ao trabalhar com conexões TCP/IP de baixo nível, lembre-se de que não há gar - - -## .ip - -**ip** : Text - -#### Descrição - -A propriedade `.ip` contém o endereço IP da máquina remota. - - - ## .port diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md index 4b46b5c6dcc890..72094b45cc78fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebFormClass.md @@ -55,8 +55,8 @@ A função `.disableState()` de Essa função não faz nada se: - - o *estado* não está habilitado no momento no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* não está habilitado no momento no formulário Web, +- o *estado* não existe para o formulário Web. Se você [enable](#enablestate) ou desativar vários estados na mesma função de usuário, todas as modificações são enviadas em simultâneo, para o cliente quando a função termina. @@ -80,8 +80,8 @@ A função `.enableState()` ativ Essa função não faz nada se: - - o *estado* já foi ativado no formulário Web, - - o *estado* não existe para o formulário Web. +- o *estado* já foi ativado no formulário Web, +- o *estado* não existe para o formulário Web. Se você ativar ou [desativar](#disablestate) vários estados dentro da mesma função de usuário, todas as modificações serão enviadas ao mesmo tempo, para o cliente quando a função terminar. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md index ca94ba2f4d4146..e6033ed940d735 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketClass.md @@ -86,8 +86,8 @@ A função `4D.WebSocket.new()` cria e Em *url*, passe o URL ao qual o servidor WebSocket responderá. Podem ser utilizados os seguintes padrões de URL: - - `ws://host[:port]path[?query]` para ligações padrão - - `wss://host[:port]path[?query]` para conexões TLS seguras +- `ws://host[:port]path[?query]` para ligações padrão +- `wss://host[:port]path[?query]` para conexões TLS seguras Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um erro (que pode ser intersetado através de um método instalado com `ON ERR CALL`). @@ -95,8 +95,8 @@ Se a ligação não for possível, é devolvido um objeto `null` sendo gerado um Em *connectionHandler*, você pode passar um objeto que contém funções de callback a serem chamadas de acordo com eventos de conexão, bem como o tipo de dados e os cabeçalhos a serem tratados. - - As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. - - O WebSocket será válido enquanto o formulário ou o worker não for fechado. +- As chamadas de retorno são chamadas automaticamente no contexto do formulário ou do worker que inicia a ligação. +- O WebSocket será válido enquanto o formulário ou o worker não for fechado. | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -236,8 +236,8 @@ A função `.terminate()` fecha Em *code*, você pode passar um código de estado explicando porque a conexão está sendo fechada (consulte também [WebSocket Connection Close Code in the RFC6455](https://www.rfc-editor.org/rfc/rfc6455.html#section-7.1.5)): - - Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. - - Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. +- Se não for especificado, um código de fechamento da conexão será automaticamente definido como 1000 para um fechamento normal ou, caso contrário, como outro valor padrão no intervalo 1001-1015 que indique o motivo real pelo qual a conexão foi fechada. +- Se especificado, o valor desse parâmetro de código substitui a configuração automática. O valor deve ser um número inteiro. Ou 1000, ou um código personalizado no intervalo 3000-4999. Se você especificar um valor *code*, também deverá especificar um valor *reason*. Em *reason*, você pode passar uma frase descrevendo porque a conexão está sendo fechada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md index 50a87f6cc1943a..4fd51bb7b34faa 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/API/WebSocketServerClass.md @@ -29,13 +29,13 @@ Consulte também [esta postagem no blog](https://blog.4d.com/new-built-in-websoc Para criar e manipular seu servidor WebSocket em 4D, é preciso usar duas classes embutidas em 4D: - - essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, - - a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. +- essa classe (`4D.WebSocketServer`) para gerenciar o próprio servidor, +- a classe [`4D.WebSocketConnection`](WebSocketConnectionClass.md) para gerir as ligações e as mensagens. Além disso, terá de criar duas classes de utilizador que conterão funções de retorno de chamada: - - uma classe de usuário para tratar as ligações ao servidor, - - uma classe de usuário para tratar as mensagens. +- uma classe de usuário para tratar as ligações ao servidor, +- uma classe de usuário para tratar as mensagens. Você deve [criar o servidor WebSocket](#4dwebsocketservernew) em um [worker](../Develop/processes.md#worker-processes) para manter a conexão ativa. @@ -387,8 +387,8 @@ Por padrão, se nenhum valor de *timeout* for definido, a função inicializa o Se um valor *timeout* for definido: - - quando o tempo de espera é alcançado, a força destrói o meio. - - se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. +- quando o tempo de espera é alcançado, a força destrói o meio. +- se *timeout* = 0, forçando a destruir o soquete sem fechar quadros ou trocar pacotes finos, e instantaneamente sem tempo de espera. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md index 8f64054f66540e..9264cf9add7935 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Admin/webAdmin.md @@ -18,7 +18,7 @@ servidor web `WebAdmin` no se lanza. Precisa configurar o lançamento ao início Pode configurar o servidor web `WebAdmin` para que se lance ao início da aplicação 4D ou 4D Server (antes de que se carregue qualquer projeto). - - Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. +- Se utilizar uma aplicação 4D con interface, selecione a opção de menu **Arquivo > Administração web > Propriedades...**. ![alt-text](../assets/en/Admin/waMenu1.png) @@ -26,7 +26,7 @@ Selecione a opção **Iniciar WebAdmin ao iniciar** na caixa de diálogo de par ![alt-text](../assets/en/Admin/waSettings.png) - - Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: +- Se usar uma aplicação 4D que tenha ou não interface, pode habilitar o modo de inicio automático utilizando o argumento abaixo *Interface de linha de comandos*: ``` open ~/Desktop/4D.app --webadmin-auto-start true @@ -72,8 +72,8 @@ Quando esta opção for marcada, pode conectar ao servidor web `WebAdmin` atrav **Notas:** - - Conexões com HTTP outras que localhost nunca são aceitas. - - Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. +- Conexões com HTTP outras que localhost nunca são aceitas. +- Mesmo se esta opção for marcada, quando [Accept HTTPS](#accept-https) for marcado e a configuração TLS for válida, as conexões localhost vão usar HTTPS. #### Porta HTTP @@ -95,11 +95,11 @@ Rota da pasta onde o certificado TLS está localizado. Como padrão, a rota da p O estado ou formato do arquivo de registro da petição HTTP (HTTPDebugLog_*nn*.txt, armazenada na pasta "Logs" da aplicação -- *nn* é o número do arquivo). As opções abaixo estão disponíveis: - - **Desactivado** (por defecto) - - **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas - - **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) - - **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições - - **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas +- **Desactivado** (por defecto) +- **Com todas as partes do corpo** - habilitado com partes do cuerpo das petições e respostas +- **Sem as partes do corpo** - ativado sem partes do corpo (se indica o tamanho do corpo) +- **Com os corpos das petições** - ativado com as partes do corpo unicamente nas petições +- **Com a resposta corpos** - ativado com as partes do corpo unicamente nas respostas #### Chave de acesso @@ -109,10 +109,10 @@ A configuração de uma chave de acesso é obrigatória para desbloquear o acess Uma chave de acesso é parecida a uma senha, mas não está associada com um login. - - Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del +- Para definir uma nova chave de acesso: clique no botão **Definir**, introduza a string da chave de acesso na caixa de diálogo e clique em **OK**. La etiqueta del botón se convierte en **Modificar**. - - Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. - - Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. +- Para modificar a chave de acesso: clique no botão **Modificar**, introduza a nova string da chave de acesso na caixa de diálogo e clique em **OK**. +- Para eliminar a chave de acesso: clique no botão**Modificar**, deixe vazia a área daa chave de acesso e clique em **OK**. #### Ativar o acesso a Qodly Studio @@ -147,9 +147,9 @@ Exemplo: ## Autenticação e sessão - - Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. +- Quando acessar uma página de gestão entrando uma URL e sem identificação prévia, uma autenticação é exigida. O usuário deve introduzir a [chave-de-acesso](#access-key) em uma janela de autenticação. Se a chave de acesso nâo foi definida na configuração de `WebAdmin`, não é possível o acesso via URL. - - Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente +- Quando uma página de gerenciamento é acessada diretamentee de um item menu 4D ou 4D Servidor (tal como **Records > Data Explorer** ou **Window > Data Explorer** (4D Server)), o acesso é garantido sem autenticação, e o usuário é autenticado automaticamente Quando o acesso é concedido, uma [sessão web](WebServer/sessions.md) com o privilégio "WebAdmin" é criado na aplicação 4D. Enquanto a sessão atual tiver o privilégio "WebAdmin", o componente `WebAdmin` entrega páginas solicitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md index 038ecc03e9654f..101480c4497149 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/restore.md @@ -5,12 +5,12 @@ title: Restaurar um backup 4D lhe permite restaurar conjuntos inteiros de dados de um banco de dados no caso de que se apresente um incidente, independentemente da causa do mesmo. Podem ocorrer dois tipos principais de incidentes: - - A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: +- A parada inesperada do banco enquanto estiver em uso. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. Esse incidente pode ocorrer por causa de uma falha de energia, erro em um elemento do sistema, etc. This incident can occur because of a power outage, system element failure, etc. In this case, depending on the current state of the data cache at the moment of the incident, the restore of the database can require different operations: - Se a cache estiver vazia, o banco de dados abre normalmente. Quaisquer mudanças feitas no banco de dados foram registradas. Este caso não exige nenhuma operação particular - Se a cache conter operações, o arquivo de dados está intacto mas exige integrar o arquivo de histórico atual. - Se a cache estiver no processo de ser escrita, o arquivo de dados está provavelmente danificado. When restoring a backup and integrating the current log file in a encrypted database: - - A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. +- A perda de um ou mais arquivos do banco de dados. This incident can occur because of defective sectors on the disk containing the database, a virus, manipulation error, etc. The last backup must be restored and then the current log file must be integrated. O último backup deve ser restaurado e o arquivo de histórico atual deve ser integrado. Para saber se um banco de dados foi danificado depois de um incidente, basta relançar o banco de dados com 4D. O programa realiza um autodiagnóstico e detalha as operações de restauração necessárias. Em modo automático, essas operações são realizadas diretamente sem precisar de ajuda da parte do usuário. Se usar uma estratégia de backup regulares, as ferramentas de restauração de 4D permite recuperar (na maioria dos casos) o banco de dados na mesma situação que estava antes do incidente. > 4D pode lançar procedimentos automaticamente para recuperar os bancos de dados depois de um incidente. Esses mecanismos são gerenciados usando duas opções disponíveis na página **Backup/Backup & Restore** das Configurações. Para obter mais informações, consulte o parágrafo [Restaurador automático](settings.md#automatic-restore-and-log-integration).\ > Se o incidente for resultado de uma operação inadequada realizada nos dados (eliminação de um registro, por exemplo), você pode tentar reparar o arquivo de dados usando a função "rollback" no arquivo de log. Esta função está disponível na página [Rollback](MSC/rollback.md) do MSC. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md index e2a56805ae3b0f..d735cf33ca5f90 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Backup/settings.md @@ -5,9 +5,9 @@ title: Backups periódicos As configurações de backup são definidas através de três páginas na [caixa de diálogo Configurações](../settings/overview.md). Pode estabelecer: - - a periodicidade das cópias de segurança automáticas - - os arquivos a incluir em cada backup - - as funcionalidades avançadas que permitem executar tarefas automáticas +- a periodicidade das cópias de segurança automáticas +- os arquivos a incluir em cada backup +- as funcionalidades avançadas que permitem executar tarefas automáticas > As propriedades definidas nesta caixa de diálogo são escritas no arquivo *Backup.4DSettings*, guardado na pasta [Settings](../Project/architecture.md#settings-user). @@ -23,12 +23,12 @@ As configurações de backup do agendador são definidas na página **Backup/Per As opções encontradas nessa aba permitem estabelecer e configurar as cópias de segurança automáticas programadas do banco de dados. Pode escolher uma configuração rápida padrão ou pode personalizá-la completamente. Várias opções aparecem dependendo da escolha feita no menu **Backup automático**: - - **Nunca**: A função de cópia de segurança agendada está inativa. - - **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. - - **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. - - **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. - - **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. - - **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: +- **Nunca**: A função de cópia de segurança agendada está inativa. +- **Cada hora**: Programa um backup automático a cada hora, começando com a próxima hora. +- **Todos os dias**: Programa um backup automático todo dia. Pode então digitar a hora quando o backup deve começar. +- **Toda semana**: Programa um backup automático toda semana. Duas áreas de entrada adicionais lhe permitem indicar o dia e a hora em que deve começar a cópia de segurança. +- **Todos os meses**: Programa uma cópia de segurança automática todos os meses. Duas áreas de entrada adicionais lhe permitem indicar o dia do mês e a hora em que deve começar a cópia de segurança. +- **Personalizado**: sirve para configurar las copias de seguridad automáticas "a medida". Quando selecionar esta opção, várias áreas de entradas aparecem: - **Cada X hora(s)**: Permite programar as cópias de segurança com frequência horária. Pode digitar um valor entre 1 e 24. * **Todos os X dia(s) no x**: permite backups de programação diariamente. Por exemplo, introduza 1 se quiser realizar uma cópia de segurança diária. Quando esta opção estiver marcada, deve digitar a hora quando o backup deve começar. * **A cada X semana(s) no x**: permite backups de programação semanais. Digite 1 se quiser realizar o backup 1 vez por semana. Quando essa opção estiver marcada, deve digitar o dia da semana e a hora em que quer começar o backup. Pode selecionar vários dias da semana se quiser. Por exemplo. pode usar essa opção para estabelecer dois backups por semana: um nas quartas feiras e outro nas sextas. @@ -48,12 +48,12 @@ A página Cópia de segurança| Configuração das propriedades do banco de dado Essa área lhe permite determinar quais os arquivos ou pastas que devem ser copiados durante o backup. - - **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. +- **Dados**: Arquivo de dados do aplicativo. Quando esta opção for marcada, o arquivo de histórico do banco de dados, se existir, recebe um backup na mesma hora que os dados. - o arquivo de histórico atual da aplicação (se houver), - a pasta `Settings` completa localizada [ao lado do arquivo de dados](../Project/architecture.md#settings-user-data) (se existir), ou seja, os *parâmetros usuário para os dados*. - - **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. - - **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* - - **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". +- **Estructura**: carpetas y archivos proyecto de la aplicación. No caso de bancos de dados compilados, essa opção permite fazer o backup do arquivo .4dz. Quando esta opção estiver marcada, uma cópia de segurança é feita automaticamente da pasta completa Settings situada [no mesmo nível que a pasta Project](../Project/architecture.md#settings-user), ou seja, *os parâmetros usuário*, é backup automaticamente. +- **Arquivo de estrutura usuário (só para bancos binários)**: *funcionalidade obsoleta* +- **Arquivos anexos**: Esta área permite especificar um conjunto de arquivos e/ou pastas para serem copiados em backup ao mesmo tempo que o aplicativo. Esses arquivos podem ser de qualquer tipo (documentos ou modelos de plug-ins, etiquetas, relatórios, imagens, etc). Pode estabelecer arquivos ou pastas individuais cujos conteúdos serão respaldados completamente. Cada elemento anexado é listado com sua rota de acesso completa na área "Anexos". - **Eliminar**: retira o arquivo selecionado da lista de arquivos anexos. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar uma pasta para adicionar à cópia de segurança. No caso de uma restauração, a pasta vai recuperar sua estrutura interna. Pode selecionar toda pasta ou volume conectado à máquina, exceto a pasta que conter os arquivos do banco de dados. - **Adicionar pasta...**: Mostra uma caixa de diálogo que permite selecionar um arquivo para adicionar à cópia de segurança. @@ -82,19 +82,19 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus ### Parâmetros gerais - - **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). +- **Mantenha apenas os últimos arquivos de backup X**: Este parâmetro ativa e configura o mecanismo usado para excluir os arquivos de backup mais antigos. que evita o risco de saturar a unidade de disco. Esta funcionalidade opera da seguinte maneira: uma vez finalizado o backup atual, 4D elimina o arquivo mais antigo se for encontrado no mesmo local que o arquivo do qual se está fazendo o backup e tiver o mesmo nome (pode solicitar que o arquivo mais antigo se elimine antes do backup para poupar espaço). Se, por exemplo, o número de conjuntos se definir como 3, as três primeiras cópias de segurança criam os arquivos MyBase-0001, MyBase-0002 e MyBase-0003 respectivamente. Durante o quarto backup, o arquivo MyBase-0004 é criado e MyBase-0001 é apagado. Como padrão, o mecanismo de eliminação de conjuntos está ativado e 4D salva 3 conjuntos de cópias de segurança. Para desativar o mecanismo, simplesmente desmarque a opção. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. +- **Fazer Cópia de segurança só se o arquivo de dados tiver sido modificado**: Quando marcar esta opção, 4D inicia as cópias de segurança programadas apenas se os dados tiverem sido adicionados, modificados ou excluídos desde a última cópia de segurança. Senão, o backup programado é cancelado e abandonado até o próximo backup programado. Nenhum erro é gerado, entretanto o diário de cópias de segurança assinala que a cópia de segurança foi adiada. Esta opção também permite poupar tempo de máquina para a cópia de segurança de aplicações utilizados principalmente para visualização. Lembre que ao ativar esta opção não se levam em consideração as modificações realizadas nos arquivos de estrutura ou nos arquivos anexos. > Esse parâmetro se refere tanto a aplicações quanto aos arquivos de registro. - - **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. +- **Excluir arquivo de backup mais antigo antes de/após backup**: Esta opção só é usada se a opção "Manter apenas os últimos X arquivos de backup" estiver marcada. Especifica se o 4D deve começar apagando o arquivo mais antigo antes de iniciar o backup (opção **before**) ou se a exclusão deve ocorrer após a conclusão do backup (opção **after**). Para que os mecanismos funcionem, o arquivo mais velho não deve ser renomeado nem movido. - - **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. +- **Se a cópia de segurança falhar**: Esta opção permite definir o mecanismo usado para lidar com cópias de segurança falhadas (cópia de segurança impossível). Quando uma cópia de segurança não puder ser realizada, 4D deixa que realize uma nova tentativa. - **Tente novamente na próxima data e hora agendadas**: essa opção só faz sentido quando trabalhar com backups automáticos programados. Equivale a anular a cópia de segurança que falhou. Um erro é gerado. - **Tentar novamente após X segundo(s), minuto(s) ou hora(s)**: Quando esta opção é marcada, uma nova tentativa de backup é executada após o período de espera. Este mecanismo permite antecipar certas circunstancias que possam bloquear a cópia de segurança. Pode estabelecer um período de espera em segundos, minutos ou horas utilizando o menu correspondente. Se a nova tentativa também falhar, um erro é gerado e a falha é notada na área de status do último backup e no arquivo de histórico de backup. - **Cancele a operação após X tentativas**: Este parâmetro é usado para definir o número máximo de tentativas de backup falhadas. Se o backup não tiver sido realizado com sucesso depois do número máximo de tentativas estabelecido tiver sido alcançado, ele será cancelado e o erro 1401 é gerado ("Número máximo de tentativas de backup foi alcançado; backup automático foi desativado temporariamente"). Nesse caso, não se fará mais backups automáticos até que a aplicação seja reiniciada ou um backup manual se realize com sucesso. @@ -106,17 +106,17 @@ Modificar as opções de cópia de segurança e restauração é opcional. Seus Essas opções se aplicam aos arquivos de cópia de segurança principais e aos arquivos de cópia de segurança do histórico. - - **Tamanho do Segmento (Mb)** +- **Tamanho do Segmento (Mb)** 4D permite que você segmente arquivos, ou seja, para cortá-lo em tamanhos menores. Esse funcionamento permite, por exemplo, armazenar uma cópia de segurança em vários discos diferentes (DVD, dispositivos usb pendrive, etc). Durante a restauração, 4D vai fusionar automaticamente os segmentos. Segment Size (Mb) 4D allows you to segment archives, i.e., to cut it up into smaller sizes. This behavior allows, for example, the storing of a backup on several different disks (DVDs, usb devices, etc.). O menu **Tamanho do Segmento** é uma caixa de combinação que permite que você defina o tamanho em MB para cada segmento do backup. Pode escolher um dos tamanhos pré-estabelecidos ou digitar um tamanho específico entre 0 e 2048. Se você passar 0, nenhum segmento ocorre (isso é o equivalente a passar **Nenhum**). - - **Taxa de Compressão** +- **Taxa de Compressão** Por padrão, o 4D comprime os backups para ajudar a economizar espaço em disco. Entretanto, a fase de compressão de arquivo pode retardar o processo de backup quando lidar com grandes volumes de dados. A opção **Taxa de Compressão** permite ajustar a compressão de arquivo: - **Nenhum:** Não se aplica compressão de arquivos. O backup é mais rápido, mas os arquivos são bem maiores. - **Rápido** (padrão): Essa opção é um compromisso entre a velocidade de backup e tamanho de arquivo. - **Compact**: A taxa máxima de compressão é aplicada aos arquivos. Os arquivos ocupam o mínimo espaço possível no disco, mas o backup é mais lento. - - **Taxa de Interlúção e Taxa de Redundância** +- **Taxa de Interlúção e Taxa de Redundância** 4D gera arquivos usando algoritmos específicos que são baseados nos mecanismos de otimização (intercrição) e segurança (redundância). Pode estabelecer esses mecanismos de acordo com suas necessidades. Os menus para essas opções contêm as taxas **Baixo**, **Médio**, **Alto** e **Nenhum** (padrão). - **Taxa de Entrelaçamento**: O Interlacing consiste de armazenar dados em setores não adjacentes para limitar riscos no caso de danos de setor. Quanto maior a taxa, maior a segurança; entretanto, o processamento de dados usa mais memória. - **Taxa de redundância**: Redundância permite a segurança de dados presentes em um arquivo ao repetir a mesma informação várias vezes. Quanto maior a taxa de redundância, melhor a segurança, mas o armazenamento é mais lento e o tamanho dos arquivos aumenta. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md index 9b3e20d36416b0..d5412569234e89 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/operators.md @@ -11,8 +11,8 @@ A linguagem 4D suporta os operadores que talvez já conheça de outras linguagen A linguagem 4D suporta operadores **binários** e **ternários**: - - Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. - - os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). +- Os operadores binários operam em dois alvos (como `2 + 3`) e aparecem entre seus dois alvos. +- os operadores ternários operam em três objectivos. Como o C, o 4D tem apenas um operador ternário, o [operador condicional ternário](#ternary-operator) (`a ? b : c`). Os valores que os operadores afectam são os operandos. Na expressão `1 + 2`, o símbolo + é um operador binário e seus dois operandos são os valores 1 e 2. @@ -33,18 +33,18 @@ $col:=New collection //$col é inicializado com uma coleção vazia Os resultados do operador dependem dos **tipos de dados** aos quais são aplicados. 4D suporta diferentes operadores em tipos de dados escalares. São descritos com os tipos de dados, nas secções seguintes: - - [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) - - [**Operadores de data**](dt_date.md#operadores-de-data) - - [**Operadores de tempo**](dt_time.md#operadores-de-tempo) - - [**Operadores de números**](dt_number.md#number-operators) - - [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) - - [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) - - [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) - - [**Operadores de string**](dt_string.md#string-operators) - - [**Operadores nas referências de objetos**](dt_object.md#object-operators) - - [**Operadores de referência de coleção**](dt_collection.md#collection-operators) - - [**Operadores null**](dt_null_undefined.md#operadores-null) - - [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) +- [**Operadores lógicos**](dt_boolean.md#logical-operators) (em expressões **booleanas**) +- [**Operadores de data**](dt_date.md#operadores-de-data) +- [**Operadores de tempo**](dt_time.md#operadores-de-tempo) +- [**Operadores de números**](dt_number.md#number-operators) +- [\*\*Operadores Bitwise \*\*](dt_number.md#bitwise-operators) (em \*\*expressões inteiras longas) +- [**Operadores em imagens**](dt_picture.md#operadores-em-imagens) +- [**Operadores em ponteiros**](dt_pointer.md#operadores-em-ponteiros) +- [**Operadores de string**](dt_string.md#string-operators) +- [**Operadores nas referências de objetos**](dt_object.md#object-operators) +- [**Operadores de referência de coleção**](dt_collection.md#collection-operators) +- [**Operadores null**](dt_null_undefined.md#operadores-null) +- [**Operadores indefinidos**](dt_null_undefined.md#undefined-operators) ## Operadores de atribuição compostos @@ -272,9 +272,9 @@ O operador condicional ternário permite-lhe escrever expressões condicionais d Aceita três operandos na seguinte ordem: - - uma condição seguida de um ponto de interrogação (?) - - uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) - - uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) +- uma condição seguida de um ponto de interrogação (?) +- uma expressão a ser executada se a condição for [truthy](#truthy-and-falsy), seguido por dois pontos (:) +- uma expressão a ser executada se a condição for [falsy](#truthy-and-falsy) ### Sintaxe @@ -325,21 +325,21 @@ Para além de um tipo, cada valor tem também um valor booliano inerente, geralm Os seguintes valores são falsy\*\*: - - false - - Null - - indefinido - - Null object - - Null collection - - Null pointer - - Null picture - - Null date !00-00-00! - - "" - Empty strings - - [] - Colecções vazias - - {} - Objectos vazios +- false +- Null +- indefinido +- Null object +- Null collection +- Null pointer +- Null picture +- Null date !00-00-00! +- "" - Empty strings +- [] - Colecções vazias +- {} - Objectos vazios Todos os outros valores são considerados **verdadeiros**, inclusive: - - 0 - zero numérico (inteiro ou não) +- 0 - zero numérico (inteiro ou não) Em 4D, a avaliação **verdadeira** e **falsa** reflete a **utilização** de um valor, o que significa que um valor verdadeiro existe e pode ser processado pelo código sem gerar erros ou resultados inesperados. A lógica por trás disso é fornecer uma maneira conveniente de lidar com valores *undefined* e *null* em objetos e coleções, de modo que um número reduzido de instruções [If…Else](flow-control.md#ifelseend-if) seja necessário para evitar erros de tempo de execução. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md index af79891afd9132..9ffc9beea3d801 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Concepts/variables.md @@ -53,8 +53,8 @@ Essa sintaxe só é compatível com declarações de [variáveis locais e de pro `varType` pode ser: - - um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, - - uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. +- um [tipo básico](Concepts/data-types.md), caso em que a variável contém um valor do tipo declarado, +- uma [referência de classe](Concepts/classes.md) (classe 4D ou classe de usuário), caso em que a variável contém uma referência a um objeto da classe definida. Se `varType` for omitido, será criada uma variável do tipo **variant**. @@ -86,7 +86,7 @@ A sintaxe legada usando comandos `C_XXX` está obsoleta a partir de 4D 20 R7. ### Exemplos - - Para declarar variáveis básicas locais e de processo: +- Para declarar variáveis básicas locais e de processo: ```4d var $myText; myText; $vt : Text @@ -98,14 +98,14 @@ var $o : 4D. Object //also equivalent to C_OBJECT($o) ``` - - Para declarar variáveis objeto da classe 4D: +- Para declarar variáveis objeto da classe 4D: ```4d var $myFolder : 4D. Folder var $myFile : 4D. File ``` - - Para declarar as variáveis objeto da classe usuário: +- Para declarar as variáveis objeto da classe usuário: ```4d var $myClass : cs. MyClass @@ -193,9 +193,9 @@ Uma variável local é, como o seu nome indica, local para um método - apenas a Poderá querer utilizar uma variável local para: - - Evitar conflitos com os nomes de outras variáveis - - Utilizar dados temporariamente - - Reduzir o número de variáveis do processo +- Evitar conflitos com os nomes de outras variáveis +- Utilizar dados temporariamente +- Reduzir o número de variáveis do processo O nome de uma variável local começa sempre com um sinal de dólar ($) e pode conter até 31 caracteres adicionais. Se introduzir um nome mais longo, 4D trunca o nome com o comprimento apropriado. @@ -224,9 +224,9 @@ No modo interpretado, as variáveis são mantidas dinamicamente; são criadas e Um processo pode "espiar e cutucar" as variáveis de processo de outro processo usando os comandos `GET PROCESS VARIABLE` e `SET PROCESS VARIABLE`. É boa prática de programação restringir a utilização destes comandos à situação para a qual foram adicionados à 4D: - - Comunicação interprocessada em locais específicos ou o seu código - - Gestão de arrastar e soltar entre processos - - Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor +- Comunicação interprocessada em locais específicos ou o seu código +- Gestão de arrastar e soltar entre processos +- Em Cliente/Servidor, comunicação entre os processos nas máquinas do cliente e os procedimentos armazenados a correr nas máquinas do servidor Para obter mais informações, consulte o capítulo **Processos** e a descrição desses comandos. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md index b9adc187e15af2..a363bac2f9beb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Debugging/basics.md @@ -33,13 +33,13 @@ Ocasionalmente, pode não haver memória suficiente para criar um BLOB. Ou, quan Estes são geralmente o tipo de erro mais difícil de encontrar. Com exceção dos erros de digitação, todos os tipos de erros acima enumerados são, em certa medida, abrangidos pela expressão "erro de conceção ou de lógica". Utilice el [depurador ](debugger.md) para detectarlos. Por exemplo: - - Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. - - Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. +- Puede ocurrir un *error de sintaxis* cuando intenta utilizar una variable que aún no está inicializada. +- Puede ocurrir un *error de entorno* cuando intenta abrir un documento, porque el nombre de ese documento es recibido por una subrutina que no obtuvo el valor correcto como parámetro. Os erros de concepção ou lógicos incluem também situações como: - - Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. - - Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. +- Un registro no está correctamente actualizado porque, mientras se llama a `SAVE RECORD`, se olvidó de la primera prueba de si el registro estaba bloqueado o no. +- Um método não faz exatamente o que se espera, porque a presença de um parâmetro opcional não é testada. Por vezes, a parte do código que apresenta o erro pode ser diferente do código que está efetivamente na origem do problema. @@ -55,8 +55,8 @@ Para encontrar rapidamente a origem do problema, reabrir a versão interpretada A janela erro de sintaxe aparece automaticamente quando a execução de um método é interrompida. Isto pode acontecer quando: - - um erro impede a continuação da execução do código - - el método produce una afirmación falsa (ver el comando `ASSERT`) +- um erro impede a continuação da execução do código +- el método produce una afirmación falsa (ver el comando `ASSERT`) ![syntax-error](../assets/en/Debugging/syntax-error.png) @@ -64,11 +64,11 @@ A área de texto superior apresenta uma mensagem que descreve o erro. A área de A janela de erro de sintaxe propõe várias opções: - - **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. +- **Modificar**: detiene la ejecución de todos los métodos. 4D muda para o ambiente de Design e o método com o erro é aberto no Editor de Código, permitindo sua correção. Utilize esta opção quando reconhecer imediatamente o erro e puder corrigi-lo sem mais investigações. - - **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. +- **Rastrear**: entra en modo Rastrear/Depurador. Se muestra la ventana del [Depurador](debugger.md). Si la línea actual solo se ha ejecutado parcialmente, es posible que tenga que hacer clic en el botón **rastrear** varias veces. - - **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. +- **Continuar**: la ejecución continua. A linha com o erro pode ser parcialmente executada, dependendo da localização do erro. Continue com cuidado: o erro pode impedir que o resto do seu método seja executado corretamente. 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. :::tip @@ -76,14 +76,14 @@ Para ignorar um erro que ocorre repetidamente (por exemplo, em loops), você pod ::: - - **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: +- **Abortar**: Interrompe a execução do método e retorna ao estado antes do método começar a executar: - Se um método formulário ou um método objeto estiver a ser executado em resposta a um evento, é interrompido e o usuário regressa ao formulário. - Se o método estiver sendo executado a partir do ambiente Application, o usuário regressa a esse ambiente. - - **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. +- **Copiar**: copia as informações de depuração na área de transferência. A informação descreve o ambiente interno do erro (número, componente interno, etc.). Eles são formatados como texto tabulado. - - **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. +- **Salvar...**: Salva o conteúdo da janela de erro de sintaxe e a cadeia de chamadas em um arquivo `.txt`. ## Depurador diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md index 2a60af42b95a19..80a1137339c4f8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Desktop/clientServer.md @@ -71,7 +71,7 @@ Quando uma atualização . versão dz do projeto foi produzida em 4D Server, má Quando o 4D se conectar a um Servidor 4D na mesma máquina, a aplicação se comporta como 4D em modo de usuário único e o ambiente de design permite que você edite os arquivos do projeto. Esse recurso permite que você desenvolva uma aplicação de cliente/servidor no mesmo contexto que o contexto de implantação. -> Quando o 4D se conecta a um 4D Server na mesma máquina, o **modo de desenvolvimento** é ativado automaticamente, independentemente do status da [opção de abertura](#opening-a-remote-project). +> When 4D connects to a 4D Server on the same machine, the **development mode** is automatically activated, whatever the [Activate development mode](#opening-a-remote-project) option status. Cada vez que o 4D realiza uma ação **Salvar tudo** no ambiente de design (explicitamente no menu **Arquivo** ou implicitamente ao alternar para o modo de aplicativo, por exemplo), o 4D Server recarrega sincronizadamente os arquivos do projeto. O 4D espera o servidor 4D terminar de recarregar os arquivos do projeto antes de continuar. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md index 4b80f44d529a0b..58ac0e31a2c1ba 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onAfterEdit.md @@ -15,10 +15,10 @@ Este evento pode ser usado para filtrar a entrada de dados nos objetos digitáve Quando é usado, este evento é gerado após cada alteração feita no conteúdo de um objeto inserível, independentemente da ação que causou a alteração, *ou seja*: - - Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; - - Eliminar um valor (ação semelhante a colar); - - Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. - - Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). +- Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar; +- Eliminar um valor (ação semelhante a colar); +- Qualquer entrada de teclado feita pelo usuário; neste caso, o evento `On After Edit` é gerado após os eventos [`On Before Keystroke`](onBeforeKeystroke.md) e [`On After Keystroke`](onAfterKeystroke.md), se eles forem utilizados. +- Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja, `POST KEY`). No evento `No After Edit`, os dados de texto sendo inseridos são retornados pelo comando [`Obter texto editado`](../commands-legacy/get-edited-text.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md index ad1fefab5585b6..6bee42c9714cb1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onBeginDragOver.md @@ -15,9 +15,9 @@ O evento `Ao Começar Arrastar Novo` pode ser selecionado para quaisquer objetos O evento `On Begin Drag Over` é útil para preparar a ação de arrastar. Pode ser usado para: - - Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). - - Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). - - Accept or refuse dragging via the result of the method of the dragged object. +- Adicione dados e assinaturas ao pasteboard (via o comando `APPEND DATA TO PASTEBOARD`). +- Use um ícone personalizado durante a ação de arrastar (via o comando `SET DRAG ICON`). +- Accept or refuse dragging via the result of the method of the dragged object. - To indicate that drag actions are accepted, the method of the source object must return 0 (zero). - To indicate that drag actions are refused, the method of the source object must return -1 (minus one). - Se nenhum resultado for retornado, 4D considera que as ações de arrastar são aceitas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md index 1360748863f4b4..7584b63ca7234e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onClicked.md @@ -15,11 +15,11 @@ El evento `On Clicked` se genera cuando el usuario hace clic en un objeto. El evento `On Clicked` suele producirse una vez que se suelta el botón del ratón. No entanto, há várias excepções: - - [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. - - [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. - - [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. - - [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual - - Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. +- [Botones invisibles](FormObjects/properties_Display.md#not-rendered): el evento `On Clicked` se produce en cuanto se hace clic y no espera a que se suelte el botón del ratón. +- [Reglas](FormObjects/ruler.md): si la opción de [método de ejecución del objeto](FormObjects/properties_Action.md#execute-object-method) se define en **true**, el evento `On Clicked` se produce en cuanto se hace clic. +- [Combo box](FormObjects/comboBox_overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú asociado. Un [combo box](FormObjects/comboBox_overview.md) debe ser tratado como un área de texto introducible cuya lista desplegable asociada ofrece valores por defecto. Por lo tanto, se maneja la entrada de datos dentro de un combo box a través de los eventos `On Before Keystroke`, `On After Keystroke` y `On Data Change`. +- [Listas desplegables](FormObjects/dropdownList_Overview.md): el evento `On Clicked` ocurre sólo si el usuario selecciona otro valor en el menú. El evento `On Data Change` permite detectar la activación del objeto cuando se selecciona un valor diferente al actual +- Cuando una celda de entrada del list box está [siendo editada](FormObjects/listbox_overview.md#managing-entry), se genera el evento `On Clicked` cuando se presiona el botón del ratón, permitiendo utilizar el comando `Contextual click` por ejemplo. En el contexto de un evento `On Clicked`, se puede comprobar el número de clics realizados por el usuario utilizando el comando `Clickcount`. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md index e6e64421975ec5..2f5c15447aacbe 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDisplayDetail.md @@ -19,7 +19,7 @@ Um registro está prestes a ser exibido em um formulário de lista exibido via ` Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada registo: +- Para cada registo: - Para cada objecto na área de detalhes: - Método objecto com o evento `On Display Detail` - Método formulário com o evento `On Display Detail` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md index e91261464d1b11..3e97f1006409be 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onDragOver.md @@ -11,8 +11,8 @@ title: On Drag Over O evento `Ao Arrastar Para` é repetidamente enviado para o objeto de destino quando o ponteiro do mouse é movido sobre o objeto. Em resposta a este evento, normalmente: - - Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). - - Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. +- Obtenha os dados e assinaturas encontrados no pasteboard (via o comando `GET PASTEBOARD DATA`). +- Dependendo da natureza e do tipo de dados na área de transferência, você **aceita** ou **rejeita** o arrastar e soltar. Para **aceitar** a arraste, o método objeto de destino deve retornar 0 (zero). Para **rejeitar** o arraste, o método objeto deve retornar -1 (menos um). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md index e5dad3403346ed..b45956f76b1c66 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeader.md @@ -15,7 +15,7 @@ El evento `On Header` se llama cuando un registro está a punto de ser visualiza Neste contexto, a seguinte sequência de chamadas para os métodos e eventos de formulário é ativada: - - Para cada objecto na área do cabeçalho: +- Para cada objecto na área do cabeçalho: - Método objeto con el evento `On Header` - Método formulario con el evento `On Header` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md index 8539316186b800..8fb9d7da298645 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Events/onHeaderClick.md @@ -15,8 +15,8 @@ Esse evento é gerado quando ocorre um clique no cabeçalho de uma coluna de lis Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) tiver sido selecionada para o list box, você poderá decidir se autoriza ou não uma classificação padrão da coluna passando o valor 0, ou -1 na variável `$0`: - - Se `$0` for igual a 0, é efetuada uma ordenação padrão. - - Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. +- Se `$0` for igual a 0, é efetuada uma ordenação padrão. +- Se `$0` for igual a -1, uma classificação padrão não será executada e o cabeçalho não exibirá a seta de classificação. O desenvolvedor ainda pode gerar uma classificação de coluna com base em critérios de classificação personalizados usando a linguagem 4D. Se a propriedade [Sortable](FormObjects/properties_Action.md#sortable) não estiver selecionada para o list box, a variável `$0` não será usada. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md index f98382730ba66b..67a39c8d81d25d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/forms.md @@ -9,16 +9,16 @@ Os formulários constituem a interface através da qual a informação é introd Os formulários também podem conter outros formulários através das seguintes funcionalidades: - - [objetos de subformulário](FormObjects/subform_overview.md) - - [formulários herdados](./properties_FormProperties.md#inherited-form-name) +- [objetos de subformulário](FormObjects/subform_overview.md) +- [formulários herdados](./properties_FormProperties.md#inherited-form-name) ## Criar formulários É possível adicionar ou modificar formulários 4D usando os seguintes elementos: - - **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. - - **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. - - **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: +- **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**. +- **Form Editor**: Modifique seus formulários usando o **[Editor de formulários](FormEditor/formEditor.md)**. +- **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture#sources). Exemplo: ``` { @@ -70,9 +70,9 @@ Os formulários também podem conter outros formulários através das seguintes Existem duas categorias de formulários: - - **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. +- **Formulários de projeto** - Formulários independentes que não estão anexados a nenhuma tabela. Eles são destinados principalmente para criar caixas de diálogo de interface, bem como componentes. Os formulários do projeto podem ser usados para criar interfaces que estejam em conformidade com os padrões do sistema operacional. - - **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. +- **Formulários de tabela** - Vinculados a tabelas específicas e, portanto, beneficiam-se de funções automáticas úteis para o desenvolvimento de aplicativos baseados em bancos de dados. Normalmente, uma tabela tem formulários de entrada e saída separados. Normalmente, você seleciona a categoria do formulário quando o cria, mas pode alterá-la posteriormente. @@ -80,15 +80,15 @@ Normalmente, você seleciona a categoria do formulário quando o cria, mas pode Cada formulário é composto por, pelo menos, duas páginas: - - uma página 1: uma página principal, exibida por defeito - - uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. +- uma página 1: uma página principal, exibida por defeito +- uma página 0: uma página de fundo, cujo conteúdo é exibido em todas as outras páginas. É possível criar várias páginas para um formulário de entrada. Se você tiver mais campos ou variáveis do que cabem em uma tela, você pode querer criar páginas adicionais para exibi-los. As páginas múltiplas permitem-lhe fazer o seguinte: - - Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. - - Organize cada tópico na sua própria página. - - Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). - - Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. +- Coloque as informações mais importantes na primeira página e as informações menos importantes nas outras páginas. +- Organize cada tópico na sua própria página. +- Reduza ou elimine a rolagem durante a entrada de dados definindo a [ordem de entrada](formEditor.md#data-entry-order). +- Fornece espaço em torno dos elementos de formulário para um design de tela atrativo. As páginas múltiplas são uma conveniência utilizada apenas para formulários de introdução. Não são para produção impressa. Quando um formulário de várias páginas é impresso, apenas a primeira página é impressa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md index 1976dfab5cc6e9..50c036cfa4e172 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/macros.md @@ -7,11 +7,11 @@ O editor de formulários 4D suporta macros. Uma macro é um conjunto de instruç Por exemplo, se você tiver um relatório recorrente com formatação específica (por exemplo, determinado texto deve aparecer em vermelho e determinado texto deve aparecer em verde), poderá criar uma macro para definir automaticamente a cor. É possível criar macros para o editor de 4D Form que podem: - - Criar e executar código 4D - - Exibir diálogos - - Seleccionar objectos do formulário - - Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades - - Modificar ficheiros de projeto (atualizar, apagar) +- Criar e executar código 4D +- Exibir diálogos +- Seleccionar objectos do formulário +- Adicionar / excluir / modificar formulários, objetos de formulário e suas propriedades +- Modificar ficheiros de projeto (atualizar, apagar) O código de macros suporta [funções de classe](Concepts/classes.md) e [propriedades de objeto de formulário em JSON](FormObjects/properties_Reference.md) para permitir que você defina qualquer recurso personalizado no editor de formulários. @@ -237,9 +237,9 @@ Por exemplo, se objectos da página actual e grupos tiverem sido modificados, po Ao lidar com o atributo 'método' de objetos de formulário, você pode definir o valor do atributo de duas maneiras nas macros: - - Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). +- Usando uma [string contendo o nome/caminho do arquivo do método](FormObjects/properties_Action.md#method). - - Utilizar um objeto com a seguinte estrutura: +- Utilizar um objeto com a seguinte estrutura: | Propriedade | Tipo | Descrição | | ----------- | ---- | ---------------- | @@ -251,9 +251,9 @@ O 4D criará um arquivo usando o nome do objeto na pasta "objectMethods" com o c A propriedade `$4dId` define um ID exclusivo para cada objeto na página atual. Essa chave é usada pelo processador de macro para controlar as alterações em `$result.currentPage`: - - Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. - - Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. - - Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. +- Se a chave `$4dId` estiver ausente no formulário e em um objeto em `$result`, o objeto será criado. +- Se a chave `$4dId` existir no formulário, mas estiver ausente em `$result`, o objeto será excluído. +- Se a chave `$4dId` existir tanto no formulário quanto em um objeto em `$result`, o objeto será modificado. #### Exemplo @@ -296,8 +296,8 @@ A função `onError` é executada quando o processador de macros encontra um err Ao executar uma macro, se a 4D encontrar um erro que impeça a macro de ser cancelada, ela não executa o macro. É o caso, por exemplo, se a execução de uma macro resultar em: - - eliminar ou modificar um script cujo ficheiro é só de leitura. - - criar dois objectos com o mesmo ID interno. +- eliminar ou modificar um script cujo ficheiro é só de leitura. +- criar dois objectos com o mesmo ID interno. #### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md index f342d25344016c..a1d843a0e5ce70 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/objectLibrary.md @@ -7,8 +7,8 @@ Pode utilizar bibliotecas de objectos nos seus formulários. Uma biblioteca de o 4D propõe dois tipos de bibliotecas de objetos: - - uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. - - as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. +- uma biblioteca de objetos padrão, pré-configurada, disponível em todos os seus projetos. +- as bibliotecas de objetos personalizados, que você pode usar para armazenar seus objetos formulários favoritos ou formulários projetos completos. ## Criar e utilizar bibliotecas de objetos personalizadas @@ -21,10 +21,10 @@ A biblioteca é apresentada numa janela separada: A janela tem as seguintes características principais: - - Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. - - Você pode filtrar o conteúdo da janela usando o menu **Categorias**: +- Área de visualização com dicas: a área central exibe uma visualização de cada objeto. Você pode passar o mouse sobre um objeto para obter informações sobre ele em uma dica. +- Você pode filtrar o conteúdo da janela usando o menu **Categorias**: ![](../assets/en/FormEditor/library3.png) - - Para utilizar um objeto da biblioteca no seu formulário, pode: +- Para utilizar um objeto da biblioteca no seu formulário, pode: - clicar com o botão direito do rato num objeto e selecionar **Copiar** no menu contextual - ou arraste e solte o objeto da biblioteca. O objeto é então adicionado ao formulário. @@ -57,13 +57,13 @@ Uma determinada biblioteca de objetos só pode ser aberta por um m banco de dado Para abrir uma biblioteca de objetos personalizada, selecione o comando **Open>Object Library...** no menu 4D **File** ou na barra de ferramentas. Aparece uma caixa de diálogo padrão de ficheiro aberto, que lhe permite seleccionar a biblioteca de objectos a abrir. Pode seleccionar os seguintes tipos de ficheiros: - - **.4dproject** - - **.4dz** +- **.4dproject** +- **.4dz** Na realidade, as bibliotecas de objectos personalizados são projectos 4D clássicos. Apenas as seguintes partes de um projecto são expostas quando este é aberto como biblioteca: - - formulários projecto - - páginas formulário 1 +- formulários projecto +- páginas formulário 1 ### Construir uma biblioteca de objectos @@ -75,10 +75,10 @@ As operações básicas estão disponíveis no menu de contexto ou no menu de op ![](../assets/en/FormEditor/library5.png) - - **Cortar** ou **Copiar** para a área de transferência - - **Colar** um objeto da área de transferência - - **Clear** - exclui o objeto da biblioteca - - **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. +- **Cortar** ou **Copiar** para a área de transferência +- **Colar** um objeto da área de transferência +- **Clear** - exclui o objeto da biblioteca +- **Renomear** - é exibida uma caixa de diálogo que permite renomear o item. Note-se que os nomes dos objectos devem ser únicos numa biblioteca. Pode colocar objectos individuais (incluindo subformulários) ou conjuntos de objectos numa biblioteca de objectos. Cada objecto ou conjunto é agrupado num único item: @@ -94,9 +94,9 @@ A utilização de copiar-colar ou arrastar-e-soltar com determinados objetos de Segue-se uma lista de objetos dependentes que serão colados na biblioteca enquanto o objeto principal que os utiliza (quando aplicável): - - Listas - - Formatos/Filtros - - Imagens - - Dicas de ajuda (ligadas a um campo) - - Métodos objecto +- Listas +- Formatos/Filtros +- Imagens +- Dicas de ajuda (ligadas a um campo) +- Métodos objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md index a969e5a70ca62e..b3dda5c2e818e6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormEditor/properties_FormSize.md @@ -11,13 +11,13 @@ As opções de tamanho dependem do valor da opção **Tamanho baseado em**. ## Tamanho baseado em - - **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). +- **Tamanho automático**: o tamanho do formulário será o necessário para exibir todos os objetos, aos quais serão adicionados os valores de margem (em píxeis) inseridos nos campos [**Hor Margin**](#hor-margin) e [**Vert Margin**](#vert-margin). Você pode escolher essa opção quando quiser usar objetos ativos colocados em uma área fora da tela (ou seja, fora do retângulo delimitador da janela) com uma janela de tamanho automático. Graças a essa opção, a presença desses objetos não modificará o tamanho da janela. - - **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). +- **Definir tamanho**: o tamanho do formulário será baseado no que você inserir (em píxeis) nos campos [**Largura**](#width) e [**Altura**](#height). - - ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. +- ``: o tamanho do formulário será baseado na posição do objeto de formulário selecionado. Por exemplo, se você escolher um objeto que esteja posicionado na parte inferior direita da área a ser exibida, o tamanho do formulário consistirá em um retângulo cujo canto superior esquerdo será a origem do formulário e o canto inferior direito corresponderá ao do objeto selecionado, acrescido de quaisquer valores de margem. > Para formulários de saída, somente os campos [**Margem Hor**](#hor-margin) ou [**Largura**](#width) estão disponíveis. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md index a5176f940c12c9..a0fb905fcb3032 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/formObjects_overview.md @@ -9,18 +9,18 @@ O usuário constrói e personaliza os seus formulários de aplicação manipulan Os formulários 4D suportam um grande número de objetos **ativos** e **estáticos** incorporados: - - Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. - - Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. +- Os **objetos ativos** executam uma tarefa de banco de dados ou uma função de interface. Os campos são objetos ativos. Outros objetos ativos - objetos digitáveis (variáveis), combo box, listas suspensas, botões imagem, etc. - armazenam dados temporariamente na memória ou executam alguma ação, como abrir uma caixa de diálogo, imprimir um relatório ou iniciar um processo em segundo plano. +- Os **objetos estáticos** são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. ## Manipulação de objectos de formulário Pode adicionar ou modificar objetos de formulários 4D das seguintes formas: - - **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. +- **[Editor de formulários](FormEditor/formEditor.md):** arraste um objeto da barra de ferramentas do editor de formulários para o formulário. Em seguida, use a Lista de propriedades para especificar as propriedades do objeto. - - **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. +- **Linguagem 4D**: os comandos do tema `Objetos (Formulários)`, como [`OBJECT DUPLICATE`](../commands-legacy/object-duplicate.md) ou [`OBJECT SET FONT STYLE`](../commands-legacy/object-set-font-style.md), permitem criar e definir objetos de formulário. - - **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). +- **Código JSON em formulários dinâmicos:** defina as propriedades usando JSON. Use a propriedade [type](properties_Object.md#type) para definir o tipo de objeto e, em seguida, defina suas [propriedades disponíveis](properties_Reference.md). Exemplo de um objeto botão: ```json diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md index 8e433c3ecf5783..8ab820cd68cee9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/input_overview.md @@ -44,6 +44,6 @@ Você pode gerenciar os dados com os [métodos](Concepts/methods.md) objeto ou f Também pode representar expressões de campo e variáveis nos seus formulários utilizando objectos alternativos, mais particularmente: - - Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). - - Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). - - Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). \ No newline at end of file +- Você pode exibir e inserir dados dos campos do banco de dados diretamente nas colunas das [List boxes do tipo de seleção](listbox_overview.md). +- Você pode representar um campo de lista ou variável diretamente em um formulário usando objetos [Popup Menus/Listas suspensas](dropdownList_Overview.md) e [Combo Boxes](comboBox_overview.md). +- Você pode representar uma expressão booleana como um [objeto de seleção](checkbox_overview.md) ou como um [botão de opção](radio_overview.md). \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md index 903e223d25ed2f..f00c816642e524 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/list_overview.md @@ -13,8 +13,8 @@ Quando apropriado, o ícone de expansão/colapso é automaticamente apresentado O conteúdo de um objeto formulário lista hierárquica pode ser inicializado de uma das seguintes formas: - - Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. - - Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. +- Associar uma [lista de opções](properties_DataSource.md#choice-list) existente ao objeto. A lista de opções deve ter sido definida no editor de listas no modo Desenho. +- Atribuir diretamente uma referência de lista hierárquica à [variável ou expressão](properties_Object.md#variable-or-expression) associada ao objeto formulário. Em ambos os casos, você gerencia uma lista hierárquica em tempo de execução através de sua referência *ListRef*, usando os comandos de [lista hierárquica](../commands/theme/Hierarchical_Lists.md) na linguagem 4D. @@ -34,9 +34,9 @@ $mylist:=New list Cada representação da lista tem suas próprias características específicas e compartilha características comuns com todas as outras representações. As características a seguir são específicas de cada representação da lista: - - A selecção, - - O estado expandido/recolhido dos seus itens, - - A posição do cursor de rolagem. +- A selecção, +- O estado expandido/recolhido dos seus itens, +- A posição do cursor de rolagem. As outras características (fonte, tamanho da fonte, estilo, controle de entrada, cor, conteúdo da lista, ícones, etc.) são comuns a todas as representações e não podem ser modificados separadamente. Consequentemente, quando você usa comandos com base na configuração expandida/colapsada ou no item atual, por exemplo, `Count list items` (quando o parâmetro final `*` não é passado), é importante poder especificar a representação a ser usada sem nenhuma ambiguidade. @@ -56,7 +56,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) Assim como em outros comandos de gerenciamento de propriedades de objetos, é possível usar o caractere "@" no parâmetro `ListName`. Regra geral, esta sintaxe é utilizada para designar um conjunto de objetos no formulário. No entanto, no contexto dos comandos de lista hierárquica, isso não se aplica em todos os casos. Essa sintaxe tem dois efeitos diferentes, dependendo do comando: - - Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." +- Para comandos que definem propriedades, essa sintaxe designa todos os objetos cujo nome corresponde (comportamento padrão). Por exemplo, o parâmetro "LH@" designa todos os objetos do tipo lista hierárquica cujo nome começa com "LH." - `DELETE FROM LIST` - `INSERT IN LIST` - `SELECT LIST ITEMS BY POSITION` @@ -66,7 +66,7 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po - `SET LIST ITEM PARAMETER` - `SET LIST ITEM PROPERTIES` - - Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: +- Para comandos que recuperam propriedades, essa sintaxe designa o primeiro objeto cujo nome corresponde: - `Count list items` - `Find in list` - `GET LIST ITEM` @@ -82,14 +82,14 @@ Assim como em outros comandos de gerenciamento de propriedades de objetos, é po É possível modificar a aparência de uma lista hierárquica de objetos usando vários comandos 4D genéricos. Você pode passar para esses comandos o nome do objeto da lista hierárquica (usando o parâmetro \*) ou o nome da variável (contendo o valor ListRef): - - `OBJECT SET FONT` - - `OBJECT SET FONT STYLE` - - `OBJECT SET FONT SIZE` - - `OBJECT SET FILTER` - - `OBJECT SET ENTERABLE` - - `OBJECT SET SCROLLBAR` - - `OBJECT SET SCROLL POSITION` - - `OBJECT SET RGB COLORS` +- `OBJECT SET FONT` +- `OBJECT SET FONT STYLE` +- `OBJECT SET FONT SIZE` +- `OBJECT SET FILTER` +- `OBJECT SET ENTERABLE` +- `OBJECT SET SCROLLBAR` +- `OBJECT SET SCROLL POSITION` +- `OBJECT SET RGB COLORS` > Lembrete: exceto `OBJECT SET SCROLL POSIÇÃO`, esses comandos modificam todas as representações da mesma lista, mesmo que você especifique apenas uma lista usando seu nome de objeto. @@ -107,8 +107,8 @@ Esse princípio é aplicado independentemente da ordem em que os comandos são c Normalmente, você pode trabalhar de duas maneiras com o conteúdo das listas hierárquicas: por posição ou por referência. - - Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. - - Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. +- Quando se trabalha por posição, 4D se baseia na posição em relação aos itens da lista exibida na tela para identificá-los. O resultado diferirá conforme o fato de determinados itens hierárquicos serem expandidos ou recolhidos. Observe que, no caso de várias representações, cada objeto de formulário tem sua própria configuração de itens expandidos/colapsados. +- Quando você trabalha por referência, 4D se baseia no número de identificação *itemRef* dos itens da lista. Assim, cada item pode ser especificado individualmente, independentemente de sua posição ou de sua exibição na lista hierárquica. ### Utilização de números de referência dos items (itemRef) @@ -141,9 +141,9 @@ Basicamente, você precisa lidar com números de referência de itens quando qui Pode controlar se os itens da lista hierárquica podem ser modificados pelo usuário, utilizando o atalho **Alt+click**(Windows) / **Option+click** (macOS), ou fazendo um clique longo no texto do item. - - Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). +- Independentemente da fonte de dados da lista hierárquica, você pode controlar todo o objeto com a propriedade [Entrável](properties_Entry.md#enterable). - - Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). +- Além disso, se você preencher a lista hierárquica usando uma lista criada no editor de Listas, poderá controlar se um item em uma lista hierárquica é modificável usando a opção **Elemento modificável** no editor de Listas. Para obter mais informações, consulte [Definir as propriedades das listas](https://doc.4d.com/4Dv20/4D/20.2/Setting-list-properties.300-6750359.en.html#1350157). ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md index 22d15fa2ac696a..e77d521325fee9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/properties_Subform.md @@ -25,13 +25,13 @@ Especifica se o utilizador pode eliminar sub-registos num subformulário lista. Esta propriedade é utilizada para declarar o formulário detalhado a utilizar no subformulário. Pode ser: - - um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ +- um widget, ou seja, um subformulário de tipo página, dotado de funções específicas. In this case, the [list subform](#list-form) and [Source](#source) properties must be empty or not present.\ You can select a component form name when it is published in the component.\ You can select a component form name when it is published in the component. > Para ello, basta con hacer dos clics en el campo a modificar para que pase al modo edición (asegúrese de dejar suficiente tiempo entre los dos clics para no generar un doble clic). - - el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. +- el formulario detallado a asociar al [subformulario listado](#formulario-de-lista). O formulário detalhado pode ser utilizado para introduzir ou visualizar sub-registos. Geralmente contém mais informações do que o subformulário lista. Naturalmente, o formulário detalhado deve pertencer à mesma tabela que o subformulário. Normalmente, utiliza-se um formulário de saída como formulário lista e um formulário de entrada como formulário detalhado. Se não especificar o formulário a ser usado para a entrada de página inteira, 4D automaticamente usa o formato de entrada padrão da tabela. #### Gramática JSON @@ -49,8 +49,8 @@ Esta propriedade é utilizada para declarar o formulário detalhado a utilizar n Ação a ser executada no caso de um clique duplo em uma linha vazia de um subformulário lista. As opções abaixo estão disponíveis: - - Não fazer nada: Ignora o duplo clique. - - Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. +- Não fazer nada: Ignora o duplo clique. +- Adicionar registro: cria um registro no subformulário e muda para o modo edição. El registro se creará directamente en la lista si la propiedad [Editable en la lista](#enterable-in-list) está activada. En caso contrario, se creará en modo página, en el [formulario detallado](#detail-form) asociado al subformulario. #### Gramática JSON @@ -74,9 +74,9 @@ Ação a ser executada no caso de um clique duplo em uma linha vazia de um subfo Define a ação a ser executada quando um usuário clica duas vezes em uma linha no subformulário lista. As opções disponíveis são: - - **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. - - **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. - - **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. +- **Não fazer nada** (padrão): clicar duas vezes em uma linha não aciona nenhuma ação automática. +- **Editar registro**: al hacer doble clic en una línea se muestra el registro correspondiente en el [formulario detallado](#detail-form) definido para el subformulario lista. O registo é aberto em modo de leitura-escrita para poder ser modificado. +- **Exibir registro**: idêntico à ação anterior, exceto pelo fato de que o registro é aberto no modo somente leitura, de modo que não pode ser modificado. Independentemente da ação selecionada/escolhida, o evento de formulário `On Double clicked` é gerado. @@ -154,10 +154,10 @@ Especifica a tabela a que pertence o subformulário Lista (se existir). Designa a opção que permite aos utilizadores selecionar linhas: - - **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. - - **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ +- **Nenhum**: Linhas não podem ser selecionadas se esse modo for escolhido. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. As teclas de navegação só fazem a lista rolar, o evento de formulário `Ao selecionar mudança` não é gerado. +- **Simples**: Uma linha de cada vez pode ser selecionada neste modo. Ao clicar em uma linha, ela será selecionada. Um **Ctrl+clique** (Windows) ou **Command+clique** (macOS) em uma linha alterna seu estado (entre selecionado ou não).\ As teclas de seta para cima e para baixo selecionam a linha anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. O evento de formulário `On Selection Change` é gerado sempre que a linha atual é alterada. - - **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. +- **Multiplique**: Várias linhas podem ser selecionadas simultaneamente neste modo. - Los subregistros seleccionados son devueltos por el comando `GET HIGHLIGHTED RECORDS`. - Clicar no registro o selecionará, mas não modificará o registro atual. - Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en un registro cambia su estado (entre seleccionado o no). As teclas de seta para cima e para baixo selecionam o registo anterior/seguinte na lista. As outras teclas de navegação percorrem a lista. El evento de formulario `On Selection Change` se genera cada vez que el registro seleccionado se modifica. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md index 5e6535494a6135..befe7cdd72f1fb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/shapes_overview.md @@ -7,9 +7,9 @@ As formas são [objetos estáticos](formObjects_overview.md#active-and-static-ob As formas 4D suportam as seguintes formas básicas: - - retângulos - - linhas - - ovals +- retângulos +- linhas +- ovals ## Retângulo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md index 00c8677749a98a..c624643b6ed698 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/splitters.md @@ -11,10 +11,10 @@ O divisor é usado, por exemplo, em formulários de saída para que as colunas p Algumas das características gerais do repartidor: - - Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. - - Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. - - As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. - - Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. +- Você pode colocar quantos divisores quiser em qualquer formulário e usar uma mistura de divisores horizontais e verticais no mesmo formulário. +- Um separador pode passar por um objeto. Este objeto será redimensionado quando o divisor for movido. +- As paradas do divisor são calculadas de modo que os objetos movidos permaneçam totalmente visíveis no formulário ou não passem sob/próximo a outro divisor. Cuando la propiedad [Empujador](properties_ResizingOptions.md#pusher) está asociada a un separador, su movimiento hacia la derecha o hacia abajo no encuentra ningún tope. +- Se você redimensionar um formulário usando um divisor, as novas dimensões do formulário serão salvas somente enquanto o formulário estiver sendo exibido. Quando um formulário é fechado, as dimensões iniciais são restauradas. Uma vez inserido, o separador aparece como uma linha. Puede modificar su [estilo de borde](properties_BackgroundAndBorder.md#border-line-style) para obtener una línea más fina o [cambiar su color](properties_BackgroundAndBorder.md#line-color). @@ -55,8 +55,8 @@ Puede asociar un método objeto a un separador y será llamado con el evento `On A cada separador se le asocia una [variable](properties_Object.md#variable-or-expression) de tipo *Longint*. Esta variável pode ser utilizada nos seus métodos objeto e/ou formulário. Seu valor indica a posição atual do divisor, em píxeis, em relação à sua posição inicial. - - Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, - - Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, - - Se o valor for 0: o divisor foi movido para a sua posição original. +- Se o valor for negativo: o divisor foi movido para cima ou para a esquerda, +- Se o valor for positivo: o divisor foi movido para a parte inferior ou para a direita, +- Se o valor for 0: o divisor foi movido para a sua posição original. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. Você também pode mover o divisor de forma programática: basta definir o valor da variável associada. A movimentação é de fato realizada no final da execução do formulário ou método objeto que contém a declaração. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md index 6f384dcc2668c5..05d1da390e99f9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/stepper.md @@ -13,11 +13,11 @@ Você pode atribuir a variável associada ao objeto a uma área de entrada (camp Um stepper pode ser associado diretamente a uma variável número, hora ou data. - - Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: +- Para valores do tipo tempo, as propriedades Mínimo, Máximo e Etapa representam segundos. Por exemplo, para definir um passo de 8:00 a 18:00 com passos de 10 minutos: - [mínimo](properties_Scale.md#minimum) = 28 800 (8\*60\*60) - [maximum](properties_Scale.md#maximum) = 64 800 (18\*60\*60) - [step](properties_Scale.md#step) = 600 (10\*60) - - Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. +- Para valores do tipo data, o valor inserido na propriedade [step](properties_Scale.md#step) representa dias. As propriedades Mínimo e Máximo são ignoradas. > For the stepper to work with a time or date variable, it is imperative to set its type in the form AND to [declare it explicitly](../Concepts/variables.md#declaring-variables) as `Time` or `Date`. @@ -29,8 +29,8 @@ Para mais informações, consulte [Usando indicadores](progressIndicator.md#usin ## Veja também - - [progress indicators](progressIndicator.md) - - [rulers](ruler.md) +- [progress indicators](progressIndicator.md) +- [rulers](ruler.md) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md index b472d374fe88ba..e1f1d4853cf367 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/subform_overview.md @@ -9,12 +9,12 @@ Um subformulário é um formulário incluído noutro formulário. Para definir claramente os conceitos implementados com subformulários, aqui estão algumas definições para certos termos utilizados: - - **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. - - **Formulário pai**: um formulário que contém um ou mais subformulários. - - **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. - - **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. - - **Formulário lista**: instância do subformulário exibido como uma lista. - - **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. +- **Subformulário**: um formulário destinado a ser incluído em outro formulário, ele próprio chamado formulário pai. +- **Formulário pai**: um formulário que contém um ou mais subformulários. +- **Contêiner de subformulário**: um objeto incluído no formulário pai, que exibe uma instância do subformulário. +- **Instância de subformulário**: a representação de um subformulário em um formulário pai. Esse conceito é importante porque é possível exibir várias instâncias do mesmo subformulário em um formulário pai. +- **Formulário lista**: instância do subformulário exibido como uma lista. +- **Formulário detalhado**: formulário de entrada do tipo página associado a um subformulário do tipo lista que pode ser acessado com um clique duplo na lista. ## Sub formulários lista @@ -43,8 +43,8 @@ Você pode vincular [uma variável ou uma expressão](properties_Object.md#varia Por padrão, 4D cria uma variável ou expressão de [tipo de objeto](properties_Object.md#expression-type) para um contêiner de subformulário, que lhe permite compartilhar valores no contexto do subformulário usando o comando `Form`. No entanto, você pode usar uma variável ou expressão de qualquer tipo escalar (tempo, inteiro, etc.) especialmente se você só precisa compartilhar um único valor: - - Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. - - Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. +- Defina uma variável vinculada ou expressão de um tipo escalar e chame os comandos `OBJECT Get subform container value` e `OBJETO SET SUBFORM CONTAINADOR VALUE` para trocar valores quando ocorreram eventos os eventos [On Bound Variable Change](../Events/onBoundVariableChange.md) ou [On Data Change](../Events/onDataChange.md). Esta solução é recomendada para sincronizar um único valor. +- Defina una variable o expresión vinculada del tipo **objecto** y utilice el comando `Form` para acceder a sus propiedades desde el subformulario. Esta solução é recomendada para sincronizar vários valores. ### Sincronização do formulário principal e do subformulário (valor único) @@ -58,8 +58,8 @@ No formulário pai, ambos os objetos (área de entrada e contêiner de subformul To display a static time, you must use the appropriate [data type](properties_DataSource.md#data-type-expression-type) for the [variable or expression](properties_Object.md#variable-or-expression): - - Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. - - Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. +- Si utiliza una variable (por ejemplo, `parisTime`), debe ser del tipo `texto` o `tiempo`. +- Si utiliza una expresión (por ejemplo, `Form.myValue`), debe contener un valor `texto`. O valor do texto deve ter o formato "hh:mm:ss". @@ -88,15 +88,15 @@ Actualiza el valor de `Form.clockValue` en el subformulario: Se genera el evento formulario [On Bound Variable Change](../Events/onBoundVariableChange.md): - - assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído - - se o subformulário pertence à página formulário atual ou à página 0. +- assim que um valor for atribuído à variável/expressão do formulário pai, mesmo que o mesmo valor seja reatribuído +- se o subformulário pertence à página formulário atual ou à página 0. Note that, as in the above example, it is preferable to use the `OBJECT Get subform container value` command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks). Modificar a variável ou expressão vinculada aciona eventos de formulário que permitem sincronizar os valores do formulário pai e do subformulário: - - Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. - - Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. +- Utilice el evento de formulario [On Bound Variable Change](../Events/onBoundVariableChange.md) para indicar al subformulario (método de formulario del subformulario) que la variable o expresión fue modificada en el formulario padre. +- Utilice el evento de formulario [On Data Change](../Events/onDataChange.md) para indicar al contenedor del subformulario que el valor de la variable o expresión fue modificado en el subformulario. #### Atualização do conteúdo de um formulário pai @@ -169,8 +169,8 @@ A comunicação entre o formulário pai e as instâncias do subformulário pode 4D implementou os seguintes mecanismos para atender a essas necessidades: - - Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` - - Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` +- Llamada de un objeto contenedor desde el subformulario utilizando el comando `CALL SUBFORM CONTAINER` +- Ejecución de un método en el contexto del subformulario mediante el comando `EXECUTE METHOD IN SUBFORM` > El comando `GOTO OBJECT` busca el objeto de destino en el formulario padre aunque se ejecute desde un subformulario. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md index f63a09ee25c6a1..ddfbf5182f546a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/tabControl.md @@ -42,9 +42,9 @@ No macOS, além da posição padrão (superior), os controles de aba também pod Para fornecer as etiquetas para o controle de abas, você pode usar: - - um objeto - - uma lista de escolha - - um array +- um objeto +- uma lista de escolha +- um array ### Utilização de um objecto diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md index 1874c230c87282..b46a43a9cb707f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/FormObjects/text.md @@ -33,9 +33,9 @@ Quando um texto é rodado, pode continuar a alterar o seu tamanho ou posição, ![](../assets/en/FormObjects/staticText2.png) - - Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; - - Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; - - Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. +- Se o objeto for redimensionado na direção A, seu [largura](properties_CoordinatesAndSizing.md#width) será modificada; +- Se o objeto for redimensionado em direção C, seu [altura](properties_CoordinatesAndSizing.md#height) será modificada; +- Se o objeto for redimensionado na direção B, ambos seus [largura](properties_CoordinatesAndSizing.md#width) e [altura](properties_CoordinatesAndSizing.md#height) serão modificados. ## Propriedades compatíveis diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md index 0db70ea8c41d72..b580086cf8714d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/analysis.md @@ -14,9 +14,9 @@ Cada operação registada no ficheiro de registo aparece como uma linha. As colu Essas informações permitem que você identifique a origem e o contexto de cada operação: - - **Operación**: número de secuencia de la operación en el archivo de historial. +- **Operación**: número de secuencia de la operación en el archivo de historial. - - **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: +- **Acción**: tipo de operación realizada sobre los datos. Esta coluna pode conter uma das seguintes operações: - Abertura de ficheiro de dados: abertura de um ficheiro de dados. - Encerramento do ficheiro de dados: encerramento de um ficheiro de dados aberto. - Criação de um contexto: criação de um processo que especifica um contexto de execução. @@ -30,21 +30,21 @@ Essas informações permitem que você identifique a origem e o contexto de cada - Cancelamento da transação: transação cancelada. - Contexto de actualización: cambio de datos adicionales (por ejemplo, una llamada a `CHANGE CURRENT USER` o `SET USER ALIAS`). - - **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. +- **Tabla**: tabla a la que pertenece el registro añadido/borrado/modificado o el BLOB. - - **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. +- **Llave primaria/BLOB**: contenido de la llave primaria de cada registro (cuando la llave primaria se compone de varios campos, los valores se separan con punto y coma) o número de secuencia del BLOB implicado en la operación. - - **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. +- **Proceso**: número interno del proceso en el que se realizó la operación. Este número interno corresponde ao contexto da operação. - - **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. +- **Tamaño**: tamaño (en bytes) de los datos procesados por la operación. - - **Fecha y hora**: fecha y hora en que se realizó la operación. +- **Fecha y hora**: fecha y hora en que se realizó la operación. - - **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. +- **Usuario sistema**: nombre del sistema del usuario que realizó la operación. Em modo cliente-servidor, o nome da máquina do lado do cliente é exibido; em modo monousuário, a ID do usuário é exibida. - - **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. +- **Usuario 4D**: nombre de usuario 4D del usuario que ha realizado la operación. Se um alias for definido para o usuário, o alias será exibido em vez do nome de usuário 4D. - - **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ +- **Valores**: valores de los campos del registro en caso de adición o de modificación. Os valores são separados por ";". Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ Only values represented in alphanumeric form are displayed.\ @@ -56,7 +56,7 @@ Essas informações permitem que você identifique a origem e o contexto de cada Only values represented in alphanumeric form are displayed.\ ***Note:** If the database is encrypted and no valid data key corresponding to the open log file has been provided, encrypted values are not displayed in this column.* - - **Registros**: número del registro. +- **Registros**: número del registro. Haga clic en **Analizar** para actualizar el contenido del archivo de historial actual de la aplicación seleccionada (llamado por defecto nomdatos.journal). O botão Navegar pode ser usado para selecionar e abrir outro arquivo de histórico para o banco de dados. El botón **Exportar...** puede utilizarse para exportar el contenido del archivo como texto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md index 9e41edffd4dc64..09310d45b91db1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/MSC/repair.md @@ -51,13 +51,13 @@ Al hacer clic en **Escanear y reparar...**, 4D realiza un análisis completo del A área "Registros encontrados no arquivo de dados" inclui duas tabelas que resumem as informações da varredura do arquivo de dados. - - A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: +- A primeira tabela lista as informações provenientes da verificação do ficheiro de dados. Cada linha mostra um grupo de registos recuperáveis no ficheiro de dados: - La columna **Orden** indica el orden de recuperación del grupo de registros. - La columna **Número** indica el número de los registros de la tabla. - La columna **Tabla de destino** indica los nombres de las tablas que se asignaron automáticamente a los grupos de registros identificados. Os nomes das tabelas atribuídas aparecem automaticamente a verde. Os grupos que não foram atribuídos, ou seja, as tabelas que não puderam ser associadas a nenhum registro, aparecem em vermelho. - La columna **Recuperar** le permite indicar, para cada grupo, si quiere recuperar los registros. Por padrão, essa opção é marcada para todos os grupos com registros que podem ser associados a uma tabela. - - A segunda tabela lista as tabelas do ficheiro de projeto. +- A segunda tabela lista as tabelas do ficheiro de projeto. ### Atribuição manual @@ -74,7 +74,7 @@ Utilice el botón **Ignorar registros** para eliminar la asociación realizada m Depois que a reparação terminar, 4D gera um arquivo de histórico na pasta Logs do banco de dados. Este arquivo permite visualizar todas as operações efectuadas. É criado no formato XML e chamado: *DatabaseName\*\*_Repair_Log_yyyy-mm-dd hh-mm-ss.xml*" onde: - - *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", - - *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". +- *ApplicationName* es el nombre del archivo del proyecto sin ninguna extensión, por ejemplo "Facturas", +- *yyyy-mm-dd hh-mm-ss* es la marca de tiempo del archivo, basada en la hora del sistema local cuando se inició la operación de mantenimiento, por ejemplo "2019-02-11 15-20-45". Al presionar el botón **Abrir archivo de historial**, 4D muestra el archivo de historial más reciente en el navegador por defecto de la máquina. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md index 8f021dcc8bfb44..f40f48cfb91711 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Menus/properties.md @@ -11,8 +11,8 @@ La propiedad **Title** contiene la etiqueta de un menú o elemento de menú tal No editor do Menu, pode introduzir directamente a etiqueta como "hard coded". Ou, pode introduzir uma referência para uma variável ou um elemento XLIFF, o que facilitará a manutenção e tradução das aplicações. Pode utilizar os seguintes tipos de referências: - - Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. - - Un nombre de variable interproceso seguido de un número, por ejemplo: +- Uma referência de recurso XLIFF do tipo :xliff:MyLabel. Para más información sobre las referencias XLIFF, consulte la sección *Arquitectura XLIFF* en *Referencia Diseño 4D*. +- Un nombre de variable interproceso seguido de un número, por ejemplo: `:<>vlang,3`. A alteração do conteúdo desta variável modificará a etiqueta do menu quando esta for exibida. Neste caso, a etiqueta chamará um recurso XLIFF. El valor contenido en la variable `<>vlang` corresponde al atributo *id* del elemento *group*. El segundo valor (3 en este ejemplo) designa el atributo *id* del elemento *trans-unit*. Utilizando el lenguaje 4D, se define la propiedad del título a través del parámetro *itemText* de los comandos `APPEND MENU ITEM`, `INSERT MENU ITEM`, y `SET MENU ITEM`. @@ -54,8 +54,8 @@ A escolha entre associar uma ação padrão ou um método de projecto a um coman É possível atribuir um método de projecto e/ou uma acção padrão a um comando de menu seleccionado no editor de Menu: - - **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. - - **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. +- **Nombre del método**: seleccione un nombre de método proyecto existente en el combo box. If the project method does not exist, enter its name in the "Method Name" combo box then click on the [...] button. 4D exibe um diálogo de criação de métodos de projecto que é utilizado para aceder ao editor de métodos. +- **Acción estándar asociada**: elija o escriba la acción que desea asignar en el combo box "Acción estándar asociada". Pode introduzir qualquer acção apoiada e (opcionalmente) parâmetro que deseje na área. Para obtener una lista completa de acciones estándar, consulte la sección **Acciones estándar** en el *Modo Diseño*. **Nota para macOS:** en macOS, los comandos de menús personalizados asociados a la acción *Salir* se colocan automáticamente en el menú de la aplicación, conforme a los estándares de interfaz de la plataforma. Utilizando el lenguaje 4D, puedes asociar un método proyecto utilizando el comando `SET MENU ITEM METHOD`, y una acción estándar utilizando el comando `SET MENU ITEM PROPERTY`. @@ -102,13 +102,13 @@ Pode adicionar atalhos de teclado a qualquer comando de menu. Se um comando de m También puede añadir la tecla **Mayús**, así como la tecla **Alt** (Windows) u **Opción** (macOS) al acceso directo asociado a un comando de menú. Isto multiplica o número de atalhos que podem ser utilizados. Os seguintes tipos de atalhos de teclado podem, portanto, ser definidos: - - Em Windows: +- Em Windows: - Ctrl+caractere - Ctrl+Shift+caracter - Ctrl+Alt+caractere - Ctrl+Shift+Alt+caractere - - Em macOS: +- Em macOS: - Comando+caractere - Comando+Shift+caracter - Comando+Opção+característica diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md index c83e050d911d14..c221bb4e3450c6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Notes/updates.md @@ -9,19 +9,19 @@ Leia [**O que há de novo no 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). - - O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). - - New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. - - Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). - - Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. - - Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. - - Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). - - [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. - - Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. - - Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). - - Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. - - A [biblioteca \*MeCab](../settings/database.md#support-of-mecab-japanese-version) (usada para classificação/busca na língua japonesa) está obsoleta e seu suporte será removido na próxima versão. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs corrigidos em 4D 20 R7. +- Suporte de [tokens de sessão](../WebServer/sessions.md#session-token-otp) manipulado com as novas funções [`Session.createOTP()`](../API/SessionClass.md#createotp) e [`Session.restore()`](../API/SessionClass.md#restore). +- O assistente de etiqueta agora usa o editor de fórmula para adicionar ou editar fórmulas na [área de design de etiqueta](../Desktop/labels.md#label-preview). +- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Os comandos e constantes obsoletos agora geram warnings específicos no [live checker e no compilador](../code-editor/write-class-method.md#warnings-and-errors). Você pode saber se um comando está obsoleto usando o comando [`Command name`](../commands/command-name.md). +- Novos comandos [WA SET CONTEXT](../commands/wa-set-context.md) e [WA Get context](../commands/wa-get-context.md) para controlar o conteúdo de [$4d](../FormObjects/webArea_overview.md#4d-object) em áreas da Web. +- Novo [parâmetro de banco de dados `RD`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) para otimizar, por exemplo, a área de transferência compartilhada ao usar o protocolo remoto desktop com 4D. +- Os componentes interpretados agora podem ser [editados a partir do projeto host](../Extensions/develop-components.md#editing-components-from-the-host). +- [Licencias](../Admin/licenses.md) são agora atualizadas automaticamente na inicialização. +- Nova [4D AIKit component](../aikit/overview.md) permitindo a interação com APIs de terceiros. +- Os seguintes comandos de callbacks de comando VP agora esperam que todas as funções personalizadas 4D completem seus cálculos: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md) e [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md). +- Novos recursos [4D Netkit](https://developer.4d.com/4D-NetKit/) para gerenciar agendas do Google e do Microsoft 365; capacidade de usar o servidor web de hospedagem para autenticação OAuth 2.0. +- A [biblioteca \*MeCab](../settings/database.md#support-of-mecab-japanese-version) (usada para classificação/busca na língua japonesa) está obsoleta e seu suporte será removido na próxima versão. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R9): lista de todos os bugs corrigidos em 4D 20 R7. ## 4D 20 R8 @@ -29,29 +29,29 @@ Leia [**O que há de novo no 4D 20 R8**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). - - As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). - - Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). - - Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. - - [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. - - [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. - - Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#build-an-evaluation-application) na caixa de diálogo Criar aplicativo. - - Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. - - Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) para registro detalhado de eventos TCP. - - Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. - - 4D Write Pro: +- Implemente seus próprios [**HTTP request handlers**](../WebServer/http-request-handler.md) usando a nova classe [`4D.IncomingMessage`](../API/IncomingMessageClass.md). +- As expressões usadas em [form object properties](../FormObjects/properties_Reference.md) agora se beneficiam da verificação de sintaxe na [Property list](../FormEditor/formEditor.md#property-list) e no [Compiler](../Project/compiler.md#check-syntax). +- Você pode [associar uma classe a um formulário](../FormEditor/properties_FormProperties.md#form-class) para ativar a antecipação do tipo de código e a instanciação automática dos dados do formulário ao usar o comando [`Form`](../commands/form.md). +- Suporte de [sessões autônomas](../API/SessionClass.md) para simplificar a codificação local para aplicações cliente/servidor. +- [Depurador 4D](../Debugging/debugger.md): novo design e salvamento automático, recursos do modo de exibição. +- [Nova arquitetura de componentes construída](../Desktop/building.md#build-component) para um melhor cumprimento das diretrizes da notarização da Apple. +- Agora você pode facilmente [criar aplicativos de avaliação](../Desktop/building.md#build-an-evaluation-application) na caixa de diálogo Criar aplicativo. +- Dependências: Use o gerenciador de dependências para [verificar se há novas versões](../Project/components.md#checking-for-new-versions) e [atualizar](../Project/components.md#updating-dependencies) os componentes do GitHub. +- Novas classes [`TCPConnection`](../API/TCPConnectionClass.md) e [`TCPEvent`](../API/TCPEventClass.md) para gerenciar conexões de clientes TCP, manipular eventos e aprimorar o controle sobre a transmissão de dados. Adicionado [`4DTCPLog.txt`](../Debugging/debugLogFiles.md#4dtcplogtxt) para registro detalhado de eventos TCP. +- Novas opções em [VP EXPORT DOCUMENT](../ViewPro/commands/vp-export-document.md) e [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md) para controlar estilos, fórmulas, integridade de dados e proteção por senha. +- 4D Write Pro: - Os seguintes comandos agora permitem parâmetros, como objetos ou coleções: [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Obter atributos](../WritePro/commands/wp-get-attributes.md), [WP REDEFINIR ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [Tabela WP anexa linha](../WritePro/commands/wp-table-append-row.md), [documento de importação do WP](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), e [WP Insert picture](../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md) e [WP Insert break](../WritePro/commands/wp-insert-break.md), agora são funções que retornam intervalos. - Novas expressões relacionadas a atributos de documentos: [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) e [This.pageIndex](../WritePro/managing-formulas.md). - - Línguagem 4D: +- Línguagem 4D: - 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R8): lista de todos os bugs corrigidos em 4D 20 R8. #### Mudanças de comportamento - - Depois de uma modificação do arquivo de log usando [`SELECT LOG FILE`](../commands/select-log-file.md) ou as [configurações do backup](../Backup/settings.md#log-management), o comando [`New log file`](../commands/new-log-file.md) valida a alteração agora sem esperar por um backup. O erro -4447 (backup necessário) não foi mais gerado. - - Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. +- Depois de uma modificação do arquivo de log usando [`SELECT LOG FILE`](../commands/select-log-file.md) ou as [configurações do backup](../Backup/settings.md#log-management), o comando [`New log file`](../commands/new-log-file.md) valida a alteração agora sem esperar por um backup. O erro -4447 (backup necessário) não foi mais gerado. +- Devido à sua [nova arquitetura](../Desktop/building.md#build-component), os componentes criados com o 4D 20 R8 e superior não podem ser instalados em versões anteriores do 4D. ## 4D 20 R7 @@ -59,30 +59,30 @@ 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). - - 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#monitoring-project-dependencies). - - Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. - - Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). - - Nova palavra-chave da função [`onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funções singleton ou ORDA que podem ser chamadas por meio de [solicitações HTTP REST GET](../REST/ClassFunctions.md#function-calls). - - Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. - - Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - - New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). - - Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). - - Línguagem 4D: +- As colunas e cabeçalhos da list box de tipo tempo agora suportam a opção ["blankIfNull"](../FormObjects/properties_Display.md#time-format). +- 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#monitoring-project-dependencies). +- Novo modo [**direct typing mode**](../Project/compiler.md#enabling-direct-typing) no qual você declara todas as variáveis e parâmetros em seu código usando as palavras-chave `var` e `#DECLARE`/`Function` (somente o modo suportado em novos projetos). A [funcionalidade verificação de sintaxe](../Project/compiler.md#check-syntax) foi aprimorado de acordo. +- Suporte a [Session singletons](../Concepts/classes.md#singleton-classes) e à nova propriedade de classe [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton). +- Nova palavra-chave da função [`onHTTPGet`](../ORDA/ordaClasses.md#onhttpget-keyword) para definir funções singleton ou ORDA que podem ser chamadas por meio de [solicitações HTTP REST GET](../REST/ClassFunctions.md#function-calls). +- Nova classe [`4D.OutgoingMessage`](../API/OutgoingMessageClass.md) para que o servidor REST retorne qualquer conteúdo Web. +- Qodly Studio: agora você pode [anexar o depurador Qodly a 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). +- New Build Application keys para aplicativos 4D remotos para validar a autoridade de certificação do servidor [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.en.html) e/ou [domain](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.en.html). +- Capacidade de [criar aplicações independentes sem licenças incorporadas](../Desktop/building.md#licenses). +- Línguagem 4D: - Novos comandos: [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Comandos modificados: [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands-legacy/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*O\*". - - 4D Write Pro: +- 4D Write Pro: - Novo comando: [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Comandos modificados: [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md) e [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R7): lista de todos os bugs corrigidos em 4D 20 R7. #### Mudanças de comportamento - - As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. - - O comando [`File`](../commands/file.md) (assim como [`4D.File. ew()`](../API/FileClass.md#4dfilenew)) é mais rigorosa quando se trata de verificar a sintaxe do *caminho* fornecido como um parâmetro. - - A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Os privilégios *describe* da sessão agora são ignorados. +- As documentações para [Linguagem 4D](../commands/command-index.md) e [Linguagem 4D Write Pro](../WritePro/commands/command-index.md) estão agora totalmente disponíveis em developer.4d.com. Saiba mais sobre todos os novos recursos e alterações referentes a essas documentações nesta nota de versão. +- O comando [`File`](../commands/file.md) (assim como [`4D.File. ew()`](../API/FileClass.md#4dfilenew)) é mais rigorosa quando se trata de verificar a sintaxe do *caminho* fornecido como um parâmetro. +- A ação de [permission](../ORDA/privileges.md#permission-actions) **describe** foi removida das ações disponíveis. Acesso às urls [`/rest/$catalog`](../REST/$catalog.md) não é mais controlado. Os privilégios *describe* da sessão agora são ignorados. ## 4D 20 R6 @@ -90,25 +90,25 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) agora suporta [objeto e referências da coleção como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). - - Quando um componente tiver um [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), suas classes agora são automaticamente compartilhadas entre todos os componentes carregados no projeto host por meio de [`cs.`](../Concepts/classes.md#cs). - - Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). - - Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. - - Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. - - Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. - - Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. - - Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. - - Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). - - Uma [nova guia de parametros](../Project/compiler.md#warnings) ajuda a definir a geração de avisos globalmente. - - Vários comandos, principalmente do tema "4D Environment", agora estão seguros bem como alguns seletores dos comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Obter parâmetro de banco de dados`](../commands-legacy/get-database-parameter.md). - - Novo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que fornece o comando `PDF Obter anexos` para extrair anexos de um documento PDF/A3. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. +- Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) agora suporta [objeto e referências da coleção como valores de consulta](../API/CollectionClass.md#object-or-collection-reference-as-value). +- Quando um componente tiver um [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), suas classes agora são automaticamente compartilhadas entre todos os componentes carregados no projeto host por meio de [`cs.`](../Concepts/classes.md#cs). +- Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). +- Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. +- Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. +- Novo [arquivo 4DCEFParameters.json](../FormObjects/webArea_overview.md#4dcefparametersjson) para personalizar áreas web embutidas no 4D. +- Nova classe [HTTPAgent](../API/HTTPAgentClass.md) e nova propriedade [`agent`](../API/HTTPRequestClass.md#options-parameter) para a classe HTTPRequest. +- Novas funções [`enableState()`](../API/WebFormClass.md) e [`disableState()`](../API/WebFormClass.md) para monitorar os estados da página Qodly a partir do servidor. +- Nova [`$singleton` API](../REST/$singleton.md) para chamar funções singleton expostas do REST e novos [privilégios associados](../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). +- Uma [nova guia de parametros](../Project/compiler.md#warnings) ajuda a definir a geração de avisos globalmente. +- Vários comandos, principalmente do tema "4D Environment", agora estão seguros bem como alguns seletores dos comandos [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Obter parâmetro de banco de dados`](../commands-legacy/get-database-parameter.md). +- Novo [componente 4D-QPDF](https://github.com/4d/4D-QPDF) que fornece o comando `PDF Obter anexos` para extrair anexos de um documento PDF/A3. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R6): lista de todos os bugs corrigidos em 4D 20 R6. #### Mudanças de comportamento - - É possível rolagem acomplada nos formulários: subformulário pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingirem os limites e o usuário continuar rolando usando o mouse ou rastreador (overscrolling). - - A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). +- É possível rolagem acomplada nos formulários: subformulário pai agora rolam automaticamente quando objetos roláveis incorporados ([verticalmente](../FormObjects/properties_Appearance.md#vertical-scroll-bar) ou [horizontalmente](. /FormObjects/properties_Appearance.md#horizontal-scroll-bar)) atingirem os limites e o usuário continuar rolando usando o mouse ou rastreador (overscrolling). +- A API REST [`$catalog`](../REST/$catalog.md) agora retorna singletons (se houver). ## 4D 20 R5 @@ -116,21 +116,21 @@ Leia [**O que há de novo no 4D 20 R5**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - - Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. - - Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). - - A camada de rede QUIC agora suporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). - - Compatibilidade de [seleções da entidade restritas](../ORDA/entities.md#restricting-entity-selections). - - Compatibilidade de [clases compartidas](../Concepts/classes.md#shared-classes) e de [classes singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). - - Compatibilidade com [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). - - Novo parâmetro REST [$format](../REST/$format.md). - - O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. +- Novo [Gerenciador de componentes](../Project/components.md) para lidar com componentes por meio de um arquivo `dependencies.json`. +- Suporte a estruturas de tratamento de erros [`Try...Catch...End try`](../Concepts/error-handling.md#trycatchend-try). +- A camada de rede QUIC agora suporta [broadcasting](../Desktop/clientServer.md#opening-a-remote-project), [SSO](https://doc.4d.com/4Dv20R5/4D/20-R5/Single-Sign-On-SSO-on-Windows.300-6932709.en.html), e [IPv6](https://doc.4d.com/4Dv20R5/4D/20-R5/IP-Settings.300-6932707.en.html). +- Compatibilidade de [seleções da entidade restritas](../ORDA/entities.md#restricting-entity-selections). +- Compatibilidade de [clases compartidas](../Concepts/classes.md#shared-classes) e de [classes singleton](../Concepts/classes.md#singleton-classes). Novas propriedades de classe: [`isShared`](../API/ClassClass.md#isshared), [`isSingleton`](../API/ClassClass.md#issingleton), [`me`](../API/ClassClass.md#me). +- Compatibilidade com [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). +- Novo parâmetro REST [$format](../REST/$format.md). +- O objeto [`Session`](../commands/session.md) agora está disponível em sessões de usuários remotos e sessões de procedimentos armazenados. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R5): lista de todos os bugs corrigidos em 4D 20 R5. #### 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/). - - Alterações feitas no editor de estrutura com relação à aparência gráfica de tabelas e campos (cor, posição, ordem...) agora são salvas em um arquivo separado chamado `catalog_editor.json` armazenado na pasta [`Sources`](../Project/architecture.md#sources) do projeto. +- 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/). +- Alterações feitas no editor de estrutura com relação à aparência gráfica de tabelas e campos (cor, posição, ordem...) 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 @@ -138,24 +138,24 @@ Leia [**O que há de novo no 4D v20 R4**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Compatibilidade do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. - - As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). - - Formato HTML direto para [exportações de definição de estrutura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). - - Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. - - Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). - - Compatibilidade de [formatos personalizados de data e hora](../Project/date-time-formats.md) - - Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. - - Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). - - Nova opção de compatibilidade [Impressão sem bloqueio](../settings/compatibility.md). - - Novo [modo de edição](../Admin/dataExplorer.md#editing-data) no Data Explorer. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. +- Compatibilidade do [formato de criptografia `ECDSA`](../Admin/tls.md#encryption) para os certificados TLS. +- As conexões TLS cliente/servidor e servidor SQL agora são [configuradas dinamicamente](../Admin/tls.md#enabling-tls-with-the-other-servers) (não são necessários arquivos de certificado). +- Formato HTML direto para [exportações de definição de estrutura](https://doc.4d.com/4Dv20R4/4D/20-R4/Exporting-and-importing-structure-definitions.300-6654851.en.html). +- Novo [Code Live Checker](../code-editor/write-class-method.md#warnings-and-errors) que aprimora o controle de código durante a digitação de código, a verificação de sintaxe e as etapas de compilação para evitar erros de execução. +- Os parâmetros de métodos declarados nos protótipos `#DECLARE` [não são mais necessários nos métodos "Compiler_"](../Concepts/parameters.md). +- Compatibilidade de [formatos personalizados de data e hora](../Project/date-time-formats.md) +- Nova palavra-chave [`Try(expression)`](../Concepts/error-handling.md#tryexpression) para tratar casos de erro simples. +- Novo comando [`HTTP Parse message`](../commands/http-parse-message.md). +- Nova opção de compatibilidade [Impressão sem bloqueio](../settings/compatibility.md). +- Novo [modo de edição](../Admin/dataExplorer.md#editing-data) no Data Explorer. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R4): lista de todos os bugs corrigidos em 4D 20 R4. #### Mudanças de comportamento - - O uso de uma sintaxe herdada para declarar parâmetros (por exemplo, `C_TEXT($1)` ou `var $1 : Text`) agora está obsoleto e gera avisos nas etapas de digitação de código, verificação de sintaxe e compilação. - - As seleções agora são mantidas consistentes após alguns registros terem sido apagados e outros registros criados (veja [este post de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/). - - Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. - - Para permitir a verificação de senha quando o diretório do usuário [4D usa o algoritmo bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), o valor da "senha" no parâmetro *connectionInfo* do comando [`Open datastore`](../commands/open-datastore.md) agora é enviado de forma clara por padrão. Certifique-se de que seu método de banco de dados "Na autenticação REST" pode manipular senhas em forma clara (terceiro parâmetro é então **False**) e que `Abrir datastore` criptografa sua conexão passando a opção "tls" para **True** em *connectionInfo*. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). +- O uso de uma sintaxe herdada para declarar parâmetros (por exemplo, `C_TEXT($1)` ou `var $1 : Text`) agora está obsoleto e gera avisos nas etapas de digitação de código, verificação de sintaxe e compilação. +- As seleções agora são mantidas consistentes após alguns registros terem sido apagados e outros registros criados (veja [este post de blog](https://blog.4d.com/4d-keeps-your-selections-of-records-consistent-regarding-deletion-of-records/). +- Na atualização da [biblioteca OpenSSL](#library-table), o nível de segurança SSL/TLS padrão foi alterado de 1 para 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. +- Para permitir a verificação de senha quando o diretório do usuário [4D usa o algoritmo bcrypt](https://blog.4d.com/bcrypt-support-for-passwords/), o valor da "senha" no parâmetro *connectionInfo* do comando [`Open datastore`](../commands/open-datastore.md) agora é enviado de forma clara por padrão. Certifique-se de que seu método de banco de dados "Na autenticação REST" pode manipular senhas em forma clara (terceiro parâmetro é então **False**) e que `Abrir datastore` criptografa sua conexão passando a opção "tls" para **True** em *connectionInfo*. Em casos específicos, uma nova opção "passwordAlgorithm" também pode ser usada para fins de compatibilidade (consulte o comando [`Open datastore`](../commands/open-datastore.md)). ## 4D 20 R3 @@ -163,21 +163,21 @@ Leia [**O que há de novo no 4D v20 R3**](https://blog.4d.com/en-whats-new-in-4d #### Destaques - - Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). - - Compatibilidade do parâmetro *context* em [`Formula from string`](../commands/formula-from-string.md). - - Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). - - [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). - - Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). - - Compatibilidade para [inicializar o valor e tipo de dados da variável na linha de declaração](../Concepts/variables/#initializing-variables-in-the-declaration-line). - - As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) - - Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) - - Visualização 4D Pro: compatibilidade para o [import](../ViewPro/commands/vp-import-from-blob) e [export](../ViewPro/commands/vp-export-to-blob) dos documentos 4D View Pro no formato Blob. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. +- Nova função [`collection.multiSort`](../API/CollectionClass.md#multisort). +- Compatibilidade do parâmetro *context* em [`Formula from string`](../commands/formula-from-string.md). +- Support of `headers` property in *connectionHandler* parameter of [4D.WebSocket.new](../API/WebSocketClass.md#4dwebsocketnew). +- [Marcador de modificação global](../ORDA/global-stamp.md) para facilitar a implementação de módulos de sincronização de dados. Novas funções: [`ds.getGlobalStamp`](../API/DataStoreClass.md#getglobalstamp) e [`ds.setGlobalStamp`](../API/DataStoreClass.md#setglobalstamp). +- Atribuindo arquivo de referências a atributos de imagem/blob é [suportado no ORDA](../ORDA/entities.md#assigning-files-to-picture-or-blob-attributes). +- Compatibilidade para [inicializar o valor e tipo de dados da variável na linha de declaração](../Concepts/variables/#initializing-variables-in-the-declaration-line). +- As configurações de arquivos de log agora são [salvas com o arquivo de dados atual](../Backup/settings.md#log-management) +- Nova sintaxe para [declarar parâmetros variádicos](../Concepts/parameters.md#declaring-variadic-parameters) +- Visualização 4D Pro: compatibilidade para o [import](../ViewPro/commands/vp-import-from-blob) e [export](../ViewPro/commands/vp-export-to-blob) dos documentos 4D View Pro no formato Blob. +- [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R3): lista de todos os bugs corrigidos em 4D 20 R3. #### Mudanças de comportamento - - Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. Foi feita uma correção para que os seguintes erros agora sejam pegos também no modo compilado: *Índice fora do intervalo*, *Tipo incompatível* e *Dereferenciando um ponteiro Nulo*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). - - 4D não inclui mais um interpretador PHP interno. Você precisa [configurar e executar seu próprio interpretador PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para usar comandos PHP. +- Alguns erros foram capturados pelo seu [método de tratamento de erros](../Concepts/error-handling.md) somente no modo interpretado. Foi feita uma correção para que os seguintes erros agora sejam pegos também no modo compilado: *Índice fora do intervalo*, *Tipo incompatível* e *Dereferenciando um ponteiro Nulo*. Entretanto, para esses erros nos processadores Intel, o procedimento ainda é interrompido como antes, enquanto nos processadores Apple Silicon o procedimento só é interrompido se você chamar o comando [`ABORT`](../commands-legacy/abort.md). +- 4D não inclui mais um interpretador PHP interno. Você precisa [configurar e executar seu próprio interpretador PHP](https://blog.4d.com/deprecation-of-php-commands-and-removal-of-4d-built-in-php-interpreter) para usar comandos PHP. ## 4D 20 R2 @@ -191,15 +191,15 @@ Se suas aplicações 4D utilizam conexões TLS, é recomendado que você faça a #### Destaques - - Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. - - Nova [configuração de interface](../settings/client-server.md#network-layer) para a camada de rede QUIC. - - 4D View Pro: Compatibilidade do formato de arquivo **.sjs** para o [import](../ViewPro/commands/vp-import-document) e [export](../ViewPro/commands/vp-export-document) dos 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. - - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=20_R2): lista de todos os bugs corrigidos em 4D 20 R2. +- Nova classe [WebSocket](../API/WebSocketClass.md) para criar e gerenciar conexões WebSocket do cliente a partir de 4D. +- Nova [configuração de interface](../settings/client-server.md#network-layer) para a camada de rede QUIC. +- 4D View Pro: Compatibilidade do formato de arquivo **.sjs** para o [import](../ViewPro/commands/vp-import-document) e [export](../ViewPro/commands/vp-export-document) dos 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. +- [**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 - - **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. +- **Aviso**: o valor inicial dos objetos [`offset`](../API/FileHandleClass.md#offset) de [4D.FileHandle](../API/FileHandleClass.md) era configurado incorretamente para 1 ao invés de 0. Foi feita uma correção no 4D a partir das versões **20.1 HF1** e **20 R2** e o valor agora é 0. ## 4D 20.x LTS diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md index e27c3f1f6ae59f..819c0908dd1497 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/global-stamp.md @@ -34,8 +34,8 @@ Para habilitar el seguimiento de cambios de datos, la estructura de la aplicaci In addition, to ensure proper operation of the feature, the following conditions are required: - - El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. - - Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: +- El campo `__GlobalStamp` debe ser del tipo *Entero 64 bits*, con las propiedades *índice automático*, *Exponer como recurso REST* e *Invisible* seleccionadas. +- Debe añadirse una tabla `__DeletedRecords`, con los siguientes campos: | Campo | Tipo | Descrição | | ------------------------------------------------------- | --------------- | ------------------------------------- | @@ -64,8 +64,8 @@ Para ativar o rastreamento de alterações de dados: Em seguida, 4D faz as seguintes alterações: - - Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). - - Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. +- Se añade un campo preconfigurado `__GlobalStamp` a la(s) tabla(s). +- Si no existe ya, se añade a la estructura una tabla `__DeletedRecords`. Para desativar o rastreamento de alterações de dados: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md index e389c2e02f27d6..ca01609ba19ce8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ORDA/remoteDatastores.md @@ -17,9 +17,9 @@ The web session created on the remote datastore is identified using a internal s El `localID` es local a la máquina que se conecta al datastore remoto, lo que significa: - - Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. - - Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. - - Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. +- Si otros procesos de la misma aplicación necesitan acceder al mismo datastore remoto, pueden utilizar el mismo `localID` y, de este modo, compartir la misma sesión. +- Si otro proceso de la misma aplicación abre el mismo datastore remoto pero con otro `localID`, creará una nueva sesión en el datastore remoto. +- Si otra máquina se conecta al mismo datastore remoto con el mismo `localID`, creará otra sesión con otra cookie. Estes princípios são ilustrados nos gráficos seguintes: @@ -29,9 +29,9 @@ Estes princípios são ilustrados nos gráficos seguintes: Os processos que gerenciam sessões para acesso ao armazenamento de dados são mostrados na janela de administração do 4D Server: - - nombre: "REST Handler: \" - - type: type Worker Server HTTP - - sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. +- nombre: "REST Handler: \" +- type: type Worker Server HTTP +- sesión: el nombre de la sesión es el nombre de usuario que se pasa al comando `Open datastore`. No exemplo a seguir, dois processos estão sendo executados na mesma sessão: @@ -47,11 +47,11 @@ Se uma solicitação for enviada ao repositório de dados remoto depois que a se Os recursos do ORDA relacionados ao bloqueio de entidades e à transação são gerenciados no nível do processo em repositórios de dados remotos, assim como no modo cliente/servidor do ORDA: - - 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. - - 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`). +- 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. +- 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: +- Os bloqueios nas entidades são removidos e as transações são anuladas: - quando o processo é eliminado. - quando a sessão é encerrada no servidor - quando a sessão é encerrada na janela de administração do servidor. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md index bb7415cd78e27b..df8b713e81450d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/general.md @@ -11,12 +11,12 @@ Esta página contém várias opções para configurar o funcionamento geral da s Esta opção permite configurar o ecrã 4D por padrão no arranque, quando o usuário inicia apenas a aplicação. - - **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. - - **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. - - **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. +- **No hacer nada**: sólo aparece la ventana de la aplicación, vacía. +- **Diálogo de apertura de proyecto local**: 4D muestra una caja de diálogo estándar de apertura de documentos, permitiéndole seleccionar un proyecto local. +- **Abrir el último proyecto utilizado**: 4D abre directamente el último proyecto utilizado; no aparece ninguna caja de diálogo de apertura. > Para forçar a apresentação da caixa de diálogo de abertura quando esta opção é selecionada, mantenha premida a tecla **Alt** (Windows) ou **Opção** (macOS) enquanto inicia o projeto. - - **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. - - **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. +- **Diálogo de apertura del proyecto remoto**: 4D muestra el diálogo estándar de inicio de sesión de 4D Server, permitiéndole seleccionar un proyecto publicado en la red. +- **Diálogo del Asistente de Bienvenida** (configuración de fábrica): 4D muestra la caja de diálogo del Asistente de Bienvenida. > **4D Server**: la aplicación 4D Server ignora esta opción. En este entorno, se utiliza siempre el modo **No hacer nada**. @@ -30,8 +30,8 @@ A partir do macOS Sierra, os aplicativos Mac podem se beneficiar do recurso Auto Você pode se beneficiar desse recurso nos seguintes ambientes (somente com versões 4D de 64 bits): - - Method Editor windows - - Janelas do editor de formulários +- Method Editor windows +- Janelas do editor de formulários Todas as janelas destes editores podem ser colocadas no formulário de tabulação: @@ -47,9 +47,9 @@ En la caja de diálogo de Preferencias de 4D, la opción **Ventana con pestañas Estão disponíveis três opções: - - **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). - - **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). - - **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. +- **Según las Preferencias sistema** (por defecto): las ventanas 4D se comportarán como se definen en las Preferencias Sistema de macOS (En pantalla completa, Siempre o Manualmente). +- **Nunca**: al abrir un nuevo documento en el editor de formularios 4D o en el Editor de Código siempre se crea una nueva ventana (nunca se crean pestañas). +- **Siempre**: al abrir un nuevo documento en el editor de formularios o en los editores de métodos de 4D, siempre se creará una nueva pestaña. ### Aparência (somente macOS) @@ -59,9 +59,9 @@ Este menú permite seleccionar la combinación de colores que se utilizará para Estão disponíveis três opções: - - **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. - - **Claro**: utilizar el tema claro - - **Sombra**: utilizar el tema Sombra +- **Según las preferencias de la paleta de colores del sistema** (por defecto): utiliza la paleta de colores definida en las Preferencias sistema de macOS. +- **Claro**: utilizar el tema claro +- **Sombra**: utilizar el tema Sombra > Esta preferência só é suportada no macOS. No Windows, é sempre utilizado o esquema "Light". @@ -73,8 +73,8 @@ Si esta opción está marcada, cuando el usuario cambia al entorno Aplicación u Si marca esta opción, se añaden dos elementos en el menú **Archivo > Nuevo** y el botón **Nuevo** de la barra de herramientas: - - **Base de dados...** - - **Base de dados a partir da definição da estrutura...** +- **Base de dados...** +- **Base de dados a partir da definição da estrutura...** ![](../assets/en/Preferences/general5.png) @@ -138,8 +138,8 @@ Ao criar um novo arquivo de dados, o 4D usa o idioma previamente definido nesse Esta área configura o acesso à documentação HTML 4D exibida no seu navegador atual: - - Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; - - Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. +- Cuando pulsa la tecla **F1** mientras el cursor está insertado en una función de clase 4D o nombre de comando en el Editor de Código; +- Al hacer doble clic sobre un comando 4D en la **página de los comandos** del Explorador. ### Língua da documentação @@ -151,8 +151,8 @@ Linguaje da documentação HTML a apresentar. É possível selecionar uma docume Define onde 4D irá procurar por páginas de documentação. - - Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. - - Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. +- Quando marcado (padrão), 4D primeiro procura a página na pasta local (veja abaixo). Se for encontrado, 4D mostra a página no navegador atual. Se for encontrado, 4D mostra a página no navegador atual. Desta forma, é possível aceder à documentação mesmo quando se está offline. +- Quando não marcada, 4D procura a página desejada diretamente no site de documentação on-line e a exibe no navegador atual. Se não for encontrado, 4D mostra uma mensagem de erro no navegador. ### Pasta local diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md index 43a2cc3d6b2cf8..604ff1d4e250d5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Preferences/methods.md @@ -15,8 +15,8 @@ Esta página permite selecionar, criar ou configurar temas do Editor de código. Nesta lista, seleciona o tema a aplicar ao editor de código. São apresentados todos os temas disponíveis, incluindo os temas personalizados (se existirem). 4D fornece dois temas por padrão: - - **Tema Light predefinido** - - **Tema escuro predefinido** +- **Tema Light predefinido** +- **Tema escuro predefinido** > Os temas padrão não podem ser modificados ou eliminados. @@ -38,8 +38,8 @@ Cada tema personalizado se almacena en un único archivo JSON llamado *themeName Definir um tema significa: - - definir um tipo de letra e um tamanho de letra globais para todo o editor de código, - - atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. +- definir um tipo de letra e um tamanho de letra globais para todo o editor de código, +- atribuir estilos e cores específicos a cada elemento da linguagem 4D (campos, tabelas, variáveis, parâmetros, SQL, etc.), elemento da linguagem SQL (palavras-chave, funções, etc.) e fundos de cor. A combinação de cores e estilos diferentes é particularmente útil para manutenção do código. @@ -83,8 +83,8 @@ Esta página configura as opções de exibição do Editor de código. Permite-lhe desativar/ativar os parâmetros do código "internacional" para a aplicação 4D local. - - **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. - - **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. +- **no seleccionado** (por defecto): los parámetros English-US y el lenguaje de programación inglés se utilizan en los métodos 4D. +- **seleccionado**: los parámetros regionales se utilizan en los métodos 4D. > Se modificar esta opção, tem de reiniciar a aplicação 4D para que a alteração seja tida em conta. @@ -138,9 +138,9 @@ Permite-lhe ocultar todos os ícones de expansão/recolhimento por padrão ao ap Permite a inserção automática de () e de chaves de fecho durante a escrita de código. Esta opção controla duas funcionalidades automáticas: - - **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). +- **par de paréntesis ()<**: se añade después de un comando 4D, una palabra clave o un método proyecto insertado desde una lista de sugerencias o de finalización, si el elemento insertado requiere uno o más argumentos obligatorios. Por exemplo, se escrever "C_OB" e pressionar Tab, 4D escreve "C_OBJECT()" e coloca o ponto de inserção dentro do (). - - **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": +- **cierre }, ), ], o "**: caracter que se añade al escribir respectivamente una apertura {, (, ], o ". Esta função permite inserir pares de símbolos correspondentes no ponto de inserção ou à volta de um texto selecionado. Por exemplo, se realçar uma cadeia de caracteres e escrever um único ", toda a cadeia de caracteres selecionada será colocada entre "": ![](../assets/en/Preferences/optionsClosing.png)\ ![](../assets/en/Preferences/optionsClosing2.png) @@ -150,11 +150,11 @@ Permite a inserção automática de () e de chaves de fecho durante a escrita de Define a sinalização gráfica das chaves correspondentes no código. Esta sinalização aparece sempre que é selecionado um parêntese quadrado, parêntese ou parêntese curvo. As opções abaixo estão disponíveis: - - **Ninguno**: sin señales - - **Retângulo** (padrão): braces cercadas por uma linha preta\ +- **Ninguno**: sin señales +- **Retângulo** (padrão): braces cercadas por uma linha preta\ ![](../assets/en/Preferences/optionsRectangle.png) - - **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). - - **Negrita**: las llaves aparecen en negrita. +- **Color de fondo**: corchetes resaltados (el color se define en la página [Tema](#Teme-definition)). +- **Negrita**: las llaves aparecen en negrita. #### Destaque de variáveis e campos @@ -162,9 +162,9 @@ Permite destacar todas as ocorrências da mesma variável ou campo numa janela d ![](../assets/en/Preferences/optionsVariables.png) - - **No**(por defecto): no resaltado - - **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto - - **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto +- **No**(por defecto): no resaltado +- **Con cursor**: todas las ocurrencias se destacan cuando se hace clic en el texto +- **Al seleccionar**: se resaltan todas las ocurrencias cuando se selecciona el texto El color de resaltado se puede definir en la página [Tema](#theme-definition). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md index 9cebe6d8a23301..cf3a0cd2bfe120 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/architecture.md @@ -5,7 +5,7 @@ title: Arquitetura de um projeto 4D Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta raiz do projeto (pasta de pacotes). Por exemplo: - - MyPackage (*carpeta raíz del proyecto*) +- MyPackage (*carpeta raíz del proyecto*) - `Componentes` - `Data` - `Logs` @@ -27,23 +27,23 @@ Um projeto 4D é composto por várias pastas e arquivos, armazenados numa pasta A pasta Project contém normalmente a seguinte hierarquia: - - archivo `.4DProject` - - `Sources` +- archivo `.4DProject` +- `Sources` - `Classes` - `DatabaseMethods` - `Página Métodos` - `Formulários` - `TableForms` - `Triggers` - - `DerivedData` - - `Trash` (si hay) +- `DerivedData` +- `Trash` (si hay) ### archivo `.4DProject` Arquivo de desenvolvimento do projeto, utilizado para designar e lançar o projeto. Esse arquivo pode ser aberto por: - - 4D - - 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) +- 4D +- 4D Server (sólo lectura, ver [Abrir un proyecto remoto](Desktop/clientServer.md#opening-a-remote-project)) > Nota: nos projetos 4D, o desenvolvimento se realiza com 4D Developer e o desenvolvimento multiusuários se gerencia através das ferramentas de controle de versão. 4D Server pode abrir arquivos .4DProject para fins de teste. @@ -120,9 +120,9 @@ Esse arquivo de texto também pode conter chaves de configuração, em particula A pasta Trash contém métodos e formulários eliminados do projeto (se existirem). Pode conter as seguintes pastas: - - `Página Métodos` - - `Formulários` - - `TableForms` +- `Página Métodos` +- `Formulários` +- `TableForms` Dentro destas pastas, os nomes dos elementos eliminados estão entre parênteses, por exemplo, "(myMethod).4dm". La organización de las carpetas es idéntica a la carpeta [Sources](#sources). @@ -175,11 +175,11 @@ Essa pasta contém [**configurações de usuário para os dados**](../Desktop/us A pasta Logs contém todos os arquivos de registo utilizados pelo projeto. Os arquivos de registro incluem, em particular: - - conversão da base de dados, - - pedidos do servidor Web, - - backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) - - depuração de comandos, - - 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). +- conversão da base de dados, +- pedidos do servidor Web, +- backup/restore activities journal (*Backup Journal\[xxx].txt*, see [Backup journal](Backup/backup.md#backup-journal)) +- depuração de comandos, +- 4D Pedidos do servidor (gerados em máquinas clientes e no servidor). > Uma pasta adicional de Logs está disponível na pasta de preferências sistema do usuário (pasta 4D ativa, consulte o comando [Get 4D folder](../commands-legacy/get-4d-folder.md)) para arquivos de log de manutenção e nos casos em que a pasta de dados é somente leitura. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/components.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/components.md index d1f63a8354c07a..e498e5ff45aa2b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/components.md @@ -13,15 +13,15 @@ Ao desenvolver em 4D, os arquivos de componentes podem ser armazenados de forma Componentes podem ser interpretados ou [compiled](../Desktop/building.md). - - Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. - - Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. +- Um projeto 4D em modo interpretado pode usar componentes interpretados ou compilados. +- Um projeto 4D em execução no modo compilado não pode usar componentes interpretados. Por isso não pode ser usado em um componente. ### Pasta do pacote A pasta do pacote de um componente (*MyComponent.4dbase*) pode conter: - - para **componentes interpretados**: um padrão [Pasta do projeto](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). - - para **componentes compilados**: +- para **componentes interpretados**: um padrão [Pasta do projeto](../Project/architecture.md). O nome da pasta do pacote deve ser sufixado com **.4dbase** se você quiser instalá-lo na pasta [**Components** do seu projeto](architecture.md#components). +- para **componentes compilados**: - ou uma pasta "Conteúdo" contendo um arquivo .4DZ, uma pasta de *Recursos*, um arquivo *Info.plist* (arquitetura recomendada) - ou diretamente um arquivo .4DZ com outras pastas como *Recursos*. @@ -37,8 +37,8 @@ A arquitetura da pasta "Contents" é recomendada para componentes, se você dese Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Server**. Em outros ambientes, os componentes são geridos de forma diferente: - - em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto - - em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). +- em [4D no modo remoto](../Desktop/clientServer.md), componentes são carregados pelo servidor e enviados para o aplicativo remoto +- em aplicações mescladas, componentes são [incluídos na etapa de compilação](../Desktop/building.md#plugins--components-page). ::: @@ -46,14 +46,14 @@ Esta página descreve como trabalhar com componentes nos ambientes **4D** e **4D Para carregar um componente no seu projeto 4D, você pode: - - copiar os arquivos do componente na pasta [**Components** do seu projeto](architecture.md#components) (as pastas do pacote de componentes interpretados devem ser sufixas com ".4dbase", veja acima), - - ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). +- copiar os arquivos do componente na pasta [**Components** do seu projeto](architecture.md#components) (as pastas do pacote de componentes interpretados devem ser sufixas com ".4dbase", veja acima), +- ou, declarar o componente nas **dependências**. fil\*\* arquivo de seu projeto; isto é feito automaticamente para arquivos locais quando você [**adicionar uma dependência usando a interface do Gerenciador de Dependência**](#adding-a-github-dependency). Os componentes declarados no arquivo **dependencies.json** podem ser armazenados em locais diferentes: - - no mesmo nível da pasta do pacote do seu projeto 4D: este é o local padrão, - - 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. +- no mesmo nível da pasta do pacote do seu projeto 4D: este é o local padrão, +- 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. Se o mesmo componente for instalado em locais diferentes, uma [ordem de prioridade](#prioridade) é aplicada. @@ -69,8 +69,8 @@ O arquivo **dependencies.json** faz referência a todos os componentes necessár Pode conter: - - nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), - - nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). +- nomes de componentes [armazenado localmente](#local-components) (caminho ou caminho padrão definido em um arquivo **environment4d.json**), +- nomes de componentes [armazenados nos repositórios do GitHub](#components-stored-on-github) (seus caminhos podem ser definidos neste arquivo ou em um arquivo **environment4d.json**). #### environment4d.json @@ -78,8 +78,8 @@ O arquivo **environment4d.json** é opcional. Ele permite que você defina **cam Os principais benefícios desta arquitetura são os seguintes: - - você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. - - se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. +- você pode armazenar o **ambiente4d. arquivo son** em uma pasta pai de seus projetos e decida não fazer commit dele, permitindo que você tenha sua organização local de componentes. +- se quiser usar o mesmo repositório GitHub para vários projetos, você poderá fazer referência a ele no arquivo **environment4d.json** e declará-lo no arquivo **dependencies.json**. ### Prioridade @@ -187,9 +187,9 @@ Em relação aos componentes armazenados no GitHub, ambos os arquivos [**depende Para ser capaz de fazer referência direta e usar um componente 4D armazenado no GitHub, você precisa configurar o repositório do componente GitHub: - - Compacte os arquivos de componentes no formato ZIP. - - Nomeie este arquivo com o mesmo nome do repositório do GitHub. - - Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. +- Compacte os arquivos de componentes no formato ZIP. +- Nomeie este arquivo com o mesmo nome do repositório do GitHub. +- Integre o arquivo em uma [versão do GitHub](https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository) do repositório. Essas etapas podem ser facilmente automatizadas, com o código 4D ou usando o GitHub Actions, por exemplo. @@ -232,7 +232,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers ::: - - **Tags** são textos que referenciam exclusivamente uma versão. No arquivo [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson) arquivos, você pode indicar a tag de lançamento que deseja usar no seu projeto. Por exemplo : +- **Tags** são textos que referenciam exclusivamente uma versão. No arquivo [**dependencies.json**](#dependenciesjson) e [**environment4d.json**](#environment4djson) arquivos, você pode indicar a tag de lançamento que deseja usar no seu projeto. Por exemplo : ```json { @@ -245,7 +245,7 @@ Se você selecionar a [**Seguir 4D Version**](#defining-a-github-dependency-vers } ``` - - Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: +- Uma versão também é identificada por uma **versão**. O sistema de versionamento usado é baseado no conceito de [*Versão semântica*](https://regex101.com/r/Ly7O1x/3/), que é o mais comummente usado. Cada número de versão é identificado da seguinte forma: `majorNumber.minorNumber.pathNumber`. Da mesma forma que para marcadores, você pode indicar a versão do componente que você deseja usar em seu projeto, como neste exemplo: ```json { @@ -262,17 +262,17 @@ Um intervalo é definido por duas versões semânticas, um mínimo e um máximo, Eis alguns exemplos: - - "latest": a versão com o selo "latest" nas versões GitHub. - - "\*": a versão mais recente lançada. - - "1.\*": todas as versões da versão principal 1. - - "1.2.\*": todos os patches da versão menor 1.2. - - ">=1.2.3": a última versão, começando com a versão 1.2.3. - - ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. - - "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. - - "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. - - "<=1.2.3": a versão mais recente até a 1.2.3. - - "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. - - "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. +- "latest": a versão com o selo "latest" nas versões GitHub. +- "\*": a versão mais recente lançada. +- "1.\*": todas as versões da versão principal 1. +- "1.2.\*": todos os patches da versão menor 1.2. +- ">=1.2.3": a última versão, começando com a versão 1.2.3. +- ">1.2.3": a versão mais recente, começando com a versão imediatamente após a versão 1.2.3. +- "^1.2.3": a última versão 1, começando com a versão 1.2.3 e estritamente inferior à versão 2. +- "~1.2.3": a última versão 1.2, começando com a versão 1.2.3 e estritamente inferior à versão 1.3. +- "<=1.2.3": a versão mais recente até a 1.2.3. +- "1.0.0 - 1.2.3" ou ">=1.0.0 <=1.2.3": versão entre 1.0.0 e 1.2.3. +- "`<1.2.3 || >=2`": versão que não está entre 1.2.3 e 2.0.0. Se você não especificar uma tag ou uma versão, 4D recupera automaticamente a "versão mais recente". @@ -282,9 +282,9 @@ O gerenciador de dependências verifica periodicamente se as atualizações do c Se quiser usar a [**Seguir 4D Version**](#defining-a-github-dependency-version-range) regra de dependência, os marcadores de versões de componentes no repositório do Github devem obedecer a convenções específicas. - - **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". +- **Versões do LT**: padrão `x.y.p`, onde `x. ` corresponde à versão 4D principal a seguir e o `p` (opcional) pode ser usado para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x". Se não existir essa versão, o usuário será notificado. Por exemplo, "20.4" será resolvido pelo Gerenciador de Dependências como "a última versão do componente 20.\* ou versão abaixo de 20". - - **Versões do R-Release**: `xRy. ` padrão, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". +- **Versões do R-Release**: `xRy. ` padrão, onde `x` e `y` correspondem à versão principal 4D R-release para seguir e `p` (opcional) podem ser usados para versões patch ou atualizações adicionais. Quando um projeto especifica que segue a versão 4D para *x. \* Versão LTS, o Gerenciador de Dependências irá resolvê-lo como "a versão mais recente x.*" se disponível ou "versão abaixo de x. Se não existir essa versão, o usuário será notificado. Por exemplo, "20R9" será resolvido pelo Gerenciador de Dependências como "a última versão do componente abaixo de 20R10". :::note @@ -310,8 +310,8 @@ Em seguida, você precisa [fornecer seu token de conexão](#providing-your-githu Os componentes GitHub referenciados são baixados em uma pasta de cache local e carregados em seu ambiente. A pasta de cache local é armazenada na seguinte localização: - - en macOs: `$HOME/Library/Caches//Dependencies` - - no Windows: `C:\Users\\AppData\Local\\Dependencies` +- en macOs: `$HOME/Library/Caches//Dependencies` +- no Windows: `C:\Users\\AppData\Local\\Dependencies` ...onde `` pode ser "4D", "4D Server" ou "tool4D". @@ -327,10 +327,10 @@ Em um projeto aberto, você pode adicionar, remover, atualizar e obter informaç Para exibir o painel Dependências: - - Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
+- Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
![dependency-menu](../assets/en/Project/dependency-menu.png) - - com 4D Server, selecione o item de menu **Janela/Dependências do projeto**.
+- com 4D Server, selecione o item de menu **Janela/Dependências do projeto**.
![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) O painel de Dependências é exibido em seguida. Dependências são classificadas por nome em ordem alfabética: @@ -345,9 +345,9 @@ Por padrão, todas as dependências identificadas pelo gerenciador de dependênc ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - - **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. - - **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... - - **Conflito**: dependências carregadas, mas que sobrecarregam pelo menos outra dependência em um [nível de prioridade](#priority) inferior. As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. +- **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. As dependências *sobrecarregadas* são listadas no painel **Conflitos**, juntamente com todas as dependências conflitantes. +- **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitos motivos possíveis para esse status: arquivos ausentes, incompatibilidade de versão... +- **Conflito**: dependências carregadas, mas que sobrecarregam pelo menos outra dependência em um [nível de prioridade](#priority) inferior. As dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. ### Estado de dependências @@ -357,16 +357,16 @@ As dependências que exigem a atenção do desenvolvedor são indicadas por um * Estão disponíveis as seguintes etiquetas de status: - - **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). - - **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). - - **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. - - **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). - - **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. - - **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. - - **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). - - **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. - - **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. +- **Overloaded**: a dependência não é carregada porque está sobrecarregada por outra dependência com o mesmo nome em um [nível de prioridade] mais alto (#prioridade). +- **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). +- **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. +- **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). +- **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#monitoring-project-dependencies) e será carregada quando o aplicativo for reiniciado. +- **Disponível após a reinicialização**: A referência de dependência acabou de ser adicionada ou atualizada [usando a interface] (#removing-a-dependency) e será carregada quando o aplicativo for reiniciado. +- **Atualização disponível \**: Foi detectada uma nova versão da dependência do GitHub que corresponde à sua [configuração da versão do componente](#defining-a-github-dependency-version-range). +- **Refreshed after restart**: A [configuração da versão do componente](#defining-a-github-dependency-version-range) da dependência do GitHub foi modificada, ela será ajustada na próxima inicialização. +- **Atualização recente**: uma nova versão da dependência do GitHub foi carregada na inicialização. Uma dica é exibida quando você passa o mouse sobre a linha de dependência, provando informações adicionais sobre o status: @@ -399,8 +399,8 @@ Este item não é exibido se a dependência estiver inativa porque seus arquivos O ícone do componente e o logotipo da localização fornecem informações adicionais: - - O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. - - Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. +- O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. +- Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno. ![dependency-origin](../assets/en/Project/dependency-github.png) @@ -420,8 +420,8 @@ Se o item selecionado não for válido, será exibida uma mensagem de erro. Clique em **Adicionar** para adicionar a dependência ao projeto. - - Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). - - Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). +- Se você selecionar um componente localizado próximo à pasta do pacote do projeto (local padrão), ele será declarado no arquivo [**dependencies.json**](#dependenciesjson). +- Se você selecionar um componente que não esteja localizado próximo à pasta do pacote do projeto, ele será declarado no arquivo [**dependencies.json**](#dependenciesjson) e seu caminho será declarado no arquivo [**environment4d.json**](#environment4djson) (consulte a nota). O painel Dependências pergunta se você deseja salvar um [caminho relativo ou absoluto](#relative-paths-vs-absolute-paths). :::note @@ -461,11 +461,11 @@ Você pode definir a opção [tag ou versão](#tags-and-versions) para uma depen ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) - - **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). - - **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. - - **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. - - **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. - - **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). +- **Latest**: Selecionado por padrão e permite baixar a versão marcada como a mais recente (estável). +- **Até a próxima versão major**: defina um [intervalo de versão semântica](#tags-and-versions) para restringir as atualizações para a próxima versão principal. +- **Até a próxima versão minor**: da mesma forma, restringe as atualizações para a próxima versão minor. +- **Versão exata (etiqueta)**: selecione ou insira manualmente uma [etiqueta específica](#tags-and-versions) na lista disponível. +- **Siga a versão 4D**: Faça o download da versão mais recente do componente que é compatível com a versão 4D em execução. Você pode usar essa regra de dependência somente se as tags de liberação do componente seguirem a [convenção de nomenclatura] apropriada (#naming-conventions-for-4d-version-tags). A versão atual da dependência do GitHub é exibida no lado direito do item de dependência: @@ -481,8 +481,8 @@ Modificar o intervalo de versão é útil, por exemplo, se você usar o recurso O gerenciador de dependências fornece um tratamento integrado de atualizações no GitHub. Os seguintes recursos são suportados: - - Verificação automática e manual das versões disponíveis - - Atualização automática e manual de componentes +- Verificação automática e manual das versões disponíveis +- Atualização automática e manual de componentes As operações manuais podem ser feitas **por dependência** ou **para todas as dependências**. @@ -498,11 +498,11 @@ Se você fornecer um [token de acesso](#providing-your-github-access-token), as Além disso, você pode verificar se há atualizações a qualquer momento, para uma única dependência ou para todas as dependências: - - Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. +- Para verificar se há atualizações de uma única dependência, clique com o botão direito do mouse na dependência e selecione **Verificar atualizações** no menu contextual. ![componente de verificação](../assets/en/Project/check-component-one.png) - - Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. +- Para verificar se há atualizações de todas as dependências, clique no menu **opções** na parte inferior da janela do Gerenciador de dependências e selecione **Verificar atualizações**. ![componentes de verificação](../assets/en/Project/check-component-all.png) @@ -520,11 +520,11 @@ Se não quiser usar uma atualização de componente (por exemplo, se quiser perm Você pode atualizar as dependências a qualquer momento, para uma única dependência ou para todas as dependências: - - Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: +- Para atualizar uma única dependência, clique com o botão direito na dependência e selecione **Atualizar \ na próxima inicialização** no menu contextual ou no menu **opções** na parte inferior da janela Gerenciador de Dependências: ![componente de verificação](../assets/en/Project/update-component-one.png) - - Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: +- Para atualizar todas as dependências de uma só vez, clique no menu **opções** na parte inferior da janela do gerenciador de dependências e selecione **Atualizar todas as dependências remotas na próxima inicialização**: ![check components](../assets/en/Project/update-component-all.png) @@ -532,8 +532,8 @@ Em qualquer caso, independentemente do status atual da dependência, é feita um Quando você seleciona um comando de atualização: - - uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. - - Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. +- uma caixa de diálogo é exibida e propõe **reiniciar o projeto**, para que as dependências atualizadas estejam imediatamente disponíveis. Em geral, recomenda-se reiniciar o projeto para avaliar as dependências atualizadas. +- Se você clicar em Later (Mais tarde), o comando de atualização não estará mais disponível no menu, o que significa que a ação foi planejada para a próxima inicialização. #### Atualização automática @@ -547,13 +547,13 @@ Quando essa opção estiver desmarcada, uma nova versão de componente que corre O registro do seu token de acesso pessoal no Gerenciador de dependências é: - - obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), - - recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). +- obrigatório se o componente estiver armazenado em um [repositório GitHub privado](#private-repositories), +- recomendado para uma [verificação de atualizações de dependências](#updating-github-dependencies). Para fornecer seu token de acesso ao GitHub, você pode: - - clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. - - ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. +- clique no botão **Adicionar um token de acesso pessoal...** que é exibido na caixa de diálogo "Adicionar uma dependência" depois que você inserir um caminho de repositório privado do GitHub. +- ou selecione **Adicionar um token de acesso pessoal GitHub...** no menu do Gerenciador de dependências a qualquer momento. ![dependency-add-token](../assets/en/Project/dependency-add-token.png) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md index 7e2af09f175ed8..7c695109cfa85e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Project/documentation.md @@ -7,10 +7,10 @@ Nos projetos de aplicação, você pode documentar seus métodos e suas classes, Os seguintes elementos do projeto aceitam documentação: - - 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 +- 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 Seus arquivos de documentação são escritos na sintaxe Markdown (arquivos .md) usando qualquer editor compatível com Markdown. São armazenados como ficheiros independentes na pasta do seu projeto. @@ -34,7 +34,7 @@ Todos los archivos de documentación se almacenan en la carpeta `Documentación` La arquitectura de la carpeta `Documentation` es la siguiente: - - `Documentation` +- `Documentation` - `Classes` - myClass.md - `DatabaseMethods` @@ -55,9 +55,9 @@ La arquitectura de la carpeta `Documentation` es la siguiente: - table1.md - ... - - Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. +- Um formulário projeto e seu método de formulário projeto compartilham o mesmo arquivo de documentação para formulário e método. - - Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. +- Um formulário tabela e seu método de formulário tabela compartilham o mesmo arquivo de documentação para o formulário e o método. > Renomear ou excluir um elemento documentado em seu projeto também renomeará ou excluirá o arquivo Markdown associado ao elemento. @@ -73,9 +73,9 @@ Para visualizar a documentação na janela do Explorer: ![](../assets/en/Project/comments-explo2.png) - - Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). +- Si no se ha encontrado ningún archivo de documentación para el elemento seleccionado, se muestra un botón **Crear** (ver más abajo). - - Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. +- Caso contrário, se houver um arquivo de documentação para o elemento selecionado, o conteúdo será exibido na área. Os conteúdos não são diretamente editáveis no painel. ### Editar o ficheiro de documentação @@ -83,8 +83,8 @@ Você pode criar e/ou editar um arquivo de documentação Markdown na janela Exp Se não houver um arquivo de documentação para o elemento selecionado, você poderá: - - haga clic en el botón **Crear** en el panel `Documentation` o, - - elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. +- haga clic en el botón **Crear** en el panel `Documentation` o, +- elija la opción **Modificar la documentación...** en el menú contextual o el menú de opciones del Explorador. ![](../assets/en/Project/comments-explo3.png) @@ -100,9 +100,9 @@ O editor de código 4D exibe uma parte da documentação de um método em sua di Si existe un archivo llamado `\.md` en la carpeta `\/documentation`, el editor de código muestra (por prioridad): - - Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. +- Todo texto introducido en una etiqueta de comentario HTML (``) en la parte superior del archivo markdown. - - Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ +- Or, if no html comment tag is used, the first sentence after a `# Description` tag of the markdown file.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ Nesse caso, a primeira linha contém o **protótipo** do método, gerado automaticamente pelo analisador de código 4D.\ @@ -134,7 +134,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Markdown suportado - - A etiqueta de título é suportada: +- A etiqueta de título é suportada: ```md # Title 1 @@ -142,7 +142,7 @@ Novos arquivos de documentação são criados com o seguinte conteúdo padrão: ### Title 3 ``` - - As etiquetas de estilo (itálico, negrito, riscado) são suportadas: +- As etiquetas de estilo (itálico, negrito, riscado) são suportadas: ```md _italic_ @@ -151,7 +151,7 @@ _italic_ ~~strikethrough~~ ``` - - A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: +- A tag do bloco de código (\`4d ... `) é suportado com destaque de código 4D: ````md ```4d @@ -160,7 +160,7 @@ _italic_ ``` ```` - - A etiqueta de tabela é suportada: +- A etiqueta de tabela é suportada: ```md | Parâmetro | Tipo | Descrição | @@ -169,7 +169,7 @@ _italic_ | toolbar | Text |Nome da barra de ferramentas | ``` - - A etiqueta de ligação é suportada: +- A etiqueta de ligação é suportada: ```md // Case 1 @@ -181,7 +181,7 @@ The [documentation](https://doc.4d.com) of the command .... [1]: https://blog.4d.com ``` - - As etiquetas de imagem são suportadas: +- As etiquetas de imagem são suportadas: ```md ![image info](pictures/image.png) @@ -228,10 +228,10 @@ $logo:=GetLogo(5) ``` ```` - - Explorer view: +- Explorer view: ![](../assets/en/Project/explorer_Doc.png) - - Code editor view: +- Code editor view: ![](../assets/en/Project/comments-explo5.png) \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md index 400ee19c74fa0d..5b7b18c85907f6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$attributes.md @@ -11,18 +11,18 @@ If you have relation attributes in a dataclass, use `$attributes` to define the Puede aplicar `$attributes` a una entidad (*p. Ej.*, People(1)) o una entity selection (*p. Ej.*, People/$entityset/0AF4679A5C394746BFEB68D2162A19FF). - - Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. +- Si `$attributes` no se especifica en una consulta, o si se pasa el valor "\*", se extraen todos los atributos disponibles. Los atributos \*\*de entidad relacionada \*\* se extraen con la forma simple: un objeto con la propiedad `__KEY` (llave primaria) y `URI`. Los atributos de las **entidades relacionadas** no se extraen. - - Si se especifica `$attributes` para los atributos **de entidad relacionada**: +- Si se especifica `$attributes` para los atributos **de entidad relacionada**: - `$attributes=relatedEntity`: se devuelve la entidad relacionada con forma simple (propiedad __KEY diferida (llave primaria)) y `URI`. - `$attributes=relatedEntity.*`: se devuelven todos los atributos de la entidad relacionada - `$attributes=relatedEntity.attributePath1, relatedEntity.attributePath2, ...`: sólo se devuelven los atributos de la entidad relacionada. - - Si se especifica `$attributes` para los atributos **de entidades relacionadas**: +- Si se especifica `$attributes` para los atributos **de entidades relacionadas**: - `$attributes=relatedEntities.*`: se devuelven todas las propiedades de todas las entidades relacionadas - `$attributes=relatedEntities.attributePath1, relatedEntities.attributePath2, ...`: sólo se devuelven los atributos de las entidades relacionadas. - - Se `$attributes` for especificado para os atributos **storage**: +- Se `$attributes` for especificado para os atributos **storage**: - `$attributes=attribute1, attribute2, ...`: somente os atributos das entidades são retornados. ## Exemplo com entidades relacionadas diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md index dd48476a7fcfe5..6e2dfde4a12fb3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$lock.md @@ -27,13 +27,13 @@ Los bloqueos activados por la API REST se colocan al nivel de la [sesión](authU Una entidad bloqueada se ve como *bloqueada* (es decir, las acciones de bloqueo / desbloqueo / actualización / eliminación no son posibles) por: - - outras sessões REST - - Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. +- outras sessões REST +- Processos 4D (cliente/servidor, datastore remoto, autónomo) em execução no servidor REST. Uma entidade bloqueada pela API REST só pode ser desbloqueada: - - por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` - - o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). +- por su bloqueador, es decir un `/?$lock=false` en la sesión REST que define `/?$lock=true` +- o si el [timeout de inactividad]($directory.md) de la sesión se alcanza (la sesión se cierra). ### Resposta diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md index 4709c79923afc9..92195929e4c718 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/$method.md @@ -193,9 +193,9 @@ Se surgir um problema ao adicionar ou modificar uma entidade, ser-lhe-á enviado :::note - - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). - - **Booleanos** son true o false. - - Arquivos carregados usando `$upload` podem ser aplicados a um atributo do tipo Imagem ou BLOB passando o objeto retornado no seguinte formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` +- **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). +- **Booleanos** son true o false. +- Arquivos carregados usando `$upload` podem ser aplicados a um atributo do tipo Imagem ou BLOB passando o objeto retornado no seguinte formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` ::: ### Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md index 206f046a875fa3..3c9932bb4f93c7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/ClassFunctions.md @@ -7,8 +7,8 @@ You can call [data model class functions](ORDA/ordaClasses.md) defined for the O Functions can be called in two ways: - - usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. - - usando solicitações **GET**, com parâmetros passados diretamente no URL. +- usando **POST requests**, com parâmetros de dados passados no corpo da solicitação. +- usando solicitações **GET**, com parâmetros passados diretamente no URL. POST requests provide a better security level because they avoid running sensitive code through an action as simple as clicking on a link. However, GET requests can be more compliant with user experience, allowing to call functions by entering an URL in a browser (note: the developer must ensure no sensitive action is done in such functions). @@ -96,11 +96,11 @@ You can send parameters to functions defined in ORDA user classes or singletons. As regras abaixo são válidas: - - Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. - - In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. - - Os parâmetros devem ser incluídos numa coleção (formato JSON). - - Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. - - A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- Nas funções chamadas por meio de solicitações POST, os parâmetros devem ser passados **no corpo da solicitação POST**. +- In functions called through GET requests, parameters must be passed **in the URL with "?$params=" syntax**. +- Os parâmetros devem ser incluídos numa coleção (formato JSON). +- Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. +- A entidade e a seleção de entidades podem ser passadas como parâmetros. The parameter list must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. Veja [este exemplo](#using-an-entity-to-be-created-on-the-server) e [este exemplo](#receiving-an-entity-selection-as-parameter). @@ -134,8 +134,8 @@ Também é possível transmitir valores para quaisquer atributos da entidade. Es | __ENTITY | Parâmetros | Obrigatório - Verdadeiro para indicar ao servidor que o parâmetro é uma entidade | | __KEY | misto (do mesmo tipo que a chave primária) | Facultativo - Chave primária da entidade | - - Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. - - Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos +- Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. +- Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos See examples below for creating or updating entities with POST requests. See an example of contents downloading using an entity with a GET request. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md index 191f72de779ce4..82fda214ca94dc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/authUsers.md @@ -43,9 +43,9 @@ All other REST requests (handling data or executing a function) will only be pro As solicitações REST descritivas podem ser processadas em sessões de usuário Web que não exigem licenças (sessões "guest"). Essas solicitações são: - - Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis - - `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario - - `/rest/$getWebForm` - Renderização de uma página Qodly +- Solicitações [`/rest/$catalog`]($catalog.md) (por exemplo, `/rest/$catalog/$all`) - acesso às dataclasses disponíveis +- `/rest/$catalog/authentify` - la función del almacén de datos utilizada para iniciar sesión del usuario +- `/rest/$getWebForm` - Renderização de uma página Qodly ![alt-text](../assets/en/REST/force-login-1.jpeg) @@ -72,8 +72,8 @@ A função pode receber qualquer autenticação ou informação contextual como Esta função deve conter duas partes: - - some code to identify and authenticate the REST request sender, - - se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. +- some code to identify and authenticate the REST request sender, +- se a autenticação for bem-sucedida, uma chamada para [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges) que atribui os privilégios apropriados à sessão. Se a função não chamar [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges), nenhum privilégio será atribuído, nenhuma licença será consumida e solicitações REST subsequentes não descritivas serão rejeitadas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md index 3404d6817ab487..716363373e907b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/gettingStarted.md @@ -9,8 +9,8 @@ El servidor REST está incluido en 4D y 4D Server, está automáticamente dispon Esta seção tem o objetivo de familiarizar com as funcionalidades REST com um exemplo simples. Nós vamos: - - criar e configurar um banco de dados 4D simples - - acessar aos dados do banco 4D através de REST usando um navegador padrão. +- criar e configurar um banco de dados 4D simples +- acessar aos dados do banco 4D através de REST usando um navegador padrão. Para simplificar o exemplo, vamos usar uma aplicação 4D e um navegador que são executados na mesma máquina. Também poderia usar uma arquitetura remota. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md index fef98a2592ccb2..87fc0baf1a4bb2 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/REST/manData.md @@ -19,7 +19,7 @@ Para adicionar e modificar entidades, você pode chamar [`$method=update`]($meth 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). -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). +Before returning a selection, you can also sort it by using [`$orderby`]($orderby.md) on one or more attributes (even relation attributes). ## Navegando dados @@ -27,7 +27,7 @@ Add the [`$skip`]($skip.md) (to define with which entity to start) and [`$top/$l ## Criar e gerenciar conjuntos de entidades -Un conjunto de entidades (también conocido como *selección de entidades*) es una colección de entidades obtenidas a través de una petición REST que se almacena en la caché de 4D Server. Usar um conjunto de entidades previne que pesquise continuamente sua aplicação pelos mesmos resultados. Acessar um conjunto de entidades é mais rápido e pode melhorar a velocidade de sua aplicação. +An entity set is a collection of entities obtained through a REST request that is stored in 4D Server's cache. Usar um conjunto de entidades previne que pesquise continuamente sua aplicação pelos mesmos resultados. Acessar um conjunto de entidades é mais rápido e pode melhorar a velocidade de sua aplicação. Para criar um conjunto de entidades, chame [`$method=entityset`]($method.md#methodentityset) em sua solicitação REST. As a measure of security, you can also use [`$savedfilter`]($savedfilter.md) and/or [`$savedorderby`]($savedorderby.md) when you call [`$filter`]($filter.md) and/or [`$orderby`]($orderby.md) so that if ever the entity set timed out or was removed from the server, it can be quickly retrieved with the same ID as before. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md index b12baafbf2032e..0e677360751766 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/processes.md @@ -17,15 +17,15 @@ Existem também três botões de atalho que podem ser utilizados para filtrar o ![](../assets/en/Admin/server-process-buttons.png) - - **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. - - **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. - - **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos usuarios**: procesos generados por y para las sesiones usuarios. Estes processos são precedidos de um ícone sob a forma de uma persona. +- **Procesos 4D**: procesos generados por el motor de 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. +- **Procesos de reserva**: procesos inactivos pero que se mantienen temporalmente y que pueden reutilizarse en cualquier momento. Este mecanismo otimiza a reatividade do 4D Server. Estes processos são precedidos de um ícone com a forma de uma roda dentada. La opción **Mostrar los procesos por grupos** le permite agrupar los procesos internos de 4D Server así como los procesos cliente, para una mejor legibilidad. Quando você marcar essa opção: - - los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, - - é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), - - é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. +- los procesos cliente 4D "gemelos" (proceso cliente 4D principal y proceso base cliente 4D, véase [Tipo de proceso ](#process-type)) se agrupan como uno solo, +- é criado um grupo "Gestores de tarefas"; inclui os processos internos dedicados à divisão de tarefas (Equilibrador partilhado, Gestor de sessões de rede, Trabalhador do grupo exclusivo), +- é criado um grupo "Gestores de clientes", que inclui vários processos internos dos clientes. A área inferior da janela é utilizada para apresentar a representação gráfica da atividade do(s) processo(s) selecionado(s). @@ -33,16 +33,16 @@ A área inferior da janela é utilizada para apresentar a representação gráfi A atividade do processo é a percentagem de tempo que 4D Server dedicou a este processo (proporção). A janela fornece as seguintes informações para cada processo: - - Tipo de processo (ver abaixo), - - Sessão/Info: +- Tipo de processo (ver abaixo), +- Sessão/Info: - Processo 4D - em branco, - Processo usuário - nome do usuário 4D, - Processo web - caminho URL, - - Nome do processo, - - Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. - - Estado atual do processo, - - Tempo de execução (em segundos) do processo desde a sua criação, - - Percentagem de tempo que 4D Server dedicou a este processo (rácio). +- Nome do processo, +- Número do processo (como retornado pelo comando [`New process`](../commands-legacy/new-process.md), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. +- Estado atual do processo, +- Tempo de execução (em segundos) do processo desde a sua criação, +- Percentagem de tempo que 4D Server dedicou a este processo (rácio). ## Tipo de processo @@ -83,15 +83,15 @@ A página também tem cinco botões de controle que atuam nos processos selecion ![](../assets/en/Admin/server-process-actions.png) - - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. +- **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. > You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](../commands-legacy/abort-process-by-id.md) command. - - **Pausar processo**: pode ser usado para pausar os processos selecionados. - - **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. - - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). +- **Pausar processo**: pode ser usado para pausar os processos selecionados. +- **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. +- **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). > También puede depurar un proceso directamente sin mostrar la caja de diálogo de confirmación manteniendo presionada la tecla **Alt** mientras presiona este botón. - - **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. +- **Ver usuarios**: permite visualizar, en la [página Usuarios](users.md), todos los procesos del usuario o usuarios seleccionados. Este botão está ativo quando pelo menos um processo do utilizador for selecionado. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md index 5ad406eb40bfc1..08aef35634f4df 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ServerWindow/real-time-monitor.md @@ -13,10 +13,10 @@ A página do Monitor em Tempo Real monitora o progresso de operações "longas" As informações seguintes são fornecidas para cada linha: - - **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" - - **Duración** (ms): duración en milisegundos de la operación en curso - - **Información**: título de la operación. - - **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: +- **Hora de inicio**: hora de inicio de la operación en el formato "dd/mm/yyyy - hh:mm:ss" +- **Duración** (ms): duración en milisegundos de la operación en curso +- **Información**: título de la operación. +- **Detalles**: esta área muestra información detallada que variará en función del tipo de operación seleccionada. Mais especificamente: - **Creada en**: indica si la operación es el resultado de una acción del cliente (Creada en cliente) o si se inició explícitamente en el servidor mediante un procedimiento almacenado o la opción "Ejecutar en el servidor" (Creada en servidor). - **Detalles de la operación**: tipo de operación y (para las operaciones de consulta) plan de búsqueda. - **Suboperaciones** (si las hay): operaciones dependientes de la operación seleccionada (por ejemplo, eliminar registros relacionados antes que un registro padre). @@ -26,9 +26,9 @@ As informações seguintes são fornecidas para cada linha: A página está ativa e é atualizada permanentemente assim que é exibida. Note-se que o seu funcionamento pode atrasar significativamente a execução da aplicação. É possível suspender a atualização desta página de uma das seguintes maneiras: - - haciendo clic en el botón **Pausa**, - - clicando na lista, - - premindo a barra de espaços. +- haciendo clic en el botón **Pausa**, +- clicando na lista, +- premindo a barra de espaços. Al pausar la página, aparece el mensaje "PAUSED" y la etiqueta del botón cambia a **Reanudar**. Você pode retomar o monitoramento das operações realizando a mesma ação que realizar a pausa. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md index fdcd6e21619131..608710e42261c0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/Users/overview.md @@ -7,8 +7,8 @@ Se mais de uma pessoa usar uma aplicação, que geralmente é o caso em arquitet A estratégia de controle de acesso 4D depende da configuração de sua implementação: - - em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, - - in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). +- em aplicações multi-usuário, pode confiar nos usuários e grupos 4D, +- in single-user applications, user access is controlled through the system session, using commands such as [`Current system user`](../commands-legacy/current-system-user.md). > Consulte la documentación [Guía de seguridad de 4D](https://blog.4d.com/4d-security-guide/) para una visión de conjunto de las funciones de seguridad de 4D. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md index e283eb9cf3a573..667ae23ab125a4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-export-document.md @@ -34,11 +34,11 @@ Em filePath, passe o caminho de destino e o nome do documento a ser importado. S Você pode especificar o formato do arquivo exportado incluindo uma extensão após o nome do documento: - - 4D View Pro (".4vp") - - Microsoft Excel (".xlsx") - - PDF (".pdf") - - CSV (".txt", ou ".csv") - - [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") +- 4D View Pro (".4vp") +- Microsoft Excel (".xlsx") +- PDF (".pdf") +- CSV (".txt", ou ".csv") +- [Documento SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (".sjs") Se a extensão não for incluída, mas o formato for especificado em *paramObj*, o arquivo exportado terá a extensão que corresponde ao formato, exceto para o formato CSV (nenhuma extensão é adicionada nesse caso). @@ -88,25 +88,25 @@ O parâmetro opcional *paramObj* permite que você defina várias propriedades p **Notas sobre o formato Excel**: - - Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. - - Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. +- Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. You can verify other settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Usando o objeto *excelOptions* é recomendado ao exportar no formato ".xlsx". Certifique-se de não misturar esse objeto com propriedades legadas de primeiro nível (*password*, *includeBindingSource*...) para evitar problemas potenciais. **Notas sobre o formato PDF**: - - Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato CSV**: - - Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. - - Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos. +- Todos os valores são guardados como cadeias de caracteres entre aspas duplas. For more information on delimiter-separated values, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values). +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. **Notas sobre o formato de arquivo SpreadJS**: - - Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. - - Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. +- Os [arquivos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) são arquivos compactados. +- Exporting in this format is run asynchronously, use the `formula` property of the *paramObj* for code to be executed after the export. Once the export operation is finished, `VP EXPORT DOCUMENT` automatically triggers the execution of the method set in the *formula* property of the *paramObj*, if used. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md index 9f8db97da06cb1..a69e8faeea2a78 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-find.md @@ -5,7 +5,7 @@ title: VP Find -**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object } ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object +**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ) : Object
**VP Find** ( *rangeObj* : Object ; *searchValue* : Text ; *searchCondition* : Object ; *replaceValue* : Text ) : Object diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md index 3a6361ba1ce077..fc90cc04ccc72f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-stylesheets.md @@ -23,8 +23,8 @@ Em *vpAreaName*, passe o nome da propriedade da área 4D View Pro. Se passar um You can define where to get the style sheets in the optional *sheet* parameter using the sheet index (counting begins at 0) or with the following constants: - - `vk current sheet` - - `vk workbook` +- `vk current sheet` +- `vk workbook` ## Exemplo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md index 47e8cd97ce06bf..40e8f143e18c79 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-get-value.md @@ -31,8 +31,8 @@ The object returned will contain the `value` property, and, in case of a js date Se o objetivo retornado incluir uma data ou hora, é tratado como uma datetime e completado como abaixo: - - valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy - - valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) +- valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy +- valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00) Se *rangeObj* contiver várias células ou vários intervalos, o valor da primeira célula é retornado. O comando retorna um objeto null se a célula estiver vazia. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md index 950f0b3fadd449..89009c2424490e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-import-document.md @@ -32,10 +32,10 @@ Em *vpAreaName*, passe o nome da área 4D View Pro. Se passar um nome que não e Em *filePath*, passe o caminho de destino e o nome do documento a ser importado. São suportados os seguintes formatos: - - Os documentos 4D View Pro (extensão ".4vp") - - Microsoft Excel (extensão ".xlsx") - - documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) - - [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") +- Os documentos 4D View Pro (extensão ".4vp") +- Microsoft Excel (extensão ".xlsx") +- documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8) +- [Documentos SpreadJS](https://developer.mescius.com/spreadjs/docs/features/spreadjs-file-format) (extensão ".sjs") If the document extension is not a recognized extension, such as `.4vp` or `.xlsx`, the document is considered a text document. Deve passar uma rota completa, a não ser que o documento esteja localizado no mesmo nível que a pasta Project, em cujo caso pode passar apenas seu nome. @@ -73,11 +73,11 @@ O parâmetro opcional *paramObj* permite definir as propriedades do documento im :::note Notas - - Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. - - Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). - - For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) - - Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. - - A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. +- Importar arquivos em formatos .xslx, .csv, e .sjs é **assíncrona**. With these formats, you must use the `formula` attribute if you want to start an action at the end of the document processing. +- Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. You can verify your settings with [this list from SpreadJS](https://developer.mescius.com/spreadjs/docs/excelimpexp/excelexport). +- For more information on the CSV format and delimiter-separated values in general, see [this article on Wikipedia](https://en.wikipedia.org/wiki/Delimiter-separated_values) +- Usando o objeto *excelOptions* é recomendado ao importar o formato ".xlsx". Make sure to not mix this object with legacy first level property *password* to avoid potiental issues. +- A função callback especificada no atributo `formula` é acionada depois que todas as [funções personalizadas 4D](../formulas.md#4d-functions) dentro do conteúdo importado tiverem concluído seus cálculos. This ensures that any dependent processes, such as document modifications or exports, are performed only after all formula-based computations are fully resolved. ::: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md index 042bb9c8815ff4..3095815f840351 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-remove-table-columns.md @@ -13,7 +13,7 @@ title: VP REMOVE TABLE COLUMNS -**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }}} ) +**VP REMOVE TABLE COLUMNS** ( *vpAreaName* : Text ; *tableName* : Text ; *column* : Integer {; *count* : Integer {; *sheet* : Integer }} ) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md index 1a2476003ae825..b6dc6b4e3461cc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/commands/vp-resize-table.md @@ -28,9 +28,9 @@ O comando `VP RESIZE TABLE` alter As regras abaixo são válidas: - - Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. - - Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. - - Se a tabela se expandir nas células que contêm dados: +- Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original. +- Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores em linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um [contexto de dados](vp-set-data-context.md), caso contrário, eles serão excluídos. +- Se a tabela se expandir nas células que contêm dados: - se as linhas forem adicionadas, os dados serão excluídos, - se colunas forem adicionadas, dados serão mantidos e exibidos em novas colunas. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md index 0ea24e8c6c0966..fa56a40ec2ede4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/ViewPro/getting-started.md @@ -37,20 +37,20 @@ As folhas de cálculo são compostas por linhas e colunas. A cada linha está as ### Seleção de células, colunas e linhas - - Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. +- Para selecionar uma célula, basta clicar nela ou usar as setas de direção do teclado. O seu conteúdo (ou fórmula) é apresentado na célula. - - Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. +- Para selecionar várias células contínuas, arraste o mouse de uma extremidade da seleção para a outra. Você também pode clicar nas duas extremidades da seleção enquanto mantém pressionada a tecla Shift. - - To select all cells in the spreadsheet, click on the cell at the top left of the area: +- To select all cells in the spreadsheet, click on the cell at the top left of the area: ![](../assets/en/ViewPro/vpSelectAll.PNG) - - Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). +- Para selecionar uma coluna, clique na letra correspondente (ou conjunto de letras). - - Para selecionar uma linha, clique no número correspondente. +- Para selecionar uma linha, clique no número correspondente. - - Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. +- Para seleccionar un grupo de celdas que no sean continuas, mantenga presionada la tecla **Ctrl** (Windows) o la tecla **Comando** (Mac) y haga clic en cada celda que desee seleccionar. - - Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. +- Para anular a seleção de células, basta clicar em qualquer parte da folha de cálculo. ### Introdução de dados @@ -76,8 +76,8 @@ As áreas do 4D View Pro se beneficiam de um menu de contexto automático que of Dependendo da área clicada, as seguintes opções também estão disponíveis: - - haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido - - clique numa célula ou num intervalo de células: +- haga clic en el encabezado de una columna o línea: **Insertar**, **Borrar**, **Ocultar**, o **Mostrar** el contenido +- clique numa célula ou num intervalo de células: - **Filtrar**: permite ocultar la línea mediante filtros (ver "Filtrar las líneas" en la [documentación de SpreadJS](https://developer.mescius.com/spreadjs/docs/)). - **Ordenar**: ordena el contenido de la columna. - **Insertar comentario**: permite al usuario introducir un comentario para un área. When a comment has been entered for an area, the top left cell of the area displays a small red triangle:\ @@ -128,8 +128,8 @@ Você pode então passar `$myRange` para outro método 4D View Pro para modifica Os objectos intervalo 4D View Pro são compostos por várias propriedades: - - área - O nome da área 4D View Pro - - intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. +- área - O nome da área 4D View Pro +- intervalos - Uma coleção de objeto(s) intervalo. As propriedades disponíveis em cada objeto de intervalo dependem do tipo de objeto de intervalo. Por ejemplo, un objeto rango de tipo columna sólo incluirá las propiedades *.column* y *.sheet*. | Propriedade | | Tipo | Descrição | Disponível para | | ----------- | ------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | @@ -146,10 +146,10 @@ Os objectos intervalo 4D View Pro são compostos por várias propriedades: 4D View Pro suporta a importação e exportação de vários formatos de documentos: - - .4vp - - .xlsx - - .txt e .csv - - .sjs - - .pdf (apenas para exportação) +- .4vp +- .xlsx +- .txt e .csv +- .sjs +- .pdf (apenas para exportação) Para obter mais detalhes, confira a descrição de [VP IMPORT DOCUMENT](commands/vp-import-document.md) e [VP EXPORT DOCUMENT](commands/vp-export-document.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md index 217af63b46f897..836441d9b6ee0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/from-qodlyscript-to-4d.md @@ -35,12 +35,12 @@ Some other items have a different case (ex: `this` vs `This`) but can be pasted QodlyScript command and constant names are written in camel case without spaces. Além disso, os nomes das constantes QodlyScript começam com a letra `k`. You might need to adapt these QodlyScript items to the 4D Language. - - Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. - - However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. +- Normalmente, você só precisará converter os nomes. Por exemplo, `newCollection` em QodlyScript é `New collection` em Linguagem 4D. +- However, some commands have been renamed for a better compliance, for example `atan` and `sqrt` are QodlyScript names for `Arctan` and `Square root` commands in 4D Language. ### Exemplo - - Código QodlyScript: +- Código QodlyScript: ```qs declare(entitySelection : 4D.EntitySelection) @@ -56,7 +56,7 @@ QodlyScript command and constant names are written in camel case without spaces. end ``` - - Código 4D equivalente no linguajem: +- Código 4D equivalente no linguajem: ```4d #DECLARE ( $entitySelection : 4D.EntitySelection ) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md index 2e41224923c456..9e0085b73e83d1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/gettingStarted.md @@ -188,8 +188,8 @@ Nas seções acima, nós temos acesso gratuito à aplicação através de solici A maneira mais simples e segura para registrar um usuário no servidor da Web 4D é baseada no seguinte cenário: - - Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) - - La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. +- Los usuarios se almacenan en una tabla dedicada y no expuesta (llamada *WebUsers* por ejemplo) +- La tabla *WebUsers* podría estar [encriptada](MSC/encrypt.md) y almacena el login del usuario y un hash de su contraseña. 1. Criar uma tabela com alguns campos, por exemplo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md index 1a62e2ddee7d64..40345036d4029d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/http-request-handler.md @@ -11,16 +11,16 @@ When a custom HTTP request handler intercepts a request, it is processed directl Custom HTTP request handlers meet various needs, including: - - using a given URL as a resource provider or a file-uploading box (to download or upload various files), - - redirecting on specific pages according to a context (user authenticated, privileges granted...), - - handle an authentication via oAuth 2.0. +- using a given URL as a resource provider or a file-uploading box (to download or upload various files), +- redirecting on specific pages according to a context (user authenticated, privileges granted...), +- handle an authentication via oAuth 2.0. ## Requisitos Custom HTTP Request handlers are supported: - - quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, - - with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). +- quando as [sessões escalonáveis](./sessions.md#enabling-web-sessions) estão ativadas, +- with the main Web Server only (HTTP Request handlers that may have been defined in [Web Servers of components](../WebServer/webServerObject.md) are ignored). :::warning @@ -62,9 +62,9 @@ You must restart the Web server so that modifications made in this file are take A handler is defined by: - - a listened URL pattern - - a function and its class where the code is implemented to handle the listened URL pattern - - the verbs with which the URL can be called to trigger the handler +- a listened URL pattern +- a function and its class where the code is implemented to handle the listened URL pattern +- the verbs with which the URL can be called to trigger the handler The handler identifier is the couple [pattern + a verb among the verbs list]. @@ -72,10 +72,10 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressões regulares**. - - To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/**/index.html"` - - To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. Ex: `"regexPattern" : "/docs/.+/index\.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -84,8 +84,8 @@ Os padrões de URL podem ser fornecidos como **prefixos** ou usando **expressõe URL patterns are triggered in the given order: - - the first matching pattern is executed - - the following patterns are not executed even if they match the URL +- the first matching pattern is executed +- the following patterns are not executed even if they match the URL As a consequence, you need to apply a accurate strategy when writing your handlers: the most detailed patterns must be written before the more general patterns. @@ -117,17 +117,17 @@ As a consequence, you need to apply a accurate strategy when writing your handle URL patterns matching 4D built-in HTTP processing features are not allowed in custom HTTP handlers. For example, the following patterns cannot be handled: - - `/4DACTION` - - `/rest` - - `/$lib/renderer` - - `/$shared` +- `/4DACTION` +- `/rest` +- `/$lib/renderer` +- `/$shared` ### Classe e método You declare the code to be executed when a defined URL pattern is intercepted using the "class" and "method" properties. - - "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). - - "method": class function belonging to the class. +- "class": class name without `cs.`, e.g. "UsersHandling" for the `cs.UsersHandling` user class. Deve ser uma classe [**compartilhada**](../Concepts/classes.md#shared-singleton) e [**singleton**](../Concepts/classes.md#singleton-classes). +- "method": class function belonging to the class. [Veja abaixo](#request-handler-code) para informações sobre o código do manipulador de pedidos. @@ -208,11 +208,11 @@ Here is a detailed example of a HTTPHandlers.json file: In this example, you must implement the following functions: - - *handle function* in the *GeneralHandling* class - - *manageAccount* na classe *UsersHandling* - - *handleInvoices* na classe \*FinancialHandling - - *handleDocs* na classe *DocsHandling* - - *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* +- *handle function* in the *GeneralHandling* class +- *manageAccount* na classe *UsersHandling* +- *handleInvoices* na classe \*FinancialHandling +- *handleDocs* na classe *DocsHandling* +- *handleTheInvoice* / *handleDetails* / *handleInvoices* na clase *InvoicesHandling* Examples of URLs triggering the handlers: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md index a7055195bb0913..beb6ef24af4677 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/preemptiveWeb.md @@ -23,10 +23,10 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív | Servidor Web | cooperativo | *configuração web* | | Servidor Web Services | cooperativo | *configuração web* | - - Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) - - Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) - - Servidor de serviços Web: trata dos pedidos SOAP - - ***web setting*** significa que el modo apropiativo depende de un valor de configuración: +- Servidor REST: gestiona las [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) +- Servidor web: maneja las [plantillas web](templates.md), [4DACTION y los métodos base](httpRequests.md) +- Servidor de serviços Web: trata dos pedidos SOAP +- ***web setting*** significa que el modo apropiativo depende de un valor de configuración: - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. - caso contrário, a opção [**Usar processos preventivos**](webServerConfig.md#use-preemptive-processes) é tida em conta. - sobre processos de serviço Web (servidor ou cliente), modo preventivo é suportado no nível do método. You just have to select "Can be run in preemptive processes" property for published SOAP server methods (see [Publishing a Web Service with 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) or proxy client methods (see [Subscribing to a Web Service in 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) and make sure they are confirmed thread-safe by the compiler. @@ -35,21 +35,21 @@ A tabela a seguir indica se o modo preventivo está utilizado ou está disponív Todo o código 4D executado pelo servidor deve ser hilo seguro se você quiser que seus processos web sejam executados em modo preventivo. Cuando el [modo apropiativo está activo](#availability-of-preemptive-mode-for-web-processes), las siguientes partes de la aplicación serán evaluadas automáticamente por el compilador 4D: - - Todos os métodos bases relacionados com a Web: +- Todos os métodos bases relacionados com a Web: - [`On Web Authentication`](authentication.md#on-web-authentication) - [`On Web Connection`](httpRequests.md#on-web-connection) - `On REST Authentication` - [`On Mobile App Authentication`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-authentication) e [`On Mobile App Action`](https://developer.4d.com/go-mobile/docs/4d/on-mobile-app-action) - - El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); +- El método proyecto `compilador_web` (independientemente de su propiedad real "Modo de ejecución"); - - Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml +- Basicamente, qualquer código processado pelo comando [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) no contexto Web, por exemplo, por páginas .shtml - - Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) +- Todo método proyecto con el atributo "Disponible a través de etiquetas 4D y URLs (`4DACTION`, etc.) - - Triggers para as tabelas com o atributo "Expor como recurso REST" +- Triggers para as tabelas com o atributo "Expor como recurso REST" - - [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST +- [funciones de clase del modelo de datos ORDA](../REST/ClassFunctions.md) llamadas vía REST Para cada um desses métodos e partes de código, o compilador irá verificar se as regras de segurança de threads são respeitadas, e retornará erros em caso de problemas. Para más información sobre las reglas hilo seguro, consulte el párrafo *Escribir un método hilo seguro* en el capítulo *Procesos* del manual de [Lenguaje 4D](https://doc.4d.com). @@ -61,8 +61,8 @@ A maioria dos comandos 4D relacionados à Web e funções, métodos de banco de Todos los comandos 4D relativos a la web son hilo seguro, *es decir*: - - todos los comandos del tema *Servidor Web*, - - todos los comandos del tema *Cliente HTTP*. +- todos los comandos del tema *Servidor Web*, +- todos los comandos del tema *Cliente HTTP*. Los métodos base relacionados con la web son hilo seguro y pueden utilizarse en modo apropiativo (ver arriba): `On Web Authentication`, `On Web Connection`, `On REST Authentication`...). @@ -72,16 +72,16 @@ Obviamente, o código executado por esses métodos também deve ser hilo seguro. As seguintes URLs Web Server 4D são hilo seguro e podem ser usadas em modo preventivo: - - *4daction/* (el método proyecto llamado también debe ser hilo seguro) - - *4dcgi/* (los métodos base llamados también deben ser hilo seguro) - - *4dwebtest/* - - *4dblank/* - - *4dstats/* - - *4dhtmlstats/* - - *4dcacheclear/* - - *rest/* - - *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) - - *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) +- *4daction/* (el método proyecto llamado también debe ser hilo seguro) +- *4dcgi/* (los métodos base llamados también deben ser hilo seguro) +- *4dwebtest/* +- *4dblank/* +- *4dstats/* +- *4dhtmlstats/* +- *4dcacheclear/* +- *rest/* +- *4dimgfield/* (generado por `PROCESS 4D TAGS` para la petición web en los campos imagen) +- *4dimg/* (generado por `PROCESS 4D TAGS` para la petición web en las variables imagen) ### Ícone de processo web preemptivo diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md index 3e6b05dda928ae..8c30b69a2d3507 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/qodly-studio.md @@ -11,10 +11,10 @@ Qodly Studio também pode ser usado na [**plataforma Qodly Cloude**](https://qod Qodly Studio propõe uma interface de usuário web completa permitindo que você: - - crie páginas Qodly colocando componentes em uma tela - - mapeie componentes para Qodly Sources - - acione o código 4D configurando eventos - - e muito mais. +- crie páginas Qodly colocando componentes em uma tela +- mapeie componentes para Qodly Sources +- acione o código 4D configurando eventos +- e muito mais. ## Configuração @@ -24,19 +24,19 @@ Qodly Studio propõe uma interface de usuário web completa permitindo que você Qodly Studio suporta os seguintes navegadores Web: - - Chrome - - Edge - - FireFox +- Chrome +- Edge +- FireFox A resolução recomendada é 1920x1080. #### Aplicação 4D - - Desenvolvimento: 4D v20 R2 ou superior - - Desenvolvimento: 4D Server v20 R2 ou superior - - Qodly Studio só funciona com projetos 4D (bancos de dados binários não são suportados). - - Sessões Web (*aka* realizáveis) precisam [estar habilitadas](sessions.md#enabling-web-sessions). - - O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). +- Desenvolvimento: 4D v20 R2 ou superior +- Desenvolvimento: 4D Server v20 R2 ou superior +- Qodly Studio só funciona com projetos 4D (bancos de dados binários não são suportados). +- Sessões Web (*aka* realizáveis) precisam [estar habilitadas](sessions.md#enabling-web-sessions). +- O código 4D chamado pelos formulários Qodly deve ser [hilo seguro](preemptiveWeb.md). ### Habilitando o acesso a Qodly Studio @@ -46,8 +46,8 @@ O Qodly Studio é servido pelo [servidor web WebAdmin](../Admin/webAdmin.md) e e Para permitir o acesso ao Qodly Studio, você deve permiti-lo explicitamente em dois níveis: - - ao nível da aplicação 4D - - a nível do projeto +- ao nível da aplicação 4D +- a nível do projeto Se um dos dois níveis (ou ambos) não estiver habilitado, o acesso ao Qodly Studio é negado (uma página 403 é retornada). @@ -79,8 +79,8 @@ A autenticação no servidor web WebAdmin é concedida usando uma chave de acess De acordo com a gestão de projetos 4D, somente são suportados os seguintes usos: - - o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). - - implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. +- o desenvolvimento com Qodly Studio deve ser feito usando **4D** (monousuário). +- implantação de aplicações 4D com páginas Qodly deve ser feita usando **4D Server**. :::warning @@ -94,10 +94,10 @@ A página Qodly Studio está disponível quando o [servidor web WebAdmin](../Adm Há duas maneiras de acessar Qodly Studio: - - selecionando o comando de menu **Qodly Studio...** do menu **Design** (4D single-user) ou o menu **Window** (servidor 4D). +- selecionando o comando de menu **Qodly Studio...** do menu **Design** (4D single-user) ou o menu **Window** (servidor 4D). Se o servidor web WebAdmin já estiver rodando, dependendo de sua configuração, seu navegador padrão abre em `IPaddress:HTTPPort/studio` ou `IPaddress:HTTPSPort/studio`. Caso contrário, você será solicitado se quiser iniciar o servidor web WebAdmin primeiro. - - em um navegador, com o servidor web WebAdmin executando (lançado pelo servidor 4D ou 4D), digite o seguinte endereço:
+- em um navegador, com o servidor web WebAdmin executando (lançado pelo servidor 4D ou 4D), digite o seguinte endereço:
`IPaddress:HTTPPort/studio` ou : @@ -145,24 +145,24 @@ Não há compatibilidade direta entre aplicativos implementados com 4D e aplicat Os seguintes comandos e classes são dedicados ao gerenciamento do servidor das páginas de Qodly: - - Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. - - comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. - - clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. - - Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. +- Comando [`Web Form`](../API/WebFormClass.md#web-form): retorna a página Qodly como um objeto. +- comando [`Web Event`](../API/WebFormClass.md#web-event): retorna eventos acionados nos componentes da página Qodly. +- clase [`WebForm`](../API/WebFormClass.md): funções e propriedades para gerenciar a página Qodly renderizada. +- Classe [`WebFormItem`](../API/WebFormItemClass.md): funções e propriedades para gerenciar componentes de página Qodly. ### Uso de métodos projeto Recomendamos o uso de funções classe em vez de métodos projeto. Apenas as funções de classe podem ser chamadas a partir de componentes. No entanto, você ainda pode usar seus métodos projeto no Qodly Studio de duas maneiras: - - Você pode chamar seus métodos a partir de funções classe. - - Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. +- Você pode chamar seus métodos a partir de funções classe. +- Você pode diretamente [executar seus métodos](https://developer.qodly.com/docs/studio/coding#methods-and-classes) do Explorador Qodly. ### Uso fora de linha Você pode desenvolver com o Qodly Studio enquanto seu computador não estiver conectado à internet. Nesse caso, entretanto, os seguintes recursos não estão disponíveis: - - [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): a biblioteca de templates está vazia - - Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). +- [Templates](https://developer.qodly.com/docs/studio/pageLoaders/templates): a biblioteca de templates está vazia +- Dicas da UI: elas não são exibidas quando você clica ![alt-text](../assets/en/WebServer/tips.png). ## Implantação @@ -178,8 +178,8 @@ Veja [esta página](https://developer.qodly.com/docs/studio/rendering) para info Para ativar a renderização das páginas Qodly, as seguintes opções devem ser definidas. - - A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. - - O [servidor Web 4D](webServer.md) deve estar em execução. +- A opção **Propriedades** > **Web** > **Funcionalidades Web** > [**Expor como servidor REST**](../settings/web.md#expose-as-rest-server) deve ser ativada. +- O [servidor Web 4D](webServer.md) deve estar em execução. :::note @@ -309,9 +309,9 @@ Para fazer o logout do usuário, basta executar a ação padrão **Logout** na p Ativar a ação de logout de uma sessão do usuário web tem os seguintes efeitos: - - a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, - - a licença associada ao 4D é liberada, - - o `Session.storage` é mantido até que o tempo limite de inatividade da sessão web seja atingido (pelo menos uma hora). Durante esse período após um logout, se o usuário logar novamente, a mesma sessão é usada e a `Sessão. o objeto compartilhado de torage` está disponível com seu conteúdo atual. +- a sessão usuário web atual perde seus privilégios, apenas as [requisições REST descritivas](../REST/authUsers.md#descriptive-rest-requests) são permitidas, +- a licença associada ao 4D é liberada, +- o `Session.storage` é mantido até que o tempo limite de inatividade da sessão web seja atingido (pelo menos uma hora). Durante esse período após um logout, se o usuário logar novamente, a mesma sessão é usada e a `Sessão. o objeto compartilhado de torage` está disponível com seu conteúdo atual. ## Sobre o uso da licença para renderização @@ -363,7 +363,7 @@ Para mais informações sobre o atributo `SameSite`, confira [este post do blog] Para evitar o uso de mais licenças do que o necessário, recomendamos fazer um dos seguintes: - - Execute o renderizador em outra aba do navegador (digitando a URL renderizada da sua página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). - - Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. - - Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. +- Execute o renderizador em outra aba do navegador (digitando a URL renderizada da sua página Qodly: `IP:port/$lib/renderer/?w=QodlyPageName`). +- Assegure-se de que o Qodly Studio e seu banco de dados sejam acessados no mesmo esquema de URL. +- Use o valor `Lax` para o [cookie de sessão](webServerConfig.md#session-cookie-samesite) do servidor web do banco de dados do seu projeto. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md index 48f067b2f19148..db7782b67a1684 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/templates.md @@ -19,16 +19,16 @@ El valor de la variable 4D *vtSiteName* se insertará en la página HTML. Estão disponíveis as seguintes etiquetas 4D: - - 4DTEXT, para inserir variáveis e expressões 4D como texto, - - 4DHTML, para inserir código HTML, - - 4DEVAL, para avaliar qualquer expressão 4D, - - 4DSCRIPT, para executar um método 4D, - - 4DINCLUDE, para incluir uma página dentro de outra, - - 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, - - 4DCODE, para inserir o código 4D, - - 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, - - 4DLOOP e 4DENDLOOP, para criar loops no código HTML, - - 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. +- 4DTEXT, para inserir variáveis e expressões 4D como texto, +- 4DHTML, para inserir código HTML, +- 4DEVAL, para avaliar qualquer expressão 4D, +- 4DSCRIPT, para executar um método 4D, +- 4DINCLUDE, para incluir uma página dentro de outra, +- 4DBASE, para modificar a pasta predefinida utilizada pela etiqueta 4DINCLUDE, +- 4DCODE, para inserir o código 4D, +- 4DIF, 4DELSE, 4DELSEIF e 4DENDIF, para inserir condições no código HTML, +- 4DLOOP e 4DENDLOOP, para criar loops no código HTML, +- 4DEACH e 4DENDEACH, para fazer loop em coleções, seleções de entidades ou propriedades de objetos. Estas etiquetas se describen en la página [Etiquetas de transformación](../Tags/transformation-tags.md). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md index 079d8c87b483bd..06758b9824340d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerAdmin.md @@ -13,13 +13,13 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) O servidor web principal de 4D pode ser iniciado de diferentes maneiras: - - Utilizar um botão/comando de menu. +- Utilizar um botão/comando de menu. - 4D: menu **Executar\>Iniciar o servidor Web**
![](../assets/en/WebServer/start1.png) - 4D Server: botão **Iniciar servidor HTTP** da página Servidor HTTP
![](../assets/en/WebServer/start2.png) - - Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) +- Inicia automaticamente cada vez que a aplicação 4D é aberta. To do this, display the **Web\/Configuration** page of the Settings and select the **Launch Web Server at Startup** check box:
![](../assets/en/WebServer/config.png) - - Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. +- Programaticamente, chamando o comando [`webServer.start()`](API/WebServerClass.md#start) ou `WEB START SERVER`. O servidor Web de qualquer componente pode ser iniciado com a chamada da função [`webServer.start()`](API/WebServerClass.md#start) no objeto do servidor Web do componente. @@ -29,9 +29,9 @@ O servidor Web de qualquer componente pode ser iniciado com a chamada da funçã O servidor web principal de 4D pode ser parado de diferentes maneiras: - - Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). +- Utilizando el menú 4D **Ejecución\>Detener el servidor Web**, o vía el botón **Detener el servidor HTTP** de la página Servidor HTTP de 4D Server (ambos elementos muestran **Iniciar...** cuando el servidor no está ya iniciado). - - Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. +- Programmaticamente, chamando o comando [`webServer.stop()`](API/WebServerClass.md#stop) ou `WEB STOP SERVER`. El servidor web de cualquier componente puede detenerse llamando a la función `webServer.stop()` en el objeto servidor web del componente. @@ -53,8 +53,8 @@ A qualquer momento, você pode limpar o cache das páginas e imagens que ele con Para o fazer, pode: - - 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. - - 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. +- 4D: haga clic en el botón **Borrar la caché** de la página [Web/Opciones (I)](../settings/web.md) de la caja de diálogo Parámetros. +- 4D Server: haga clic en el botón **Borrar la caché** de la página HTTP de la ventana Administración de 4D Server. A cache é então imediatamente limpa. @@ -64,11 +64,11 @@ A cache é então imediatamente limpa. La página **Watch** (sección **Web**) del Explorador de ejecución muestra la información del servidor web, en particular: - - **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. +- **Uso de la caché web**: indica el número de páginas presentes en la caché web así como su porcentaje de uso. Esta informação só estará disponível se o servidor web estiver ativo e se o tamanho do cache for maior que 0. - - **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. +- **Tiempo de actividad del servidor web**: indica la duración del uso (en formato horas:minutos:segundos) del servidor web. Esta informação só está disponível se o servidor Web estiver ativo. - - **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. +- **Conteo de visitas web**: indica el número total de peticiones HTTP recibidas desde el arranque del servidor web, así como un número instantáneo de peticiones por segundo (medida tomada entre dos actualizaciones del Explorador de ejecución). Esta informação só está disponível se o servidor Web estiver ativo. ## URLs de administração @@ -123,8 +123,8 @@ La URL */4DWEBTEST* permite verificar el estado del servidor web. Quando esse UR 4D permite gerar dois logs de pedidos web: - - un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), - - un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). +- un historial de depuración, útil en la fase de desarrollo del servidor web (*HTTPDebugLog.txt*), +- un historial estandarizado de peticiones web, más bien utilizado con fines estadísticos (*logweb.txt*). Ambos archivos de historial se crean automáticamente en la carpeta **Logs** del proyecto de aplicación. @@ -223,15 +223,15 @@ Los parámetros de copia de seguridad automáticadel logweb.txt se definen en la First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md index 102c959a8cee73..e10569433d2d67 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerConfig.md @@ -82,29 +82,29 @@ Lista de hosts e métodos permitidos para o serviço CORS. Nome de domínio ou endereço IP de onde as páginas externas têm permissão para enviar solicitações de dados ao servidor via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Várias sintaxes são suportadas: - - 192.168.5.17:8081 - - 192.168.5.17 - - 192.168.\* - - 192.168.\*:8081 - - http://192.168.5.17:8081 - - http://\*.myDomain.com - - http://myProject.myDomain.com - - \*.myDomain.com - - myProject.myDomain.com - - \* +- 192.168.5.17:8081 +- 192.168.5.17 +- 192.168.\* +- 192.168.\*:8081 +- http://192.168.5.17:8081 +- http://\*.myDomain.com +- http://myProject.myDomain.com +- \*.myDomain.com +- myProject.myDomain.com +- \* #### Métodos HTTP autorizados (propriedade methods) Método(s) HTTP aceite(s) para o host CORS correspondente. São suportados os seguintes métodos HTTP: - - GET - - HEAD - - POST - - PUT - - DELETE - - OPTIONS - - TRACE - - PATCH +- GET +- HEAD +- POST +- PUT +- DELETE +- OPTIONS +- TRACE +- PATCH Separar cada método com um ";" (por exemplo: "post;get"). Se methods estiver vazio, null ou indefinido, todos os métodos serão ativados. @@ -145,9 +145,9 @@ Por padrão, quando o servidor web é iniciado pela primeira vez, 4D cria uma p Você pode designar outra página inicial padrão inserindo seu nome de caminho. - - O caminho é relativo à [pasta raiz HTML padrão](#root-folder). - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - O caminho não deve começar nem terminar com uma barra. +- O caminho é relativo à [pasta raiz HTML padrão](#root-folder). +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- O caminho não deve começar nem terminar com uma barra. Por exemplo, se você quiser que a página inicial padrão seja "MyHome. tm", e está localizado na pasta "Web" (ela própria localizada na pasta raiz padrão HTML), use "Web/MyHome.htm". @@ -318,15 +318,15 @@ Valores possíveis: cadeia de endereços IP. Ambos os formatos de string IPv6 (p #### Acerca do suporte IPv6 - - **Sem aviso quando a porta TCP estiver ocupada**
+- **Sem aviso quando a porta TCP estiver ocupada**
Quando o servidor estiver definido para responder em "Qualquer" endereços IP, se a porta TCP estiver sendo usada por outra aplicação, isso não é indicado quando o servidor é iniciado. Na verdade, o servidor 4D não detecta nenhum erro neste caso porque a porta permanece gratuita no endereço IPv6. No entanto, não é possível acessá-lo usando o endereço IPv4 da máquina, nem através do endereço local: 127.0.0.1. Se o seu servidor 4D não parecer responder na porta definida, pode testar o endereço [::1] na máquina do servidor (equivalente a 127.0.0.1 para IPv6, adicionar [:portNum] para testar outro número de porta). Se 4D responder, é provável que outro aplicativo esteja usando a porta em IPv4. - - **Endereços IPv6 mapeados**
+- **Endereços IPv6 mapeados**
Para padronizar o processamento, 4D fornece uma representação híbrida padrão de endereços IPv4 em IPv6. Esses endereços são escritos com um prefixo de 96 bits no formato IPv6, seguido de 32 bits escritos na notação ponto-decimal do IPv4. Por exemplo, ::ffff:192.168.2.34 representa o endereço IPv4 192.168.2.34. - - **Indicação dos números da porta**
+- **Indicação dos números da porta**
Dado que a notação IPv6 usa dois-pontos (:), adicionar números de portas pode causar alguma confusão, por exemplo: ```code4d @@ -420,10 +420,10 @@ Versão mínima de TLS aceita para ligações. As tentativas de ligação de cli Valores possíveis: - - 1 = TLSv1_0 - - 2 = TLSv1_1 - - 3 = TLSv1_2 (padrão) - - 4 = TLSv1_3 +- 1 = TLSv1_0 +- 2 = TLSv1_1 +- 3 = TLSv1_2 (padrão) +- 4 = TLSv1_3 Se modificado, o servidor deve ser reiniciado para utilizar o novo valor. @@ -489,10 +489,10 @@ Por exemplo: Disallow: /GIFS/ ``` - - "User-Agent: \*" - todos os robôs são afetados. - - "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. - - "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. - - "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. +- "User-Agent: \*" - todos os robôs são afetados. +- "Disallow: /4D" - os robôs não têm permissão para acessar URLs que começam com /4D. +- "Disallow: /%23%23" - os robôs não têm permissão para acessar URLs que começam com /%23%23. +- "Disallow: /GIFS/' - os robôs não têm permissão para acessar a pasta /GIFS/ ou suas subpastas. Outro exemplo @@ -517,15 +517,15 @@ Além disso, a pasta raiz do HTML define, no disco rígido do servidor da Web, o Por padrão, 4D define uma pasta HTML Root chamada **WebFolder**. Se ela ainda não existir, a pasta raiz HTML será fisicamente criada no disco no momento em que o servidor Web for iniciado pela primeira vez. A pasta raiz é criada: - - com 4D (local) e servidor 4D, no mesmo nível que a [pasta do projeto](Project/architecture.md#project-folder). - - com 4D em modo remoto, na pasta de recursos locais. +- com 4D (local) e servidor 4D, no mesmo nível que a [pasta do projeto](Project/architecture.md#project-folder). +- com 4D em modo remoto, na pasta de recursos locais. Você pode designar outra pasta raiz HTML padrão inserindo seu caminho. - - O caminho é relativo à [pasta do projeto](Project/architecture.md#project-folder) (servidor local e 4D) ou à pasta que contém o pacote de software ou aplicativo 4D (4D no modo remoto). - - O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) - - Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta - - O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). +- O caminho é relativo à [pasta do projeto](Project/architecture.md#project-folder) (servidor local e 4D) ou à pasta que contém o pacote de software ou aplicativo 4D (4D no modo remoto). +- O caminho é expresso com a sintaxe POSIX (pastas são separadas por uma barra ("/")) +- Para "subir" um nível na hierarquia de pastas, digite "..." (dois pontos) antes do nome da pasta +- O caminho não deve começar com uma barra (exceto se você quiser que a pasta raiz HTML seja a pasta remota Project ou 4D, mas que o acesso às pastas acima seja proibido; nesse caso, você pode passar "/" como a pasta raiz). Por exemplo, se você quiser que a pasta raiz HTML seja a subpasta "Web" na pasta "MyWebApp", digite "MyWebApp/Web". @@ -580,9 +580,9 @@ Valor do atributo 'SameSite' do cookie de sessão. Esse atributo permite declara Há três valores disponíveis: - - "Strict" (valor de atributo padrão `SameSite` para cookies de sessão 4D): os cookies só serão enviados no contexto de primeira, ou seja, no contexto correspondente ao domínio do site atual, e nunca a sites de terceiros. - - "Lax": os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). - - "None": cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). +- "Strict" (valor de atributo padrão `SameSite` para cookies de sessão 4D): os cookies só serão enviados no contexto de primeira, ou seja, no contexto correspondente ao domínio do site atual, e nunca a sites de terceiros. +- "Lax": os cookies não são enviados em solicitações entre sites (por exemplo, para carregar imagens ou quadros em um site de terceiros), mas são enviados quando um usuário está navegando para o site de origem (ou seja, ele segue um link). +- "None": cookies são enviados em todos os contextos, ou seja, nas respostas para solicitações de primeira e de cruzada de origem. Cuando se utiliza el valor "None", el atributo cookie `Secure` también debe ser definido (o la cookie será bloqueada). O valor de atributo 'Secure' do cookie de sessão é definido automaticamente como "True" se a conexão for HTTPS (qualquer que seja o valor de atributo 'SameSite'). @@ -626,9 +626,9 @@ Em alguns casos, outras funções internas otimizadas podem ser invocadas. As li Duas opções permitem que você defina como funcionam as conexões persistentes: - - **Número de solicitações por conexão**: permite definir o número máximo de solicitações e respostas que podem trafegar em uma conexão keep alive. Limitar o número de solicitações por conexão permite que você evite a inundação do servidor devido a um grande número de solicitações recebidas (uma técnica usada por hackers).

+- **Número de solicitações por conexão**: permite definir o número máximo de solicitações e respostas que podem trafegar em uma conexão keep alive. Limitar o número de solicitações por conexão permite que você evite a inundação do servidor devido a um grande número de solicitações recebidas (uma técnica usada por hackers).

The default value (100) can be increased or decreased depending on the resources of the machine hosting the 4D Web Server.

- - **Timeout**: esse valor define o período máximo de espera (em segundos) durante o qual o servidor da Web mantém uma conexão TCP aberta sem receber nenhuma solicitação do navegador da Web. Quando este período acabar, o servidor fecha a conexão.

+- **Timeout**: esse valor define o período máximo de espera (em segundos) durante o qual o servidor da Web mantém uma conexão TCP aberta sem receber nenhuma solicitação do navegador da Web. Quando este período acabar, o servidor fecha a conexão.

Se o navegador da web enviar um pedido depois que a conexão for fechada, uma nova conexão TCP será criada automaticamente. Esta operação não é visível para o usuário.

diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md index 89dc823399d8ab..f5027f1adccc0d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WebServer/webServerObject.md @@ -7,9 +7,9 @@ Um projeto 4D pode iniciar e monitorar um servidor web para a aplicação (host) Por exemplo, se você instalou dois componentes em sua aplicação principal, você pode iniciar e monitorar até três servidores web independentes em sua aplicação: - - um servidor web para a aplicação local, - - um servidor Web para o componente #1, - - um servidor Web para o componente #2. +- um servidor web para a aplicação local, +- um servidor Web para o componente #1, +- um servidor Web para o componente #2. Além da memória, não há limite para o número de componentes e, assim, de servidores web, que podem ser anexados a um único projeto de aplicação 4D. @@ -19,9 +19,9 @@ Cada servidor web 4D, incluido el servidor web de la aplicación principal, se e Cada servidor web (aplicação host ou componente) pode ser usado em seu próprio contexto separado, incluindo: - - las llamadas a los métodos base `On Web Authentication` y `On Web Connection` - - o processamento das etiquetas 4D e das chamadas de métodos, - - sessões Web e gestão do protocolo TLS. +- las llamadas a los métodos base `On Web Authentication` y `On Web Connection` +- o processamento das etiquetas 4D e das chamadas de métodos, +- sessões Web e gestão do protocolo TLS. Isso permite que você desenvolva componentes e recursos independentes que vêm com suas próprias interfaces web. @@ -48,8 +48,8 @@ webServer:=WEB Server(Web server database) Se a aplicação utilizar componentes e o usuário pretender chamar: - - o servidor Web da aplicação host a partir de um componente ou - - o servidor que recebeu o pedido (qualquer que seja o servidor), +- o servidor Web da aplicação host a partir de um componente ou +- o servidor que recebeu o pedido (qualquer que seja o servidor), também pode ser utilizado: @@ -94,8 +94,8 @@ Estas propriedades são definidas: 2. si no se utiliza, utilizando el comando `WEB SET OPTION` (sólo aplicaciones locales), 3. se não for usado, nos parâmetros da aplicação host ou do componente. - - Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. - - If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. +- Se o servidor web não for iniciado, as propriedades contêm os valores que serão usados na próxima inicialização do servidor web. +- If the web server is started, the properties contain the actual values used by the web server (default settings could have been overriden by the `settings` parameter of the [`.start()`](API/WebServerClass.md#start) function. > *isRunning*, *name*, *openSSLVersion*, and *perfectForwardSecrecy* are read-only properties that cannot be predefined in the `settings` object parameter for the [`start()`](API/WebServerClass.md#start) function. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md index 241cf8f08802d9..8279b68a3320eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-break.md @@ -24,9 +24,9 @@ The **WP Insert break** command ins Em *targetObj*, passe: - - um intervalo, ou - - an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or - - um documento 4D Write Pro +- um intervalo, ou +- an element (table / row / paragraph / body / header / footer / inline picture / section / subsection), or +- um documento 4D Write Pro In *breakType*, pass one of the following constants from the *4D Write Pro Constants* theme to define the type of break to insert: @@ -47,7 +47,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us | wk prepend | Integer | 1 | Insert contents at beginning of target | | wk replace | Integer | 0 | Replace target contents | - - If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: +- If *targetObj* is a range, you can use the optional *rangeUpdate* parameter to pass one of the following constants to specify whether or not the inserted contents are included in the resulting range: | Parâmetros | Tipo | Valor | Comentário | | --------------------- | ------- | ----- | ------------------------------------------------------------------------ | @@ -56,7 +56,7 @@ In the *mode* parameter, pass a constant to indicate the insertion mode to be us If you do not pass a *rangeUpdate* parameter, by default the inserted contents are included in the resulting range. - - Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. +- Se *targetObj* não for um intervalo, *rangeUpdate* será ignorado. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md index 491bc78f5d2554..23587c8ed23223 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/WritePro/commands/wp-insert-document-body.md @@ -24,9 +24,9 @@ The **WP Insert document body** commandO comando **Form** retorna o objeto associado ao formulário atual (instanciado a partir do parâmetro *formData* ou da classe usuário atribuída no editor de formulários). O 4D associa automaticamente um objeto ao formulário atual nos seguintes casos: - - o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), - - o formulário atual é um subformulário, - - um formulário de tabela é exibido na tela no momento. +- o formulário atual foi carregado por um dos comandos [`DIALOG`](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), +- o formulário atual é um subformulário, +- um formulário de tabela é exibido na tela no momento. ### Comandos (DIALOG...) Se o formulário atual estiver sendo exibido ou carregado por uma chamada aos comandos [DIALOG](dialog.md), [`Print form`](print-form.md) ou [`FORM LOAD`](form-load.md), **Form** retornará um dos dois: - - o objeto *formData* passado como parâmetro para esse comando, se houver, - - ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, - - ou um objeto vazio. +- o objeto *formData* passado como parâmetro para esse comando, se houver, +- ou, um objeto instanciado da [classe de usuário associada ao formulário](../FormEditor/properties_FormProperties.md#form-class), se houver, +- ou um objeto vazio. ### Subformulário Se o formulário atual for um subformulário, o objeto retornado dependerá da variável do contêiner pai: - - Se a variável associada ao contêiner pai tiver sido digitada como um objeto, **Form** retornará o valor dessa variável.\ +- Se a variável associada ao contêiner pai tiver sido digitada como um objeto, **Form** retornará o valor dessa variável.\ **Form** returns the object associated with the table form displayed on screen.\ In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: @@ -50,7 +50,7 @@ Se o formulário atual for um subformulário, o objeto retornado dependerá da v (OBJECT Get pointer(Object subform container))-> ``` - - Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. +- Se a variável associada ao contêiner pai não foi tipada como um objeto, **Forma** retorna um objeto vazio, mantido por 4D no contexto do subformulário. Para mais informações, consulte a seção *Subformulários de Páginas*. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md index 2128ff99f847fc..2ffe7e88a60ae7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/new-shared-collection.md @@ -39,14 +39,14 @@ Se o novo índice elemento for além do último elemento existente da coleção Pode passar qualquer número de valores dos tipos compatíveis abaixo: - - número (real, longint....). Valores numéricos são sempre armazenados como reais. - - text - - boolean - - date - - hora (armazenada como número de milissegundos - real) - - null - - objeto compartido - - coleção compartilhada +- número (real, longint....). Valores numéricos são sempre armazenados como reais. +- text +- boolean +- date +- hora (armazenada como número de milissegundos - real) +- null +- objeto compartido +- coleção compartilhada :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md index 9932777fa589eb..06e4be9e27340c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/print-form.md @@ -25,15 +25,15 @@ displayed_sidebar: docs No parâmetro *form*, você pode passar: - - o nome de um formulário, ou - - o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou - - um objeto contendo uma descrição do formulário. +- o nome de um formulário, ou +- o caminho (na sintaxe POSIX) para um arquivo .json válido que contém uma descrição do formulário a ser usado (consulte *Caminho do arquivo de formulário*), ou +- um objeto contendo uma descrição do formulário. Como **Imprimir formulário** não emite uma quebra de página após a impressão do formulário, é fácil combinar diferentes formulários na mesma página. Portanto, o **Print form** é perfeito para tarefas de impressão complexas que envolvam diferentes tabelas e diferentes formulários. Para forçar uma quebra de página entre os formulários, use o comando [PAGE BREAK](../commands-legacy/page-break.md). Para transferir a impressão para a próxima página em um formulário cuja altura seja maior que o espaço disponível, chame o comando [CANCEL](../commands-legacy/cancel.md) antes do comando [PAGE BREAK](../commands-legacy/page-break.md). Três sintaxes diferentes podem ser usadas: - - **Impressão da área de detalhe** +- **Impressão da área de detalhe** Sintaxe: @@ -43,7 +43,7 @@ Sintaxe: Nesse caso, **Imprimir formulário** imprime apenas a área de detalhes (a área entre a linha do cabeçalho e a linha de detalhes) do formulário. - - **Impressão da área do formulário** +- **Impressão da área do formulário** Sintaxe: @@ -79,7 +79,7 @@ Nesse caso, o comando imprimirá a seção designada pelo *marker*. Passe uma da | Form header8 | Integer | 208 | | Form header9 | Integer | 209 | - - **Impressão da seção** +- **Impressão da seção** Sintaxe: @@ -101,8 +101,8 @@ O valor retornado por **Print form** indica a altura da área impressa. Esse val As caixas de diálogo da impressora não são exibidas quando você usa **Print form**. O relatório não usa as configurações de impressão que foram atribuídas ao formulário no ambiente Design. Há duas maneiras de especificar as configurações de impressão antes de emitir uma série de chamadas para **Print form**: - - Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. - - Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. +- Chame [PRINT SETTINGS](../commands-legacy/print-settings.md). Nesse caso, você permite que o usuário escolha as configurações. +- Chame [SET PRINT OPTION](../commands-legacy/set-print-option.md) e [GET PRINT OPTION](../commands-legacy/get-print-option.md). Nesse caso, as configurações de impressão são especificadas de forma programática. **Print form**\* cria cada página impressa na memória. Cada página é impressa quando a página na memória está cheia ou quando você chama [PAGE BREAK] (../commands-legacy/page-break.md). Para garantir a impressão da última página após qualquer uso de **formulário de impressão**, você deve concluir com o comando [PAGE BREAK](../commands-legacy/page-break.md) (exceto no contexto de um [ABERTO PRINTING JOB](../commands-legacy/open-printing-job.md), ver nota). Caso contrário, se a última página não estiver cheia, ela permanecerá na memória e não será impressa. @@ -116,8 +116,8 @@ Esse comando imprime áreas e objetos externos (por exemplo, áreas 4D Write ou **4D Server:** Esse comando pode ser executado no 4D Server dentro da estrutura de um procedimento armazenado. Neste contexto: - - Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). - - No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. +- Certifique-se de que nenhuma caixa de diálogo seja exibida no computador do servidor (exceto por um requisito específico). +- No caso de um problema relacionado à impressora (falta de papel, impressora desconectada, etc.), nenhuma mensagem de erro é gerada. ## Exemplo 1 diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md index 8ef8463555262b..c35abaaaa85ce5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/process-info.md @@ -44,7 +44,7 @@ O objeto retornado contém as propriedades abaixo: | type | Integer | Tipo de processo em execução. Valores possíveis: veja abaixo | | visible | Parâmetros | True if visible, false otherwise | - - Valores possíveis para "state": +- Valores possíveis para "state": | Parâmetros | Valor | | ------------------------- | ----- | @@ -57,7 +57,7 @@ O objeto retornado contém as propriedades abaixo: | Waiting for internal flag | 4 | | Paused | 5 | - - Valores possíveis para "type": +- Valores possíveis para "type": | Parâmetros | Valor | | ----------------------------- | ----- | diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/session.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/session.md index 6bbf9889f0877e..79545be3842d19 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/session.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/commands/session.md @@ -96,11 +96,14 @@ IP:port/4DACTION/action_Session End case ``` -### Veja também +## Veja também [Session storage](session-storage.md)\ [Session API](../API/SessionClass.md)\ [Web server user sessions](../WebServer/sessions.md) +[*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) + +- [*Permissions: Inspect Session Privileges for Easy Debugging* (blog post)](https://blog.4d.com/permissions-inspect-session-privileges-for-easy-debugging/) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md index be108f33fb31e9..66461efc27a1eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/client-server.md @@ -13,8 +13,8 @@ As páginas Cliente-servidor agrupam parâmetros relacionados ao uso do banco de Essa opção permite que você indique se o banco de dados do 4D Server aparecerá ou não na lista de bancos de dados publicados. - - When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). - - Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. +- When this option is checked (default), the database is made public and appears in the list of published databases (**Available** tab). +- Quando a opção não estiver marcada, o banco de dados não será tornado público e não aparecerá na lista de bancos de dados publicados. Para se conectar, os usuários devem inserir manualmente o endereço do banco de dados na guia **Personalizado** da caixa de diálogo de conexão. :::note @@ -49,12 +49,12 @@ Para actualizar las otras máquinas clientes que no estén conectadas, basta con O 4D Server usa três portas TCP para comunicações entre servidores internos e clientes: - - **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). - - **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). - - **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ +- **SQL Server**: 19812 por defecto (puede modificarse a través de la página "SQL/Configuración" de las Preferencias). +- **Application Server**: 19813 by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). +- **DB4D Server** (servidor de banco de dados): 19814 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 1.\ When a 4D client connects to 4D Server, it uses the TCP port of the application server (19813 or the port indicated after the colon ':' in the IP address shown in the connection dialog box). Connection to other servers via their respective ports is then automatic; it is no longer necessary to specify them.\ Note that in the case of access via a router or a firewall, the three TCP ports must be opened explicitly. - - [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. +- [**Depurador remoto**](../Debugging/debugging-remote.md): 19815 por padrão. This port number cannot be modified directly but it always consists of the application server port number + 2. #### Autenticação do usuário com o servidor de domínio @@ -68,9 +68,9 @@ Quando o Single Sign On (SSO) estiver ativado (veja acima), você deverá preenc This drop-down box contains 3 network layer options to choose between: **legacy**, **ServerNet** and **QUIC** (only in project mode), which are used to handle communications between 4D Server and remote 4D machines (clients). - - **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). - - **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). - - **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. +- **Legacy**: This former "legacy" network layer is still supported in order to ensure compatibility for databases created prior to v15. Essa camada de rede também pode ser ativada por programação usando o comando [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md). +- **ServerNet** (por padrão): ativa a camada de rede ServerNet no servidor (disponível desde 4D v15). +- **QUIC** (disponible solo en modo proyecto): activa la capa de red QUIC en el servidor. **Notas**: @@ -110,9 +110,9 @@ Essa opção permite que você ative o modo seguro para comunicações entre a m This setting can be used to globally set the updating mode for the local instance of the **Resources** folder on the connected 4D machines when the **Resources** folder of the database is modified during the session (the **Resources** folder is automatically synchronized on the remote machine each time a session is opened). Estão disponíveis três parâmetros: - - **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). - - **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. - - **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ +- **Nunca**: a pasta local **Resources** não é atualizada durante a sessão. A notificação enviada pelo servidor é ignorada. A pasta local **Resources** pode ser atualizada manualmente com o comando do menu de ação **Update Local Resources** (consulte [Usando o explorador de recursos](https://doc.4d.com/4Dv20/4D/20.2/Using-the-Resources-explorer.300-6750254.en.html)). +- **Always**: The synchronization of the local **Resources** folder is automatically carried out during the session whenever notification is sent by the server. +- **Ask**: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local **Resources** folder.\ The **Resources** folder centralizes the custom files required for the database interface (translation files, pictures, etc.). Mecanismos automáticos ou manuais podem ser usados para notificar cada cliente quando o conteúdo dessa pasta tiver sido modificado. Para mais informações, por favor consulte a seção [Gerenciando da pasta Resources](https://doc.4d.com/4Dv20/4D/20/Managing-the-Resources-folder.300-6330534.en.html). ## Página Configuração IP @@ -125,10 +125,10 @@ Essa tabela permite definir regras de controle de acesso para o banco de dados, O comportamento da tabela de configuração é o seguinte: - - A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. - - A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. - - A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. - - Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: +- A coluna "Allow-Deny" permite selecionar o tipo de regra a ser aplicada (Allow ou Deny) usando um menu pop-up. Para adicionar uma regra, clique no botão Adicionar. Aparece uma nova linha na tabela. O botão **Excluir** permite que você remova a linha atual. +- A coluna "IP Address" (Endereço IP) permite definir o(s) endereço(s) IP afetado(s) pela regra. Para especificar um endereço, clique na coluna e digite o endereço da seguinte forma: 123.45.67.89 (formato IPv4) ou 2001:0DB8:0000:85A3:0000:0000:AC1F:8001 (formato IPv6). Você pode usar um caractere \* (asterisco) para especificar endereços do tipo "começa com". Por exemplo, 192.168.\* indica todos os endereços que começam com 192.168. +- A aplicação das regras é baseada na ordem de exibição da tabela. Se duas regras forem contraditórias, a prioridade será dada à regra localizada na parte mais alta da tabela. Você pode reordenar as linhas modificando a classificação atual (clique no cabeçalho da coluna para alternar a direção da classificação). Você também pode mover as linhas usando o recurso de arrastar e soltar. +- Por motivos de segurança, somente os endereços que realmente correspondem a uma regra terão permissão para se conectar. Em outras palavras, se a tabela contiver apenas uma ou mais regras Deny, todos os endereços serão recusados porque nenhum corresponderá a pelo menos uma regra. Se você quiser negar apenas determinados endereços (e permitir outros), adicione uma regra Allow \* no final da tabela. Por exemplo: - Negar 192.168.\* (negar todos os endereços que comecem por 192.168) - Autorizar \* (e autorizar outros) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md index f5dc235cc5c47d..7a47cabf23f216 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/compatibility.md @@ -8,10 +8,10 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m > The number of options displayed depends on the version of 4D with which the original database/project was created, as well as the settings modified in this database/project.\ > This page lists the compatibility options available for database/projects converted from 4D v18 onwards. Para opções de compatibilidade mais antigas, consulte a [Página de compatibilidade](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) em **doc.4d.com**. - - **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. +- **Use legacy network layer**: Starting with 4D v15, 4D applications propose a new network layer, named *ServerNet*, to handle communications between 4D Server and remote 4D machines (clients). A antiga camada de rede tornou-se obsoleta, mas é mantida para garantir a compatibilidade com as bases de dados existentes. Usando esta opção, você pode ativar a antiga camada de rede a qualquer momento nos seus aplicativos do servidor 4D dependendo das suas necessidades. *ServerNet* é usado automaticamente para novos bancos de dados e bancos de dados convertidos a partir de uma versão v15 ou posterior. Observe que, em caso de modificação, você precisa reiniciar o aplicativo para que a mudança seja levada em conta. Todos os aplicativos clientes que foram conectados também devem ser reiniciados para poderem se conectar à nova camada de rede. **Nota:** esta opção também pode ser gerenciada programando usando o comando `SET DATABASE PARAMETER`. - - **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: +- **Usar XPath padrão:** oor padrão, essa opção está desmarcada para bancos de dados convertidos de uma versão 4D anterior à v18 R3 e marcada para bancos de dados criados com 4D v18 R3 e superior. A partir da v18 R3, a implementação do XPath no 4D foi modificada para ser mais compatível e suportar mais previsões. Consequentemente, as características não convencionais da anterior implementação já não funcionam. Estes incluem: - inicial "/" não é apenas o nó raiz - usar um / como primeiro caractere em uma expressão XPath não declara um caminho absoluto do nó raiz - não há nó atual implícito - o nó atual tem que ser incluído na expressão XPath @@ -19,12 +19,12 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m Although not standard, you might want to keep using these features so that your code continues to work as before -- in this case, just set the option *unchecked*. Por outro lado, se seu código não depender da implementação não padrão e se você quiser se beneficiar dos recursos estendidos do XPath em seus bancos de dados (como descrito no [`elemento DOM Find XML`](../commands-legacy/dom-find-xml-element.md) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. - - **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Use LF for end of line on macOS:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files with line feed (LF) as default end of line (EOL) character instead of CR (CRLF for xml SAX) on macOS in new projects. Se você deseja se beneficiar deste novo comportamento em projetos convertidos de versões anteriores da 4D, marque esta opção. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D v19 R2 (and 4D v19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. Nas versões anteriores, os arquivos texto eram gravados com um BOM por padrão. Selecione esta opção se quiser ativar o novo comportamento nos projetos convertidos. Consulte [`TEXT TO DOCUMENT`](../commands-legacy/text-to-document.md), [`Document to text`](../commands-legacy/document-to-text.md) e [XML SET OPTIONS](../commands-legacy/xml-set-options.md). - - **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). +- **Map NULL values to blank values unchecked by default a field creation**: For better compliance with ORDA specifications, in databases created with 4D v19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. Você pode aplicar esse comportamento padrão aos seus bancos de dados convertidos marcando esta opção (trabalhar com valores Null é recomendado, uma vez que são totalmente suportados por [ORDA](../ORDA/overview.md). - - **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). +- **Non-blocking printing**: Starting with 4D v20 R4, each process has its own printing settings (print options, current printer, etc.), thus allowing you to run multiple printing jobs simultaneously. Check this option if you want to benefit from this new implementation in your converted 4D projects or databases converted from binary mode to project mode. **When left unchecked**, the previous implementation is applied: the current 4D printing settings are applied globally, the printer is placed in "busy" mode when one printing job is running, you must call `CLOSE PRINTING JOB` for the printer to be available for the next print job (check previous 4D documentations for more information). - - **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file +- **Salvar cores da estrutura e coordenadas em um arquivo catalog_editor.json file**: começando com 4D v20 R5, alterações feitas no editor de estrutura sobre a aparência gráfica das tabelas e campos (cor, posição, ordem...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nueva arquitectura de archivos facilita la gestión de conflictos en aplicaciones VCS, ya que el archivo `catalog.4DCatalog` ahora contiene sólo cambios cruciales en la estructura de la base de datos. For compatibility reasons, this feature is not enabled by default in projects converted from previous 4D versions, you need to check this option. Cuando la función está habilitada, el archivo `catalog_editor.json` se crea en la primera modificación en el editor de estructuras. \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/database.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/database.md index c9b9a2923920be..2d804cab1e59de 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/database.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/database.md @@ -31,9 +31,9 @@ A localização atual desta pasta é exibida na área "Atual:". Você pode clica São oferecidos três opções de localização: - - **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. - - **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. - - **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. +- **Sistema**: cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta situada en la ubicación especificada por Windows y/o macOS. Você pode descobrir o local atual definido pelo seu sistema usando o comando 4D [`Temporary folder`](../commands-legacy/temporary-folder.md). Os arquivos são colocados em uma subpasta cujo nome consiste no nome do banco de dados e em um identificador exclusivo. +- **Carpeta de archivos de datos** (opción por defecto): cuando se selecciona esta opción, los archivos temporales 4D se crean en una carpeta llamada "archivos temporales" situada en el mismo nivel que el archivo de datos de la base de datos. +- **Definido por el usuario**: esta opción se utiliza para definir una ubicación personalizada. Se a opção local for modificada, será necessário reiniciar a base de dados para que a nova opção seja tida em conta. 4D verifica se a pasta selecionada pode ser acessada por gravação. Se não for esse o caso, o aplicativo tenta outras opções até que uma pasta válida seja encontrada. > This option is stored in the "extra properties" of the structure that is available when the structure definition is exported in XML (see [Exporting and importing structure definitions](https://doc.4d.com/4Dv20/4D/20.2/Exporting-and-importing-structure-definitions.300-6750295.en.html)). @@ -41,7 +41,7 @@ São oferecidos três opções de localização: > Se você alterar uma dessas opções, é preciso sair e reabrir o banco de dados para tornar a alteração eficaz. Quando a base de dados for reaberta, todos os índices da base de dados são automaticamente reindexados. - - **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en +- **Considere @ como comodín sólo cuando se encuentre al principio o al final de patrones de texto**: permite definir como se interpretará la arroba "@" cuando se utilice en una búsqueda o en una comparación de cadenas de caracteres, cuando se encuentre en Cuando esta opción no está marcada (valor por defecto), la arroba se utiliza como carácter comodín, es decir, sustituye a cualquier caracter (ver [Caracter comodín (@)](https://doc.4d.com/4Dv20/4D/20.2/Query-editor.300-6750279.en.html#463876)). Quando a opção estiver marcada, o sinal de arroba é considerado um caractere simples se estiver localizado em uma palavra. Essa configuração é especialmente útil quando se procura por endereços de e-mail, onde o sinal @ é usado internamente. Esta opção tem influência em pesquisas, ordenações, comparações de string, bem como em dados armazenados em tabelas e dados encontrados na memória, como arrays. Campos e variáveis do alfa (indexado ou não) e tipo de texto estão preocupados com a forma como o caractere @ é interpretado em pesquisas e tipos de caracteres. @@ -52,19 +52,19 @@ São oferecidos três opções de localização: - Esta opción también puede influir en el comportamiento de los comandos del tema [Objetos (Formularios)](../commands/theme/Objects_Forms.md) que aceptan el caracter comodín ("@") en el parámetro objeto. - Por razões de segurança, apenas o Administrador ou Designer da base de dados podem modificar este parâmetro. - - **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. +- **Lenguaje del archivo de datos actual:** permite configurar el lenguaje utilizado para el procesamiento y la comparación de cadenas de caracteres. A escolha do idioma influencia diretamente a classificação e a pesquisa de texto, bem como as letras maiúsculas e minúsculas, mas não afeta a tradução de textos nem os formatos de data, hora ou moeda, que permanecem no idioma do sistema. Por padrão, 4D usa a linguagem do sistema. Um projeto 4D pode, portanto, operar em uma linguagem diferente da do sistema. Quando um projeto for aberto, o mecanismo 4D detecta o idioma usado pelo arquivo de dados e o fornece ao idioma (modo interpretador ou compilado). As comparações de texto, independentemente de serem realizadas pelo mecanismo de projeto ou pelo idioma, são feitas no mesmo idioma. > Puede modificar esta configuración en las Preferencias de la aplicación (ver [Página general](../Preferences/general.md)). Neste caso, a configuração aplica-se a todas as novas bases de dados criadas pela 4D. - - **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. +- **Considerar sólo caracteres no alfanuméricos para las palabras claves**: modifica el algoritmo utilizado por 4D para identificar los separadores de palabras claves y crear así sus índices. Por padrão, quando esta opção não é verificada, a 4D usa um algoritmo sofisticado que leva em conta as características linguísticas. Este algoritmo é semelhante ao usado pelo software de processamento de palavras para determinar os limites ao selecionar uma palavra que é clicada duplo. Para más información sobre este algoritmo, consulte la siguiente dirección: `http://userguide.icu-project.org/boundaryanalysis`. Quando esta opção está selecionada, 4D utiliza um algoritmo simplificado. Nessa configuração, qualquer caractere não alfanumérico (ou seja, que não seja uma letra ou um número) é considerado um separador de palavras-chave. Essa configuração atende a requisitos específicos associados a determinados idiomas, como o japonês. - - **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. +- **Orden de clasificación apropiado para la búsqueda**: esta opción sólo aparece cuando se selecciona el idioma japonés. Modifica a interpretação de caracteres como a "Marca de som prolongado Katakana-Hiragana" ou "長音記号" ou as "Marcas de iteração japonesas" como "ゝ" ou "ゞ". Um falante típico de japonês provavelmente preferirá os resultados com a configuração ativada. #### Compatibilidade do MeCab (versão japonesa) @@ -82,7 +82,7 @@ Você usa as configurações nesta aba para configurar a memória em cache para ### Parâmetros da cache do banco de dados - - **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. +- **Cálculo de la caché adaptable**: cuando esta opción está marcada, la gestión de la memoria caché es realizada dinámicamente por el sistema, respetando los límites que defina. Isto permite a configuração de um cache de memória de alto desempenho adaptado à maioria das configurações. O tamanho do cache de memória é então calculado dinamicamente dependendo dos parâmetros definidos. Os valores oferecidos por defeito correspondem à utilização normal de 4D. - **Memoria a reservar para el sistema y las otras aplicaciones**: parte de la memoria RAM a reservar para el Sistema y las otras aplicaciones. Esse valor é aumentado para otimização quando outros aplicativos são executados na mesma máquina que a 4D. - **Percentage of available memory used for cache**: Percentage of the remaining memory allocated to the cache by default.\ @@ -98,11 +98,11 @@ Você usa as configurações nesta aba para configurar a memória em cache para ![](../assets/en/settings/memory-maximum-size.png) - - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). +- **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. O 4D então exibe uma área de entrada que permite a configuração do cache de memória para uso, bem como informações relacionadas à memória física (RAM disponíveis na máquina), o cache atual e o cache após reiniciar (levando suas alterações em conta). O tamanho do cache de memória que você inserir será reservado para o banco de dados 4D, independentemente do estado dos recursos da máquina. Esta configuração pode ser usada em certas configurações específicas, ou quando a base de dados é projetada para ser usada em sistemas diferentes em termos de memória. Geralmente, a cache adaptativa oferece um melhor desempenho. - - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. +- **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. 4D salva os dados colocados no cache em intervalos regulares. Você pode especificar qualquer intervalo de tempo entre 1 segundo e 500 minutos. Por padrão, 4D salva seus dados a cada 20 segundos. O aplicativo também salva seus dados em disco toda vez que você alterar para outro ambiente ou sair do aplicativo. También puede llamar al comando [FLUSH CACHE](../commands-legacy/flush-cache.md) para activar el vaciado en cualquier momento. Quando você antecipar uma entrada de dados pesada, considere definir um curto intervalo de tempo entre saves. Em caso de falha de poder, você só perderá os dados inseridos desde o salvamento anterior (se o banco de dados estiver sendo executado sem um arquivo de log). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md index 98a3fb3bb2f38d..d2a30f191995bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/interface.md @@ -23,9 +23,9 @@ A fonte padrão e seu tamanho dependem da plataforma onde 4D está sendo executa Outras opções configuram a exibição de várias janelas no modo Aplicativo. - - **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. +- **Pantalla de inicio**: cuando esta opción no está seleccionada, la [pantalla de inicio de la barra de menú actual](Menus/bars.md#splash-screen) no aparece en modo Aplicación. Cuando oculte esta ventana, le corresponderá gestionar la visualización de todas sus ventanas por programación, por ejemplo en el método base `On Startup`. - - **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. +- **Escritura de caché**: cuando esta opción está marcada, 4D muestra una ventana en la parte inferior izquierda de la pantalla mientras se vacían los datos de la caché. Como esta operação bloqueia temporariamente ações do usuário, exibindo esta janela permite que ele saiba que o movimento está em andamento. :::note @@ -33,9 +33,9 @@ Puede definir la [frecuencia de escritura de la caché](database.md#memory-page) ::: - - **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. +- **Progreso de la impresión**: permite, durante la impresión, activar o desactivar la visualización de la caja de diálogo de progreso de la impresión. - - **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: +- **Usar modo SDI en Windows**: cuando esta opción está marcada, 4D habilita automáticamente el [modo SDI (Single-Document Interface)](../Menus/sdi.md) en su aplicación cuando se ejecuta en un [contexto soportado](../Menus/sdi.md#sdi-mode-availability). Al seleccionar esta opción, en Windows el menú **Ejecutar** de la barra de menú de 4D le permite seleccionar el modo en el que desea probar la aplicación: ![](../assets/en/settings/sdi-mdi.png) @@ -53,18 +53,18 @@ Esse menu permite que você selecione o esquema de cores a ser usado no nível d Os seguintes esquemas estão disponíveis: - - **Light**: the application will use the Default Light Theme +- **Light**: the application will use the Default Light Theme ![](../assets/en/settings/light-appearance.png) - - **Escuro**: o aplicativo irá usar o Tema Escuro Padrão +- **Escuro**: o aplicativo irá usar o Tema Escuro Padrão ![](../assets/en/settings/dark-appearance.png) - - **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) +- **Heredado** (por defecto): la aplicación heredará el nivel de prioridad superior (es decir, las preferencias del usuario del sistema operativo) > Os temas predefinidos podem ser tratados com CSS. Para más información, consulte la sección [Media Queries](../FormEditor/createStylesheet.md#media-queries). O esquema de aplicação principal será aplicado aos formulários por defeito. No entanto, ele pode ser substituído: - - por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; - - utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". +- por el comando [SET APPLICATION COLOR SCHEME](../commands-legacy/set-application-color-scheme.md) a nivel de la sesión de trabajo; +- utilizando la propiedad de formulario [Color Scheme](../FormEditor/propertiesForm.html#color-scheme) en cada nivel de formulario (nivel de prioridad más alto). **Nota:** cuando se imprimen, los formularios utilizan siempre la paleta "Light". ## Atalhos @@ -72,9 +72,9 @@ Você usa a área de atalhos para visualizar e modificar atalhos padrão para tr Os atalhos predefinidos são os seguintes: - - Aceptación de formulario de entrada: **Entrada** - - Anulación de entrada: **Esc** - - Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) +- Aceptación de formulario de entrada: **Entrada** +- Anulación de entrada: **Esc** +- Añadir al subformulario: **Ctrl+Mayús+/** (Windows) o **Comando+Mayús+/** (macOS) Para cambiar el acceso directo de una operación, haga clic en el botón **Editar** correspondiente. Aparece a seguinte caixa de diálogo: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/security.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/security.md index 5dc652ca0b495d..eb49da34e62255 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/security.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/security.md @@ -11,7 +11,7 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa > Essas configurações não se aplicam às bases de dados do projeto abertas no modo de usuário único. - - **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. +- **Acceso Diseño y al Explorador de ejecución**: da al grupo especificado la capacidad de entrar al modo Diseño de la base y mostrar el Explorador de ejecución. Note que: @@ -19,21 +19,21 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - The Designer and Administrator always have access to the Design environment and Runtime Explorer, even if they are not explicitly part of the specified access group.For more information about users and user groups, refer to the [Users and groups](../Users/handling_users_groups.md) chapter. - - **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. +- **Usuario por defecto**: cuando se ha definido un Usuario por defecto, todos los usuarios que abren o se conectan a la base tienen los mismos privilegios y restricciones de acceso definidos para este Usuario por defecto. Já não é necessário introduzir um nome de usuário. Além disso, se você não tiver associado uma senha com o usuário padrão, a caixa de diálogo de senha não aparece mais e o banco de dados abre diretamente. Esta opção simplifica o acesso ao banco de dados, mantendo um sistema completo de controle de dados. - Se você associou uma senha ao usuário padrão, uma caixa de diálogo aparece quando o banco de dados está aberto e os usuários devem inserir uma senha. - If you haven't associated a password with the Default User, the User Identification dialog box will not appear.**Note:** You can "force" the display of the User Identification dialog box when the "Default User" mode is active, for instance in order to connect as Administrator or Designer. Para ello, presione la tecla **Mayús** mientras abre la base de datos o se conecta a ella. - - **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html +- **Mostrar lista de usuarios en la caja de diálogo Contraseña**: si se marca esta opción, los usuarios deben elegir su nombre en la lista de usuarios e introducir su contraseña en la caja de diálogo de identificación de usuario. Se essa opção não estiver marcada, os usuários deverão digitar o nome e a senha. Para obtener más información sobre las dos versiones de la caja de diálogo de contraseña, consulte la sección "Acceso a las bases protegidas" en [Presentación del control de acceso](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.en.html - **Ordenar la lista de los usuarios en orden alfabético** (sólo disponible si está marcada la opción anterior): cuando esta opción está seleccionada, la lista de los usuarios de la caja de diálogo de introducción de contraseña se ordena por orden alfabétic - - **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. +- **Los usuarios pueden cambiar su contraseña**: cuando esta opción está marcada, aparece un botón **Cambiar** en la caja de diálogo Identificación del usuario. This button lets the user access a dialog box that can be used to change their password (for more information about this dialog box, refer to the "Modification of password by user" in [Ensuring system maintenance](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.en.html)). Si lo desea, puede ocultar el botón **Cambiar** para que los usuarios no puedan modificar sus contraseñas. Para o fazer, basta desmarcar esta opção. ## Opções - - **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: +- **Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents**: For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands-legacy/st-insert-expression.md)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md) command can be used. Você pode remover completamente ou parcialmente esta filtragem usando as seguintes opções. - **Activado para todos** (opción por defecto): el acceso a los comandos, funciones y métodos proyecto está restringido para todos los usuarios, incluidos el Diseñador y el Administrador. - **Desactivado para el Diseñador y el Administrador**: esta opción concede acceso completo a los comandos 4D y a los métodos sólo al Diseñador y al Administrador. Ele pode ser usado para definir um modo de acesso ilimitado para comandos e métodos, enquanto permanece no controle das operações realizadas. Durante a fase de desenvolvimento, este modo pode ser usado para testar livremente todas as fórmulas, relatórios e assim por diante. Durante a operação, pode ser usado para configurar soluções seguras que permitam o acesso a comandos e métodos temporários. This consists in changing the user (via the [`CHANGE CURRENT USER`](../commands-legacy/change-current-user.md) command) before calling a dialog box or starting a printing process that requires full access to the commands, then returning to the original user when the specific operation is completed. @@ -41,9 +41,9 @@ Esta página contém opções relacionadas ao acesso e à proteção de dados pa - **Desactivado para todos**: esta opción desactiva el control en las fórmulas. Quando esta opção estiver marcada, os usuários terão acesso a todos os comandos 4D e plug-ins, bem como a todos os métodos do projeto (exceto para os invisíveis). **Nota:** esta opção tem prioridade sobre o comando [`SET ALLOWED METHODS`](../commands/set-allowed-methods.md). Quando está selecionado, este comando não faz nada. - - **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). +- **Autorizar las propiedades usuario**: debe marcar esta opción para poder mostrar cajas de diálogo separadas para las propiedades usuario. Cuando esta opción está marcada, hay disponibles hasta tres cuadros de diálogo: **Propiedades estructura**, **Propiedades usuario**, y **Propiedades usuario para archivo de datos**. Para mais informações, consulte [Parâmetros do usuário](../Desktop/user-settings.md). - - **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. +- **Execute "On Host Database Event" method of the components**: The [On Host Database Event database method](../commands-legacy/on-host-database-event-database-method.md) facilitates the initialization and backup phases for 4D components. Por razões de segurança, você deve autorizar explicitamente a execução deste método em cada banco de dados de host. Para o efeito, é necessário marcar esta opção. Por padrão, não está marcada. Quando esta opção está seleccionada: diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/web.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/web.md index c055e23b8f2766..74c4681da956be 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/web.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R9/settings/web.md @@ -82,9 +82,9 @@ Quando esta opção é selecionada, o servidor web não fornece nenhum suporte e Neste modo, pode configurar parâmetros do servidor Web adicionais: - - [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) - - [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) - - [Usar processos preemptivos](#use-preemptive-processes) +- [Máximo de Processos Web Concorrentes](#maximum-concurrent-web-processes) +- [Reutilização dos contextos temporários (4D em modo remoto)](#reuse-temporary-contexts) +- [Usar processos preemptivos](#use-preemptive-processes) #### Sessões herdadas (sessões de processo único) @@ -164,9 +164,9 @@ Inicia o detiene el registro de las peticiones recibidas por el servidor web 4D O menu de formato do histórico oferece as seguintes opções: - - **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. +- **Sem arquivo de registro**: Quando esta opção for selecionada, o 4D não irá gerar um arquivo de registro de requisições. - - **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ +- **CLF (Formato de Log Comum)**: Quando esta opção for selecionada, o log de pedidos é gerado no formato CLF Com o formato CLF, cada linha do arquivo representa uma solicitação, como:\ host rfc931 usuário [DD/MMM/AAAA:HH:MM:SS] "solicitação" estado tamanho\ Cada campo é separado por um espaço e cada linha termina com a sequência CR/LF (caractere 13, caractere 10). @@ -177,9 +177,9 @@ O menu de formato do histórico oferece as seguintes opções: > A data e a hora são locais para o servidor. - - petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) - - estado: resposta dada pelo servidor. - - length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. +- petição: petição enviada pelo cliente (por exemplo, GET /index.htm HTTP/1.0) +- estado: resposta dada pelo servidor. +- length: tamanho dos dados devolvidos (exceto o cabeçalho HTTP) ou 0. > **Nota:** Por razões de desempenho, as operações são salvas em um buffer de memória em pacotes de 1Kb antes de serem escritas em disco. As operações também são gravadas no disco se nenhuma solicitação tiver sido enviada a cada 5 segundos. > Os valores possíveis de estado são os seguintes: @@ -193,16 +193,16 @@ O menu de formato do histórico oferece as seguintes opções: > 500: Internal error > O formato CLF não pode ser personalizado. - - **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. +- **DLF (Combined Log Format)**: Quando esta opção é selecionada, o registro de solicitações é gerado no formato DLF. O formato DLF é semelhante ao formato CLF e usa a mesma estrutura. Simplesmente adiciona dois campos HTTP adicionais no final de cada solicitação: Referer e User-agent. - Referer: contém o URL da página que aponta para o documento solicitado. - User-agent: contém o nome e a versão do navegador ou software cliente que origina a solicitação. > O formato DLF não pode ser personalizado. - - **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. +- **ELF (Extended Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato ELF. O formato ELF está muito difundido no mundo dos navegadores HTTP. Ele pode ser usado para criar registros sofisticados que atendam a necessidades específicas. Por esse motivo, o formato ELF pode ser personalizado: é possível escolher os campos a serem registrados, bem como sua ordem de inserção no arquivo. - - **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. +- **WLF (WebStar Log Format)**: Quando essa opção é selecionada, o registro da solicitação é gerado no formato WLF. O formato WLF foi desenvolvido especificamente para o servidor 4D WebSTAR. Ele é semelhante ao formato ELF, com apenas alguns campos adicionais. Tal como o formato ELF, pode ser personalizado. **Configuração dos campos** Quando você escolhe o formato ELF (Extended Log Format) ou WLF (WebStar Log Format), a área "Weg Log Token Selection" exibe os campos disponíveis para o formato escolhido. Você precisará selecionar cada campo a ser incluído no registro. You will need to select each field to be included in the log. To do so, check the desired fields. @@ -242,14 +242,14 @@ A tabela a seguir lista os campos disponíveis para cada formato (em ordem alfab Configure the automatic backup parameters for the request log. Configure the automatic backup parameters for the request log. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. First you must choose the frequency (days, weeks, etc.) or the file size limit criterion by clicking on the corresponding radio button. Você deve então especificar o momento exato do backup, se necessário. - - **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. - - **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. +- **Sin copia de seguridad**: la función de copia de seguridad programada está desactivada. +- **Cada X hora(s)**: esta opción se utiliza para programar las copias de seguridad con una base horaria. Pode digitar um valor entre 1 e 24. - **a partir de**: permite definir la hora de activación de la primera copia de seguridad. - - **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. - - **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. - - **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. - - **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. +- **Cada X día(s) a las X**: esta opción se utiliza para programar las copias de seguridad con una base diaria. Introduza 1 se pretender efetuar uma cópia de segurança diária. Quando essa opção estiver marcada, você deve indicar a hora em que o backup deve ser iniciado. +- **Cada X semana(s), día a las X**: esta opción se utiliza para programar las copias de seguridad con una base semanal. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Digite 1 se quiser realizar o backup 1 vez por semana. Você pode selecionar vários dias da semana, se desejar. +- **Cada X mes(es), el día X a las X**: esta opción se utiliza para programar las copias de seguridad con una base mensual. Digite 1 se quiser realizar uma cópia de segurança mensal. Quando essa opção estiver marcada, você deve indicar o dia do mês e a hora em que o backup deve ser iniciado. +- **Todos los X MB**: esta opción se utiliza para programar las copias de seguridad en función del tamaño del archivo de registro actual. Um backup é automaticamente acionado quando o arquivo atinge o tamanho definido. Você pode definir um limite de tamanho de 1, 10, 100 ou 1000 MB. > No caso de backups programados, se o servidor Web não foi iniciado quando o backup estava programado para ocorrer, na próxima inicialização o 4D considera o backup como falho e aplica as configurações apropriadas, definidas nas Propriedades. @@ -263,9 +263,9 @@ Para obter mais informações sobre o suporte de serviços da Web em 4D, consult Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" de serviços da Web, ou seja, a publicação de métodos projeto na forma de serviços Web. - - **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. - - **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. - - **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. +- **Autorizar peticiones de servicios web**: Esta opção permite que você inicialize a publicação de Serviços Web. Se essa opção não tiver sido marcada, o 4D recusará solicitações SOAP e não gerará um WSDL, mesmo que os métodos tenham o atributo *Published in WSDL*. Quando essa opção está marcada, 4D cria o arquivo WSDL. +- **Nome do Serviço Web**: Esta área permite que você altere o "nome genérico" do Serviço Web. Esse nome é usado para diferenciar os serviços no nível do servidor SOAP (quando o servidor publica vários serviços Web diferentes), bem como nos diretórios de serviços Web. Por padrão, 4D usa o nome A_WebService. +- **Namespace de Serviços Web**: Essa área é usada para alterar o namespace dos serviços da Web publicados por 4D. Cada serviço Web publicado na Internet deve ser único. A singularidade dos nomes dos Serviços Web é assegurada pelo uso de namespaces XML. Um namespace é uma cadeia de caracteres arbitrária usada para identificar um conjunto de tags XML de forma exclusiva. Normalmente, o namespace começa com a URL da empresa (http://mycompany.com/mynamespace). Nesse caso, não é indispensável ter algo em particular no URL indicado; o que importa é que a cadeia de caracteres usada seja exclusiva. Por padrão, o 4D usa o seguinte namespace: http://www.4d.com/namespace/default. > Em conformidade com o padrão XML para nomes de etiquetas, as cadeias de caracteres usadas não devem conter espaços nem começar com um número. Além disso, para evitar qualquer risco de incompatibilidade, recomendamos que você não use nenhum caractere estendido (como caracteres acentuados). @@ -273,7 +273,7 @@ Essa área contém várias opções relacionadas ao uso de 4D como um "servidor" Essa área contém várias opções relacionadas ao uso de 4D como um "cliente" de serviços Web, ou seja, a assinatura de serviços publicados na rede. - - **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". +- **Prefixo do Método do Wizard**: Esta área permite que você altere o prefixo que é adicionado automaticamente por 4D ao nome dos métodos proxy gerados pelo Assistente de Serviços Web. Os métodos do projeto de proxy formam um link entre a aplicação 4D e o servidor de Serviços Web. Por padrão, 4D usa o prefixo "proxy_". ## Funcionalidades Web @@ -307,9 +307,9 @@ Esse botão só está disponível em projetos abertos com a aplicação 4D (usu O botão aciona a seguinte sequência de atualização: - - O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. - - O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). - - Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. +- O grupo de usuários da API REST definido no menu **Leitura/Escrita** é removido. +- O método de banco de dados `On REST Authentication` é excluído (movido para a lixeira do sistema). +- Um arquivo padrão ["roles.json"](../ORDA/privileges.md#rolesjson-file) é criado na pasta [Sources](../Project/architecture.md#sources) do projeto, caso ainda não exista, com seu atributo `forceLogin` como `True`. Lembre-se de reiniciar seu projeto após realizar essa atualização.