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 83d77c51dfe529..5e9cb6b7c1147b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -71,8 +71,8 @@ Puede añadir o modificar formularios 4D utilizando los siguientes elementos: Forms are called using specific commands of the 4D Language. In your 4D desktop applications, forms can be used in various ways, depending on their status within your interface needs. A form can be: - used in its own window for data viewing, processing, editing, or to display on-screen information to the user, -- used as template for printing, - used embedded in another form (subform), +- used as template for printing, - or called by specific features like the Label editor. ### Using a project form in a window @@ -147,6 +147,10 @@ In the same way that you pass an object to a form with the [`DIALOG`](../command ### Using forms to be printed +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +#### Ejemplos + You can use forms to print data, either as page or as list. - To simply print some part of a form, use the [`Print form`](../commands/print-form) command. Por ejemplo: @@ -184,6 +188,43 @@ var $h:=Print form("Request_var";$formData;Form detail) CLOSE PRINTING JOB ``` +#### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Entrada de blog relacionada + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +#### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitación + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ### Other form usages There are several other ways to use forms in the 4D applications, including: @@ -204,7 +245,7 @@ Normalmente, se selecciona la categoría del formulario al crearlo, pero se pued ## Páginas formulario -Cada formulario consta de al menos dos páginas: +Each form is made of at least two pages: - 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. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md index a74cf0f941c532..61cb60fc73f183 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md @@ -7,7 +7,7 @@ title: Imprimir Permite definir los parámetros de impresión específicos para el formulario. Esta funcionalidad es útil para ver los límites de páginas de impresión en el editor de formularios. -> **Compatibilidad:** aunque estos parámetros se tengan en cuenta cuando se imprime el formulario en modo Aplicación, se desaconseja confiar en esta funcionalidad para almacenar los parámetros de impresión del formulario, debido a las limitaciones relativas Es muy recomendable utilizar los comandos 4D `Print settings to BLOB`/`BLOB to print settings` que son más poderosos. +> **Compatibilidad:** aunque estos parámetros se tengan en cuenta cuando se imprime el formulario en modo Aplicación, se desaconseja confiar en esta funcionalidad para almacenar los parámetros de impresión del formulario, debido a las limitaciones relativas It is highly recommended to use the 4D commands [`Print settings to BLOB`](../commands/print-settings-to-blob)/[`BLOB to print settings`](../commands/blob-to-print-settings) which are more powerful. Puede modificar los siguientes parámetros de impresión: 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 5947c6998f1ab7..f11024ef3c872e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -18,6 +18,7 @@ Lea [**Novedades en 4D 21 R3**](https://blog.4d.com/es/whats-new-in-4d-21-r3/), - New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. - 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). - Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=21_R3): lista de todos los bugs que se han corregido en 4D 21 R3. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png new file mode 100644 index 00000000000000..7cbec84055b1d3 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png new file mode 100644 index 00000000000000..d78a6f5f3c1a48 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png new file mode 100644 index 00000000000000..95e6603575d8a3 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png new file mode 100644 index 00000000000000..5b09f52d9fa16c Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png differ 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 21dc3c4ba00c72..a7655ac309725a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -5,10 +5,14 @@ title: Página de compatibilidad La página Compatibilidad agrupa los parámetros relacionados con el mantenimiento de la compatibilidad con versiones anteriores de 4D. -> 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**. +:::note -- **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 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. +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. 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**. + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 @@ -16,12 +20,14 @@ 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/dom-find-xml-element)), 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). + +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). -- \*\*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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. 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). +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) 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. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md index 403237a756ee57..5c7d6e67a9bc26 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md @@ -66,6 +66,47 @@ Puede añadir o modificar formularios 4D utilizando los siguientes elementos: } ``` +## Printing forms + +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Entrada de blog relacionada + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitación + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ## Formulario proyecto y formulario tabla Hay dos categorías de formularios: @@ -78,7 +119,7 @@ Normalmente, se selecciona la categoría del formulario al crearlo, pero se pued ## Páginas formulario -Cada formulario consta de al menos dos páginas: +Each form is made of at least two pages: - 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. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md index 4edef371468b67..f11024ef3c872e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md @@ -5,7 +5,7 @@ title: Notas del lanzamiento ## 4D 21 R3 -Lea [**Novedades en 4D 21 R3**](https://blog.4d.com/whats-new-in-4d-21-r3/), la entrada del blog que muestra todas las nuevas funcionalidades y mejoras en 4D 21 R3. +Lea [**Novedades en 4D 21 R3**](https://blog.4d.com/es/whats-new-in-4d-21-r3/), la entrada del blog que muestra todas las nuevas funcionalidades y mejoras en 4D 21 R3. #### Lo más destacado @@ -18,6 +18,7 @@ Lea [**Novedades en 4D 21 R3**](https://blog.4d.com/whats-new-in-4d-21-r3/), la - New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. - 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). - Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). - [**Lista de bugs corregidos**](https://bugs.4d.fr/fixedbugslist?version=21_R3): lista de todos los bugs que se han corregido en 4D 21 R3. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md index 21dc3c4ba00c72..a7655ac309725a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md @@ -5,10 +5,14 @@ title: Página de compatibilidad La página Compatibilidad agrupa los parámetros relacionados con el mantenimiento de la compatibilidad con versiones anteriores de 4D. -> 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**. +:::note -- **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 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. +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. 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**. + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 @@ -16,12 +20,14 @@ 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/dom-find-xml-element)), 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). + +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). -- \*\*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/text-to-document), [`Document to text`](../commands/document-to-text), y [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. 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). +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) 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. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file 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 505d4aee180621..d524d3381d481f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -71,8 +71,8 @@ Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suiv Forms are called using specific commands of the 4D Language. In your 4D desktop applications, forms can be used in various ways, depending on their status within your interface needs. A form can be: - used in its own window for data viewing, processing, editing, or to display on-screen information to the user, -- used as template for printing, - used embedded in another form (subform), +- used as template for printing, - or called by specific features like the Label editor. ### Using a project form in a window @@ -147,6 +147,10 @@ In the same way that you pass an object to a form with the [`DIALOG`](../command ### Using forms to be printed +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +#### Exemples + You can use forms to print data, either as page or as list. - To simply print some part of a form, use the [`Print form`](../commands/print-form) command. Par exemple : @@ -184,6 +188,43 @@ var $h:=Print form("Request_var";$formData;Form detail) CLOSE PRINTING JOB ``` +#### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Article(s) de blog sur le sujet + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +#### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitation + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ### Other form usages There are several other ways to use forms in the 4D applications, including: @@ -204,7 +245,7 @@ En règle générale, vous sélectionnez la catégorie de formulaire lorsque vou ## Pages formulaire -Chaque formulaire est composé d'au moins deux pages : +Each form is made of at least two 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. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md index 47e1bb442101f2..bfeaf3678c7ca6 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md @@ -7,7 +7,7 @@ title: Impression Permet de définir des paramètres d'impression spécifiques pour le formulaire. Cette fonctionnalité est utile pour afficher les limites de pages d'impression dans l'éditeur de formulaire. -> **Compatibilité** : Même si ces paramètres sont pris en compte lors de l'impression du formulaire en mode Application, il est déconseillé de s'appuyer sur cette fonctionnalité pour stocker les paramètres d'impression du formulaire, en raison des limitatio It is highly recommended to use the 4D commands `Print settings to BLOB`/`BLOB to print settings` which are more powerful. Propriétés +> **Compatibilité** : Même si ces paramètres sont pris en compte lors de l'impression du formulaire en mode Application, il est déconseillé de s'appuyer sur cette fonctionnalité pour stocker les paramètres d'impression du formulaire, en raison des limitatio It is highly recommended to use the 4D commands `Print settings to BLOB`/`BLOB to print settings` which are more powerful. It is highly recommended to use the 4D commands [`Print settings to BLOB`](../commands/print-settings-to-blob)/[`BLOB to print settings`](../commands/blob-to-print-settings) which are more powerful. Vous pouvez modifier les paramètres d'impression suivants : 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 8ddf67afc744d5..4c4ed9c8ca9ba5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -18,6 +18,7 @@ Lisez [**Les nouveautés de 4D 21 R3**](https://blog.4d.com/fr/whats-new-in-4d-2 - Nouvelle [page **IA**](../settings/ai.md) dans la boîte de dialogue des Propriétés, permettant de configurer des [alias de fournisseurs et de modèles](../aikit/provider-model-aliases.md) qui peuvent être appelés dans le code via le composant 4D AIKit. - Composant 4D AIKit : nouvelle classe [Providers](../aikit/Classes/OpenAIProviders.md) pour instancier et gérer les [alias de fournisseurs et de modèles](../aikit/provider-model-aliases.md). - Prise en charge du [mot-clé `server`](../Concepts/classes.md#server) pour les fonctions du modèle de données ORDA et les fonctions singleton partagées/session. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dépendances : prise en charge des [composants stockés sur les dépôts GitLab](../Project/components.md#configuring-a-gitlab-repository). - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=21_R3) : liste de tous les bugs qui ont été corrigés dans 4D 21 R3. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAI.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAI.md index 28c927f4594f94..5ebf2ed6230474 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAI.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAI.md @@ -78,6 +78,6 @@ $client.files.create(...) $client.model.lists(...) ``` -## Provider Model Aliases +## Alias de modèles de fournisseurs -The OpenAI client supports provider model aliases for easy multi-provider usage. See [Provider Model Aliases](../provider-model-aliases.md) for complete documentation. +Le client OpenAI prend en charge les alias de modèles de fournisseurs pour faciliter l'utilisation de plusieurs fournisseurs. Voir [Alias de modèles de fournisseurs](../provider-model-aliases.md) pour une documentation complète. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md index c61ea26f7df83e..aa38bf8293f03b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md @@ -13,20 +13,20 @@ La classe `OpenAIChatCompletionParameters` permet de gérer les paramètres requ ## Propriétés -| Propriété | Type | Valeur par défaut | Description | -| ----------------------- | ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | `"gpt-4o-mini"` | ID du modèle à utiliser. Supports [provider:model aliases](../provider-model-aliases.md) for multi-provider usage (e.g., `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`). | -| `stream` | Boolean | `False` | Indique si la progression partielle doit être retransmise en continu. Si cette option est activée, les tokens seront envoyés sous forme de données uniquement. Une formule de rappel est requise. | -| `stream_options` | Object | `Null` | Propriété pour stream=True. Par exemple : `{include_usage: True}` | -| `max_completion_tokens` | Integer | `0` | Le nombre maximum de tokens qui peuvent être générés dans la réponse. | -| `n` | Integer | `1` | Nombre de réponses à générer pour chaque invite (prompt). | -| `temperature` | Real | `-1` | Température d'échantillonnage à utiliser, entre 0 et 2. Les valeurs élevées rendent la sortie plus aléatoire, tandis que des valeurs faibles la rendent plus ciblée et déterministe. | -| `store` | Boolean | `False` | Stocker ou non le résultat de cette requête de génération de réponse conversationnelle. | -| `reasoning_effort` | Text | `Null` | Contraintes sur l'effort de raisonnement pour les modèles de raisonnement. Les valeurs actuellement prises en charge sont "low", "medium" et "high". | -| `response_format` | Object | `Null` | Un objet spécifiant le format que le modèle doit produire. Compatible avec les sorties structurées. | -| `tools` | Collection | `Null` | Une liste d'outils ([OpenAITool](OpenAITool.md)) que le modèle peut appeler. Seul le type "function" est pris en charge. | -| `tool_choice` | Variant | `Null` | Contrôle l'outil (le cas échéant) qui est appelé par le modèle. Peut être `"none"`, `"auto"`, `"required"`, ou spécifier un outil particulier. | -| `prediction` | Object | `Null` | Contenu de sortie statique, tel que le contenu d'un fichier texte en cours de régénération. | +| Propriété | Type | Valeur par défaut | Description | +| ----------------------- | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | `"gpt-4o-mini"` | ID du modèle à utiliser. Prend en charge [provider:model aliases](../provider-model-aliases.md) pour une utilisation multi-fournisseurs (par exemple, `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`). | +| `stream` | Boolean | `False` | Indique si la progression partielle doit être retransmise en continu. Si cette option est activée, les tokens seront envoyés sous forme de données uniquement. Une formule de rappel est requise. | +| `stream_options` | Object | `Null` | Propriété pour stream=True. Par exemple : `{include_usage: True}` | +| `max_completion_tokens` | Integer | `0` | Le nombre maximum de tokens qui peuvent être générés dans la réponse. | +| `n` | Integer | `1` | Nombre de réponses à générer pour chaque invite (prompt). | +| `temperature` | Real | `-1` | Température d'échantillonnage à utiliser, entre 0 et 2. Les valeurs élevées rendent la sortie plus aléatoire, tandis que des valeurs faibles la rendent plus ciblée et déterministe. | +| `store` | Boolean | `False` | Stocker ou non le résultat de cette requête de génération de réponse conversationnelle. | +| `reasoning_effort` | Text | `Null` | Contraintes sur l'effort de raisonnement pour les modèles de raisonnement. Les valeurs actuellement prises en charge sont "low", "medium" et "high". | +| `response_format` | Object | `Null` | Un objet spécifiant le format que le modèle doit produire. Compatible avec les sorties structurées. | +| `tools` | Collection | `Null` | Une liste d'outils ([OpenAITool](OpenAITool.md)) que le modèle peut appeler. Seul le type "function" est pris en charge. | +| `tool_choice` | Variant | `Null` | Contrôle l'outil (le cas échéant) qui est appelé par le modèle. Peut être `"none"`, `"auto"`, `"required"`, ou spécifier un outil particulier. | +| `prediction` | Object | `Null` | Contenu de sortie statique, tel que le contenu d'un fichier texte en cours de régénération. | ### Propriétés du callback asynchrone diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md index 26abe440b712ed..bdc18b5514dd9e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIEmbeddingsAPI.md @@ -17,12 +17,12 @@ https://platform.openai.com/docs/api-reference/embeddings Crée une représentation vectorielle pour l'entrée, le modèle et les paramètres fournis. -| Paramètre | Type | Description | -| ------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| *input* | Text ou Collection de textes | L'entrée à vectoriser. | -| *model* | Text | Le [modèle à utiliser](https://platform.openai.com/docs/guides/embeddings#embedding-models). Supports [provider:model aliases](../provider-model-aliases.md). | -| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | Les paramètres permettant de personnaliser la requête de représentations vectorielles. | -| Résultat | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | Les représentations vectorielles | +| Paramètre | Type | Description | +| ------------ | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| *input* | Text ou Collection de textes | L'entrée à vectoriser. | +| *model* | Text | Le [modèle à utiliser](https://platform.openai.com/docs/guides/embeddings#embedding-models). Prend en charge [provider:model aliases](../provider-model-aliases.md). | +| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | Les paramètres permettant de personnaliser la requête de représentations vectorielles. | +| Résultat | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | Les représentations vectorielles | #### Exemples d'utilisation diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md index 68a2dc88e3dce5..c41bd344be9853 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md @@ -13,13 +13,13 @@ La classe `OpenAIImageParameters` permet de configurer et gérer les paramètres ## Propriétés -| Nom de propriété | Type | Valeur par défaut | Description | -| ----------------- | ------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | "dall-e-2" | Spécifie le modèle à utiliser pour la génération d'images. Supports [provider:model aliases](../provider-model-aliases.md). | -| `n` | Integer | 1 | Le nombre d'images à générer (doit être compris entre 1 et 10 ; seul `n=1` est supporté pour `dall-e-3`). | -| `size` | Text | "1024x1024" | La taille des images générées. Doit être conforme aux spécifications du modèle. | -| `style` | Text | "" | Le style des images générées (doit être soit `vivid` soit `natural`). | -| `response_format` | Text | "url" | Le format des images retournées. Doit être `url` ou `b64_json`. | +| Nom de propriété | Type | Valeur par défaut | Description | +| ----------------- | ------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | "dall-e-2" | Spécifie le modèle à utiliser pour la génération d'images. Prend en charge [provider:model aliases](../provider-model-aliases.md). | +| `n` | Integer | 1 | Le nombre d'images à générer (doit être compris entre 1 et 10 ; seul `n=1` est supporté pour `dall-e-3`). | +| `size` | Text | "1024x1024" | La taille des images générées. Doit être conforme aux spécifications du modèle. | +| `style` | Text | "" | Le style des images générées (doit être soit `vivid` soit `natural`). | +| `response_format` | Text | "url" | Le format des images retournées. Doit être `url` ou `b64_json`. | ## Voir également diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIProviders.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIProviders.md index 4e714401f5c59c..382936177ed516 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIProviders.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIProviders.md @@ -7,20 +7,20 @@ title: OpenAIProviders ## Sommaire -The `OpenAIProviders` class manages AI provider configurations by loading configuration and handling resolution of model strings in the `provider:model` format. +La classe `OpenAIProviders` gère les configurations de fournisseurs d'IA en chargeant la configuration et en gérant la résolution des chaînes de modèles au format `provider:model`. -For complete usage documentation, see [Provider Model Aliases](../provider-model-aliases.md). +Pour une documentation complète sur son utilisation, voir [Alias de modèles de fournisseurs](../provider-model-aliases.md). ## Description -This class enables multi-provider support by: +Cette classe permet la prise en charge de plusieurs fournisseurs via : -- Loading provider configurations from a single JSON file -- Loading named model aliases that map to providers and model IDs -- Resolving `provider:model` syntax to full API configurations -- Resolving named model aliases by bare name to full provider + model configurations +- le chargement des configurations de fournisseurs à partir d'un seul fichier JSON +- le chargement des alias de modèles nommés correspondant à des fournisseurs et à des identifiants de modèles +- la résolution de la syntaxe `provider:model` en configuration complète de l'API +- la résolution des alias de modèles nommés depuis un nom simple en nom du fournisseur complet + les configurations du modèle -The `OpenAI` class automatically loads provider configurations when instantiated. +La classe `OpenAI` charge automatiquement les configurations des fournisseurs lors de son instanciation. ## Constructeur @@ -28,38 +28,38 @@ The `OpenAI` class automatically loads provider configurations when instantiated var $providers := cs.AIKit.OpenAIProviders.new() ``` -Creates a new instance that loads provider configuration from the `AIProviders.json` file (see [**Configuration Files**](../provider-model-aliases.md#configuration-files) in the "Provider Model Aliases" page for details on file locations and format). +Crée une nouvelle instance qui charge la configuration du fournisseur à partir du fichier `AIProviders.json` (voir [**Fichiers de configuration**](../provider-model-aliases.md#configuration-files) dans la page "Alias de fournisseurs de modèles" pour plus de détails sur l'emplacement et le format des fichiers). **Important:** -- Only the first existing file is loaded. There is no merging of multiple files. -- The configuration is read once at instantiation time. If the `AIProviders.json` file is modified afterward, those changes will not be reflected in the existing instance. You must create a new instance of `OpenAIProviders` to reload the updated configuration. +- Seul le premier fichier existant est chargé. Il n'y a pas de fusion de plusieurs fichiers. +- La configuration est lue une fois au moment de l'instanciation. Si le fichier `AIProviders.json` est modifié par la suite, ces changements ne seront pas reflétés dans l'instance existante. Vous devez créer une nouvelle instance de `OpenAIProviders` pour recharger la configuration mise à jour. ## Utilisation -### Integration with OpenAI Class +### Intégration avec la classe OpenAI ```4d var $client := cs.AIKit.OpenAI.new() -// Use model aliases with provider:model syntax +// Utilisation d'alias de modèles avec syntaxe provider:model var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) var $result := $client.chat.completions.create($messages; {model: "local:llama3"}) ``` -### Direct Provider Access +### Accès direct aux fournisseurs ```4d var $providers := cs.AIKit.OpenAIProviders.new() -// Get a specific provider configuration +// Obtenir une configuration de fournisseur spécifique var $config := $providers.get("openai") -// Returns: {baseURL: "...", apiKey: "...", modelAliases: [...], ...} or Null +// Renvoie : {baseURL : "...", apiKey : "...", modelAliases : [...], ...} ou Null -// Get all provider names +// Obtenir tous les noms de fournisseurs var $names := $providers.list() -// Returns: ["openai", "anthropic", "mistral", "local"] +// Renvoie : ["openai", "anthropic", "mistral", "local"] ``` ## Fonctions @@ -68,21 +68,21 @@ var $names := $providers.list() **get**(*name* : Text) : Object -Get a provider configuration by name. +Obtenir la configuration d'un fournisseur par son nom. -| Paramètres | Type | Description | -| ---------- | ------ | ----------------------------------------------------- | -| *name* | Text | The provider name | -| Résultat | Object | Provider configuration object, or `Null` if not found | +| Paramètres | Type | Description | +| ---------- | ------ | ---------------------------------------------------------------------- | +| *name* | Text | Le nom du fournisseur | +| Résultat | Object | Objet de configuration du fournisseur, ou `Null` s'il n'est pas trouvé | #### Exemple ```4d var $config := $providers.get("openai") If ($config # Null) - // Use $config.baseURL, $config.apiKey, etc. + // Utiliser $config.baseURL, $config.apiKey, etc. - // We could build a client with it + // Nous pourrions construire un client avec var $client:=cs.AIKit.OpenAI.new($config) End if ``` @@ -91,17 +91,17 @@ End if **list**() : Collection -Get all provider names. +Obtenir les noms de tous les fournisseurs. -| Paramètres | Type | Description | -| ---------- | ---------- | ---------------------------- | -| Résultat | Collection | Collection of provider names | +| Paramètres | Type | Description | +| ---------- | ---------- | ---------------------------------- | +| Résultat | Collection | Collection de noms de fournisseurs | #### Exemple ```4d var $names := $providers.list() -// Returns: ["openai", "anthropic", ...] +// Retourne : ["openai", "anthropic", ...] For each ($name; $names) var $config := $providers.get($name) @@ -112,75 +112,75 @@ End for each **modelAliases**() : Collection -Get all configured model aliases. +Récupère tous les alias de modèle configurés. -| Paramètres | Type | Description | -| ---------- | ---------- | --------------------------------- | -| Résultat | Collection | Collection of model alias objects | +| Paramètres | Type | Description | +| ---------- | ---------- | -------------------------------------- | +| Résultat | Collection | Collection d'objets d'alias de modèles | -Each object in the collection contains: +Chaque objet de la collection contient : -| Propriété | Type | Description | -| ------------- | ---- | --------------------------------- | -| `name` | Text | Model alias name | -| `fournisseur` | Text | Provider name | -| `model` | Text | Model ID to use with the provider | +| Propriété | Type | Description | +| ---------- | ---- | ------------------------------------------- | +| `name` | Text | Nom de l'alias du modèle | +| `provider` | Text | Nom du fournisseur | +| `model` | Text | ID du modèle à utiliser avec le fournisseur | #### Exemple ```4d var $models := $providers.modelAliases() -// Returns: [{name: "my-gpt", provider: "openai", model: "gpt-5.1"}, ...] +// Renvoie : [{name: "my-gpt", provider: "openai", model: "gpt-5.1"}, ...] For each ($model; $models) // $m.name, $m.provider, $m.model End for each ``` -## Model Resolution +## Résolution du modèle -Two syntaxes are supported for model resolution: +Deux syntaxes sont prises en charge pour la résolution des modèles : -### Provider alias (`provider:model`) +### Alias de fournisseur (`provider:model`) -Specify the provider and model name directly: +Spécifie directement le nom du fournisseur et du modèle : ```4d var $client := cs.AIKit.OpenAI.new() $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) ``` -This is resolved internally to: +Résolution en interne : -1. Split `"openai:gpt-5.1"` into provider=`"openai"` and model=`"gpt-5.1"` -2. Look up the `"openai"` provider configuration -3. Extract `baseURL` and `apiKey` -4. Make the API request using the resolved configuration +1. Séparation `"openai:gpt-5.1"` en provider=`"openai"` et model=`"gpt-5.1"` +2. Recherche de la configuration du fournisseur `"openai"` +3. Extraction de `baseURL` et `apiKey` +4. Requête API effectuée en utilisant la configuration résolue **Exemples :** -- `"openai:gpt-5.1"` → Use OpenAI provider with gpt-5.1 model -- `"anthropic:claude-3-opus"` → Use Anthropic provider with claude-3-opus -- `"local:llama3"` → Use local provider with llama3 model +- `"openai:gpt-5.1"` → Utiliser le fournisseur OpenAI avec le modèle gpt-5.1 +- `"anthropic:claude-3-opus"` → Utiliser le fournisseur Anthropic avec claude-3-opus +- `"local:llama3"` → Utiliser un fournisseur local avec le modèle llama3 -### Model alias (bare name) +### Alias de modèle (nom simple) -Use a named model by its bare name from the `models` section of the configuration: +Utilise un modèle déclaré par son nom simple dans la section `models` de la configuration : ```4d var $client := cs.AIKit.OpenAI.new() $client.chat.completions.create($messages; {model: ":my-gpt"}) ``` -This is resolved internally to: +Résolution en interne : -1. Look up `"my-gpt"` in the `models` configuration -2. Find its `provider` (e.g., `"openai"`) and `model` (e.g., `"gpt-5.1"`) -3. Resolve the provider to get `baseURL` and `apiKey` -4. Make the API request using the resolved configuration +1. Recherche de `"my-gpt"` dans la configuration `models` +2. Récupération de son `provider` (par exemple, `"openai"`) et de son `model` (par exemple, `"gpt-5.1"`) +3. Résolution du fournisseur pour obtenir `baseURL` et `apiKey` +4. Requête API effectuée en utilisant la configuration résolue **Exemples :** -- `"my-gpt"` → Use the model alias "my-gpt" (resolves to its configured provider and model) -- `"my-embedding"` → Use the model alias "my-embedding" for embedding operations +- `"my-gpt"` → Utiliser l'alias de modèle "my-gpt" (résolu par le fournisseur et le modèle configurés) +- `"my-embedding"` → Utiliser l'alias de modèle "my-embedding" pour les opérations d'embedding diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/provider-model-aliases.md b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/provider-model-aliases.md index 15dc100e3b12ba..0cecf0aec7697a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/aikit/provider-model-aliases.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/aikit/provider-model-aliases.md @@ -1,35 +1,35 @@ --- id: provider-model-aliases -title: Provider & Model Aliases +title: Alias de fournisseurs et de modèles --- -# Provider & Model Aliases +# Alias de fournisseurs et de modèles -The OpenAI client supports provider and model aliases, allowing you to define provider configurations and named model aliases in JSON files and reference them using simple syntaxes. +Le client OpenAI prend en charge les alias de fournisseurs et de modèles, ce qui vous permet de définir des configurations de fournisseurs et des alias de modèles nommés dans des fichiers JSON et de les référencer à l'aide de syntaxes simples. ## Vue d’ensemble -Instead of hard-coding API endpoints and credentials in your code, you can: +Au lieu de coder en dur les points de terminaison et les identifiants de l'API dans votre code, vous pouvez : -- Define provider configurations in a JSON file -- Use the `provider:model` syntax to specify a provider and model directly -- Define named model aliases that map to a provider and a model ID -- Use a named model alias by bare name (e.g., `my-gpt`) -- Switch between providers (OpenAI, Anthropic, local Ollama, etc.) easily +- Définir les configurations des fournisseurs dans un fichier JSON +- Utiliser la syntaxe `provider:model` pour spécifier directement un fournisseur et un modèle +- Définir des alias de modèles nommés qui correspondent à un fournisseur et à un identifiant de modèle +- Utiliser l'alias d'un modèle nommé par son simple nom (par exemple, `my-gpt`) +- Passer d'un fournisseur à l'autre (OpenAI, Anthropic, Ollama local, etc.) facilement -## Configuration Files +## Fichiers de configuration -The client automatically loads provider configurations from the first existing file found (in priority order): +Le client charge automatiquement les configurations du fournisseur à partir du premier fichier existant trouvé (par ordre de priorité) : -| Priorité | Emplacement | File Path | +| Priorité | Emplacement | Emplacement du fichier | | ------------------------------------- | ----------- | ------------------------------------------------- | | 1 (le plus élevé) | userData | `/Settings/AIProviders.json` | | 2 | user | `/Settings/AIProviders.json` | | 3 (le plus faible) | structure | `/SOURCES/AIProviders.json` | -**Important:** Only the **first existing file** is loaded. There is no merging of multiple files. +**Important:** Seul le **premier fichier existant** est chargé. Il n'y a pas de fusion de plusieurs fichiers. -### Configuration File Format +### Format du fichier de configuration ```json { @@ -50,23 +50,23 @@ The client automatically loads provider configurations from the first existing f } ``` -### Provider Fields +### Champs du fournisseur -| Champ | Type | Obligatoire | Description | -| -------------- | ---- | ----------- | -------------------------------------------------------------- | -| `baseURL` | Text | Oui | API endpoint URL | -| `apiKey` | Text | Non | API key value | -| `organisation` | Text | Non | Organization ID (optional, OpenAI-specific) | -| `project` | Text | Non | Project ID (optional, OpenAI-specific) | +| Champ | Type | Obligatoire | Description | +| -------------- | ---- | ----------- | ------------------------------------------------------------------------- | +| `baseURL` | Text | Oui | URL du point de terminaison de l'API | +| `apiKey` | Text | Non | Valeur de la clé API | +| `organisation` | Text | Non | ID de l'organisation (facultatif, spécifique à OpenAI) | +| `project` | Text | Non | ID du projet (facultatif, spécifique à OpenAI) | -### Model Alias Fields +### Champs d'alias de modèle -| Champ | Type | Obligatoire | Description | -| ------------- | ---- | ----------- | ------------------------------------------------------------------- | -| `fournisseur` | Text | Oui | Name of the provider (must exist in `providers`) | -| `model` | Text | Oui | Model ID used by the provider | +| Champ | Type | Obligatoire | Description | +| ---------- | ---- | ----------- | --------------------------------------------------------------------- | +| `provider` | Text | Oui | Nom du fournisseur (doit exister dans `providers`) | +| `model` | Text | Oui | ID du modèle utilisé par le fournisseur | -### Example Configuration +### Exemple de configuration ```json { @@ -103,25 +103,25 @@ The client automatically loads provider configurations from the first existing f } ``` -## Usage in API Calls +## Utilisation dans les appels d'API -### Model Parameter Formats +### Formats de paramétrage du modèle -Two syntaxes are supported: +Deux syntaxes sont prises en charge : -| Syntaxe | Description | -| --------------------- | ---------------------------------------------------------------------------------- | -| `provider:model_name` | Provider alias — specify provider and model directly | -| `:model_alias` | Model alias — reference a named model from the `models` configuration by bare name | +| Syntaxe | Description | +| --------------------- | ------------------------------------------------------------------------------------------ | +| `provider:model_name` | Alias de fournisseur - spécifie directement le fournisseur et le modèle | +| `:model_alias` | Alias de modèle — référence un modèle nommé de la configuration `models` par un nom simple | -#### Provider alias syntax +#### Syntaxe alias de fournisseur -Use the `provider:model_name` syntax in any API call that accepts a model parameter: +Utilisez la syntaxe `provider:model_name` dans tout appel d'API qui accepte un modèle en paramètre : ```4d var $client := cs.AIKit.OpenAI.new() -// Chat completions +// Complétions de chat var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) var $result := $client.chat.completions.create($messages; {model: "local:llama3"}) @@ -130,131 +130,131 @@ var $result := $client.chat.completions.create($messages; {model: "local:llama3" var $result := $client.embeddings.create("text"; "openai:text-embedding-3-small") var $result := $client.embeddings.create("text"; "local:nomic-embed-text") -// Image generation +// Génération d'images var $result := $client.images.generate("prompt"; {model: "openai:dall-e-3"}) ``` -#### Model alias syntax +#### Syntaxe alias de modèle -Use a bare model name to reference a named model defined in the `models` section of the configuration file. The provider, model ID, and credentials are resolved automatically: +Utilisez un nom de modèle simple pour référencer un modèle nommé défini dans la section `models` du fichier de configuration. Le fournisseur, l'ID du modèle et les informations d'identification sont résolus automatiquement : ```4d var $client := cs.AIKit.OpenAI.new() -// Use a named model alias +// Utiliser un alias de modèle nommé var $result := $client.chat.completions.create($messages; {model: ":my-gpt"}) var $result := $client.chat.completions.create($messages; {model: ":my-claude"}) -// Embeddings with a named model alias +// Embeddings avec un alias de modèle nommé var $result := $client.embeddings.create("text"; ":my-embedding") ``` -### How It Works +### Comment ça marche -#### Provider alias (`provider:model`) +#### Alias de fournisseur (`provider:model`) -When you use the `provider:model` syntax, the client automatically: +Lorsque vous utilisez la syntaxe `provider:model`, le client automatiquement : -1. **Parses** the model string to extract provider name and model name - - Example: `"openai:gpt-5.1"` → provider=`"openai"`, model=`"gpt-5.1"` +1. **analyse** la chaîne du modèle pour extraire le nom du fournisseur et le nom du modèle + - Exemple : `"openai:gpt-5.1"` → provider=`"openai"`, model=`"gpt-5.1"` -2. **Looks up** the provider configuration from the loaded JSON file - - Retrieves `baseURL`, `apiKey`, `organization`, `project` +2. **recherche** la configuration du fournisseur à partir du fichier JSON chargé + - Récupère `baseURL`, `apiKey`, `organization`, `project` -3. **Makes the API request** using the resolved configuration - - Sends request to the provider's `baseURL` with the correct `apiKey` +3. **effectue la requête API** en utilisant la configuration résolue + - Envoie une requête à la `baseURL` du fournisseur avec la `apiKey` correcte -#### Model alias (bare name) +#### Alias de modèle (nom simple) -When you use a bare model name that matches a configured alias, the client automatically: +Lorsque vous utilisez un nom de modèle simple qui correspond à un alias configuré, le client automatiquement : -1. **Looks up** the model alias in the `models` section of the configuration - - Example: `":my-gpt"` → finds entry with `provider: "openai"`, `model: "gpt-5.1"` +1. **recherche** l'alias du modèle dans la section `models` de la configuration + - Exemple : `":my-gpt"` → trouve une entrée avec `provider : "openai"`, `model : "gpt-5.1"` -2. **Resolves** the associated provider to get `baseURL` and `apiKey` +2. **résoud** le fournisseur associé pour obtenir `baseURL` et `apiKey` -3. **Makes the API request** using the provider's endpoint and the stored model ID +3. **effectue la requête API** en utilisant le point de terminaison du fournisseur et l'ID du modèle stocké. -### Using Plain Model Names +### Utiliser des noms de modèles seuls -If you specify a model name **without** a provider prefix or `:` prefix, the client uses the configuration from its constructor: +Si vous spécifiez un nom de modèle **sans** préfixe de fournisseur ou avec un préfixe `:`, le client utilise la configuration de son constructeur : ```4d -// Use constructor configuration -var $client := cs.AIKit.OpenAI.new({apiKey: "sk-..."; baseURL: "https://api.openai.com/v1"}) -var $result := $client.chat.completions.create($messages; {model: "gpt-5.1"}) +// Utiliser la configuration du constructeur +var $client := cs.AIKit.OpenAI.new({apiKey : "sk-..." ; baseURL : "https://api.openai.com/v1"}) +var $result := $client.chat.completions.create($messages; {model : "gpt-5.1"}) -// Override with provider alias -var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) +// Surcharge avec l'alias du fournisseur +var $result := $client.chat.completions.create($messages; {model : "anthropic:claude-3-opus"}) -// Override with model alias (bare name) -var $result := $client.chat.completions.create($messages; {model: ":my-gpt"}) +// Surcharge avec l'alias du modèle (nom simple) +var $result := $client.chat.completions.create($messages; {model : ":my-gpt"}) ``` ## Exemples -### Multi-Provider Chat Application +### Application de chat multi-fournisseurs ```4d var $client := cs.AIKit.OpenAI.new() var $messages := [] -$messages.push({role: "user"; content: "What is the capital of France?"}) +$messages.push({role : "user" ; content : "Quelle est la capitale de la France ?"}) -// Try OpenAI -var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) +// On essaie OpenAI +var $result := $client.chat.completions.create($messages; {model : "openai:gpt-5.1"}) -// Try Anthropic -var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-5-sonnet"}) +// On essaie Anthropic +var $result := $client.chat.completions.create($messages; {model : "anthropic:claude-3-5-sonnet"}) -// Try local Ollama -var $result := $client.chat.completions.create($messages; {model: "local:llama3.2"}) +// On essaie Ollama local +var $result := $client.chat.completions.create($messages; {model : "local:llama3.2"}) ``` -### Embeddings with Multiple Providers +### Embeddings avec plusieurs fournisseurs ```4d var $client := cs.AIKit.OpenAI.new() var $text := "Hello world" -// Use OpenAI embeddings +// Utiliser les embeddings OpenAI var $embedding1 := $client.embeddings.create($text; "openai:text-embedding-3-small") -// Use local embeddings +// Utiliser les embeddings locaux var $embedding2 := $client.embeddings.create($text; "local:nomic-embed-text") ``` -## Configuration Management +## Gestion des configurations -Provider configurations can be managed through [4D Settings](https://developer.4d.com/docs/settings/ai) or by directly editing JSON files. +Les configurations de fournisseurs peuvent être gérées via les [Paramètres de 4D](https://developer.4d.com/docs/settings/ai) ou en modifiant directement les fichiers JSON. -**To add or modify providers:** +**Pour ajouter ou modifier des fournisseurs :** -1. Use 4D Settings interface (recommended), or -2. Edit the appropriate JSON file (userData, user, or structure) -3. Restart your application or create a new OpenAI client instance to load changes +1. Utilisez l'interface des Paramètres 4D (recommandé), ou +2. Modifiez le fichier JSON approprié (fichier données utilisateur, utilisateur ou structure) +3. Redémarrez votre application ou créez une nouvelle instance de client OpenAI pour tenir compte des modifications. -**Recommended file location:** +**Emplacement du fichier recommandé :** -- **For user-specific configs:** `/Settings/AIProviders.json` -- **For application defaults:** `/SOURCES/AIProviders.json` +- **Pour les configurations spécifiques à l'utilisateur :** `/Settings/AIProviders.json` +- **Pour les valeurs par défaut de l'application :** `/SOURCES/AIProviders.json` -### No Reload Capability +### Pas de capacité de rechargement -Once a client is instantiated, it cannot reload provider configurations. To pick up configuration changes: +Une fois qu'un client est instancié, il ne peut pas recharger les configurations de fournisseurs. Pour prendre en compte les changements de configuration : ```4d -// Configuration changed - create new client +// Configuration modifiée - création d'un nouveau client var $client := cs.AIKit.OpenAI.new() ``` -## Security Considerations +## Considérations sur la sécurité -When using 4D in client/server mode, it is **strongly recommended** to execute AI-related code on the server side to protect API tokens and credentials from exposure to client machines. +Lors de l'utilisation de 4D en mode client/serveur, il est **fortement recommandé** d'exécuter le code lié à l'IA côté serveur afin de protéger les tokens et les informations d'identification de l'API de l'exposition aux machines clientes. -## Common Use Cases +## Scénarios d'application courants -### Local Development with Ollama +### Développement local avec Ollama ```json { @@ -271,9 +271,9 @@ var $client := cs.AIKit.OpenAI.new() var $result := $client.chat.completions.create($messages; {model: "local:llama3.2"}) ``` -### Named Model Aliases +### Alias de modèles nommés -Define models once, use them everywhere by name: +Définir les modèles une fois, les utiliser partout par leur nom : ```json { @@ -307,21 +307,21 @@ Define models once, use them everywhere by name: ```4d var $client := cs.AIKit.OpenAI.new() -// Use named model aliases — no need to remember provider or model ID +// Utiliser des alias de modèles nommés — pas besoin de se souvenir du fournisseur ou de l'ID du modèle var $result := $client.chat.completions.create($messages; {model: ":chat"}) var $result := $client.chat.completions.create($messages; {model: ":fast"}) var $embedding := $client.embeddings.create("text"; ":embedding") ``` -### List All Configured Models +### Lister tous les modèles configurés ```4d var $providers := cs.AIKit.OpenAIProviders.new() var $models := $providers.modelAliases() -// Returns: [{name: "chat", provider: "openai", model: "gpt-5.1"}, ...] +// Renvoie : [{name: "chat", provider: "openai", model: "gpt-5.1"}, ...] ``` -### Production with Multiple Cloud Providers +### Production avec plusieurs fournisseurs de services dans le cloud ```json { @@ -342,7 +342,7 @@ var $models := $providers.modelAliases() } ``` -### Provider-Specific Organizations +### Organisations spécifiques des fournisseurs ```json { @@ -360,13 +360,13 @@ var $models := $providers.modelAliases() ``` ```4d -// Route to different organizations -var $resultA := $client.chat.completions.create($messages; {model: "openai-team-a:gpt-5.1"}) -var $resultB := $client.chat.completions.create($messages; {model: "openai-team-b:gpt-5.1"}) +// Routage vers différentes organisations +var $resultA := $client.chat.completions.create($messages; {model : "openai-team-a:gpt-5.1"}) +var $resultB := $client.chat.completions.create($messages; {model : "openai-team-b:gpt-5.1"}) ``` -## Related Documentation +## Documentation liée -- [OpenAI Class](Classes/OpenAI.md) - Main client class -- [OpenAIProviders Class](Classes/OpenAIProviders.md) - Provider configuration management -- [Compatible OpenAI APIs](compatible-openai.md) - List of compatible providers +- [Classe OpenAI](Classes/OpenAI.md) - Classe client principale +- [Classe OpenAIProviders](Classes/OpenAIProviders.md) - Gestion de la configuration des fournisseurs +- [API OpenAI compatibles](compatible-openai.md) - Liste des fournisseurs compatibles diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png new file mode 100644 index 00000000000000..7cbec84055b1d3 Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png new file mode 100644 index 00000000000000..d78a6f5f3c1a48 Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png new file mode 100644 index 00000000000000..95e6603575d8a3 Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png new file mode 100644 index 00000000000000..5b09f52d9fa16c Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png differ 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 264a248513dfd6..0dc399d405f1df 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -5,12 +5,16 @@ title: Page Compatibilité La page Compatibilité regroupe les paramètres relatifs au maintien de la compatibilité avec les versions précédentes de 4D. -> Le nombre d'options affichées dépend de la version de 4D avec laquelle la base de données/projet original a été créé, ainsi que des paramétrages modifiés dans cette base/projet.\ -> 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. -> 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**. +:::note -- **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 nombre d'options affichées dépend de la version de 4D avec laquelle la base de données/projet original a été créé, ainsi que des paramétrages modifiés dans cette base/projet.\ + 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. +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. 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**. + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 @@ -18,12 +22,14 @@ 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/dom-find-xml-element) 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). + +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). -- **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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. 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)). +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) 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. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md index 70672f53e6684a..a67cb3ec56d1cf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md @@ -66,6 +66,47 @@ Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suiv } ``` +## Printing forms + +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Article(s) de blog sur le sujet + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitation + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ## Formulaire projet et formulaire table Il existe deux catégories de formulaires : @@ -78,7 +119,7 @@ En règle générale, vous sélectionnez la catégorie de formulaire lorsque vou ## Pages formulaire -Chaque formulaire est composé d'au moins deux pages : +Each form is made of at least two 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. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md index 8ddf67afc744d5..4c4ed9c8ca9ba5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md @@ -18,6 +18,7 @@ Lisez [**Les nouveautés de 4D 21 R3**](https://blog.4d.com/fr/whats-new-in-4d-2 - Nouvelle [page **IA**](../settings/ai.md) dans la boîte de dialogue des Propriétés, permettant de configurer des [alias de fournisseurs et de modèles](../aikit/provider-model-aliases.md) qui peuvent être appelés dans le code via le composant 4D AIKit. - Composant 4D AIKit : nouvelle classe [Providers](../aikit/Classes/OpenAIProviders.md) pour instancier et gérer les [alias de fournisseurs et de modèles](../aikit/provider-model-aliases.md). - Prise en charge du [mot-clé `server`](../Concepts/classes.md#server) pour les fonctions du modèle de données ORDA et les fonctions singleton partagées/session. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dépendances : prise en charge des [composants stockés sur les dépôts GitLab](../Project/components.md#configuring-a-gitlab-repository). - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=21_R3) : liste de tous les bugs qui ont été corrigés dans 4D 21 R3. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAI.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAI.md index 28c927f4594f94..5ebf2ed6230474 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAI.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAI.md @@ -78,6 +78,6 @@ $client.files.create(...) $client.model.lists(...) ``` -## Provider Model Aliases +## Alias de modèles de fournisseurs -The OpenAI client supports provider model aliases for easy multi-provider usage. See [Provider Model Aliases](../provider-model-aliases.md) for complete documentation. +Le client OpenAI prend en charge les alias de modèles de fournisseurs pour faciliter l'utilisation de plusieurs fournisseurs. Voir [Alias de modèles de fournisseurs](../provider-model-aliases.md) pour une documentation complète. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIChatCompletionsParameters.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIChatCompletionsParameters.md index c61ea26f7df83e..aa38bf8293f03b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIChatCompletionsParameters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIChatCompletionsParameters.md @@ -13,20 +13,20 @@ La classe `OpenAIChatCompletionParameters` permet de gérer les paramètres requ ## Propriétés -| Propriété | Type | Valeur par défaut | Description | -| ----------------------- | ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | `"gpt-4o-mini"` | ID du modèle à utiliser. Supports [provider:model aliases](../provider-model-aliases.md) for multi-provider usage (e.g., `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`). | -| `stream` | Boolean | `False` | Indique si la progression partielle doit être retransmise en continu. Si cette option est activée, les tokens seront envoyés sous forme de données uniquement. Une formule de rappel est requise. | -| `stream_options` | Object | `Null` | Propriété pour stream=True. Par exemple : `{include_usage: True}` | -| `max_completion_tokens` | Integer | `0` | Le nombre maximum de tokens qui peuvent être générés dans la réponse. | -| `n` | Integer | `1` | Nombre de réponses à générer pour chaque invite (prompt). | -| `temperature` | Real | `-1` | Température d'échantillonnage à utiliser, entre 0 et 2. Les valeurs élevées rendent la sortie plus aléatoire, tandis que des valeurs faibles la rendent plus ciblée et déterministe. | -| `store` | Boolean | `False` | Stocker ou non le résultat de cette requête de génération de réponse conversationnelle. | -| `reasoning_effort` | Text | `Null` | Contraintes sur l'effort de raisonnement pour les modèles de raisonnement. Les valeurs actuellement prises en charge sont "low", "medium" et "high". | -| `response_format` | Object | `Null` | Un objet spécifiant le format que le modèle doit produire. Compatible avec les sorties structurées. | -| `tools` | Collection | `Null` | Une liste d'outils ([OpenAITool](OpenAITool.md)) que le modèle peut appeler. Seul le type "function" est pris en charge. | -| `tool_choice` | Variant | `Null` | Contrôle l'outil (le cas échéant) qui est appelé par le modèle. Peut être `"none"`, `"auto"`, `"required"`, ou spécifier un outil particulier. | -| `prediction` | Object | `Null` | Contenu de sortie statique, tel que le contenu d'un fichier texte en cours de régénération. | +| Propriété | Type | Valeur par défaut | Description | +| ----------------------- | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | `"gpt-4o-mini"` | ID du modèle à utiliser. Prend en charge [provider:model aliases](../provider-model-aliases.md) pour une utilisation multi-fournisseurs (par exemple, `"openai:gpt-4o"`, `"anthropic:claude-3-opus"`). | +| `stream` | Boolean | `False` | Indique si la progression partielle doit être retransmise en continu. Si cette option est activée, les tokens seront envoyés sous forme de données uniquement. Une formule de rappel est requise. | +| `stream_options` | Object | `Null` | Propriété pour stream=True. Par exemple : `{include_usage: True}` | +| `max_completion_tokens` | Integer | `0` | Le nombre maximum de tokens qui peuvent être générés dans la réponse. | +| `n` | Integer | `1` | Nombre de réponses à générer pour chaque invite (prompt). | +| `temperature` | Real | `-1` | Température d'échantillonnage à utiliser, entre 0 et 2. Les valeurs élevées rendent la sortie plus aléatoire, tandis que des valeurs faibles la rendent plus ciblée et déterministe. | +| `store` | Boolean | `False` | Stocker ou non le résultat de cette requête de génération de réponse conversationnelle. | +| `reasoning_effort` | Text | `Null` | Contraintes sur l'effort de raisonnement pour les modèles de raisonnement. Les valeurs actuellement prises en charge sont "low", "medium" et "high". | +| `response_format` | Object | `Null` | Un objet spécifiant le format que le modèle doit produire. Compatible avec les sorties structurées. | +| `tools` | Collection | `Null` | Une liste d'outils ([OpenAITool](OpenAITool.md)) que le modèle peut appeler. Seul le type "function" est pris en charge. | +| `tool_choice` | Variant | `Null` | Contrôle l'outil (le cas échéant) qui est appelé par le modèle. Peut être `"none"`, `"auto"`, `"required"`, ou spécifier un outil particulier. | +| `prediction` | Object | `Null` | Contenu de sortie statique, tel que le contenu d'un fichier texte en cours de régénération. | ### Propriétés du callback asynchrone diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIEmbeddingsAPI.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIEmbeddingsAPI.md index 394f2c5140db1f..581ad8f6a177ea 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIEmbeddingsAPI.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIEmbeddingsAPI.md @@ -17,12 +17,12 @@ https://platform.openai.com/docs/api-reference/embeddings Crée une représentation vectorielle pour l'entrée, le modèle et les paramètres fournis. -| Argument | Type | Description | -| ------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| *input* | Text ou Collection de textes | L'entrée à vectoriser. | -| *model* | Text | Le [modèle à utiliser](https://platform.openai.com/docs/guides/embeddings#embedding-models). Supports [provider:model aliases](../provider-model-aliases.md). | -| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | Les paramètres permettant de personnaliser la requête de représentations vectorielles. | -| Résultat | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | Les représentations vectorielles | +| Argument | Type | Description | +| ------------ | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| *input* | Text ou Collection de textes | L'entrée à vectoriser. | +| *model* | Text | Le [modèle à utiliser](https://platform.openai.com/docs/guides/embeddings#embedding-models). Prend en charge [provider:model aliases](../provider-model-aliases.md). | +| *parameters* | [OpenAIEmbeddingsParameters](OpenAIEmbeddingsParameters.md) | Les paramètres permettant de personnaliser la requête de représentations vectorielles. | +| Résultat | [OpenAIEmbeddingsResult](OpenAIEmbeddingsResult.md) | Les représentations vectorielles | #### Exemples d'utilisation diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIImageParameters.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIImageParameters.md index 68a2dc88e3dce5..c41bd344be9853 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIImageParameters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIImageParameters.md @@ -13,13 +13,13 @@ La classe `OpenAIImageParameters` permet de configurer et gérer les paramètres ## Propriétés -| Nom de propriété | Type | Valeur par défaut | Description | -| ----------------- | ------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | "dall-e-2" | Spécifie le modèle à utiliser pour la génération d'images. Supports [provider:model aliases](../provider-model-aliases.md). | -| `n` | Integer | 1 | Le nombre d'images à générer (doit être compris entre 1 et 10 ; seul `n=1` est supporté pour `dall-e-3`). | -| `size` | Text | "1024x1024" | La taille des images générées. Doit être conforme aux spécifications du modèle. | -| `style` | Text | "" | Le style des images générées (doit être soit `vivid` soit `natural`). | -| `response_format` | Text | "url" | Le format des images retournées. Doit être `url` ou `b64_json`. | +| Nom de propriété | Type | Valeur par défaut | Description | +| ----------------- | ------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | "dall-e-2" | Spécifie le modèle à utiliser pour la génération d'images. Prend en charge [provider:model aliases](../provider-model-aliases.md). | +| `n` | Integer | 1 | Le nombre d'images à générer (doit être compris entre 1 et 10 ; seul `n=1` est supporté pour `dall-e-3`). | +| `size` | Text | "1024x1024" | La taille des images générées. Doit être conforme aux spécifications du modèle. | +| `style` | Text | "" | Le style des images générées (doit être soit `vivid` soit `natural`). | +| `response_format` | Text | "url" | Le format des images retournées. Doit être `url` ou `b64_json`. | ## Voir également diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIProviders.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIProviders.md index 4e714401f5c59c..382936177ed516 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIProviders.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/Classes/OpenAIProviders.md @@ -7,20 +7,20 @@ title: OpenAIProviders ## Sommaire -The `OpenAIProviders` class manages AI provider configurations by loading configuration and handling resolution of model strings in the `provider:model` format. +La classe `OpenAIProviders` gère les configurations de fournisseurs d'IA en chargeant la configuration et en gérant la résolution des chaînes de modèles au format `provider:model`. -For complete usage documentation, see [Provider Model Aliases](../provider-model-aliases.md). +Pour une documentation complète sur son utilisation, voir [Alias de modèles de fournisseurs](../provider-model-aliases.md). ## Description -This class enables multi-provider support by: +Cette classe permet la prise en charge de plusieurs fournisseurs via : -- Loading provider configurations from a single JSON file -- Loading named model aliases that map to providers and model IDs -- Resolving `provider:model` syntax to full API configurations -- Resolving named model aliases by bare name to full provider + model configurations +- le chargement des configurations de fournisseurs à partir d'un seul fichier JSON +- le chargement des alias de modèles nommés correspondant à des fournisseurs et à des identifiants de modèles +- la résolution de la syntaxe `provider:model` en configuration complète de l'API +- la résolution des alias de modèles nommés depuis un nom simple en nom du fournisseur complet + les configurations du modèle -The `OpenAI` class automatically loads provider configurations when instantiated. +La classe `OpenAI` charge automatiquement les configurations des fournisseurs lors de son instanciation. ## Constructeur @@ -28,38 +28,38 @@ The `OpenAI` class automatically loads provider configurations when instantiated var $providers := cs.AIKit.OpenAIProviders.new() ``` -Creates a new instance that loads provider configuration from the `AIProviders.json` file (see [**Configuration Files**](../provider-model-aliases.md#configuration-files) in the "Provider Model Aliases" page for details on file locations and format). +Crée une nouvelle instance qui charge la configuration du fournisseur à partir du fichier `AIProviders.json` (voir [**Fichiers de configuration**](../provider-model-aliases.md#configuration-files) dans la page "Alias de fournisseurs de modèles" pour plus de détails sur l'emplacement et le format des fichiers). **Important:** -- Only the first existing file is loaded. There is no merging of multiple files. -- The configuration is read once at instantiation time. If the `AIProviders.json` file is modified afterward, those changes will not be reflected in the existing instance. You must create a new instance of `OpenAIProviders` to reload the updated configuration. +- Seul le premier fichier existant est chargé. Il n'y a pas de fusion de plusieurs fichiers. +- La configuration est lue une fois au moment de l'instanciation. Si le fichier `AIProviders.json` est modifié par la suite, ces changements ne seront pas reflétés dans l'instance existante. Vous devez créer une nouvelle instance de `OpenAIProviders` pour recharger la configuration mise à jour. ## Utilisation -### Integration with OpenAI Class +### Intégration avec la classe OpenAI ```4d var $client := cs.AIKit.OpenAI.new() -// Use model aliases with provider:model syntax +// Utilisation d'alias de modèles avec syntaxe provider:model var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) var $result := $client.chat.completions.create($messages; {model: "local:llama3"}) ``` -### Direct Provider Access +### Accès direct aux fournisseurs ```4d var $providers := cs.AIKit.OpenAIProviders.new() -// Get a specific provider configuration +// Obtenir une configuration de fournisseur spécifique var $config := $providers.get("openai") -// Returns: {baseURL: "...", apiKey: "...", modelAliases: [...], ...} or Null +// Renvoie : {baseURL : "...", apiKey : "...", modelAliases : [...], ...} ou Null -// Get all provider names +// Obtenir tous les noms de fournisseurs var $names := $providers.list() -// Returns: ["openai", "anthropic", "mistral", "local"] +// Renvoie : ["openai", "anthropic", "mistral", "local"] ``` ## Fonctions @@ -68,21 +68,21 @@ var $names := $providers.list() **get**(*name* : Text) : Object -Get a provider configuration by name. +Obtenir la configuration d'un fournisseur par son nom. -| Paramètres | Type | Description | -| ---------- | ------ | ----------------------------------------------------- | -| *name* | Text | The provider name | -| Résultat | Object | Provider configuration object, or `Null` if not found | +| Paramètres | Type | Description | +| ---------- | ------ | ---------------------------------------------------------------------- | +| *name* | Text | Le nom du fournisseur | +| Résultat | Object | Objet de configuration du fournisseur, ou `Null` s'il n'est pas trouvé | #### Exemple ```4d var $config := $providers.get("openai") If ($config # Null) - // Use $config.baseURL, $config.apiKey, etc. + // Utiliser $config.baseURL, $config.apiKey, etc. - // We could build a client with it + // Nous pourrions construire un client avec var $client:=cs.AIKit.OpenAI.new($config) End if ``` @@ -91,17 +91,17 @@ End if **list**() : Collection -Get all provider names. +Obtenir les noms de tous les fournisseurs. -| Paramètres | Type | Description | -| ---------- | ---------- | ---------------------------- | -| Résultat | Collection | Collection of provider names | +| Paramètres | Type | Description | +| ---------- | ---------- | ---------------------------------- | +| Résultat | Collection | Collection de noms de fournisseurs | #### Exemple ```4d var $names := $providers.list() -// Returns: ["openai", "anthropic", ...] +// Retourne : ["openai", "anthropic", ...] For each ($name; $names) var $config := $providers.get($name) @@ -112,75 +112,75 @@ End for each **modelAliases**() : Collection -Get all configured model aliases. +Récupère tous les alias de modèle configurés. -| Paramètres | Type | Description | -| ---------- | ---------- | --------------------------------- | -| Résultat | Collection | Collection of model alias objects | +| Paramètres | Type | Description | +| ---------- | ---------- | -------------------------------------- | +| Résultat | Collection | Collection d'objets d'alias de modèles | -Each object in the collection contains: +Chaque objet de la collection contient : -| Propriété | Type | Description | -| ------------- | ---- | --------------------------------- | -| `name` | Text | Model alias name | -| `fournisseur` | Text | Provider name | -| `model` | Text | Model ID to use with the provider | +| Propriété | Type | Description | +| ---------- | ---- | ------------------------------------------- | +| `name` | Text | Nom de l'alias du modèle | +| `provider` | Text | Nom du fournisseur | +| `model` | Text | ID du modèle à utiliser avec le fournisseur | #### Exemple ```4d var $models := $providers.modelAliases() -// Returns: [{name: "my-gpt", provider: "openai", model: "gpt-5.1"}, ...] +// Renvoie : [{name: "my-gpt", provider: "openai", model: "gpt-5.1"}, ...] For each ($model; $models) // $m.name, $m.provider, $m.model End for each ``` -## Model Resolution +## Résolution du modèle -Two syntaxes are supported for model resolution: +Deux syntaxes sont prises en charge pour la résolution des modèles : -### Provider alias (`provider:model`) +### Alias de fournisseur (`provider:model`) -Specify the provider and model name directly: +Spécifie directement le nom du fournisseur et du modèle : ```4d var $client := cs.AIKit.OpenAI.new() $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) ``` -This is resolved internally to: +Résolution en interne : -1. Split `"openai:gpt-5.1"` into provider=`"openai"` and model=`"gpt-5.1"` -2. Look up the `"openai"` provider configuration -3. Extract `baseURL` and `apiKey` -4. Make the API request using the resolved configuration +1. Séparation `"openai:gpt-5.1"` en provider=`"openai"` et model=`"gpt-5.1"` +2. Recherche de la configuration du fournisseur `"openai"` +3. Extraction de `baseURL` et `apiKey` +4. Requête API effectuée en utilisant la configuration résolue **Exemples :** -- `"openai:gpt-5.1"` → Use OpenAI provider with gpt-5.1 model -- `"anthropic:claude-3-opus"` → Use Anthropic provider with claude-3-opus -- `"local:llama3"` → Use local provider with llama3 model +- `"openai:gpt-5.1"` → Utiliser le fournisseur OpenAI avec le modèle gpt-5.1 +- `"anthropic:claude-3-opus"` → Utiliser le fournisseur Anthropic avec claude-3-opus +- `"local:llama3"` → Utiliser un fournisseur local avec le modèle llama3 -### Model alias (bare name) +### Alias de modèle (nom simple) -Use a named model by its bare name from the `models` section of the configuration: +Utilise un modèle déclaré par son nom simple dans la section `models` de la configuration : ```4d var $client := cs.AIKit.OpenAI.new() $client.chat.completions.create($messages; {model: ":my-gpt"}) ``` -This is resolved internally to: +Résolution en interne : -1. Look up `"my-gpt"` in the `models` configuration -2. Find its `provider` (e.g., `"openai"`) and `model` (e.g., `"gpt-5.1"`) -3. Resolve the provider to get `baseURL` and `apiKey` -4. Make the API request using the resolved configuration +1. Recherche de `"my-gpt"` dans la configuration `models` +2. Récupération de son `provider` (par exemple, `"openai"`) et de son `model` (par exemple, `"gpt-5.1"`) +3. Résolution du fournisseur pour obtenir `baseURL` et `apiKey` +4. Requête API effectuée en utilisant la configuration résolue **Exemples :** -- `"my-gpt"` → Use the model alias "my-gpt" (resolves to its configured provider and model) -- `"my-embedding"` → Use the model alias "my-embedding" for embedding operations +- `"my-gpt"` → Utiliser l'alias de modèle "my-gpt" (résolu par le fournisseur et le modèle configurés) +- `"my-embedding"` → Utiliser l'alias de modèle "my-embedding" pour les opérations d'embedding diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/provider-model-aliases.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/provider-model-aliases.md index 15dc100e3b12ba..0cecf0aec7697a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/provider-model-aliases.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/aikit/provider-model-aliases.md @@ -1,35 +1,35 @@ --- id: provider-model-aliases -title: Provider & Model Aliases +title: Alias de fournisseurs et de modèles --- -# Provider & Model Aliases +# Alias de fournisseurs et de modèles -The OpenAI client supports provider and model aliases, allowing you to define provider configurations and named model aliases in JSON files and reference them using simple syntaxes. +Le client OpenAI prend en charge les alias de fournisseurs et de modèles, ce qui vous permet de définir des configurations de fournisseurs et des alias de modèles nommés dans des fichiers JSON et de les référencer à l'aide de syntaxes simples. ## Vue d’ensemble -Instead of hard-coding API endpoints and credentials in your code, you can: +Au lieu de coder en dur les points de terminaison et les identifiants de l'API dans votre code, vous pouvez : -- Define provider configurations in a JSON file -- Use the `provider:model` syntax to specify a provider and model directly -- Define named model aliases that map to a provider and a model ID -- Use a named model alias by bare name (e.g., `my-gpt`) -- Switch between providers (OpenAI, Anthropic, local Ollama, etc.) easily +- Définir les configurations des fournisseurs dans un fichier JSON +- Utiliser la syntaxe `provider:model` pour spécifier directement un fournisseur et un modèle +- Définir des alias de modèles nommés qui correspondent à un fournisseur et à un identifiant de modèle +- Utiliser l'alias d'un modèle nommé par son simple nom (par exemple, `my-gpt`) +- Passer d'un fournisseur à l'autre (OpenAI, Anthropic, Ollama local, etc.) facilement -## Configuration Files +## Fichiers de configuration -The client automatically loads provider configurations from the first existing file found (in priority order): +Le client charge automatiquement les configurations du fournisseur à partir du premier fichier existant trouvé (par ordre de priorité) : -| Priorité | Emplacement | File Path | +| Priorité | Emplacement | Emplacement du fichier | | ------------------------------------- | ----------- | ------------------------------------------------- | | 1 (le plus élevé) | userData | `/Settings/AIProviders.json` | | 2 | user | `/Settings/AIProviders.json` | | 3 (le plus faible) | structure | `/SOURCES/AIProviders.json` | -**Important:** Only the **first existing file** is loaded. There is no merging of multiple files. +**Important:** Seul le **premier fichier existant** est chargé. Il n'y a pas de fusion de plusieurs fichiers. -### Configuration File Format +### Format du fichier de configuration ```json { @@ -50,23 +50,23 @@ The client automatically loads provider configurations from the first existing f } ``` -### Provider Fields +### Champs du fournisseur -| Champ | Type | Obligatoire | Description | -| -------------- | ---- | ----------- | -------------------------------------------------------------- | -| `baseURL` | Text | Oui | API endpoint URL | -| `apiKey` | Text | Non | API key value | -| `organisation` | Text | Non | Organization ID (optional, OpenAI-specific) | -| `project` | Text | Non | Project ID (optional, OpenAI-specific) | +| Champ | Type | Obligatoire | Description | +| -------------- | ---- | ----------- | ------------------------------------------------------------------------- | +| `baseURL` | Text | Oui | URL du point de terminaison de l'API | +| `apiKey` | Text | Non | Valeur de la clé API | +| `organisation` | Text | Non | ID de l'organisation (facultatif, spécifique à OpenAI) | +| `project` | Text | Non | ID du projet (facultatif, spécifique à OpenAI) | -### Model Alias Fields +### Champs d'alias de modèle -| Champ | Type | Obligatoire | Description | -| ------------- | ---- | ----------- | ------------------------------------------------------------------- | -| `fournisseur` | Text | Oui | Name of the provider (must exist in `providers`) | -| `model` | Text | Oui | Model ID used by the provider | +| Champ | Type | Obligatoire | Description | +| ---------- | ---- | ----------- | --------------------------------------------------------------------- | +| `provider` | Text | Oui | Nom du fournisseur (doit exister dans `providers`) | +| `model` | Text | Oui | ID du modèle utilisé par le fournisseur | -### Example Configuration +### Exemple de configuration ```json { @@ -103,25 +103,25 @@ The client automatically loads provider configurations from the first existing f } ``` -## Usage in API Calls +## Utilisation dans les appels d'API -### Model Parameter Formats +### Formats de paramétrage du modèle -Two syntaxes are supported: +Deux syntaxes sont prises en charge : -| Syntaxe | Description | -| --------------------- | ---------------------------------------------------------------------------------- | -| `provider:model_name` | Provider alias — specify provider and model directly | -| `:model_alias` | Model alias — reference a named model from the `models` configuration by bare name | +| Syntaxe | Description | +| --------------------- | ------------------------------------------------------------------------------------------ | +| `provider:model_name` | Alias de fournisseur - spécifie directement le fournisseur et le modèle | +| `:model_alias` | Alias de modèle — référence un modèle nommé de la configuration `models` par un nom simple | -#### Provider alias syntax +#### Syntaxe alias de fournisseur -Use the `provider:model_name` syntax in any API call that accepts a model parameter: +Utilisez la syntaxe `provider:model_name` dans tout appel d'API qui accepte un modèle en paramètre : ```4d var $client := cs.AIKit.OpenAI.new() -// Chat completions +// Complétions de chat var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) var $result := $client.chat.completions.create($messages; {model: "local:llama3"}) @@ -130,131 +130,131 @@ var $result := $client.chat.completions.create($messages; {model: "local:llama3" var $result := $client.embeddings.create("text"; "openai:text-embedding-3-small") var $result := $client.embeddings.create("text"; "local:nomic-embed-text") -// Image generation +// Génération d'images var $result := $client.images.generate("prompt"; {model: "openai:dall-e-3"}) ``` -#### Model alias syntax +#### Syntaxe alias de modèle -Use a bare model name to reference a named model defined in the `models` section of the configuration file. The provider, model ID, and credentials are resolved automatically: +Utilisez un nom de modèle simple pour référencer un modèle nommé défini dans la section `models` du fichier de configuration. Le fournisseur, l'ID du modèle et les informations d'identification sont résolus automatiquement : ```4d var $client := cs.AIKit.OpenAI.new() -// Use a named model alias +// Utiliser un alias de modèle nommé var $result := $client.chat.completions.create($messages; {model: ":my-gpt"}) var $result := $client.chat.completions.create($messages; {model: ":my-claude"}) -// Embeddings with a named model alias +// Embeddings avec un alias de modèle nommé var $result := $client.embeddings.create("text"; ":my-embedding") ``` -### How It Works +### Comment ça marche -#### Provider alias (`provider:model`) +#### Alias de fournisseur (`provider:model`) -When you use the `provider:model` syntax, the client automatically: +Lorsque vous utilisez la syntaxe `provider:model`, le client automatiquement : -1. **Parses** the model string to extract provider name and model name - - Example: `"openai:gpt-5.1"` → provider=`"openai"`, model=`"gpt-5.1"` +1. **analyse** la chaîne du modèle pour extraire le nom du fournisseur et le nom du modèle + - Exemple : `"openai:gpt-5.1"` → provider=`"openai"`, model=`"gpt-5.1"` -2. **Looks up** the provider configuration from the loaded JSON file - - Retrieves `baseURL`, `apiKey`, `organization`, `project` +2. **recherche** la configuration du fournisseur à partir du fichier JSON chargé + - Récupère `baseURL`, `apiKey`, `organization`, `project` -3. **Makes the API request** using the resolved configuration - - Sends request to the provider's `baseURL` with the correct `apiKey` +3. **effectue la requête API** en utilisant la configuration résolue + - Envoie une requête à la `baseURL` du fournisseur avec la `apiKey` correcte -#### Model alias (bare name) +#### Alias de modèle (nom simple) -When you use a bare model name that matches a configured alias, the client automatically: +Lorsque vous utilisez un nom de modèle simple qui correspond à un alias configuré, le client automatiquement : -1. **Looks up** the model alias in the `models` section of the configuration - - Example: `":my-gpt"` → finds entry with `provider: "openai"`, `model: "gpt-5.1"` +1. **recherche** l'alias du modèle dans la section `models` de la configuration + - Exemple : `":my-gpt"` → trouve une entrée avec `provider : "openai"`, `model : "gpt-5.1"` -2. **Resolves** the associated provider to get `baseURL` and `apiKey` +2. **résoud** le fournisseur associé pour obtenir `baseURL` et `apiKey` -3. **Makes the API request** using the provider's endpoint and the stored model ID +3. **effectue la requête API** en utilisant le point de terminaison du fournisseur et l'ID du modèle stocké. -### Using Plain Model Names +### Utiliser des noms de modèles seuls -If you specify a model name **without** a provider prefix or `:` prefix, the client uses the configuration from its constructor: +Si vous spécifiez un nom de modèle **sans** préfixe de fournisseur ou avec un préfixe `:`, le client utilise la configuration de son constructeur : ```4d -// Use constructor configuration -var $client := cs.AIKit.OpenAI.new({apiKey: "sk-..."; baseURL: "https://api.openai.com/v1"}) -var $result := $client.chat.completions.create($messages; {model: "gpt-5.1"}) +// Utiliser la configuration du constructeur +var $client := cs.AIKit.OpenAI.new({apiKey : "sk-..." ; baseURL : "https://api.openai.com/v1"}) +var $result := $client.chat.completions.create($messages; {model : "gpt-5.1"}) -// Override with provider alias -var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-opus"}) +// Surcharge avec l'alias du fournisseur +var $result := $client.chat.completions.create($messages; {model : "anthropic:claude-3-opus"}) -// Override with model alias (bare name) -var $result := $client.chat.completions.create($messages; {model: ":my-gpt"}) +// Surcharge avec l'alias du modèle (nom simple) +var $result := $client.chat.completions.create($messages; {model : ":my-gpt"}) ``` ## Exemples -### Multi-Provider Chat Application +### Application de chat multi-fournisseurs ```4d var $client := cs.AIKit.OpenAI.new() var $messages := [] -$messages.push({role: "user"; content: "What is the capital of France?"}) +$messages.push({role : "user" ; content : "Quelle est la capitale de la France ?"}) -// Try OpenAI -var $result := $client.chat.completions.create($messages; {model: "openai:gpt-5.1"}) +// On essaie OpenAI +var $result := $client.chat.completions.create($messages; {model : "openai:gpt-5.1"}) -// Try Anthropic -var $result := $client.chat.completions.create($messages; {model: "anthropic:claude-3-5-sonnet"}) +// On essaie Anthropic +var $result := $client.chat.completions.create($messages; {model : "anthropic:claude-3-5-sonnet"}) -// Try local Ollama -var $result := $client.chat.completions.create($messages; {model: "local:llama3.2"}) +// On essaie Ollama local +var $result := $client.chat.completions.create($messages; {model : "local:llama3.2"}) ``` -### Embeddings with Multiple Providers +### Embeddings avec plusieurs fournisseurs ```4d var $client := cs.AIKit.OpenAI.new() var $text := "Hello world" -// Use OpenAI embeddings +// Utiliser les embeddings OpenAI var $embedding1 := $client.embeddings.create($text; "openai:text-embedding-3-small") -// Use local embeddings +// Utiliser les embeddings locaux var $embedding2 := $client.embeddings.create($text; "local:nomic-embed-text") ``` -## Configuration Management +## Gestion des configurations -Provider configurations can be managed through [4D Settings](https://developer.4d.com/docs/settings/ai) or by directly editing JSON files. +Les configurations de fournisseurs peuvent être gérées via les [Paramètres de 4D](https://developer.4d.com/docs/settings/ai) ou en modifiant directement les fichiers JSON. -**To add or modify providers:** +**Pour ajouter ou modifier des fournisseurs :** -1. Use 4D Settings interface (recommended), or -2. Edit the appropriate JSON file (userData, user, or structure) -3. Restart your application or create a new OpenAI client instance to load changes +1. Utilisez l'interface des Paramètres 4D (recommandé), ou +2. Modifiez le fichier JSON approprié (fichier données utilisateur, utilisateur ou structure) +3. Redémarrez votre application ou créez une nouvelle instance de client OpenAI pour tenir compte des modifications. -**Recommended file location:** +**Emplacement du fichier recommandé :** -- **For user-specific configs:** `/Settings/AIProviders.json` -- **For application defaults:** `/SOURCES/AIProviders.json` +- **Pour les configurations spécifiques à l'utilisateur :** `/Settings/AIProviders.json` +- **Pour les valeurs par défaut de l'application :** `/SOURCES/AIProviders.json` -### No Reload Capability +### Pas de capacité de rechargement -Once a client is instantiated, it cannot reload provider configurations. To pick up configuration changes: +Une fois qu'un client est instancié, il ne peut pas recharger les configurations de fournisseurs. Pour prendre en compte les changements de configuration : ```4d -// Configuration changed - create new client +// Configuration modifiée - création d'un nouveau client var $client := cs.AIKit.OpenAI.new() ``` -## Security Considerations +## Considérations sur la sécurité -When using 4D in client/server mode, it is **strongly recommended** to execute AI-related code on the server side to protect API tokens and credentials from exposure to client machines. +Lors de l'utilisation de 4D en mode client/serveur, il est **fortement recommandé** d'exécuter le code lié à l'IA côté serveur afin de protéger les tokens et les informations d'identification de l'API de l'exposition aux machines clientes. -## Common Use Cases +## Scénarios d'application courants -### Local Development with Ollama +### Développement local avec Ollama ```json { @@ -271,9 +271,9 @@ var $client := cs.AIKit.OpenAI.new() var $result := $client.chat.completions.create($messages; {model: "local:llama3.2"}) ``` -### Named Model Aliases +### Alias de modèles nommés -Define models once, use them everywhere by name: +Définir les modèles une fois, les utiliser partout par leur nom : ```json { @@ -307,21 +307,21 @@ Define models once, use them everywhere by name: ```4d var $client := cs.AIKit.OpenAI.new() -// Use named model aliases — no need to remember provider or model ID +// Utiliser des alias de modèles nommés — pas besoin de se souvenir du fournisseur ou de l'ID du modèle var $result := $client.chat.completions.create($messages; {model: ":chat"}) var $result := $client.chat.completions.create($messages; {model: ":fast"}) var $embedding := $client.embeddings.create("text"; ":embedding") ``` -### List All Configured Models +### Lister tous les modèles configurés ```4d var $providers := cs.AIKit.OpenAIProviders.new() var $models := $providers.modelAliases() -// Returns: [{name: "chat", provider: "openai", model: "gpt-5.1"}, ...] +// Renvoie : [{name: "chat", provider: "openai", model: "gpt-5.1"}, ...] ``` -### Production with Multiple Cloud Providers +### Production avec plusieurs fournisseurs de services dans le cloud ```json { @@ -342,7 +342,7 @@ var $models := $providers.modelAliases() } ``` -### Provider-Specific Organizations +### Organisations spécifiques des fournisseurs ```json { @@ -360,13 +360,13 @@ var $models := $providers.modelAliases() ``` ```4d -// Route to different organizations -var $resultA := $client.chat.completions.create($messages; {model: "openai-team-a:gpt-5.1"}) -var $resultB := $client.chat.completions.create($messages; {model: "openai-team-b:gpt-5.1"}) +// Routage vers différentes organisations +var $resultA := $client.chat.completions.create($messages; {model : "openai-team-a:gpt-5.1"}) +var $resultB := $client.chat.completions.create($messages; {model : "openai-team-b:gpt-5.1"}) ``` -## Related Documentation +## Documentation liée -- [OpenAI Class](Classes/OpenAI.md) - Main client class -- [OpenAIProviders Class](Classes/OpenAIProviders.md) - Provider configuration management -- [Compatible OpenAI APIs](compatible-openai.md) - List of compatible providers +- [Classe OpenAI](Classes/OpenAI.md) - Classe client principale +- [Classe OpenAIProviders](Classes/OpenAIProviders.md) - Gestion de la configuration des fournisseurs +- [API OpenAI compatibles](compatible-openai.md) - Liste des fournisseurs compatibles diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md index 264a248513dfd6..0dc399d405f1df 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md @@ -5,12 +5,16 @@ title: Page Compatibilité La page Compatibilité regroupe les paramètres relatifs au maintien de la compatibilité avec les versions précédentes de 4D. -> Le nombre d'options affichées dépend de la version de 4D avec laquelle la base de données/projet original a été créé, ainsi que des paramétrages modifiés dans cette base/projet.\ -> 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. -> 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**. +:::note -- **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 nombre d'options affichées dépend de la version de 4D avec laquelle la base de données/projet original a été créé, ainsi que des paramétrages modifiés dans cette base/projet.\ + 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. +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. 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**. + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 @@ -18,12 +22,14 @@ 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/dom-find-xml-element) 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). + +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). -- **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/text-to-document), [`Document to text`](../commands/document-to-text), et [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. 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)). +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) 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. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file 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 91205ce85412df..939642c4b1a04d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -71,8 +71,8 @@ title: Forms Forms are called using specific commands of the 4D Language. In your 4D desktop applications, forms can be used in various ways, depending on their status within your interface needs. A form can be: - used in its own window for data viewing, processing, editing, or to display on-screen information to the user, -- used as template for printing, - used embedded in another form (subform), +- used as template for printing, - or called by specific features like the Label editor. ### Using a project form in a window @@ -147,6 +147,10 @@ In the same way that you pass an object to a form with the [`DIALOG`](../command ### Using forms to be printed +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +#### 例題 + You can use forms to print data, either as page or as list. - To simply print some part of a form, use the [`Print form`](../commands/print-form) command. 例: @@ -184,6 +188,43 @@ var $h:=Print form("Request_var";$formData;Form detail) CLOSE PRINTING JOB ``` +#### 印刷レンダリングエンジン + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip 関連したblog 記事 + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +#### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning 制限 + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ### Other form usages There are several other ways to use forms in the 4D applications, including: @@ -204,7 +245,7 @@ There are several other ways to use forms in the 4D applications, including: ## フォームのページ -各フォームは、少なくとも 2つのページで構成されています: +Each form is made of at least two pages: - ページ1: デフォルトで表示されるメインページ - ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md index 3802e4d8a95a77..9703de00e01be9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md @@ -7,7 +7,7 @@ title: 印刷 フォーム毎に用紙設定をおこなうことができます。 この機能は、フォームエディターで印刷ページの境界を表示するのに便利です。 -> **互換性に関する注意:** アプリケーションモードでフォームを印刷するときにこれらの設定が考慮されたとしても、プラットフォームおよびドライバー依存性に関する制約から、フォームの印刷設定を保存するのにこの機能を使用することは推奨されません。 より強力な `Print settings to BLOB` / `BLOB to print settings` を使用することが強く推奨されています。 +> **互換性に関する注意:** アプリケーションモードでフォームを印刷するときにこれらの設定が考慮されたとしても、プラットフォームおよびドライバー依存性に関する制約から、フォームの印刷設定を保存するのにこの機能を使用することは推奨されません。 It is highly recommended to use the 4D commands [`Print settings to BLOB`](../commands/print-settings-to-blob)/[`BLOB to print settings`](../commands/blob-to-print-settings) which are more powerful. 次の印刷設定が変更できます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_ResizingOptions.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_ResizingOptions.md index 84afe846266ac9..db4055de8c06bd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_ResizingOptions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_ResizingOptions.md @@ -67,7 +67,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド @@ -97,7 +124,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md index bb99064225ab9f..67b977cfaf67e6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md @@ -38,7 +38,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -63,7 +75,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -83,7 +107,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -124,7 +160,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -149,7 +197,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -167,7 +227,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -197,7 +269,21 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Progress Indicators](progressIndicator.md) - [Ruler](ruler.md) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[進捗インジケーター](progressIndicator.md) - +[ルーラー](ruler.md) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -293,7 +379,18 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) (all styles except Regular and Flat) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Header](listbox-header-footer.md#headers) - [List Box Footer](listbox-header-footer.md#footers) - [Radio Button](radio_overview.md) (all styles except Regular and Flat) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) (通常とフラット以外のスタイル) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[ラジオボタン](radio_overview.md) (通常とフラット以外のスタイル) - +[テキストエリア](text.md) #### コマンド @@ -320,7 +417,7 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) +[リストボックス](listbox_overview.md) - [リストボックスカラム](listbox-column.md) - [リストボックスフッター](listbox-header-footer.md#footers) - [リストボックスヘッダー](listbox-header-footer.md#headers) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_TextAndPicture.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_TextAndPicture.md index 8ee351e7c155a9..f5d980a94652e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_TextAndPicture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_TextAndPicture.md @@ -86,7 +86,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[List Box Header](listbox-header-footer.md#headers) +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) #### コマンド @@ -171,7 +171,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Button](button_overview.md) (all styles except [Help](button_overview.md#help)) - [Check Box](checkbox_overview.md) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) +[ボタン](button_overview.md) ([ヘルプ](button_overview.md#ヘルプ)ボタンを除く) - [チェックボックス](checkbox_overview.md) - [リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - [ラジオボタン](radio_overview.md) #### コマンド @@ -300,7 +300,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Toolbar Button](button_overview.md#toolbar) - [Bevel Button](button_overview.md#bevel) - [Rounded Bevel Button](button_overview.md#rounded-bevel) - [OS X Gradient Button](button_overview.md#os-x-gradient) - [OS X Textured Button](button_overview.md#os-x-textured) - [Office XP Button](button_overview.md#office-xp) - [Custom](button_overview.md#custom) +[ツールバーボタン](button_overview.md#ツールバー) - [ベベルボタン](button_overview.md#ベベル) - [角の丸いべべルボタン](button_overview.md#角の丸いベベル) - [OS X グラデーションボタン](button_overview.md#os-x-グラデーション) - [OS X テクスチャーボタン](button_overview.md#os-x-テクスチャー) - [Office XP ボタン](button_overview.md#office-xp) - [カスタムボタン](button_overview.md#カスタム) #### コマンド 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 06265dd125789f..5c9346ec9f140d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -13,12 +13,13 @@ title: リリースノート - 4D Write Pro は[階層リストスタイルシート](../WritePro/user-legacy/stylesheets.md#hierarchical-list-style-sheets) サポートするようになり、これにより自動ナンバリングつきの、構造化された[マルチレベルのリスト](../WritePro/user-legacy/using-a-4d-write-pro-area.md#multi-level-lists) の作成と管理が可能になりました。 - [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) および [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew) クラスにおいて、ローカル証明書フォルダの代わりにmacOS キーチェーンからのカスタムの証明書を使用できるようになりました。 - テキストソースから4D メソッドを作成し実行するための[`4D.Method` クラス](../API/MethodClass.md)。 [`METHOD Get path`](../commands/method-get-path) および [`METHOD RESOLVE PATH`](../commands/method-resolve-path) コマンドは新しい`path volatile method` 定数 (128) をサポートするようになりました。 -- IMAP transporter now supports mailbox event notifications using the IDLE protocol through a [notifier object](../API/IMAPTransporterClass.md#notifier) of the [4D.IMAPNotifier](../API/IMAPNotifierClass.md) class, configurable via the `listener` property of [IMAP New transporter](../commands/imap-new-transporter). +- IMAP transporter は、[4D.IMAPNotifier](../API/IMAPNotifierClass.md) クラスの、[notifier オブジェクト](../API/IMAPTransporterClass.md#notifier) を通して、IDLE プロトコルを使用したメールボックスイベント通知イベントをサポートするようになりました。またこのクラスは [IMAP New transporter](../commands/imap-new-transporter) の `listener` プロパティを通して設定することができます。 - リモートの[session](../API/SessionClass.md) オブジェクトは、[クライアント側でも利用可能](../Desktop/sessions.md#availability) になりました。 -- New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. -- 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). -- Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. -- Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). +- 新しい[データベース設定の新しい **AI** ページ](../settings/ai.md) を使うことで、4D AIKit コンポーネントを使用したコード内から呼び出し可能な、 [プロバイダーモデルエイリアス](../aikit/provider-model-aliases.md) を設定することができるようになりました。 +- 4D AIKit コンポーネント: 新しい[Providers](../aikit/Classes/OpenAIProviders.md) クラスを使用して [プロバイダーとモデルエイリアス](../aikit/provider-model-aliases.md) をインスタンス化して管理することができます。 +- ORDA データモデル関数および共有/セッションシングルトン関数における [`server` キーワード](../Concepts/classes.md#server) のサポート。 +- Liquid glass および Fluent UI インターフェースのフォーム用の新しい[印刷レンダラー](../FormEditor/forms.md#印刷レンダリングエンジン)。 [クラシックインターフェースのレンダラーを有効化する](../FormEditor/forms.md#旧式印刷レンダラー) ための新しい互換性オプション。 +- 依存関係: [GitLab レポジトリ上に保存されたコンポーネント](../Project/components.md#configuring-a-gitlab-repository) のサポート。 - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=21_R3): 4D 21 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 #### macOS におけるLiquid glass のサポート @@ -32,8 +33,8 @@ title: リリースノート - [`JSON Validate`](../commands/json-validate) コマンドは *$schema* キーを考慮するようになり、スキーマ内でサポートされていないバージョンが宣言されたときにはエラーを生成するようになりました。 - 分かりやすさのために、フォーミュラオブジェクトは、汎用的な [`4D.Function`](../API/FunctionClass.md) クラスを継承する [`4D.Formula`](../API/FormulaClass.md) クラスの新しいインスタンスになりました。 - 4D 21 R3 では、[コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー) にもたらされた新しい改良が、ランゲージコマンドに対しても適用されます([こちらのblog 記事](https://blog.4d.com/enhancement-of-command-syntax-checking-in-the-editor)を参照してください)。 以前は検知されなかったシンタックスエラーがコード内でフラグ付けされるようになりました。 -- [設定ダイアログボックス](../settings/overview.md) から、"PHP" ページが削除されました。 Use the [PHP selectors with the `SET DATABASE PARAMETER`](../commands/set-database-parameter#php-interpreter-ip-address-55) command to configure a PHP interpreter. -- The **Legacy** network layer is no longer supported. 旧式ネットワークレイヤーを使用していたプロジェクトまたはバイナリーデータベースは、4D 21 R3 以降にアップグレードした際に自動的に[**ServerNet**](../settings/client-server.md#ネットワークレイヤー) へと設定されます。 +- [設定ダイアログボックス](../settings/overview.md) から、"PHP" ページが削除されました。 PHP インタープリターを設定するためには、[`SET DATABASE PARAMETER` のPHP セレクター](../commands/set-database-parameter#php-interpreter-ip-address-55) を使用してください。 +- \**旧式* ネットワークレイヤーはサポートされなくなりました。 旧式ネットワークレイヤーを使用していたプロジェクトまたはバイナリーデータベースは、4D 21 R3 以降にアップグレードした際に自動的に[**ServerNet**](../settings/client-server.md#ネットワークレイヤー) へと設定されます。 ## 4D 21 R2 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/client-server-optimization.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/client-server-optimization.md index 48d3ec1a2a1235..15af0cc9863e7a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/client-server-optimization.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/client-server-optimization.md @@ -143,13 +143,13 @@ title: クライアント/サーバーの最適化 ### `local` キーワードの使用 -By default, [ORDA data model functions](../ORDA/ordaClasses.md) are executed on the server, which usually provides the best performance since only the function request and the result are sent over the network. However, it could happen that a function processes data that's already in the local cache and is fully executable on the client side. In this case, you can save requests to the server and thus, enhance the application performance by [using the `local` keyword in the function definition](../Concepts/classes.md#local). +デフォルトで、[ORDA データモデル関数](../ORDA/ordaClasses.md) はサーバー上で実行されます。これは関数リクエストと結果のみがネットワーク越しで送信されるため、一般的にはベストパフォーマンスを提供するとされています。 しかしながら、関数がローカルキャッシュ内に既にあるデータを処理するために、クライアント側だけで完全に完結可能な場合もあります。 この場合、[関数定義内で `local` キーワードを使用する](../Concepts/classes.md#local) ことによって、サーバーへのリクエスト回数をおさえ、結果としてアプリケーションのパフォーマンスを改善することができます。 最終的にサーバーへのアクセスが必要になっても (ORDAキャッシュが有効期限切れになった場合など) 関数は動作します。 もっとも、それではローカル実行によるパフォーマンスの向上は見込めないため、ローカル関数がサーバー上のデータにアクセスしないことを確認しておくことが推奨されます。 サーバーに対して複数のリクエストをおこなうローカル関数は、サーバー上で実行されて結果だけを返す関数よりも非効率的です。 たとえば、Schools Entityクラスの次の関数を考えます: ```4d -// Get the youngest students -// Inappropriate use of local keyword +// 最も若い生徒を取得する +// local キーワードの不適切な使用例 local Function getYoungest() : Object return This.students.query("birthDate >= :1"; !2000-01-01!).orderBy("birthDate desc").slice(0; 5) ``` @@ -157,7 +157,7 @@ local Function getYoungest() : Object - `local` キーワードを **使わない** 場合、1つのリクエストで結果が得られます。 - `local` キーワードを **使う** 場合、4つのリクエストが必要になります: Schools エンティティの students エンティティセレクションの取得、`query()` の実行、`orderBy()` の実行、`slice()` の実行。 この例では、`local` キーワードを使用するのは適切ではありません。 -#### Example: Checking attributes +#### 例: 属性のチェック クライアントにロードされ、ユーザーによって更新されたエンティティの属性について、サーバーへ保存リクエストを出すまえに、それらの一貫性を検査します。 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 04507178bdf936..d83c25fad24b1f 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 @@ -48,7 +48,7 @@ title: エンティティイベント :::note -ORDA [`constructor()`](./ordaClasses.md#class-constructor) functions are always executed locally. +ORDA [`constructor()`](./ordaClasses.md#class-constructor) 関数は必ずローカルで実行されます。 ::: @@ -58,7 +58,7 @@ ORDA [`constructor()`](./ordaClasses.md#class-constructor) functions are always 以下の表は、ORDA イベントの一覧とそのルールをまとめたものです。 -| イベント | レベル | 関数名 | (C/S) Execution | エラーを返すことでアクションを停止できる | +| イベント | レベル | 関数名 | (C/S の場合) 実行される場所 | エラーを返すことでアクションを停止できる | | :------------------------------------ | :----- | :------------------------------------------------------ | :----------------------------------------------: | -------------------- | | エンティティのインスタンス化 | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | ローカル | × | | 属性がタッチされた | 属性 | `event touched ()` | [`local`](../Concepts/classes.md#local) キーワードによる | × | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png new file mode 100644 index 00000000000000..7cbec84055b1d3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png new file mode 100644 index 00000000000000..d78a6f5f3c1a48 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png new file mode 100644 index 00000000000000..95e6603575d8a3 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png new file mode 100644 index 00000000000000..5b09f52d9fa16c Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png differ 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 c01d15e195f70a..19be2ac27b1f06 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -5,23 +5,29 @@ title: 互換性ページ 互換性ページには、以前の 4Dバージョンとの互換性を管理するためのパラメーターがまとめられています。 -> 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。 -> このページでは、v18以降のバージョンから変換された 4Dデータベース/プロジェクトで利用可能な互換性オプションのみを説明します。 それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 +:::note -- **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: +- 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。 +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: - 最初の "/" はルートノードに限らない - "/" を XPath 式の最初の文字として使用しても、ルートノードからの絶対パスの宣言にはなりません。 - 暗示的なカレントノードはなし - カレントノードは XPath 式の中に含められていなければなりません。 - 繰り返された構造内の再帰的な検索は不可 - 最初の要素のみが解析されます。 - 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 その一方で、これらの非標準の実装をコード内で使用しておらず、拡張された XPath 機能 ([DOM Find XML element](../commands/dom-find-xml-element) コマンドの説明参照) をデータベース内で利用したい場合、この **標準のXPathを使用** オプションが *チェックされている* ことを確認してください。 + 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 その一方で、これらの非標準の実装をコード内で使用しておらず、拡張された XPath 機能 ([DOM Find XML element](../commands/dom-find-xml-element) コマンドの説明参照) をデータベース内で利用したい場合、この **標準のXPathを使用** オプションが *チェックされている* ことを確認してください。 + +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 -- **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 -- **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 -- **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 -- **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_ResizingOptions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_ResizingOptions.md index 12032c3f07fdfd..5cd780d6ae2a47 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_ResizingOptions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_ResizingOptions.md @@ -67,7 +67,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド @@ -97,7 +124,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_Text.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_Text.md index 78e7746760a32b..2916c92958464a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_Text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_Text.md @@ -38,7 +38,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -63,7 +75,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -83,7 +107,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -124,7 +160,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -149,7 +197,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -167,7 +227,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -197,7 +269,21 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Progress Indicators](progressIndicator.md) - [Ruler](ruler.md) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[進捗インジケーター](progressIndicator.md) - +[ルーラー](ruler.md) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -293,7 +379,18 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) (all styles except Regular and Flat) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Header](listbox-header-footer.md#headers) - [List Box Footer](listbox-header-footer.md#footers) - [Radio Button](radio_overview.md) (all styles except Regular and Flat) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) (通常とフラット以外のスタイル) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[ラジオボタン](radio_overview.md) (通常とフラット以外のスタイル) - +[テキストエリア](text.md) #### コマンド @@ -320,7 +417,7 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) +[リストボックス](listbox_overview.md) - [リストボックスカラム](listbox-column.md) - [リストボックスフッター](listbox-header-footer.md#footers) - [リストボックスヘッダー](listbox-header-footer.md#headers) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_TextAndPicture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_TextAndPicture.md index 25e5e15749761b..64716fbb391759 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_TextAndPicture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R2/FormObjects/properties_TextAndPicture.md @@ -86,7 +86,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[List Box Header](listbox-header-footer.md#headers) +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) #### コマンド @@ -171,7 +171,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Button](button_overview.md) (all styles except [Help](button_overview.md#help)) - [Check Box](checkbox_overview.md) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) +[ボタン](button_overview.md) ([ヘルプ](button_overview.md#ヘルプ)ボタンを除く) - [チェックボックス](checkbox_overview.md) - [リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - [ラジオボタン](radio_overview.md) #### コマンド @@ -300,7 +300,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Toolbar Button](button_overview.md#toolbar) - [Bevel Button](button_overview.md#bevel) - [Rounded Bevel Button](button_overview.md#rounded-bevel) - [OS X Gradient Button](button_overview.md#os-x-gradient) - [OS X Textured Button](button_overview.md#os-x-textured) - [Office XP Button](button_overview.md#office-xp) - [Custom](button_overview.md#custom) +[ツールバーボタン](button_overview.md#ツールバー) - [ベベルボタン](button_overview.md#ベベル) - [角の丸いべべルボタン](button_overview.md#角の丸いベベル) - [OS X グラデーションボタン](button_overview.md#os-x-グラデーション) - [OS X テクスチャーボタン](button_overview.md#os-x-テクスチャー) - [Office XP ボタン](button_overview.md#office-xp) - [カスタムボタン](button_overview.md#カスタム) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md index d3a57ce3e53bc6..3260cd04078a5a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md @@ -66,6 +66,47 @@ title: Forms } ``` +## Printing forms + +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +### 印刷レンダリングエンジン + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip 関連したblog 記事 + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning 制限 + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ## プロジェクトフォームとテーブルフォーム 2つのカテゴリーのフォームが存在します: @@ -78,7 +119,7 @@ title: Forms ## フォームのページ -各フォームは、少なくとも 2つのページで構成されています: +Each form is made of at least two pages: - ページ1: デフォルトで表示されるメインページ - ページ0: 背景ページ。このページ上に置かれたオブジェクトはすべてのページで表示されます diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_ResizingOptions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_ResizingOptions.md index 84afe846266ac9..db4055de8c06bd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_ResizingOptions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_ResizingOptions.md @@ -67,7 +67,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド @@ -97,7 +124,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_Text.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_Text.md index bb99064225ab9f..67b977cfaf67e6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_Text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_Text.md @@ -38,7 +38,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -63,7 +75,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -83,7 +107,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -124,7 +160,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -149,7 +197,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -167,7 +227,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -197,7 +269,21 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Progress Indicators](progressIndicator.md) - [Ruler](ruler.md) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[進捗インジケーター](progressIndicator.md) - +[ルーラー](ruler.md) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -293,7 +379,18 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) (all styles except Regular and Flat) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Header](listbox-header-footer.md#headers) - [List Box Footer](listbox-header-footer.md#footers) - [Radio Button](radio_overview.md) (all styles except Regular and Flat) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) (通常とフラット以外のスタイル) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[ラジオボタン](radio_overview.md) (通常とフラット以外のスタイル) - +[テキストエリア](text.md) #### コマンド @@ -320,7 +417,7 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) +[リストボックス](listbox_overview.md) - [リストボックスカラム](listbox-column.md) - [リストボックスフッター](listbox-header-footer.md#footers) - [リストボックスヘッダー](listbox-header-footer.md#headers) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_TextAndPicture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_TextAndPicture.md index 8ee351e7c155a9..f5d980a94652e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_TextAndPicture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/FormObjects/properties_TextAndPicture.md @@ -86,7 +86,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[List Box Header](listbox-header-footer.md#headers) +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) #### コマンド @@ -171,7 +171,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Button](button_overview.md) (all styles except [Help](button_overview.md#help)) - [Check Box](checkbox_overview.md) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) +[ボタン](button_overview.md) ([ヘルプ](button_overview.md#ヘルプ)ボタンを除く) - [チェックボックス](checkbox_overview.md) - [リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - [ラジオボタン](radio_overview.md) #### コマンド @@ -300,7 +300,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Toolbar Button](button_overview.md#toolbar) - [Bevel Button](button_overview.md#bevel) - [Rounded Bevel Button](button_overview.md#rounded-bevel) - [OS X Gradient Button](button_overview.md#os-x-gradient) - [OS X Textured Button](button_overview.md#os-x-textured) - [Office XP Button](button_overview.md#office-xp) - [Custom](button_overview.md#custom) +[ツールバーボタン](button_overview.md#ツールバー) - [ベベルボタン](button_overview.md#ベベル) - [角の丸いべべルボタン](button_overview.md#角の丸いベベル) - [OS X グラデーションボタン](button_overview.md#os-x-グラデーション) - [OS X テクスチャーボタン](button_overview.md#os-x-テクスチャー) - [Office XP ボタン](button_overview.md#office-xp) - [カスタムボタン](button_overview.md#カスタム) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md index 06265dd125789f..5c9346ec9f140d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md @@ -13,12 +13,13 @@ title: リリースノート - 4D Write Pro は[階層リストスタイルシート](../WritePro/user-legacy/stylesheets.md#hierarchical-list-style-sheets) サポートするようになり、これにより自動ナンバリングつきの、構造化された[マルチレベルのリスト](../WritePro/user-legacy/using-a-4d-write-pro-area.md#multi-level-lists) の作成と管理が可能になりました。 - [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) および [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew) クラスにおいて、ローカル証明書フォルダの代わりにmacOS キーチェーンからのカスタムの証明書を使用できるようになりました。 - テキストソースから4D メソッドを作成し実行するための[`4D.Method` クラス](../API/MethodClass.md)。 [`METHOD Get path`](../commands/method-get-path) および [`METHOD RESOLVE PATH`](../commands/method-resolve-path) コマンドは新しい`path volatile method` 定数 (128) をサポートするようになりました。 -- IMAP transporter now supports mailbox event notifications using the IDLE protocol through a [notifier object](../API/IMAPTransporterClass.md#notifier) of the [4D.IMAPNotifier](../API/IMAPNotifierClass.md) class, configurable via the `listener` property of [IMAP New transporter](../commands/imap-new-transporter). +- IMAP transporter は、[4D.IMAPNotifier](../API/IMAPNotifierClass.md) クラスの、[notifier オブジェクト](../API/IMAPTransporterClass.md#notifier) を通して、IDLE プロトコルを使用したメールボックスイベント通知イベントをサポートするようになりました。またこのクラスは [IMAP New transporter](../commands/imap-new-transporter) の `listener` プロパティを通して設定することができます。 - リモートの[session](../API/SessionClass.md) オブジェクトは、[クライアント側でも利用可能](../Desktop/sessions.md#availability) になりました。 -- New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. -- 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). -- Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. -- Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). +- 新しい[データベース設定の新しい **AI** ページ](../settings/ai.md) を使うことで、4D AIKit コンポーネントを使用したコード内から呼び出し可能な、 [プロバイダーモデルエイリアス](../aikit/provider-model-aliases.md) を設定することができるようになりました。 +- 4D AIKit コンポーネント: 新しい[Providers](../aikit/Classes/OpenAIProviders.md) クラスを使用して [プロバイダーとモデルエイリアス](../aikit/provider-model-aliases.md) をインスタンス化して管理することができます。 +- ORDA データモデル関数および共有/セッションシングルトン関数における [`server` キーワード](../Concepts/classes.md#server) のサポート。 +- Liquid glass および Fluent UI インターフェースのフォーム用の新しい[印刷レンダラー](../FormEditor/forms.md#印刷レンダリングエンジン)。 [クラシックインターフェースのレンダラーを有効化する](../FormEditor/forms.md#旧式印刷レンダラー) ための新しい互換性オプション。 +- 依存関係: [GitLab レポジトリ上に保存されたコンポーネント](../Project/components.md#configuring-a-gitlab-repository) のサポート。 - [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=21_R3): 4D 21 R3 で修正されたバグのリストです ([日本語版はこちら](https://4d-jp.github.io/2023/269/release-note-version-20r3/))。 #### macOS におけるLiquid glass のサポート @@ -32,8 +33,8 @@ title: リリースノート - [`JSON Validate`](../commands/json-validate) コマンドは *$schema* キーを考慮するようになり、スキーマ内でサポートされていないバージョンが宣言されたときにはエラーを生成するようになりました。 - 分かりやすさのために、フォーミュラオブジェクトは、汎用的な [`4D.Function`](../API/FunctionClass.md) クラスを継承する [`4D.Formula`](../API/FormulaClass.md) クラスの新しいインスタンスになりました。 - 4D 21 R3 では、[コードライブチェッカー](../code-editor/write-class-method.md#警告とエラー) にもたらされた新しい改良が、ランゲージコマンドに対しても適用されます([こちらのblog 記事](https://blog.4d.com/enhancement-of-command-syntax-checking-in-the-editor)を参照してください)。 以前は検知されなかったシンタックスエラーがコード内でフラグ付けされるようになりました。 -- [設定ダイアログボックス](../settings/overview.md) から、"PHP" ページが削除されました。 Use the [PHP selectors with the `SET DATABASE PARAMETER`](../commands/set-database-parameter#php-interpreter-ip-address-55) command to configure a PHP interpreter. -- The **Legacy** network layer is no longer supported. 旧式ネットワークレイヤーを使用していたプロジェクトまたはバイナリーデータベースは、4D 21 R3 以降にアップグレードした際に自動的に[**ServerNet**](../settings/client-server.md#ネットワークレイヤー) へと設定されます。 +- [設定ダイアログボックス](../settings/overview.md) から、"PHP" ページが削除されました。 PHP インタープリターを設定するためには、[`SET DATABASE PARAMETER` のPHP セレクター](../commands/set-database-parameter#php-interpreter-ip-address-55) を使用してください。 +- \**旧式* ネットワークレイヤーはサポートされなくなりました。 旧式ネットワークレイヤーを使用していたプロジェクトまたはバイナリーデータベースは、4D 21 R3 以降にアップグレードした際に自動的に[**ServerNet**](../settings/client-server.md#ネットワークレイヤー) へと設定されます。 ## 4D 21 R2 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/client-server-optimization.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/client-server-optimization.md index 48d3ec1a2a1235..15af0cc9863e7a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/client-server-optimization.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/client-server-optimization.md @@ -143,13 +143,13 @@ title: クライアント/サーバーの最適化 ### `local` キーワードの使用 -By default, [ORDA data model functions](../ORDA/ordaClasses.md) are executed on the server, which usually provides the best performance since only the function request and the result are sent over the network. However, it could happen that a function processes data that's already in the local cache and is fully executable on the client side. In this case, you can save requests to the server and thus, enhance the application performance by [using the `local` keyword in the function definition](../Concepts/classes.md#local). +デフォルトで、[ORDA データモデル関数](../ORDA/ordaClasses.md) はサーバー上で実行されます。これは関数リクエストと結果のみがネットワーク越しで送信されるため、一般的にはベストパフォーマンスを提供するとされています。 しかしながら、関数がローカルキャッシュ内に既にあるデータを処理するために、クライアント側だけで完全に完結可能な場合もあります。 この場合、[関数定義内で `local` キーワードを使用する](../Concepts/classes.md#local) ことによって、サーバーへのリクエスト回数をおさえ、結果としてアプリケーションのパフォーマンスを改善することができます。 最終的にサーバーへのアクセスが必要になっても (ORDAキャッシュが有効期限切れになった場合など) 関数は動作します。 もっとも、それではローカル実行によるパフォーマンスの向上は見込めないため、ローカル関数がサーバー上のデータにアクセスしないことを確認しておくことが推奨されます。 サーバーに対して複数のリクエストをおこなうローカル関数は、サーバー上で実行されて結果だけを返す関数よりも非効率的です。 たとえば、Schools Entityクラスの次の関数を考えます: ```4d -// Get the youngest students -// Inappropriate use of local keyword +// 最も若い生徒を取得する +// local キーワードの不適切な使用例 local Function getYoungest() : Object return This.students.query("birthDate >= :1"; !2000-01-01!).orderBy("birthDate desc").slice(0; 5) ``` @@ -157,7 +157,7 @@ local Function getYoungest() : Object - `local` キーワードを **使わない** 場合、1つのリクエストで結果が得られます。 - `local` キーワードを **使う** 場合、4つのリクエストが必要になります: Schools エンティティの students エンティティセレクションの取得、`query()` の実行、`orderBy()` の実行、`slice()` の実行。 この例では、`local` キーワードを使用するのは適切ではありません。 -#### Example: Checking attributes +#### 例: 属性のチェック クライアントにロードされ、ユーザーによって更新されたエンティティの属性について、サーバーへ保存リクエストを出すまえに、それらの一貫性を検査します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/orda-events.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/orda-events.md index 04507178bdf936..d83c25fad24b1f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/orda-events.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/ORDA/orda-events.md @@ -48,7 +48,7 @@ title: エンティティイベント :::note -ORDA [`constructor()`](./ordaClasses.md#class-constructor) functions are always executed locally. +ORDA [`constructor()`](./ordaClasses.md#class-constructor) 関数は必ずローカルで実行されます。 ::: @@ -58,7 +58,7 @@ ORDA [`constructor()`](./ordaClasses.md#class-constructor) functions are always 以下の表は、ORDA イベントの一覧とそのルールをまとめたものです。 -| イベント | レベル | 関数名 | (C/S) Execution | エラーを返すことでアクションを停止できる | +| イベント | レベル | 関数名 | (C/S の場合) 実行される場所 | エラーを返すことでアクションを停止できる | | :------------------------------------ | :----- | :------------------------------------------------------ | :----------------------------------------------: | -------------------- | | エンティティのインスタンス化 | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | ローカル | × | | 属性がタッチされた | 属性 | `event touched ()` | [`local`](../Concepts/classes.md#local) キーワードによる | × | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md index c01d15e195f70a..19be2ac27b1f06 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md @@ -5,23 +5,29 @@ title: 互換性ページ 互換性ページには、以前の 4Dバージョンとの互換性を管理するためのパラメーターがまとめられています。 -> 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。 -> このページでは、v18以降のバージョンから変換された 4Dデータベース/プロジェクトで利用可能な互換性オプションのみを説明します。 それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 +:::note -- **標準のXPathを使用:** デフォルトでは、v18 R3 より前のバージョンの 4D から変換されたデータベースではチェックが外されており、4D v18 R3 以降で作成されたデータベースではチェックされています。 v18 R3 以降、4D の XPath 実装は、より多くの述語に対応しサポートするために変更されました。 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: +- 表示されるオプションの数は、元のデータベース/プロジェクトが作成されたバージョンや、そのデータベース/プロジェクトでおこなわれた設定の変更により異なります。 +- This page lists the compatibility options available for database/projects converted from 4D 18 onwards. それ以前のバージョンから引引き継がれる互換性オプションについては **doc.4d.com** の [互換性ページ](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.ja.html) を参照ください。 + +::: + +- **Use standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 結果的に、以前の標準でない一部の機能は動作しなくなります。 これには以下のような機能が含まれます: - 最初の "/" はルートノードに限らない - "/" を XPath 式の最初の文字として使用しても、ルートノードからの絶対パスの宣言にはなりません。 - 暗示的なカレントノードはなし - カレントノードは XPath 式の中に含められていなければなりません。 - 繰り返された構造内の再帰的な検索は不可 - 最初の要素のみが解析されます。 - 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 その一方で、これらの非標準の実装をコード内で使用しておらず、拡張された XPath 機能 ([DOM Find XML element](../commands/dom-find-xml-element) コマンドの説明参照) をデータベース内で利用したい場合、この **標準のXPathを使用** オプションが *チェックされている* ことを確認してください。 + 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 標準的なものでなくとも、コードが以前と同じように動くように以前の機能を保ちたい場合もあるかもしれません。その場合、この *チェックを外して* ください。 その一方で、これらの非標準の実装をコード内で使用しておらず、拡張された XPath 機能 ([DOM Find XML element](../commands/dom-find-xml-element) コマンドの説明参照) をデータベース内で利用したい場合、この **標準のXPathを使用** オプションが *チェックされている* ことを確認してください。 + +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 -- **macOSにて改行コードとしてLFを使用する:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降) の新規プロジェクトにおいて、4D は macOS でデフォルトの改行コード (EOL) として CR (xml SAX では CRLF) ではなくラインフィード (LF) をテキストファイルに書き込みます。 以前の 4D のバージョンから変換されたデータベースにおいてこの新しい振る舞いを利用したい場合には、このオプションをチェックしてください。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 R3 for XML files), 4D writes text files without a byte order mark (BOM) by default. 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 -- **Unicodeテキストファイルに書き込んでいる際にデフォルトでBOMを追加しない:** 4D v19 R2 以降 (XMLファイルについては 4D v19 R3 以降)、4D はデフォルトでバイトオーダーマーク (BOM) なしでテキストファイルに書き込みます。 以前のバージョンでは、テキストファイルはデフォルトでBOM 付きで書き込まれていました。 変換されたプロジェクトでこの新しい振る舞いを有効化するには、このオプションを選択します。 [`TEXT TO DOCUMENT`](../commands/text-to-document)、[`Document to text`](../commands/document-to-text)、および [XML SET OPTIONS](../commands/xml-set-options) コマンドの詳細を参照してください。 +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 R4 and higher the **Map NULL values to blank values** field property is unchecked by default when you create fields. このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 -- **フィールド作成時にデフォルトで"ヌル値を空値にマップ"オプションのチェックを外す:** ORDA の仕様により合致するために、4D v19 R4 以降で作成されたデータベースにおいては、フィールド作成時に **ヌル値を空値にマップ** フィールドプロパティがデフォルトでチェックされなくなります。 このオプションにチェックを入れることで、変換されたデータベースにおいてもこのデフォルトの振る舞いを適用することができます ([ORDA](../ORDA/overview.md) で NULL値がサポートされるようになったため、今後は空値ではなく NULL値の使用が推奨されます)。 +- **Non-blocking printing**: Starting with 4D 20 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 your 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`](../commands/close-printing-job) for the printer to be available for the next print job (check previous 4D documentations for more information). -- **ノンブロッキング印刷**: 4D v20 R4以降、各プロセスには独自の印刷設定 (印刷オプション、カレントプリンターなど) を持つようになりました。これにより、複数の印刷ジョブを同時に実行できます。 このオプションをチェックすると、アップグレード変換された 4Dプロジェクトや、バイナリモードから変換されたプロジェクトデータベースで、この新しい機能を有効化できます。 **チェックしない場合**、以前の実装が適用されます: カレントの 4D印刷設定がグローバルに適用され、印刷ジョブ実行中はプリンターが "ビジー" 状態になります。次の印刷ジョブのためにプリンターを利用可能にするには、`CLOSE PRINTING JOB` を呼び出す必要があります (詳細は以前の4Dドキュメントを参照ください)。 +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 -- **ストラクチャーのカラーと座標を個別の catalog_editor.json ファイルに保存する**: 4D 20 R5以降、ストラクチャーエディターでテーブルやフィールドのグラフィカルな表示 (色、位置、順序など) に加えた変更は、catalog_editor.json という個別ファイルに保存されます。このファイルはプロジェクトの [Sourcesフォルダー](../Project/architecture.md#sources) に保存されます。 この新しいファイルアーキテクチャーにより、`catalog.4DCatalog` ファイルは重要なデータベースストラクチャーの変更のみを含むようになるため、VCSアプリケーションでマージの競合を管理しやすくなります。 互換性のため、この機能は以前の 4Dバージョンから変換されたプロジェクトではデフォルトで有効になっていません。有効にするには、このオプションをチェックする必要があります。 この機能が有効になっている場合、ストラクチャーエディターで初めて編集した時に `catalog_editor.json` ファイルが作成されます。 +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_ResizingOptions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_ResizingOptions.md index 5701d4b136cb4b..7b73d7648e758c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_ResizingOptions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_ResizingOptions.md @@ -67,7 +67,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド @@ -97,7 +124,34 @@ title: リサイズオプション #### 対象オブジェクト -[4D View Pro Area](viewProArea_overview.md) - [4D Write Pro Area](writeProArea_overview.md) - [Button](button_overview.md) - [Button Grid](buttonGrid_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Dropdown list](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [Line](shapes_overview.md#line) - [List Box Column](listbox-column.md) - [Oval](shapes_overview.md#oval) - [Picture Button](pictureButton_overview.md) - [Picture Pop up menu](picturePopupMenu_overview.md) - [Plug-in Area](pluginArea_overview.md) - [Progress Indicators](progressIndicator.md) - [Radio Button](radio_overview.md) - [Ruler](ruler.md) - [Rectangle](shapes_overview.md#rectangle) - [Spinner](spinner.md) - [Splitter](splitters.md) - [Static Picture](staticPicture.md) - [Stepper](stepper.md) - [Subform](subform_overview.md) - [Tab control](tabControl.md) - [Web Area](webArea_overview.md) +[4D View Pro エリア](viewProArea_overview.md) - +[4D Write Pro エリア](writeProArea_overview.md) - +[ボタン](button_overview.md) - +[ボタングリッド](buttonGrid_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[線](shapes_overview.md#線) - +[リストボックスカラム](listbox-column.md) - +[楕円](shapes_overview.md#楕円) - +[ピクチャーボタン](pictureButton_overview.md) - +[ピクチャーポップアップメニュー](picturePopupMenu_overview.md) - +[プラグインエリア](pluginArea_overview.md) - +[進捗インジケーター](progressIndicator.md) - +[ラジオボタン](radio_overview.md) - +[ルーラー](ruler.md) - +[四角](shapes_overview.md#四角) - +[スピナー](spinner.md) - +[スプリッター](splitters.md) - +[スタティックピクチャー](staticPicture.md) - +[ステッパー](stepper.md) - +[サブフォーム](subform_overview.md) - +[タブコントロール](tabControl.md) - +[Web エリア](webArea_overview.md) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Text.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Text.md index 78e7746760a32b..2916c92958464a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Text.md @@ -38,7 +38,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -63,7 +75,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -83,7 +107,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -124,7 +160,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -149,7 +197,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -167,7 +227,19 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックス列](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -197,7 +269,21 @@ title: Text #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Hierarchical List](list_overview.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) - [Progress Indicators](progressIndicator.md) - [Ruler](ruler.md) - [Radio Button](radio_overview.md) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[階層リスト](list_overview.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[進捗インジケーター](progressIndicator.md) - +[ルーラー](ruler.md) - +[ラジオボタン](radio_overview.md) - +[テキストエリア](text.md) #### コマンド @@ -293,7 +379,18 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[Button](button_overview.md) - [Check Box](checkbox_overview.md) (all styles except Regular and Flat) - [Combo Box](comboBox_overview.md) - [Drop-down List](dropdownList_Overview.md) - [Group Box](groupBox.md) - [Input](input_overview.md) - [List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Header](listbox-header-footer.md#headers) - [List Box Footer](listbox-header-footer.md#footers) - [Radio Button](radio_overview.md) (all styles except Regular and Flat) - [Text Area](text.md) +[ボタン](button_overview.md) - +[チェックボックス](checkbox_overview.md) (通常とフラット以外のスタイル) - +[コンボボックス](comboBox_overview.md) - +[ドロップダウンリスト](dropdownList_Overview.md) - +[グループボックス](groupBox.md) - +[入力](input_overview.md) - +[リストボックス](listbox_overview.md) - +[リストボックスカラム](listbox-column.md) - +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - +[リストボックスフッター](listbox-header-footer.md#フッター) - +[ラジオボタン](radio_overview.md) (通常とフラット以外のスタイル) - +[テキストエリア](text.md) #### コマンド @@ -320,7 +417,7 @@ Choose([Companies]ID;Bold;Plain;Italic;Underline) #### 対象オブジェクト -[List Box](listbox_overview.md) - [List Box Column](listbox-column.md) - [List Box Footer](listbox-header-footer.md#footers) - [List Box Header](listbox-header-footer.md#headers) +[リストボックス](listbox_overview.md) - [リストボックスカラム](listbox-column.md) - [リストボックスフッター](listbox-header-footer.md#footers) - [リストボックスヘッダー](listbox-header-footer.md#headers) #### コマンド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_TextAndPicture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_TextAndPicture.md index 25e5e15749761b..64716fbb391759 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_TextAndPicture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_TextAndPicture.md @@ -86,7 +86,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[List Box Header](listbox-header-footer.md#headers) +[リストボックスヘッダー](listbox-header-footer.md#ヘッダー) #### コマンド @@ -171,7 +171,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Button](button_overview.md) (all styles except [Help](button_overview.md#help)) - [Check Box](checkbox_overview.md) - [List Box Header](listbox-header-footer.md#headers) - [Radio Button](radio_overview.md) +[ボタン](button_overview.md) ([ヘルプ](button_overview.md#ヘルプ)ボタンを除く) - [チェックボックス](checkbox_overview.md) - [リストボックスヘッダー](listbox-header-footer.md#ヘッダー) - [ラジオボタン](radio_overview.md) #### コマンド @@ -300,7 +300,7 @@ title: テキスト、ピクチャー #### 対象オブジェクト -[Toolbar Button](button_overview.md#toolbar) - [Bevel Button](button_overview.md#bevel) - [Rounded Bevel Button](button_overview.md#rounded-bevel) - [OS X Gradient Button](button_overview.md#os-x-gradient) - [OS X Textured Button](button_overview.md#os-x-textured) - [Office XP Button](button_overview.md#office-xp) - [Custom](button_overview.md#custom) +[ツールバーボタン](button_overview.md#ツールバー) - [ベベルボタン](button_overview.md#ベベル) - [角の丸いべべルボタン](button_overview.md#角の丸いベベル) - [OS X グラデーションボタン](button_overview.md#os-x-グラデーション) - [OS X テクスチャーボタン](button_overview.md#os-x-テクスチャー) - [Office XP ボタン](button_overview.md#office-xp) - [カスタムボタン](button_overview.md#カスタム) #### コマンド 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 ebb3750cf7d01a..722d592ac075b3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -71,8 +71,8 @@ Os formulários também podem conter outros formulários através das seguintes Forms are called using specific commands of the 4D Language. In your 4D desktop applications, forms can be used in various ways, depending on their status within your interface needs. A form can be: - used in its own window for data viewing, processing, editing, or to display on-screen information to the user, -- used as template for printing, - used embedded in another form (subform), +- used as template for printing, - or called by specific features like the Label editor. ### Using a project form in a window @@ -147,6 +147,10 @@ In the same way that you pass an object to a form with the [`DIALOG`](../command ### Using forms to be printed +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +#### Exemplos + You can use forms to print data, either as page or as list. - To simply print some part of a form, use the [`Print form`](../commands/print-form) command. Por exemplo: @@ -184,6 +188,43 @@ var $h:=Print form("Request_var";$formData;Form detail) CLOSE PRINTING JOB ``` +#### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Related blog post + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +#### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitação + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ### Other form usages There are several other ways to use forms in the 4D applications, including: @@ -204,7 +245,7 @@ Normalmente, você seleciona a categoria do formulário quando o cria, mas pode ## Páginas formulário -Cada formulário é composto por, pelo menos, duas páginas: +Each form is made of at least two pages: - 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. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md index 4b47eefa681737..4d9d05d24fb61a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/properties_Print.md @@ -7,7 +7,7 @@ title: Imprimir Permite definir os parâmetros de impressão específicos para o formulário. Esta funcionalidade é útil para visualizar os limites da página de impressão no editor de formulários. -> **Compatibilidad:** aunque estos parámetros se tengan en cuenta cuando se imprime el formulario en modo Aplicación, se desaconseja confiar en esta funcionalidad para almacenar los parámetros de impresión del formulario, debido a las limitaciones relativas Es muy recomendable utilizar los comandos 4D `Print settings to BLOB`/`BLOB to print settings` que son más poderosos. +> **Compatibilidad:** aunque estos parámetros se tengan en cuenta cuando se imprime el formulario en modo Aplicación, se desaconseja confiar en esta funcionalidad para almacenar los parámetros de impresión del formulario, debido a las limitaciones relativas It is highly recommended to use the 4D commands [`Print settings to BLOB`](../commands/print-settings-to-blob)/[`BLOB to print settings`](../commands/blob-to-print-settings) which are more powerful. Pode modificar os seguintes parâmetros de impressão: 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 b1307dd17c0497..cf1d39d1674b03 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -18,6 +18,7 @@ Leia [**O que há de novo no 4D v21 R3**](https://blog.4d.com/whats-new-in-4d-21 - New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. - 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). - Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=21_R3): lista de todos os bugs corrigidos em 4D 21 R3. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png new file mode 100644 index 00000000000000..7cbec84055b1d3 Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print1.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png new file mode 100644 index 00000000000000..d78a6f5f3c1a48 Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/form-print2.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png new file mode 100644 index 00000000000000..95e6603575d8a3 Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection1.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png new file mode 100644 index 00000000000000..5b09f52d9fa16c Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/current/assets/en/commands/print-selection2.png differ 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 8d5fb3d290185b..4d7d3f3d98e6c9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/settings/compatibility.md @@ -5,23 +5,29 @@ title: Página de compatibilidade Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a manutenção da compatibilidade com versões anteriores do 4D. -> 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**. +:::note -- **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: +- O número de opções exibidas depende da versão 4D com a qual o banco de dados/projeto original foi criado. bem como as configurações modificadas neste banco de dados/projeto. +- This page lists the compatibility options available for database/projects converted from 4D 18 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 standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 - não há pesquisa recursiva em estruturas repetidas - apenas o primeiro elemento é analisado.\ - 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/dom-find-xml-element) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. + Embora não seja padrão, você pode querer continuar usando essas funções para que seu código continue a funcionar como antes -- nesse caso, apenas defina a opção *desmarcada*. 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/dom-find-xml-element) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. + +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). -- **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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). -- **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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 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 20 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 your 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`](../commands/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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nova arquitetura de arquivos torna mais fácil gerenciar conflitos de merge em aplicações VCS desde o arquivo `catalog.4DCatalog` agora contém apenas alterações cruciais na estrutura da base de dados. Por razões de compatibilidade, este recurso não está habilitado por padrão em projetos convertidos de versões 4D anteriores, você precisa marcar esta opção. Quando o recurso estiver ativado, o arquivo `catalog_editor.json` é criado na primeira modificação no editor de estruturas. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R2/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R2/settings/compatibility.md index bb202f65a5dfe4..abfe89ae829b58 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R2/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R2/settings/compatibility.md @@ -5,7 +5,7 @@ title: Página de compatibilidade Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a manutenção da compatibilidade com versões anteriores do 4D. -> 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. +> O número de opções exibidas depende da versão 4D com a qual o banco de dados/projeto original foi criado. bem como as configurações modificadas neste banco de dados/projeto. > 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. @@ -17,7 +17,7 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m - não há nó atual implícito - o nó atual tem que ser incluído na expressão XPath - não há pesquisa recursiva em estruturas repetidas - apenas o primeiro elemento é analisado.\ - 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*. + Embora não seja padrão, você pode querer continuar usando essas funções para que seu código continue a funcionar como antes -- nesse caso, apenas defina a opção *desmarcada*. 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). @@ -27,4 +27,4 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m - **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 nova arquitetura de arquivos torna mais fácil gerenciar conflitos de merge em aplicações VCS desde o arquivo `catalog.4DCatalog` agora contém apenas alterações cruciais na estrutura da base de dados. Por razões de compatibilidade, este recurso não está habilitado por padrão em projetos convertidos de versões 4D anteriores, você precisa marcar esta opção. Quando o recurso estiver ativado, o arquivo `catalog_editor.json` é criado na primeira modificação no editor de estruturas. \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md index 2a288a49a433af..3c047e706fb262 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/FormEditor/forms.md @@ -66,6 +66,47 @@ Os formulários também podem conter outros formulários através das seguintes } ``` +## Printing forms + +In 4D desktop applications, forms can be printed using the various [commands of the **Printing** theme](../commands/theme/Printing). + +### Print rendering engine + +4D uses a dedicated print rendering engine to generate outputs with a design adapted for printing. It includes the following main features: + +- Interactive widgets such as buttons, toggles, dropdowns, etc. and modern UI effects such as glass, blur, transparency, or shadow effects are converted into adapted static representations and flattened into printable styles, so that the document remains readable and professional once printed. +- Layout structure, spacing, and alignment, are preserved so that the printed document reflects the logical structure of the on-screen form. +- The same output is produced, whether the form is printed from macOS or Windows. + +For example, the following form: + +![](../assets/en/FormEditor/screen_rendering.png) + +... will be printed with this rendering: + +![](../assets/en/FormEditor/print_rendering.png) + +:::tip Related blog post + +[Printing Modern Interfaces with Clean, Consistent Output](https://blog.4d.com/printing-modern-interfaces-with-clean-consistent-output) + +::: + +### Legacy print renderer + +In releases prior to 4D 21 R3, another print renderer was used. This legacy renderer simply draws widgets as they appear on the screen. For compatibility, the legacy renderer is **enabled by default** in projects or databases converted from versions prior to 4D 21 R3, so that forms designed with this renderer continue to be printed as expected. + +You can however enable the modern print rendering engine at any moment by: + +- unchecking the **Use legacy print rendering** option in the [Compatibility page of the Settings dialog box](../settings/compatibility.md) (permanent setting), +- or executing [`SET DATABASE PARAMETER`](../commands/set-database-parameter) command with `Use legacy print rendering` selector set to 1 (volatile setting). + +:::warning Limitação + +For technical reasons, the legacy print renderer is not available with forms displayed with [Fluent UI](#fluent-ui-rendering) on Windows or [Liquid Glass](../Notes/updates.md#support-of-liquid-glass-on-macos) on macOS. In these contexts, forms are **always printed with the modern print rendering engine**, whatever the compatibility option. + +::: + ## Formulário projeto e formulário tabela Existem duas categorias de formulários: @@ -78,7 +119,7 @@ Normalmente, você seleciona a categoria do formulário quando o cria, mas pode ## Páginas formulário -Cada formulário é composto por, pelo menos, duas páginas: +Each form is made of at least two pages: - 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. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md index b1307dd17c0497..cf1d39d1674b03 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Notes/updates.md @@ -18,6 +18,7 @@ Leia [**O que há de novo no 4D v21 R3**](https://blog.4d.com/whats-new-in-4d-21 - New [**AI** page in Settings](../settings/ai.md), allowing to configure [Provider model aliases](../aikit/provider-model-aliases.md) that can be called in the code using 4D AIKit component. - 4D AIKit component: new [Providers](../aikit/Classes/OpenAIProviders.md) class to instantiate and handle [Provider and model aliases](../aikit/provider-model-aliases.md). - Support of [`server` keyword](../Concepts/classes.md#server) for ORDA data model functions and shared/session singleton functions. +- New [printing renderer](../FormEditor/forms.md#print-rendering-engine) for forms on Liquid glass and Fluent UI interfaces. New compatibility options to [enable the renderer on Classic interfaces](../FormEditor/forms.md#legacy-print-renderer). - Dependencies: support of [components stored on GitLab repositories](../Project/components.md#configuring-a-gitlab-repository). - [**Lista de erros corrigida**](https://bugs.4d.fr/fixedbugslist?version=21_R3): lista de todos os bugs corrigidos em 4D 21 R3. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png new file mode 100644 index 00000000000000..d2a28e9dda474d Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/print_rendering.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png new file mode 100644 index 00000000000000..b219623b061d96 Binary files /dev/null and b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/assets/en/FormEditor/screen_rendering.png differ diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md index 8d5fb3d290185b..4d7d3f3d98e6c9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/settings/compatibility.md @@ -5,23 +5,29 @@ title: Página de compatibilidade Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a manutenção da compatibilidade com versões anteriores do 4D. -> 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**. +:::note -- **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: +- O número de opções exibidas depende da versão 4D com a qual o banco de dados/projeto original foi criado. bem como as configurações modificadas neste banco de dados/projeto. +- This page lists the compatibility options available for database/projects converted from 4D 18 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 standard XPath:** By default this option is unchecked for databases converted from a 4D version prior to 18 R3, and checked for databases created with 4D 18 R3 and higher. Starting with 18 R3, the XPath implementation in 4D has been modified to be more compliant and to support more predicates. 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 - não há pesquisa recursiva em estruturas repetidas - apenas o primeiro elemento é analisado.\ - 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/dom-find-xml-element) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. + Embora não seja padrão, você pode querer continuar usando essas funções para que seu código continue a funcionar como antes -- nesse caso, apenas defina a opção *desmarcada*. 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/dom-find-xml-element) comando), certifique-se que a opção **Use XPath** padrão está *marcada*. + +- **Use LF for end of line on macOS:** Starting with 4D 19 R2 (and 4D 19 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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). -- **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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). +- **Don't add a BOM when writing a unicode text file by default:** Starting with 4D 19 R2 (and 4D 19 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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). -- **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. Veja [`TEXT TO DOCUMENT`](../commands/text-to-document), [`Documento ao texto`](../commands/document-to-text), e [XML SET OPTIONS](../commands/xml-set-options). +- **Map NULL values to blank values unchecked by default at field creation**: For better compliance with ORDA specifications, in databases created with 4D 19 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 20 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 your 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`](../commands/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). +- **Save structure color and coordinates in separate catalog_editor.json file**: Starting with 4D 20 R5, changes made in the Structure editor regarding graphical appearance of tables and fields (color, position, order...) são salvos em um arquivo separado chamado `catalog_editor.json`, armazenado na [pasta de códigos](../Project/architecture.md#sources). Esta nova arquitetura de arquivos torna mais fácil gerenciar conflitos de merge em aplicações VCS desde o arquivo `catalog.4DCatalog` agora contém apenas alterações cruciais na estrutura da base de dados. Por razões de compatibilidade, este recurso não está habilitado por padrão em projetos convertidos de versões 4D anteriores, você precisa marcar esta opção. Quando o recurso estiver ativado, o arquivo `catalog_editor.json` é criado na primeira modificação no editor de estruturas. -- **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. +- **Use legacy print rendering**: Starting with 4D 21 R3, 4D uses a new, unified print rendering engine to print forms on macOS and Windows. To make sure forms designed with the [legacy screen-based print renderer](../FormEditor/forms.md#legacy-print-renderer) continue to be printed as expected, this option is checked by default in converted projects or databases created with 4D 21 R2 and before. You can uncheck this option to benefit from the [modern print rendering engine](../FormEditor/forms.md#print-rendering-engine). Note that when forms are rendered under Liquid Glass (macOS) or Fluent UI (Windows) interfaces, this option is ignored: in such contexts forms are always printed using the modern print renderer (see [this section](../../FormEditor/forms.md#legacy-print-rendering)). \ No newline at end of file diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/settings/compatibility.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/settings/compatibility.md index bb202f65a5dfe4..abfe89ae829b58 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/settings/compatibility.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/settings/compatibility.md @@ -5,7 +5,7 @@ title: Página de compatibilidade Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a manutenção da compatibilidade com versões anteriores do 4D. -> 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. +> O número de opções exibidas depende da versão 4D com a qual o banco de dados/projeto original foi criado. bem como as configurações modificadas neste banco de dados/projeto. > 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. @@ -17,7 +17,7 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m - não há nó atual implícito - o nó atual tem que ser incluído na expressão XPath - não há pesquisa recursiva em estruturas repetidas - apenas o primeiro elemento é analisado.\ - 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*. + Embora não seja padrão, você pode querer continuar usando essas funções para que seu código continue a funcionar como antes -- nesse caso, apenas defina a opção *desmarcada*. 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). @@ -27,4 +27,4 @@ Os grupos de páginas de compatibilidade juntam parâmetros relacionados com a m - **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 nova arquitetura de arquivos torna mais fácil gerenciar conflitos de merge em aplicações VCS desde o arquivo `catalog.4DCatalog` agora contém apenas alterações cruciais na estrutura da base de dados. Por razões de compatibilidade, este recurso não está habilitado por padrão em projetos convertidos de versões 4D anteriores, você precisa marcar esta opção. Quando o recurso estiver ativado, o arquivo `catalog_editor.json` é criado na primeira modificação no editor de estruturas. \ No newline at end of file