From 59cbcded261f9d8b8d98c5276c6910282cf41b68 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 16:34:06 +0200 Subject: [PATCH 001/201] New translations clientserver.md (French) --- .../current/Desktop/clientServer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/clientServer.md b/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/clientServer.md index 1217eff7a00779..9ece18d4745892 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/clientServer.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/clientServer.md @@ -128,7 +128,7 @@ Note that [privileges](../ORDA/privileges.md) should be set in the session befor Shared sessions are handled through [OTP tokens](../WebServer/sessions.md#session-token-otp). After you created an OTP token on the server for the user session, you add the token (through the `$4DSID` parameter value) to web requests sent from web areas containing Qodly pages so that the user session on the server is identified and shared. On the web server side, if a web request contains an *OTP id* in the $4DSID parameter, the session corresponding to this OTP token is used. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [Share your 4D remote client session with web accesses](https://blog.4d.com/share-your-4d-remote-client-session-with-web-accesses) From 1d996208916dcefcbc1ff4ab352d1fd9e4d36b16 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 16:48:09 +0200 Subject: [PATCH 002/201] New translations updates.md (French) --- i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 877c7e6e4ec0dd..41d9e35ed7eddf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -44,7 +44,7 @@ Le [rendu **Fluent UI** pour les formulaires 4D](../FormEditor/forms.md#fluent-u - Serveur web : la prise en charge des URLs dépréciés `4DSYNC/` et `4DCGI/` est supprimée. Plus aucun traitement spécifique n'est effectué sur ces URLs. - Les sessions utilisateurs Web sont désormais renvoyées par [`Process activity`](../commands/process-activity.md). - La commande [`HIGHLIGHT TEXT`](../commands/highlight-text) est maintenant prise en charge dans le contexte des sous-formulaires. -- **Les composants ne sont plus intégrés** : à partir de 4D 21, les composants développés par 4D (4D NetKit, 4D SVG..., voir [cette liste](../Extensions/overview-old.md)) ne sont plus intégrés dans l'application 4D. Lors de la mise à jour d'un projet vers 4D 21 ou supérieur, une boîte de dialogue s'affiche :
+- **Les composants ne sont plus intégrés** : à partir de 4D 21, les composants développés par 4D (4D NetKit, 4D SVG..., voir [cette liste](../Extensions/overview.md#components-developed-by-4d)) ne sont plus intégrés dans l'application 4D. Lors de la mise à jour d'un projet vers 4D 21 ou supérieur, une boîte de dialogue s'affiche :
![alt-text](../assets/en/getStart/convert.png)
\- **Import**/**Importer** : importer automatiquement les composants 4D comme dépendances du projet
\- **Ignore**/**Ignorer** : ne pas importer les composants et vous laisser [gérer les composants manuellement](../Project/components.md)
From 45b2ae41e0ab373725c38d1ba4581794ca8dbf45 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 16:48:12 +0200 Subject: [PATCH 003/201] New translations updates.md (Spanish) --- i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 c103e59731fccd..8d14d4fd39ce5a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -44,7 +44,7 @@ Lea [**Novedades en 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), la ent - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. Ya no se realiza ningún tratamiento específico en estas URL. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
+- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
![alt-text](../assets/en/getStart/convert.png)
\- **Import**: import automatically 4D components as dependencies to the project
\- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
From fa1bcc0ebf814ac5e9040c94a8ac826dab065044 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 16:48:15 +0200 Subject: [PATCH 004/201] New translations updates.md (Japanese) --- i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 15a6fe78c32b18..4194cab442f35b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -44,7 +44,7 @@ title: リリースノート - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
+- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
![alt-text](../assets/en/getStart/convert.png)
\- **Import**: import automatically 4D components as dependencies to the project
\- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
From c4b60271e60d465d7488b288ce5e7a5168cb2539 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 16:48:18 +0200 Subject: [PATCH 005/201] New translations updates.md (Portuguese, Brazilian) --- i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 afbf68362b9441..2984e093d3b5a6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -44,7 +44,7 @@ Leia [**O que há de novo no 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/ - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
+- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
![alt-text](../assets/en/getStart/convert.png)
\- **Import**: import automatically 4D components as dependencies to the project
\- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
From 744202afcd30d45805c8b250b08a593429f997d6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 17:06:03 +0200 Subject: [PATCH 006/201] New translations preemptiveweb.md (French) --- .../current/WebServer/preemptiveWeb.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md index a61af9ff781cc8..7395ed0a06637b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/preemptiveWeb.md @@ -44,7 +44,7 @@ Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souh - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; -- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- En principe, tout code traité par la commande [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) dans le contexte du web, par exemple par le biais de pages .shtml - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" From d2351ab026c2d1851a79b152a76d4118edee6666 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 17:06:17 +0200 Subject: [PATCH 007/201] New translations sessions.md (French) --- .../current/WebServer/sessions.md | 110 +++++++++--------- 1 file changed, 55 insertions(+), 55 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md index 3524feb00429dd..6fcb2a97a4df8a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -12,7 +12,7 @@ Les sessions Web permettent de : - stocker et partager des données entre les process d'un client web en utilisant le [.storage](../API/SessionClass.md#storage) de la session, - associer des privilèges à l'utilisateur qui exécute la session. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) @@ -22,7 +22,7 @@ Les sessions Web permettent de : Les sessions Web sont utilisées par : -- [Web applications](gettingStarted.md) sending http requests (including [SOAP Web services](../commands/theme/Web_Services_Server.md) and [/4DACTION](../WebServer/httpRequests.md#4daction) requests), +- les [applications Web](gettingStarted.md) envoyant des requêtes http (y compris les [Web services SOAP](../commands/theme/Web_Services_Server.md) et les requêtes [/4DACTION](../WebServer/httpRequests.md#4daction)), - les appels à l'[API REST](../REST/authUsers.md), qui sont effectués par les [datastores distants](../ORDA/remoteDatastores.md) et les [pages Qodly](qodly-studio.md). ## Activation des sessions web @@ -36,7 +36,7 @@ Cette option est sélectionnée par défaut dans les nouveaux projets. Elle peut - En utilisant la propriété [`.scalableSession`](API/WebServerClass.md#scalablession) de l'objet Web Server (à passer dans le paramètre *settings* de la fonction [`.start()`](API/WebServerClass.md#start) ). Dans ce cas, ce paramètre remplace l'option définie dans la boîte de dialogue Propriétés pour l'objet Web Server (il n'est pas stocké sur disque). -> The [`WEB SET OPTION`](../commands-legacy/web-set-option.md) command can also set the session mode for the main Web server. +> La commande [`WEB SET OPTION`](../commands-legacy/web-set-option.md) peut également définir le mode de session du serveur Web principal. Dans tous les cas, ce paramètre est local à la machine ; il peut donc être différent sur le serveur Web 4D Server et les serveurs Web des machines 4D distantes. @@ -44,7 +44,7 @@ Dans tous les cas, ce paramètre est local à la machine ; il peut donc être di ## Implémentation des sessions -When [sessions are enabled](#enabling-web-sessions), automatic mechanisms are implemented, based upon a private cookie set by 4D itself: "4DSID__AppName_", where *AppName* is the name of the application project. Ce cookie référence la session web courante pour l'application. +Lorsque [les sessions sont activées](#enabling-web-sessions), des mécanismes automatiques sont mis en œuvre, sur la base d'un cookie privé défini par 4D lui-même : "4DSID_*AppName*", où *AppName* est le nom du projet d'application. Ce cookie référence la session web courante pour l'application. :::info @@ -73,7 +73,7 @@ L'objet `Session` de la session en cours peut ensuite être manipulé via la com :::info -Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Since a web process can be reused by any session, [process variables](Concepts/variables.md#process-variables) must be cleared by your code at the end of its execution (using [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) for example). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. +Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Comme un process web peut être réutilisé par n'importe quelle session, les [variables process](Concepts/variables.md#process-variables) doivent être effacées par votre code à la fin de son exécution (en utilisant [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) par exemple). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. ::: @@ -90,7 +90,7 @@ Une session web évolutive est fermée lorsque: La durée de vie d'un cookie inactif est de 60 minutes par défaut, ce qui signifie que le serveur Web fermera automatiquement les sessions inactives après 60 minutes. -This timeout can be set using the [`.idleTimeout`](API/SessionClass.md#idletimeout) property of the `Session` object (the timeout cannot be less than 60 minutes) or the *connectionInfo* parameter of the [`Open datastore`](../commands/open-datastore.md) command. +Ce délai peut être défini en utilisant la propriété [`.idleTimeout`](API/SessionClass.md#idletimeout) de l'objet `Session` (le délai ne peut être inférieur à 60 minutes) ou le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md). Lorsqu'une session web est fermée, si la commande [`Session`](commands/session.md) est appelée par la suite : @@ -159,7 +159,7 @@ http://localhost:8044/authenticate.shtml ![alt-text](../assets/en/WebServer/authenticate.png) -3. La méthode de projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : +3. La méthode projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : ```4d var $indexUserId; $indexPassword; $userId : Integer @@ -203,80 +203,80 @@ End if :::note -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). ::: -## Session Token (OTP) +## Token de session (OTP) -The 4D web server allows you to generate, share, and use OTP (One-Time Passcode) session tokens. OTP session tokens are used to secure communications with third-party applications or websites. For information on OTP, please refer to the [One-time password page](https://en.wikipedia.org/wiki/One-time_password) on Wikipedia. +Le serveur web 4D vous permet de générer, de partager et d'utiliser des tokens de session OTP (One-Time Passcode). Les tokens (ou *jetons*) de session OTP sont utilisés pour sécuriser les communications avec des applications ou des sites web tiers. Pour plus d'informations sur OTP, veuillez vous référer à la page [Mot de passe à usage unique](https://en.wikipedia.org/wiki/One-time_password) sur Wikipedia. -In 4D, OTP session tokens are useful when calling external URLs and being called back in another browser or device (mobile/computer). Typically, a third-party application sends a confirmation email containing a callback link on which the user has to click. The callback link includes the OTP token, so that the session which triggered the callback is loaded along with its data and privileges. This principle allows you to share the same session on multiple devices. Thanks to this architecture, the [session cookie](#session-implementation) is not exposed on the network, which eliminates the risk of man-in-the-middle attack. +Dans 4D, les tokens de session OTP sont utiles pour appeler des URL externes et être rappelé dans un autre navigateur ou appareil (mobile/ordinateur). Généralement, une application tierce envoie un courriel de confirmation contenant un lien de rappel sur lequel l'utilisateur doit cliquer. Le lien de rappel inclut le token OTP, de sorte que la session qui a déclenché le rappel est chargée avec ses données et ses privilèges. Ce principe vous permet de partager la même session sur plusieurs appareils. Grâce à cette architecture, le [cookie de session] (#session-implementation) n'est pas exposé sur le réseau, ce qui élimine le risque d'une attaque de type "man-in-the-middle". :::tips Articles de blog sur le sujet -[Connect Your Web Apps to Third-Party Systems](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/) +[Connectez vos applications Web à des systèmes tiers](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/) ::: ### Vue d’ensemble -The basic sequence of an OTP session token use in a 4D web application is the following: +La séquence de base de l'utilisaton d'un token de session OTP dans une application web 4D est la suivante : -1. The web user initiates an action that requires a secured third-party connection, for example a validation, from within a specific session. -2. In your 4D code, you create a new OTP for the session using the [`Session.createOTP()`](../API/SessionClass.md#createotp) function. -3. You send a request to the third-party application with the session token included in the callback Uri. Note that the way to provide the callback Uri to a third-party application depends on its API (see below). -4. The third-party application sends back a request to 4D with the pattern you provided in the callback Uri. -5. The request callback is processed in your application. +1. L'utilisateur web initie une action qui nécessite une connexion tierce sécurisée, par exemple une validation, à partir d'une session spécifique. +2. Dans votre code 4D, vous créez un nouvel OTP pour la session à l'aide de la fonction [`Session.createOTP()`](../API/SessionClass.md#createotp). +3. Vous envoyez une requête à l'application tierce avec le token de session inclus dans l'Uri de callback (rappel). Notez que la manière de fournir l'Uri de rappel à une application tierce dépend de son API (voir ci-dessous). +4. L'application tierce renvoie une requête à 4D avec le modèle que vous avez fourni dans l'Uri de rappel. +5. Le rappel de la requête est traité dans votre application. -By definition, an OTP token can only be used once. In this scenario, if a web request is received with a session token as parameter that has already been used, the initial session is not restored. +Par définition, un token OTP ne peut être utilisé qu'une seule fois. Dans ce scénario, si une requête web est reçue avec un token de session comme paramètre qui a déjà été utilisé, la session initiale n'est pas restaurée. -### Processing the OTP in the callback +### Traitement de l'OTP dans le callback -Callbacks from third-party applications that include the OTP token can be processed in different ways in your 4D application, depending on your development and the third-party API. Basically, you have two possibilities to handle the token: through the **`$4DSID`** parameter for an automatic processing, or through a custom parameter that you need to process. +Les callbacks d'applications tierces qui incluent le token OTP peuvent être traités de différentes manières dans votre application 4D, en fonction de votre développement et de l'API tierce. En principe, vous avez deux possibilités pour gérer le token : via le paramètre **`$4DSID`** pour un traitement automatique, ou via un paramètre personnalisé que vous devez traiter. -#### Using `$4DSID` in the URL +#### Utilisation de `$4DSID` dans l'URL -Using the `$4DSID` parameter is the most simple way to process a callback from the third-party application: +L'utilisation du paramètre `$4DSID` est la façon la plus simple de traiter un callback de l'application tierce : -- The OTP token is provided as a parameter directly in the callback url using the standard `?$4DSID=XXXX123` syntax. -- In 4D, you implement a dedicated [HTTP Request handler](http-request-handler.md) in your 4D application using [`IncomingMessage`](../API/IncomingMessageClass.md) and [`OutgoingMessage`](../API/OutgoingMessageClass.md) classes. -- If the `$4DSID` token is valid, the related web user session is **automatically restored** in any web process with its storage and privileges. +- Le token OTP est fourni en tant que paramètre directement dans l'url de callback en utilisant la syntaxe standard `?$4DSID=XXXX123`. +- Dans votre application 4D, vous implémentez un [HTTP Request handler](http-request-handler.md) dédié en utilisant les classes [`IncomingMessage`](../API/IncomingMessageClass.md) et [`OutgoingMessage`](../API/OutgoingMessageClass.md). +- Si le token `$4DSID` est valide, la session de l'utilisateur web concerné est **automatiquement restaurée** dans n'importe quel process web avec son *storage* et ses privilèges. :::note -A [`4DACTION`](./httpRequests.md#4daction) url can also be used on the 4D side. +Une url [`4DACTION`](./httpRequests.md#4daction) peut également être utilisée du côté 4D. ::: -#### Using a custom parameter +#### Utilisation d'un paramètre personnalisé -The OTP token can also be provided as a custom parameter that you need to process specifically to restore the session. You must use this solution if: +Le token OTP peut également être fourni en tant que paramètre personnalisé que vous devez traiter spécifiquement pour restaurer la session. Vous devez utiliser cette solution si : -- the third-party application does not allow to insert parameters such as a `$4DSID` directly in the redirect Uri, and provides a dedicated API (the implementation depends on the third-party application), -- or, you want to call an ORDA function through REST to process the callback, in which case you need to pass the OTP with the [REST parameter syntax](../REST/ClassFunctions.md#parameters) (e.g. `?$params='["XXX123"]'`). +- l'application tierce ne permet pas d'insérer des paramètres tels que `$4DSID` directement dans l'Uri de redirection, et fournit une API dédiée (l'implémentation dépend de l'application tierce), +- ou bien vous souhaitez appeler une fonction ORDA via REST pour traiter le callback, auquel cas vous devez transmettre l'OTP avec la [syntaxe des paramètres REST](../REST/ClassFunctions.md#parameters) (par exemple `?$params='["XXX123"]'`). -In both cases, you need to extract the token from the custom parameter and to call the [`Session.restore()`](../API/SessionClass.md#restore) function with the token as parameter. +Dans les deux cas, vous devez extraire le token du paramètre personnalisé et appeler la fonction [`Session.restore()`](../API/SessionClass.md#restore) avec le token en paramètre. -#### Processing a invalid OTP +#### Traitement d'un OTP non valide -The OTP token is considered invalid if: +Le token OTP est considéré comme invalide si : - le token de session a déjà été utilisé, - le token de session a expiré, - le token de session n'existe pas, - la session d'origine elle-même a expiré. -In this case, no web user session is restored and the current session (if any) is left unchanged. Usually, you can decide to display a login page or to open a guest session. +Dans ce cas, aucune session d'utilisateur Web n'est restaurée et la session courante (s'il y en a une) reste inchangée. En général, vous pouvez décider d'afficher une page de connexion ou d'ouvrir une session guest. -Verifying if the received OTP token is valid depends on how it was handled: +La vérification de la validité du token OTP reçu dépend de la manière dont il a été géré : -- If you used a `$4DSID`, you can store a custom status property in the [session storage](../API/SessionClass.md#storage) at the moment of the token creation, and check this status once the OTP token was received to see if it is the same value (see example). -- If you used the [`Session.restore()`](../API/SessionClass.md#restore) function, it returns true if the session correctly restored. +- Si vous avez utilisé un `$4DSID`, vous pouvez stocker une propriété d'état personnalisée dans le [storage de la session](../API/SessionClass.md#storage) au moment de la création du token, et vérifier cet état une fois que le token OTP a été reçu pour voir s'il s'agit de la même valeur (voir l'exemple). +- Si vous avez utilisé la fonction [`Session.restore()`](../API/SessionClass.md#restore), elle renvoie true si la session a été correctement restaurée. -### Scenario with $4DSID +### Scénario avec $4DSID -The scenario using the `$4DSID` key is illustrated in the following diagram: +Le scénario utilisant la clé `$4DSID` est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -289,25 +289,25 @@ sequenceDiagram FrontEnd ->>+ 4DServer: ValidateOperation() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() -Note over 4DServer: e.g. OTP is 2E5D0D5xxx + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() +Note over 4DServer: e.g. OTP vaut 2E5D0D5xxx - 4DServer ->>+ ExternalPlatform: Call the external platform, give a callback URL containing a $4DSID parameter (depends on the platform API) + 4DServer ->>+ ExternalPlatform: Appel de la plate-forme tirece, envoi d'un URL de rappel contenant un paramètre $4DSID (dépend de l'API de la plate-forme) Note right of 4DServer: e.g. callback URL: "https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D5xxx" - ExternalPlatform ->>+ ExternalPlatform: Process request -ExternalPlatform ->>+ 4DServer: External platform calls back 4D Server if validation OK + ExternalPlatform ->>+ ExternalPlatform: Traitement de la requête +ExternalPlatform ->>+ 4DServer: Rappel de 4D Server si validation OK Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D57751D471DB29FD110D2DCE253 - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
(e.g. handleOperation() function of the OperationsHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
(e.g. fonction handleOperation() du singleton OperationsHandler, voir code ci-dessous) - Note over 4DServer: The original session is retrieved thanks to the OTP given in the $4DSID parameter. - Note over 4DServer: Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer: La session d'origine session est restaurée grâce à l'OTP fourni dans le paramètre $4DSID. + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -320,7 +320,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler @@ -329,9 +329,9 @@ shared singleton Class constructor() $session:=Session ``` -### Scenario with `restore` function +### Scénario avec la fonction `restore` -The scenario using a custom parameter is illustrated in the following diagram: +Le scénario utilisant un paramètre personnalisé est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -366,7 +366,7 @@ sequenceDiagram ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -379,7 +379,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler From 57d07a44c949ccf8d6951a5886099905a9107e72 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:16:16 +0200 Subject: [PATCH 008/201] New translations new-collection.md (Portuguese, Brazilian) --- .../current/commands/new-collection.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-collection.md b/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-collection.md index 62e06ed6627541..f044c5be71860c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-collection.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/commands/new-collection.md @@ -1,6 +1,6 @@ --- id: new-collection -title: New collection +title: Nova coleção displayed_sidebar: docs --- From a91ee610fb048b8894e25ab7b3b0cc0b1ec978a1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:24:19 +0200 Subject: [PATCH 009/201] New translations http-request-handler.md (French) --- .../current/WebServer/http-request-handler.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index a9e16ab1adf8ea..cc9ddee4b5c362 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -17,35 +17,35 @@ Les gestionnaires de requêtes HTTP personnalisés répondent à divers besoins, ## Conditions requises -Custom HTTP Request handlers are supported in the following context: +Les gestionnaires de requêtes HTTP personnalisés sont pris en charge dans le contexte suivant : -- [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, -- a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). +- les [sessions extensibles](./sessions.md#enabling-web-sessions) ou [pas de sessions](../settings/web.md#no-sessions) sont activées, +- un serveur web exécuté localement par 4D ou 4D Server, y compris ceux [exécutés par des composants](./webServerObject.md). :::warning -For security reasons, external access to the datastore can be disallowed in 4D. Vous devez configurer les [privilèges ORDA](../ORDA/privileges.md) pour autoriser les requêtes HTTP. +Pour des raisons de sécurité, l'accès externe au datastore peut être interdit dans 4D. Vous devez configurer les [privilèges ORDA](../ORDA/privileges.md) pour autoriser les requêtes HTTP. ::: -## How to set handlers +## Comment définir les gestionnaires -You can declare HTTP Request handlers: +Vous pouvez déclarer des gestionnaires de requêtes HTTP : -- in a configuration file named **HTTPHandlers.json** stored in the [`Project/Sources`](../Project/architecture.md#sources) folder of the project. HTTP Request handlers are loaded and applied in the main Web server once it is started. -- using a [`.handlers`](../API/WebServerClass.md#handlers) property set in the *settings* parameter of the [start()](../API/WebServerClass.md#start) function, for any web server object: +- dans un fichier de configuration nommé **HTTPHandlers.json** stocké dans le dossier [`Project/Sources`](../Project/architecture.md#sources) du projet. Les gestionnaires de requêtes HTTP sont chargés et appliqués dans le serveur Web principal une fois qu'il est démarré. +- en utilisant une propriété [`.handlers`](../API/WebServerClass.md#handlers) dans le paramètre *settings* de la fonction [start()](../API/WebServerClass.md#start), pour n'importe quel objet serveur web : ```4d -WEB Server.start($settings.handlers) //set rules at web server startup +WEB Server.start($settings.handlers) //prise en compte au démarrage du server web ``` -If both a **HTTPHandlers.json** file and a call to the [`WEB Server`](../commands/web-server.md) command with a valid `$settings.handlers` are used, the `WEB Server` command has priority. +Si à la fois un fichier **HTTPHandlers.json** et un appel à la commande [`WEB Server`](../commands/web-server.md) avec un `$settings.handlers` valide sont utilisés, la commande `WEB Server` est prioritaire. -The json file (or the object in the *settings* parameter) contains all listened URL patterns, the handled verbs, and the code to be called. +Le fichier json (ou l'objet dans le paramètre *settings*) contient tous les modèles d'URL listés, les verbes traités et le code à appeler. -Handlers are provided as a collection. +Les *handlers* sont fournis sous la forme d'une collection. -Au moment de l'exécution, le premier motif correspondant à l'URL est exécuté, les autres sont ignorés. +Au moment de l'exécution, le premier motif (*pattern*) correspondant à l'URL est exécuté, les autres sont ignorés. Voici un exemple du contenu d'un fichier *HTTPHandlers.json* : From 95763556fb847a834c47ca4e10eee3b35144a438 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:36:08 +0200 Subject: [PATCH 010/201] New translations openaichathelper.md (Japanese) --- .../current/aikit/Classes/OpenAIChatHelper.md | 112 +++++++++--------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatHelper.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatHelper.md index 57c10348740857..567211cdf9f8ba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatHelper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatHelper.md @@ -9,26 +9,26 @@ title: OpenAIChatHelper ## プロパティ -| プロパティ名 | 型 | デフォルト値 | 説明 | -| --------------------- | --------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | -| `chat` | [OpenAIChatAPI](OpenAIChatAPI.md) | - | Open AI との通信で使用されるチャットAPI インスタンス。 | -| `systemPrompt` | [OpenAIMessage](OpenAIMessage.md) | - | チャットアシスタントのレスポンスをガイドするためのシステムプロンプトメッセージ。 | -| `numberOfMessages` | Integer | 15 | チャット履歴に保持するメッセージの最大数。 | -| `引数` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | -| `messages` | [OpenAIMessage](OpenAIMessage.md) のコレクション | [] | そのチャットセッション内でやりとりされたメッセージのコレクション。 | -| `ツール` | Collection of [OpenAITool](OpenAITool.md) | [] | List of registered OpenAI tools for function calling. | -| `autoHandleToolCalls` | Boolean | true | Boolean indicating whether tool calls are handled automatically using registered tools. | -| `lastErrors` | Collection | - | Collection containing the last errors encountered during chat operations. | +| プロパティ名 | 型 | デフォルト値 | 説明 | +| --------------------- | --------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------- | +| `chat` | [OpenAIChatAPI](OpenAIChatAPI.md) | - | Open AI との通信で使用されるチャットAPI インスタンス。 | +| `systemPrompt` | [OpenAIMessage](OpenAIMessage.md) | - | チャットアシスタントのレスポンスをガイドするためのシステムプロンプトメッセージ。 | +| `numberOfMessages` | Integer | 15 | チャット履歴に保持するメッセージの最大数。 | +| `parameters` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | +| `messages` | [OpenAIMessage](OpenAIMessage.md) のコレクション | [] | そのチャットセッション内でやりとりされたメッセージのコレクション。 | +| `tools` | [OpenAITool](OpenAITool.md) のコレクション | [] | 関数呼び出し用に登録されたOpenAI ツールの一覧。 | +| `autoHandleToolCalls` | Boolean | true | 登録されたツールを使用してツール呼び出しを自動的に管理するかどうかをあらわすブール値。 | +| `lastErrors` | Collection | - | チャット操作中に発生した最後のエラーを格納したコレクション。 | -## Constructor +## コンストラクター -To create a new `OpenAIChatHelper` instance, it's best to use the `create()` method from the [OpenAI client's chat API](OpenAIChatAPI.md): +新しい `OpenAIChatHelper` インスタンスを作成するためには、[OpenAI クライアントのチャットAPI](OpenAIChatAPI.md)の `create()` メソッドを使用するのが最適です: ```4D var $chatHelper:=$client.chat.create("You are a helpful assistant.") ``` -This method creates a new chat helper with the specified system prompt and initializes it with default parameters. The system prompt defines the assistant's role and behavior throughout the conversation. +このメソッドは指定されたシステムプロンプトで新しいチャットヘルパーを作成し、デフォルトの引数で初期化します。 このシステムプロンプトが会話の間全体の、アシスタントの役割と振る舞いを定義します。 ## 関数 @@ -54,52 +54,52 @@ $result:=$chatHelper.prompt("Why 42?") **reset**() -Resets the chat context by clearing all messages and unregistering all tools. This effectively starts a fresh conversation while keeping the system prompt and parameters intact. +全てのメッセージを消去し、全てのツールの登録を解除することで、チャットコンテキストをリセットします。 これにより、システムのプロンプトとパラメータをそのままにしながら、効果的に新しい会話を始めることができます。 -#### Reset Example +#### リセットの例 ```4D $chatHelper.prompt("Hello!") -$chatHelper.reset() // Clear all previous messages and tools +$chatHelper.reset() // 以前のメッセージとツールを全て消去 ``` ### registerTool() **registerTool**(*tool* : Object; *handler* : Object) -| 引数 | 型 | 説明 | -| --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| *tool* | Object | The tool definition object (or [OpenAITool](OpenAITool.md) instance) | -| *handler* | Object | The function to handle tool calls ([4D.Function](../../API/FunctionClass.md) or Object), optional if defined inside *tool* as *handler* property | +| 引数 | 型 | 説明 | +| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| *tool* | Object | ツール定義オブジェクト(あるいは[OpenAITool](OpenAITool.md) インスタンス) | +| *handler* | Object | ツール呼び出しを管理する関数([4D.Function](../../API/FunctionClass.md) またはオブジェクト)、*tool* 内の *handler* プロパティで定義されている場合にはオプション。 | -Registers a tool with its handler function for automatic tool call handling. +自動ツール呼び出し関数のために、ツールとそのハンドラ関数を登録します。 -The *handler* parameter can be: +*handler* 引数には以下のものを渡すことができます: -- A **4D.Function**: Direct handler function -- An **Object**: An object containing a `formula` property matching the tool function name +- **4D.Function**: 直接ハンドラ関数 +- **オブジェクト**: ツール関数名と一致する `formula` プロパティを格納しているオブジェクト -The handler function receives an object containing the parameters passed from the OpenAI tool call. This object contains key-value pairs where the keys match the parameter names defined in the tool's schema, and the values are the actual arguments provided by the AI model. +ハンドラー関数はOpenAI ツール呼び出しから渡された引数を格納しているオブジェクトを受け取ります。 オブジェクトは、ツールのスキーマで定義されたパラメーター名とキーが一致するキーと、AI モデルから提供された実際の引数である値との、キーと値のペアを格納しています。 -#### Register Tool Example +#### ツールを登録する例題 ```4D -// Example 1: Simple registration with direct handler +// Example 1: 直接ハンドラを使用したシンプルな登録 var $tool:={type: "function"; function: {name: "get_weather"; description: "Get current weather"; parameters: {type: "object"; properties: {location: {type: "string"; description: "City name"}}}}} var $handler:=Formula(return "Sunny, 25°C in "+$1.location) $chatHelper.registerTool($tool; $handler) -// Example 2: Tool with handler property (no second parameter needed) +// Example 2: プロパティを持つtool オブジェクトを使用(この場合第2に引数は不要です) var $tool:={name: "calculate"; description: "Perform calculations"; handler: Formula(return String(Num($1.expression)))} $chatHelper.registerTool($tool) -// Example 3: Using object notation +// Example 3: オブジェクト記法を使用する $chatHelper.registerTool({tool: $tool; handler: $handler}) -// Example 4: Handler as object with formula matching tool name +// Example 4: ツール名と合致するフォーミュラを持ったオブジェクトとしてのハンドラ var $tool:={name: "getTime"; description: "Get current time"} -var $handlerObj:=cs.MyTimeTool.new() // class with a getTime function +var $handlerObj:=cs.MyTimeTool.new() // getTime 関数を持つクラス $chatHelper.registerTool($tool; $handlerObj) ``` @@ -107,19 +107,19 @@ $chatHelper.registerTool($tool; $handlerObj) **registerTools**(*toolsWithHandlers* : Variant) -| 引数 | 型 | 説明 | -| ------------------- | ------- | -------------------------------------------------------- | -| *toolsWithHandlers* | Variant | Object or Collection containing tools and their handlers | +| 引数 | 型 | 説明 | +| ------------------- | ------- | ------------------------------- | +| *toolsWithHandlers* | Variant | ツールとのそのハンドラを格納したオブジェクトまたはコレクション | -Registers multiple tools at once. The parameter can be: +複数のツールを一度に登録します。 引数には以下のものを渡すことができます: -- **Collection**: Array of tool objects (with handlers embedded or separate) -- **Object**: Object with function names as keys mapping to tool definitions -- **Object with `tools` attribute**: Object containing a `tools` collection and formula properties matching tool names +- **コレクション**: (ハンドラが埋め込んである、あるいは分離してある)ツールオブジェクトのコレクション +- **オブジェクト**: 関数名がツール定義にマッピングされているキーとするオブジェクト +- **`tools` 属性を持つオブジェクト**: `tools` コレクションと、ツール名に合致するフォーミュラプロパティを格納しているオブジェクト -#### Register Multiple Tools Example +#### 複数のツールを登録する例題 -##### Example 1: Collection format with handlers in tools +##### 例 1: ツール内のハンドルを使用したコレクションフォーマット ```4D var $weatherTool:={name: "getWeather"; description: "Get current weather"; handler: Formula(return "Sunny, 25°C in "+$1.location)} @@ -128,7 +128,7 @@ var $calculatorTool:={name: "calculate"; description: "Perform calculations"; ha $chatHelper.registerTools([$weatherTool; $calculatorTool]) ``` -##### Example 2: Object format with separate tool and handler +##### 例 2: 別個のツールとハンドラを使用したオブジェクトフォーマット ```4D var $toolsWithSeparateHandlers:={} @@ -138,15 +138,15 @@ $toolsWithSeparateHandlers.calculate:={tool: $calculatorToolDefinition; handler: $chatHelper.registerTools($toolsWithSeparateHandlers) ``` -##### Example 3: Object with tools collection attribute and formula properties +##### 例 3: tools コレクション属性とformula プロパティを持ったオブジェクト -MyTools class: +MyTools クラス: ```4D Class constructor this.tools:=[{name: "getWeather"; description: "Get current weather"}; \ - {name: "getTime"; description: "Get current time"}] // Collection of tool definitions + {name: "getTime"; description: "Get current time"}] // ツール定義のコレクション Function getWeather($parameters: Object) return "Sunny, 25°C" @@ -159,12 +159,12 @@ Function getTime($parameters: Object) $chatHelper.registerTools(cs.MyTools.new()) ``` -##### Example 4: Simple object format with tools as properties +##### 例 4: ツールをプロパティにもつシンプルなオブジェクトフォーマット ```4D var $tools:={} -$tools.getWeather:=$weatherTool // Tool with handler property -$tools.calculate:=$calculatorTool // Tool with handler property +$tools.getWeather:=$weatherTool // handler プロパティを持つTool +$tools.calculate:=$calculatorTool // handler プロパティを持つTool $chatHelper.registerTools($tools) ``` @@ -173,28 +173,28 @@ $chatHelper.registerTools($tools) **unregisterTool**(*functionName* : Text) -| 引数 | 型 | 説明 | -| -------------- | ---- | ------------------------------------------- | -| *functionName* | Text | The name of the function tool to unregister | +| 引数 | 型 | 説明 | +| -------------- | ---- | --------------- | +| *functionName* | Text | 登録を解除したいツールの関数名 | -Unregisters a specific tool by its function name. This removes the tool from the registered tools collection, clears its handler, and removes it from the parameters. +特定のツールをその関数名で指定して登録解除します。 これによってツールは登録されたツールのコレクションから削除され、ハンドラも消去され、引数からも削除されます。 -#### Unregister Tool Example +#### ツールを登録解除する例 ```4D $chatHelper.registerTool($weatherTool; $weatherHandler) -$chatHelper.unregisterTool("get_weather") // Remove the weather tool +$chatHelper.unregisterTool("get_weather") // weather ツールを削除 ``` ### unregisterTools() **unregisterTools**() -Unregisters all tools at once. This clears all tool handlers, empties the tools collection, and removes all tools from the parameters. +全てのツールを一度に登録解除します。 これはすべてのツールハンドラを消去し、tools コレクションをからにし、そして引数からも全てのツールを削除します。 -#### Unregister All Tools Example +#### 全てのツールを登録解除する例 ```4D $chatHelper.registerTools($multipleTools) -$chatHelper.unregisterTools() // Remove all tools +$chatHelper.unregisterTools() // 全てのツールを削除 ``` \ No newline at end of file From 91f6bdb1f705ea006f60ea430bd98a7c9fd8a665 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:38:51 +0200 Subject: [PATCH 011/201] New translations orda-events.md (French) --- .../docusaurus-plugin-content-docs/current/ORDA/orda-events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index 1f4e78f6cc9c23..cc75f45301a848 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -16,7 +16,7 @@ ORDA events are functions that are automatically invoked by ORDA each time entit You cannot directly trigger event function execution. Events are called automatically by ORDA based on user actions or operations performed through code on entities and their attributes. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [ORDA – Handle an event-driven logic during data persistence actions](https://blog.4d.com/orda-handle-an-event-driven-logic-during-data-persistence-actions) From 908342c5503209660808fb076385ceaed4b41fda Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:40:08 +0200 Subject: [PATCH 012/201] New translations collectionclass.md (French) --- .../version-20-R10/API/CollectionClass.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/CollectionClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/CollectionClass.md index 0f3efe19eef728..4988f47bd80d77 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/CollectionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/CollectionClass.md @@ -3216,15 +3216,15 @@ La fonction `.sort()` trie les éléments > Cette fonction modifie la collection d'origine. Si `.sort()` est appelé sans paramètres, seules les valeurs scalaires (nombres, textes, dates, booléens) sont triées. Les éléments sont triés par défaut par ordre croissant, en fonction de leur type. -You can also pass one of the following constants in the *ascOrDesc* parameter: +Vous pouvez également passer une des constantes suivantes dans le paramètre *ascOrDesc* : ``` - |Constant| Type|Value|Comment| - |---|---|---|---| - |ck ascending|Integer|0|Elements are ordered in ascending order (default)| - |ck descending|Integer|1|Elements are ordered in descending order| + |Constante| Type|Valeur|Comment| + |---|---|---| + |ck ascending|Integer|0|Les éléments sont classés par ordre croissant (par défaut)| + |ck descending|Integer|1|Les éléments sont classés par ordre décroissant| - This syntax orders scalar values in the collection only (other element types such as objects or collections are returned unordered). + Cette syntaxe ordonne uniquement les valeurs scalaires dans la collection (les autres types d'éléments tels que les objets ou les collections sont renvoyés non ordonnés). ``` Si la collection contient des éléments de différents types, ils sont d'abord groupés par type et triés par la suite. Les types sont renvoyés dans l'ordre suivant : From cb644de9541468d6b2c3bf137dc5bf94afe7b90e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:40:38 +0200 Subject: [PATCH 013/201] New translations dataclassclass.md (French) --- .../version-20-R10/API/DataClassClass.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/DataClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/DataClassClass.md index 2c280ab9385cac..833e8629f5469a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/DataClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/DataClassClass.md @@ -1181,7 +1181,7 @@ La formule doit avoir été créée à l'aide de la commande [`Formula`](../comm - *formula* est évaluée pour chaque entité et doit renvoyer vrai ou faux. Lors de l'exécution de la requête, si le résultat de la formule n'est pas un booléen, il est considéré comme faux. - dans *formula*, l'entité est disponible via l'objet `This`. -- if the `Formula` object is **null**, the error 1626 ("Expecting a text or formula") is generated, that you can intercept using a method installed with `ON ERR CALL`. +- si l'objet `Formula` est **null**, l'erreur 1626 ("Expecting a text or formula") est générée, que vous pouvez intercepter en utilisant une méthode installée avec `ON ERR CALL`. > Pour des raisons de sécurité, les appels de formule dans les fonctions `query()` peuvent être interdits. Voir la description du paramètre *querySettings*. From 7a42d3d918842920dede9db1e9c41b0005065216 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:41:21 +0200 Subject: [PATCH 014/201] New translations entityclass.md (French) --- .../version-20-R10/API/EntityClass.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/EntityClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/EntityClass.md index e7b012bba8b244..1207bd9123c398 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/EntityClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/EntityClass.md @@ -509,7 +509,7 @@ La correspondance entre l'objet et l'entité est établie à partir des noms de - Si une propriété de l'objet n'existe pas dans la dataclass, elle est ignorée. - Les types de données doivent être équivalents. S'il existe une différence de type entre l'objet et la dataclass, 4D essaie de convertir les données lorsque cela est possible (voir [`Converting data types`](Concepts/data-types.md#converting-data-types)), sinon l'attribut est laissé intact. -- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. +- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si elle n'existe pas déjà dans la dataclass, l'entité est créée avec la valeur donnée lorsque [.save()](#save) est appelée. Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. *filler* peut contenir une related entity dans les conditions suivantes : From 7e2f40b7699f9c0e96a0339af4917d8cdaa4daab Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:43:12 +0200 Subject: [PATCH 015/201] New translations sessionclass.md (French) --- .../version-20-R10/API/SessionClass.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md index 75b05496143148..9c4ff9359a4f01 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/API/SessionClass.md @@ -120,7 +120,7 @@ $isGuest:=Session.isGuest() //$isGuest est True | Paramètres | Type | | Description | | ---------- | ------- | :-------------------------: | -------------------------------------------- | | lifespan | Integer | -> | Durée de vie du token de session en secondes | -| Résultat | Text | <- | UUID of the OTP token | +| Résultat | Text | <- | UUID du token OTP | @@ -735,7 +735,7 @@ Function callback($request : 4D.IncomingMessage) : 4D.OutgoingMessage :::note -Cette fonction ne fait rien et retourne toujours **False** avec les sessions client distants, procédures stockées et autonomes. +Cette fonction ne fait rien et retourne toujours **False** avec les sessions client distantes, procédures stockées et autonomes. ::: From 118cd9f618da391dd5c40452ffc13f8647cb2a15 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:50:00 +0200 Subject: [PATCH 016/201] New translations onafteredit.md (French) --- .../version-20-R10/Events/onAfterEdit.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md index 1b7faf45be6041..0850656f6df974 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Events/onAfterEdit.md @@ -62,11 +62,11 @@ En fonction de la valeur de la propriété `action`, l'[objet event](overview.md #### action = DragFillBlock -| Propriété | Type | Description | -| ------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | Plage utilisée pour le remplissage | -| autoFillType | entier long | Value used for the fill.
  • 0: Cells are filled with all data (values, formatting, and formulas)
  • 1: Cells are filled with automatically sequential data
  • 2: Cells are filled with formatting only
  • 3: Cells are filled with values but not formatting
  • 4: Values are removed from the cells
  • 5: Cells are filled automatically
    • | -| fillDirection | entier long | Direction of the fill.
  • 0: The cells to the left are filled
  • 1: The cells to the right are filled
  • 2: The cells above are filled
  • 3: The cells below are filled
    • | +| Propriété | Type | Description | +| ------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | Plage utilisée pour le remplissage | +| autoFillType | entier long | Valeur utilisée pour le remplissage.
  • 0 : Les cellules sont remplies avec toutes les données (valeurs, formatage et formules)
  • 1 : Les cellules sont remplies avec des données séquentielles automatiques
  • 2 : Les cellules sont remplies avec la mise en forme uniquement
  • 3 : Les cellules sont remplies avec les valeurs mais pas la mise en forme
  • 4 : Les valeurs sont supprimées des cellules
  • 5 : Les cellules sont remplies automatiquement
    • | +| fillDirection | entier long | Direction du remplissage.
  • 0 : Les cellules de gauche sont remplies
  • 1 : Les cellules de droite sont remplies
  • 2 : Les cellules du haut sont remplies
  • 3 : Les cellules du bas sont remplies
    • | #### action = formulaChanged From 948baca631129ff65d4f895da2697719757433de Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 18:54:44 +0200 Subject: [PATCH 017/201] New translations overview.md (French) --- .../version-20-R10/Extensions/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Extensions/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Extensions/overview.md index 227a3b0ae64922..750da38a611e75 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Extensions/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/Extensions/overview.md @@ -3,11 +3,11 @@ id: overview title: Extension des applications 4D --- -The 4D architecture is open and can be extended in different ways. Si vous avez besoin d'une fonctionnalité qui n'est pas disponible de manière native dans 4D, vous pouvez toujours l'intégrer dans votre application de différentes manières : +L'architecture de 4D est ouverte et peut être étendue de plusieurs façons. Si vous avez besoin d'une fonctionnalité qui n'est pas disponible de manière native dans 4D, vous pouvez toujours l'intégrer dans votre application de différentes manières : - les [**System workers**](../API/SystemWorkerClass.md) permettent au code 4D d'appeler n'importe quel process externe (une commande shell, PHP, un script, etc.) et d'en contrôler l'exécution. - les [**commandes SQL**](../commands/theme/SQL) vous permettent de vous connecter à diverses sources de données SQL et de les utiliser . - Le [**client HTTP intégré**](../API/HTTPRequestClass.md) peut envoyer des requêtes à n'importe quel serveur HTTP et traiter les données. - les [**zones web**](../FormObjects/webArea_overview.md) peuvent donner accès à des pages web ou à divers contenus HTML à l'intérieur de vos formulaires. -- les [**Composants**](Concepts/components.md). Les composants sont faits de code 4D. 4D includes by default [a set of built-in 4D components](../Project/components.md#preinstalled-4d-components). Vous pouvez également [développer vos propres composants 4D](develop-components.md), ou utiliser des composants tiers. De nombreux développeurs de la communauté 4D ont partagé des composants 4D (consultez Github pour obtenir une liste des composants 4D publics rassemblés dans le topic [`4d-component`](https://github.com/topics/4d-component)). +- les [**Composants**](Concepts/components.md). Les composants sont faits de code 4D. 4D inclut par défaut [un ensemble de composants 4D](../Project/components.md#preinstalled-4d-components). Vous pouvez également [développer vos propres composants 4D](develop-components.md), ou utiliser des composants tiers. De nombreux développeurs de la communauté 4D ont partagé des composants 4D (consultez Github pour obtenir une liste des composants 4D publics rassemblés dans le topic [`4d-component`](https://github.com/topics/4d-component)). - les [**Plug-ins**](../Concepts/plug-ins.md). Les plug-ins peuvent être créés dans n'importe quel langage. Les plugins font des choses que 4D ne fait pas nativement (par exemple, une technologie de plateforme spécifique), ou qui seraient très difficiles à écrire en utilisant uniquement 4D. Comme décrit dans [cette page](develop-plug-ins.md), vous pouvez développer vos propres plugins. De nombreuses fonctionnalités sont couvertes par les plug-ins 4D existants. Parcourez GitHub pour obtenir la liste des plugins 4D publics rassemblés sous le topic [`4d-plugin`](https://github.com/topics/4d-plugin). From 8c8dae82b765ed1a39decb792dbce298868be44d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 19:19:34 +0200 Subject: [PATCH 018/201] New translations http-request-handler.md (French) --- .../version-20-R10/WebServer/http-request-handler.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md index 61877412ae2d4c..8e30dc8a9b7ecd 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/http-request-handler.md @@ -34,7 +34,7 @@ Vous définissez vos gestionnaires de requêtes HTTP personnalisés dans un fich Ce fichier contient tous les motifs d'URL à intercepter, les verbes manipulés et le code à appeler. Les gestionnaires sont fournis sous la forme d'une collection au format JSON. -Au moment de l'exécution, le premier motif correspondant à l'URL est exécuté, les autres sont ignorés. +Au moment de l'exécution, le premier motif (*pattern*) correspondant à l'URL est exécuté, les autres sont ignorés. Voici un exemple du contenu d'un fichier *HTTPHandlers.json* : From df89fb0d825937f4096796e89df8c9ce2d7a1249 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 19:19:45 +0200 Subject: [PATCH 019/201] New translations preemptiveweb.md (French) --- .../version-20-R10/WebServer/preemptiveWeb.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md index 1b2b27e26c6d0a..829fa0155037b3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/preemptiveWeb.md @@ -26,10 +26,10 @@ Le tableau suivant indique si l'utilisation du mode préemptif pour les process - Serveur REST : gère les [fonctions de classe du modèle de données ORDA](../REST/ClassFunctions.md) - Serveur Web : gère les [modèles Web](templates.md), [4DACTION et les méthodes base](httpRequests.md) - Serveur de services Web : gère les requêtes SOAP -- ***web setting*** signifie que le mode préemptif dépend d'une valeur de réglage : - - when [**Scalable sessions**](sessions.md#enabling-web-sessions) option is selected, the preemptive mode is automatically used for web processes. +- ***paramètres web*** signifie que le mode préemptif dépend d'une valeur de réglage : + - lorsque l'option [**Sessions évolutives**](sessions.md#enabling-web-sessions) est sélectionnée, le mode préemptif est automatiquement utilisé pour les process web. - sinon, l'option [**Utiliser des process préemptifs**](webServerConfig.md#use-preemptive-processes) est prise en compte. - - en ce qui concerne les process de service Web (serveur ou client), le mode préemptif est pris en charge au niveau de la méthode. You just have to select "Can be run in preemptive processes" property for published SOAP server methods (see [Publishing a Web Service with 4D](https://doc.4d.com/4Dv20/4D/20.2/Publishing-a-Web-Service-with-4D.300-6750334.en.html)) or proxy client methods (see [Subscribing to a Web Service in 4D](https://doc.4d.com/4Dv20/4D/20.2/Subscribing-to-a-Web-Service-in-4D.300-6750336.en.html)) and make sure they are confirmed thread-safe by the compiler. + - en ce qui concerne les process de service Web (serveur ou client), le mode préemptif est pris en charge au niveau de la méthode. Il suffit de sélectionner la propriété "Peut être exécutée dans un process préemptif" pour les méthodes de serveur SOAP publiées (voir [Publier un Service Web avec 4D](https://doc.4d.com/4Dv20/4D/20.2/Publier-un-Service-Web-avec-4D.300-6750334.fe.html)) ou les méthodes de client proxy (voir [Souscrire à un Service Web dans 4D](https://doc.4d.com/4Dv20/4D/20.2/Souscrire-a-un-Service-Web-dans-4D.300-6750336.fe.html)) et de s'assurer qu'elles sont confirmées thread-safe par le compilateur. ## Ecrire du code serveur Web thread-safe @@ -43,7 +43,7 @@ Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souh - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; -- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- En principe, tout code traité par la commande [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) dans le contexte du web, par exemple par le biais de pages .shtml - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" From 20d27c1ee70e9a2d91946a400efc5009b8a93726 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 19:19:57 +0200 Subject: [PATCH 020/201] New translations sessions.md (French) --- .../version-20-R10/WebServer/sessions.md | 172 +++++++++--------- 1 file changed, 86 insertions(+), 86 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md index 222f22401c7e53..65e34e8f83ca65 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md @@ -12,7 +12,7 @@ Les sessions Web permettent de : - stocker et partager des données entre les process d'un client web en utilisant le [.storage](../API/SessionClass.md#storage) de la session, - associer des privilèges à l'utilisateur qui exécute la session. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) @@ -36,7 +36,7 @@ Cette option est sélectionnée par défaut dans les nouveaux projets. Elle peut - En utilisant la propriété [`.scalableSession`](API/WebServerClass.md#scalablession) de l'objet Web Server (à passer dans le paramètre *settings* de la fonction [`.start()`](API/WebServerClass.md#start) ). Dans ce cas, ce paramètre remplace l'option définie dans la boîte de dialogue Propriétés pour l'objet Web Server (il n'est pas stocké sur disque). -> The [`WEB SET OPTION`](../commands-legacy/web-set-option.md) command can also set the session mode for the main Web server. +> La commande [`WEB SET OPTION`](../commands-legacy/web-set-option.md) peut également définir le mode de session du serveur Web principal. Dans tous les cas, ce paramètre est local à la machine ; il peut donc être différent sur le serveur Web 4D Server et les serveurs Web des machines 4D distantes. @@ -44,7 +44,7 @@ Dans tous les cas, ce paramètre est local à la machine ; il peut donc être di ## Implémentation des sessions -When [sessions are enabled](#enabling-web-sessions), automatic mechanisms are implemented, based upon a private cookie set by 4D itself: "4DSID__AppName_", where *AppName* is the name of the application project. Ce cookie référence la session web courante pour l'application. +Lorsque [les sessions sont activées](#enabling-web-sessions), des mécanismes automatiques sont mis en œuvre, sur la base d'un cookie privé défini par 4D lui-même : "4DSID_*AppName*", où *AppName* est le nom du projet d'application. Ce cookie référence la session web courante pour l'application. :::info @@ -73,7 +73,7 @@ L'objet `Session` de la session en cours peut ensuite être manipulé via la com :::info -Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Since a web process can be reused by any session, [process variables](Concepts/variables.md#process-variables) must be cleared by your code at the end of its execution (using [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) for example). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. +Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Comme un process web peut être réutilisé par n'importe quelle session, les [variables process](Concepts/variables.md#process-variables) doivent être effacées par votre code à la fin de son exécution (en utilisant [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) par exemple). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. ::: @@ -90,7 +90,7 @@ Une session web évolutive est fermée lorsque: La durée de vie d'un cookie inactif est de 60 minutes par défaut, ce qui signifie que le serveur Web fermera automatiquement les sessions inactives après 60 minutes. -This timeout can be set using the [`.idleTimeout`](API/SessionClass.md#idletimeout) property of the `Session` object (the timeout cannot be less than 60 minutes) or the *connectionInfo* parameter of the [`Open datastore`](../commands/open-datastore.md) command. +Ce délai peut être défini en utilisant la propriété [`.idleTimeout`](API/SessionClass.md#idletimeout) de l'objet `Session` (le délai ne peut être inférieur à 60 minutes) ou le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md). Lorsqu'une session web est fermée, si la commande [`Session`](commands/session.md) est appelée par la suite : @@ -159,7 +159,7 @@ http://localhost:8044/authenticate.shtml ![alt-text](../assets/en/WebServer/authenticate.png) -3. La méthode de projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : +3. La méthode projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : ```4d var $indexUserId; $indexPassword; $userId : Integer @@ -203,74 +203,74 @@ End if :::note -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). ::: -## Session Token (OTP) +## Token de session (OTP) -The 4D web server allows you to generate, share, and use OTP (One-Time Passcode) session tokens. OTP session tokens are used to secure communications with third-party applications or websites. For information on OTP, please refer to the [One-time password page](https://en.wikipedia.org/wiki/One-time_password) on Wikipedia. +Le serveur web 4D vous permet de générer, de partager et d'utiliser des tokens de session OTP (One-Time Passcode). Les tokens (ou *jetons*) de session OTP sont utilisés pour sécuriser les communications avec des applications ou des sites web tiers. Pour plus d'informations sur OTP, veuillez vous référer à la page [Mot de passe à usage unique](https://en.wikipedia.org/wiki/One-time_password) sur Wikipedia. -In 4D, OTP session tokens are useful when calling external URLs and being called back in another browser or device (mobile/computer). Typically, a third-party application sends a confirmation email containing a callback link on which the user has to click. The callback link includes the OTP token, so that the session which triggered the callback is loaded along with its data and privileges. This principle allows you to share the same session on multiple devices. Thanks to this architecture, the [session cookie](#session-implementation) is not exposed on the network, which eliminates the risk of man-in-the-middle attack. +Dans 4D, les tokens de session OTP sont utiles pour appeler des URL externes et être rappelé dans un autre navigateur ou appareil (mobile/ordinateur). Généralement, une application tierce envoie un courriel de confirmation contenant un lien de rappel sur lequel l'utilisateur doit cliquer. Le lien de rappel inclut le token OTP, de sorte que la session qui a déclenché le rappel est chargée avec ses données et ses privilèges. Ce principe vous permet de partager la même session sur plusieurs appareils. Grâce à cette architecture, le [cookie de session] (#session-implementation) n'est pas exposé sur le réseau, ce qui élimine le risque d'une attaque de type "man-in-the-middle". ### Vue d’ensemble -The basic sequence of an OTP session token use in a 4D web application is the following: +La séquence de base de l'utilisaton d'un token de session OTP dans une application web 4D est la suivante : -1. The web user initiates an action that requires a secured third-party connection, for example a validation, from within a specific session. -2. In your 4D code, you create a new OTP for the session using the [`Session.createOTP()`](../API/SessionClass.md#createotp) function. -3. You send a request to the third-party application with the session token included in the callback Uri. Note that the way to provide the callback Uri to a third-party application depends on its API (see below). -4. The third-party application sends back a request to 4D with the pattern you provided in the callback Uri. -5. The request callback is processed in your application. +1. L'utilisateur web initie une action qui nécessite une connexion tierce sécurisée, par exemple une validation, à partir d'une session spécifique. +2. Dans votre code 4D, vous créez un nouvel OTP pour la session à l'aide de la fonction [`Session.createOTP()`](../API/SessionClass.md#createotp). +3. Vous envoyez une requête à l'application tierce avec le token de session inclus dans l'Uri de callback (rappel). Notez que la manière de fournir l'Uri de rappel à une application tierce dépend de son API (voir ci-dessous). +4. L'application tierce renvoie une requête à 4D avec le modèle que vous avez fourni dans l'Uri de rappel. +5. Le rappel de la requête est traité dans votre application. -By definition, an OTP token can only be used once. In this scenario, if a web request is received with a session token as parameter that has already been used, the initial session is not restored. +Par définition, un token OTP ne peut être utilisé qu'une seule fois. Dans ce scénario, si une requête web est reçue avec un token de session comme paramètre qui a déjà été utilisé, la session initiale n'est pas restaurée. -### Processing the OTP in the callback +### Traitement de l'OTP dans le callback -Callbacks from third-party applications that include the OTP token can be processed in different ways in your 4D application, depending on your development and the third-party API. Basically, you have two possibilities to handle the token: through the **`$4DSID`** parameter for an automatic processing, or through a custom parameter that you need to process. +Les callbacks d'applications tierces qui incluent le token OTP peuvent être traités de différentes manières dans votre application 4D, en fonction de votre développement et de l'API tierce. En principe, vous avez deux possibilités pour gérer le token : via le paramètre **`$4DSID`** pour un traitement automatique, ou via un paramètre personnalisé que vous devez traiter. -#### Using `$4DSID` in the URL +#### Utilisation de `$4DSID` dans l'URL -Using the `$4DSID` parameter is the most simple way to process a callback from the third-party application: +L'utilisation du paramètre `$4DSID` est la façon la plus simple de traiter un callback de l'application tierce : -- The OTP token is provided as a parameter directly in the callback url using the standard `?$4DSID=XXXX123` syntax. -- In 4D, you implement a dedicated [HTTP Request handler](http-request-handler.md) in your 4D application using [`IncomingMessage`](../API/IncomingMessageClass.md) and [`OutgoingMessage`](../API/OutgoingMessageClass.md) classes. -- If the `$4DSID` token is valid, the related web user session is **automatically restored** in any web process with its storage and privileges. +- Le token OTP est fourni en tant que paramètre directement dans l'url de callback en utilisant la syntaxe standard `?$4DSID=XXXX123`. +- Dans votre application 4D, vous implémentez un [HTTP Request handler](http-request-handler.md) dédié en utilisant les classes [`IncomingMessage`](../API/IncomingMessageClass.md) et [`OutgoingMessage`](../API/OutgoingMessageClass.md). +- Si le token `$4DSID` est valide, la session de l'utilisateur web concerné est **automatiquement restaurée** dans n'importe quel process web avec son *storage* et ses privilèges. :::note -A [`4DACTION`](./httpRequests.md#4daction) url can also be used on the 4D side. +Une url [`4DACTION`](./httpRequests.md#4daction) peut également être utilisée du côté 4D. ::: -#### Using a custom parameter +#### Utilisation d'un paramètre personnalisé -The OTP token can also be provided as a custom parameter that you need to process specifically to restore the session. You must use this solution if: +Le token OTP peut également être fourni en tant que paramètre personnalisé que vous devez traiter spécifiquement pour restaurer la session. Vous devez utiliser cette solution si : -- the third-party application does not allow to insert parameters such as a `$4DSID` directly in the redirect Uri, and provides a dedicated API (the implementation depends on the third-party application), -- or, you want to call an ORDA function through REST to process the callback, in which case you need to pass the OTP with the [REST parameter syntax](../REST/ClassFunctions.md#parameters) (e.g. `?$params='["XXX123"]'`). +- l'application tierce ne permet pas d'insérer des paramètres tels que `$4DSID` directement dans l'Uri de redirection, et fournit une API dédiée (l'implémentation dépend de l'application tierce), +- ou bien vous souhaitez appeler une fonction ORDA via REST pour traiter le callback, auquel cas vous devez transmettre l'OTP avec la [syntaxe des paramètres REST](../REST/ClassFunctions.md#parameters) (par exemple `?$params='["XXX123"]'`). -In both cases, you need to extract the token from the custom parameter and to call the [`Session.restore()`](../API/SessionClass.md#restore) function with the token as parameter. +Dans les deux cas, vous devez extraire le token du paramètre personnalisé et appeler la fonction [`Session.restore()`](../API/SessionClass.md#restore) avec le token en paramètre. -#### Processing a invalid OTP +#### Traitement d'un OTP non valide -The OTP token is considered invalid if: +Le token OTP est considéré comme invalide si : - le token de session a déjà été utilisé, - le token de session a expiré, - le token de session n'existe pas, - la session d'origine elle-même a expiré. -In this case, no web user session is restored and the current session (if any) is left unchanged. Usually, you can decide to display a login page or to open a guest session. +Dans ce cas, aucune session d'utilisateur Web n'est restaurée et la session courante (s'il y en a une) reste inchangée. En général, vous pouvez décider d'afficher une page de connexion ou d'ouvrir une session guest. -Verifying if the received OTP token is valid depends on how it was handled: +La vérification de la validité du token OTP reçu dépend de la manière dont il a été géré : -- If you used a `$4DSID`, you can store a custom status property in the [session storage](../API/SessionClass.md#storage) at the moment of the token creation, and check this status once the OTP token was received to see if it is the same value (see example). -- If you used the [`Session.restore()`](../API/SessionClass.md#restore) function, it returns true if the session correctly restored. +- Si vous avez utilisé un `$4DSID`, vous pouvez stocker une propriété d'état personnalisée dans le [storage de la session](../API/SessionClass.md#storage) au moment de la création du token, et vérifier cet état une fois que le token OTP a été reçu pour voir s'il s'agit de la même valeur (voir l'exemple). +- Si vous avez utilisé la fonction [`Session.restore()`](../API/SessionClass.md#restore), elle renvoie true si la session a été correctement restaurée. -### Scenario with $4DSID +### Scénario avec $4DSID -The scenario using the `$4DSID` key is illustrated in the following diagram: +Le scénario utilisant la clé `$4DSID` est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -283,25 +283,25 @@ sequenceDiagram FrontEnd ->>+ 4DServer: ValidateOperation() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() -Note over 4DServer: e.g. OTP is 2E5D0D5xxx + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() +Note over 4DServer: e.g. OTP vaut 2E5D0D5xxx - 4DServer ->>+ ExternalPlatform: Call the external platform, give a callback URL containing a $4DSID parameter (depends on the platform API) + 4DServer ->>+ ExternalPlatform: Appel de la plate-forme tirece, envoi d'un URL de rappel contenant un paramètre $4DSID (dépend de l'API de la plate-forme) Note right of 4DServer: e.g. callback URL: "https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D5xxx" - ExternalPlatform ->>+ ExternalPlatform: Process request -ExternalPlatform ->>+ 4DServer: External platform calls back 4D Server if validation OK + ExternalPlatform ->>+ ExternalPlatform: Traitement de la requête +ExternalPlatform ->>+ 4DServer: Rappel de 4D Server si validation OK Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D57751D471DB29FD110D2DCE253 - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
    (e.g. handleOperation() function of the OperationsHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
    (e.g. fonction handleOperation() du singleton OperationsHandler, voir code ci-dessous) - Note over 4DServer: The original session is retrieved thanks to the OTP given in the $4DSID parameter. - Note over 4DServer: Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer: La session d'origine session est restaurée grâce à l'OTP fourni dans le paramètre $4DSID. + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -314,7 +314,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler @@ -323,9 +323,9 @@ shared singleton Class constructor() $session:=Session ``` -### Scenario with `restore` function +### Scénario avec la fonction `restore` -The scenario using a custom parameter is illustrated in the following diagram: +Le scénario utilisant un paramètre personnalisé est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -338,29 +338,29 @@ sequenceDiagram FrontEnd ->>+ 4DServer: Validate() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() Note over 4DServer: e.g. OTP is 2E5D0D5xxx - 4DServer ->> ExternalPlatform: Call the external platform giving the OTP, for example as a state parameter (depends on the platform) + 4DServer ->> ExternalPlatform: Appel de la plate-forme externe en donnant l'OTP, par exemple sous forme de paramètre state (dépend de la plate-forme) Note right of 4DServer: e.g. https://thirdPartSystem.com/validate?state=2E5D0D5xxx&redirect_uri=https://acme.com/my4DApp/completeOperation - Note right of 4DServer: The callback URL will be like: https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - ExternalPlatform ->> ExternalPlatform: Process request - ExternalPlatform ->> 4DServer: The state parameter is sent back by the third party system in the callback + Note right of 4DServer: L'URLde rappel sera du type : https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx + ExternalPlatform ->> ExternalPlatform: Traitement de la requête + ExternalPlatform ->> 4DServer: Le paramètre state est renvoyé par le système tiers dans la callback Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
    (e.g. handleOperation() function of the OperationHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
    (e.g. fonction handleOperation() du singleton OperationHandler, voir code ci-dessous) 4DServer ->> 4DServer: Session.restore() - Note over 4DServer:The state parameter is got from the received request ($req.urlQuery.state) - Note over 4DServer:The original session is retrieved by calling the restore() function - Note over 4DServer:Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer:Le paramètre state est extrait de la requête reçue ($req.urlQuery.state) + Note over 4DServer:La session originale est restaurée par l'appel à la fonction restore() + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -373,7 +373,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler @@ -382,9 +382,9 @@ shared singleton Class constructor() Session.restore($req.urlQuery.state) ``` -### Example of email validation with $4DSID +### Exemple de validation d'email avec $4DSID -1. A user account is created in a *Users* dataclass. A *$info* object is received with the email and password. An OTP corresponding to the current session is generated. An URL is then returned with this OTP given in the $4DSID parameter. +1. Un compte d'utilisateur est créé dans une dataclass *Users*. Un objet *$info* est reçu avec l'email et le mot de passe. Un OTP correspondant à la session courante est généré. Une URL est alors renvoyée avec l'OTP indiqué dans le paramètre $4DSID. ```4d //cs.Users class @@ -395,26 +395,26 @@ var $user : cs.UsersEntity var $status : Object var $token : Text -$user:=This.new() //create a new user +$user:=This.new() //créatoin d'un user $user.fromObject($info) $status:=$user.save() -//Store information in the session -//including user creation status +//Stockage d'information dans la session +//y compris le statut de création de l'utilisateur Use (Session.storage) Session.storage.status:=New shared object("step"; "Waiting for validation email"; / "email"; $user.email; "ID"; $user.ID) End use -//Generate an OTP corresponding to the session +//Génération d'un OTP correspondant à la session $token:=Session.createOTP() -// Return an URL with a $4DSID parameter +// Renvoi d'un URL avec un paramètre $4DSID return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ``` -2. The user is sent this URL as a link in an email. The URL prefix `/validateEmail` is handled by a [custom HTTP request handler](./http-request-handler.md): +2. L'utilisateur reçoit cette URL sous la forme d'un lien dans un courrier électronique. Le préfixe d'URL `/validateEmail` est traité par un [gestionnaire de requête HTTP personnalisé](./http-request-handler.md) : ```json [ @@ -427,7 +427,7 @@ return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ] ``` -The *validateEmail()* function of the RequestHandler singleton: +La fonction *validateEmail()* du singleton RequestHandler : ```4d //validateEmail class @@ -437,12 +437,12 @@ shared singleton Class constructor() Function validateEmail() : 4D.OutgoingMessage var $result:=4D.OutgoingMessage.new() - //The session which generated the OTP is retrieved - //thanks to the $4DSID parameter given in the URL + //La session qui a généré l'OTP est restaurée + //grâce au paramètre $4DSID fourni dans l'URL If (Session.storage.status.step="Waiting for validation email") $user:=ds.Users.get(Session.storage.status.ID) - $user.emailValidated() //set to true + $user.emailValidated() //fixé à vrai $result.setBody("Congratulations
    "\ +"Your email "+Session.storage.status.email+" has been validated") @@ -460,25 +460,25 @@ Function validateEmail() : 4D.OutgoingMessage ``` -Since the `$4DSID` parameter contains a valid OTP corresponding to the original session, the `Session` object refers to the session that created the OTP. +Comme le paramètre `$4DSID` contient un OTP valide correspondant à la session d'origine, l'objet `Session` référence la session qui a créé l'OTP. -A new user is created, and some information is stored in the session, especially the current step of the user account creation process (Waiting for validation email) and the user ID. +Un nouvel utilisateur est créé et des informations sont stockées dans la session, en particulier l'étape courante du processus de création du compte utilisateur (attente du courriel de validation) et l'identifiant de l'utilisateur. -### Supported contexts +### Contextes pris en charge -- Both HTTP and HTTPS schemas are supported. -- Only [scalable sessions](#enabling-web-sessions) can be reused with tokens. -- Only sessions of the host database can be reused (sessions created in component web servers cannot be restored). -- Tokens are not supported with client/server sessions or single-user sessions. +- Les schémas HTTP et HTTPS sont tous deux pris en charge. +- Seules des [sessions évolutives](#enabling-web-sessions) peuvent être réutilisées avec des tokens. +- Seules les sessions de la base de données hôte peuvent être réutilisées (les sessions créées dans les serveurs web des composants ne peuvent pas être restaurées). +- Les tokens ne sont pas pris en charge dans les sessions client/serveur ou les sessions mono-utilisateur. -### Lifespan +### Durée de vie -A session token has a lifespan, and the session itself has a lifespan. The session token lifespan can be set [at the token creation](../API/SessionClass.md#createotp). By default, the token lifespan is the same value as the [`.idleTimeout`](../API/SessionClass.md#idletimeout) value. +Un token de session a une durée de vie, et la session elle-même a une durée de vie. La durée de vie du token de session peut être définie [lors de sa création](../API/SessionClass.md#createotp). Par défaut, la durée de vie du token est la même que la valeur [`.idleTimeout`](../API/SessionClass.md#idletimeout). -A session is only restored by a token if both the session token lifespan and the session lifespan have not expired. In other cases (the session token has expired and/or the session itself has expired), a guest session is created when a web request with a session token is received. +Une session n'est restaurée par un token que si ni la durée de vie du token de session ni celle de la session n'ont expiré. Dans les autres cas (le token de session a expiré et/ou la session elle-même a expiré), une session *guest* est créée lorsqu'une requête web avec un token de session est reçue. :::note -For more information, please refer to the [Connect Your Web Apps to Third-Party Systems](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/) blog post. +Pour plus d'informations, veuillez consulter l'article de blog [Connecter vos applications Web à des systèmes tiers](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/). ::: \ No newline at end of file From dc65de04efcf63e7cf62761ee6e84aaf38e9ab30 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 19:22:49 +0200 Subject: [PATCH 021/201] New translations openaichathelper.md (Japanese) --- .../version-20-R10/aikit/Classes/OpenAIChatHelper.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatHelper.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatHelper.md index d72fcbf4b6e596..2668ad7f7d862a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatHelper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatHelper.md @@ -14,7 +14,7 @@ title: OpenAIChatHelper | `chat` | [OpenAIChatAPI](OpenAIChatAPI.md) | - | Open AI との通信で使用されるチャットAPI インスタンス。 | | `systemPrompt` | [OpenAIMessage](OpenAIMessage.md) | - | チャットアシスタントのレスポンスをガイドするためのシステムプロンプトメッセージ。 | | `numberOfMessages` | Integer | 5 | チャット履歴に保持するメッセージの最大数。 | -| `引数` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | +| `parameters` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | | `messages` | [OpenAIMessage](OpenAIMessage.md) のコレクション | [] | そのチャットセッション内でやりとりされたメッセージのコレクション。 | ## 関数 From 22190d41fe4f5911e4d8d9335e00874d418c9564 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:42:40 +0200 Subject: [PATCH 022/201] New translations session.md (French) --- .../version-20-R10/commands/session.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md index 523ed759670b5f..27b16127c8ada7 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/commands/session.md @@ -100,7 +100,7 @@ IP:port/4DACTION/action_Session [Session storage](session-storage.md) [Session API](../API/SessionClass.md) -[Web server user sessions](../WebServer/sessions.md) +[Sessions Web](../WebServer/sessions.md) [*Scalable sessions for advanced web applications* (blog post)](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ## Propriétés From 116203a409bc242daa066dcf27b93535c121e000 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:56:55 +0200 Subject: [PATCH 023/201] New translations openaitool.md (Japanese) --- .../current/aikit/Classes/OpenAITool.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md index bc638180ea1b72..c6d1be78b53a00 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md @@ -29,9 +29,9 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. ### Function-specific Properties -| プロパティ | 型 | 説明 | -| ----- | ------ | -------------------------------------------------------------------------------- | -| `引数` | Object | Parameters definition for the function using JSON schema format. | +| プロパティ | 型 | 説明 | +| ------------ | ------ | -------------------------------------------------------------------------------- | +| `parameters` | Object | Parameters definition for the function using JSON schema format. | ## Constructor From 1e38553e2a0cf197ff3e2043977dceea07e40405 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:56:59 +0200 Subject: [PATCH 024/201] New translations http-rules.md (French) --- .../current/WebServer/http-rules.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-rules.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-rules.md index c5d53afb1f666c..ebc926199d567c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-rules.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/http-rules.md @@ -11,8 +11,8 @@ To define HTTP rules, you just need to write some RegEx to declare the URL patte HTTP rules are supported in the following contexts: -- [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, -- a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). +- les [sessions extensibles](./sessions.md#enabling-web-sessions) ou [pas de sessions](../settings/web.md#no-sessions) sont activées, +- un serveur web exécuté localement par 4D ou 4D Server, y compris ceux [exécutés par des composants](./webServerObject.md). ## How to set rules @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Header | Ajouter | Set | Remove | +| ---------------- | ------- | ---------- | ------ | +| Date | Non | Non | Non | +| Content-Length | Non | Non | Non | +| Content-Encoding | Non | Non | Non | +| Vary | Oui | Non | Non | +| Set-Cookie | Oui | Add cookie | Non | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules @@ -215,7 +220,7 @@ $return:=WEB Server.start($settings) ``` -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [New Way to Control Your HTTP Responses](https://blog.4d.com/new-way-to-control-your-http-responses/) From 60af580caed0481da8a8eb59c1e5efcf54cb04ce Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:57:01 +0200 Subject: [PATCH 025/201] New translations http-rules.md (Spanish) --- .../current/WebServer/http-rules.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md index e087d1672ba793..f45b8e7388655f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md @@ -1,6 +1,6 @@ --- id: http-rules -title: HTTP Rules +title: Reglas HTTP --- You can define HTTP rules to control HTTP response headers for any requests received by the 4D web server, including REST requests. You can add, modify, or remove HTTP headers, send redirections or set the HTTP status. This feature is useful to implement security policies based upon the handling of headers. @@ -60,16 +60,21 @@ The following action keywords are supported: | `setHeaders` | Object | Name (text) and value (text) of header(s) to modify in the HTTP responses. If a header to modify does not exist in the response header, it is added. | | `denyAccess` | Boolean | true to deny access to the resource, false to allow access. When the access to a resource is denied, the web server returns a 403 status by default | | `redirect` | Text | Redirection URL. When a redirection is triggered, the web server returns a 302 status by default | -| `status` | Number | HTTP status | +| `status` | Number | Estado HTTP | ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Encabezado | Acción de añadir | Set | Remove | +| ---------------- | ---------------- | ------------- | ------ | +| Fecha | No | No | No | +| Content-Length | No | No | No | +| Content-Encoding | No | No | No | +| Vary | Sí | No | No | +| Set-Cookie | Sí | Añadir cookie | No | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From ab5256a3a99ba5b9880d6e4473602b87c66cf8a0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:57:04 +0200 Subject: [PATCH 026/201] New translations http-rules.md (Japanese) --- .../current/WebServer/http-rules.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-rules.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-rules.md index d857bb23d70623..6f6e8aacb4e491 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-rules.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-rules.md @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "日付", -- "Content-Length" +| Header | 追加 | Set | Reduce | +| ---------------- | -- | ---------- | ------ | +| Date | × | × | × | +| Content-Length | × | × | × | +| Content-Encoding | × | × | × | +| Vary | ◯ | × | × | +| Set-Cookie | ◯ | Add cookie | × | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From f9076e1851ace6d563dd840009af70eec2997440 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:57:06 +0200 Subject: [PATCH 027/201] New translations http-rules.md (Portuguese, Brazilian) --- .../current/WebServer/http-rules.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-rules.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-rules.md index a8c220ccb23587..2d09d0687cbba6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-rules.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/http-rules.md @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Header | Add | Set | Remove | +| ---------------- | --- | ---------- | ------ | +| Date | Não | Não | Não | +| Content-Length | Não | Não | Não | +| Content-Encoding | Não | Não | Não | +| Vary | Sim | Não | Não | +| Set-Cookie | Sim | Add cookie | Não | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From 9db89d2f8204af43b42af8abecbe61c8b8191c08 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:57:39 +0200 Subject: [PATCH 028/201] New translations collectionclass.md (French) --- .../version-21/API/CollectionClass.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md index 0f3efe19eef728..4988f47bd80d77 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md @@ -3216,15 +3216,15 @@ La fonction `.sort()` trie les éléments > Cette fonction modifie la collection d'origine. Si `.sort()` est appelé sans paramètres, seules les valeurs scalaires (nombres, textes, dates, booléens) sont triées. Les éléments sont triés par défaut par ordre croissant, en fonction de leur type. -You can also pass one of the following constants in the *ascOrDesc* parameter: +Vous pouvez également passer une des constantes suivantes dans le paramètre *ascOrDesc* : ``` - |Constant| Type|Value|Comment| - |---|---|---|---| - |ck ascending|Integer|0|Elements are ordered in ascending order (default)| - |ck descending|Integer|1|Elements are ordered in descending order| + |Constante| Type|Valeur|Comment| + |---|---|---| + |ck ascending|Integer|0|Les éléments sont classés par ordre croissant (par défaut)| + |ck descending|Integer|1|Les éléments sont classés par ordre décroissant| - This syntax orders scalar values in the collection only (other element types such as objects or collections are returned unordered). + Cette syntaxe ordonne uniquement les valeurs scalaires dans la collection (les autres types d'éléments tels que les objets ou les collections sont renvoyés non ordonnés). ``` Si la collection contient des éléments de différents types, ils sont d'abord groupés par type et triés par la suite. Les types sont renvoyés dans l'ordre suivant : From fd46196475f383519278962a59125c5ddcc5e46a Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:58:08 +0200 Subject: [PATCH 029/201] New translations dataclassclass.md (French) --- .../version-21/API/DataClassClass.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md index c6151a92503144..b19e8e8e1e63c4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md @@ -1181,11 +1181,11 @@ Si *attributePath* désigne un attribut stockant des [**objets vecteurs**](../AP Dans ce cas, le paramètre *value* doit être un **objet vecteur de comparaison** contenant les propriétés suivantes : -| Propriété | Type | Description | -| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| vector | [4D.Vector](../API/VectorClass.md) | Obligatoire. Le vecteur à comparer | -| metric | Text | Optionnel. [Calcul vectoriel](../API/VectorClass.md#understanding-the-different-vector-computations) à utiliser pour la recherche. You can use one of the following (Text) constants:
  • `mk cosine` (default if omitted): calculates the cosine distance between vectors.
  • `mk dot`: calculates the dot similarity of vectors.
  • `mk euclidean`: calculates the Euclidean distance between vectors. | -| threshold | Real | Facultatif (valeur par défaut : 0,5). Valeur seuil utilisée pour filtrer les comparaisons de vecteurs sur la base de leur score de similarité cosinus, point ou euclidienne selon la "métrique" sélectionnée. Il est fortement recommandé de choisir une similitude qui corresponde le mieux à votre cas d'utilisation spécifique pour des résultats optimaux. | +| Propriété | Type | Description | +| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| vector | [4D.Vector](../API/VectorClass.md) | Obligatoire. Le vecteur à comparer | +| metric | Text | Optionnel. [Calcul vectoriel](../API/VectorClass.md#understanding-the-different-vector-computations) à utiliser pour la recherche. Vous pouvez utiliser l'une des constantes (texte) suivantes
  • :`mk cosine` (par défaut si omis) : calcule la distance cosinus entre les vecteurs.
  • `mk dot` : calcule la similarité en points des vecteurs.
  • `mk euclidean` : calcule la distance euclidienne entre les vecteurs. | +| threshold | Real | Facultatif (valeur par défaut : 0,5). Valeur seuil utilisée pour filtrer les comparaisons de vecteurs sur la base de leur score de similarité cosinus, point ou euclidienne selon la "métrique" sélectionnée. Il est fortement recommandé de choisir une similitude qui corresponde le mieux à votre cas d'utilisation spécifique pour des résultats optimaux. | Seul un sous-ensemble de symboles **comparateurs** est pris en charge. Notez qu'ils comparent les résultats à la valeur de seuil (threshold) : From 38687c08cea5d7e106939ac73243999f1f6af8e8 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 20:58:51 +0200 Subject: [PATCH 030/201] New translations entityclass.md (French) --- .../version-21/API/EntityClass.md | 80 +++++++++---------- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index 2d89f983655f8e..013fbf6415a56d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -335,10 +335,10 @@ vCompareResult3 (seules les différences sur les attributs touchés de $e1 sont
    Historique -| Release | Modifications | -| ------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Ajout | +| Release | Modifications | +| ------- | ------------------------ | +| 21 | Ajout des statuts 7 et 8 | +| 17 | Ajout |
    @@ -365,7 +365,7 @@ Sinon, vous pouvez passer l'option `dk force drop if stamp changed` dans le para **Résultat** -The object returned by `.drop()` contains the following properties: +L'objet renvoyé par `.drop()` contient les propriétés suivantes : | Propriété | | Type | Description | | --------------------------------- | ----------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -390,15 +390,15 @@ The object returned by `.drop()` contains the following properties: (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using entity.drop(), this error can be returned when dk force drop if stamp changed option is used. When using entity.lock(), this error can be returned when dk reload if stamp changed option is used.
    • **Associated statusText**: "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | -| `dk status validation failed` | 7 | Non fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Mild Validation Error" | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | -| `dk status serious validation error` | 8 | Fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used
  • **Associated statusText**: "Stamp has changed"
    • | -| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de entity.drop(), cette erreur peut être renvoyée lorsque l'option dk force drop if stamp changed est utilisée. Lors de l'utilisation de entity.lock(), cette erreur peut être renvoyée si l'option dk reload if stamp changed est utilisée.
    • \*\*statusText associé : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | +| `dk status validation failed` | 7 | Erreur non fatale envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Mild Validation Error" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | +| `dk status serious validation error` | 8 | Erreur critique envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Serious Validation Error" | +| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur uniquement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()` : erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée
  • **statusText associé** : "Stamp has chaged"
    • | +| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | #### Exemple 1 @@ -512,7 +512,7 @@ La correspondance entre l'objet et l'entité est établie à partir des noms de - Si une propriété de l'objet n'existe pas dans la dataclass, elle est ignorée. - Les types de données doivent être équivalents. S'il existe une différence de type entre l'objet et la dataclass, 4D essaie de convertir les données lorsque cela est possible (voir [`Converting data types`](Concepts/data-types.md#converting-data-types)), sinon l'attribut est laissé intact. -- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. +- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si elle n'existe pas déjà dans la dataclass, l'entité est créée avec la valeur donnée lorsque [.save()](#save) est appelée. Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. *filler* peut contenir une related entity dans les conditions suivantes : @@ -1011,13 +1011,13 @@ L'objet retourné par `.lock()` contient les propriétés suivantes : (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | -| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option dk force drop if stamp changed est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | +| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | +| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur seulement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()` : erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée

    • **statusText associé** : "Stamp has changed" | #### Exemple 1 @@ -1178,10 +1178,10 @@ L'objet retourné par `.reload( )` contient les propriétés suivantes : (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when `dk force drop if stamp changed` option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • ***statusText associé***: "Entity does not exist anymore" | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    ***statusText associé*** : "Other error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option `dk force drop if stamp changed` est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • ***statusText associé***: "Entity does not exist anymore" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    ***statusText associé*** : "Other error" | #### Exemple @@ -1210,10 +1210,10 @@ L'objet retourné par `.reload( )` contient les propriétés suivantes :
    Historique -| Release | Modifications | -| ------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Ajout | +| Release | Modifications | +| ------- | ------------------------ | +| 21 | Ajout des statuts 7 et 8 | +| 17 | Ajout |
    @@ -1273,16 +1273,16 @@ L'objet retourné par `.save()` contient les propriétés suivantes : Les valeurs suivantes peuvent être retournées dans les propriétés `status` et `statusText` de l'objet Résultat en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status automerge failed` | 6 | (Only if the `dk auto merge` option is used) The automatic merge option failed when saving the entity. **Associated statusText**: "Auto merge failed" | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when `dk force drop if stamp changed` option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste. **statusText associé** : "Already locked" | -| `dk status validation failed` | 7 | Non fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Mild Validation Error" | -| `dk status serious error` | 4 | A serious error is a low-level database error (e.g. duplicated key), a hardware error, etc. **Associated statusText**: "Other error" | -| `dk status serious validation error` | 8 | Fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | -| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status automerge failed` | 6 | (Seulement si l'option `dk auto merge` est utilisée) L'option de fusion automatique a échoué lors de la sauvegarde de l'entité. \*\*statusText associé : "Auto merge failed" | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option `dk force drop if stamp changed` est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste. **statusText associé** : "Already locked" | +| `dk status validation failed` | 7 | Erreur non fatale envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Mild Validation Error" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc. **statusText associé** : "Other error" | +| `dk status serious validation error` | 8 | Erreur critique envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Serious Validation Error" | +| `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur seulement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()` : erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée

    • **Associated statusText** : "Stamp has changed" | +| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | #### Exemple 1 From a35c7e2e35affde79ab0f87ea352a0f2d032a8cf Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 21:07:21 +0200 Subject: [PATCH 031/201] New translations clientserver.md (French) --- .../version-21/Desktop/clientServer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md index 1217eff7a00779..9ece18d4745892 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md @@ -128,7 +128,7 @@ Note that [privileges](../ORDA/privileges.md) should be set in the session befor Shared sessions are handled through [OTP tokens](../WebServer/sessions.md#session-token-otp). After you created an OTP token on the server for the user session, you add the token (through the `$4DSID` parameter value) to web requests sent from web areas containing Qodly pages so that the user session on the server is identified and shared. On the web server side, if a web request contains an *OTP id* in the $4DSID parameter, the session corresponding to this OTP token is used. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [Share your 4D remote client session with web accesses](https://blog.4d.com/share-your-4d-remote-client-session-with-web-accesses) From 5c885b45f8c19c0a6190d0c386b956ab10999003 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 21:07:53 +0200 Subject: [PATCH 032/201] New translations onafteredit.md (French) --- .../version-21/Events/onAfterEdit.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md index 1b7faf45be6041..0850656f6df974 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md @@ -62,11 +62,11 @@ En fonction de la valeur de la propriété `action`, l'[objet event](overview.md #### action = DragFillBlock -| Propriété | Type | Description | -| ------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | Plage utilisée pour le remplissage | -| autoFillType | entier long | Value used for the fill.
  • 0: Cells are filled with all data (values, formatting, and formulas)
  • 1: Cells are filled with automatically sequential data
  • 2: Cells are filled with formatting only
  • 3: Cells are filled with values but not formatting
  • 4: Values are removed from the cells
  • 5: Cells are filled automatically
    • | -| fillDirection | entier long | Direction of the fill.
  • 0: The cells to the left are filled
  • 1: The cells to the right are filled
  • 2: The cells above are filled
  • 3: The cells below are filled
    • | +| Propriété | Type | Description | +| ------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | Plage utilisée pour le remplissage | +| autoFillType | entier long | Valeur utilisée pour le remplissage.
  • 0 : Les cellules sont remplies avec toutes les données (valeurs, formatage et formules)
  • 1 : Les cellules sont remplies avec des données séquentielles automatiques
  • 2 : Les cellules sont remplies avec la mise en forme uniquement
  • 3 : Les cellules sont remplies avec les valeurs mais pas la mise en forme
  • 4 : Les valeurs sont supprimées des cellules
  • 5 : Les cellules sont remplies automatiquement
    • | +| fillDirection | entier long | Direction du remplissage.
  • 0 : Les cellules de gauche sont remplies
  • 1 : Les cellules de droite sont remplies
  • 2 : Les cellules du haut sont remplies
  • 3 : Les cellules du bas sont remplies
    • | #### action = formulaChanged From 84423099d82bc6ca336df7a2ee33463d4e295d8c Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:07:39 +0200 Subject: [PATCH 033/201] New translations webarea_overview.md (Japanese) --- .../version-21/FormObjects/webArea_overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/webArea_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/webArea_overview.md index f75f96f240a10d..f9f51797c37684 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/webArea_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/webArea_overview.md @@ -206,7 +206,7 @@ Windows においては、Webエリアから、同じ 4Dアプリケーション ### プロトコルの挿入 (macOS) -macOS 上の Webエリアで、プログラムにより処理される URL は、プロトコルで開始されていなければなりません。 つまり、"www.mysite.com" ではなく、"http://www.mysite.com" 文字列を渡さなければならないということです。 +macOS 上の Webエリアで、プログラムにより処理される URL は、プロトコルで開始されていなければなりません。 つまり、"www.mysite.com" ではな、"http://www.mysite.com" 文字列を渡さなければならないということです。 ## Webインスペクターへのアクセス From 5902ce58144e48a3563621f24007647e723feb1e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:08:48 +0200 Subject: [PATCH 034/201] New translations creating.md (French) --- .../docusaurus-plugin-content-docs/version-21/Menus/creating.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Menus/creating.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Menus/creating.md index d79f92455ae1b2..8ebe9c62f66df2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Menus/creating.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Menus/creating.md @@ -33,7 +33,7 @@ Vous pouvez modifier cette barre de menus comme vous le souhaitez ou créer des 1. Sélectionnez l'élément que vous souhaitez créer et cliquez sur le bouton ajouter ![](../assets/en/Menus/PlussNew.png) sous la barre de menu. OU Choisissez la commande **Créer une nouvelle barre de menus** ou **Créer un nouveau menu** dans le menu contextuel de la liste ou dans le menu d’options situé sous la liste. - Si vous avez créé une barre de menus, une nouvelle barre de menus apparaît dans la liste, contenant les menus par défaut (Fichier et Edition). + Si vous avez créé une barre de menu, une nouvelle barre de menus apparaît dans la liste, contenant les menus par défaut (Fichier et Edition). 2. (Facultatif) Effectuez un double-clic sur le nom du menu/de la barre de menus afin de le rendre éditable et saisissez un nom personnalisé. OU Saisissez le nom personnalisé dans la zone “Titre”. From e766dca062611f1f3cdaf276d8f3311be91c9704 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:08 +0200 Subject: [PATCH 035/201] New translations updates.md (French) --- .../version-21/Notes/updates.md | 139 +++++++++--------- 1 file changed, 70 insertions(+), 69 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Notes/updates.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Notes/updates.md index efc6f3254a2bd7..41d9e35ed7eddf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Notes/updates.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Notes/updates.md @@ -9,49 +9,50 @@ Lisez [**Les nouveautés de 4D 21**](https://blog.4d.com/fe-whats-new-in-4d-v21/ #### Points forts -- Support of AI Vector Searches in the [`query()`](../API/DataClassClass.md#query-by-vector-similarity) function and in the [`$filter`](../REST/$filter.md#vector-similarity) REST API. -- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. -- Serveur Web: - - new [HTTP rules](../WebServer/http-rules.md) to customize HTTP response headers, - - ability to set [HTTP request handlers](../WebServer/http-request-handler.md) using a `handlers` property in the *settings* parameter of the Web server [`start()`](../API/WebServerClass.md#start) function, - - the Web server object contains new [`rules`](../API/WebServerClass.md#rules) and [`handlers`](../API/WebServerClass.md#handlers) properties. -- New [ORDA events on data](../ORDA/orda-events.md): validateSave, saving, afterSave, validateDrop, dropping, afterDrop. -- New option allowing to use certificates from Windows Certificate Store instead of a local certificates folder in [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) and [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew) classes. -- Client/server: - - You can display Qodly pages in Web areas and [share the remote client session](../Desktop/clientServer.md#sharing-the-session-with-qodly-pages-in-web-areas). - - The [QUIC network layer](../settings/client-server.md#network-layer) has been enhanced to handle network interface changes transparently, for example when you travel with your laptop. See [this blog post](https://blog.4d.com/work-and-move-with-quic-and-network-switching). -- You can now [create components directly from the host project](../Extensions/develop-components.md#creating-components) and [edit their code from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer without leaving or restarting the project. -- The 4D product activation step has been simplified and automated during [sign-in](../GettingStarted/Installation.md#sign-in). -- 4D AIKit component: new features to [invoke a specific tool automatically](../aikit/Classes/OpenAIChatHelper.md#registertool) and [specify a response format](../aikit/Classes/OpenAIChatCompletionsParameters.md#response-format). -- Langage 4D: - - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). +- Prise en charge des recherches vectorielles d'IA dans la fonction [`query()`](../API/DataClassClass.md#query-by-vector-similarity) et dans l'API REST [`$filter`](../REST/$filter.md#vector-similarity). +- Prise en charge du cryptage TLS pour la classe [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew). +- Serveur Web : + - nouvelles [*HTTP rules*](../WebServer/http-rules.md) pour personnaliser les en-têtes de réponse HTTP, + - possibilité de définir des [gestionnaires de requêtes HTTP](../WebServer/http-request-handler.md) en utilisant une propriété `handlers` dans le paramètre *settings* de la fonction [`start()`](../API/WebServerClass.md#start) du serveur Web, + - l'objet serveur Web contient de nouvelles propriétés [`rules`](../API/WebServerClass.md#rules) et [`handlers`](../API/WebServerClass.md#handlers). +- Nouveaux [événements ORDA sur les données](../ORDA/orda-events.md) : validateSave, saving, afterSave, validateDrop, dropping, afterDrop. +- Nouvelle option permettant d'utiliser les certificats du Windows Certificate Store au lieu d'un dossier de certificats locaux dans les classes [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) et [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew). +- Client/serveur : + - Vous pouvez afficher des pages Qodly dans des zones Web et [partager la session du client distant](../Desktop/clientServer.md#sharing-the-session-with-qodly-pages-in-web-areas). + - La [couche réseau QUIC](../settings/client-server.md#network-layer) a été renforcée pour gérer les changements d'interface réseau de manière transparente, par exemple lorsque vous voyagez avec votre ordinateur portable. Plus d'informations dans [cet article de blog](https://blog.4d.com/work-and-move-with-quic-and-network-switching). +- Vous pouvez désormais [créer des composants directement à partir du projet hôte](../Extensions/develop-components.md#creating-components) et [éditer leur code à partir d'un onglet dédié](../Extensions/develop-components.md#editing-all-component-code) dans l'explorateur 4D sans quitter ou redémarrer le projet. +- L'étape d'activation du produit 4D a été simplifiée et automatisée lors de la [connexion](../GettingStarted/Installation.md#sign-in). +- Composant 4D AIKit : nouvelles fonctionnalités pour [invoquer un outil spécifique automatiquement](../aikit/Classes/OpenAIChatHelper.md#registertool) et [spécifier un format de réponse](../aikit/Classes/OpenAIChatCompletionsParameters.md#response-format). +- Langage 4D : + - Nouvelles commandes "trim" pour supprimer les espaces de début et de fin d'une chaîne : [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), et [`Trim end`](../commands/trim-end.md). + - Les commandes [`Num`](../commands/num.md) et [`String`](../commands/string.md) ont été mises à jour pour prendre en charge des conversions dans différentes bases (radix). +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=21) : liste de tous les bugs qui ont été corrigés dans 4D 21. #### Developer Preview -[**Fluent UI** rendering for 4D forms](../FormEditor/forms.md#fluent-ui-rendering-developer-preview) is proposed in Developer Preview during the beta test program. +Le [rendu **Fluent UI** pour les formulaires 4D](../FormEditor/forms.md#fluent-ui-rendering-developer-preview) est proposé en Developer Preview pendant le programme de bêta-test. #### Changements de comportement -:::caution Index rebuild +:::caution Reconstruction d'index -4D 21 includes an ICU library update ([see below](#library-table)) which will force an automatic rebuild of indexes of type alpha, text, and object. En fonction de la taille du fichier de données, cette opération peut prendre un certain temps et nécessiter une planification. +4D 21 inclut une mise à jour de la bibliothèque ICU ([voir ci-dessous](#library-table)) qui forcera une reconstruction automatique des index de type alpha, texte et objet. En fonction de la taille du fichier de données, cette opération peut prendre un certain temps et nécessiter une planification. ::: -- Web services (SOAP): when [scalable sessions](../WebServer/sessions.md#enabling-web-sessions) are enabled, web services now run in [**preemptive processes**](../Develop/preemptive.md) in compiled mode. Make sure your SOAP code is thread-safe. -- Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. -- Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). -- The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    +- Services web (SOAP) : lorsque les [sessions évolutives](../WebServer/sessions.md#enabling-web-sessions) sont activées, les services web s'exécutent désormais dans des [**process préemptifs**](../Develop/preemptive.md) en mode compilé. Assurez-vous que votre code SOAP est thread-safe. +- Serveur web : la prise en charge des URLs dépréciés `4DSYNC/` et `4DCGI/` est supprimée. Plus aucun traitement spécifique n'est effectué sur ces URLs. +- Les sessions utilisateurs Web sont désormais renvoyées par [`Process activity`](../commands/process-activity.md). +- La commande [`HIGHLIGHT TEXT`](../commands/highlight-text) est maintenant prise en charge dans le contexte des sous-formulaires. +- **Les composants ne sont plus intégrés** : à partir de 4D 21, les composants développés par 4D (4D NetKit, 4D SVG..., voir [cette liste](../Extensions/overview.md#components-developed-by-4d)) ne sont plus intégrés dans l'application 4D. Lors de la mise à jour d'un projet vers 4D 21 ou supérieur, une boîte de dialogue s'affiche :
    ![alt-text](../assets/en/getStart/convert.png)
    - \- **Import**: import automatically 4D components as dependencies to the project
    - \- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
    - \- **Ask later**: do not import components and display the dialog at the next project opening. + \- **Import**/**Importer** : importer automatiquement les composants 4D comme dépendances du projet
    + \- **Ignore**/**Ignorer** : ne pas importer les composants et vous laisser [gérer les composants manuellement](../Project/components.md)
    + \- **Ask later**/**Redemander** : ne pas importer les composants et afficher la boîte de dialogue lors de la prochaine ouverture du projet. :::note -In binary databases, you need to select the required components in the 4D installer or download them from the [4D Product Download portal](https://product-download.4d.com/?type=components). +Dans les bases de données binaires, vous devez sélectionner les composants requis dans le programme d'installation de 4D ou les télécharger à partir du [portail de téléchargement des produits 4D](https://product-download.4d.com/?type=components). ::: @@ -61,30 +62,30 @@ Lisez [**Les nouveautés de 4D 20 R10**](https://blog.4d.com/fe-whats-new-in-4d- #### Points forts -- Handling of [ORDA events on data](../ORDA/orda-events.md). +- Gestion des [événements ORDA sur les données](../ORDA/orda-events.md). - Nouvelle option `connectionTimeout` dans le paramètre [`options`](../API/TCPConnectionClass.md#options-parameter) de la fonction [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew). -- New [`4D.Vector`](../API/VectorClass.md) class to process and compare vectors, usually calculated by AIs. -- New options to generate UUIDs in **version 7** for [4D automatic fields](../settings/database.md#auto-uuid-version) and [`Generate UUID`](../commands/generate-uuid) command. -- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). -- New [`.promote()`](../API/SessionClass.md#promote) and [`.demote()`](../API/SessionClass.md#demote) functions in the [Session class](../API/SessionClass.md) to dynamically add/remove privileges in a web process. -- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. -- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. -- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. -- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. -- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). -- Langage 4D: +- Nouvelle classe [`4D.Vector`](../API/VectorClass.md) pour traiter et comparer des vecteurs, généralement calculés par des IA. +- Nouvelles options pour générer des UUIDs en **version 7** pour les [champs 4D automatiques](../settings/database.md#auto-uuid-version) et la commande [`Generate UUID`](../commands/generate-uuid). +- Nouvelles classes [`UDPSocket`](../API/UDPSocketClass.md) et [`UDPEvent`](../API/UDPEventClass.md) pour envoyer des données en utilisant des sockets UDP. Prise en charge de la journalisation détaillée des événements UDP dans le fichier journal [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) (anciennement nommé `4DTCPLog.txt`). +- Nouvelles fonctions [`.promote()`](../API/SessionClass.md#promote) et [`.demote()`](../API/SessionClass.md#demote) dans la [classe Session](../API/SessionClass.md) pour ajouter/supprimer dynamiquement des privilèges dans un process web. +- [Sélection automatique des licences à intégrer](../Desktop/building.md#application-automatically-embedding-available-licenses) dans la boîte de dialogue du Générateur d'application, modification de la commande [`Create deployment license`](../commands/create-deployment-license.md), nouvelle clé xml BuildApplication [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html). +- Sécurité renforcée pour le copier/coller de formules dans [4D Write Pro](../WritePro/managing-formulas.md) et les [zones de texte stylées](../FormObjects/input_overview.md) : les formules copiées depuis l'extérieur de l'application 4D en cours sont désormais toujours collées en tant que valeurs uniquement. +- Composant 4D AIKit : nouvelle classe [OpenAIEmbeddingsAPI](../aikit/Classes/OpenAIEmbeddingsAPI.md) pour créer des embeddings à l'aide de l'API OpenAI. +- Vous pouvez [associer une classe](../Develop/field-properties.md) à un champ objet dans l'éditeur de structure. +- Gestion automatique des [dépendances récursives](../Project/components.md#automatic-dependency-resolution). +- Langage 4D : - Pour des raisons de cohérence, les commandes [`Create entity selection`](../commands/create-entity-selection.md) et [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) ont été déplacées du thème ["4D Environnement"](../commands/theme/4D_Environment.md) vers le thème ["Sélections"](../commands/theme/Selection.md). - Nouvelles commandes [`OBJET SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) et [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) pour assigner et lire les objets `Formula` comme sources de données pour les objets de formulaire. - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) et [`LISTBOX Get property`](../commands/listbox-get-property.md) prennent en charge trois nouvelles constantes : `lk current item`, `lk current item position`, et `lk selected items expression`. -- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R10) : liste de tous les bugs qui ont été corrigés dans 4D 20 R10. #### Changements de comportement - Sous Windows, les polices d'imprimante courantes destinées uniquement à l'impression (c'est-à-dire non utilisables à l'écran) ne sont plus chargées par 4D au démarrage. -- The *MeCab* library has been removed. This change only affects the processing of Japanese text. -- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. -- [`.hasPrivilege()`](../API/SessionClass.md#hasprivilege) returns True for promoted privileges in the web process. -- The [`Time`](../commands/time) command now returns a negative time expression when the *timeValue* parameter is negative. For instance, `Time("-01:02:03")` will return **-01:02:03**. In previous releases, the negative sign was ignored. +- La bibliothèque *MeCab* a été supprimée. Cette modification n'affecte que le traitement du texte japonais. +- Lorsqu'une variable objet ou un paramètre objet est déclaré(e) avec un type ["cs" class](../Concepts/classes.md#cs), son affectation à une instance d'objet d'une classe différente génère désormais une erreur de syntaxe. +- [`.hasPrivilege()`](../API/SessionClass.md#hasprivilege) renvoie True pour les privilèges promus dans le process web. +- La commande [`Time`](../commands/time) renvoie désormais une expression temporelle négative lorsque le paramètre *timeValue* est négatif. Par exemple, `Time("-01:02:03")` renverra **-01:02:03**. Dans les versions précédentes, le signe moins était ignoré. ## 4D 20 R9 @@ -95,7 +96,7 @@ Lisez [**Les nouveautés de 4D 20 R9**](https://blog.4d.com/fe-whats-new-in-4d-2 - La bibliothèque [*MeCab*](../settings/database.md#support-of-mecab-japanese-version) est désormais obsolète et sera supprimée dans la prochaine version. - Prise en charge des [tokens de session](../WebServer/sessions.md#session-token-otp) gérés avec les nouvelles fonctions [`Session.createOTP()`](../API/SessionClass.md#createotp) et [`Session.restore()`](../API/SessionClass.md#restore). - L'assistant d'étiquettes utilise maintenant l'éditeur de formules pour ajouter ou éditer des formules dans la [zone de construction du modèle](../Desktop/labels.md#label-preview). -- New [`TCPListener`](../API/TCPListenerClass.md) class to create TCP server connections; new properties in related classes: `address`, `listener` and `port` in [`TCPConnection`](../API/TCPConnectionClass.md) class, `address` and `port` in [`TCPEvent`](../API/TCPEventClass.md) class. +- Nouvelle classe [`TCPListener`](../API/TCPListenerClass.md) pour créer des connexions à un serveur TCP ; nouvelles propriétés dans les classes associées : `address`, `listener` et `port` dans la classe [`TCPConnection`](../API/TCPConnectionClass.md), `address` et `port` dans la classe [`TCPEvent`](../API/TCPEventClass.md). - Les commandes et constantes obsolètes génèrent maintenant des warnings spécifiques dans le [live checker et le compilateur](../code-editor/write-class-method.md#warnings-and-errors). Vous pouvez savoir si une commande est obsolète en utilisant la commande [`Command name`](../commands/command-name.md). - Nouvelles commandes [WA SET CONTEXT](../commands/wa-set-context.md) et [WA Get context](../commands/wa-get-context.md) pour contrôler le contenu de [$4d](../FormObjects/webArea_overview.md#4d-object) dans les zones web. - Nouveau paramètre de base de données [`RDP optimization`](../commands-legacy/set-database-parameter.md#rdp-optimization-133) pour optimiser par exemple le presse-papiers partagé lors de l'utilisation du protocole de bureau distant avec 4D. @@ -127,7 +128,7 @@ Lisez [**Les nouveautés de 4D 20 R8**](https://blog.4d.com/fe-whats-new-in-4d-2 - Les commandes suivantes acceptent maintenant des paramètres tels que des objets ou des collections : [WP SET ATTRIBUTES](../WritePro/commands/wp-set-attributes.md), [WP Get Attributes](../WritePro/commands/wp-get-attributes.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md), [WP Table append row](../WritePro/commands/wp-table-append-row.md), [WP Import document](../WritePro/commands/wp-import-document.md), [WP EXPORT DOCUMENT](../WritePro/commands/wp-export-document.md), [WP Add picture](../WritePro/commands/wp-add-picture.md), et [WP Insert picture] (../WritePro/commands/wp-insert-picture.md). - [WP Insert formula](../WritePro/commands/wp-insert-formula.md), [WP Insert document body](../WritePro/commands/wp-insert-document-body.md), et [WP Insert break](../WritePro/commands/wp-insert-break.md), sont maintenant des fonctions qui retournent des plages. - Nouvelles expressions liées aux attributs de documents : [This.sectionIndex](../WritePro/managing-formulas.md), [This.sectionName](../WritePro/managing-formulas.md) et [This.pageIndex](../WritePro/managing-formulas.md). -- Langage 4D: +- Langage 4D : - Commande modifiée : [`FORM EDIT`](../commands/form-edit.md) - Les fonctions [`.sign()`](../API/CryptoKeyClass.md#sign) et [`.verify()`](../API/CryptoKeyClass.md#verify) de la [classe 4D.CryptoKey](../API/CryptoKeyClass.md) prennent en charge des Blobs dans le paramètre *message*. - [**Liste des bugs corrigés**](https://bugs.4d.fr/fixedbugslist?version=20_R8) : liste de tous les bugs qui ont été corrigés dans 4D 20 R8. @@ -153,10 +154,10 @@ Lisez [**Les nouveautés de 4D 20 R7**](https://blog.4d.com/fe-whats-new-in-4d-2 - Qodly Studio : Vous pouvez maintenant [attacher le débogueur Qodly à 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server). - Nouvelles clés Build Application pour que les applications 4D distantes valident les [signatures](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateAuthoritiesCertificates.300-7425900.fe.html) et/ou les [domaines](https://doc.4d.com/4Dv20R7/4D/20-R7/CertificateDomainName.300-7425906.fe.html) des autorités de certification des serveurs. - Possibilité de [construire des applications autonomes sans licences intégrées](../Desktop/building.md#licenses). -- Langage 4D: +- Langage 4D : - Nouvelles commandes : [Process info](../commands/process-info.md), [Session info](../commands/session-info.md), [SET WINDOW DOCUMENT ICON](../commands/set-window-document-icon.md) - Commandes modifiées : [Process activity](../commands/process-activity.md), [Process number](../commands/process-number.md) - - Deprecated commands (replacement): `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) and [#DECLARE/Function](../Concepts/parameters.md#declaring-parameters) declarations). Deprecated commands are prefixed with "\*o\*". + - Commandes obsolètes (remplacement) : `GET LAST ERROR STACK` ([Last errors](../commands/last-errors.md)), `GET SERIAL INFORMATION` ([License info](../commands/license-info.md)), `PROCESS PROPERTIES` ([Process info](../commands/process-info.md)), `SET SCREEN DEPTH`, `C_XXX` commands ([var](../Concepts/variables.md#declaring-variables) et [#DECLARE/déclarations Function](../Concepts/parameters.md#declaring-parameters) ). Les commandes obsolètes sont précédées du préfixe "\*o\*". - 4D Write Pro : - Nouvelle commande : [WP DELETE SECTION](../WritePro/commands/wp-delete-section.md) - Commandes modifiées : [WP DELETE SUBSECTION](../WritePro/commands/wp-delete-subsection.md), [WP RESET ATTRIBUTES](../WritePro/commands/wp-reset-attributes.md) @@ -291,23 +292,23 @@ Voir [**Release Notes pour 4D 20.x LTS**](../../version-20/Notes/updates.md). ## Tableau des bibliothèques -| Bibliothèque | Version courante | Mise à jour dans 4D | Commentaire | -| ------------ | -------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -| BoringSSL | fa47b1d | **21** | Utilisé pour QUIC | -| CEF | 7258 | **21** | Chromium 139 | -| Hunspell | 1.7.2 | 20 | Utilisé pour la vérification orthographique dans les formulaires 4D et 4D Write Pro | -| ICU | 77.1 | **21** | This upgrade forces an automatic rebuild of alphanumeric, text and object indexes. | -| libldap | 2.6.10 | **21** | | -| libsasl | 2.1.28 | 20 | | -| Liblsquic | 4.2.0 | 20 R10 | Utilisé pour QUIC | -| Libuv | 1.51.0 | **21** | Utilisé pour QUIC | -| libZip | 1.11.4 | **21** | Utilisé par les classes zip, 4D Write Pro, les composants svg et serverNet | -| LZMA | 5.8.1 | **21** | | -| ngtcp2 | 1.16.0 | **21** | Utilisé pour QUIC | -| OpenSSL | 3.5.2 | **21** | | -| PDFWriter | 4.7.0 | **21** | Used for [`WP Export document`](../WritePro/commands/wp-export-document.md) and [`WP Export variable`](../WritePro/commands/wp-export-variable.md) | -| PHP | 8.2.4 | 20 | | -| SpreadJS | 17.1.0 | 20 R7 | Voir [ce blog post](https://blog.4d.com/4d-view-pro-whats-new-in-4d-20-r7/) pour un aperçu des nouvelles fonctionnalités. | -| webKit | WKWebView | 19 | | -| Xerces | 3.3.0 | **21** | Used for XML commands | -| Zlib | 1.3.1 | **21** | | +| Bibliothèque | Version courante | Mise à jour dans 4D | Commentaire | +| ------------ | -------------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | +| BoringSSL | fa47b1d | **21** | Utilisé pour QUIC | +| CEF | 7258 | **21** | Chromium 139 | +| Hunspell | 1.7.2 | 20 | Utilisé pour la vérification orthographique dans les formulaires 4D et 4D Write Pro | +| ICU | 77.1 | **21** | Cette mise à jour entraîne une reconstruction automatique des index alphanumériques, textes et objets. | +| libldap | 2.6.10 | **21** | | +| libsasl | 2.1.28 | 20 | | +| Liblsquic | 4.2.0 | 20 R10 | Utilisé pour QUIC | +| Libuv | 1.51.0 | **21** | Utilisé pour QUIC | +| libZip | 1.11.4 | **21** | Utilisé par les classes zip, 4D Write Pro, les composants svg et serverNet | +| LZMA | 5.8.1 | **21** | | +| ngtcp2 | 1.16.0 | **21** | Utilisé pour QUIC | +| OpenSSL | 3.5.2 | **21** | | +| PDFWriter | 4.7.0 | **21** | Utilisé pour [`WP Export document`](../WritePro/commands/wp-export-document.md) et [`WP Export variable`](../WritePro/commands/wp-export-variable.md) | +| PHP | 8.2.4 | 20 | | +| SpreadJS | 17.1.0 | 20 R7 | Voir [ce blog post](https://blog.4d.com/4d-view-pro-whats-new-in-4d-20-r7/) pour un aperçu des nouvelles fonctionnalités. | +| webKit | WKWebView | 19 | | +| Xerces | 3.3.0 | **21** | Utilisé pour les commandes XML | +| Zlib | 1.3.1 | **21** | | From 50414576a6011849eba8e679a0bab72da9a15222 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:11 +0200 Subject: [PATCH 036/201] New translations updates.md (Spanish) --- .../docusaurus-plugin-content-docs/version-21/Notes/updates.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/version-21/Notes/updates.md index b730b0bbfb1492..8d14d4fd39ce5a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/Notes/updates.md @@ -26,6 +26,7 @@ Lea [**Novedades en 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), la ent - Lenguaje 4D: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - Los comandos [`Num`](../commands/num.md) y [`String`](../commands/string.md) han sido actualizados para soportar conversiones en diferentes bases (radix). +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=21): list of all bugs that have been fixed in 4D 21. #### Vista previa para desarrolladores @@ -43,7 +44,7 @@ Lea [**Novedades en 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), la ent - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. Ya no se realiza ningún tratamiento específico en estas URL. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    +- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    ![alt-text](../assets/en/getStart/convert.png)
    \- **Import**: import automatically 4D components as dependencies to the project
    \- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
    From 521ca465b79c35e75d51c4eb9fd8143b25dc7525 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:14 +0200 Subject: [PATCH 037/201] New translations updates.md (Japanese) --- .../version-21/Notes/updates.md | 61 ++++++++++--------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Notes/updates.md index eb435eba5b6f23..2a1c5bf455b87a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Notes/updates.md @@ -5,27 +5,28 @@ title: リリースノート ## 4D 21 -Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), the blog post that lists all new features and enhancements in 4D 21. +[**4D 21 での新機能**](https://blog.4d.com/en-whats-new-in-4d-21/): 4D 21 の新機能と拡張機能をすべてリストアップしたブログ記事です。 #### ハイライト -- Support of AI Vector Searches in the [`query()`](../API/DataClassClass.md#query-by-vector-similarity) function and in the [`$filter`](../REST/$filter.md#vector-similarity) REST API. -- Support of TLS encryption for the [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) class. +- [`query()`](../API/DataClassClass.md#ベクトル類似度でのクエリ) 関数と、[`$filter`](../REST/$filter.md#vector-similarity) REST API 内でのAI ベクトル検索のサポート。 +- [4D.TCPConnection](../API/TCPConnectionClass.md#4dtcpconnectionnew) クラスにおけるTLS 暗号化のサポート。 - Web サーバー: - - new [HTTP rules](../WebServer/http-rules.md) to customize HTTP response headers, - - ability to set [HTTP request handlers](../WebServer/http-request-handler.md) using a `handlers` property in the *settings* parameter of the Web server [`start()`](../API/WebServerClass.md#start) function, - - the Web server object contains new [`rules`](../API/WebServerClass.md#rules) and [`handlers`](../API/WebServerClass.md#handlers) properties. -- New [ORDA events on data](../ORDA/orda-events.md): validateSave, saving, afterSave, validateDrop, dropping, afterDrop. -- New option allowing to use certificates from Windows Certificate Store instead of a local certificates folder in [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) and [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew) classes. -- Client/server: - - You can display Qodly pages in Web areas and [share the remote client session](../Desktop/clientServer.md#sharing-the-session-with-qodly-pages-in-web-areas). - - The [QUIC network layer](../settings/client-server.md#network-layer) has been enhanced to handle network interface changes transparently, for example when you travel with your laptop. See [this blog post](https://blog.4d.com/work-and-move-with-quic-and-network-switching). -- You can now [create components directly from the host project](../Extensions/develop-components.md#creating-components) and [edit their code from a dedicated tab](../Extensions/develop-components.md#editing-all-component-code) in the 4D Explorer without leaving or restarting the project. -- The 4D product activation step has been simplified and automated during [sign-in](../GettingStarted/Installation.md#sign-in). -- 4D AIKit component: new features to [invoke a specific tool automatically](../aikit/Classes/OpenAIChatHelper.md#registertool) and [specify a response format](../aikit/Classes/OpenAIChatCompletionsParameters.md#response-format). + - 新しい [HTTP ルール](../WebServer/http-rules.md) を使用することでHTTP レスポンスヘッダーをカスタマイズすることができます。 + - Web サーバーの[`start()`](../API/WebServerClass.md#start) 関数の*settings* 引数内の`handlers` プロパティを使用することで、[HTTP リクエストハンドラー](../WebServer/http-request-handler.md) を設定することができます。 + - Web サーバーオブジェクトには新しい[`rules`](../API/WebServerClass.md#rules) and [`handlers`](../API/WebServerClass.md#handlers) プロパティが含まれます。 +- 新しい[データに対するORDA イベント](../ORDA/orda-events.md): validateSave、saving、afterSave、validateDrop、dropping、afterDrop +- [`HTTPRequest`](../API/HTTPRequestClass.md#4dhttprequestnew) および [`HTTPAgent`](../API/HTTPAgentClass.md#4dhttpagentnew) クラスにおいて、ローカルの証明書フォルダの代わりにWindows 証明書ストアからの証明書を使用することを許可する新しいオプション。 +- クライアント/サーバー: + - Web エリア内でQodly ページを表示し、[リモートクライアントセッションを共有](../Desktop/clientServer.md#web-エリア内のqodly-ページでセッションを共有する)することができるようになりました。 + - [QUIC ネットワークレイヤー](../settings/client-server.md#ネットワークレイヤー) はネットワークインターフェースの変更(例えばラップトップを持って良好するような場合)を透過的に管理できるように改善されました。 [こちらの blog 記事](https://blog.4d.com/work-and-move-with-quic-and-network-switching) をご覧ください。 +- プロジェクトを閉じたり再起動したりすることなく、4D エクスプローラーから[ホストプロジェクトから直接コンポーネントを作成](../Extensions/develop-components.md#コンポーネントの作成)したり、あるいは[専用のタブからコンポーネントのコードを編集する](../Extensions/develop-components.md#全てのコンポーネントコードを編集) ことができるようになりました。 +- 4D プロダクトのアクティベーションステップが、簡略化されて[サインイン](../GettingStarted/Installation.md#sign-in) 中に自動化されました。 +- 4D AIKit コンポーネント: [特定のツールを自動的に呼び出す](../aikit/Classes/OpenAIChatHelper.md#registertool) ことと [レスポンスフォーマットを指定する](../aikit/Classes/OpenAIChatCompletionsParameters.md#response-format) 新機能。 - 4Dランゲージ: - - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). + - 文字列から先頭と末尾のスペースを削除する新しい "trim" 系コマンド: [`Trim`](../commands/trim.md)、[`Trim start`](../commands/trim-start.md)、および[`Trim end`](../commands/trim-end.md)。 + - [`Num`](../commands/num.md) および [`String`](../commands/string.md) コマンドは、異なる基数での変換をサポートするようにアップデートされました。 +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=21): list of all bugs that have been fixed in 4D 21. #### デベロッパー・プレビュー @@ -43,7 +44,7 @@ Read [**What’s new in 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/), th - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    +- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    ![alt-text](../assets/en/getStart/convert.png)
    \- **Import**: import automatically 4D components as dependencies to the project
    \- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
    @@ -65,26 +66,26 @@ In binary databases, you need to select the required components in the 4D instal - [`4D.TCPConnection.new()`](../API/TCPConnectionClass.md#4dtcpconnectionnew) 関数の[`options`](../API/TCPConnectionClass.md#options-parameter) 引数に新しい`connectionTimeout` オプションが追加されました。 - 新しい[`4D.Vector`](../API/VectorClass.md) クラス。これを使用して、一般的にAI で計算されたベクトルを処理して比較することができます。 - [4D 自動フィールド](../settings/database.md#自動uuidバージョン) および [`Generate UUID`](../commands/generate-uuid) コマンドに対して、**バージョン 7**のUUID を生成するための新しいオプション。 -- New [`UDPSocket`](../API/UDPSocketClass.md) and [`UDPEvent`](../API/UDPEventClass.md) classes to send data using UDP sockets. Support of detailed logging for UDP events in the [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) log file (renamed from `4DTCPLog.txt`). -- New [`.promote()`](../API/SessionClass.md#promote) and [`.demote()`](../API/SessionClass.md#demote) functions in the [Session class](../API/SessionClass.md) to dynamically add/remove privileges in a web process. -- [Automatic selection of licenses to embed](../Desktop/building.md#application-automatically-embedding-available-licenses) in the Build application dialog box, modified [`Create deployment license`](../commands/create-deployment-license.md) command, new [`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.en.html) BuildApplication xml key. -- Enhanced security for formula copy/paste in [4D Write Pro](../WritePro/managing-formulas.md) and [styled text areas](../FormObjects/input_overview.md): formulas copied from outside the current 4D application are now always pasted as values only. -- 4D AIKit component: new [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) to create embeddings using OpenAI's API. -- You can now [associate a class](../Develop/field-properties.md) to an object field in the structure editor. -- Automatic handling of [recursive dependencies](../Project/components.md#automatic-dependency-resolution). +- 新しい[`UDPSocket`](../API/UDPSocketClass.md) および [`UDPEvent`](../API/UDPEventClass.md) クラスを使用することでUDP ソケットを使用してデータを送信することができます。 [`4DTCPUDPLog.txt`](../Debugging/debugLogFiles.md#4dtcpudplogtxt) ログファイル(`4DTCPLog.txt` から改名)内でのUDP イベントの詳細なログのサポート。 +- [Session class](../API/SessionClass.md) 内の[`.promote()`](../API/SessionClass.md#promote) および[`.demote()`](../API/SessionClass.md#demote) 関数を使用することでWeb プロセスの権限を動的に追加/削除することができます。 +- ビルドアプリケーションのダイアログボックスで[埋め込むライセンスの自動選択](../Desktop/building.md#アプリケーションの利用可能なライセンスの自動埋め込み)、 更新された[`Create deployment license`](../commands/create-deployment-license.md) コマンド、新しい[`AutomaticLicenseIntegration`](https://doc.4d.com/4Dv20R10/4D/20-R10/AutomaticLicenseIntegration.300-7611090.ja.html) ビルドアプリケーションXML キー。 +- [4D Write Pro](../WritePro/managing-formulas.md) および [スタイル付きテキストエリア](../FormObjects/input_overview.md)におけるフォーミュラのコピー/ペースト時のセキュリティの改善: カレントの4D アプリケーションの外部からコピーされたフォーミュラは、今後は常に値のみがペーストされます。 +- 4D AIKit コンポーネント: 新しい [OpenAIEmbeddingsAPI class](../aikit/Classes/OpenAIEmbeddingsAPI.md) を使用することで、OpenAI のAPI を使用して埋め込みを作成できます。 +- ストラクチャーエディターにおいて、オブジェクト型フィールドに対して[クラスを割り当てる](../Develop/field-properties.md) ことができます。 +- [再起的な依存関係](../Project/components.md#自動依存関係解決) の自動管理。 - 4Dランゲージ: - 統一性のため、[`Create entity selection`](../commands/create-entity-selection.md) コマンドおよび [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) コマンドは、["4D 環境"](../commands/theme/4D_Environment.md) テーマから ["Selection"](../commands/theme/Selection.md) テーマへと移動しました。 - 新しい [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) および [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) コマンドを使用して、フォームオブジェクトに対して`Formula` オブジェクトを割り当て、または読み出しができるようになります。 - [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) および [`LISTBOX Get property`](../commands/listbox-get-property.md) は3つの新しい定数をサポートするようになりました: `lk current item`、`lk current item position`、および `lk selected items expression` です。 -- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R10): list of all bugs that have been fixed in 4D 20 R10. +- [**修正リスト**](https://bugs.4d.fr/fixedbugslist?version=20_R10): 4D 20 R10 で修正されたバグのリストです(日本語版は[こちら](https://4d-jp.github.io/2025/188/release-note-version-20r10/))。 #### 動作の変更 - Windows 上では、印刷しか想定していない(つまりスクリーン上で使用不可能な)カレントプリンターフォントは、4D の起動時にはロードされないようになりました。 -- The *MeCab* library has been removed. This change only affects the processing of Japanese text. -- When an object variable or parameter is declared with a ["cs" class](../Concepts/classes.md#cs) type, assigning it with an object instance of a different class now generates a syntax error. -- [`.hasPrivilege()`](../API/SessionClass.md#hasprivilege) returns True for promoted privileges in the web process. -- The [`Time`](../commands/time) command now returns a negative time expression when the *timeValue* parameter is negative. For instance, `Time("-01:02:03")` will return **-01:02:03**. In previous releases, the negative sign was ignored. +- *MeCab* ライブラリーは削除されました。 この変更は、日本語テキストの処理のみに影響します。 +- ["cs" クラス](../Concepts/classes.md#cs) タイプを使用して宣言されたオブジェクト型変数またはオブジェクト型引数に、異なるクラスのオブジェクトインスタンスを代入した場合にはシンタックスエラーを生成するようになりました。 +- [`.hasPrivilege()`](../API/SessionClass.md#hasprivilege) 関数は、Web プロセス内において昇格された権限に対してはTrue を返すようになりました。 +- [`Time`](../commands/time) コマンドは、*timeValue* 引数が負の値の場合には、負の時間式を返すようになりました。 例えば、`Time("-01:02:03")` は **-01:02:03** を返します。 過去のリリースにおいては、負の符号は無視されていました。 ## 4D 20 R9 @@ -176,7 +177,7 @@ In binary databases, you need to select the required components in the 4D instal #### ハイライト - [オブジェクト参照](../Concepts/dt_object.md#オブジェクト演算子) と [コレクション参照](../Concepts/dt_collection.md#コレクション演算子) を対象とした比較演算子をサポート。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 [`collection.query()`](../API/CollectionClass.md#query) は、[オブジェクト参照やコレクション参照をクエリの値](../API/CollectionClass.md#オブジェクト参照やコレクション参照で検索する) としてサポートするようになりました。 -- [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs) を介して、ホストプロジェクトに読み込まれているすべてのコンポーネント間で自動的に共有されるようになりました。 +- [宣言された名前空間](../Extensions/develop-components.md#コンポーネント名前空間の宣言) をコンポーネントが持つ場合、そのクラスは [`cs.`](../Concepts/classes.md#cs). - コンポーネントマネージャー: [GitHub に保存されたコンポーネント](../Project/components.md#github-に保存されたコンポーネント) のサポート。 - 新しい [`entitySelection.clean()`](../API/EntitySelectionClass.md#clean) 関数と [`$clean`](../REST/$clean.md) REST API が追加されました。これらは、対象のエンティティセレクションから削除済みエンティティを除外したエンティティセレクションを新規に取得します。 - セッションの権限を確認し、デバッグを容易にするための新しい [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) 関数と [`$info/privileges`](../REST/$info.md) REST API が追加されました。 From d535234d33d77289512d545d9d42d17e987a5504 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:16 +0200 Subject: [PATCH 038/201] New translations updates.md (Portuguese, Brazilian) --- .../version-21/Notes/updates.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/Notes/updates.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/Notes/updates.md index 2ddb2e25800354..3bbe0bf92d5a73 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/Notes/updates.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/Notes/updates.md @@ -26,6 +26,7 @@ Leia [**O que há de novo no 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/ - Línguagem 4D: - New "trim" commands to remove leading and trailing spaces from a string: [`Trim`](../commands/trim.md), [`Trim start`](../commands/trim-start.md), and [`Trim end`](../commands/trim-end.md). - [`Num`](../commands/num.md) and [`String`](../commands/string.md) commands have been updated to support conversions in different bases (radix). +- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=21): list of all bugs that have been fixed in 4D 21. #### Prévia do desenvolvedor @@ -43,7 +44,7 @@ Leia [**O que há de novo no 4D 21**](https://blog.4d.com/en-whats-new-in-4d-21/ - Web server: the support of deprecated `4DSYNC/` and `4DCGI/` URLs is removed. No specific processing is done on these URLs anymore. - Web user sessions are now returned by [`Process activity`](../commands/process-activity.md). - The [`HIGHLIGHT TEXT`](../commands/highlight-text) command is now supported in the context of subforms. -- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview-old.md)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    +- **Components no longer embedded**: starting with 4D 21, components developed by 4D (4D NetKit, 4D SVG..., see [this list](../Extensions/overview.md#components-developed-by-4d)) are no longer embedded in the 4D application. When upgrading a project to 4D 21 or higher, a dialog box is displayed:
    ![alt-text](../assets/en/getStart/convert.png)
    \- **Import**: import automatically 4D components as dependencies to the project
    \- **Ignore**: do not import components and let you [manage components manually](../Project/components.md)
    @@ -175,7 +176,7 @@ Leia [**O que há de novo no 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d- #### Destaques - Operadores de comparação nas [referências a objetos](../Concepts/dt_object.md#object-operators) e nas [referências a coleções](../Concepts/dt_collection.md#collection-operators). [`collection.query()`](../API/CollectionClass.md#query) now supports [object and collection references as query values](../API/CollectionClass.md#object-or-collection-reference-as-value). -- When a component has a [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), its classes are now automatically shared between all loaded components in the host project via [`cs.`](../Concepts/classes.md#cs). +- Quando um componente tiver um [declared namespace](../Extensions/develop-components.md#declaring-the-component-namespace), suas classes agora são automaticamente compartilhadas entre todos os componentes carregados no projeto host por meio de [`cs.`](../Concepts/classes.md#cs). - Gerenciador de componentes: suporte de [componentes armazenados no GitHub](../Project/components.md#components-stored-on-github). - Novo [`entitySeletion. lean()`](../API/EntitySelectionClass.md#clean) função e [`$clean`](../REST/$clean.md) REST API para obter uma nova seleção de entidade baseada na seleção da entidade original, mas sem as entidades excluídas. - Nova função [`session.getPrivileges()`](../API/SessionClass.md#getprivileges) e [`$info/privileges`](../REST/$info.md) API REST para inspecionar os privilégios de sessão para uma depuração mais fácil. From 4c55c2125a60564dd0507d57859a6e06205c0c54 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:28 +0200 Subject: [PATCH 039/201] New translations entities.md (French) --- .../version-21/ORDA/entities.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/entities.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/entities.md index 0be4eacb122866..50d4730852d6fa 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/entities.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/entities.md @@ -564,11 +564,11 @@ Ce mécanisme automatique est basé sur le concept de "verrouillage optimiste" q Le diagramme suivant illustre le verrouillage optimiste : -1. Deux process chargent la même entité.

    ![](../assets/en/ORDA/optimisticLock1.png) +1. Two processes load the same entity.

    ![](../assets/en/ORDA/optimisticLock1.png) -2. Le premier process modifie l'entité et valide le changement. La méthode `entity.save()` est appelée. Le moteur 4D compare automatiquement la valeur du marqueur interne de l'entité modifiée avec celle de l'entité stockée dans les données. Étant donné qu'ils correspondent, l'entité est enregistrée et sa valeur de marqueur est incrémentée.

    ![](../assets/en/ORDA/optimisticLock2.png) +2. Le premier process modifie l'entité et valide le changement. La méthode `entity.save()` est appelée. Le moteur 4D compare automatiquement la valeur du marqueur interne de l'entité modifiée avec celle de l'entité stockée dans les données. Since they match, the entity is saved and its stamp value is incremented.

    ![](../assets/en/ORDA/optimisticLock2.png) -3. Le deuxième process modifie également l'entité chargée et valide ses modifications. La méthode `entity.save()` est appelée. Comme la valeur du marqueur de l'entité modifiée ne correspond pas à celle de l'entité stockée dans les données, la sauvegarde n'est pas effectuée et une erreur est renvoyée.

    ![](../assets/en/ORDA/optimisticLock3.png) +3. Le deuxième process modifie également l'entité chargée et valide ses modifications. La méthode `entity.save()` est appelée. Since the stamp value of the modified entity does not match the one of the entity stored in the data, the save is not performed and an error is returned.

    ![](../assets/en/ORDA/optimisticLock3.png) Cela peut également être illustré par le code suivant : From 4a5bfbf38d063390d68853b7bbdd5efba2cd9ebe Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:31 +0200 Subject: [PATCH 040/201] New translations entities.md (Spanish) --- .../version-21/ORDA/entities.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/entities.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/entities.md index 2ac6f5af37a028..7a2db28e32c11f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/entities.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/entities.md @@ -566,9 +566,9 @@ El siguiente diagrama ilustra el bloqueo optimista: 1. Dos procesos cargan la misma entidad.

    ![](../assets/en/ORDA/optimisticLock1.png) -2. El primer proceso modifica la entidad y valida el cambio. Se llama al método `entity.save( )`. El motor 4D compara automáticamente el valor del marcador interno de la entidad modificada con el de la entidad almacenada en los datos. Dado que coinciden, la entidad se guarda y su valor de marcador se incrementa.

    ![](../assets/en/ORDA/optimisticLock2.png) +2. El primer proceso modifica la entidad y valida el cambio. Se llama al método `entity.save( )`. El motor 4D compara automáticamente el valor del marcador interno de la entidad modificada con el de la entidad almacenada en los datos. Since they match, the entity is saved and its stamp value is incremented.

    ![](../assets/en/ORDA/optimisticLock2.png) -3. El segundo proceso también modifica la entidad cargada y valida sus cambios. Se llama al método `entity.save( )`. Dado que el valor del sello de la entidad modificada no coincide con el de la entidad almacenada en los datos, no se realiza el guardado y se devuelve un error.

    ![](../assets/en/ORDA/optimisticLock3.png) +3. El segundo proceso también modifica la entidad cargada y valida sus cambios. Se llama al método `entity.save( )`. Since the stamp value of the modified entity does not match the one of the entity stored in the data, the save is not performed and an error is returned.

    ![](../assets/en/ORDA/optimisticLock3.png) Esto también puede ilustrarse con el siguiente código: From e07edc0136ec57aabccb3f59963889c7757a868b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:34 +0200 Subject: [PATCH 041/201] New translations entities.md (Portuguese, Brazilian) --- .../docusaurus-plugin-content-docs/version-21/ORDA/entities.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/entities.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/entities.md index 647fe5f0082093..0ab195287b1363 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/entities.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/entities.md @@ -565,7 +565,7 @@ Esse mecanismo automático baseia-se no conceito de "bloqueio otimista", sendo p O diagrama seguinte ilustra o bloqueio otimista: -1. Dois processos carregam a mesma entidade.

    ![](../assets/en/ORDA/optimisticLock1.png) +1. Two processes load the same entity.

    ![](../assets/en/ORDA/optimisticLock1.png) 2. O primeiro processo modifica a entidade e valida a alteração. Se llama al método `entity.save( )`. O mecanismo 4D compara automaticamente o valor do carimbo interno da entidade modificada com o da entidade armazenada nos dados. Since they match, the entity is saved and its stamp value is incremented.

    ![](../assets/en/ORDA/optimisticLock2.png) From 3e0c26e7e91b359ae700fdc4444d6a596290169d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:46 +0200 Subject: [PATCH 042/201] New translations orda-events.md (French) --- .../version-21/ORDA/orda-events.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md index 6be733d4b7838d..cc75f45301a848 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md @@ -16,7 +16,7 @@ ORDA events are functions that are automatically invoked by ORDA each time entit You cannot directly trigger event function execution. Events are called automatically by ORDA based on user actions or operations performed through code on entities and their attributes. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [ORDA – Handle an event-driven logic during data persistence actions](https://blog.4d.com/orda-handle-an-event-driven-logic-during-data-persistence-actions) @@ -102,19 +102,19 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| Propriété | Type | Description | Set by the developer | -| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Oui | -| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Oui | -| extraDescription | Object | Free information to set up | Oui | -| seriousError | Boolean | Used only with validate events (see below). Will insert a specific `status` value in the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) function:
  • If true: `dk status serious validation error`
  • If false: `dk status validation failed`
    • | Yes (default is false) | -| componentSignature | Text | Always "DBEV" | Non | - -- The errors are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. -- In case of an error triggered by a **validate** event, the `fatalError` property allows you to insert a specific `status` and its associated `statusText` in the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions: - - If **false**: `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". Such errors do not require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. - - If **true**: `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". Such errors require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. They are raised at the end of the event and reach the client requesting the save/drop action (REST client for example). -- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error (`dk status serious error`) whatever the `seriousError` property value. +| Propriété | Type | Description | Set by the developer | +| ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Oui | +| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Oui | +| extraDescription | Object | Free information to set up | Oui | +| seriousError | Boolean | Used only with validate events (see below).
  • `True`: creates a [serious (unpredictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) and triggers an exception. Adds the `dk status serious validation error` status
  • creates only a [silent (predictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). Adds the `dk status validation failed` status
    • | Yes (default is false) | +| componentSignature | Text | Always "DBEV" | Non | + +- [Serious errors](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. +- In case of an error triggered by a **validate** event, the `seriousError` property allows you to choose the level of the error to generate: + - If **true**: a serious error is thrown and should be handled by the [error processing code](../Concepts/error-handling.md#predictable-vs-unpredictable-errors), such as a [try catch](../Concepts/error-handling.md#trycatchend-try). In the result object of the calling function, `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". The error is raised at the end of the event and reach the client requesting the save/drop action (REST client for example). + - If **false** (default): a [silent (predictable) error is generated](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). It does not trigger any exception and is not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. In the result object of the calling function, `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". +- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error whatever the `seriousError` property value. ## Event function description From 34c81d32a355d0f4432382c971cd6b2e61d133ac Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:48 +0200 Subject: [PATCH 043/201] New translations orda-events.md (Spanish) --- .../version-21/ORDA/orda-events.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md index 884af1066d3c9f..fa590c474ac3c6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md @@ -1,6 +1,6 @@ --- id: orda-events -title: Events +title: Eventos ---
    Historia @@ -94,7 +94,7 @@ Event functions accept a single *event* object as parameter. When the function i | "saveStatus" | Only in [`afterSave()`](#function-event-aftersave) | String | "success" if the save was successful, "failed" otherwise | | | "dropStatus" | Only in [`afterDrop()`](#function-event-afterdrop) | String | "success" if the drop was successful, "failed" otherwise | | -## Error object +## Objeto de error [Some event functions](#summary-table) can return an **error object** to raise an error and stop the running action. @@ -102,19 +102,19 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| Propiedad | Tipo | Descripción | Set by the developer | -| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | -| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | -| extraDescription | Object | Free information to set up | Sí | -| seriousError | Boolean | Used only with validate events (see below). Will insert a specific `status` value in the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) function:
  • If true: `dk status serious validation error`
  • If false: `dk status validation failed`
    • | Yes (default is false) | -| componentSignature | Text | Always "DBEV" | No | - -- The errors are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. -- In case of an error triggered by a **validate** event, the `fatalError` property allows you to insert a specific `status` and its associated `statusText` in the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions: - - If **false**: `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". Such errors do not require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. - - If **true**: `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". Such errors require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. They are raised at the end of the event and reach the client requesting the save/drop action (REST client for example). -- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error (`dk status serious error`) whatever the `seriousError` property value. +| Propiedad | Tipo | Descripción | Set by the developer | +| ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | +| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | +| extraDescription | Object | Free information to set up | Sí | +| seriousError | Boolean | Used only with validate events (see below).
  • `True`: creates a [serious (unpredictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) and triggers an exception. Adds the `dk status serious validation error` status
  • creates only a [silent (predictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). Adds the `dk status validation failed` status
    • | Yes (default is false) | +| componentSignature | Text | Always "DBEV" | No | + +- [Serious errors](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. +- In case of an error triggered by a **validate** event, the `seriousError` property allows you to choose the level of the error to generate: + - If **true**: a serious error is thrown and should be handled by the [error processing code](../Concepts/error-handling.md#predictable-vs-unpredictable-errors), such as a [try catch](../Concepts/error-handling.md#trycatchend-try). In the result object of the calling function, `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". The error is raised at the end of the event and reach the client requesting the save/drop action (REST client for example). + - If **false** (default): a [silent (predictable) error is generated](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). It does not trigger any exception and is not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. In the result object of the calling function, `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". +- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error whatever the `seriousError` property value. ## Event function description From aa942ee552232733484f0608783ea632cfc40ccb Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:51 +0200 Subject: [PATCH 044/201] New translations orda-events.md (Japanese) --- .../version-21/ORDA/orda-events.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md index cbf92c9aad387b..33bc7539dc0b38 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md @@ -102,19 +102,19 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| プロパティ | 型 | 説明 | Set by the developer | -| ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | ◯ | -| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | ◯ | -| extraDescription | Object | Free information to set up | ◯ | -| seriousError | Boolean | Used only with validate events (see below). Will insert a specific `status` value in the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) function:
  • If true: `dk status serious validation error`
  • If false: `dk status validation failed`
    • | Yes (default is false) | -| componentSignature | Text | Always "DBEV" | × | - -- The errors are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. -- In case of an error triggered by a **validate** event, the `fatalError` property allows you to insert a specific `status` and its associated `statusText` in the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions: - - If **false**: `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". Such errors do not require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. - - If **true**: `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". Such errors require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. They are raised at the end of the event and reach the client requesting the save/drop action (REST client for example). -- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error (`dk status serious error`) whatever the `seriousError` property value. +| プロパティ | 型 | 説明 | Set by the developer | +| ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | ◯ | +| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | ◯ | +| extraDescription | Object | Free information to set up | ◯ | +| seriousError | Boolean | Used only with validate events (see below).
  • `True`: creates a [serious (unpredictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) and triggers an exception. Adds the `dk status serious validation error` status
  • creates only a [silent (predictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). Adds the `dk status validation failed` status
    • | Yes (default is false) | +| componentSignature | Text | Always "DBEV" | × | + +- [Serious errors](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. +- In case of an error triggered by a **validate** event, the `seriousError` property allows you to choose the level of the error to generate: + - If **true**: a serious error is thrown and should be handled by the [error processing code](../Concepts/error-handling.md#predictable-vs-unpredictable-errors), such as a [try catch](../Concepts/error-handling.md#trycatchend-try). In the result object of the calling function, `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". The error is raised at the end of the event and reach the client requesting the save/drop action (REST client for example). + - If **false** (default): a [silent (predictable) error is generated](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). It does not trigger any exception and is not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. In the result object of the calling function, `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". +- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error whatever the `seriousError` property value. ## Event function description From 9161cc4e90f8557471c424de28038014481556d2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:09:53 +0200 Subject: [PATCH 045/201] New translations orda-events.md (Portuguese, Brazilian) --- .../version-21/ORDA/orda-events.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md index dcd8c2c2b70e98..2d483010e8a237 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md @@ -102,19 +102,19 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| Propriedade | Tipo | Descrição | Set by the developer | -| ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | -| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sim | -| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sim | -| extraDescription | Object | Free information to set up | Sim | -| seriousError | Parâmetros | Used only with validate events (see below). Will insert a specific `status` value in the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) function:
  • If true: `dk status serious validation error`
  • If false: `dk status validation failed`
    • | Yes (default is false) | -| componentSignature | Text | Always "DBEV" | Não | - -- The errors are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. -- In case of an error triggered by a **validate** event, the `fatalError` property allows you to insert a specific `status` and its associated `statusText` in the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions: - - If **false**: `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". Such errors do not require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. - - If **true**: `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". Such errors require a [try catch](../Concepts/error-handling.md#trycatchend-try) and are not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. They are raised at the end of the event and reach the client requesting the save/drop action (REST client for example). -- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error (`dk status serious error`) whatever the `seriousError` property value. +| Propriedade | Tipo | Descrição | Set by the developer | +| ------------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sim | +| message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sim | +| extraDescription | Object | Free information to set up | Sim | +| seriousError | Parâmetros | Used only with validate events (see below).
  • `True`: creates a [serious (unpredictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) and triggers an exception. Adds the `dk status serious validation error` status
  • creates only a [silent (predictable) error](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). Adds the `dk status validation failed` status
    • | Yes (default is false) | +| componentSignature | Text | Always "DBEV" | Não | + +- [Serious errors](../Concepts/error-handling.md#predictable-vs-unpredictable-errors) are stacked in the `errors` collection property of the **Result object** returned by the [`save()`](../API/EntityClass.md#save) or [`drop()`](../API/EntityClass.md#drop) functions. +- In case of an error triggered by a **validate** event, the `seriousError` property allows you to choose the level of the error to generate: + - If **true**: a serious error is thrown and should be handled by the [error processing code](../Concepts/error-handling.md#predictable-vs-unpredictable-errors), such as a [try catch](../Concepts/error-handling.md#trycatchend-try). In the result object of the calling function, `status` gets `dk status serious validation error` and `statusText` gets "Serious Validation Error". The error is raised at the end of the event and reach the client requesting the save/drop action (REST client for example). + - If **false** (default): a [silent (predictable) error is generated](../Concepts/error-handling.md#predictable-vs-unpredictable-errors). It does not trigger any exception and is not stacked in the errors returned by the [`Last errors`](../commands/last-errors.md) command. In the result object of the calling function, `status` gets `dk status validation failed` and `statusText` gets "Mild Validation Error". +- In case of an error triggered by a **saving/dropping** event, when an error object is returned, the error is always raised as a serious error whatever the `seriousError` property value. ## Event function description From 00536c1c12a2d7d668381fbcf2af625286e20ea7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:10:29 +0200 Subject: [PATCH 046/201] New translations methods.md (Spanish) --- .../version-21/Preferences/methods.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/Preferences/methods.md b/i18n/es/docusaurus-plugin-content-docs/version-21/Preferences/methods.md index 5beaa5f717c17c..6a6eb8c18fccf1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/Preferences/methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/Preferences/methods.md @@ -180,8 +180,8 @@ Si deselecciona esta opción, sólo se mostrará la flecha amarilla. Esta área le permite configurar los mecanismos de autocompletar en el Editor de código para adaptarlo a sus propios hábitos de trabajo. -| | Descripción | -| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Apertura automática de la ventana | Activa la visualización automática de la ventana de sugerencias para:
    • Constantes
    • Variables (locales e interproceso) y atributos del objeto
    • Tablas
    • Prototipos (es decir, funciones de clase)

    Por ejemplo, cuando se selecciona la opción "Variables (locales o interproceso) y atributos del objeto", aparece una lista de sugerencias cuando se escribe el caracter $:

    ![](../assets/en/Preferences/suggestionsAutoOpen.png)

    Puede deshabilitar esta funcionalidad para ciertos elementos del lenguaje deseleccionando su opción correspondiente. | -| Validación de una sugerencia | Establece el contexto de entrada que permite al Editor de Código validar automáticamente la sugerencia actual mostrada en la ventana de autocompletado.
    • **Tabuladores y delimitadores**
      Cuando esta opción está seleccionada, puede validar la selección actual con la tecla Tab o cualquier delimitador relevante para el contexto. Por ejemplo, si introduce "ALE" y luego "(", 4D escribe automáticamente "ALERT(" en el editor. Esta es la lista de delimitadores que se tienen en cuenta:
      ( ; : = < [ {
    • **Sólo tabulador**
      Cuando se selecciona esta opción, sólo se puede utilizar el tabulador para insertar la sugerencia actual. Esto puede utilizarse más concretamente para facilitar la introducción de caracteres delimitadores en los nombres de elementos, como ${1}.**Note**: También puede hacer doble clic en la ventana o presionar la tecla Retorno de carro para validar una sugerencia.
    | +| | Descripción | +| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Apertura automática de la ventana | Activa la visualización automática de la ventana de sugerencias para:
    • Constantes
    • Variables (locales e interproceso) y atributos del objeto
    • Tablas
    • Prototipos (es decir, funciones de clase)

    Por ejemplo, cuando se selecciona la opción "Variables (locales o interproceso) y atributos del objeto", aparece una lista de sugerencias cuando se escribe el caracter $:

    ![](../assets/en/Preferences/suggestionsAutoOpen.png)

    Puede deshabilitar esta funcionalidad para ciertos elementos del lenguaje deseleccionando su opción correspondiente. | +| Validación de una sugerencia | Sets the entry context that allows the Code Editor to validate automatically the current suggestion displayed in the autocomplete window.
    • **Tab and delimiters**
      When this option is selected, you can validate the current selection with the Tab key or any delimiter that is relevant to the context. Por ejemplo, si introduce "ALE" y luego "(", 4D escribe automáticamente "ALERT(" en el editor. Esta es la lista de delimitadores que se tienen en cuenta:
      ( ; : = < [ {
    • **Sólo tabulador**
      Cuando se selecciona esta opción, sólo se puede utilizar el tabulador para insertar la sugerencia actual. Esto puede utilizarse más concretamente para facilitar la introducción de caracteres delimitadores en los nombres de elementos, como ${1}.**Note**: También puede hacer doble clic en la ventana o presionar la tecla Retorno de carro para validar una sugerencia.
    | From e132057a4330831d4cd779ac16dee00585c80f5f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:10:31 +0200 Subject: [PATCH 047/201] New translations methods.md (Japanese) --- .../version-21/Preferences/methods.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Preferences/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Preferences/methods.md index e0d5eb69a426f8..e1e76859c3dc67 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Preferences/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Preferences/methods.md @@ -179,8 +179,8 @@ The corresponding [clipboard shorcuts](../code-editor/write-class-method.md#clip このエリアでは、コードエディターの自動補完メカニズムを設定して、作業習慣に合わせることができます。 -| | 説明 | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ウィンドウを自動で開く | 次の要素に関する提案ウィンドウを自動で開くかを指定します:
    • 定数
    • 変数(ローカルまたはインタープロセス)あるいはオブジェクト属性
    • テーブル
    • プロトタイプ (例: クラス関数)

    たとえば、"変数(ローカルまたはインタープロセス)あるいはオブジェクト属性" オプションがチェックされている場合、$ 文字を入力すると提案されるローカル変数のリストが表示されます:

    ![](../assets/en/Preferences/suggestionsAutoOpen.png)

    対応するオプションのチェックを外すことで、要素ごとにこの機能を無効にできます。 | -| 提案の決定 | コードエディターで、自動補完ウィンドウに表示されたカレントの提案を受け入れるための、入力コンテキストを設定します。
    • **タブと区切り文字**
      このオプションが選択されていると、タブキーまたは現在のコンテキストに関連する区切り文字で、現在選択されている提案を決定することができます。 たとえば "ALE" と入力して "(" を入力すると、4Dは自動で "ALERT(" とエディターに書き込みます。 区切り文字は以下の通りです:
      ( ; : = < [ {
    • **タブのみ**
      このオプションが選択されていると、現在の提案はタブキーを押したときにのみ受け入れられます。 これは特に ${1} のように、要素名に区切り文字を入力することを容易にします。**注記**: ウィンドウ内をダブルクリックするか、改行キーを押すことで提案を受け入れることもできます。
    | +| | 説明 | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ウィンドウを自動で開く | 次の要素に関する提案ウィンドウを自動で開くかを指定します:
    • 定数
    • 変数(ローカルまたはインタープロセス)あるいはオブジェクト属性
    • テーブル
    • プロトタイプ (例: クラス関数)

    たとえば、"変数(ローカルまたはインタープロセス)あるいはオブジェクト属性" オプションがチェックされている場合、$ 文字を入力すると提案されるローカル変数のリストが表示されます:

    ![](../assets/en/Preferences/suggestionsAutoOpen.png)

    対応するオプションのチェックを外すことで、要素ごとにこの機能を無効にできます。 | +| 提案の決定 | コードエディターで、自動補完ウィンドウに表示されたカレントの提案を受け入れるための、入力コンテキストを設定します。
    • **タブと区切り文字**
      このオプションが選択されていると、タブキーまたは現在のコンテキストに関連する区切り文字で、現在選択されている提案を決定することができます。 たとえば "ALE" と入力して "(" を入力すると、4Dは自動で "ALERT(" とエディターに書き込みます。 区切り文字は以下の通りです:
      ( ; : = < [ {
    • **タブのみ**
      このオプションが選択されていると、現在の提案はタブキーを押したときにのみ受け入れられます。 これは特に ${1} のように、要素名に区切り文字を入力することを容易にします。**注記**: ウィンドウ内をダブルクリックするか、改行キーを押すことで提案を受け入れることもできます。
    | From 45be3c8d57f0b3c8ec3dfadf2464b6065ecf1d3c Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:10:59 +0200 Subject: [PATCH 048/201] New translations components.md (French) --- .../version-21/Project/components.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/components.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/components.md index f2548492d1ada3..463fc86bd23e53 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/components.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/components.md @@ -1,6 +1,6 @@ --- id: components -title: Dependencies +title: Dépendances --- [L'architecture des projets](../Project/architecture.md) 4D est modulaire. Vous pouvez ajouter des fonctionnalités supplémentaires dans vos projets 4D en installant des [**composants**](Concepts/components.md) et des [**plug-ins**](../Concepts/plug-ins.md). Components are made of 4D code, while plug-ins can be [built using any language](../Extensions/develop-plug-ins.md). @@ -350,7 +350,7 @@ Pour afficher la fenêtre Dépendances : ![dependency-menu](../assets/en/Project/dependency-menu.png) - avec 4D Server, sélectionnez la ligne de menu **Fenêtre/Dépendances du projet**.
    - ![menu-dépendances-serveur](../assets/en/Project/dependency-menu-server.png) + ![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) La fenêtre Dépendances s'affiche alors. Les dépendances sont classées par nom par ordre alphabétique : From dadeda9dcb27bc6d6068bd4178423827468c07f1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:11:01 +0200 Subject: [PATCH 049/201] New translations components.md (Spanish) --- .../version-21/Project/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/Project/components.md b/i18n/es/docusaurus-plugin-content-docs/version-21/Project/components.md index 3bb2eb19a0f57e..e7fda44cc53d46 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/Project/components.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/Project/components.md @@ -349,7 +349,7 @@ Para mostrar el panel Dependencias: - con 4D, seleccione el ítem de menú **Diseño/Dependencias del Proyecto** (entorno de desarrollo),
    ![dependency-menu](../assets/en/Project/dependency-menu.png) -- con 4D Server, seleccione el ítem de menú **Ventana/Dependencias del Proyecto**.
    +- con el servidor 4D, seleccione el elemento de menú **Ventana/Dependencias del proyecto**.
    ![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) A continuación, se muestra el panel Dependencias. Las dependencias se ordenan por nombre en orden alfabético: From f6eafa1896e3ce44fa0d38a1d8edd89f0f418abe Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:11:04 +0200 Subject: [PATCH 050/201] New translations components.md (Japanese) --- .../version-21/Project/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md index 5979f2a6997c4c..9ec1cc2e38ce55 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md @@ -349,7 +349,7 @@ GitHubでリリースが作成されると、そこに**タグ**と**バージ - 4D では、**デザイン/プロジェクト依存関係** メニューアイテムを選択します (開発環境)。
    ![dependency-menu](../assets/en/Project/dependency-menu.png) -- 4D Server では、**ウインドウ/プロジェクト依存関係** メニューアイテムを選択します。
    +- 4D Server では、**ウィンドウ/プロジェクト依存関係** メニュー項目を選択します。
    ![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) 依存関係パネルが表示されます。 依存関係は ABC順にソートされます。 From 85fc5ccb90a07163a211de07bb221ab6d5717129 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:11:06 +0200 Subject: [PATCH 051/201] New translations components.md (Portuguese, Brazilian) --- .../version-21/Project/components.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/Project/components.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/Project/components.md index b6c05fefa599fc..4c8dfc2ede1a2e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/Project/components.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/Project/components.md @@ -349,7 +349,7 @@ Para exibir o painel Dependências: - Com 4D, selecione o item de menu **Design/Project Dependencies** (ambiente de desenvolvimento),
    ![dependency-menu](../assets/en/Project/dependency-menu.png) -- com o servidor 4D, selecione o item de menu **dependência do Window/Projeto**.
    +- com 4D Server, selecione o item de menu **Janela/Dependências do projeto**.
    ![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) O painel de Dependências é exibido em seguida. Dependências são classificadas por nome em ordem alfabética: From 527f6bfd8b76091e445d3311480aa09d3c595203 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:11:09 +0200 Subject: [PATCH 052/201] New translations date-time-formats.md (French) --- .../version-21/Project/date-time-formats.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/date-time-formats.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/date-time-formats.md index 13aa1b691806b2..86aa3e539a0877 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/date-time-formats.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Project/date-time-formats.md @@ -51,18 +51,18 @@ Le tableau suivant répertorie tous les motifs pris en charge pour les formats d | D | jour de l'année | D | 189 | | E | jour de la semaine | E, EE, ou EEE | Tue | | | | EEEE | Tuesday | -| | | EEEEE | M | +| | | EEEEE | T | | | | EEEEEE | ma | | e | jour local de la semaine | e | 2 | | | | ee | 02 | -| | | eee | mar. | -| | | eeee | Mardi | +| | | eee | Tue | +| | | eeee | Tuesday | | | | eeeee | T | | | | eeeeee | ma | | c | jour local de la semaine seul | c ou cc | 2 | -| | | ccc | mar. | -| | | cccc | mardi | -| | | ccccc | M | +| | | ccc | Tue | +| | | cccc | Tuesday | +| | | ccccc | T | | | | cccccc | ma | | a | AM ou PM | a, aa, ou aaa | PM [abbrev] | | | | aaaa | PM [complet] | @@ -98,8 +98,8 @@ Le tableau suivant répertorie tous les motifs pris en charge pour les formats d | O | Time Zone: short localized UTC | O | UTC-8 | | | Time Zone: long localized UTC (=ZZZZ) | OOOO | UTC-08:00 | | z | Time Zone: specific non-location | z, zz, ou zzz | UTC+1 | -| | | zzzz | heure normale d'Europe centrale | -| | | zzzzz | heure normale d'Europe centrale | +| | | zzzz | UTC-08:00 | +| | | zzzzz | -08:00, -07:52:58, Z | | | | | | | ' | échappement pour le texte | ' | ' | | ' ' | deux guillemets simples en produisent un | ' ' | ' ' | From e0edced5fbfdc4d1e72a39920d2e2e2e3d92095b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:12:18 +0200 Subject: [PATCH 053/201] New translations $filter.md (French) --- .../version-21/REST/$filter.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/$filter.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/$filter.md index 225bb92db1df45..34fb6f7e9a251a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/$filter.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/$filter.md @@ -90,11 +90,11 @@ Use the `params` property to provide the filter with the vector comparison param The *vectorComparison* parameter is a collection of the following elements: -| Propriété | Type | Description | | -| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [].vector | Collection d'objets) | Obligatoire. A collection that represents the vector to compare | | -| [].metric | Text | Optionnel. [Calcul vectoriel](../API/VectorClass.md#understanding-the-different-vector-computations) à utiliser pour la recherche. Supported values:
  • "cosine" (default if omitted): calculates the cosine distance between vectors.
  • "dot": calculates the dot similarity of vectors.
  • "euclidean": calculates the Euclidean distance between vectors. | | -| | [].threshold | Real | Facultatif (valeur par défaut : 0,5). Valeur seuil utilisée pour filtrer les comparaisons de vecteurs sur la base de leur score de similarité cosinus, point ou euclidienne selon la "métrique" sélectionnée. Il est fortement recommandé de choisir une similitude qui corresponde le mieux à votre cas d'utilisation spécifique pour des résultats optimaux. | +| Propriété | Type | Description | | +| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [].vector | Collection d'objets) | Obligatoire. A collection that represents the vector to compare | | +| [].metric | Text | Optionnel. [Calcul vectoriel](../API/VectorClass.md#understanding-the-different-vector-computations) à utiliser pour la recherche. Valeurs prises en charge :
  • "cosine" (valeur par défaut si omis) : calcule la distance cosinus entre les vecteurs.
  • "dot" : calcule la similarité de points des vecteurs.
  • "euclidean" : calcule la distance euclidienne entre les vecteurs. | | +| | [].threshold | Real | Facultatif (valeur par défaut : 0,5). Valeur seuil utilisée pour filtrer les comparaisons de vecteurs sur la base de leur score de similarité cosinus, point ou euclidienne selon la "métrique" sélectionnée. Il est fortement recommandé de choisir une similitude qui corresponde le mieux à votre cas d'utilisation spécifique pour des résultats optimaux. | Only a subset of **comparator** symbols are supported with vector comparisons. Notez qu'ils comparent les résultats à la valeur de seuil (threshold) : From a4317d66ffe3614994cf4da7d6f2d1db5e6d7be1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:12:44 +0200 Subject: [PATCH 054/201] New translations $method.md (Spanish) --- .../docusaurus-plugin-content-docs/version-21/REST/$method.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$method.md b/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$method.md index ec63e8eb56445e..706279be3d9811 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$method.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$method.md @@ -196,7 +196,8 @@ Si surge un problema al añadir o modificar una entidad, se le devolverá un err - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Si ha seleccionado la propiedad Fecha únicamente para su atributo Fecha, se eliminará la zona horaria y la hora (hora, minutos y segundos). En este caso, también puede enviar la fecha en el formato que se le devuelve dd!mm!aaaa (por ejemplo, 05!10!2013). - **Booleanos** son true o false. -- Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: +- Uploaded files using `$upload` can be applied to an attribute of type Image or BLOB by passing the object returned in the following format `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` + ::: ### Ejemplo From 8bb22ea73d6890931fc393510179122716870df4 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:12:46 +0200 Subject: [PATCH 055/201] New translations $method.md (Japanese) --- .../ja/docusaurus-plugin-content-docs/version-21/REST/$method.md | 1 + 1 file changed, 1 insertion(+) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md index 722858ec7053d5..df2bee8b228d9b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md @@ -197,6 +197,7 @@ RESTリクエストで定義されたリレートエンティティのコレク - **日付** は JavaScript 形式で表す必要があります: YYYY-MM-DDTHH:MM:SSZ (例: "2010-10-05T23:00:00Z")。 日付属性のためだけに日付プロパティを指定した場合、タイムゾーンおよび時刻 (時間・分・秒) の情報は削除されます。 この場合、レスポンスの形式 dd!mm!yyyy (例: 05!10!2013) を使って日付を送信することも可能です。 - **ブール** は true または false です。 - `$upload` を使ってアップロードしたファイルは、`{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` のような形式で返されるオブジェクトを渡すことで、ピクチャー型やBLOB型の属性に適用できます。 + ::: ### 例題 From e3de9b89d10597595d71a9a3347ec0d87f82113c Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:12:48 +0200 Subject: [PATCH 056/201] New translations $method.md (Portuguese, Brazilian) --- .../docusaurus-plugin-content-docs/version-21/REST/$method.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/REST/$method.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/REST/$method.md index d21437b56a1f5a..8338676845ead1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/REST/$method.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/REST/$method.md @@ -195,7 +195,8 @@ Se surgir um problema ao adicionar ou modificar uma entidade, ser-lhe-á enviado - **Las fechas** deben expresarse en formato JS: YYYY-MM-DDTHH:MM:SSZ (por ejemplo, "2010-10-05T23:00:00Z"). Se tiver selecionado a propriedade Apenas data para o seu atributo Data, o fuso horário e a hora (hora, minutos e segundos) serão removidos. Neste caso, também pode enviar a data no formato que lhe é devolvido dd!mm!yyyy (por exemplo, 05!10!2013). - **Booleanos** son true o false. -- Los archivos subidos mediante `$upload` pueden aplicarse a un atributo de tipo Imagen o BLOB pasando el objeto devuelto en el siguiente formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}`::: +- Arquivos carregados usando `$upload` podem ser aplicados a um atributo do tipo Imagem ou BLOB passando o objeto retornado no seguinte formato `{ "ID": "D507BC03E613487E9B4C2F6A0512FE50"}` + ::: ### Exemplo From 86561af857045ab10b31654a9ba347eba9a18ac2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:13:35 +0200 Subject: [PATCH 057/201] New translations classfunctions.md (French) --- .../version-21/REST/ClassFunctions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md index 5740fc0d6c2ff1..76d5a6bbd7b1f0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md @@ -120,7 +120,7 @@ Par exemple, avec une fonction de la dataclass `getCities()` recevant des param `/rest/City/getCities?$params='["Aguada","Paris"]'` -### Paramètres des entités +### Paramètre d'entité Les entités passées en paramètres sont référencées sur le serveur via leur clé (c'est-à-dire la propriété __KEY). Si le paramètre clé est omis dans une requête, une nouvelle entité est chargée en mémoire sur le serveur. Vous pouvez également transmettre des valeurs pour tous les attributs de l'entité. Ces valeurs seront automatiquement utilisées pour l'entité traitée sur le serveur. From aa0f53d1c38a01cec7a6536f2c0e8008ecbf0fe4 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:14:58 +0200 Subject: [PATCH 058/201] New translations transformation-tags.md (French) --- .../version-21/Tags/transformation-tags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md index 1c69170a4f0670..8bea0677e610e2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md @@ -160,7 +160,7 @@ Voici les caractéristiques de la balise 4DCODE : - La commande `TRACE` est prise en charge et active le débogueur 4D, vous permettant ainsi de déboguer votre code de template. - Toute erreur affichera le dialogue d'erreur standard qui permet à l'utilisateur d'arrêter l'exécution du code ou d'entrer en mode débogage. - Le texte compris entre `` est divisé en lignes acceptant n'importe quelle convention de fin de ligne (cr, lf, ou crlf). -- Le texte est tokenisé dans le contexte de la base de données qui a appelé `PROCESS 4D TAGS`. C'est important pour la reconnaissance des méthodes projet par exemple. La propriété de méthode [Disponible via les balises et les URL 4D (4DACTION...)](WebServer/allowProject.md) n'est pas prise en compte. +- Le texte est tokenisé dans le contexte de la base de données qui a appelé `PROCESS 4D TAGS`. Ceci est important pour la reconnaissance des méthodes de projet par exemple. La propriété de méthode [Disponible via les balises et les URL 4D (4DACTION...)](WebServer/allowProject.md) n'est pas prise en compte. - Même si le texte utilise toujours l'anglais-US, il est recommandé d'utiliser la syntaxe token (:Cxxx) pour les noms de commandes et de constantes afin de se prémunir contre d'éventuels problèmes dus à des commandes ou des constantes renommées d'une version de 4D à une autre. > Le fait que les balises 4DCODE puissent appeler n'importe quelle commande du langage 4D ou méthode du projet pourrait être considéré comme un problème de sécurité, en particulier lorsque la base de données est disponible via HTTP. Toutefois, étant donné qu'elle exécute du code côté serveur appelé à partir de vos propres fichiers de modèle, la balise elle-même ne représente pas un problème de sécurité. Dans ce contexte, comme pour tout serveur Web, la sécurité est principalement gérée au niveau des accès distants aux fichiers du serveur. From 61a3ec29a8d12c3577733753944d600329c08e37 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:16:33 +0200 Subject: [PATCH 059/201] New translations vp-copy-to-object.md (French) --- .../version-21/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md index 28a83e40f5d3ef..01d52a237e1f4e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ Dans *rangeObj*, passez la plage de cellules contenant les valeurs, formatages e Vous pouvez passer un paramètre facultatif *options* contenant les propriétés suivantes : -| Propriété | Type | Description | -| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | *Vrai* (par défaut) pour conserver les valeurs copiées, le formatage et les formules après l'exécution de la commande. *Faux* pour les supprimer. | -| copyOptions | Integer | Spécifie ce qui est copié ou déplacé. Valeurs possibles :

    ValeurDescription
    `vk clipboard options all` (par défaut)Copie tous les objets de données, y compris les valeurs, le formatage et les formules.
    `vk clipboard options formatting`Copie uniquement le formatage.
    `vk clipboard options formulas`Copie uniquement les formules.
    `vk clipboard options formulas and formatting`Copie les formules et le formatage.
    `vk clipboard options values`Copie uniquement les valeurs.
    `vk clipboard options value and formatting`Copie les valeurs et le formatage.

    | +| Propriété | Type | Description | +| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | *Vrai* (par défaut) pour conserver les valeurs copiées, le formatage et les formules après l'exécution de la commande. *Faux* pour les supprimer. | +| copyOptions | Integer | Spécifie ce qui est copié ou déplacé. Valeurs possibles :

    ValeurDescription
    `vk clipboard options all` (par défaut)Copie tous les objets de données, y compris les valeurs, la mise en forme et les formules.
    `vk clipboard options formatting` (options du presse-papier)Copie uniquement la mise en forme.
    `vk clipboard options formulas`Copie uniquement les formules.
    `vk clipboard options formulas and formatting`Copie les formules et la mise en forme.
    `vk clipboard options values`Copie uniquement les valeurs.
    `vk clipboard options value and formatting` Copie les valeurs et la mise en forme.

    | Les options de collage définies dans [workbook options](vp-set-workbook-options.md) sont prises en compte. From 6d39593f9c8a0063a987014a152689b3fb7c668c Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:16:35 +0200 Subject: [PATCH 060/201] New translations vp-copy-to-object.md (Spanish) --- .../version-21/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md index a70d5af54aa8d6..b551849007c39b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ En *rangeObj*, pase el rango de celdas con los valores, formato y fórmulas a co Puede pasar un parámetro opcional *options* con las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | -| copyOptions | Integer | Especifica lo que se copia o mueve. Valores posibles:

    ValorDescripción
    `vk clipboard options all` (por defecto)Copia todos los objetos de datos, incluidos los valores, el formato y las fórmulas.
    `vk clipboard options formatting`Copia sólo el formato.
    `vk clipboard options formulas`Copia sólo las fórmulas.
    `vk clipboard options formulas and formatting`Copia las fórmulas y el formato.
    `vk clipboard options values`Copia sólo los valores.
    `vk clipboard options value and formatting`Copia los valores y el formato.

    | +| Propiedad | Tipo | Descripción | +| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | +| copyOptions | Integer | Especifica lo que se copia o mueve. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copies only the formatting.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From abbaba7bb027988d4e06768fc9db93818797d1b7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:16:37 +0200 Subject: [PATCH 061/201] New translations vp-copy-to-object.md (Japanese) --- .../version-21/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md index 183cb255ecf2df..749f7fa9d1acad 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ title: VP Copy to object 任意の *options* 引数として、以下のプロパティを渡すことができます。 -| プロパティ | 型 | 説明 | -| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | コマンド実行後もコピーされた値、書式、数式が保持するには *true* (デフォルト)。 削除するには *false*。 | -| copyOptions | Integer | コピーまたは移動する内容を指定します。 とりうる値:

    値説明
    `vk clipboard options all` (デフォルト)値、フォーマット、フォーミュラを含むすべてのデータオブジェクトをコピーします。
    `vk clipboard options formatting`フォーマットだけをコピーします。
    `vk clipboard options formulas`フォーミュラだけをコピーします。
    `vk clipboard options formulas and formatting`フォーミュラとフォーマットをコピーします。
    `vk clipboard options values`値だけをコピーします。
    `vk clipboard options value and formatting`値とフォーマットをコピーします。

    | +| プロパティ | 型 | 説明 | +| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | コマンド実行後もコピーされた値、書式、数式が保持するには *true* (デフォルト)。 削除するには *false*。 | +| copyOptions | Integer | コピーまたは移動する内容を指定します。 取り得る値:

    値詳細
    `vk clipboard options all` (デフォルト)値、書式、数式を含め、全てのデータオブジェクトをコピーします。
    `vk clipboard options formatting`書式のみをコピーします。
    `vk clipboard options formulas`数式のみをコピーします。
    `vk clipboard options formulas and formatting`数式と書式をコピーします。
    `vk clipboard options values`値のみをコピーします。
    `vk clipboard options value and formatting`値と書式をコピーします。

    | [ワークブックオプション](vp-set-workbook-options.md) で定義されている貼り付けオプションが考慮されます。 From 83c74a04e6a59f689f557146d941b2bbfba04ddc Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:16:39 +0200 Subject: [PATCH 062/201] New translations vp-copy-to-object.md (Portuguese, Brazilian) --- .../version-21/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md index e16223fade7d46..ad799b3abf413b 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ Em *rangeObj*, passe o intervalo de células com os valores, a formatação e as Você pode passar um parâmetro *options* opcional com as seguintes propriedades: -| Propriedade | Tipo | Descrição | -| ----------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Parâmetros | *Verdadeiro* (padrão) para manter os valores copiados, a formatação e as fórmulas após a execução do comando. *Falso* para removê-los. | -| copyOptions | Integer | Especifica o que é copiado ou movido. Valores possíveis:

    ValorDescrição
    `vk clipboard options all` (padrão)Copia todos os objetos de dados, incluindo valores, formatação e fórmulas.
    `vk clipboard options formatting`Copia somente a formatação.
    `vk clipboard options formulas`Copia somente as fórmulas.
    `vk clipboard options formulas and formatting`Copia as fórmulas e a formatação.
    `vk clipboard options values`Copia apenas os valores.
    `vk clipboard options value and formatting`Copia os valores e a formatação.

    | +| Propriedade | Tipo | Descrição | +| ----------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| copy | Parâmetros | *Verdadeiro* (padrão) para manter os valores copiados, a formatação e as fórmulas após a execução do comando. *Falso* para removê-los. | +| copyOptions | Integer | Especifica o que é copiado ou movido. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copies only the formatting.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | As opções de colagem definidas nas [opções de workbook](#vp-set-workbook-options) são tomadas em conta. From 8b72ec8f9f53bb84600099e33bb29902ef40021b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:00 +0200 Subject: [PATCH 063/201] New translations vp-export-to-blob.md (French) --- .../version-21/ViewPro/commands/vp-export-to-blob.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md index af326cb69945f7..1ea98812df74fb 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md @@ -16,7 +16,7 @@ title: VP EXPORT TO BLOB ## Description -La commande `VP EXPORT TO BLOB` exporte le document 4D View Pro *vpAreaName* dans un 4D.Blob en fonction des options *paramObj*. Le blob exporté est disponible par le callback export. L'exportation et l'importation des zones 4D View Pro sous forme de blobs est rapide et économe en mémoire. +La commande `VP EXPORT TO BLOB` exporte le document 4D View Pro *vpAreaName* dans un 4D.Blob selon les options *paramObj*. Le blob exporté est disponible via la méthode de rappel de l'export. L'exportation et l'importation des zones 4D View Pro sous forme de blobs est rapide et économe en mémoire. Dans *paramObj*, vous pouvez passer plusieurs propriétés : From be3b62c87a7d9ecab79a81d1635d1ae702daa4b5 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:01 +0200 Subject: [PATCH 064/201] New translations vp-export-to-blob.md (Spanish) --- .../version-21/ViewPro/commands/vp-export-to-blob.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md index afa59df379020c..19cd648eadc591 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md @@ -16,7 +16,7 @@ title: VP EXPORT TO BLOB ## Descripción -El comando `VP EXPORT TO BLOB` exporta el documento 4D View Pro *vpAreaName* en un 4D.Blob según las opciones *paramObj*. El blob exportado está disponible a través de la retrollamada de exportación. Exportar e importar áreas de 4D View Pro como blogs es rápido y eficiente en memoria. +El comando `VP EXPORT TO BLOB` exporta el documento *vpAreaName* 4D View Pro en un 4D.Blob de acuerdo a las opciones *paramObj*. El blob exportado está disponible a través de la retrollamada de exportación. Exportar e importar áreas de 4D View Pro como blogs es rápido y eficiente en memoria. En *paramObj*, puede pasar varias propiedades: From e23212f8c68aa750106d08989ed1e05623b59a10 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:05 +0200 Subject: [PATCH 065/201] New translations vp-export-to-blob.md (Portuguese, Brazilian) --- .../version-21/ViewPro/commands/vp-export-to-blob.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md index 1d1a768c2882b6..141ba019a958c3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-export-to-blob.md @@ -16,7 +16,7 @@ title: VP EXPORT TO BLOB ## Descrição -The `VP EXPORT TO BLOB` command exports the *vpAreaName* 4D View Pro document in a 4D.Blob according to the *paramObj* options. The exported blob is available through the export callback. A exportação e importação de áreas do 4D View Pro como blobs é rápida e eficiente em termos de memória. +O comando `VP EXPORT TO BLOB` exporta o documento *vpAreaName* 4D View Pro em um 4D.Blob de acordo com as opções *paramObj*. O blob exportado está disponível por meio da chamada de retorno de exportação. A exportação e importação de áreas do 4D View Pro como blobs é rápida e eficiente em termos de memória. Em *paramObj*, você pode passar várias propriedades: From fd7f665ff0899457a4c9dd2e5688fbf08a06a7b2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:15 +0200 Subject: [PATCH 066/201] New translations vp-find.md (French) --- .../version-21/ViewPro/commands/vp-find.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md index 072da0f1050400..f7acf77abdbe77 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md @@ -27,14 +27,14 @@ Le paramètre *searchValue* vous permet de passer le texte à rechercher dans *r Vous pouvez passer le paramètre optionnel *searchCondition* pour préciser la manière dont la recherche est effectuée. Les propriétés suivantes sont prises en charge : -| Propriété | Type | Description | -| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| afterColumn | Integer | Le numéro de la colonne située juste avant la colonne de départ de la recherche. If the *rangeObj* is a combined range, the column number given must be from the first range. Default value: -1 (beginning of the *rangeObj*) | -| afterRow | Integer | Le numéro de la colonne située juste avant la colonne de départ de la recherche. Le numéro de la colonne située juste avant la colonne de départ de la recherche. Default value: -1 (beginning of the *rangeObj*) | -| all | Boolean |
  • True - All cells in *rangeObj* corresponding to *searchValue* are returned
  • False - (default value) Only the first cell in *rangeObj* corresponding to *searchValue* is returned
    • | -| flags | Integer |
    `vk find flag exact match`The entire content of the cell must completely match the search value
    `vk find flag ignore case`Capital and lower-case letters are considered the same. Ex: "a" is the same as "A".
    `vk find flag none`no search flags are considered (default)
    `vk find flag use wild cards`Wildcard characters (\*,?) can be used in the search string. Wildcard characters can be used in any string comparison to match any number of characters:
  • \* for zero or multiple characters (for example, searching for "bl*" can find "bl", "black", or "blob")
  • ? for a single character (for example, searching for "h?t" can find "hot", or "hit"
    • These flags can be combined. For example: $search.flags:=vk find flag use wild cards+vk find flag ignore case | -| order | Integer |
    `vk find order by columns`The search is performed by columns. Each row of a column is searched before the search continues to the next column.
    `vk find order by rows`The search is performed by rows. Each column of a row is searched before the search continues to the next row (default)
    | -| target | Integer |
    `vk find target formula`The search is performed in the cell formula
    `vk find target tag`The search is performed in the cell tag
    `vk find target text`The search is performed in the cell text (default)

    These flags can be combined. For example:$search.target:=vk find target formula+vk find target text

    | +| Propriété | Type | Description | +| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| afterColumn | Integer | Le numéro de la colonne située juste avant la colonne de départ de la recherche. If the *rangeObj* is a combined range, the column number given must be from the first range. Default value: -1 (beginning of the *rangeObj*) | +| afterRow | Integer | Le numéro de la colonne située juste avant la colonne de départ de la recherche. Le numéro de la colonne située juste avant la colonne de départ de la recherche. Default value: -1 (beginning of the *rangeObj*) | +| all | Boolean |
  • True - All cells in *rangeObj* corresponding to *searchValue* are returned
  • False - (default value) Only the first cell in *rangeObj* corresponding to *searchValue* is returned
    • | +| flags | Integer |
    `vk find flag exact match`The entire content of the cell must completely match the search value
    `vk find flag ignore case`Capital and lower-case letters are considered the same. Ex : "a" est la même chose que "A".
    `vk find flag none`aucun drapeau de recherche n'est pris en compte (par défaut)
    `vk find flag use wild cards`Caractères génériques (\*, ?) can be used in the search string. Wildcard characters can be used in any string comparison to match any number of characters:
  • \* for zero or multiple characters (for example, searching for "bl*" can find "bl", "black", or "blob")
  • ? for a single character (for example, searching for "h?t" can find "hot", or "hit"
    • These flags can be combined. For example: $search.flags:=vk find flag use wild cards+vk find flag ignore case | +| order | Integer |
    `vk find order by columns`The search is performed by columns. Chaque ligne d'une colonne est recherchée avant que la recherche ne passe à la colonne suivante.
    `vk find order by rows`La recherche est effectuée par lignes. Each column of a row is searched before the search continues to the next row (default)
    | +| target | Integer |
    `vk find target formula`The search is performed in the cell formula
    `vk find target tag`The search is performed in the cell tag
    `vk find target text`The search is performed in the cell text (default)

    These flags can be combined. For example:$search.target:=vk find target formula+vk find target text

    | Dans le paramètre optionnel *replaceValue*, vous pouvez passer du texte pour remplacer toute instance du texte dans la *searchValue* trouvée dans *rangeObj*. From e9ec1e8b60992ab3c446d2992a635e9c412e2b5e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:17 +0200 Subject: [PATCH 067/201] New translations vp-find.md (Spanish) --- .../version-21/ViewPro/commands/vp-find.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md index e122ecdf423030..4ccd334c12e81f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md @@ -27,14 +27,14 @@ El parámetro *searchValue* permite pasar el texto a buscar dentro del *rangeObj Puede pasar el parámetro opcional *searchCondition* para especificar el funcionamiento de la búsqueda. Se soportan las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| afterColumn | Integer | El número de la columna justo antes de la columna inicial de la búsqueda. Si *rangeObj* es un rango combinado, el número de columna indicado debe ser del primer rango. Valor por defecto: -1 (inicio de *rangeObj*) | -| afterRow | Integer | El número de la línea justo antes de la línea inicial de la búsqueda. Si *rangeObj* es un rango combinado, el número de línea indicado debe ser del primer rango. Valor por defecto: -1 (inicio de *rangeObj*) | -| all | Boolean |
  • True - Se devuelven todas las celdas en *rangeObj* correspondientes a *searchValue*
  • False - (valor por defecto) Sólo se devuelve la primera celda de *rangeObj* correspondiente a *searchValue*
    • | -| flags | Integer |
    `vk find flag exact match`El contenido completo de la celda debe coincidir completamente con el valor de búsqueda
    `vk find flag ignore case`Las mayúsculas y minúsculas se consideran iguales. Ej: "a" es igual a "A".
    `vk find flag none`no se consideran banderas de búsqueda (por defecto)
    `vk find flag use wild cards`Caracteres comodín (\*,?) puede utilizarse en la cadena de búsqueda. Los caracteres comodín se pueden utilizar en cualquier comparación de cadenas para coincidir con cualquier número de caracteres:
  • \* para cero o varios caracteres (por ejemplo, al buscar "bl*" se puede encontrar "bl", "black" o "blob")
  • ? para un solo carácter (por ejemplo, la búsqueda de "h?t" puede encontrar "hot", o "hit"
    • Estos indicadores pueden combinarse. Por ejemplo: $search.flags:=vk find flag use wild cards+vk find flag ignore case | -| order | Integer |
    `vk find order by columns`La búsqueda se realiza por columnas. Cada fila de una columna se busca antes de que la búsqueda continúe a la siguiente columna.
    `vk find order by rows`La búsqueda se realiza por filas. Se busca en cada columna de una linea antes de continuar con la siguiente linea (por defecto)
    | -| target | Integer |
    `vk find target formula`La búsqueda se realiza en la fórmula de la celda
    `vk find target tag`La búsqueda se realiza en la etiqueta de la celda
    `vk find target text`La búsqueda se realiza en el texto de la celda (predeterminado)

    Estas banderas pueden combinarse. Por ejemplo:$search.target:=vk find target formula+vk find target text

    | +| Propiedad | Tipo | Descripción | +| ----------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| afterColumn | Integer | El número de la columna justo antes de la columna inicial de la búsqueda. Si *rangeObj* es un rango combinado, el número de columna indicado debe ser del primer rango. Valor por defecto: -1 (inicio de *rangeObj*) | +| afterRow | Integer | El número de la línea justo antes de la línea inicial de la búsqueda. Si *rangeObj* es un rango combinado, el número de línea indicado debe ser del primer rango. Valor por defecto: -1 (inicio de *rangeObj*) | +| all | Boolean |
  • True - Se devuelven todas las celdas en *rangeObj* correspondientes a *searchValue*
  • False - (valor por defecto) Sólo se devuelve la primera celda de *rangeObj* correspondiente a *searchValue*
    • | +| flags | Integer |
    `vk find flag exact match`El contenido completo de la celda debe coincidir completamente con el valor de búsqueda
    `vk find flag ignore case`Las mayúsculas y minúsculas se consideran iguales. Ej: "a" es lo mismo que "A".
    `vk find flag none`no search flags are considered (default)
    `vk find flag use wild cards`Wildcard characters (\*,?) puede utilizarse en la cadena de búsqueda. Los caracteres comodín se pueden utilizar en cualquier comparación de cadenas para coincidir con cualquier número de caracteres:
  • \* para cero o varios caracteres (por ejemplo, al buscar "bl*" se puede encontrar "bl", "black" o "blob")
  • ? para un solo carácter (por ejemplo, la búsqueda de "h?t" puede encontrar "hot", o "hit"
    • Estos indicadores pueden combinarse. Por ejemplo: $search.flags:=vk find flag use wild cards+vk find flag ignore case | +| order | Integer |
    `vk find order by columns`La búsqueda se realiza por columnas. Each row of a column is searched before the search continues to the next column.
    `vk find order by rows`The search is performed by rows. Se busca en cada columna de una linea antes de continuar con la siguiente linea (por defecto)
    | +| target | Integer |
    `vk find target formula`La búsqueda se realiza en la fórmula de la celda
    `vk find target tag`La búsqueda se realiza en la etiqueta de la celda
    `vk find target text`La búsqueda se realiza en el texto de la celda (predeterminado)

    Estas banderas pueden combinarse. Por ejemplo:$search.target:=vk find target formula+vk find target text

    | En el parámetro opcional *replaceValue*, puede pasar un texto para que ocupe el lugar de toda instancia del texto en el *searchValue* encontrado en *rangeObj*. From 40a489246499a68a2c47421240d26df6208b3b86 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:17:19 +0200 Subject: [PATCH 068/201] New translations vp-find.md (Japanese) --- .../version-21/ViewPro/commands/vp-find.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md index 70ceccbf7b40d6..c394508d9bed5b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-find.md @@ -32,8 +32,8 @@ title: VP Find | afterColumn | Integer | 検索を開始するカラムの直前のカラムの番号。 *rangeObj* 引数が統合されたレンジの場合、渡されるカラムの番号は最初のレンジのものでなければなりません。 デフォルト値: -1 (*rangeObj* の最初) | | afterRow | Integer | 検索を開始する行の直前の行番号。 *rangeObj* 引数が統合されたレンジの場合、渡される行番号は最初のレンジのものでなければなりません。 デフォルト値: -1 (*rangeObj* の最初) | | all | Boolean |
  • true - *rangeObj* 内で *searchValue* の値に合致するセルはすべて返されます。
  • false - (デフォルト値) *rangeObj* 内で *searchValue* の値に合致する最初のセルのみが返されます。
    • | -| flags | Integer |
    `vk find flag exact match`セルの中身全体が検索値と完全に一致する必要があります
    `vk find flag ignore case`文字の大小は区別されません。 例: "a" と "A" は同じとみなされます。
    `vk find flag none`検索フラグは指定されていません (デフォルト)。
    `vk find flag use wild cards`検索文字列においてワイルドカード文字 (\*,?) を使用できます。 ワイルドカードは、すべての文字列の比較に使用することができ、ワイルドカードによって置き換わる文字の数は指定されません:
  • \* は 0 から複数文字に使用可能です (例: "bl*" を検索した場合、"bl"、"black"、"blob" などが合致します)。
  • ? は単一文字に使用可能です (例: "h?t" を検索した場合、"hot"、"hit" などが合致します)。
    • フラグは組み合わせることができます。 例: $search.flags:=vk find flag use wild cards+vk find flag ignore case | -| order | Integer |
    `vk find order by columns`検索がカラムごとに実行されます。 カラムの各行が検索されたあとに次のカラムへと移動します。
    `vk find order by rows`検索が行ごとに実行されます。 行の各カラムが検索されたあとに次の行へと移動します (デフォルト)。
    | +| flags | Integer |
    `vk find flag exact match`セルの中身全体が検索値と完全に一致する必要があります
    `vk find flag ignore case`文字の大小は区別されません。 例: "a" と "A" は同じとみなされます。
    `vk find flag none`検索フラグは指定されていません(デフォルト)
    `vk find flag use wild cards`検索文字列においてワイルドカード文字(\*,?)を使用 を使用できます。 ワイルドカードは、すべての文字列の比較に使用することができ、ワイルドカードによって置き換わる文字の数は指定されません:
  • \* は 0 から複数文字に使用可能です (例: "bl*" を検索した場合、"bl"、"black"、"blob" などが合致します)。
  • ? は単一文字に使用可能です (例: "h?t" を検索した場合、"hot"、"hit" などが合致します)。
    • フラグは組み合わせることができます。 例: $search.flags:=vk find flag use wild cards+vk find flag ignore case | +| order | Integer |
    `vk find order by columns`検索がカラムごとに実行されます。 カラムの各行が検索されたあとに次のカラムへと移動します。
    `vk find order by rows`検索は行ごとに実行されます。 行の各カラムが検索されたあとに次の行へと移動します (デフォルト)。
    | | target | Integer |
    `vk find target formula`セルフォーミュラ内で検索がおこなわれます。
    `vk find target tag`セルタグ内で検索がおこなわれます。
    `vk find target text`セルテキスト内で検索がおこなわれます (デフォルト)。

    フラグは組み合わせることができます。 例:$search.target:=vk find target formula+vk find target text

    | 任意の *replaceValue* 引数として、*rangeObj* 内で見つかった *searchValue* の値のテキストを置換するテキストを渡すことができます。 From 3db4e4f65c9a6090592ca9df32cf96731d099de3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:19:55 +0200 Subject: [PATCH 069/201] New translations vp-import-document.md (French) --- .../ViewPro/commands/vp-import-document.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md index 9a7e1a0cf81fdb..9e4d78895e35dc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md @@ -43,33 +43,33 @@ Une erreur est retournée si le paramètre `filePath` est invalide, ou si le fic Le paramètre optionnel *paramObj* vous permet de définir les propriétés du document importé: -| Paramètres | | Type | Description | -| ------------ | ------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| formula | | 4D.Function | Une méthode callback à lancer lorsque l'import est terminé. Vous devez utiliser une formule retournée par la commande [`Formula`](../../commands/formula.md). See [Passing a callback method (formula)](vp-export-document.md#passing-a-callback-method-formula). | -| password | | text | Microsoft Excel uniquement (optionnel) - Mot de passe utilisé pour protéger un document Microsoft Excel. | -| csvOptions | | object | options d'import csv | -| | range | object | Plage de cellules contenant la première cellule dans laquelle les données seront saisies. Si la plage spécifiée n'est pas une plage de cellules, seule la première cellule de la plage est utilisée. | -| | rowDelimiter | text | Délimiteur de ligne. S'il n'est pas défini, le délimiteur est automatiquement déterminé par 4D. | -| | columnDelimiter | text | Délimiteur de colonne. Par défaut : "," | -| sjsOptions | | object | options d'import sjs | -| | calcOnDemand | boolean | Indique si les formules doivent être calculées uniquement lorsqu'elles sont demandées, la valeur par défaut est faux. | -| | dynamicReferences | boolean | Indique si les fonctions doivent être calculées avec des références dynamiques, la valeur par défaut est vrai. | -| | fullRecalc | boolean | Indique si le calcul doit être effectué après le chargement des données json, la valeur par défaut est faux. | -| | includeFormulas | boolean | Whether to include the formulas when loading, default is true. | -| | includeStyles | boolean | Whether to include the styles when loading, default is true. | -| | includeUnusedStyles | boolean | Whether to include the unused name styles when converting excel xml to the json, default is true. | -| | openMode | integer |
  • 0 (normal): normal open mode, without lazy and incremental. When opening file, UI and UI event could be refreshed and responsive at specific time points.
  • 1 (lazy): lazy open mode. When opening file, only the active sheet will be loaded directly. Other sheets will be loaded only when they are be used.
  • 2 (incremental): incremental open mode. When opening file, UI and UI event could be refreshed and responsive directly.
    • | -| excelOptions | | object | Excel only (optional) - Options for Excel export | -| | includeStyles | boolean | Whether to include the style when importing, default true. | -| | includeFormulas | boolean | Whether to include the formula when importing, default true. | -| | frozenColumnsAsRowHeaders | boolean | Whether to treat the frozen columns as row headers when importing, default false. | -| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | -| | fullRecalc | boolean | Indique si le calcul doit être effectué après le chargement des données json, la valeur par défaut est faux. | -| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | -| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | -| | includeUnusedStyles | boolean | Whether to include the unused name style when converting excel xml to the json, default true. | -| | password | text | The password to open the workbook. | -| | openMode | text | The open mode of normal, lazy and incremental. By default is normal. | +| Paramètres | | Type | Description | +| ------------ | ------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| formula | | 4D.Function | Une méthode callback à lancer lorsque l'import est terminé. Vous devez utiliser une formule retournée par la commande [`Formula`](../../commands/formula.md). See [Passing a callback method (formula)](vp-export-document.md#passing-a-callback-method-formula). | +| password | | text | Microsoft Excel uniquement (optionnel) - Mot de passe utilisé pour protéger un document Microsoft Excel. | +| csvOptions | | object | options d'import csv | +| | range | object | Plage de cellules contenant la première cellule dans laquelle les données seront saisies. Si la plage spécifiée n'est pas une plage de cellules, seule la première cellule de la plage est utilisée. | +| | rowDelimiter | text | Délimiteur de ligne. S'il n'est pas défini, le délimiteur est automatiquement déterminé par 4D. | +| | columnDelimiter | text | Délimiteur de colonne. Par défaut : "," | +| sjsOptions | | object | options d'import sjs | +| | calcOnDemand | boolean | Indique si les formules doivent être calculées uniquement lorsqu'elles sont demandées, la valeur par défaut est faux. | +| | dynamicReferences | boolean | Indique si les fonctions doivent être calculées avec des références dynamiques, la valeur par défaut est vrai. | +| | fullRecalc | boolean | Indique si le calcul doit être effectué après le chargement des données json, la valeur par défaut est faux. | +| | includeFormulas | boolean | Whether to include the formulas when loading, default is true. | +| | includeStyles | boolean | Whether to include the styles when loading, default is true. | +| | includeUnusedStyles | boolean | Whether to include the unused name styles when converting excel xml to the json, default is true. | +| | openMode | integer |
  • 0 (normal): normal open mode, without lazy and incremental. Lors de l'ouverture d'un fichier, l'interface utilisateur et l'événement d'interface utilisateur peuvent être actualisés et réactifs à des moments précis.
  • 1 (lazy) : mode d'ouverture lazy. When opening file, only the active sheet will be loaded directly. Les autres feuilles ne seront chargées que lorsqu'elles seront utilisées.
  • 2 (incrémental): mode d'ouverture incrémental. When opening file, UI and UI event could be refreshed and responsive directly.
    • | +| excelOptions | | object | Excel only (optional) - Options for Excel export | +| | includeStyles | boolean | Whether to include the style when importing, default true. | +| | includeFormulas | boolean | Whether to include the formula when importing, default true. | +| | frozenColumnsAsRowHeaders | boolean | Whether to treat the frozen columns as row headers when importing, default false. | +| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | +| | fullRecalc | boolean | Indique si le calcul doit être effectué après le chargement des données json, la valeur par défaut est faux. | +| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | +| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | +| | includeUnusedStyles | boolean | Whether to include the unused name style when converting excel xml to the json, default true. | +| | password | text | The password to open the workbook. | +| | openMode | text | The open mode of normal, lazy and incremental. By default is normal. | :::note Notes From ac9859791ca6e21d32920831f49bdb33f8311140 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:19:56 +0200 Subject: [PATCH 070/201] New translations vp-import-document.md (Spanish) --- .../ViewPro/commands/vp-import-document.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md index 5e65abf6ea6b63..ce43ad5c50c92a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md @@ -43,33 +43,33 @@ Se devuelve un error si el parámetro `filePath` no es válido, o si el archivo El parámetro opcional *paramObj* permite definir las propiedades del documento importado: -| Parámetros | | Tipo | Descripción | -| ------------ | ------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| formula | | 4D.Function | Un método de retollamada que se lanzará cuando la importación haya terminado. Debe utilizar una fórmula devuelta por el comando [`Formula`](../../commands/formula.md). Ver [Pasar un método de retrollamada (fórmula)](vp-export-document.md#passing-a-callback-method-formula). | -| contraseña | | text | Sólo Microsoft Excel (opcional) - La contraseña utilizada para proteger un documento MS Excel. | -| csvOptions | | object | opciones de importación csv | -| | range | object | Rango de celdas que contiene la primera celda donde se escribirán los datos. Si el rango especificado no es un rango de celdas, sólo se utiliza la primera celda del rango. | -| | rowDelimiter | text | Delimitador de línea. Si no está presente, el delimitador es determinado automáticamente por 4D. | -| | columnDelimiter | text | Delimitador de columna. Por defecto: "," | -| sjsOptions | | object | opciones para la importación de sjs | -| | calcOnDemand | boolean | Si se calculan las fórmulas sólo cuando se solicitan, por defecto es false. | -| | dynamicReferences | boolean | Si calcular funciones con referencias dinámicas, por defecto es true. | -| | fullRecalc | boolean | Si calcular después de cargar los datos json, false por defecto. | -| | includeFormulas | boolean | Si se incluyen las fórmulas al cargar, por defecto es true. | -| | includeStyles | boolean | Si se incluyen los estilos al cargar, por defecto es true. | -| | includeUnusedStyles | boolean | Si se incluyen los estilos de nombre no utilizados al convertir excel xml a json, por defecto es true. | -| | openMode | integer |
  • 0 (normal): modo abierto normal, sin perezoso (lazy) e incremental. Al abrir un archivo, la interfaz de usuario y el evento de interfaz de usuario podrían actualizarse y responder en momentos específicos.
  • 1 (lazy): modo de apertura lazy. Al abrir el archivo, sólo se cargará directamente la hoja activa. Las demás hojas sólo se cargarán cuando se vayan a utilizar.
  • 2 (incremental): modo de apertura incremental. Al abrir un archivo, la interfaz de usuario y el evento de interfaz de usuario podrían actualizarse y responder directamente.
    • | -| excelOptions | | object | Sólo Excel (opcional) - Opciones para exportar Excel | -| | includeStyles | boolean | Si se incluye el estilo al importar, por defecto true. | -| | includeFormulas | boolean | Si se incluye la fórmula al importar, por defecto true. | -| | frozenColumnsAsRowHeaders | boolean | Bien sea tratar las columnas congeladas como encabezados de línea al importar, por defecto false. | -| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | -| | fullRecalc | boolean | Si calcular después de cargar los datos json, false por defecto. | -| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | -| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | -| | includeUnusedStyles | boolean | Si incluir el estilo de nombre no utilizado al convertir excel xml al json, default true. | -| | contraseña | text | La contraseña para abrir el workbook. | -| | openMode | text | The open mode of normal, lazy and incremental. Por defecto es normal. | +| Parámetros | | Tipo | Descripción | +| ------------ | ------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| formula | | 4D.Function | Un método de retollamada que se lanzará cuando la importación haya terminado. Debe utilizar una fórmula devuelta por el comando [`Formula`](../../commands/formula.md). Ver [Pasar un método de retrollamada (fórmula)](vp-export-document.md#passing-a-callback-method-formula). | +| contraseña | | text | Sólo Microsoft Excel (opcional) - La contraseña utilizada para proteger un documento MS Excel. | +| csvOptions | | object | opciones de importación csv | +| | range | object | Rango de celdas que contiene la primera celda donde se escribirán los datos. Si el rango especificado no es un rango de celdas, sólo se utiliza la primera celda del rango. | +| | rowDelimiter | text | Delimitador de línea. Si no está presente, el delimitador es determinado automáticamente por 4D. | +| | columnDelimiter | text | Delimitador de columna. Por defecto: "," | +| sjsOptions | | object | opciones para la importación de sjs | +| | calcOnDemand | boolean | Si se calculan las fórmulas sólo cuando se solicitan, por defecto es false. | +| | dynamicReferences | boolean | Si calcular funciones con referencias dinámicas, por defecto es true. | +| | fullRecalc | boolean | Si calcular después de cargar los datos json, false por defecto. | +| | includeFormulas | boolean | Si se incluyen las fórmulas al cargar, por defecto es true. | +| | includeStyles | boolean | Si se incluyen los estilos al cargar, por defecto es true. | +| | includeUnusedStyles | boolean | Si se incluyen los estilos de nombre no utilizados al convertir excel xml a json, por defecto es true. | +| | openMode | integer |
  • 0 (normal): modo abierto normal, sin perezoso (lazy) e incremental. When opening file, UI and UI event could be refreshed and responsive at specific time points.
  • 1 (lazy): modo de apertura lazy. Al abrir el archivo, sólo se cargará directamente la hoja activa. Las demás hojas sólo se cargarán cuando se vayan a utilizar.
  • 2 (incremental): modo abierto incremental. Al abrir un archivo, la interfaz de usuario y el evento de interfaz de usuario podrían actualizarse y responder directamente.
    • | +| excelOptions | | object | Sólo Excel (opcional) - Opciones para exportar Excel | +| | includeStyles | boolean | Si se incluye el estilo al importar, por defecto true. | +| | includeFormulas | boolean | Si se incluye la fórmula al importar, por defecto true. | +| | frozenColumnsAsRowHeaders | boolean | Bien sea tratar las columnas congeladas como encabezados de línea al importar, por defecto false. | +| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | +| | fullRecalc | boolean | Si calcular después de cargar los datos json, false por defecto. | +| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | +| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | +| | includeUnusedStyles | boolean | Si incluir el estilo de nombre no utilizado al convertir excel xml al json, default true. | +| | contraseña | text | La contraseña para abrir el workbook. | +| | openMode | text | The open mode of normal, lazy and incremental. Por defecto es normal. | :::note Notas From 5fe5c97e82178405899bf3618100fe1b0a4e82f7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:19:58 +0200 Subject: [PATCH 071/201] New translations vp-import-document.md (Japanese) --- .../ViewPro/commands/vp-import-document.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md index 5d069870ab5a4e..d2178137e0151b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-import-document.md @@ -43,33 +43,33 @@ title: VP IMPORT DOCUMENT 任意の *paramObj* 引数を渡すことで、読み込まれるドキュメントのプロパティを定義することができます: -| 引数 | | 型 | 説明 | -| ------------ | ------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| formula | | 4D.Function | 読み込み終了時に実行させるコールバックメソッド。 [`Formula`](../../commands/formula.md) コマンドの戻り値フォーミュラを使用する必要があります。 [コールバックメソッド (フォーミュラ) の渡し方](vp-export-document.md#コールバックメソッド-フォーミュラ-の渡し方) を参照ください。 | -| password | | text | Microsoft Excel のみ (任意) - MS Excel ドキュメントの保護に使用されているパスワード。 | -| csvOptions | | object | CSV読み込みのオプション | -| | range | object | 書き出されるデータの、最初のセルを格納しているセルレンジ。 指定されたレンジがセルレンジではない場合、レンジの最初のセルが使用されます。 | -| | rowDelimiter | text | 行の区切り文字。 渡されなかった場合、区切り文字は 4D によって自動的に定義されます。 | -| | columnDelimiter | text | カラムの区切り文字。 デフォルト: "," | -| sjsOptions | | object | sjs 読み込みのオプション | -| | calcOnDemand | boolean | 要求されたときにだけフォーミュラを計算するかどうか。デフォルトは false。 | -| | dynamicReferences | boolean | 動的参照を含む関数を計算するかどうか。デフォルトは true。 | -| | fullRecalc | boolean | jsonデータを読み込んだ後に計算するかどうか。デフォルトは false。 | -| | includeFormulas | boolean | 読み込み時にフォーミュラを含めるかどうか。デフォルトは true。 | -| | includeStyles | boolean | 読み込み時にスタイルを含めるかどうか。デフォルトは true。 | -| | includeUnusedStyles | boolean | excel xml を json に変換する際、使用されていないカスタム名を含めるかどうか。デフォルトは true。 | -| | openMode | integer |
  • 0 (normal): 通常のオープンモード、レイジーなし、インクリメンタルなし。 ファイルを開くと、特定の時点で UI と UIイベントが更新され、応答します。
  • 1 (lazy): レイジー (遅延) オープンモード。 ファイルを開くと、アクティブなシートだけが直接読み込まれます。 ファイルを開くと、アクティブなシートだけが直接読み込まれます。 他のシートは使用された場合にのみ読み込まれます。
  • 2 (incremental): インクリメンタル (増分) オープンモード。 ファイルを開くと、データ読み込み中に UI と UIイベントが更新され、即座に応答します。
    • | -| excelOptions | | object | Excel のみ (任意) - Excel 書き出しのオプション | -| | includeStyles | boolean | Whether to include the style when importing, default true. | -| | includeFormulas | boolean | Whether to include the formula when importing, default true. | -| | frozenColumnsAsRowHeaders | boolean | Whether to treat the frozen columns as row headers when importing, default false. | -| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | -| | fullRecalc | boolean | jsonデータを読み込んだ後に計算するかどうか。デフォルトは false。 | -| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | -| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | -| | includeUnusedStyles | boolean | Whether to include the unused name style when converting excel xml to the json, default true. | -| | password | text | The password to open the workbook. | -| | openMode | text | The open mode of normal, lazy and incremental. By default is normal. | +| 引数 | | 型 | 説明 | +| ------------ | ------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| formula | | 4D.Function | 読み込み終了時に実行させるコールバックメソッド。 [`Formula`](../../commands/formula.md) コマンドの戻り値フォーミュラを使用する必要があります。 [コールバックメソッド (フォーミュラ) の渡し方](vp-export-document.md#コールバックメソッド-フォーミュラ-の渡し方) を参照ください。 | +| password | | text | Microsoft Excel のみ (任意) - MS Excel ドキュメントの保護に使用されているパスワード。 | +| csvOptions | | object | CSV読み込みのオプション | +| | range | object | 書き出されるデータの、最初のセルを格納しているセルレンジ。 指定されたレンジがセルレンジではない場合、レンジの最初のセルが使用されます。 | +| | rowDelimiter | text | 行の区切り文字。 渡されなかった場合、区切り文字は 4D によって自動的に定義されます。 | +| | columnDelimiter | text | カラムの区切り文字。 デフォルト: "," | +| sjsOptions | | object | sjs 読み込みのオプション | +| | calcOnDemand | boolean | 要求されたときにだけフォーミュラを計算するかどうか。デフォルトは false。 | +| | dynamicReferences | boolean | 動的参照を含む関数を計算するかどうか。デフォルトは true。 | +| | fullRecalc | boolean | jsonデータを読み込んだ後に計算するかどうか。デフォルトは false。 | +| | includeFormulas | boolean | 読み込み時にフォーミュラを含めるかどうか。デフォルトは true。 | +| | includeStyles | boolean | 読み込み時にスタイルを含めるかどうか。デフォルトは true。 | +| | includeUnusedStyles | boolean | excel xml を json に変換する際、使用されていないカスタム名を含めるかどうか。デフォルトは true。 | +| | openMode | integer |
  • 0 (normal): 通常のオープンモード、レイジーなし、インクリメンタルなし。 ファイルを開くと、特定の時点で UI と UIイベントが更新され、応答します。
  • 1 (lazy): レイジー (遅延) オープンモード。 ファイルを開くと、アクティブなシートだけが直接読み込まれます。 他のシートは使用された場合にのみ読み込まれます。
  • 2 (incremental): インクリメンタル (増分) オープンモード。 ファイルを開くと、データ読み込み中に UI と UIイベントが更新され、即座に応答します。
    • | +| excelOptions | | object | Excel のみ (任意) - Excel 書き出しのオプション | +| | includeStyles | boolean | Whether to include the style when importing, default true. | +| | includeFormulas | boolean | Whether to include the formula when importing, default true. | +| | frozenColumnsAsRowHeaders | boolean | Whether to treat the frozen columns as row headers when importing, default false. | +| | frozenRowsAsColumnHeaders | boolean | Whether to treat the frozen rows as column headers when importing, default false. | +| | fullRecalc | boolean | jsonデータを読み込んだ後に計算するかどうか。デフォルトは false。 | +| | dynamicReferences | boolean | Whether to calculate functions with dynamic reference, default true. | +| | calcOnDemand | boolean | Whether to calculate formulas only when they are demanded, default false. | +| | includeUnusedStyles | boolean | Whether to include the unused name style when converting excel xml to the json, default true. | +| | password | text | The password to open the workbook. | +| | openMode | text | The open mode of normal, lazy and incremental. By default is normal. | :::note 注記 From 68579a97856d9f0f40b73fe730cb12797ff5d59d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:20:29 +0200 Subject: [PATCH 072/201] New translations vp-move-cells.md (French) --- .../version-21/ViewPro/commands/vp-move-cells.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md index 06c23b842ecbd4..825e1a99be63eb 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md @@ -35,10 +35,10 @@ Dans *targetRange*, passez la plage de cellules où les valeurs, le style et les Le paramètre *options* a plusieurs propriétés : -| Propriété | Type | Description | -| ------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | Détermine si les valeurs, la mise en forme et les formules des cellules de *originRange* sont supprimés après l'exécution de la commande :
    • *False* (par défaut) pour les supprimer
    • *True* pour les conserver
    | -| pasteOptions | Integer | Spécifie ce qui est collé. Valeurs possibles :

    ValeurDescription
    `vk clipboard options all` (default)Colle tous les objets de données, y compris les valeurs, la mise en forme et les formules.
    `vk clipboard options formatting`Colle uniquement la mise en forme.
    `vk clipboard options formulas`Colle uniquement les formules.
    `vk clipboard options formulas and formatting`Colle les formules et la mise en forme.
    `vk clipboard options values`Colle uniquement les valeurs.
    `vk clipboard options value and formatting`Colle les valeurs et la mise en forme

    | +| Propriété | Type | Description | +| ------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | Détermine si les valeurs, la mise en forme et les formules des cellules de *originRange* sont supprimés après l'exécution de la commande :
    • *False* (par défaut) pour les supprimer
    • *True* pour les conserver
    | +| pasteOptions | Integer | Spécifie ce qui est collé. Valeurs possibles :

    ValeurDescription
    `vk clipboard options all` (par défaut)Colle tous les objets de données, y compris les valeurs, la mise en forme et les formules.
    `vk clipboard options formatting`Ne colle que la mise en forme..
    `vk clipboard options formulas`Ne colle que les formules.
    `vk clipboard options formulas and formatting`Colle les formules et la mise en forme.
    `vk clipboard options values`Ne colle que les valeurs.
    `vk clipboard options value and formatting`Colle les valeurs et la mise en forme.

    | Les options de collage définies dans [workbook options](vp-set-workbook-options.md) sont prises en compte. From 3fbdee7d985bc1b8304f8d6a032890569a20db26 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:20:31 +0200 Subject: [PATCH 073/201] New translations vp-move-cells.md (Spanish) --- .../version-21/ViewPro/commands/vp-move-cells.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md index b4ead57aa40468..dd9df040b43600 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md @@ -35,10 +35,10 @@ En *targetRange*, pase el rango de celdas donde se copiarán o moverán los valo El parámetro *options* tiene varias propiedades: -| Propiedad | Tipo | Descripción | -| ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | -| pasteOptions | Integer | Especifica lo que se pega. Valores posibles:

    ValorDescripción
    `vk clipboard options all` (por defecto)Pega todos los objetos de datos, incluidos los valores, el formato y las fórmulas.
    `vk clipboard options formatting`Pega sólo el formato.
    `vk clipboard options formulas`Pega sólo las fórmulas.
    `vk clipboard options formulas and formatting`Pega las fórmulas y el formato.
    `vk clipboard options values`Pega sólo los valores.
    `vk clipboard options value and formatting`Pega los valores y el formato.

    | +| Propiedad | Tipo | Descripción | +| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | +| pasteOptions | Integer | Especifica lo que se pega. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Pastes all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Pastes only the formatting.
    `vk clipboard options formulas`Pastes only the formulas.
    `vk clipboard options formulas and formatting`Pastes the formulas and formatting.
    `vk clipboard options values`Pastes only the values.
    `vk clipboard options value and formatting`Pastes the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From d69a3e6f9fe00e23270edd14e1a6a831593503c2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:20:32 +0200 Subject: [PATCH 074/201] New translations vp-move-cells.md (Japanese) --- .../version-21/ViewPro/commands/vp-move-cells.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md index b60aa5046e33ff..731d78f1d33f84 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md @@ -35,10 +35,10 @@ title: VP MOVE CELLS *options* は、複数のプロパティを持ちます: -| プロパティ | 型 | 説明 | -| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | *originRange* のセルの値・書式・フォーミュラをコマンド実行後に削除するかどうかを指定します:
    • 削除するには *false* (デフォルト)。
    • 保持するには *true*。
    | -| pasteOptions | Integer | ペーストする内容を指定します。 とりうる値:

    値説明
    `vk clipboard options all` (デフォルト)値・フォーマット・フォーミュラを含むすべてのデータオブジェクトをペーストします。
    `vk clipboard options formatting`フォーマットだけをペーストします。
    `vk clipboard options formulas`フォーミュラだけをペーストします。
    `vk clipboard options formulas and formatting`フォーミュラとフォーマットをペーストします。
    `vk clipboard options values`値だけをペーストします。
    `vk clipboard options value and formatting`値とフォーマットをペーストします。

    | +| プロパティ | 型 | 説明 | +| ------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | *originRange* のセルの値・書式・フォーミュラをコマンド実行後に削除するかどうかを指定します:
    • 削除するには *false* (デフォルト)。
    • 保持するには *true*。
    | +| pasteOptions | Integer | ペーストする内容を指定します。 取り得る値:

    値詳細
    `vk clipboard options all` (デフォルト)値、書式、数式を含め、全てのデータオブジェクトをペーストします。
    `vk clipboard options formatting`書式のみをペーストします。
    `vk clipboard options formulas`数式のみをペーストします。
    `vk clipboard options formulas and formatting`数式と書式をコピーします。
    `vk clipboard options values`値のみをペーストします。
    `vk clipboard options value and formatting`値と書式をペーストします。

    | [ワークブックオプション](vp-set-workbook-options.md) で定義されている貼り付けオプションが考慮されます。 From ea25ff59116d6e28f933ab0e80c8a37e9f5d45a5 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:21:50 +0200 Subject: [PATCH 075/201] New translations vp-row.md (French) --- .../version-21/ViewPro/commands/vp-row.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-row.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-row.md index 2213cd4df3bfb5..b7b51cdbcc4c1a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-row.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-row.md @@ -33,7 +33,7 @@ Dans le paramètre optionnel *sheet*, vous pouvez désigner une feuille spécifi ## Exemple -Vous souhaitez définir une plage pour la ligne ci-dessous (dans la feuille de calcul courante) : +Vous souhaitez définir une plage pour la ligne ci-dessous (dans la feuille courante) : ![](../../assets/en/ViewPro/cmd_vpRow.PNG) From 166b1a3bbef5907ec680bf5d3912aa3df4403ecf Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:22:44 +0200 Subject: [PATCH 076/201] New translations vp-set-data-context.md (Spanish) --- .../version-21/ViewPro/commands/vp-set-data-context.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md index b495dcab799355..8a32e26833bd1a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md @@ -42,10 +42,10 @@ Para pasar un valor de tiempo en *dataObj* o *dataColl*, encapsúlelo en un obje En *options*, puede pasar un objeto que especifique las opciones adicionales. Las propiedades posibles son: -| Propiedad | Tipo | Descripción | -| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| reset | Object | True para restablecer el contenido de la hoja antes de cargar el nuevo contexto, False (por defecto) en caso contrario. | -| autoGenerateColumns | Object | Sólo se utiliza cuando los datos son una colección. True (por defecto) para especificar que las columnas deben generarse automáticamente cuando se vincula el contexto de datos. En este caso, se aplican las siguientes reglas:
    • Si *dataColl* es una colección de objetos, los nombres de los atributos se utilizan como títulos de las columnas (ver el ejemplo 2).
    • Si *dataColl* contiene subcolecciones de valores escalares, cada subcolección define los valores de una fila (ver el ejemplo 3). La primera subcolección determina cuántas columnas se crean.
    | +| Propiedad | Tipo | Descripción | +| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| reset | Object | True para restablecer el contenido de la hoja antes de cargar el nuevo contexto, False (por defecto) en caso contrario. | +| autoGenerateColumns | Object | Sólo se utiliza cuando los datos son una colección. True (por defecto) para especificar que las columnas deben generarse automáticamente cuando se vincula el contexto de datos. In this case, the following rules apply:
    • If *dataColl* is a collection of objects, attribute names are used as column titles (see example 2).
    • If *dataColl* contains subcollections of scalar values, each subcollection defines the values in a row (see example 3). La primera subcolección determina cuántas columnas se crean.
    | En *sheet*, pase el índice de la hoja que recibirá el contexto de datos. Si no se pasa ningún índice, el contexto se aplica a la hoja actual. From 72fbea4d4d13548723aeaf75650f59e7cad55a3e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:22:46 +0200 Subject: [PATCH 077/201] New translations vp-set-data-context.md (Japanese) --- .../version-21/ViewPro/commands/vp-set-data-context.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md index 36566919d9dbcf..a0a7967066cd84 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-data-context.md @@ -42,10 +42,10 @@ title: VP SET DATA CONTEXT *options* には、追加のオプションを格納したオブジェクトを渡せます。 利用可能なプロパティは次のとおりです: -| プロパティ | 型 | 説明 | -| ------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| reset | Object | 新しいコンテキストを読み込む前にシートの内容をリセットする場合は true、それ以外は false (デフォルト) | -| autoGenerateColumns | Object | コレクション型のデータの場合にのみ使用します。 データコンテキストがバインドされると同時に、カラムを自動生成する場合は true (デフォルト)。 この場合、次のルールが適用されます:
    • *dataColl* がオブジェクトのコレクションの場合、属性名はカラムのタイトルとして使用されます (例題 2 参照)。
    • *dataColl* がスカラー値のサブコレクションを含む場合、各サブコレクションは一つの行の値を定義します (例題 3 参照)。 最初のサブコレクションにより、生成されるカラム数が決定します。
    | +| プロパティ | 型 | 説明 | +| ------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| reset | Object | 新しいコンテキストを読み込む前にシートの内容をリセットする場合は true、それ以外は false (デフォルト) | +| autoGenerateColumns | Object | コレクション型のデータの場合にのみ使用します。 データコンテキストがバインドされると同時に、カラムを自動生成する場合は true (デフォルト)。 この場合、以下のルールが適用されます:
    • If *dataColl* がオブジェクトのコレクションである場合、属性名がカラムのタイトルとして使用されます(例題2 を参照)。
    • *dataColl* がスカラー値のサブコレクションを格納している場合、各サブコレクションは一つの行の値を定義します (例題3 参照)。 最初のサブコレクションにより、生成されるカラム数が決定します。
    | *sheet* には、データコンテキストを受け取るシートのインデックスを渡します。 インデックスを渡さなかった場合、コンテキストはカレントシートに対して適用されます。 From 13baa260e934f350f225f5e4e0de5d5e9fa270b1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:23:57 +0200 Subject: [PATCH 078/201] New translations vp-set-show-print-lines.md (Japanese) --- .../version-21/ViewPro/commands/vp-set-show-print-lines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-show-print-lines.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-show-print-lines.md index 39fe5f6b0ff3cd..2657e9dbfee53e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-show-print-lines.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-show-print-lines.md @@ -17,7 +17,7 @@ title: VP SET SHOW PRINT LINES ## 説明 -`VP SET SHOW PRINT LINES` コマンドは、 スプレッドシート内で印刷プレビュー線を表示するかどうかを設定します。 +`VP SET SHOW PRINT LINES` コマンドは、スプレッドシート内で印刷プレビュー線を表示するかどうかを設定します。。 *vpAreaName* には、4D View Pro エリアの名前を渡します。 From 8db61f7fa5b1055b9d64ede5f7d56ec2f93c1ed0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:28 +0200 Subject: [PATCH 079/201] New translations vp-set-workbook-options.md (French) --- .../commands/vp-set-workbook-options.md | 120 +++++++++--------- 1 file changed, 60 insertions(+), 60 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md index 2999513fe85d7c..7407f3c7a4eb04 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md @@ -29,66 +29,66 @@ Les options modifiées du classeur sont enregistrées avec le document. Le tableau suivant répertorie les options de classeur disponibles : -| Propriété | Type | Description | -| ------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| allowUserDragMerge | boolean | L'opération de fusion par glisser est autorisée (sélection des cellules et glisser de la sélection pour fusionner les cellules) | -| allowAutoCreateHyperlink | boolean | Permet la création automatique d'hyperliens dans la feuille de calcul. | -| allowContextMenu | boolean | Le menu contextuel intégré peut être ouvert. | -| allowCopyPasteExcelStyle | boolean | Les styles d'une feuille de calcul peuvent être copiés et collés dans Excel, et vice-versa. | -| allowDynamicArray | boolean | Active les tableaux dynamiques dans les feuilles de travail | -| allowExtendPasteRange | boolean | Étend la plage collée si la plage collée n'est pas suffisante pour les données collées | -| allowSheetReorder | boolean | La réorganisation de la feuille est autorisée | -| allowUndo | boolean | L'annulation des modifications est autorisée. | -| allowUserDeselect | boolean | La désélection de cellules spécifiques d'une sélection est autorisée. | -| allowUserDragDrop | boolean | Glisser-déposer des données de plage est autorisé | -| allowUserDragFill | boolean | Le remplissage par glisser est autorisé | -| allowUserEditFormula | boolean | Des formules peuvent être saisies dans les cellules | -| allowUserResize | boolean | Les colonnes et les lignes peuvent être redimensionnées | -| allowUserZoom | boolean | Le zoom (ctrl + molette de la souris) est autorisé | -| autoFitType | number | Le contenu est formaté pour tenir dans les cellules, les cellules et les en-têtes. Valeurs disponibles :
    ConstanteValeurDescription
    vk auto fit type cell 0 Le contenu ajuste automatiquement les cellules
    vk auto fit type cell with header 1 Le contenu ajuste automatiquement les cellules et les en-têtes
    | -| backColor | string | Chaîne de couleur utilisée pour représenter la couleur de fond de la zone, comme "rouge", "#FFFF00", "rgb(255,0,0)", "Accent 5". La couleur de fond initiale est masquée lorsqu'une image de fond est définie. | -| backgroundImage | string / picture / file | Image de fond de la zone. | -| backgroundImageLayout | number | Comment l'image de fond s'affiche. Valeurs disponibles :
    ConstanteValeurDescription
    vk image layout center 1 Au centre de la zone.
    vk image layout none 3 Dans le coin supérieur gauche de la zone avec sa taille originale.
    vk image layout stretch 0 Remplit la zone.
    vk image layout zoom 2 S'affiche avec son ratio d'aspect d'origine.
    | -| calcOnDemand | boolean | Les formules ne sont calculées que lorsqu'elles sont demandées. | -| columnResizeMode | number | Mode redimensionnement pour les colonnes. Valeurs disponibles :
    ConstanteValeurDescription
    vk resize mode normal 0 Utilise le mode de redimensionnement normal (c'est-à-dire que les colonnes restantes sont affectées)
    vk resize mode split 1 Utiliser le mode fractionné (les colonnes restantes ne sont pas affectées)
    | -| copyPasteHeaderOptions | number | En-têtes à inclure lorsque les données sont copiées ou collées. Valeurs disponibles :
    ConstanteValeurDescription
    vk copy paste header options all headers3 Inclut les en-têtes sélectionnés lorsque les données sont copiées ; écrase les en-têtes sélectionnés lorsque les données sont collées.
    vk copy paste header options column headers 2 Inclut les en-têtes de colonnes sélectionnées lorsque les données sont copiées ; écrase les en-têtes de colonnes sélectionnées lorsque les données sont collées.
    vk copy paste header options no headers0 Les en-têtes de colonne et de ligne ne sont pas inclus lorsque les données sont copiées ; les en-têtes de colonne ou de ligne sélectionnés ne sont pas écrasés lorsque les données sont collées.
    vk copy paste header options row headers1 Inclut les en-têtes de ligne sélectionnés lorsque les données sont copiées ; écrase les en-têtes de ligne sélectionnés lorsque les données sont collées.
    | -| customList | collection | Liste pour que les utilisateurs personnalisent le remplissage par glisser-déposer, en priorisant la correspondance de cette liste dans chaque remplissage. Chaque élément de collection est une collection de strings. Voir sur [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists). | -| cutCopyIndicatorBorderColor | string | Couleur de bordure de l'indicateur affiché lorsque l'utilisateur coupe ou copie la sélection. | -| cutCopyIndicatorVisible | boolean | Afficher un indicateur lors du copier ou du coller de l'élément sélectionné. | -| defaultDragFillType | number | Le type de remplissage par défaut du glisser-déposer. Valeurs disponibles :
    ConstanteValeurDescription
    vk auto fill type auto 5 Remplit automatiquement les cellules.
    vk auto fill type clear values 4 Efface les valeurs des cellules.
    vk auto fill type copycells 0 Remplit les cellules avec tous les objets de données, y compris les valeurs, la mise en forme et les formules.
    vk auto fill type fill formatting only 2 Remplit les cellules uniquement avec la mise en forme.
    vk auto fill type fill series 1 Remplit les cellules avec des séries.
    vk auto fill type fill without formatting 3 Remplit les cellules avec des valeurs sans les formater.
    | -| enableAccessibility | boolean | La prise en charge de l'accessibilité est activée dans la feuille de calcul. | -| enableFormulaTextbox | boolean | La zone de texte de la formule est activée. | -| grayAreaBackColor | string | Une chaîne de couleur utilisée pour représenter la couleur de fond de la zone grise, comme "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | -| highlightInvalidData | boolean | Les données non valides sont surlignées. | -| iterativeCalculation | boolean | Active le calcul itératif. Voir sur [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative). | -| iterativeCalculationMaximumChange | numérique | Montant maximum de changement entre deux valeurs de calcul. | -| iterativeCalculationMaximumIterations | numérique | Nombre de fois maximum que la formule doit recalculer. | -| newTabVisible | boolean | Afficher un onglet spécial pour permettre aux utilisateurs d'insérer de nouvelles feuilles. | -| numbersFitMode | number | Modifie le mode d'affichage lorsque la largeur des données date/nombre est plus longue que la largeur des colonnes. Valeurs disponibles : vk
    ConstanteValeurDescription
    vk numbers fit mode mask0 Remplace le contenu des données par "###" et affiche l'astuce
    numbers fit mode overflow 1 Affiche le contenu des données sous forme de chaîne de caractères. Si la cellule suivante est vide, le contenu est débordé.
    | -| pasteSkipInvisibleRange | boolean | Coller ou ne pas coller les données dans les plages invisibles :
    • False (par défaut) : coller les données
    • True : Ne pas coller les données dans les plages invisibles
    Voir [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) pour plus d'informations sur les plages invisibles. | -| referenceStyle | number | Style pour les références de cellules et de plages dans les formules de cellules. Valeurs disponibles :
    ConstanteValeur Description
    vk reference style A1 0 Utiliser le style A1.
    vk reference style R1C1 1 Utiliser le style R1C1
    | -| resizeZeroIndicator | number | Règle de dessin lorsque la ligne ou la colonne est redimensionnée à zéro. Valeurs disponibles :
    ConstanteValeurDescription
    vk resize zero indicator default 0 Utilise la politique de dessin actuelle lorsque la ligne ou la colonne est redimensionnée à zéro.
    vk resize zero indicator enhanced 1 Dessine deux lignes courtes lorsque la ligne ou la colonne est redimensionnée à zéro.
    | -| rowResizeMode | number | La façon dont les lignes sont redimensionnées. Les valeurs disponibles sont les mêmes que columnResizeMode | -| scrollbarAppearance | number | Apparence de la barre de défilement. Valeurs disponibles :
    ConstanteValeurDescription
    vk scrollbar appearance mobile1 Apparence de la barre de défilement mobile.
    vk scrollbar appearance skin (par défaut)0 Apparence de la barre de défilement classique de type Excel.
    | -| scrollbarMaxAlign | boolean | La barre de défilement s'aligne sur la dernière ligne et la dernière colonne de la feuille courante. | -| scrollbarShowMax | boolean | Les barres de défilement affichées sont basées sur le nombre total de colonnes et de lignes dans la feuille. | -| scrollByPixel | boolean | Activer le défilement de précision par pixel. | -| scrollIgnoreHidden | boolean | La barre de défilement ignore les lignes ou colonnes cachées. | -| scrollPixel | integer | Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Par exemple : le delta de défilement est de 3, scrollPixel est de 5, le défilement final de pixels est de 15. | -| showDragDropTip | boolean | Afficher l'info bulle de glisser-déposer. | -| showDragFillSmartTag | boolean | Afficher la boîte de dialogue de remplissage par glisser-déplacer. | -| showDragFillTip | boolean | Afficher l'info bulle de glisser-remplir. | -| showHorizontalScrollbar | boolean | Afficher la barre de défilement horizontale. | -| showResizeTip | number | Comment afficher l'info-bulle de redimensionnement. Valeurs disponibles :
    ConstanteValeurDescription
    vk show resize tip both 3 Des astuces de redimensionnement horizontaux et verticaux sont affichés.
    vk show resize tip column 1 Seule l'astuce de redimensionnement horizontal est affiché.
    vk show resize tip none 0 Aucune astuce de redimensionnement n'est affiché.
    vk show resize tip row 2 Seule l'astuce de redimensionnement vertical est affiché.
    | -| showScrollTip | number | Comment afficher les info-bulles de défilement. Valeurs disponibles :
    ConstanteValeurDescription
    vk show scroll tip both 3 Des astuces de défilement horizontales et verticales sont affichées.
    vk show scroll tip horizontal 1 Seule l'astuce de défilement horizontale est affichée.
    vk show scroll tip none Aucune astuce de défilement n'est affichée.
    vk show scroll tip vertical 2 Seule l'astuce de défilement verticale est affichée.
    | -| showVerticalScrollbar | boolean | Afficher la barre de défilement verticale. | -| tabEditable | boolean | La barre d'onglets de la feuille peut être modifiée. | -| tabNavigationVisible | boolean | Afficher l'onglet de navigation de la feuille. | -| tabStripPosition | number | Position de la barre d'onglets. Valeurs disponibles :
    ConstanteValeurDescription
    vk tab strip position bottom 0 La position de la barre de tabulation est relative au bas du classeur.
    vk tab strip position left 2 La position de la barre de tabulation est relative à la gauche du classeur.
    vk tab strip position right 3 La position de la barre de tabulation est relative à la droite du classeur.
    vk tab strip position top 1 La position de la barre de tabulation est relative au haut du classeur.
    | -| tabStripRatio | number | Valeur de pourcentage (0.x) qui spécifie combien d'espace horizontal sera alloué à la barre d'onglets. Le reste de la zone horizontale (1 - 0.x) sera alloué à la barre de défilement horizontale. | -| tabStripVisible | boolean | Afficher la barre d'onglets de la feuille. | -| tabStripWidth | number | Largeur de la barre d'onglets lorsque la position est à gauche ou à droite. Par défaut et minimum 80. | -| useTouchLayout | boolean | Utiliser ou non le format tactile pour présenter le composant Spread. | +| Propriété | Type | Description | +| ------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| allowUserDragMerge | boolean | L'opération de fusion par glisser est autorisée (sélection des cellules et glisser de la sélection pour fusionner les cellules) | +| allowAutoCreateHyperlink | boolean | Permet la création automatique d'hyperliens dans la feuille de calcul. | +| allowContextMenu | boolean | Le menu contextuel intégré peut être ouvert. | +| allowCopyPasteExcelStyle | boolean | Les styles d'une feuille de calcul peuvent être copiés et collés dans Excel, et vice-versa. | +| allowDynamicArray | boolean | Active les tableaux dynamiques dans les feuilles de travail | +| allowExtendPasteRange | boolean | Étend la plage collée si la plage collée n'est pas suffisante pour les données collées | +| allowSheetReorder | boolean | La réorganisation de la feuille est autorisée | +| allowUndo | boolean | L'annulation des modifications est autorisée. | +| allowUserDeselect | boolean | La désélection de cellules spécifiques d'une sélection est autorisée. | +| allowUserDragDrop | boolean | Glisser-déposer des données de plage est autorisé | +| allowUserDragFill | boolean | Le remplissage par glisser est autorisé | +| allowUserEditFormula | boolean | Des formules peuvent être saisies dans les cellules | +| allowUserResize | boolean | Les colonnes et les lignes peuvent être redimensionnées | +| allowUserZoom | boolean | Le zoom (ctrl + molette de la souris) est autorisé | +| autoFitType | number | Le contenu est formaté pour tenir dans les cellules, les cellules et les en-têtes. Valeurs disponibles :
    ConstanteValeurDescription
    vk auto fit type cell 0 Le contenu ajuste automatiquement les cellules
    vk auto fit type cell with header 1 Le contenu ajuste automatiquement les cellules et les en-têtes
    | +| backColor | string | Chaîne de couleur utilisée pour représenter la couleur de fond de la zone, comme "rouge", "#FFFF00", "rgb(255,0,0)", "Accent 5". La couleur de fond initiale est masquée lorsqu'une image de fond est définie. | +| backgroundImage | string / picture / file | Image de fond de la zone. | +| backgroundImageLayout | number | Comment l'image de fond s'affiche. Available values:
    ConstantValueDescription
    vk image layout center 1 In the center of the area.
    vk image layout none 3 In the upper left corner of the area with its original size.
    vk image layout stretch 0 Fills the area.
    vk image layout zoom 2 Displayed with its original aspect ratio.
    | +| calcOnDemand | boolean | Les formules ne sont calculées que lorsqu'elles sont demandées. | +| columnResizeMode | number | Mode redimensionnement pour les colonnes. Valeurs disponibles :
    ConstanteValeurDescription
    vk resize mode normal 0 Utilise le mode de redimensionnement normal (c'est-à-dire que les colonnes restantes sont affectées)
    vk resize mode split 1 Utiliser le mode fractionné (les colonnes restantes ne sont pas affectées)
    | +| copyPasteHeaderOptions | number | En-têtes à inclure lorsque les données sont copiées ou collées. Available values:
    ConstantValueDescription
    vk copy paste header options all headers3 Includes selected headers when data is copied; overwrites selected headers when data is pasted.
    vk copy paste header options column headers 2 Includes selected column headers when data is copied; overwrites selected column headers when data is pasted.
    vk copy paste header options no headers0 Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted.
    vk copy paste header options row headers1 Includes selected row headers when data is copied; overwrites selected row headers when data is pasted.
    | +| customList | collection | Liste pour que les utilisateurs personnalisent le remplissage par glisser-déposer, en priorisant la correspondance de cette liste dans chaque remplissage. Chaque élément de collection est une collection de strings. Voir sur [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists). | +| cutCopyIndicatorBorderColor | string | Couleur de bordure de l'indicateur affiché lorsque l'utilisateur coupe ou copie la sélection. | +| cutCopyIndicatorVisible | boolean | Afficher un indicateur lors du copier ou du coller de l'élément sélectionné. | +| defaultDragFillType | number | Le type de remplissage par défaut du glisser-déposer. Valeurs disponibles :
    ConstanteValeurDescription
    vk auto fill type auto 5 Remplit automatiquement les cellules.
    vk auto fill type clear values 4 Clears cell values.
    vk auto fill type copycells 0 Fills cells with all data objects, including values, formatting, and formulas.
    vk auto fill type fill formatting only 2 Fills cells only with formatting.
    vk auto fill type fill series 1 Fills cells with series.
    vk auto fill type fill without formatting 3 Remplit les cellules avec des valeurs sans les formater.
    | +| enableAccessibility | boolean | La prise en charge de l'accessibilité est activée dans la feuille de calcul. | +| enableFormulaTextbox | boolean | La zone de texte de la formule est activée. | +| grayAreaBackColor | string | Une chaîne de couleur utilisée pour représenter la couleur de fond de la zone grise, comme "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | +| highlightInvalidData | boolean | Les données non valides sont surlignées. | +| iterativeCalculation | boolean | Active le calcul itératif. Voir sur [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative). | +| iterativeCalculationMaximumChange | numérique | Montant maximum de changement entre deux valeurs de calcul. | +| iterativeCalculationMaximumIterations | numérique | Nombre de fois maximum que la formule doit recalculer. | +| newTabVisible | boolean | Afficher un onglet spécial pour permettre aux utilisateurs d'insérer de nouvelles feuilles. | +| numbersFitMode | number | Modifie le mode d'affichage lorsque la largeur des données date/nombre est plus longue que la largeur des colonnes. Valeurs disponibles : vk
    ConstanteValeurDescription
    vk numbers fit mode mask0 Remplace le contenu des données par "###" et affiche l'astuce
    numbers fit mode overflow 1 Affiche le contenu des données sous forme de chaîne de caractères. Si la cellule suivante est vide, le contenu est débordé.
    | +| pasteSkipInvisibleRange | boolean | Coller ou ne pas coller les données dans les plages invisibles :
    • False (par défaut) : coller les données
    • True : Ne pas coller les données dans les plages invisibles
    Voir [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) pour plus d'informations sur les plages invisibles. | +| referenceStyle | number | Style pour les références de cellules et de plages dans les formules de cellules. Available values:
    ConstantValueDescription
    vk reference style A1 0 Use A1 style.
    vk reference style R1C1 1 Use R1C1 style
    | +| resizeZeroIndicator | number | Règle de dessin lorsque la ligne ou la colonne est redimensionnée à zéro. Available values:
    ConstantValueDescription
    vk resize zero indicator default 0 Uses the current drawing policy when the row or column is resized to zero.
    vk resize zero indicator enhanced 1 Draws two short lines when the row or column is resized to zero.
    | +| rowResizeMode | number | La façon dont les lignes sont redimensionnées. Les valeurs disponibles sont les mêmes que columnResizeMode | +| scrollbarAppearance | number | Apparence de la barre de défilement. Available values:
    ConstantValueDescription
    vk scrollbar appearance mobile1 Mobile scrollbar appearance.
    vk scrollbar appearance skin (default)0 Excel-like classic scrollbar appearance.
    | +| scrollbarMaxAlign | boolean | La barre de défilement s'aligne sur la dernière ligne et la dernière colonne de la feuille courante. | +| scrollbarShowMax | boolean | Les barres de défilement affichées sont basées sur le nombre total de colonnes et de lignes dans la feuille. | +| scrollByPixel | boolean | Activer le défilement de précision par pixel. | +| scrollIgnoreHidden | boolean | La barre de défilement ignore les lignes ou colonnes cachées. | +| scrollPixel | integer | Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Par exemple : le delta de défilement est de 3, scrollPixel est de 5, le défilement final de pixels est de 15. | +| showDragDropTip | boolean | Afficher l'info bulle de glisser-déposer. | +| showDragFillSmartTag | boolean | Afficher la boîte de dialogue de remplissage par glisser-déplacer. | +| showDragFillTip | boolean | Afficher l'info bulle de glisser-remplir. | +| showHorizontalScrollbar | boolean | Afficher la barre de défilement horizontale. | +| showResizeTip | number | Comment afficher l'info-bulle de redimensionnement. Available values:
    ConstantValueDescription
    vk show resize tip both 3 Horizontal and vertical resize tips are displayed.
    vk show resize tip column 1 Only the horizontal resize tip is displayed.
    vk show resize tip none 0 No resize tip is displayed.
    vk show resize tip row 2 Only the vertical resize tip is displayed.
    | +| showScrollTip | number | Comment afficher les info-bulles de défilement. Available values:
    ConstantValueDescription
    vk show scroll tip both 3 Horizontal and vertical scroll tips are displayed.
    vk show scroll tip horizontal 1 Only the horizontal scroll tip is displayed.
    vk show scroll tip none No scroll tip is displayed.
    vk show scroll tip vertical 2 Only the vertical scroll tip is displayed.
    | +| showVerticalScrollbar | boolean | Afficher la barre de défilement verticale. | +| tabEditable | boolean | La barre d'onglets de la feuille peut être modifiée. | +| tabNavigationVisible | boolean | Afficher l'onglet de navigation de la feuille. | +| tabStripPosition | number | Position de la barre d'onglets. Available values:
    ConstantValueDescription
    vk tab strip position bottom 0 Tab strip position is relative to the bottom of the workbook.
    vk tab strip position left 2 Tab strip position is relative to the left of the workbook.
    vk tab strip position right 3 Tab strip position is relative to the right of the workbook.
    vk tab strip position top 1 Tab strip position is relative to the top of the workbook.
    | +| tabStripRatio | number | Valeur de pourcentage (0.x) qui spécifie combien d'espace horizontal sera alloué à la barre d'onglets. Le reste de la zone horizontale (1 - 0.x) sera alloué à la barre de défilement horizontale. | +| tabStripVisible | boolean | Afficher la barre d'onglets de la feuille. | +| tabStripWidth | number | Largeur de la barre d'onglets lorsque la position est à gauche ou à droite. Par défaut et minimum 80. | +| useTouchLayout | boolean | Utiliser ou non le format tactile pour présenter le composant Spread. | ## Exemple From 640e7685e52a0ef601636134e9f5bb5378ef73e6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:30 +0200 Subject: [PATCH 080/201] New translations vp-set-workbook-options.md (Spanish) --- .../commands/vp-set-workbook-options.md | 120 +++++++++--------- 1 file changed, 60 insertions(+), 60 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md index 5fa478c3200126..ecbe60ce95a598 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md @@ -29,66 +29,66 @@ Las opciones modificadas del libro de trabajo se guardan con el documento. En la siguiente tabla se listan las opciones de libros de trabajo disponibles: -| Propiedad | Tipo | Descripción | -| ------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| allowUserDragMerge | boolean | Se permite la operación de fusión por arrastre (seleccionar celdas y arrastrar la selección para fusionar celdas) | -| allowAutoCreateHyperlink | boolean | Permite la creación automática de hipervínculos en la hoja de cálculo. | -| allowContextMenu | boolean | Se puede abrir el menú contextual integrado. | -| allowCopyPasteExcelStyle | boolean | Los estilos de una hoja de cálculo pueden copiarse y pegarse en Excel, y viceversa. | -| allowDynamicArray | boolean | Permite arrays dinámicos en hojas de cálculo | -| allowExtendPasteRange | boolean | Amplía el rango pegado si éste no es suficiente para los datos pegados | -| allowSheetReorder | boolean | Se permite reordenar la hoja | -| allowUndo | boolean | Deshacer ediciones está permitido. | -| allowUserDeselect | boolean | Se permite desmarcar celdas específicas de una selección. | -| allowUserDragDrop | boolean | Se permite arrastrar y soltar los datos del rango | -| allowUserDragFill | boolean | Se permite el relleno por arrastre | -| allowUserEditFormula | boolean | Las fórmulas pueden introducirse en las celdas | -| allowUserResize | boolean | Columnas y filas redimensionables | -| allowUserZoom | boolean | Se permite hacer zoom (ctrl + rueda del ratón) | -| autoFitType | number | El contenido se formatea para que se ajuste en las celdas, o en las celdas y los encabezados. Valores disponibles:
    ConstanteValorDescripción
    vk auto fit type cell 0 El contenido se ajusta automáticamente a las celdas
    vk auto fit type cell with header 1 El contenido se ajusta automáticamente a las celdas y encabezados
    | -| backColor | string | Una cadena de color utilizada para representar el color de fondo del área, como "red", "#FFFF00", "rgb(255,0,0)", "Acento 5". El color de fondo inicial se oculta cuando se define una backgroundImage. | -| backgroundImage | string / picture / file | Imagen de fondo para el área. | -| backgroundImageLayout | number | Cómo se muestra la imagen de fondo. Valores disponibles:
    ConstanteValorDescripción
    vk image layout center 1 En el centro del área.
    vk image layout none 3 En la esquina superior izquierda del área con su tamaño original.
    vk image layout stretch 0 Rellena el área.
    vk image layout zoom 2 Se muestra con su relación de aspecto original.
    | -| calcOnDemand | boolean | Las fórmulas se calculan sólo cuando se piden. | -| columnResizeMode | number | Redimensiona modo para columnas. Valores disponibles:
    ConstanteValorDescripción
    vk resize mode normal 0 Utiliza el modo de redimensionamiento normal (es decir, las columnas restantes se ven afectadas)
    vk resize mode split 1 Utiliza el modo dividido (es decir, las columnas restantes no se ven afectadas)
    | -| copyPasteHeaderOptions | number | Encabezados para incluir cuando se copian o pegan datos. Valores disponibles:
    ConstanteValorDescripción
    vk copy paste header options all headers3 Incluye los encabezados seleccionados cuando se copian los datos; sobrescribe los encabezados seleccionados cuando se pegan los datos.
    vk copy paste header options column headers 2 Incluye los encabezados de columna seleccionados cuando se copian los datos; sobrescribe los encabezados de columna seleccionados cuando se pegan los datos.
    vk copy paste header options no headers0 No incluye los encabezados de columna y fila al copiar los datos; no sobrescribe los encabezados de columna o fila seleccionadas al pegar los datos.
    vk copy paste header options row headers1 Incluye los encabezados de fila seleccionados cuando se copian los datos; sobrescribe los encabezados de fila seleccionados cuando se pegan los datos.
    | -| customList | collection | La lista para que los usuarios personalicen el relleno de arrastre, dar prioridad a que coincida con esta lista en cada relleno. Cada elemento de colección es una colección de cadenas. Vet en [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists). | -| cutCopyIndicatorBorderColor | string | Color del borde del indicador que aparece cuando el usuario corta o copia la selección. | -| cutCopyIndicatorVisible | boolean | Muestra un indicador al copiar o cortar el elemento seleccionado. | -| defaultDragFillType | number | El tipo de relleno de arrastre por defecto. Valores disponibles :
    ConstanteValorDescripción
    vk auto fill type auto 5 Rellena automáticamente las celdas.
    vk auto fill type clear values 4 Borra los valores de las celdas.
    vk auto fill type copycells 0 Rellena las celdas con todos los objetos de datos, incluyendo valores, formato y fórmulas.
    vk auto fill type fill formatting only 2 Rellena las celdas sólo con formato.
    vk auto fill type fill series 1 Rellena las celdas con series.
    vk auto fill type fill without formatting 3 Rellena las celdas con valores y no con formato.
    | -| enableAccessibility | boolean | El soporte de accesibilidad está activado en la hoja de cálculo. | -| enableFormulaTextbox | boolean | Se activa la caja de texto de la fórmula. | -| grayAreaBackColor | string | Una cadena color utilizada para representar el color de fondo del área gris, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | -| highlightInvalidData | boolean | Los datos inválidos son resaltados. | -| iterativeCalculation | boolean | Activa el cálculo iterativo. Vet en [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative). | -| iterativeCalculationMaximumChange | numeric | Cantidad máxima de cambio entre dos valores de cálculo. | -| iterativeCalculationMaximumIterations | numeric | Número de veces que la fórmula debe recalcular. | -| newTabVisible | boolean | Mostrar una pestaña especial para permitir a los usuarios insertar nuevas hojas. | -| numbersFitMode | number | Cambia el modo de visualización cuando el ancho de los datos de fecha/número es mayor que el ancho de la columna. Valores disponibles:
    ConstanteValorDescripción
    vk numbers fit mode mask0 Sustituye el contenido de los datos por "###" y muestra la punta
    vk numbers fit mode overflow 1 Muestra el contenido de los datos como una cadena. Si la siguiente celda está vacía, se desborda el contenido.
    | -| pasteSkipInvisibleRange | boolean | Pegar u omitir el pegado de datos en rangos invisibles:
    • False (por defecto): pegar datos
    • True: omitir el pegado en rangos invisibles
    Ver [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) para más información sobre rangos invisibles. | -| referenceStyle | number | Estilo para referencias de celdas y rangos en fórmulas de celdas. Valores disponibles:
    ConstanteValorDescripción
    vk reference style A1 0 Utiliza el estilo A1.
    vk reference style R1C1 1 Utiliza el estilo R1C1
    | -| resizeZeroIndicator | number | Política de dibujo cuando las líneas o columnas se redimensionan a 0. Valores disponibles:
    ConstanteValorDescripción
    vk resize zero indicator default 0 Utiliza la política de dibujo actual cuando la fila o columna se redimensiona a cero.
    vk resize zero indicator enhanced 1 Dibuja dos líneas cortas cuando la fila o columna se redimensiona a cero.
    | -| rowResizeMode | number | La forma en que se redimensionan las líneas. Los valores disponibles son los mismos qe columnResizeMode | -| scrollbarAppearance | number | Apariencia de la barra de desplazamiento. Valores disponibles:
    ConstanteValorDescripción
    vk scrollbar appearance mobile1 Aspecto de la barra de desplazamiento móvil.
    vk scrollbar appearance skin (por defecto)0 Aspecto clásico de la barra de desplazamiento.
    | -| scrollbarMaxAlign | boolean | La barra de desplazamiento se alinea con la última línea y columna de la hoja activa. | -| scrollbarShowMax | boolean | Las barras de desplazamiento mostradas se basan en el número total de columnas y líneas de la hoja. | -| scrollByPixel | boolean | Activar desplazamiento de precisión por píxel. | -| scrollIgnoreHidden | boolean | La barra de desplazamiento ignora líneas o columnas ocultas. | -| scrollPixel | integer | Decide el desplazamiento por ese número de píxeles cuando scrollByPixel es true. Los píxeles finales de desplazamiento son el resultado de `scrolling delta * scrollPixel`. Por ejemplo: delta de desplazamiento es 3, scrollPixel es 5, los píxeles finales de desplazamiento son 15. | -| showDragDropTip | boolean | Mostrar la punta de arrastrar y soltar. | -| showDragFillSmartTag | boolean | Mostrar el diálogo de arrastrar y rellenar. | -| showDragFillTip | boolean | Mostrar la punta de arrastrar y soltar. | -| showHorizontalScrollbar | boolean | Mostrar la barra de desplazamiento horizontal. | -| showResizeTip | number | Cómo mostrar el tip de redimensionamiento. Valores disponibles:
    ConstanteValorDescripción
    vk show resize tip both 3 Se muestran los consejos de redimensionamiento horizontal y vertical.
    vk show resize tip column 1 Sólo se muestra el consejo de redimensionamiento horizontal.
    vk show resize tip none 0 No se muestra ningún consejo de redimensionamiento.
    vk show resize tip row 2 Sólo se muestra el consejo de redimensionamiento vertical.
    | -| showScrollTip | number | Cómo mostrar el tip de desplazamiento. Valores disponibles:
    ConstanteValorDescripción
    vk show scroll tip both 3 Se muestran los consejos de desplazamiento horizontal y vertical.
    vk show scroll tip horizontal 1 Sólo se muestra el consejo de desplazamiento horizontal.
    vk show scroll tip none No se muestra ninguna información de desplazamiento.
    vk show scroll tip vertical 2 Sólo se muestra la información de desplazamiento vertical.
    | -| showVerticalScrollbar | boolean | Mostrar la barra de desplazamiento vertical. | -| tabEditable | boolean | La pestaña de la hoja se puede editar. | -| tabNavigationVisible | boolean | Mostrar la navegación por pestañas. | -| tabStripPosition | number | Posición de la barra de pestañas. Valores disponibles:
    ConstanteValorDescripción
    vk tab strip position bottom 0 La posición del tabulador es relativa a la parte inferior del libro.
    vk tab strip position left 2 La posición de la barra es relativa a la izquierda del libro.
    vk tab strip position right 3 La posición de la barra es relativa a la derecha del libro.
    vk tab strip position top 1 La posición de la barra de pestañas es relativa a la parte superior del libro.
    | -| tabStripRatio | number | Valor porcentual (0,x) que especifica qué parte del espacio horizontal se asignará al tabulador. El resto del área horizontal (1 - 0.x) se asignará a la barra de desplazamiento horizontal. | -| tabStripVisible | boolean | Mostrar la barra de pestañas de la hoja. | -| tabStripWidth | number | Ancho de la etiqueta cuando la posición es izquierda o derecha. Por defecto y el mínimo es 80. | -| useTouchLayout | boolean | Si se va a utilizar el diseño táctil para presentar el componente Spread. | +| Propiedad | Tipo | Descripción | +| ------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| allowUserDragMerge | boolean | Se permite la operación de fusión por arrastre (seleccionar celdas y arrastrar la selección para fusionar celdas) | +| allowAutoCreateHyperlink | boolean | Permite la creación automática de hipervínculos en la hoja de cálculo. | +| allowContextMenu | boolean | Se puede abrir el menú contextual integrado. | +| allowCopyPasteExcelStyle | boolean | Los estilos de una hoja de cálculo pueden copiarse y pegarse en Excel, y viceversa. | +| allowDynamicArray | boolean | Permite arrays dinámicos en hojas de cálculo | +| allowExtendPasteRange | boolean | Amplía el rango pegado si éste no es suficiente para los datos pegados | +| allowSheetReorder | boolean | Se permite reordenar la hoja | +| allowUndo | boolean | Deshacer ediciones está permitido. | +| allowUserDeselect | boolean | Se permite desmarcar celdas específicas de una selección. | +| allowUserDragDrop | boolean | Se permite arrastrar y soltar los datos del rango | +| allowUserDragFill | boolean | Se permite el relleno por arrastre | +| allowUserEditFormula | boolean | Las fórmulas pueden introducirse en las celdas | +| allowUserResize | boolean | Columnas y filas redimensionables | +| allowUserZoom | boolean | Se permite hacer zoom (ctrl + rueda del ratón) | +| autoFitType | number | El contenido se formatea para que se ajuste en las celdas, o en las celdas y los encabezados. Valores disponibles:
    ConstanteValorDescripción
    vk auto fit type cell 0 El contenido se ajusta automáticamente a las celdas
    vk auto fit type cell with header 1 El contenido se ajusta automáticamente a las celdas y encabezados
    | +| backColor | string | Una cadena de color utilizada para representar el color de fondo del área, como "red", "#FFFF00", "rgb(255,0,0)", "Acento 5". El color de fondo inicial se oculta cuando se define una backgroundImage. | +| backgroundImage | string / picture / file | Imagen de fondo para el área. | +| backgroundImageLayout | number | Cómo se muestra la imagen de fondo. Available values:
    ConstantValueDescription
    vk image layout center 1 In the center of the area.
    vk image layout none 3 In the upper left corner of the area with its original size.
    vk image layout stretch 0 Fills the area.
    vk image layout zoom 2 Displayed with its original aspect ratio.
    | +| calcOnDemand | boolean | Las fórmulas se calculan sólo cuando se piden. | +| columnResizeMode | number | Redimensiona modo para columnas. Valores disponibles:
    ConstanteValorDescripción
    vk resize mode normal 0 Utiliza el modo de redimensionamiento normal (es decir, las columnas restantes se ven afectadas)
    vk resize mode split 1 Utiliza el modo dividido (es decir, las columnas restantes no se ven afectadas)
    | +| copyPasteHeaderOptions | number | Encabezados para incluir cuando se copian o pegan datos. Available values:
    ConstantValueDescription
    vk copy paste header options all headers3 Includes selected headers when data is copied; overwrites selected headers when data is pasted.
    vk copy paste header options column headers 2 Includes selected column headers when data is copied; overwrites selected column headers when data is pasted.
    vk copy paste header options no headers0 Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted.
    vk copy paste header options row headers1 Includes selected row headers when data is copied; overwrites selected row headers when data is pasted.
    | +| customList | collection | La lista para que los usuarios personalicen el relleno de arrastre, dar prioridad a que coincida con esta lista en cada relleno. Cada elemento de colección es una colección de cadenas. Vet en [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists). | +| cutCopyIndicatorBorderColor | string | Color del borde del indicador que aparece cuando el usuario corta o copia la selección. | +| cutCopyIndicatorVisible | boolean | Muestra un indicador al copiar o cortar el elemento seleccionado. | +| defaultDragFillType | number | El tipo de relleno de arrastre por defecto. Valores disponibles :
    ConstanteValorDescripción
    vk auto fill type auto 5 Rellena automáticamente las celdas.
    vk auto fill type clear values 4 Clears cell values.
    vk auto fill type copycells 0 Fills cells with all data objects, including values, formatting, and formulas.
    vk auto fill type fill formatting only 2 Fills cells only with formatting.
    vk auto fill type fill series 1 Fills cells with series.
    vk auto fill type fill without formatting 3 Rellena las celdas con valores y no con formato.
    | +| enableAccessibility | boolean | El soporte de accesibilidad está activado en la hoja de cálculo. | +| enableFormulaTextbox | boolean | Se activa la caja de texto de la fórmula. | +| grayAreaBackColor | string | Una cadena color utilizada para representar el color de fondo del área gris, como "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | +| highlightInvalidData | boolean | Los datos inválidos son resaltados. | +| iterativeCalculation | boolean | Activa el cálculo iterativo. Vet en [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative). | +| iterativeCalculationMaximumChange | numeric | Cantidad máxima de cambio entre dos valores de cálculo. | +| iterativeCalculationMaximumIterations | numeric | Número de veces que la fórmula debe recalcular. | +| newTabVisible | boolean | Mostrar una pestaña especial para permitir a los usuarios insertar nuevas hojas. | +| numbersFitMode | number | Cambia el modo de visualización cuando el ancho de los datos de fecha/número es mayor que el ancho de la columna. Valores disponibles:
    ConstanteValorDescripción
    vk numbers fit mode mask0 Sustituye el contenido de los datos por "###" y muestra la punta
    vk numbers fit mode overflow 1 Muestra el contenido de los datos como una cadena. Si la siguiente celda está vacía, se desborda el contenido.
    | +| pasteSkipInvisibleRange | boolean | Pegar u omitir el pegado de datos en rangos invisibles:
    • False (por defecto): pegar datos
    • True: omitir el pegado en rangos invisibles
    Ver [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) para más información sobre rangos invisibles. | +| referenceStyle | number | Estilo para referencias de celdas y rangos en fórmulas de celdas. Available values:
    ConstantValueDescription
    vk reference style A1 0 Use A1 style.
    vk reference style R1C1 1 Use R1C1 style
    | +| resizeZeroIndicator | number | Política de dibujo cuando las líneas o columnas se redimensionan a 0. Available values:
    ConstantValueDescription
    vk resize zero indicator default 0 Uses the current drawing policy when the row or column is resized to zero.
    vk resize zero indicator enhanced 1 Draws two short lines when the row or column is resized to zero.
    | +| rowResizeMode | number | La forma en que se redimensionan las líneas. Los valores disponibles son los mismos qe columnResizeMode | +| scrollbarAppearance | number | Apariencia de la barra de desplazamiento. Available values:
    ConstantValueDescription
    vk scrollbar appearance mobile1 Mobile scrollbar appearance.
    vk scrollbar appearance skin (default)0 Excel-like classic scrollbar appearance.
    | +| scrollbarMaxAlign | boolean | La barra de desplazamiento se alinea con la última línea y columna de la hoja activa. | +| scrollbarShowMax | boolean | Las barras de desplazamiento mostradas se basan en el número total de columnas y líneas de la hoja. | +| scrollByPixel | boolean | Activar desplazamiento de precisión por píxel. | +| scrollIgnoreHidden | boolean | La barra de desplazamiento ignora líneas o columnas ocultas. | +| scrollPixel | integer | Decide el desplazamiento por ese número de píxeles cuando scrollByPixel es true. Los píxeles finales de desplazamiento son el resultado de `scrolling delta * scrollPixel`. Por ejemplo: delta de desplazamiento es 3, scrollPixel es 5, los píxeles finales de desplazamiento son 15. | +| showDragDropTip | boolean | Mostrar la punta de arrastrar y soltar. | +| showDragFillSmartTag | boolean | Mostrar el diálogo de arrastrar y rellenar. | +| showDragFillTip | boolean | Mostrar la punta de arrastrar y soltar. | +| showHorizontalScrollbar | boolean | Mostrar la barra de desplazamiento horizontal. | +| showResizeTip | number | Cómo mostrar el tip de redimensionamiento. Available values:
    ConstantValueDescription
    vk show resize tip both 3 Horizontal and vertical resize tips are displayed.
    vk show resize tip column 1 Only the horizontal resize tip is displayed.
    vk show resize tip none 0 No resize tip is displayed.
    vk show resize tip row 2 Only the vertical resize tip is displayed.
    | +| showScrollTip | number | Cómo mostrar el tip de desplazamiento. Available values:
    ConstantValueDescription
    vk show scroll tip both 3 Horizontal and vertical scroll tips are displayed.
    vk show scroll tip horizontal 1 Only the horizontal scroll tip is displayed.
    vk show scroll tip none No scroll tip is displayed.
    vk show scroll tip vertical 2 Only the vertical scroll tip is displayed.
    | +| showVerticalScrollbar | boolean | Mostrar la barra de desplazamiento vertical. | +| tabEditable | boolean | La pestaña de la hoja se puede editar. | +| tabNavigationVisible | boolean | Mostrar la navegación por pestañas. | +| tabStripPosition | number | Posición de la barra de pestañas. Available values:
    ConstantValueDescription
    vk tab strip position bottom 0 Tab strip position is relative to the bottom of the workbook.
    vk tab strip position left 2 Tab strip position is relative to the left of the workbook.
    vk tab strip position right 3 Tab strip position is relative to the right of the workbook.
    vk tab strip position top 1 Tab strip position is relative to the top of the workbook.
    | +| tabStripRatio | number | Valor porcentual (0,x) que especifica qué parte del espacio horizontal se asignará al tabulador. El resto del área horizontal (1 - 0.x) se asignará a la barra de desplazamiento horizontal. | +| tabStripVisible | boolean | Mostrar la barra de pestañas de la hoja. | +| tabStripWidth | number | Ancho de la etiqueta cuando la posición es izquierda o derecha. Por defecto y el mínimo es 80. | +| useTouchLayout | boolean | Si se va a utilizar el diseño táctil para presentar el componente Spread. | ## Ejemplo From 2e8bab57f9df1dfda31aff92ca7ca573a67b4835 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:32 +0200 Subject: [PATCH 081/201] New translations vp-set-workbook-options.md (Japanese) --- .../commands/vp-set-workbook-options.md | 120 +++++++++--------- 1 file changed, 60 insertions(+), 60 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md index a8d88482966a5d..4ee5c786941f9d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md @@ -28,66 +28,66 @@ title: VP SET WORKBOOK OPTIONS 次の表は、利用可能なワークブックオプションの一覧です: -| プロパティ | 型 | 説明 | -| ------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| allowUserDragMerge | boolean | ドラッグ＆マージオプションを許可します (複数セルを選択し、選択をドラッグしてセルを結合します) | -| allowAutoCreateHyperlink | boolean | スプレッドシート内でハイパーリンクの自動作成を有効にします。 | -| allowContextMenu | boolean | ビルトインのコンテキストメニューの使用を許可します。 | -| allowCopyPasteExcelStyle | boolean | スプレッドシートのスタイルを Excel にコピー＆ペーストすることを許可します (逆も可)。 | -| allowDynamicArray | boolean | ワークシート内で動的配列を有効にします。 | -| allowExtendPasteRange | boolean | 貼り付けデータが貼り付け先の範囲に収まりきらない場合に、貼り付け先の範囲を拡張します。 | -| allowSheetReorder | boolean | シートの順序変更を許可します。 | -| allowUndo | boolean | 編集を元に戻す操作を許可します。 | -| allowUserDeselect | boolean | 選択範囲から特定のセルを除外することを許可します。 | -| allowUserDragDrop | boolean | レンジデータのドラッグ＆ドロップを許可します。 | -| allowUserDragFill | boolean | ドラッグ＆フィルを許可します。 | -| allowUserEditFormula | boolean | セルへのフォーミュラの入力を許可します。 | -| allowUserResize | boolean | カラムと行のリサイズを許可します。 | -| allowUserZoom | boolean | ズームを許可します (Ctrl + マウスホイール)。 | -| autoFitType | number | セル内やヘッダー内に収まるよう、内容をフォーマットします。 使用可能な値:
    定数値説明
    vk auto fit type cell 0 内容をセル内に収めます。
    vk auto fit type cell with header 1 内容をセル内・ヘッダー内に収めます。
    | -| backColor | string | エリアの背景色を表すカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5")。 backgroundImage を設定している場合、背景色は非表示になります。 | -| backgroundImage | string / picture / file | エリアの背景画像。 | -| backgroundImageLayout | number | 背景画像のレイアウト。 使用可能な値:
    定数値説明
    vk image layout center 1 エリアの中央に表示。
    vk image layout none 3 エリアの左上に元のサイズで表示。
    vk image layout stretch 0 エリアを埋めるように拡大表示。
    vk image layout zoom 2 アスペクト比を維持して表示。
    | -| calcOnDemand | boolean | 要求されたときのみフォーミュラを計算します。 | -| columnResizeMode | number | カラムのリサイズモード。 使用可能な値:
    定数値説明
    vk resize mode normal 0 通常のリサイズモード (残りのカラムに影響します)
    vk resize mode split 1 split モード (残りのカラムに影響しません)
    | -| copyPasteHeaderOptions | number | データのコピー/ペースト時に含めるヘッダーについて指定します。 使用可能な値:
    定数値説明
    vk copy paste header options all headers3 データのコピー時: 選択ヘッダーを含めます。データのペースト時: 選択ヘッダーを上書きします。
    vk copy paste header options column headers 2 データのコピー時: 選択されたカラムヘッダーを含めます。データのペースト時: 選択されたカラムヘッダーを上書きします。
    vk copy paste header options no headers0 データのコピー時: ヘッダーを含めません。データのペースト時: ヘッダーを上書きしません。
    vk copy paste header options row headers1 データのコピー時: 選択された行ヘッダーを含めます。データのペースト時: 選択された行ヘッダーを上書きします。
    | -| customList | collection | ドラッグ＆フィルをカスタマイズするためのリストです。フィルの際には、このリストに合致する値が入力されます。 各コレクション要素は、文字列のコレクションです。 [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists) 参照。 | -| cutCopyIndicatorBorderColor | string | ユーザーが選択をカットまたはコピーしたときの領域の境界色。 | -| cutCopyIndicatorVisible | boolean | コピーまたはカットされた際の領域を表示します。 | -| defaultDragFillType | number | デフォルトのドラッグ＆フィルタイプ。 使用可能な値 :
    定数値説明
    vk auto fill type auto 5 自動でセルをフィルします。
    vk auto fill type clear values 4 セルの値をクリアします。
    vk auto fill type copycells 0 値・フォーマット・フォーミュラを含むすべてのデータオブジェクトでセルをフィルします。
    vk auto fill type fill formatting only 2 フォーマットのみでセルをフィルします。
    vk auto fill type fill series 1 連続データでフィルします。
    vk auto fill type fill without formatting 3 値のみでセルをフィルします (フォーマットは除外)。
    | -| enableAccessibility | boolean | スプレッドシートにおけるアクセシビリティのサポートを有効にします。 | -| enableFormulaTextbox | boolean | フォーミュラテキストボックスを有効化します。 | -| grayAreaBackColor | string | グレー領域の背景色を表すカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5")。 | -| highlightInvalidData | boolean | 無効なデータをハイライト表示します。 | -| iterativeCalculation | boolean | 反復計算を有効にします。 [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative) 参照。 | -| iterativeCalculationMaximumChange | numeric | 2つの計算値の最大差。 | -| iterativeCalculationMaximumIterations | numeric | フォーミュラが反復計算される最大回数。 | -| newTabVisible | boolean | 新規シートを挿入するための特別なタブを表示します。 | -| numbersFitMode | number | 日付/数値データがカラム幅を超える場合の表示モード。 使用可能な値:
    定数値説明
    vk numbers fit mode mask0 データの中身を "###" で置き換え、Tipを表示します。
    vk numbers fit mode overflow 1 データの中身を文字列として表示します。 隣のセルが空であれば、はみ出して表示します。
    | -| pasteSkipInvisibleRange | boolean | 非表示のレンジへの貼り付けについて指定します。
    • False (デフォルト): データを貼り付けます。
    • True: 非表示のレンジはスキップします。
    非表示のレンジについての詳細は [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) を参照ください。 | -| referenceStyle | number | セルフォーミュラにおける、セルやレンジ参照のスタイル。 使用可能な値:
    定数値説明
    vk reference style A1 0 A1 スタイルを使用します。
    vk reference style R1C1 1 R1C1 スタイルを使用します。
    | -| resizeZeroIndicator | number | 行やカラムのサイズが 0 に変更されたときの描画ポリシー。 使用可能な値:
    定数値説明
    vk resize zero indicator default 0 行やカラムのサイズが 0 に変更されたときに、現在の描画ポリシーを使用します。
    vk resize zero indicator enhanced 1 行やカラムのサイズが 0 に変更されたときに、2本の短い線を描画します。
    | -| rowResizeMode | number | 行のリサイズモード。 使用可能な値は columnResizeMode と同じです。 | -| scrollbarAppearance | number | スクロールバーの見た目。 使用可能な値:
    定数値説明
    vk scrollbar appearance mobile1 モバイル風のスクロールバー。
    vk scrollbar appearance skin (デフォルト)0 Excel風のクラシックなスクロールバー。
    | -| scrollbarMaxAlign | boolean | スクロールバーをアクティブシートの最後の行およびカラムに揃えます。 | -| scrollbarShowMax | boolean | シートのカラムと行の総数に基づいてスクロールバーを表示します。 | -| scrollByPixel | boolean | ピクセル単位のスクロールを有効にします。 | -| scrollIgnoreHidden | boolean | スクロールバーは非表示の行やカラムを無視します。 | -| scrollPixel | integer | scrollByPixel が true の場合、スクロール毎のピクセル数を指定します。 最終的にスクロールするピクセル数は `scrolling delta (スクロールの相対変化値) * scrollPixel` によって算出されます。 例: scrolling delta が 3、scrollPixel が 5 の場合、最終的なスクロールピクセル数は 15 です。 | -| showDragDropTip | boolean | ドラッグ＆ドロップの Tip を表示します。 | -| showDragFillSmartTag | boolean | ドラッグ＆フィルダイアログを表示します。 | -| showDragFillTip | boolean | ドラッグ＆フィルの Tip を表示します。 | -| showHorizontalScrollbar | boolean | 横スクロールバーを表示します。 | -| showResizeTip | number | リサイズ Tip の表示を指定します。 使用可能な値:
    定数値説明
    vk show resize tip both 3 縦と横のリサイズ Tip が表示されます。
    vk show resize tip column 1 横のリサイズ Tip のみ表示されます。
    vk show resize tip none 0 リサイズ Tip は表示されません。
    vk show resize tip row 2 縦のリサイズ Tip のみ表示されます。
    | -| showScrollTip | number | スクロール Tip の表示を指定します。 使用可能な値:
    定数値説明
    vk show scroll tip both 3 縦と横のスクロール Tip が表示されます。
    vk show scroll tip horizontal 1 横のスクロール Tip のみ表示されます。
    vk show scroll tip none スクロール Tip は表示されません。
    vk show scroll tip vertical 2 縦のスクロール Tip のみ表示されます。
    | -| showVerticalScrollbar | boolean | 縦スクロールバーを表示します。 | -| tabEditable | boolean | タブストリップの編集を有効にします。 | -| tabNavigationVisible | boolean | タブナビゲーションを表示します。 | -| tabStripPosition | number | タブストリップの位置を指定します。 使用可能な値:
    定数値説明
    vk tab strip position bottom 0 タブストリップはワークブックの下側に位置します。
    vk tab strip position left 2 タブストリップはワークブックの左側に位置します。
    vk tab strip position right 3 タブストリップはワークブックの右側に位置します。
    vk tab strip position top 1 タブストリップはワークブックの上側に位置します。
    | -| tabStripRatio | number | スプレッドシートエリアの幅において、タブストリップが占める割合を指定します (0.x)。 残るスペース (1 - 0.x) には横スクロールバーが表示されます。 | -| tabStripVisible | boolean | タブストリップを表示します。 | -| tabStripWidth | number | タブストリップの位置が左側/右側の場合に、その幅を指定します。 デフォルト値は最小値の 80 です。 | -| useTouchLayout | boolean | Spreadコンポーネントを提示するのにタッチレイアウトを使用するかどうかを指定します。 | +| プロパティ | 型 | 説明 | +| ------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| allowUserDragMerge | boolean | ドラッグ＆マージオプションを許可します (複数セルを選択し、選択をドラッグしてセルを結合します) | +| allowAutoCreateHyperlink | boolean | スプレッドシート内でハイパーリンクの自動作成を有効にします。 | +| allowContextMenu | boolean | ビルトインのコンテキストメニューの使用を許可します。 | +| allowCopyPasteExcelStyle | boolean | スプレッドシートのスタイルを Excel にコピー＆ペーストすることを許可します (逆も可)。 | +| allowDynamicArray | boolean | ワークシート内で動的配列を有効にします。 | +| allowExtendPasteRange | boolean | 貼り付けデータが貼り付け先の範囲に収まりきらない場合に、貼り付け先の範囲を拡張します。 | +| allowSheetReorder | boolean | シートの順序変更を許可します。 | +| allowUndo | boolean | 編集を元に戻す操作を許可します。 | +| allowUserDeselect | boolean | 選択範囲から特定のセルを除外することを許可します。 | +| allowUserDragDrop | boolean | レンジデータのドラッグ＆ドロップを許可します。 | +| allowUserDragFill | boolean | ドラッグ＆フィルを許可します。 | +| allowUserEditFormula | boolean | セルへのフォーミュラの入力を許可します。 | +| allowUserResize | boolean | カラムと行のリサイズを許可します。 | +| allowUserZoom | boolean | ズームを許可します (Ctrl + マウスホイール)。 | +| autoFitType | number | セル内やヘッダー内に収まるよう、内容をフォーマットします。 使用可能な値:
    定数値説明
    vk auto fit type cell 0 内容をセル内に収めます。
    vk auto fit type cell with header 1 内容をセル内・ヘッダー内に収めます。
    | +| backColor | string | エリアの背景色を表すカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5")。 backgroundImage を設定している場合、背景色は非表示になります。 | +| backgroundImage | string / picture / file | エリアの背景画像。 | +| backgroundImageLayout | number | 背景画像のレイアウト。 利用可能な値:
    定数値詳細
    vk image layout center 1エリアの中心に配置。
    vk image layout none 3エリアの左上端にオリジナルのサイズで配置。
    vk image layout stretch 0エリアを埋めるように配置。
    vk image layout zoom 2元々のアスペクト比で表示。
    | +| calcOnDemand | boolean | 要求されたときのみフォーミュラを計算します。 | +| columnResizeMode | number | カラムのリサイズモード。 使用可能な値:
    定数値説明
    vk resize mode normal 0 通常のリサイズモード (残りのカラムに影響します)
    vk resize mode split 1 split モード (残りのカラムに影響しません)
    | +| copyPasteHeaderOptions | number | データのコピー/ペースト時に含めるヘッダーについて指定します。 利用可能な値:
    定数値詳細
    vk copy paste header options all headers3データがコピーされる際に選択されたヘッダーを含み、データがペーストされるときに選択されたヘッダーを上書きする。
    vk copy paste header options column headers 2データがコピーされる際に選択されたカラムヘッダーを含み、データがペーストされるときに選択されたカラムヘッダを上書きする。
    vk copy paste header options no headers0データがコピーされる際にカラム及び行ヘッダーは含まれず、データがペーストされるときにカラムおよび行ヘッダーは上書きされません。
    vk copy paste header options row headers1データがコピーされる際に選択された行ヘッダーを含み、データがペーストされる際に選択された行ヘッダーを上書きします。
    | +| customList | collection | ドラッグ＆フィルをカスタマイズするためのリストです。フィルの際には、このリストに合致する値が入力されます。 各コレクション要素は、文字列のコレクションです。 [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/features/cells/AutoFillData/AutoFillLists) 参照。 | +| cutCopyIndicatorBorderColor | string | ユーザーが選択をカットまたはコピーしたときの領域の境界色。 | +| cutCopyIndicatorVisible | boolean | コピーまたはカットされた際の領域を表示します。 | +| defaultDragFillType | number | デフォルトのドラッグ＆フィルタイプ。 使用可能な値 :
    定数値説明
    vk auto fill type auto 5 自動でセルをフィルします。
    vk auto fill type clear values 4セルの値をクリアします。
    vk auto fill type copycells 0値、書式、数式を含め、全てのデータオブジェクトでセルを埋めます。
    vk auto fill type fill formatting only 2書式のみをセルにフィルします。
    vk auto fill type fill series 1 セルを系列で埋めます。
    vk auto fill type fill without formatting 3 値のみでセルをフィルします (フォーマットは除外)。
    | +| enableAccessibility | boolean | スプレッドシートにおけるアクセシビリティのサポートを有効にします。 | +| enableFormulaTextbox | boolean | フォーミュラテキストボックスを有効化します。 | +| grayAreaBackColor | string | グレー領域の背景色を表すカラー文字列 (例: "red"、"#FFFF00"、"rgb(255,0,0)"、"Accent 5")。 | +| highlightInvalidData | boolean | 無効なデータをハイライト表示します。 | +| iterativeCalculation | boolean | 反復計算を有効にします。 [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/formulareference/formulaoverview/calculating-iterative) 参照。 | +| iterativeCalculationMaximumChange | numeric | 2つの計算値の最大差。 | +| iterativeCalculationMaximumIterations | numeric | フォーミュラが反復計算される最大回数。 | +| newTabVisible | boolean | 新規シートを挿入するための特別なタブを表示します。 | +| numbersFitMode | number | 日付/数値データがカラム幅を超える場合の表示モード。 使用可能な値:
    定数値説明
    vk numbers fit mode mask0 データの中身を "###" で置き換え、Tipを表示します。
    vk numbers fit mode overflow 1 データの中身を文字列として表示します。 隣のセルが空であれば、はみ出して表示します。
    | +| pasteSkipInvisibleRange | boolean | 非表示のレンジへの貼り付けについて指定します。
    • False (デフォルト): データを貼り付けます。
    • True: 非表示のレンジはスキップします。
    非表示のレンジについての詳細は [SpreadJS のドキュメント](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) を参照ください。 | +| referenceStyle | number | セルフォーミュラにおける、セルやレンジ参照のスタイル。 利用可能な値:
    定数値詳細
    vk reference style A1 0A1 スタイルを使用。
    vk reference style R1C1 1R1C1 スタイルを使用。
    | +| resizeZeroIndicator | number | 行やカラムのサイズが 0 に変更されたときの描画ポリシー。 利用可能な値:
    定数値詳細
    vk resize zero indicator default 0行またはカラムがゼロにリサイズされた際には現在の描画ポリシーを使用します。
    vk resize zero indicator enhanced 1行またはカラムがゼロにリサイズされた際には2本の短い線を描画します。
    | +| rowResizeMode | number | 行のリサイズモード。 使用可能な値は columnResizeMode と同じです。 | +| scrollbarAppearance | number | スクロールバーの見た目。 利用可能な値:
    定数値詳細
    vk scrollbar appearance mobile1 モバイルのスクロールバーの見た目。
    vk scrollbar appearance skin (デフォルト)0Excel 風のクラシックなスクロールバーの見た目。
    | +| scrollbarMaxAlign | boolean | スクロールバーをアクティブシートの最後の行およびカラムに揃えます。 | +| scrollbarShowMax | boolean | シートのカラムと行の総数に基づいてスクロールバーを表示します。 | +| scrollByPixel | boolean | ピクセル単位のスクロールを有効にします。 | +| scrollIgnoreHidden | boolean | スクロールバーは非表示の行やカラムを無視します。 | +| scrollPixel | integer | scrollByPixel が true の場合、スクロール毎のピクセル数を指定します。 最終的にスクロールするピクセル数は `scrolling delta (スクロールの相対変化値) * scrollPixel` によって算出されます。 例: scrolling delta が 3、scrollPixel が 5 の場合、最終的なスクロールピクセル数は 15 です。 | +| showDragDropTip | boolean | ドラッグ＆ドロップの Tip を表示します。 | +| showDragFillSmartTag | boolean | ドラッグ＆フィルダイアログを表示します。 | +| showDragFillTip | boolean | ドラッグ＆フィルの Tip を表示します。 | +| showHorizontalScrollbar | boolean | 横スクロールバーを表示します。 | +| showResizeTip | number | リサイズ Tip の表示を指定します。 利用可能な値:
    定数値詳細
    vk show resize tip both 3水平方向と垂直方向のリサイズTips が表示されます。
    vk show resize tip column 1水平方向のリサイズ Tips のみ表示されます。
    vk show resize tip none 0リサイズTips は表示されません。
    vk show resize tip row 2垂直方向のリサイズTips のみ表示されます。
    | +| showScrollTip | number | スクロール Tip の表示を指定します。 利用可能な値:
    定数値詳細
    vk show scroll tip both 3水平方向と垂直方向のスクロールTips が表示されます。
    vk show scroll tip horizontal 1水平方向のスクロールTips のみが表示されます。
    vk show scroll tip none スクロールTips は表示されません。
    vk show scroll tip vertical 2垂直方向のスクロールTips のみが表示されます。
    | +| showVerticalScrollbar | boolean | 縦スクロールバーを表示します。 | +| tabEditable | boolean | タブストリップの編集を有効にします。 | +| tabNavigationVisible | boolean | タブナビゲーションを表示します。 | +| tabStripPosition | number | タブストリップの位置を指定します。 利用可能な値:
    定数値詳細
    vk tab strip position bottom 0タブストリップの位置は、ワークブックの下に対しての相対位置となります。
    vk tab strip position left 2タブストリップの位置は、ワークブックの左に対しての相対位置となります。
    vk tab strip position right 3タブストリップの位置は、ワークブックの右に対しての相対位置となります。
    vk tab strip position top 1タブストリップの一は、ワークブックの上に対しての相対位置となります。
    | +| tabStripRatio | number | スプレッドシートエリアの幅において、タブストリップが占める割合を指定します (0.x)。 残るスペース (1 - 0.x) には横スクロールバーが表示されます。 | +| tabStripVisible | boolean | タブストリップを表示します。 | +| tabStripWidth | number | タブストリップの位置が左側/右側の場合に、その幅を指定します。 デフォルト値は最小値の 80 です。 | +| useTouchLayout | boolean | Spreadコンポーネントを提示するのにタッチレイアウトを使用するかどうかを指定します。 | ## 例題 From f22275693ed351287e72dcfb8ebbdfaac8d69291 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:35 +0200 Subject: [PATCH 082/201] New translations vp-set-workbook-options.md (Portuguese, Brazilian) --- .../version-21/ViewPro/commands/vp-set-workbook-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md index 65c8d2a7a3aa81..11f9f624e61105 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-workbook-options.md @@ -66,7 +66,7 @@ A tabela seguinte lista as opções de libro disponíveis: | newTabVisible | boolean | Apresentar um separador especial para permitir que os usuários insiram novas folhas. | | numbersFitMode | number | Muda o modo de exibição quando a largura de dados/data é maior que a largura da coluna. Available values:
    ConstantValueDescription
    vk numbers fit mode mask0 Replace data content with "###" and shows tip
    vk numbers fit mode overflow 1 Display data content as a string. If next cell is empty, overflow the content.
    | | pasteSkipInvisibleRange | boolean | Paste or skip pasting data in invisible ranges:
    • False (default): paste data
    • True: Skip pasting in invisible ranges
    See [SpreadJS docs](https://developer.mescius.com/spreadjs/docs/features/rows-columns/paste-skip-data-invisible-range) for more information on invisible ranges. | -| referenceStyle | number | Estilo para referências de células e intervalos em fórmulas de células. Valores disponíveis:
    ConstanteValorDescrição
    vk reference style A1 0Usar o estilo A1.
    vk reference style R1C1 1Usar o estilo R1C1
    | +| referenceStyle | number | Estilo para referências de células e intervalos em fórmulas de células. Available values:
    ConstantValueDescription
    vk reference style A1 0 Use A1 style.
    vk reference style R1C1 1 Use R1C1 style
    | | resizeZeroIndicator | number | Política de desenho quando a linha ou coluna é redimensionada para zero. Available values:
    ConstantValueDescription
    vk resize zero indicator default 0 Uses the current drawing policy when the row or column is resized to zero.
    vk resize zero indicator enhanced 1 Draws two short lines when the row or column is resized to zero.
    | | rowResizeMode | number | A forma como as linhas são redimensionadas. Os valores disponíveis são os mesmos que columnResizeMode | | scrollbarAppearance | number | Aspeto da barra de deslocação. Available values:
    ConstantValueDescription
    vk scrollbar appearance mobile1 Mobile scrollbar appearance.
    vk scrollbar appearance skin (default)0 Excel-like classic scrollbar appearance.
    | From 8c8bc9ecf3e80ade82caf2cf7b1bf45ac6d5fe02 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:48 +0200 Subject: [PATCH 083/201] New translations configuring.md (French) --- .../version-21/ViewPro/configuring.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md index 6da02526026bd4..5cdbaa95105016 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md @@ -332,16 +332,16 @@ Les attributs d'orientation sont utilisés pour spécifier la direction de la mi Les attributs de page sont utilisés pour spécifier les paramètres généraux d'impression du document. -| Propriété | Type | Description | -| --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| blackAndWhite | boolean | Impression en noir et blanc seulement.

    Valeur par défaut = false

    **Note**: Les PDF ne sont pas affectés par cet attribut. Les couleurs en PDF restent.

    | -| centering | entier long | Comment le contenu est centré sur la page imprimée. Valeurs disponibles : `vk print centering both`, `vk print centering horizontal`, `vk print centering none` (par défaut), `vk print centering vertical` | -| firstPageNumber | entier long | Le numéro de page à imprimer sur la première page. Valeur par défaut = 1 | -| pageOrder | entier long | L'ordre d'impression des pages. Valeurs disponibles : `vk print page order auto` (par défaut), `vk print page order down then over`, `vk print page order over then down`. | -| pageRange | text | La plage de pages pour l'impression | -| qualityFactor | entier long | Le facteur de qualité pour l'impression (1 - 8). Plus le facteur de qualité est élevé, meilleure est la qualité d'impression, cependant les performances d'impression peuvent être affectées.

    Valeur par défaut = 2

    | -| useMax | boolean | Seules les colonnes et les lignes avec des données sont imprimées.

    Valeur par défaut = true

    | -| zoomFactor | réel | Le montant de l'agrandissement ou de la réduction de la page imprimée.

    Valeur par défaut = 1

    | +| Propriété | Type | Description | +| --------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| blackAndWhite | boolean | Impression en noir et blanc seulement.

    Valeur par défaut = false

    **Note**: Les PDF ne sont pas affectés par cet attribut. Les couleurs en PDF restent.

    | +| centering | entier long | Comment le contenu est centré sur la page imprimée. Valeurs disponibles : `vk print centering both`, `vk print centering horizontal`, `vk print centering none` (par défaut), `vk print centering vertical` | +| firstPageNumber | entier long | Le numéro de page à imprimer sur la première page. Valeur par défaut = 1 | +| pageOrder | entier long | L'ordre d'impression des pages. Valeurs disponibles : `vk print page order auto` (par défaut), `vk print page order down then over`, `vk print page order over then down`. | +| pageRange | text | La plage de pages pour l'impression | +| qualityFactor | entier long | Le facteur de qualité pour l'impression (1 - 8). The higher the quality factor, the better the printing quality, however printing performance may be affected.

    Default value = 2

    | +| useMax | boolean | Only columns and rows with data are printed.

    Default value = true

    | +| zoomFactor | réel | The amount to enlarge or reduce the printed page.

    Default value = 1

    | ### Taille du papier From 45c372a126073792905e5dcfe2c40786492052f0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:24:51 +0200 Subject: [PATCH 084/201] New translations configuring.md (Spanish) --- .../version-21/ViewPro/configuring.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md index 6479ca5a5168dc..7d22996a114d4a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md @@ -332,16 +332,16 @@ Los atributos de orientación se utilizan para especificar la dirección del dis Los atributos página se utilizan para especificar la configuración general de impresión del documento. -| Propiedad | Tipo | Descripción | -| --------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| blackAndWhite | boolean | Impresión sólo en blanco y negro.

    Valor por defecto = false

    **Nota**: este atributo no afecta a los archivos PDF. Se mantienen los colores en los PDF.

    | -| centering | entero largo | Como se centran los contenidos en la página impresa. Valores disponibles: `vk print centering both`, `vk print centering horizontal`, `vk print centering none` (por defecto), `vk print centering vertical` | -| firstPageNumber | entero largo | El número de página a imprimir en la primera página. Valor por defecto = 1 | -| pageOrder | entero largo | Las páginas del pedido se imprimen. Valores disponibles: `vk print page order auto` (por defecto), `vk print page order down then over`, `vk print page order over then down`. | -| pageRange | text | El rango de páginas a imprimir | -| qualityFactor | entero largo | El factor de calidad para la impresión (1 - 8). Cuanto mayor sea el factor de calidad, mejor será la calidad de impresión, sin embargo, el rendimiento de impresión puede verse afectado.

    Valor por defecto = 2

    | -| useMax | boolean | Sólo se imprimen columnas y líneas con datos.

    Valor predeterminado = true

    | -| zoomFactor | real | La cantidad para ampliar o reducir la página impresa.

    Valor predeterminado = 1

    | +| Propiedad | Tipo | Descripción | +| --------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| blackAndWhite | boolean | Impresión sólo en blanco y negro.

    Valor por defecto = false

    **Nota**: este atributo no afecta a los archivos PDF. Se mantienen los colores en los PDF.

    | +| centering | entero largo | Como se centran los contenidos en la página impresa. Valores disponibles: `vk print centering both`, `vk print centering horizontal`, `vk print centering none` (por defecto), `vk print centering vertical` | +| firstPageNumber | entero largo | El número de página a imprimir en la primera página. Valor por defecto = 1 | +| pageOrder | entero largo | Las páginas del pedido se imprimen. Valores disponibles: `vk print page order auto` (por defecto), `vk print page order down then over`, `vk print page order over then down`. | +| pageRange | text | El rango de páginas a imprimir | +| qualityFactor | entero largo | El factor de calidad para la impresión (1 - 8). The higher the quality factor, the better the printing quality, however printing performance may be affected.

    Valor por defecto = 2

    | +| useMax | boolean | Sólo se imprimen columnas y líneas con datos.

    Valor por defecto = true

    | +| zoomFactor | real | La cantidad para ampliar o reducir la página impresa.

    Valor por defecto = 1

    | ### Tamaño del papel From 1a2fb0c652a4766d9c25c0c093bbfcff197b574d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:33 +0200 Subject: [PATCH 085/201] New translations http-request-handler.md (French) --- .../WebServer/http-request-handler.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md index a9e16ab1adf8ea..cc9ddee4b5c362 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md @@ -17,35 +17,35 @@ Les gestionnaires de requêtes HTTP personnalisés répondent à divers besoins, ## Conditions requises -Custom HTTP Request handlers are supported in the following context: +Les gestionnaires de requêtes HTTP personnalisés sont pris en charge dans le contexte suivant : -- [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, -- a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). +- les [sessions extensibles](./sessions.md#enabling-web-sessions) ou [pas de sessions](../settings/web.md#no-sessions) sont activées, +- un serveur web exécuté localement par 4D ou 4D Server, y compris ceux [exécutés par des composants](./webServerObject.md). :::warning -For security reasons, external access to the datastore can be disallowed in 4D. Vous devez configurer les [privilèges ORDA](../ORDA/privileges.md) pour autoriser les requêtes HTTP. +Pour des raisons de sécurité, l'accès externe au datastore peut être interdit dans 4D. Vous devez configurer les [privilèges ORDA](../ORDA/privileges.md) pour autoriser les requêtes HTTP. ::: -## How to set handlers +## Comment définir les gestionnaires -You can declare HTTP Request handlers: +Vous pouvez déclarer des gestionnaires de requêtes HTTP : -- in a configuration file named **HTTPHandlers.json** stored in the [`Project/Sources`](../Project/architecture.md#sources) folder of the project. HTTP Request handlers are loaded and applied in the main Web server once it is started. -- using a [`.handlers`](../API/WebServerClass.md#handlers) property set in the *settings* parameter of the [start()](../API/WebServerClass.md#start) function, for any web server object: +- dans un fichier de configuration nommé **HTTPHandlers.json** stocké dans le dossier [`Project/Sources`](../Project/architecture.md#sources) du projet. Les gestionnaires de requêtes HTTP sont chargés et appliqués dans le serveur Web principal une fois qu'il est démarré. +- en utilisant une propriété [`.handlers`](../API/WebServerClass.md#handlers) dans le paramètre *settings* de la fonction [start()](../API/WebServerClass.md#start), pour n'importe quel objet serveur web : ```4d -WEB Server.start($settings.handlers) //set rules at web server startup +WEB Server.start($settings.handlers) //prise en compte au démarrage du server web ``` -If both a **HTTPHandlers.json** file and a call to the [`WEB Server`](../commands/web-server.md) command with a valid `$settings.handlers` are used, the `WEB Server` command has priority. +Si à la fois un fichier **HTTPHandlers.json** et un appel à la commande [`WEB Server`](../commands/web-server.md) avec un `$settings.handlers` valide sont utilisés, la commande `WEB Server` est prioritaire. -The json file (or the object in the *settings* parameter) contains all listened URL patterns, the handled verbs, and the code to be called. +Le fichier json (ou l'objet dans le paramètre *settings*) contient tous les modèles d'URL listés, les verbes traités et le code à appeler. -Handlers are provided as a collection. +Les *handlers* sont fournis sous la forme d'une collection. -Au moment de l'exécution, le premier motif correspondant à l'URL est exécuté, les autres sont ignorés. +Au moment de l'exécution, le premier motif (*pattern*) correspondant à l'URL est exécuté, les autres sont ignorés. Voici un exemple du contenu d'un fichier *HTTPHandlers.json* : From 565e3502d09cbec62d800f626e179e862240e43a Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:34 +0200 Subject: [PATCH 086/201] New translations http-request-handler.md (Spanish) --- .../version-21/WebServer/http-request-handler.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md index facb115670bf95..e0a480493e6133 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-request-handler.md @@ -28,7 +28,7 @@ For security reasons, external access to the datastore can be disallowed in 4D. ::: -## How to set handlers +## Cómo definir los manejadores You can declare HTTP Request handlers: From 8475360e71c451547afeb9b8daba5e29024f2bf0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:39 +0200 Subject: [PATCH 087/201] New translations http-rules.md (French) --- .../version-21/WebServer/http-rules.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md index c5d53afb1f666c..ebc926199d567c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md @@ -11,8 +11,8 @@ To define HTTP rules, you just need to write some RegEx to declare the URL patte HTTP rules are supported in the following contexts: -- [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, -- a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). +- les [sessions extensibles](./sessions.md#enabling-web-sessions) ou [pas de sessions](../settings/web.md#no-sessions) sont activées, +- un serveur web exécuté localement par 4D ou 4D Server, y compris ceux [exécutés par des composants](./webServerObject.md). ## How to set rules @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Header | Ajouter | Set | Remove | +| ---------------- | ------- | ---------- | ------ | +| Date | Non | Non | Non | +| Content-Length | Non | Non | Non | +| Content-Encoding | Non | Non | Non | +| Vary | Oui | Non | Non | +| Set-Cookie | Oui | Add cookie | Non | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules @@ -215,7 +220,7 @@ $return:=WEB Server.start($settings) ``` -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [New Way to Control Your HTTP Responses](https://blog.4d.com/new-way-to-control-your-http-responses/) From 52d938266c423864476b423afdab225c5297c231 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:41 +0200 Subject: [PATCH 088/201] New translations http-rules.md (Spanish) --- .../version-21/WebServer/http-rules.md | 21 ++++++++++++------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md index e087d1672ba793..e88e079122443e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md @@ -1,6 +1,6 @@ --- id: http-rules -title: HTTP Rules +title: Reglas HTTP --- You can define HTTP rules to control HTTP response headers for any requests received by the 4D web server, including REST requests. You can add, modify, or remove HTTP headers, send redirections or set the HTTP status. This feature is useful to implement security policies based upon the handling of headers. @@ -14,7 +14,7 @@ HTTP rules are supported in the following contexts: - [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, - a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). -## How to set rules +## Cómo definir reglas You can declare HTTP response rules: @@ -29,7 +29,7 @@ If both a **HTTPRules.json** file and a call to the [`WEB Server`](../commands/w If the URI of the request does not match any of the RegEx patterns, the web server returns a default response. -## Rules Definition +## Definición de reglas The **HTTPRules.json** file or the [`.rules`](../API/WebServerClass.md#rules) property must contain a collection of **rule objects**. @@ -60,16 +60,21 @@ The following action keywords are supported: | `setHeaders` | Object | Name (text) and value (text) of header(s) to modify in the HTTP responses. If a header to modify does not exist in the response header, it is added. | | `denyAccess` | Boolean | true to deny access to the resource, false to allow access. When the access to a resource is denied, the web server returns a 403 status by default | | `redirect` | Text | Redirection URL. When a redirection is triggered, the web server returns a 302 status by default | -| `status` | Number | HTTP status | +| `status` | Number | Estado HTTP | ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Encabezado | Acción de añadir | Set | Remove | +| ---------------- | ---------------- | ------------- | ------ | +| Fecha | No | No | No | +| Content-Length | No | No | No | +| Content-Encoding | No | No | No | +| Vary | Sí | No | No | +| Set-Cookie | Sí | Añadir cookie | No | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From fbadee234e535d2e69801019a8908040d5933872 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:42 +0200 Subject: [PATCH 089/201] New translations http-rules.md (Japanese) --- .../version-21/WebServer/http-rules.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md index d857bb23d70623..6f6e8aacb4e491 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "日付", -- "Content-Length" +| Header | 追加 | Set | Reduce | +| ---------------- | -- | ---------- | ------ | +| Date | × | × | × | +| Content-Length | × | × | × | +| Content-Encoding | × | × | × | +| Vary | ◯ | × | × | +| Set-Cookie | ◯ | Add cookie | × | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From 742870ecaf0498ec41bd48865305241021d673aa Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:45 +0200 Subject: [PATCH 090/201] New translations http-rules.md (Portuguese, Brazilian) --- .../version-21/WebServer/http-rules.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md index a8c220ccb23587..2d09d0687cbba6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/http-rules.md @@ -64,12 +64,17 @@ The following action keywords are supported: ### Non-modifiable headers -The following headers could not be modified by the `removeHeaders`, `setHeaders`, or `addHeaders` actions: +Some headers could not be added, modified or removed: -- "Date", -- "Content-Length" +| Header | Add | Set | Remove | +| ---------------- | --- | ---------- | ------ | +| Date | Não | Não | Não | +| Content-Length | Não | Não | Não | +| Content-Encoding | Não | Não | Não | +| Vary | Sim | Não | Não | +| Set-Cookie | Sim | Add cookie | Não | -Modifying these headers do not generate errors, however modifications will be ignored. +Unauthorized changes on these headers do not generate errors, however modifications will be ignored. ### Current rules From 4bf0c763b4a5c54342b50978fb10593e5c7b3f57 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:52 +0200 Subject: [PATCH 091/201] New translations preemptiveweb.md (French) --- .../version-21/WebServer/preemptiveWeb.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/preemptiveWeb.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/preemptiveWeb.md index a61af9ff781cc8..7395ed0a06637b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/preemptiveWeb.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/preemptiveWeb.md @@ -44,7 +44,7 @@ Tout le code 4D exécuté par le serveur Web doit être thread-safe si vous souh - La méthode projet `compiler_web` (indépendamment de sa propriété "Mode d'exécution") ; -- Basically any code processed by the [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) command in the web context, for example through .shtml pages +- En principe, tout code traité par la commande [`PROCESS 4D TAGS`](../commands-legacy/process-4d-tags.md) dans le contexte du web, par exemple par le biais de pages .shtml - Toute méthode projet comportant l'attribut "Available through 4D tags and URLS (`4DACTION`, etc.)" From 29fbb78604066b63a6c076258202258e07ba92ac Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:25:59 +0200 Subject: [PATCH 092/201] New translations qodly-studio.md (French) --- .../version-21/WebServer/qodly-studio.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md index daf11db9f41587..a2d1f2e0c7862c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md @@ -138,7 +138,8 @@ Il n'y a pas de compatibilité directe entre les applications implémentées ave | Débogueur | 4D IDE debugger
    *4D Server only*: Qodly Studio debugger (see [this paragraph](#using-qodly-debugger-on-4d-server)) | Débogueur Qodly Studio | | Rôles et privilèges REST/Web | Edition directe roles.json / Éditeur de rôles et privilèges de Qodly Studio | Éditeur de rôles et privilèges de Qodly Studio | -Notez que dans 4D monoposte, si vous ouvrez du code 4D avec l'éditeur de code de Qodly Studio, la coloration syntaxique n'est pas disponible et un avertissement "Lsp not loaded" est affiché. Notez que dans 4D monoposte, si vous ouvrez du code 4D avec l'éditeur de code de Qodly Studio, la coloration syntaxique n'est pas disponible et un avertissement "Lsp not loaded" est affiché. +(1) L'élément **Modèle** est désactivé dans Qodly Studio.
    +(2) Dans 4D Server, l'ouverture du code 4D avec l'éditeur de code Qodly Studio est prise en charge **à des fins de test et de débogage** (voir [ce paragraphe](#development-and-deployment)). Notez que dans 4D monoposte, si vous ouvrez du code 4D avec l'éditeur de code de Qodly Studio, la coloration syntaxique n'est pas disponible et un avertissement "Lsp not loaded" est affiché. ### Langage @@ -234,7 +235,7 @@ The project must be running in interpreted mode so that **Qodly Studio** menu it ::: -2. In the Qodly Studio toolbar, click on the **Debug** button.
    +2. Dans la barre d'outils de Qodly Studio, cliquez sur le bouton **Debug**.
    ![qodly-debug](../assets/en/WebServer/qodly-debug.png) If the debug session starts successfully, a green bullet appears on the button label ![qodly-debug](../assets/en/WebServer/debug2.png) and you can use the Qodly Studio debugger. From 586f28772855da661581ef5cbca7b915d7c7edba Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:01 +0200 Subject: [PATCH 093/201] New translations qodly-studio.md (Spanish) --- .../version-21/WebServer/qodly-studio.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md index cb189885bf97f9..5988064c941307 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md @@ -138,7 +138,8 @@ No existe compatibilidad directa entre las aplicaciones implementadas con 4D y l | Depurador | 4D IDE debugger
    *4D Server only*: Qodly Studio debugger (see [this paragraph](#using-qodly-debugger-on-4d-server)) | Qodly Studio debugger | | Roles y privilegios REST/Web | Edición directa de roles.json/Editor de roles y permisos Qodly Studio | Editor de roles y privilegios de Qodly Studio | -Note that in 4D single-user, if you open some 4D code with the Qodly Studio code editor, syntax coloring is not available and a "Lsp not loaded" warning is displayed. (1) The **Model** item is disabled in Qodly Studio.
    +(1) El elemento **Modelo** está desactivado en Qodly Studio.
    +(2) En el servidor 4D, la apertura del código 4D con el editor de código Qodly Studio es soportada **para pruebas y depuración** (ver [este párrafo](#development-and-deployment)). (1) The **Model** item is disabled in Qodly Studio.
    (2) In 4D Server, opening 4D code with the Qodly Studio code editor is supported **for testing and debugging purposes** (see [this paragraph](#development-and-deployment)). ### Lenguaje @@ -235,7 +236,7 @@ El proyecto debe ejecutarse en modo interpretado para que el elemento de menú * ::: -2. In the Qodly Studio toolbar, click on the **Debug** button.
    +2. En la barra de herramientas de Qodly Studio, haga clic en el botón **Debug**.
    ![qodly-debug](../assets/en/WebServer/qodly-debug.png) Si la sesión de depuración se inicia correctamente, aparecerá una viñeta verde en la etiqueta del botón ![qodly-debug](../assets/en/WebServer/debug2.png) y podrá utilizar el depurador de Qodly Studio. From 5c2fdccde893aee6165655fb017e962b08f39b55 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:03 +0200 Subject: [PATCH 094/201] New translations qodly-studio.md (Japanese) --- .../version-21/WebServer/qodly-studio.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md index 17c2d431301349..858d01afba03f5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md @@ -138,8 +138,8 @@ Qodlyページを利用した Webアプリケーションを開発するには | デバッガー | 4D IDE デバッガー
    *4D Serverのみ*: Qodly Studio デバッガー ([この段落](#4d-server-で-qodlyデバッガーを使用する) を参照ください) | Qodly Studio デバッガー | | REST/Web ロールとアクセス権 | roles.json の直接編集 / Qodly Studio ロールとアクセス権エディター | Qodly Studio ロールとアクセス権エディター | -(1) Qodly Studioでは **Model** 項目は無効化されています。
    -(2) 4D Serverでは、Qodly Studio のコードエディターで 4Dコードを開くことができます (**テストおよびデバッグ目的のみ**。[この段落](#開発と運用) を参照ください) 4Dシングルユーザーの場合、Qodly Studio で 4Dコードを開くと、シンタックスの配色がサポートされておらず、"Lsp not loaded" という警告が表示されます。 +(1) **Model** の項目はQodly Studio では無効化されています。
    +(2) 4D Server では、Qodly Studio で4D コードを開くことは、**テストおよびデバッグ目的のため** にサポートされています([こちらの段落](#開発と運用) をご覧ください)。 4Dシングルユーザーの場合、Qodly Studio で 4Dコードを開くと、シンタックスの配色がサポートされておらず、"Lsp not loaded" という警告が表示されます。 ### ランゲージ @@ -235,7 +235,7 @@ Qodly Studio デバッガーを実行中の 4D Server アプリケーション ::: -2. Qodly Studio のツールバーで、**Debug** ボタンをクリックします。
    +2. Qoldy Studio ツールバー内において、**Debug** ボタンをクリックします。
    ![qodly-debug](../assets/en/WebServer/qodly-debug.png) デバッグセッションが正常に開始されると、ボタンラベルに緑色の丸が表示され ![qodly-debug](../assets/en/WebServer/debug2.png) 、Qodly Studio デバッガーを使用できるようになります。 From 3925789643014fab288c50c3dae8ed9b7a82c894 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:05 +0200 Subject: [PATCH 095/201] New translations qodly-studio.md (Portuguese, Brazilian) --- .../version-21/WebServer/qodly-studio.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md index 146662cec4481d..d1108f678dd9b7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/qodly-studio.md @@ -138,7 +138,8 @@ There is no direct compatibility between apps implemented with 4D and apps imple | Depurador | 4D IDE debugger
    *4D Server only*: Qodly Studio debugger (see [this paragraph](#using-qodly-debugger-on-4d-server)) | Depurador Qodly Studio | | Funções e privilégios REST/Web | roles.json direct edit/Qodly Studio roles and privileges editor | Qodly Studio role and privileges editor | -Note that in 4D single-user, if you open some 4D code with the Qodly Studio code editor, syntax coloring is not available and a "Lsp not loaded" warning is displayed. (1) The **Model** item is disabled in Qodly Studio.
    +(1) O item **Modelo** está desativado no Qodly Studio.
    +(2) No servidor 4D, a abertura de código 4D com o editor de código Qodly Studio é suportada **para fins de teste e depuração** (veja [esse parágrafo](#development-and-deployment)). (1) The **Model** item is disabled in Qodly Studio.
    (2) In 4D Server, opening 4D code with the Qodly Studio code editor is supported **for testing and debugging purposes** (see [this paragraph](#development-and-deployment)). ### Línguagem @@ -235,7 +236,7 @@ O projeto deve estar sendo executado no modo interpretado para que o item de men ::: -2. Na barra de ferramentas do Qodly Studio, clique no botão **Debug**.
    +2. Na barra de ferramentas Qodly Studio, clique no botão **Debug**.
    ![qodly-debug](../assets/en/WebServer/qodly-debug.png) If the debug session starts successfully, a green bullet appears on the button label ![qodly-debug](../assets/en/WebServer/debug2.png) and you can use the Qodly Studio debugger. From acb561cb572f3437e7b801a02e838a66f2b3e5ad Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:07 +0200 Subject: [PATCH 096/201] New translations sessions.md (French) --- .../version-21/WebServer/sessions.md | 174 +++++++++--------- 1 file changed, 87 insertions(+), 87 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index 3524feb00429dd..933c2fb182d830 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -12,7 +12,7 @@ Les sessions Web permettent de : - stocker et partager des données entre les process d'un client web en utilisant le [.storage](../API/SessionClass.md#storage) de la session, - associer des privilèges à l'utilisateur qui exécute la session. -:::tip Related blog post +:::tip Article(s) de blog sur le sujet [Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) @@ -22,7 +22,7 @@ Les sessions Web permettent de : Les sessions Web sont utilisées par : -- [Web applications](gettingStarted.md) sending http requests (including [SOAP Web services](../commands/theme/Web_Services_Server.md) and [/4DACTION](../WebServer/httpRequests.md#4daction) requests), +- les [applications Web](gettingStarted.md) envoyant des requêtes http (y compris les [Web services SOAP](../commands/theme/Web_Services_Server.md) et les requêtes [/4DACTION](../WebServer/httpRequests.md#4daction)), - les appels à l'[API REST](../REST/authUsers.md), qui sont effectués par les [datastores distants](../ORDA/remoteDatastores.md) et les [pages Qodly](qodly-studio.md). ## Activation des sessions web @@ -36,7 +36,7 @@ Cette option est sélectionnée par défaut dans les nouveaux projets. Elle peut - En utilisant la propriété [`.scalableSession`](API/WebServerClass.md#scalablession) de l'objet Web Server (à passer dans le paramètre *settings* de la fonction [`.start()`](API/WebServerClass.md#start) ). Dans ce cas, ce paramètre remplace l'option définie dans la boîte de dialogue Propriétés pour l'objet Web Server (il n'est pas stocké sur disque). -> The [`WEB SET OPTION`](../commands-legacy/web-set-option.md) command can also set the session mode for the main Web server. +> La commande [`WEB SET OPTION`](../commands-legacy/web-set-option.md) peut également définir le mode de session du serveur Web principal. Dans tous les cas, ce paramètre est local à la machine ; il peut donc être différent sur le serveur Web 4D Server et les serveurs Web des machines 4D distantes. @@ -44,7 +44,7 @@ Dans tous les cas, ce paramètre est local à la machine ; il peut donc être di ## Implémentation des sessions -When [sessions are enabled](#enabling-web-sessions), automatic mechanisms are implemented, based upon a private cookie set by 4D itself: "4DSID__AppName_", where *AppName* is the name of the application project. Ce cookie référence la session web courante pour l'application. +Lorsque [les sessions sont activées](#enabling-web-sessions), des mécanismes automatiques sont mis en œuvre, sur la base d'un cookie privé défini par 4D lui-même : "4DSID_*AppName*", où *AppName* est le nom du projet d'application. Ce cookie référence la session web courante pour l'application. :::info @@ -73,7 +73,7 @@ L'objet `Session` de la session en cours peut ensuite être manipulé via la com :::info -Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Since a web process can be reused by any session, [process variables](Concepts/variables.md#process-variables) must be cleared by your code at the end of its execution (using [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) for example). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. +Les process Web ne se terminent généralement pas, ils sont recyclés dans un pool pour des raisons d'optimisation. Lorsqu'un process termine l'exécution d'une requête, il est replacé dans le pool et rendu disponible pour la requête suivante. Comme un process web peut être réutilisé par n'importe quelle session, les [variables process](Concepts/variables.md#process-variables) doivent être effacées par votre code à la fin de son exécution (en utilisant [`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) par exemple). Ce nettoyage est nécessaire pour toute information liée au process, comme une référence à un fichier ouvert. C'est la raison pour laquelle **il est recommandé** d'utiliser l'objet [Session](API/SessionClass.md) lorsque vous souhaitez conserver les informations relatives à la session. ::: @@ -90,7 +90,7 @@ Une session web évolutive est fermée lorsque: La durée de vie d'un cookie inactif est de 60 minutes par défaut, ce qui signifie que le serveur Web fermera automatiquement les sessions inactives après 60 minutes. -This timeout can be set using the [`.idleTimeout`](API/SessionClass.md#idletimeout) property of the `Session` object (the timeout cannot be less than 60 minutes) or the *connectionInfo* parameter of the [`Open datastore`](../commands/open-datastore.md) command. +Ce délai peut être défini en utilisant la propriété [`.idleTimeout`](API/SessionClass.md#idletimeout) de l'objet `Session` (le délai ne peut être inférieur à 60 minutes) ou le paramètre *connectionInfo* de la commande [`Open datastore`](../commands/open-datastore.md). Lorsqu'une session web est fermée, si la commande [`Session`](commands/session.md) est appelée par la suite : @@ -159,7 +159,7 @@ http://localhost:8044/authenticate.shtml ![alt-text](../assets/en/WebServer/authenticate.png) -3. La méthode de projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : +3. La méthode projet d'authentification recherche la personne *userID* et valide le mot de passe par rapport à la valeur hachée déjà stockée dans la table *SalesPersons* : ```4d var $indexUserId; $indexPassword; $userId : Integer @@ -203,80 +203,80 @@ End if :::note -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). ::: -## Session Token (OTP) +## Token de session (OTP) -The 4D web server allows you to generate, share, and use OTP (One-Time Passcode) session tokens. OTP session tokens are used to secure communications with third-party applications or websites. For information on OTP, please refer to the [One-time password page](https://en.wikipedia.org/wiki/One-time_password) on Wikipedia. +Le serveur web 4D vous permet de générer, de partager et d'utiliser des tokens de session OTP (One-Time Passcode). Les tokens (ou *jetons*) de session OTP sont utilisés pour sécuriser les communications avec des applications ou des sites web tiers. Pour plus d'informations sur OTP, veuillez vous référer à la page [Mot de passe à usage unique](https://en.wikipedia.org/wiki/One-time_password) sur Wikipedia. -In 4D, OTP session tokens are useful when calling external URLs and being called back in another browser or device (mobile/computer). Typically, a third-party application sends a confirmation email containing a callback link on which the user has to click. The callback link includes the OTP token, so that the session which triggered the callback is loaded along with its data and privileges. This principle allows you to share the same session on multiple devices. Thanks to this architecture, the [session cookie](#session-implementation) is not exposed on the network, which eliminates the risk of man-in-the-middle attack. +Dans 4D, les tokens de session OTP sont utiles pour appeler des URL externes et être rappelé dans un autre navigateur ou appareil (mobile/ordinateur). Généralement, une application tierce envoie un courriel de confirmation contenant un lien de rappel sur lequel l'utilisateur doit cliquer. Le lien de rappel inclut le token OTP, de sorte que la session qui a déclenché le rappel est chargée avec ses données et ses privilèges. Ce principe vous permet de partager la même session sur plusieurs appareils. Grâce à cette architecture, le [cookie de session] (#session-implementation) n'est pas exposé sur le réseau, ce qui élimine le risque d'une attaque de type "man-in-the-middle". :::tips Articles de blog sur le sujet -[Connect Your Web Apps to Third-Party Systems](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/) +[Connectez vos applications Web à des systèmes tiers](https://blog.4d.com/connect-your-web-apps-to-third-party-systems/) ::: ### Vue d’ensemble -The basic sequence of an OTP session token use in a 4D web application is the following: +La séquence de base de l'utilisaton d'un token de session OTP dans une application web 4D est la suivante : -1. The web user initiates an action that requires a secured third-party connection, for example a validation, from within a specific session. -2. In your 4D code, you create a new OTP for the session using the [`Session.createOTP()`](../API/SessionClass.md#createotp) function. -3. You send a request to the third-party application with the session token included in the callback Uri. Note that the way to provide the callback Uri to a third-party application depends on its API (see below). -4. The third-party application sends back a request to 4D with the pattern you provided in the callback Uri. -5. The request callback is processed in your application. +1. L'utilisateur web initie une action qui nécessite une connexion tierce sécurisée, par exemple une validation, à partir d'une session spécifique. +2. Dans votre code 4D, vous créez un nouvel OTP pour la session à l'aide de la fonction [`Session.createOTP()`](../API/SessionClass.md#createotp). +3. Vous envoyez une requête à l'application tierce avec le token de session inclus dans l'Uri de callback (rappel). Notez que la manière de fournir l'Uri de rappel à une application tierce dépend de son API (voir ci-dessous). +4. L'application tierce renvoie une requête à 4D avec le modèle que vous avez fourni dans l'Uri de rappel. +5. Le rappel de la requête est traité dans votre application. -By definition, an OTP token can only be used once. In this scenario, if a web request is received with a session token as parameter that has already been used, the initial session is not restored. +Par définition, un token OTP ne peut être utilisé qu'une seule fois. Dans ce scénario, si une requête web est reçue avec un token de session comme paramètre qui a déjà été utilisé, la session initiale n'est pas restaurée. -### Processing the OTP in the callback +### Traitement de l'OTP dans le callback -Callbacks from third-party applications that include the OTP token can be processed in different ways in your 4D application, depending on your development and the third-party API. Basically, you have two possibilities to handle the token: through the **`$4DSID`** parameter for an automatic processing, or through a custom parameter that you need to process. +Les callbacks d'applications tierces qui incluent le token OTP peuvent être traités de différentes manières dans votre application 4D, en fonction de votre développement et de l'API tierce. En principe, vous avez deux possibilités pour gérer le token : via le paramètre **`$4DSID`** pour un traitement automatique, ou via un paramètre personnalisé que vous devez traiter. -#### Using `$4DSID` in the URL +#### Utilisation de `$4DSID` dans l'URL -Using the `$4DSID` parameter is the most simple way to process a callback from the third-party application: +L'utilisation du paramètre `$4DSID` est la façon la plus simple de traiter un callback de l'application tierce : -- The OTP token is provided as a parameter directly in the callback url using the standard `?$4DSID=XXXX123` syntax. -- In 4D, you implement a dedicated [HTTP Request handler](http-request-handler.md) in your 4D application using [`IncomingMessage`](../API/IncomingMessageClass.md) and [`OutgoingMessage`](../API/OutgoingMessageClass.md) classes. -- If the `$4DSID` token is valid, the related web user session is **automatically restored** in any web process with its storage and privileges. +- Le token OTP est fourni en tant que paramètre directement dans l'url de callback en utilisant la syntaxe standard `?$4DSID=XXXX123`. +- Dans votre application 4D, vous implémentez un [HTTP Request handler](http-request-handler.md) dédié en utilisant les classes [`IncomingMessage`](../API/IncomingMessageClass.md) et [`OutgoingMessage`](../API/OutgoingMessageClass.md). +- Si le token `$4DSID` est valide, la session de l'utilisateur web concerné est **automatiquement restaurée** dans n'importe quel process web avec son *storage* et ses privilèges. :::note -A [`4DACTION`](./httpRequests.md#4daction) url can also be used on the 4D side. +Une url [`4DACTION`](./httpRequests.md#4daction) peut également être utilisée du côté 4D. ::: -#### Using a custom parameter +#### Utilisation d'un paramètre personnalisé -The OTP token can also be provided as a custom parameter that you need to process specifically to restore the session. You must use this solution if: +Le token OTP peut également être fourni en tant que paramètre personnalisé que vous devez traiter spécifiquement pour restaurer la session. Vous devez utiliser cette solution si : -- the third-party application does not allow to insert parameters such as a `$4DSID` directly in the redirect Uri, and provides a dedicated API (the implementation depends on the third-party application), -- or, you want to call an ORDA function through REST to process the callback, in which case you need to pass the OTP with the [REST parameter syntax](../REST/ClassFunctions.md#parameters) (e.g. `?$params='["XXX123"]'`). +- l'application tierce ne permet pas d'insérer des paramètres tels que `$4DSID` directement dans l'Uri de redirection, et fournit une API dédiée (l'implémentation dépend de l'application tierce), +- ou bien vous souhaitez appeler une fonction ORDA via REST pour traiter le callback, auquel cas vous devez transmettre l'OTP avec la [syntaxe des paramètres REST](../REST/ClassFunctions.md#parameters) (par exemple `?$params='["XXX123"]'`). -In both cases, you need to extract the token from the custom parameter and to call the [`Session.restore()`](../API/SessionClass.md#restore) function with the token as parameter. +Dans les deux cas, vous devez extraire le token du paramètre personnalisé et appeler la fonction [`Session.restore()`](../API/SessionClass.md#restore) avec le token en paramètre. -#### Processing a invalid OTP +#### Traitement d'un OTP non valide -The OTP token is considered invalid if: +Le token OTP est considéré comme invalide si : - le token de session a déjà été utilisé, - le token de session a expiré, - le token de session n'existe pas, - la session d'origine elle-même a expiré. -In this case, no web user session is restored and the current session (if any) is left unchanged. Usually, you can decide to display a login page or to open a guest session. +Dans ce cas, aucune session d'utilisateur Web n'est restaurée et la session courante (s'il y en a une) reste inchangée. En général, vous pouvez décider d'afficher une page de connexion ou d'ouvrir une session guest. -Verifying if the received OTP token is valid depends on how it was handled: +La vérification de la validité du token OTP reçu dépend de la manière dont il a été géré : -- If you used a `$4DSID`, you can store a custom status property in the [session storage](../API/SessionClass.md#storage) at the moment of the token creation, and check this status once the OTP token was received to see if it is the same value (see example). -- If you used the [`Session.restore()`](../API/SessionClass.md#restore) function, it returns true if the session correctly restored. +- Si vous avez utilisé un `$4DSID`, vous pouvez stocker une propriété d'état personnalisée dans le [storage de la session](../API/SessionClass.md#storage) au moment de la création du token, et vérifier cet état une fois que le token OTP a été reçu pour voir s'il s'agit de la même valeur (voir l'exemple). +- Si vous avez utilisé la fonction [`Session.restore()`](../API/SessionClass.md#restore), elle renvoie true si la session a été correctement restaurée. -### Scenario with $4DSID +### Scénario avec $4DSID -The scenario using the `$4DSID` key is illustrated in the following diagram: +Le scénario utilisant la clé `$4DSID` est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -289,25 +289,25 @@ sequenceDiagram FrontEnd ->>+ 4DServer: ValidateOperation() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() -Note over 4DServer: e.g. OTP is 2E5D0D5xxx + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() +Note over 4DServer: e.g. OTP vaut 2E5D0D5xxx - 4DServer ->>+ ExternalPlatform: Call the external platform, give a callback URL containing a $4DSID parameter (depends on the platform API) + 4DServer ->>+ ExternalPlatform: Appel de la plate-forme tirece, envoi d'un URL de rappel contenant un paramètre $4DSID (dépend de l'API de la plate-forme) Note right of 4DServer: e.g. callback URL: "https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D5xxx" - ExternalPlatform ->>+ ExternalPlatform: Process request -ExternalPlatform ->>+ 4DServer: External platform calls back 4D Server if validation OK + ExternalPlatform ->>+ ExternalPlatform: Traitement de la requête +ExternalPlatform ->>+ 4DServer: Rappel de 4D Server si validation OK Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?$4DSID=2E5D0D57751D471DB29FD110D2DCE253 - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
    (e.g. handleOperation() function of the OperationsHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
    (e.g. fonction handleOperation() du singleton OperationsHandler, voir code ci-dessous) - Note over 4DServer: The original session is retrieved thanks to the OTP given in the $4DSID parameter. - Note over 4DServer: Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer: La session d'origine session est restaurée grâce à l'OTP fourni dans le paramètre $4DSID. + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -320,7 +320,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler @@ -329,9 +329,9 @@ shared singleton Class constructor() $session:=Session ``` -### Scenario with `restore` function +### Scénario avec la fonction `restore` -The scenario using a custom parameter is illustrated in the following diagram: +Le scénario utilisant un paramètre personnalisé est illustré dans le diagramme suivant : ```mermaid sequenceDiagram @@ -344,29 +344,29 @@ sequenceDiagram FrontEnd ->>+ 4DServer: Validate() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() Note over 4DServer: e.g. OTP is 2E5D0D5xxx - 4DServer ->> ExternalPlatform: Call the external platform giving the OTP, for example as a state parameter (depends on the platform) + 4DServer ->> ExternalPlatform: Appel de la plate-forme externe en donnant l'OTP, par exemple sous forme de paramètre state (dépend de la plate-forme) Note right of 4DServer: e.g. https://thirdPartSystem.com/validate?state=2E5D0D5xxx&redirect_uri=https://acme.com/my4DApp/completeOperation - Note right of 4DServer: The callback URL will be like: https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - ExternalPlatform ->> ExternalPlatform: Process request - ExternalPlatform ->> 4DServer: The state parameter is sent back by the third party system in the callback + Note right of 4DServer: L'URLde rappel sera du type : https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx + ExternalPlatform ->> ExternalPlatform: Traitement de la requête + ExternalPlatform ->> 4DServer: Le paramètre state est renvoyé par le système tiers dans la callback Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
    (e.g. handleOperation() function of the OperationHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
    (e.g. fonction handleOperation() du singleton OperationHandler, voir code ci-dessous) 4DServer ->> 4DServer: Session.restore() - Note over 4DServer:The state parameter is got from the received request ($req.urlQuery.state) - Note over 4DServer:The original session is retrieved by calling the restore() function - Note over 4DServer:Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer:Le paramètre state est extrait de la requête reçue ($req.urlQuery.state) + Note over 4DServer:La session originale est restaurée par l'appel à la fonction restore() + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` -The 4D HTTP request handler definition: +La définition du gestionnaire de requêtes HTTP 4D : ```json [ @@ -379,7 +379,7 @@ The 4D HTTP request handler definition: ] ``` -The singleton class: +La classe du singleton : ```4d //Class OperationsHandler @@ -388,9 +388,9 @@ shared singleton Class constructor() Session.restore($req.urlQuery.state) ``` -### Example of email validation with $4DSID +### Exemple de validation d'email avec $4DSID -1. A user account is created in a *Users* dataclass. A *$info* object is received with the email and password. An OTP corresponding to the current session is generated. An URL is then returned with this OTP given in the $4DSID parameter. +1. Un compte d'utilisateur est créé dans une dataclass *Users*. Un objet *$info* est reçu avec l'email et le mot de passe. Un OTP correspondant à la session courante est généré. Une URL est alors renvoyée avec l'OTP indiqué dans le paramètre $4DSID. ```4d //cs.Users class @@ -401,26 +401,26 @@ var $user : cs.UsersEntity var $status : Object var $token : Text -$user:=This.new() //create a new user +$user:=This.new() //créatoin d'un user $user.fromObject($info) $status:=$user.save() -//Store information in the session -//including user creation status +//Stockage d'information dans la session +//y compris le statut de création de l'utilisateur Use (Session.storage) Session.storage.status:=New shared object("step"; "Waiting for validation email"; / "email"; $user.email; "ID"; $user.ID) End use -//Generate an OTP corresponding to the session +//Génération d'un OTP correspondant à la session $token:=Session.createOTP() -// Return an URL with a $4DSID parameter +// Renvoi d'un URL avec un paramètre $4DSID return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ``` -2. The user is sent this URL as a link in an email. The URL prefix `/validateEmail` is handled by a [custom HTTP request handler](./http-request-handler.md): +2. L'utilisateur reçoit cette URL sous la forme d'un lien dans un courrier électronique. Le préfixe d'URL `/validateEmail` est traité par un [gestionnaire de requête HTTP personnalisé](./http-request-handler.md) : ```json [ @@ -433,7 +433,7 @@ return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ] ``` -The *validateEmail()* function of the RequestHandler singleton: +La fonction *validateEmail()* du singleton RequestHandler : ```4d //validateEmail class @@ -443,12 +443,12 @@ shared singleton Class constructor() Function validateEmail() : 4D.OutgoingMessage var $result:=4D.OutgoingMessage.new() - //The session which generated the OTP is retrieved - //thanks to the $4DSID parameter given in the URL + //La session qui a généré l'OTP est restaurée + //grâce au paramètre $4DSID fourni dans l'URL If (Session.storage.status.step="Waiting for validation email") $user:=ds.Users.get(Session.storage.status.ID) - $user.emailValidated() //set to true + $user.emailValidated() //fixé à vrai $result.setBody("Congratulations
    "\ +"Your email "+Session.storage.status.email+" has been validated") @@ -466,21 +466,21 @@ Function validateEmail() : 4D.OutgoingMessage ``` -Since the `$4DSID` parameter contains a valid OTP corresponding to the original session, the `Session` object refers to the session that created the OTP. +Comme le paramètre `$4DSID` contient un OTP valide correspondant à la session d'origine, l'objet `Session` référence la session qui a créé l'OTP. -A new user is created, and some information is stored in the session, especially the current step of the user account creation process (Waiting for validation email) and the user ID. +Un nouvel utilisateur est créé et des informations sont stockées dans la session, en particulier l'étape courante du processus de création du compte utilisateur (attente du courriel de validation) et l'identifiant de l'utilisateur. -### Supported contexts +### Contextes pris en charge -- Both HTTP and HTTPS schemas are supported. -- Only [scalable sessions](#enabling-web-sessions) can be reused with tokens. -- Only sessions of the host database can be reused (sessions created in component web servers cannot be restored). -- Tokens are not supported with client/server sessions or single-user sessions. +- Les schémas HTTP et HTTPS sont tous deux pris en charge. +- Seules des [sessions évolutives](#enabling-web-sessions) peuvent être réutilisées avec des tokens. +- Seules les sessions de la base de données hôte peuvent être réutilisées (les sessions créées dans les serveurs web des composants ne peuvent pas être restaurées). +- Les tokens ne sont pas pris en charge dans les sessions client/serveur ou les sessions mono-utilisateur. -### Lifespan +### Durée de vie -A session token has a lifespan, and the session itself has a lifespan. The session token lifespan can be set [at the token creation](../API/SessionClass.md#createotp). By default, the token lifespan is the same value as the [`.idleTimeout`](../API/SessionClass.md#idletimeout) value. +Un token de session a une durée de vie, et la session elle-même a une durée de vie. La durée de vie du token de session peut être définie [lors de sa création](../API/SessionClass.md#createotp). Par défaut, la durée de vie du token est la même que la valeur [`.idleTimeout`](../API/SessionClass.md#idletimeout). -A session is only restored by a token if both the session token lifespan and the session lifespan have not expired. In other cases (the session token has expired and/or the session itself has expired), a guest session is created when a web request with a session token is received. +Une session n'est restaurée par un token que si ni la durée de vie du token de session ni celle de la session n'ont expiré. Dans les autres cas (le token de session a expiré et/ou la session elle-même a expiré), une session *guest* est créée lorsqu'une requête web avec un token de session est reçue. From df240f4c8de63866a3de638edac7a6d473e7d0b4 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:10 +0200 Subject: [PATCH 097/201] New translations sessions.md (Spanish) --- .../version-21/WebServer/sessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index b2a3a87835a17c..5652ce165f242d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -477,7 +477,7 @@ Se crea un nuevo usuario y se almacena cierta información en la sesión, especi - Sólo se pueden reutilizar las sesiones de la base de datos local (las sesiones creadas en servidores web de componentes no se pueden restaurar). - Los tokens no son compatibles con las sesiones cliente/servidor ni con las sesiones monousuario. -### Lifespan +### Vida útil Un testigo de sesión tiene una vida útil, y la propia sesión tiene una vida útil. El tiempo de vida útil del token de sesión puede definirse [en la creación de tokens](../API/SessionClass.md#createotp). Por defecto, el tiempo de vida del token es el mismo valor que el valor de [`.idleTimeout`](../API/SessionClass.md#idletimeout). From f04728581967de450a10bfc8c84ac1d9c7f375f3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:31 +0200 Subject: [PATCH 098/201] New translations webserverconfig.md (French) --- .../version-21/WebServer/webServerConfig.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md index 6cddcc5504bfd3..5d9e19398db534 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md @@ -626,9 +626,9 @@ Dans certains cas, d'autres fonctions internes optimisées peuvent être appelé Deux options permettent de définir le mode de fonctionnement des connexions persistantes : -- **Nombre de requêtes par connexion** : Permet de définir le nombre maximal de requêtes et de réponses capables d'être transmises lors d'une connexion persistante. Limiter le nombre de demandes par connexion permet d'éviter le server flooding, provoqué par un trop grand nombre de requêtes entrantes (technique utilisée par les pirates informatiques).

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

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

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

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

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

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

    From f57460022dc4da33552a16b83a8012cb917fbea3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:34 +0200 Subject: [PATCH 099/201] New translations webserverconfig.md (Spanish) --- .../version-21/WebServer/webServerConfig.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md index 22056b4f4e48a2..4a467a5ab602c3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md @@ -623,9 +623,9 @@ En algunos casos, se pueden invocar otras funciones internas optimizadas. Las co Dos opciones le permiten definir cómo funcionan las conexiones persistentes: -- **Número de peticiones por conexión**: permite definir el número máximo de peticiones y de respuestas capaces de viajar por una conexión persistente. Limitar el número de peticiones por conexión le permite evitar la inundación del servidor debido a un gran número de peticiones entrantes (una técnica utilizada por los hackers).

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

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

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

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

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

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

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

    From 5502434f9a38775a7caffb885a4d7e1bbc5d5c62 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:37 +0200 Subject: [PATCH 100/201] New translations webserverconfig.md (Japanese) --- .../version-21/WebServer/webServerConfig.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md index 020a8dc923f782..ab699f1c9596ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md @@ -629,7 +629,8 @@ This option allows you to designate a user, previously defined in the [4D passwo Keep-Alive接続を設定する 2つのオプションがあります: -- **接続毎のリクエスト数**: ひとつの Keep-Alive接続におけるリクエストとレスポンスの最大数を設定します。 接続あたりのリクエスト数を制限することで、サーバーのリクエスト過多を避けることができます (攻撃者が使用するテクニック)。

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

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

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

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

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

    From 3d2ae25e4b16cd970747fbfe7a213394f4410afe Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:39 +0200 Subject: [PATCH 101/201] New translations webserverconfig.md (Portuguese, Brazilian) --- .../version-21/WebServer/webServerConfig.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md index e6222856a3d812..ea0060dd3c63c8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md @@ -625,9 +625,9 @@ Em alguns casos, outras funções internas otimizadas podem ser invocadas. As li Duas opções permitem que você defina como funcionam as conexões persistentes: -- **Number of requests by connection**: Allows you to set the maximum number of requests and responses able to travel over a connection keep alive. Limiting the number of requests per connection allows you to prevent server flooding due to a large number of incoming requests (a technique used by hackers).

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

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

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

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

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

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

    From 03305015d0fbbc954aecd3ef6cc17e21b6cebc29 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:51 +0200 Subject: [PATCH 102/201] New translations wp-add-picture.md (French) --- .../version-21/WritePro/commands/wp-add-picture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md index 60400e7ab9ec95..747b9690292e4c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Description -La commande **WP Add picture** ancre l'image passée en paramètre à un emplacement fixe dans le *wpDoc* spécifié et retourne sa référence. La référence retournée peut alors être passée à la commande [WP SET ATTRIBUTES](wp-set-attributes.md) pour déplacer l'image à n'importe quel emplacement dans le *wpDoc* (page, section, en-tête, pied de page, etc.) avec une couche définie, taille, etc. +La commande **WP Add picture** ancre l'image passée en paramètre à un emplacement fixe dans le *wpDoc* spécifié et renvoie sa référence. La référence renvoyée peut ensuite être transmise à la commande [WP SET ATTRIBUTES](wp-set-attributes.md) pour placer l'image à n'importe quel endroit du *wpDoc* (page, section, en-tête, pied de page, etc.) avec une couche définie, taille, etc. Dans *wpDoc*, passez le nom d'un objet document 4D Write Pro. From 1d4e9047990490ce27a97a691ff24bfbf1d645d7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:54 +0200 Subject: [PATCH 103/201] New translations wp-add-picture.md (Japanese) --- .../version-21/WritePro/commands/wp-add-picture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md index e25a76d713e869..2f1e46a91dbe29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## 説明 -**WP Add picture** コマンドは、 引数として渡されたピクチャーを*wpDoc* 引数で指定したドキュメント内での固定された場所にアンカーし、その参照を返します。 返された参照は、 [WP SET ATTRIBUTES](wp-set-attributes.md) コマンドへと渡すことで*wpDoc* 引数で指定したドキュメント内の(ページ、セクション、ヘッダー、フッター等の)任意の位置へと移動させることができます。 レイヤーやサイズなども指定可能です。 +**WP Add picture** コマンドは、引数として渡されたピクチャーを、*wpDoc* 引数で指定されたドキュメント内の固定された位置にアンカーし、その参照を返します。 その返された参照は、[WP SET ATTRIBUTES](wp-set-attributes.md) コマンドに渡すことによって *wpDoc* (ページ、セクション、ヘッダー、フッター、他)引数内の任意の位置にピクチャーを移動させることができます。 レイヤーやサイズなども指定可能です。 *wpDoc* 引数には、4D Write Pro ドキュメントオブジェクトを渡します。 From d42709964f1508b2cfe2849b4f17b2887635b7a4 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:26:56 +0200 Subject: [PATCH 104/201] New translations wp-add-picture.md (Portuguese, Brazilian) --- .../version-21/WritePro/commands/wp-add-picture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md index 124392c8b62474..988c667a79fcaf 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-add-picture.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Descrição -The **WP Add picture** command anchors the picture passed as parameter at a fixed location within the specified *wpDoc* and returns its reference. The returned reference can then be passed to the [WP SET ATTRIBUTES](wp-set-attributes.md) command to move the picture to any location in *wpDoc* (page, section, header, footer, etc.) with a defined layer, size, etc. +O comando **WP Adicionar imagem** ancora a imagem passada como parâmetro em um local fixo dentro do *wpDoc* especificado e retorna sua referência. A referência retornada pode ser passada para o comando [WP SET ATTRIBUTES](wp-set-attributes.md) para mover a imagem para qualquer local em *wpDoc* (página, seção, cabeçalho, rodapé, etc.) with a defined layer, size, etc. Em *wpDoc*, passe o nome de um objeto documento 4D Write Pro. From ee14040ada46b733fc63d982ae463c96482a5990 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:07 +0200 Subject: [PATCH 105/201] New translations wp-export-document.md (French) --- .../WritePro/commands/wp-export-document.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md index 64310fd825d0f8..69d289c7bf10eb 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md @@ -52,25 +52,25 @@ Vous pouvez omettre le paramètre *format*, auquel cas vous devez spécifier l'e Pass an [object](# "Data structured as a native 4D object") in *option* containing the values to define the properties of the exported document. Les propriétés suivantes sont disponibles : -| Constante | Valeur | Commentaire | -| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponible uniquement lorsque le format `wk mime html` est utilisé. | -| wk embedded pictures | embeddedPictures | For SVG Export only. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | For PDF export only. Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](#wk-factur-x-object)). | -| wk files | Historique | For PDF export only. Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](#wk-files-collection)). For PDF export only. In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | -| wk google fonts tag | googleFontsTag | For SVG export only. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | -| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | -| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 300 (Windows only). If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | For SVG export only. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Note:** Page index is independent from page numbering. | -| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Aussi, `wk pdfa3` signifie "exporte vers *au moins* PDF/A-3". Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. | -| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valeurs possibles :
  • true - Valeur par défaut. Toutes les formules sont recalculées
  • false - Ne pas recalculer les formules
    • | -| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Possible values: True/False | -| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | -| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Possible values: True/False | -| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Possible values: True/False | -| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Possible values: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Valeurs possibles : "normal", "nowrap", "pre", "pre-wrap" (par défaut), "pre-line", "break-spaces". | +| Constante | Valeur | Commentaire | +| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponible uniquement lorsque le format `wk mime html` est utilisé. | +| wk embedded pictures | embeddedPictures | For SVG Export only. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. Les images ne sont pas intégrées, mais sont référencées dans le fichier .svg.
    • Note : Si le dossier existe déjà, il est vidé avant l'exportation du fichier. If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | For PDF export only. Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](#wk-factur-x-object)). | +| wk files | Historique | For PDF export only. Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](#wk-files-collection)). For PDF export only. In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | +| wk google fonts tag | googleFontsTag | For SVG export only. Sets the import rule for google fonts in the exported SVG. Valeurs possibles :
  • false (par défaut) : Aucune règle d'importation des polices de Google n'est ajoutée.
  • true : Ajoute la règle @import au fichier exporté. Utile si vous voulez utiliser des polices qui ne sont pas disponibles par défaut sur Windows ou macOS.
    • **Note:** Cette propriété est définie sur false par défaut car, lorsqu'elle est activée, les polices Google ont la priorité sur les polices natives, et ces dernières sont généralement mieux rendues dans le navigateur. | +| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | +| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | +| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 300 (Windows only). If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). Si une image contient plus d'un format, le format de rendu d'écran est utilisé.
    • **Note:** Les documents exportés au format `wk docx` sont toujours optimisés pour wk print (l'option wk optimized for est ignorée). | +| wk page index | pageIndex | For SVG export only. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Note:** Page index is independent from page numbering. | +| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Aussi, `wk pdfa3` signifie "exporte vers *au moins* PDF/A-3". Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. | +| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valeurs possibles :
  • true - Valeur par défaut. Toutes les formules sont recalculées
  • false - Ne pas recalculer les formules
    • | +| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Possible values: True/False | +| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | +| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Possible values: True/False | +| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Possible values: True/False | +| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Possible values: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Valeurs possibles : "normal", "nowrap", "pre", "pre-wrap" (par défaut), "pre-line", "break-spaces". | Le tableau suivant indique l'*option* disponible par *format* d'export : @@ -89,7 +89,7 @@ Le tableau suivant indique l'*option* disponible par *format* d'export : | wk recompute formulas | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | | wk visible background and anchored elements | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | toujours true | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | | wk visible empty images | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | -| wk visible footers | \- | toujours true | toujours false | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (default: true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | +| wk visible footers | \- | toujours true | toujours false | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | | wk visible headers | \- | toujours true | toujours false | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : true) | | wk visible references | \- | \- | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : false) | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : false) | | wk whitespace | \- | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : "pre-wrap") | \- | ![](../../assets/en/WritePro/commands/pict5058606.en.png) (par défaut : "pre-wrap") | \- | From 4f3f2563a901aa5f38df7a37c58a2e2087463da0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:10 +0200 Subject: [PATCH 106/201] New translations wp-export-document.md (Spanish) --- .../WritePro/commands/wp-export-document.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md index 5b83c6bb5b8efb..e3ba5688f10b6f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md @@ -52,25 +52,25 @@ Puede omitir el parámetro *format*, en cuyo caso deberá especificar la extensi Pase un [objeto](# "Datos estructurados como un objeto nativo 4D") en *option* conteniendo los valores para definir las propiedades del documento exportado. Las siguientes propiedades están disponibles: -| Constante | Valor | Comentario | -| ------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | Nombre de dominio de host CID: dominio de host que se añadirá a las URL CID generadas incluyendo una "@" como separador. Disponible sólo cuando se utiliza el formato `wk mime html`. | -| wk embedded pictures | embeddedPictures | Sólo para exportación SVG. Establece si las imágenes se incrustan en el archivo .svg exportado cuando se llama a [WP EXPORT DOCUMENT](wp-export-document.md). Valores disponibles:
  • true (por defecto): las imágenes están incrustadas en el archivo .svg exportado
  • false: las imágenes se exportan en una carpeta llamada "filename\_images" en el nivel del archivo .svg exportado, "filename" siendo el nombre pasado al comando para el archivo, sin la extensión. Las imágenes no se incrustan, sino que se hace referencia a ellas en el archivo .svg.
    • Nota: si la carpeta ya existe, se vacía antes de exportar el archivo. Si no hay ninguna imagen en la página exportada, se elimina la carpeta | -| wk factur x | facturX | Sólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver [wk factur x object](#wk-factur-x-object)). | -| wk files | Histórico | Sólo para exportación en PDF. Valor: colección de objetos, cada uno de los cuales describe un archivo que se integrará en el documento final (ver [wk files collection](#wk-files-collection)). Esta funcionalidad sólo se admite en documentos PDF/A-3: cuando se utiliza el atributo `wk files`, se establece automáticamente la versión "PDF/A-3" (se ignora el atributo `wk pdfa version`). En caso de una exportación de Factur-X PDF (ver abajo), el primer objeto de la colección debe contener el archivo Factur-X xml. | -| wk google fonts tag | googleFontsTag | Sólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Valores posibles:
  • false (por defecto): no se añade ninguna regla de importación de google fonts.
  • true: añade la regla @import al archivo exportado. Útil si desea utilizar fuentes que no están disponibles por defecto en Windows o macOS.
    • **Nota:** esta propiedad está definida en false de forma predeterminada porque, cuando está activa, las fuentes de Google anulan las fuentes nativas y, por lo general, las fuentes nativas se muestran mejor en el navegador. | -| wk HTML pretty print | htmlPrettyPrint | El código HTML está formateado para facilitar su lectura. | -| wk max picture DPI | maxPictureDPI | Se utiliza para reducir imágenes a la resolución preferida. Para imágenes SVG en Windows, utilizado para la rasterización. Valores por defecto: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Valor máximo posible: 1440 | -| wk optimized for | optimizedFor | Define cómo se optimiza un documento exportado en función de su soporte. Valores posibles:
  • `wk print` (valor por defecto para `wk pdf` y `wk svg`) Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 300 (valor por defecto) y pueden convertirse a PNG si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 300 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el mejor formato para la impresión (*por ejemplo*, .tiff en lugar de .jpg)
  • `wk screen` (valor por defecto para `wk web page complete` y `wk mime html`). Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 192 (valor por defecto) y pueden convertirse a JPEG (imágenes opacas) o PNG (imágenes transparentes) si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 192 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el formato para la representación en pantalla.
    • **Nota:** los documentos exportados en formato `wk docx` siempre se optimizan para la impresión wk (se ignora la opción wk optimized for). | -| wk page index | pageIndex | Sólo para exportación SVG. Índice de la página a exportar a formato svg (por defecto es 1). El índice de páginas comienza en 1 para la primera página del documento. **Nota:** el índice de páginas es independiente de la numeración de páginas. | -| wk pdfa version | pdfaVersion | Exporta PDF conforme a una versión PDF/A. Para más información sobre las propiedades y versiones de PDF/A, consulte la [página PDF/A en Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Valores posibles:
  • `wk pdfa2`: exporta a la versión "PDF/A-2"
  • `wk pdfa3`: exporta a la versión "PDF/A-3"
  • **Nota:** en macOS, `wk pdfa2` puede exportar a PDF/A-2 o PDF/A-3 o superior, dependiendo de la implementación de la plataforma. Además, `wk pdfa3` significa "exporta a *al menos* PDF/A-3". En Windows, el archivo PDF de salida siempre será igual a la conformidad deseada. | -| wk recompute formulas | recomputeFormulas | Define si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles:
  • true - Valor por defecto. Se vuelven a calcular todas las fórmulas
  • false - No se vuelven a calcular las fórmulas
    • | -| wk visible background and anchored elements | visibleBackground | Muestra o exporta imágenes/color de fondo, imágenes ancladas y cuadros de texto (para mostrar, efecto visible sólo en modo de vista Página o Anidado). Valores posibles: True/False | -| wk visible empty images | visibleEmptyImages | Muestra o exporta un rectángulo negro por defecto para las imágenes que no se pueden cargar o calcular (imágenes vacías o imágenes en un formato no compatible). Valores posibles: True/False. Valor por defecto: True Si el valor es False, los elementos de imagen que falten no se mostrarán en absoluto aunque tengan bordes, ancho, alto o fondo; esto puede afectar al diseño de la página para imágenes en línea. | -| wk visible footers | visibleFooters | Muestra o exporta los pies de página (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | -| wk visible headers | visibleHeaders | Muestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | -| wk visible references | visibleReferences | Muestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False | -| wk whitespace | whitespace | Define el valor css "white-space" para los formatos de exportación `wk mime html` y `wk web page complete`. El estilo [white-space css](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) se aplica a los párrafos. Valores posibles: "normal", "nowrap", "pre", "pre-wrap" (por defecto), "pre-line", "break-spaces". | +| Constante | Valor | Comentario | +| ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | Nombre de dominio de host CID: dominio de host que se añadirá a las URL CID generadas incluyendo una "@" como separador. Disponible sólo cuando se utiliza el formato `wk mime html`. | +| wk embedded pictures | embeddedPictures | Sólo para exportación SVG. Establece si las imágenes se incrustan en el archivo .svg exportado cuando se llama a [WP EXPORT DOCUMENT](wp-export-document.md). Valores disponibles:
  • true (por defecto): las imágenes están incrustadas en el archivo .svg exportado
  • false: las imágenes se exportan en una carpeta llamada "filename\_images" en el nivel del archivo .svg exportado, "filename" siendo el nombre pasado al comando para el archivo, sin la extensión. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. Si no hay ninguna imagen en la página exportada, se elimina la carpeta | +| wk factur x | facturX | Sólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver [wk factur x object](#wk-factur-x-object)). | +| wk files | Histórico | Sólo para exportación en PDF. Valor: colección de objetos, cada uno de los cuales describe un archivo que se integrará en el documento final (ver [wk files collection](#wk-files-collection)). Esta funcionalidad sólo se admite en documentos PDF/A-3: cuando se utiliza el atributo `wk files`, se establece automáticamente la versión "PDF/A-3" (se ignora el atributo `wk pdfa version`). En caso de una exportación de Factur-X PDF (ver abajo), el primer objeto de la colección debe contener el archivo Factur-X xml. | +| wk google fonts tag | googleFontsTag | Sólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Possible values:
  • false (default): No google fonts import rule is added.
  • true: añade la regla @import al archivo exportado. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | +| wk HTML pretty print | htmlPrettyPrint | El código HTML está formateado para facilitar su lectura. | +| wk max picture DPI | maxPictureDPI | Se utiliza para reducir imágenes a la resolución preferida. Para imágenes SVG en Windows, utilizado para la rasterización. Valores por defecto: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Valor máximo posible: 1440 | +| wk optimized for | optimizedFor | Define cómo se optimiza un documento exportado en función de su soporte. Valores posibles:
  • `wk print` (valor por defecto para `wk pdf` y `wk svg`) Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 300 (valor por defecto) y pueden convertirse a PNG si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 300 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el mejor formato para la impresión (*por ejemplo*, .tiff en lugar de .jpg)
  • `wk screen` (valor por defecto para `wk web page complete` y `wk mime html`). Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 192 (valor por defecto) y pueden convertirse a JPEG (imágenes opacas) o PNG (imágenes transparentes) si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 192 (sólo Windows). If a picture contains more than one format, the format for screen rendering is used.
    • **Nota:** los documentos exportados en formato `wk docx` siempre se optimizan para la impresión wk (la opción wk optimized for se ignora). | +| wk page index | pageIndex | Sólo para exportación SVG. Índice de la página a exportar a formato svg (por defecto es 1). El índice de páginas comienza en 1 para la primera página del documento. **Nota:** el índice de páginas es independiente de la numeración de páginas. | +| wk pdfa version | pdfaVersion | Exporta PDF conforme a una versión PDF/A. Para más información sobre las propiedades y versiones de PDF/A, consulte la [página PDF/A en Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Valores posibles:
  • `wk pdfa2`: exporta a la versión "PDF/A-2"
  • `wk pdfa3`: exporta a la versión "PDF/A-3"
  • **Nota:** en macOS, `wk pdfa2` puede exportar a PDF/A-2 o PDF/A-3 o superior, dependiendo de la implementación de la plataforma. Además, `wk pdfa3` significa "exporta a *al menos* PDF/A-3". En Windows, el archivo PDF de salida siempre será igual a la conformidad deseada. | +| wk recompute formulas | recomputeFormulas | Define si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles:
  • true - Valor por defecto. Se vuelven a calcular todas las fórmulas
  • false - No se vuelven a calcular las fórmulas
    • | +| wk visible background and anchored elements | visibleBackground | Muestra o exporta imágenes/color de fondo, imágenes ancladas y cuadros de texto (para mostrar, efecto visible sólo en modo de vista Página o Anidado). Valores posibles: True/False | +| wk visible empty images | visibleEmptyImages | Muestra o exporta un rectángulo negro por defecto para las imágenes que no se pueden cargar o calcular (imágenes vacías o imágenes en un formato no compatible). Valores posibles: True/False. Valor por defecto: True Si el valor es False, los elementos de imagen que falten no se mostrarán en absoluto aunque tengan bordes, ancho, alto o fondo; esto puede afectar al diseño de la página para imágenes en línea. | +| wk visible footers | visibleFooters | Muestra o exporta los pies de página (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | +| wk visible headers | visibleHeaders | Muestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | +| wk visible references | visibleReferences | Muestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False | +| wk whitespace | whitespace | Define el valor css "white-space" para los formatos de exportación `wk mime html` y `wk web page complete`. El estilo [white-space css](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) se aplica a los párrafos. Valores posibles: "normal", "nowrap", "pre", "pre-wrap" (por defecto), "pre-line", "break-spaces". | The following table indicates the *option* available per export *format*: From 167f7b59f793da1ac06f570894a79d9aafd6eff2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:12 +0200 Subject: [PATCH 107/201] New translations wp-export-document.md (Japanese) --- .../WritePro/commands/wp-export-document.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md index fd9e6d6d78da8e..53188bb1383cf8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md @@ -52,25 +52,25 @@ displayed_sidebar: docs *option* 引数には、書き出されるドキュメントのプロパティを定義する値を格納している[オブジェクト](# "ネイティブな4D オブジェクトとして構築されたデータ") を渡します。 次のプロパティを利用することができます: 次のプロパティを利用することができます: 次のプロパティを利用することができます: -| 定数 | 値 | 説明 | -| ------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。 wk mime html フォーマットが使用されている際にのみ使用可能です。 Available only when the `wk mime html` format is used. | -| wk embedded pictures | embeddedPictures | SVG 書き出し専用。 [WP EXPORT DOCUMENT](wp-export-document.md) を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。 Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | PDF 書き出しのみ。 Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](#wk-factur-x-object)). | -| wk files | files | PDF 書き出しのみ。 Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](#wk-files-collection)). This feature is only supported in PDF/A-3 documents: when the `wk files` attribute is used, the "PDF/A-3" version is automatically set (the `wk pdfa version` attribute is ignored). Factur-X PDF 書き出し(下記参照)の場合、コレクションの最初のオブジェクトにはFactur-X XML ファイルが格納されている必要があります。 | -| wk google fonts tag | googleFontsTag | SVG書き出し専用。 書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。 取り得る値:
  • false (デフォルト): google フォントの読み込みルールは何も追加されていません。
  • true: @import ルールを下記出されたファイルに追加します。 Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 | -| wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。 Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値: 300 (for wk optimized for \= wk print 時) 192 (for wk optimized for \= wk screen 時) 取り得る最大値: 1440 | -| wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 取り得る値:
  • `wk print` (`wk pdf` および `wk svg` のデフォルト値) ビットマップピクチャーは、`wk max picture DPI` で定義されたDPI または300 (デフォルト値) を使用してダウンスケールされる可能性があり、また書き出されるタイプに対してコーデックがサポートされていない場合にはPNG へと変換される可能性もあります。 ベクターのピクチャーは `wk max picture DPI` で定義されたDPI、または300 (Windows のみ)を使用してPNG へと変換されます。 If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | SVG書き出し専用。 SVG書き出し専用。 SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 | -| wk pdfa version | pdfaVersion | PDF/A バージョンに適合したPDF を書き出します。 PDF/A のプロパティおよびバージョンの詳細については、[Wikipedia のPDF/A のページ](https://ja.wikipedia.org/wiki/PDF/A) を参照してください。 Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". Windows 上では、出力されたPDF ファイルは常に指定されたバージョンと同じになります。 | -| wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。 Possible values:
  • true - Default value. All formulas are recomputed
  • false - Do not recompute formulas
    • | -| wk visible background and anchored elements | visibleBackground | 背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | -| wk visible empty images | visibleEmptyImages | 読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。 取り得る値: True/False. 取り得る値: True/False. デフォルト値: True 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。 | -| wk visible footers | visibleFooters | フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False | -| wk visible headers | visibleHeaders | ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | -| wk visible references | visibleReferences | ドキュメントに挿入されている4D 式を参照として表示または書き出しします。 取り得る値: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | +| 定数 | 値 | 説明 | +| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。 wk mime html フォーマットが使用されている際にのみ使用可能です。 Available only when the `wk mime html` format is used. | +| wk embedded pictures | embeddedPictures | SVG 書き出し専用。 [WP EXPORT DOCUMENT](wp-export-document.md) を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。 Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. ピクチャーは埋め込まれませんが、.svg ファイルから参照されます。
    • 注意: フォルダが既に存在する場合、ファイルが書き出される前にそのフォルダは空にされます。 If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | PDF 書き出しのみ。 Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](#wk-factur-x-object)). | +| wk files | files | PDF 書き出しのみ。 Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](#wk-files-collection)). This feature is only supported in PDF/A-3 documents: when the `wk files` attribute is used, the "PDF/A-3" version is automatically set (the `wk pdfa version` attribute is ignored). Factur-X PDF 書き出し(下記参照)の場合、コレクションの最初のオブジェクトにはFactur-X XML ファイルが格納されている必要があります。 | +| wk google fonts tag | googleFontsTag | SVG書き出し専用。 書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。 取り得る値:
  • false (デフォルト): Google フォントの読み込みルールは何も追加されません。
  • true: 書き出されたファイルに@import ルールを追加します。 Windows またはmacOS において利用できないフォントを使用したい場合に有用です。
    • **注意:** このプロパティはデフォルトではFalse に設定されています。なぜなら読み込まれたGoogle フォントはネイティブのフォントを上書きしますが、一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされるからです。 | +| wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 | +| wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。 Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値: 300 (for wk optimized for \= wk print 時) 192 (for wk optimized for \= wk screen 時) 取り得る最大値: 1440 | +| wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 取り得る値:
  • `wk print` (`wk pdf` および `wk svg` のデフォルト値) ビットマップピクチャーは、`wk max picture DPI` で定義されたDPI または300 (デフォルト値) を使用してダウンスケールされる可能性があり、また書き出されるタイプに対してコーデックがサポートされていない場合にはPNG へと変換される可能性もあります。 ベクターのピクチャーは `wk max picture DPI` で定義されたDPI、または300 (Windows のみ)を使用してPNG へと変換されます。 If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). 画像に複数のフォーマットが含まれている場合、スクリーンレンダリング用のフォーマットが使用されます。
    • **注意:** `wk docx` フォーマットで書き出されたドキュメントは、常にwk print 用に最適化されています(wk optimized for オプションは無視されます)。 | +| wk page index | pageIndex | SVG書き出し専用。 SVG書き出し専用。 SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 | +| wk pdfa version | pdfaVersion | PDF/A バージョンに適合したPDF を書き出します。 PDF/A のプロパティおよびバージョンの詳細については、[Wikipedia のPDF/A のページ](https://ja.wikipedia.org/wiki/PDF/A) を参照してください。 Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". Windows 上では、出力されたPDF ファイルは常に指定されたバージョンと同じになります。 | +| wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。 Possible values:
  • true - Default value. All formulas are recomputed
  • false - Do not recompute formulas
    • | +| wk visible background and anchored elements | visibleBackground | 背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | +| wk visible empty images | visibleEmptyImages | 読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。 取り得る値: True/False. 取り得る値: True/False. デフォルト値: True 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。 | +| wk visible footers | visibleFooters | フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False | +| wk visible headers | visibleHeaders | ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | +| wk visible references | visibleReferences | ドキュメントに挿入されている4D 式を参照として表示または書き出しします。 取り得る値: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | 以下の表は*format* 引数の各フォーマットごとに利用可能な*option* 引数のオプションをあらわしています: From 8a695bfefc4e06ec0809e23ce46c422466f797f7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:14 +0200 Subject: [PATCH 108/201] New translations wp-export-document.md (Portuguese, Brazilian) --- .../WritePro/commands/wp-export-document.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md index 20e7d6838d5ae9..f38e886e2ec987 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-document.md @@ -52,25 +52,25 @@ Você pode omitir o parâmetro *format*, neste caso você precisa especificar a Pass an [object](# "Data structured as a native 4D object") in *option* containing the values to define the properties of the exported document. As seguintes propriedades estão disponíveis: -| Parâmetros | Valor | Comentário | -| ------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponível somente quando o formato `wk mime html` é usado. | -| wk embedded pictures | embeddedPictures | Somente para exportação SVG. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | Somente para exportação em PDF. Valor: objeto que configura uma exportação de PDF "Factur-X (ZUGFeRD)" (consulte [wk factur x object](#wk-factur-x-object)). | -| wk files | files | Somente para exportação em PDF. Valor: coleção de objetos, cada um deles descrevendo um arquivo a ser incorporado no documento final (consulte [wk files collection](#wk-files-collection)). Este recurso só é suportado em documentos PDF/A-3: quando o atributo `wk files` é usado, a versão "PDF/A-3" é definida automaticamente (o atributo `wk pdfa version` é ignorado). In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | -| wk google fonts tag | googleFontsTag | Somente para exportação SVG. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | -| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | -| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 300 (apenas Windows). Se uma imagem contiver mais de um formato, será usado o melhor formato para impressão (*por exemplo*, .tiff em vez de .jpg)
  • `wk screen` (valor padrão para `wk web page complete` e `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 192 (apenas Windows). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | Somente para exportação SVG. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Nota:** o índice de páginas é independente da numeração de páginas. | -| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". On Windows, the output PDF file will always be equal to the desired conformance. | -| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valores possíveis:
  • true - Valor padrão. All formulas are recomputed
  • false - Do not recompute formulas
    • | -| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Valores possíveis: True/False | -| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | -| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Valores possíveis: True/False | -| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Valores possíveis: True/False | -| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Valores possíveis: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | +| Parâmetros | Valor | Comentário | +| ------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponível somente quando o formato `wk mime html` é usado. | +| wk embedded pictures | embeddedPictures | Somente para exportação SVG. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | Somente para exportação em PDF. Valor: objeto que configura uma exportação de PDF "Factur-X (ZUGFeRD)" (consulte [wk factur x object](#wk-factur-x-object)). | +| wk files | files | Somente para exportação em PDF. Valor: coleção de objetos, cada um deles descrevendo um arquivo a ser incorporado no documento final (consulte [wk files collection](#wk-files-collection)). Este recurso só é suportado em documentos PDF/A-3: quando o atributo `wk files` é usado, a versão "PDF/A-3" é definida automaticamente (o atributo `wk pdfa version` é ignorado). In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | +| wk google fonts tag | googleFontsTag | Somente para exportação SVG. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Útil se você quiser usar fontes que não estão disponíveis por padrão no Windows ou macOS.
    • **Nota:** Essa propriedade é definida como falso por padrão porque quando habilitada As fontes do Google substituem fontes nativas, e as fontes nativas são geralmente melhor renderizadas no navegador. | +| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | +| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | +| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 300 (apenas Windows). Se uma imagem contiver mais de um formato, será usado o melhor formato para impressão (*por exemplo*, .tiff em vez de .jpg)
  • `wk screen` (valor padrão para `wk web page complete` e `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 192 (apenas Windows). Se uma imagem contiver mais de um formato, será utilizado o formato para a renderização de tela. U
    • **Nota:** Documentos exportados em formato `wk docx` são sempre otimizados para impressão wk (wk otimizado para opção é ignorado). | +| wk page index | pageIndex | Somente para exportação SVG. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Nota:** o índice de páginas é independente da numeração de páginas. | +| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". On Windows, the output PDF file will always be equal to the desired conformance. | +| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valores possíveis:
  • true - Valor padrão. All formulas are recomputed
  • false - Do not recompute formulas
    • | +| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Valores possíveis: True/False | +| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | +| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Valores possíveis: True/False | +| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Valores possíveis: True/False | +| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Valores possíveis: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` and `wk web page complete` export formats. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | A tabela a seguir indica a *option* disponível por *format* de exportação: From 83853440f7f43e6bfea8c99f0a6038e690040402 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:16 +0200 Subject: [PATCH 109/201] New translations wp-export-variable.md (French) --- .../WritePro/commands/wp-export-variable.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md index 8ab471cf8de5d3..4aa00fc3ebab01 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Description -The **WP EXPORT VARIABLE** command exports the *wpDoc* 4D Write Pro object to the 4D *destination* variable in the specified *format*. +La commande **WP EXPORT VARIABLE** exporte l'objet *wpDoc* 4D Write Pro vers la variable 4D *destination* dans le *format* spécifié. Dans *wpDoc*, passez l'objet 4D Write Pro que vous souhaitez exporter. @@ -52,25 +52,25 @@ Dans le paramètre *format*, passez une constante du thème *4D Write Pro Consta Pass an [object](# "Data structured as a native 4D object") in *option* containing the values to define the properties of the exported document. Les propriétés suivantes sont disponibles : -| Constante | Valeur | Commentaire | -| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponible uniquement lorsque le format `wk mime html` est utilisé. | -| wk embedded pictures | embeddedPictures | For SVG Export only. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | For PDF export only. Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | -| wk files | Historique | For PDF export only. Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](./wp-export-document.md#wk-files-collection)). For PDF export only. In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | -| wk google fonts tag | googleFontsTag | For SVG export only. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | -| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | -| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 300 (Windows only). If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | For SVG export only. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Note:** Page index is independent from page numbering. | -| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Aussi, `wk pdfa3` signifie "exporte vers *au moins* PDF/A-3". Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. | -| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valeurs possibles :
  • true - Valeur par défaut. Toutes les formules sont recalculées
  • false - Ne pas recalculer les formules
    • | -| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Possible values: True/False | -| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | -| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Possible values: True/False | -| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Possible values: True/False | -| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Possible values: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Valeurs possibles : "normal", "nowrap", "pre", "pre-wrap" (par défaut), "pre-line", "break-spaces". | +| Constante | Valeur | Commentaire | +| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponible uniquement lorsque le format `wk mime html` est utilisé. | +| wk embedded pictures | embeddedPictures | For SVG Export only. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. Les images ne sont pas intégrées, mais sont référencées dans le fichier .svg.
    • Note : Si le dossier existe déjà, il est vidé avant l'exportation du fichier. If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | For PDF export only. Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | +| wk files | Historique | For PDF export only. Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](./wp-export-document.md#wk-files-collection)). For PDF export only. In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | +| wk google fonts tag | googleFontsTag | For SVG export only. Sets the import rule for google fonts in the exported SVG. Valeurs possibles :
  • false (par défaut) : Aucune règle d'importation des polices de Google n'est ajoutée.
  • true : Ajoute la règle @import au fichier exporté. Utile si vous voulez utiliser des polices qui ne sont pas disponibles par défaut sur Windows ou macOS.
    • **Note:** Cette propriété est définie sur false par défaut car, lorsqu'elle est activée, les polices Google ont la priorité sur les polices natives, et ces dernières sont généralement mieux rendues dans le navigateur. | +| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | +| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | +| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 300 (Windows only). If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). Si une image contient plus d'un format, le format de rendu d'écran est utilisé.
    • **Note:** Les documents exportés au format `wk docx` sont toujours optimisés pour wk print (l'option wk optimized for est ignorée). | +| wk page index | pageIndex | For SVG export only. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Note:** Page index is independent from page numbering. | +| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Aussi, `wk pdfa3` signifie "exporte vers *au moins* PDF/A-3". Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. | +| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valeurs possibles :
  • true - Valeur par défaut. Toutes les formules sont recalculées
  • false - Ne pas recalculer les formules
    • | +| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Possible values: True/False | +| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | +| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Possible values: True/False | +| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Possible values: True/False | +| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Possible values: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Valeurs possibles : "normal", "nowrap", "pre", "pre-wrap" (par défaut), "pre-line", "break-spaces". | Le tableau suivant indique l'*option* disponible par *format* d'export : From efd3b745070130b18b3a4f1af0b292a708e755c3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:18 +0200 Subject: [PATCH 110/201] New translations wp-export-variable.md (Spanish) --- .../WritePro/commands/wp-export-variable.md | 44 +++++++++---------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md index 22cf5a3c10a7c8..76ca0b6b25da13 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Descripción -The **WP EXPORT VARIABLE** command exports the *wpDoc* 4D Write Pro object to the 4D *destination* variable in the specified *format*. +El comando **WP EXPORT VARIABLE** exporta el objeto *wpDoc* 4D Write Pro a la variable *destination* 4D en el *format* especificado. En *wpDoc*, pase el objeto 4D Write Pro que desea exportar. @@ -52,27 +52,27 @@ En el parámetro *format*, pase una constante del tema *4D Write Pro Constants* Pase un [objeto](# "Datos estructurados como un objeto nativo 4D") en *option* conteniendo los valores para definir las propiedades del documento exportado. Las siguientes propiedades están disponibles: -| Constante | Valor | Comentario | -| ------------------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | Nombre de dominio de host CID: dominio de host que se añadirá a las URL CID generadas incluyendo una "@" como separador. Disponible sólo cuando se utiliza el formato `wk mime html`. | -| wk embedded pictures | embeddedPictures | Sólo para exportación SVG. Establece si las imágenes se incrustan en el archivo .svg exportado cuando se llama a [WP EXPORT DOCUMENT](wp-export-document.md). Valores disponibles:
  • true (por defecto): las imágenes están incrustadas en el archivo .svg exportado
  • false: las imágenes se exportan en una carpeta llamada "filename\_images" en el nivel del archivo .svg exportado, "filename" siendo el nombre pasado al comando para el archivo, sin la extensión. Las imágenes no se integran, sino que se hace referencia a ellas en el archivo .svg.
    • Nota: si la carpeta ya existe, se vacía antes de exportar el archivo. Si no hay ninguna imagen en la página exportada, se elimina la carpeta | -| wk factur x | facturX | Sólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | -| wk files | Histórico | Sólo para exportación en PDF. Valor: colección de objetos, cada uno de los cuales describe un archivo que se integrará en el documento final (ver [wk files collection](./wp-export-document.md#wk-files-collection)). Esta funcionalidad sólo se admite en documentos PDF/A-3: cuando se utiliza el atributo `wk files`, se establece automáticamente la versión "PDF/A-3" (se ignora el atributo `wk pdfa version`). En caso de una exportación de Factur-X PDF (ver abajo), el primer objeto de la colección debe contener el archivo Factur-X xml. | -| wk google fonts tag | googleFontsTag | Sólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Valores posibles:
  • false (por defecto): no se añade ninguna regla de importación de google fonts.
  • true: añade la regla @import al archivo exportado. Útil si desea utilizar fuentes que no están disponibles por defecto en Windows o macOS.
    • **Nota:** esta propiedad está definida en false de forma predeterminada porque, cuando está activa, las fuentes de Google anulan las fuentes nativas y, por lo general, las fuentes nativas se muestran mejor en el navegador. | -| wk HTML pretty print | htmlPrettyPrint | El código HTML está formateado para facilitar su lectura. | -| wk max picture DPI | maxPictureDPI | Se utiliza para reducir imágenes a la resolución preferida. Para imágenes SVG en Windows, utilizado para la rasterización. Valores por defecto: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Valor máximo posible: 1440 | -| wk optimized for | optimizedFor | Define cómo se optimiza un documento exportado en función de su soporte. Valores posibles:
  • `wk print` (valor por defecto para `wk pdf` y `wk svg`) Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 300 (valor por defecto) y pueden convertirse a PNG si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 300 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el mejor formato para la impresión (*por ejemplo*, .tiff en lugar de .jpg)
  • `wk screen` (valor por defecto para `wk web page complete` y `wk mime html`). Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 192 (valor por defecto) y pueden convertirse a JPEG (imágenes opacas) o PNG (imágenes transparentes) si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 192 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el formato para la representación en pantalla.
    • **Nota:** los documentos exportados en formato `wk docx` siempre se optimizan para la impresión wk (se ignora la opción wk optimized for). | -| wk page index | pageIndex | Sólo para exportación SVG. Índice de la página a exportar a formato svg (por defecto es 1). El índice de páginas comienza en 1 para la primera página del documento. **Nota:** el índice de páginas es independiente de la numeración de páginas. | -| wk pdfa version | pdfaVersion | Exporta PDF conforme a una versión PDF/A. Para más información sobre las propiedades y versiones de PDF/A, consulte la [página PDF/A en Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Valores posibles:
  • `wk pdfa2`: exporta a la versión "PDF/A-2"
  • `wk pdfa3`: exporta a la versión "PDF/A-3"
  • **Nota:** en macOS, `wk pdfa2` puede exportar a PDF/A-2 o PDF/A-3 o superior, dependiendo de la implementación de la plataforma. Además, `wk pdfa3` significa "exporta a *al menos* PDF/A-3". En Windows, el archivo PDF de salida siempre será igual a la conformidad deseada. | -| wk recompute formulas | recomputeFormulas | Define si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles:
  • true - Valor por defecto. Se vuelven a calcular todas las fórmulas
  • false - No se vuelven a calcular las fórmulas
    • | -| wk visible background and anchored elements | visibleBackground | Muestra o exporta imágenes/color de fondo, imágenes ancladas y cuadros de texto (para mostrar, efecto visible sólo en modo de vista Página o Anidado). Valores posibles: True/False | -| wk visible empty images | visibleEmptyImages | Muestra o exporta un rectángulo negro por defecto para las imágenes que no se pueden cargar o calcular (imágenes vacías o imágenes en un formato no compatible). Valores posibles: True/False. Valor por defecto: True Si el valor es False, los elementos de imagen que falten no se mostrarán en absoluto aunque tengan bordes, ancho, alto o fondo; esto puede afectar al diseño de la página para imágenes en línea. | -| wk visible footers | visibleFooters | Muestra o exporta los pies de página (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | -| wk visible headers | visibleHeaders | Muestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | -| wk visible references | visibleReferences | Muestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False | -| wk whitespace | whitespace | Define el valor css "white-space" para el formato de exportación `wk mime html`. El estilo [white-space css](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) se aplica a los párrafos. Valores posibles: "normal", "nowrap", "pre", "pre-wrap" (por defecto), "pre-line", "break-spaces". | - -La siguiente tabla indica la *option* disponible por cada *format*: +| Constante | Valor | Comentario | +| ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | Nombre de dominio de host CID: dominio de host que se añadirá a las URL CID generadas incluyendo una "@" como separador. Disponible sólo cuando se utiliza el formato `wk mime html`. | +| wk embedded pictures | embeddedPictures | Sólo para exportación SVG. Establece si las imágenes se incrustan en el archivo .svg exportado cuando se llama a [WP EXPORT DOCUMENT](wp-export-document.md). Valores disponibles:
  • true (por defecto): las imágenes están incrustadas en el archivo .svg exportado
  • false: las imágenes se exportan en una carpeta llamada "filename\_images" en el nivel del archivo .svg exportado, "filename" siendo el nombre pasado al comando para el archivo, sin la extensión. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. Si no hay ninguna imagen en la página exportada, se elimina la carpeta | +| wk factur x | facturX | Sólo para exportación en PDF. Valor: objeto que configura una exportación PDF "Factur-X (ZUGFeRD)" (ver [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | +| wk files | Histórico | Sólo para exportación en PDF. Valor: colección de objetos, cada uno de los cuales describe un archivo que se integrará en el documento final (ver [wk files collection](./wp-export-document.md#wk-files-collection)). Esta funcionalidad sólo se admite en documentos PDF/A-3: cuando se utiliza el atributo `wk files`, se establece automáticamente la versión "PDF/A-3" (se ignora el atributo `wk pdfa version`). En caso de una exportación de Factur-X PDF (ver abajo), el primer objeto de la colección debe contener el archivo Factur-X xml. | +| wk google fonts tag | googleFontsTag | Sólo para exportación SVG. Define la regla de importación para fuentes google en el SVG exportado. Possible values:
  • false (default): No google fonts import rule is added.
  • true: añade la regla @import al archivo exportado. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | +| wk HTML pretty print | htmlPrettyPrint | El código HTML está formateado para facilitar su lectura. | +| wk max picture DPI | maxPictureDPI | Se utiliza para reducir imágenes a la resolución preferida. Para imágenes SVG en Windows, utilizado para la rasterización. Valores por defecto: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Valor máximo posible: 1440 | +| wk optimized for | optimizedFor | Define cómo se optimiza un documento exportado en función de su soporte. Valores posibles:
  • `wk print` (valor por defecto para `wk pdf` y `wk svg`) Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 300 (valor por defecto) y pueden convertirse a PNG si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 300 (sólo Windows). Si una imagen contiene más de un formato, se utiliza el mejor formato para la impresión (*por ejemplo*, .tiff en lugar de .jpg)
  • `wk screen` (valor por defecto para `wk web page complete` y `wk mime html`). Las imágenes de mapa de bits pueden reducirse utilizando los PPP definidos por `wk max picture DPI` o 192 (valor por defecto) y pueden convertirse a JPEG (imágenes opacas) o PNG (imágenes transparentes) si el códec no es compatible con el tipo de exportación. Las imágenes vectoriales se convierten a PNG utilizando los PPP definidos por `wk max picture DPI` o 192 (sólo Windows). If a picture contains more than one format, the format for screen rendering is used.
    • **Nota:** los documentos exportados en formato `wk docx` siempre se optimizan para la impresión wk (la opción wk optimized for se ignora). | +| wk page index | pageIndex | Sólo para exportación SVG. Índice de la página a exportar a formato svg (por defecto es 1). El índice de páginas comienza en 1 para la primera página del documento. **Nota:** el índice de páginas es independiente de la numeración de páginas. | +| wk pdfa version | pdfaVersion | Exporta PDF conforme a una versión PDF/A. Para más información sobre las propiedades y versiones de PDF/A, consulte la [página PDF/A en Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Valores posibles:
  • `wk pdfa2`: exporta a la versión "PDF/A-2"
  • `wk pdfa3`: exporta a la versión "PDF/A-3"
  • **Nota:** en macOS, `wk pdfa2` puede exportar a PDF/A-2 o PDF/A-3 o superior, dependiendo de la implementación de la plataforma. Además, `wk pdfa3` significa "exporta a *al menos* PDF/A-3". En Windows, el archivo PDF de salida siempre será igual a la conformidad deseada. | +| wk recompute formulas | recomputeFormulas | Define si las fórmulas deben volver a calcularse cuando se exportan. Valores posibles:
  • true - Valor por defecto. Se vuelven a calcular todas las fórmulas
  • false - No se vuelven a calcular las fórmulas
    • | +| wk visible background and anchored elements | visibleBackground | Muestra o exporta imágenes/color de fondo, imágenes ancladas y cuadros de texto (para mostrar, efecto visible sólo en modo de vista Página o Anidado). Valores posibles: True/False | +| wk visible empty images | visibleEmptyImages | Muestra o exporta un rectángulo negro por defecto para las imágenes que no se pueden cargar o calcular (imágenes vacías o imágenes en un formato no compatible). Valores posibles: True/False. Valor por defecto: True Si el valor es False, los elementos de imagen que falten no se mostrarán en absoluto aunque tengan bordes, ancho, alto o fondo; esto puede afectar al diseño de la página para imágenes en línea. | +| wk visible footers | visibleFooters | Muestra o exporta los pies de página (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | +| wk visible headers | visibleHeaders | Muestra o exporta los encabezados (para la visualización, efecto visible sólo en el modo vista Página). Valores posibles: True/False | +| wk visible references | visibleReferences | Muestra o exporta todas las expresiones 4D insertadas en el documento como referencias. Valores posibles: True/False | +| wk whitespace | whitespace | Define el valor css "white-space" para el formato de exportación `wk mime html`. El estilo [white-space css](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) se aplica a los párrafos. Valores posibles: "normal", "nowrap", "pre", "pre-wrap" (por defecto), "pre-line", "break-spaces". | + +The following table indicates the *option* available per export *format*: | | **wk 4wp** | **wk docx** | **wk mime html** | **wk pdf** | **wk web page html 4d** | **wk svg** | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | From 01caffdafc330d4c63e05d14faa314d4e02abee5 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:21 +0200 Subject: [PATCH 111/201] New translations wp-export-variable.md (Japanese) --- .../WritePro/commands/wp-export-variable.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md index 4817ba6934cdb2..0832de95bfc83d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md @@ -52,25 +52,25 @@ In the *format* parameter, pass a constant from the *4D Write Pro Constants* the *option* 引数には、書き出されるドキュメントのプロパティを定義する値を格納している[オブジェクト](# "ネイティブな4D オブジェクトとして構築されたデータ") を渡します。 次のプロパティを利用することができます: 次のプロパティを利用することができます: 次のプロパティを利用することができます: -| 定数 | 値 | 説明 | -| ------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。 wk mime html フォーマットが使用されている際にのみ使用可能です。 Available only when the `wk mime html` format is used. | -| wk embedded pictures | embeddedPictures | SVG 書き出し専用。 [WP EXPORT DOCUMENT](wp-export-document.md) を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。 Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | PDF 書き出しのみ。 Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | -| wk files | files | PDF 書き出しのみ。 Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](./wp-export-document.md#wk-files-collection)). This feature is only supported in PDF/A-3 documents: when the `wk files` attribute is used, the "PDF/A-3" version is automatically set (the `wk pdfa version` attribute is ignored). Factur-X PDF 書き出し(下記参照)の場合、コレクションの最初のオブジェクトにはFactur-X XML ファイルが格納されている必要があります。 | -| wk google fonts tag | googleFontsTag | SVG書き出し専用。 書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。 取り得る値:
  • false (デフォルト): google フォントの読み込みルールは何も追加されていません。
  • true: @import ルールを下記出されたファイルに追加します。 Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 | -| wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。 Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値: 300 (for wk optimized for \= wk print 時) 192 (for wk optimized for \= wk screen 時) 取り得る最大値: 1440 | -| wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 取り得る値:
  • `wk print` (`wk pdf` および `wk svg` のデフォルト値) ビットマップピクチャーは、`wk max picture DPI` で定義されたDPI または300 (デフォルト値) を使用してダウンスケールされる可能性があり、また書き出されるタイプに対してコーデックがサポートされていない場合にはPNG へと変換される可能性もあります。 ベクターのピクチャーは `wk max picture DPI` で定義されたDPI、または300 (Windows のみ)を使用してPNG へと変換されます。 If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | SVG書き出し専用。 SVG書き出し専用。 SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 | -| wk pdfa version | pdfaVersion | PDF/A バージョンに適合したPDF を書き出します。 PDF/A のプロパティおよびバージョンの詳細については、[Wikipedia のPDF/A のページ](https://ja.wikipedia.org/wiki/PDF/A) を参照してください。 Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". Windows 上では、出力されたPDF ファイルは常に指定されたバージョンと同じになります。 | -| wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。 Possible values:
  • true - Default value. All formulas are recomputed
  • false - Do not recompute formulas
    • | -| wk visible background and anchored elements | visibleBackground | 背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | -| wk visible empty images | visibleEmptyImages | 読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。 取り得る値: True/False. 取り得る値: True/False. デフォルト値: True 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。 | -| wk visible footers | visibleFooters | フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False | -| wk visible headers | visibleHeaders | ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | -| wk visible references | visibleReferences | ドキュメントに挿入されている4D 式を参照として表示または書き出しします。 取り得る値: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | +| 定数 | 値 | 説明 | +| ------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。 wk mime html フォーマットが使用されている際にのみ使用可能です。 Available only when the `wk mime html` format is used. | +| wk embedded pictures | embeddedPictures | SVG 書き出し専用。 [WP EXPORT DOCUMENT](wp-export-document.md) を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。 Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. ピクチャーは埋め込まれませんが、.svg ファイルから参照されます。
    • 注意: フォルダが既に存在する場合、ファイルが書き出される前にそのフォルダは空にされます。 If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | PDF 書き出しのみ。 Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | +| wk files | files | PDF 書き出しのみ。 Value: collection of objects, each of them describing a file to be embedded in the final document (see [wk files collection](./wp-export-document.md#wk-files-collection)). This feature is only supported in PDF/A-3 documents: when the `wk files` attribute is used, the "PDF/A-3" version is automatically set (the `wk pdfa version` attribute is ignored). Factur-X PDF 書き出し(下記参照)の場合、コレクションの最初のオブジェクトにはFactur-X XML ファイルが格納されている必要があります。 | +| wk google fonts tag | googleFontsTag | SVG書き出し専用。 書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。 取り得る値:
  • false (デフォルト): Google フォントの読み込みルールは何も追加されません。
  • true: 書き出されたファイルに@import ルールを追加します。 Windows またはmacOS において利用できないフォントを使用したい場合に有用です。
    • **注意:** このプロパティはデフォルトではFalse に設定されています。なぜなら読み込まれたGoogle フォントはネイティブのフォントを上書きしますが、一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされるからです。 | +| wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 | +| wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。 Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値: 300 (for wk optimized for \= wk print 時) 192 (for wk optimized for \= wk screen 時) 取り得る最大値: 1440 | +| wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 取り得る値:
  • `wk print` (`wk pdf` および `wk svg` のデフォルト値) ビットマップピクチャーは、`wk max picture DPI` で定義されたDPI または300 (デフォルト値) を使用してダウンスケールされる可能性があり、また書き出されるタイプに対してコーデックがサポートされていない場合にはPNG へと変換される可能性もあります。 ベクターのピクチャーは `wk max picture DPI` で定義されたDPI、または300 (Windows のみ)を使用してPNG へと変換されます。 If a picture contains more than one format, the best format for printing is used (*e.g.*, .tiff instead or .jpg)
  • `wk screen` (default value for `wk web page complete` and `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by `wk max picture DPI` or 192 (Windows only). 画像に複数のフォーマットが含まれている場合、スクリーンレンダリング用のフォーマットが使用されます。
    • **注意:** `wk docx` フォーマットで書き出されたドキュメントは、常にwk print 用に最適化されています(wk optimized for オプションは無視されます)。 | +| wk page index | pageIndex | SVG書き出し専用。 SVG書き出し専用。 SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 **注意:** ページインデックスはページナンバリングとは異なるものです。 | +| wk pdfa version | pdfaVersion | PDF/A バージョンに適合したPDF を書き出します。 PDF/A のプロパティおよびバージョンの詳細については、[Wikipedia のPDF/A のページ](https://ja.wikipedia.org/wiki/PDF/A) を参照してください。 Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". Windows 上では、出力されたPDF ファイルは常に指定されたバージョンと同じになります。 | +| wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。 Possible values:
  • true - Default value. All formulas are recomputed
  • false - Do not recompute formulas
    • | +| wk visible background and anchored elements | visibleBackground | 背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | +| wk visible empty images | visibleEmptyImages | 読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。 取り得る値: True/False. 取り得る値: True/False. デフォルト値: True 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。 | +| wk visible footers | visibleFooters | フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False | +| wk visible headers | visibleHeaders | ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False | +| wk visible references | visibleReferences | ドキュメントに挿入されている4D 式を参照として表示または書き出しします。 取り得る値: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | 以下の表は*format* 引数の各フォーマットごとに利用可能な*option* 引数のオプションをあらわしています: From e556c096fe6f6fc797b6f4c80f3fb681e07e2fbb Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:23 +0200 Subject: [PATCH 112/201] New translations wp-export-variable.md (Portuguese, Brazilian) --- .../WritePro/commands/wp-export-variable.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md index 90eb441c3f302c..db8472c40d9d5e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-export-variable.md @@ -52,25 +52,25 @@ In the *format* parameter, pass a constant from the *4D Write Pro Constants* the Pass an [object](# "Data structured as a native 4D object") in *option* containing the values to define the properties of the exported document. As seguintes propriedades estão disponíveis: -| Parâmetros | Valor | Comentário | -| ------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponível somente quando o formato `wk mime html` é usado. | -| wk embedded pictures | embeddedPictures | Somente para exportação SVG. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | -| wk factur x | facturX | Somente para exportação em PDF. Valor: objeto que configura uma exportação de PDF "Factur-X (ZUGFeRD)" (consulte [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | -| wk files | files | Somente para exportação em PDF. Valor: coleção de objetos, cada um deles descrevendo um arquivo a ser incorporado no documento final (consulte [wk files collection](./wp-export-document.md#wk-files-collection)). Este recurso só é suportado em documentos PDF/A-3: quando o atributo `wk files` é usado, a versão "PDF/A-3" é definida automaticamente (o atributo `wk pdfa version` é ignorado). In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | -| wk google fonts tag | googleFontsTag | Somente para exportação SVG. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Useful if you want to use fonts that are not available by default on Windows or macOS.
    • **Note:** This property is set to false by default because when enabled, Google fonts override native fonts, and native fonts are generally better rendered in the browser. | -| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | -| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | -| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 300 (apenas Windows). Se uma imagem contiver mais de um formato, será usado o melhor formato para impressão (*por exemplo*, .tiff em vez de .jpg)
  • `wk screen` (valor padrão para `wk web page complete` e `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 192 (apenas Windows). If a picture contains more than one format, the format for screen rendering is used.
    • **Note:** Documents exported in `wk docx` format are always optimized for wk print (wk optimized for option is ignored). | -| wk page index | pageIndex | Somente para exportação SVG. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Nota:** o índice de páginas é independente da numeração de páginas. | -| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". On Windows, the output PDF file will always be equal to the desired conformance. | -| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valores possíveis:
  • true - Valor padrão. All formulas are recomputed
  • false - Do not recompute formulas
    • | -| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Valores possíveis: True/False | -| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | -| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Valores possíveis: True/False | -| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Valores possíveis: True/False | -| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Valores possíveis: True/False | -| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | +| Parâmetros | Valor | Comentário | +| ------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| wk CID host domain name | cidHostDomain | CID host domain name: host domain that will be added to generated CID URLs including an '@' as separator. Disponível somente quando o formato `wk mime html` é usado. | +| wk embedded pictures | embeddedPictures | Somente para exportação SVG. Sets whether pictures are embedded in the exported .svg file when you call [WP EXPORT DOCUMENT](wp-export-document.md). Available values:
  • true (default): Pictures are embedded in the exported .svg file
  • false: Pictures are exported in a folder called "filename\_images" at the level of the exported .svg file, "filename" being the name passed to the command for the file, without the extension. The pictures are not embedded, but referenced in the .svg file.
    • Note: If the folder already exists, it is emptied before the file is exported. If there is no image on the exported page, the folder is deleted | +| wk factur x | facturX | Somente para exportação em PDF. Valor: objeto que configura uma exportação de PDF "Factur-X (ZUGFeRD)" (consulte [wk factur x object](./wp-export-document.md#wk-factur-x-object)). | +| wk files | files | Somente para exportação em PDF. Valor: coleção de objetos, cada um deles descrevendo um arquivo a ser incorporado no documento final (consulte [wk files collection](./wp-export-document.md#wk-files-collection)). Este recurso só é suportado em documentos PDF/A-3: quando o atributo `wk files` é usado, a versão "PDF/A-3" é definida automaticamente (o atributo `wk pdfa version` é ignorado). In case of a Factur-X PDF export (see below), the first object of the collection must contain the Factur-X xml file. | +| wk google fonts tag | googleFontsTag | Somente para exportação SVG. Sets the import rule for google fonts in the exported SVG. Possible values:
  • false (default): No google fonts import rule is added.
  • true: Adds the @import rule to the exported file. Útil se você quiser usar fontes que não estão disponíveis por padrão no Windows ou macOS.
    • **Nota:** Essa propriedade é definida como falso por padrão porque quando habilitada As fontes do Google substituem fontes nativas, e as fontes nativas são geralmente melhor renderizadas no navegador. | +| wk HTML pretty print | htmlPrettyPrint | HTML code is formatted to be easier to read. | +| wk max picture DPI | maxPictureDPI | Used for resampling (reducing) images to preferred resolution. For SVG images in Windows, used for rasterization. Default values: 300 (for wk optimized for \= wk print) 192 (for wk optimized for \= wk screen) Maximum possible value: 1440 | +| wk optimized for | optimizedFor | Defines how an exported document is optimized based on its intended medium. Possible values:
  • `wk print` (default value for `wk pdf` and `wk svg`) Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 300 (apenas Windows). Se uma imagem contiver mais de um formato, será usado o melhor formato para impressão (*por exemplo*, .tiff em vez de .jpg)
  • `wk screen` (valor padrão para `wk web page complete` e `wk mime html`). Bitmap pictures may be downscaled using the DPI defined by `wk max picture DPI` or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Imagens vetoriais são convertidas para PNG usando o DPI definido por `wk max image DPI` ou 192 (apenas Windows). Se uma imagem contiver mais de um formato, será utilizado o formato para a renderização de tela. U
    • **Nota:** Documentos exportados em formato `wk docx` são sempre otimizados para impressão wk (wk otimizado para opção é ignorado). | +| wk page index | pageIndex | Somente para exportação SVG. Index of the page to export to svg format (default is 1). Page index starts at 1 for the first page of the document. **Nota:** o índice de páginas é independente da numeração de páginas. | +| wk pdfa version | pdfaVersion | Exports PDF with conformance to a PDF/A version. For more information on PDF/A properties and versions, please refer to the [PDF/A page on Wikipedia](https://en.wikipedia.org/wiki/PDF/A). Possible values:
  • `wk pdfa2`: Exports to version "PDF/A-2"
  • `wk pdfa3`: Exports to version "PDF/A-3"
  • **Note:** On macOS, `wk pdfa2` may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, `wk pdfa3` means "exports to *at least* PDF/A-3". On Windows, the output PDF file will always be equal to the desired conformance. | +| wk recompute formulas | recomputeFormulas | Defines if formulas must be recomputed when exported. Valores possíveis:
  • true - Valor padrão. All formulas are recomputed
  • false - Do not recompute formulas
    • | +| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Valores possíveis: True/False | +| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. | +| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Valores possíveis: True/False | +| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Valores possíveis: True/False | +| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Valores possíveis: True/False | +| wk whitespace | whitespace | Sets the "white-space" css value for `wk mime html` export format. The [white-space css style](https://developer.mozilla.org/en-US/docs/Web/CSS/white-space) is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". | A tabela a seguir indica a *option* disponível por *format* de exportação: From 0ea3633d632fe7761e42350906e38c2d44bf6ef0 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:24 +0200 Subject: [PATCH 113/201] New translations wp-get-attributes.md (French) --- .../version-21/WritePro/commands/wp-get-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md index 3541af254aa8e2..6dc3b884b3c359 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Description -The **WP Get attributes** command returns the value of any attribute in a 4D Write Pro range, header, body, footer, table, or document. This command gives you access to any kind of 4D Write Pro internal attributes: character, paragraph, document, table, or image. +La commande **WP Get attributes** renvoie la valeur de n'importe quel attribut de plage, en-tête, corps, pied de page, tableau ou document de 4D Write Pro. Cette commande vous donne accès à tout type d'attribut interne 4D Write Pro : caractère, paragraphe, document, tableau ou image. In *targetObj*, you can pass: From e9eccce665cf1f9e01b0931718bc7d1439866101 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:26 +0200 Subject: [PATCH 114/201] New translations wp-get-attributes.md (Spanish) --- .../version-21/WritePro/commands/wp-get-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md index 7daedb273fe4d2..fa6360bcb95c9e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Descripción -El comando **WP Get attributes** devuelve el valor de cualquier atributo en un rango 4D Write Pro, encabezado, cuerpo, pie de página, tabla o documento. Este comando le da acceso a cualquier tipo de atributos internos 4D Write Pro: carácter, párrafo, documento, tabla o imagen. +El comando **WP Get attributes** devuelve el valor de todo atributo en un rango 4D Write Pro, encabezado, cuerpo, pie de página, tabla o documento. This command gives you access to any kind of 4D Write Pro internal attributes: character, paragraph, document, table, or image. En *targetObj*, puede pasar: From d87332a69d37e60e49d22c4ce6140874736e8443 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:28 +0200 Subject: [PATCH 115/201] New translations wp-get-attributes.md (Japanese) --- .../version-21/WritePro/commands/wp-get-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md index 00127fc47458f2..b7637d2c7a8b8b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## 説明 -**WP Get attributes** コマンドは、4D Write Proレンジ、ヘッダー/フッター/本文/表、あるいはドキュメント内のあらゆる属性の値を返します。 このコマンドを使用すると4D Write Proのどのような内部属性(文字、段落、ドキュメント、表組み、画像など)にもアクセスすることができます。 +**WP Get attributes** コマンドは、4D Write Pro レンジ、ヘッダー、本文、フッター、表、あるいはドキュメント内の、任意の属性の値を返します。 このコマンドを使用することで、4D Write Pro の次のようなあらゆる内部属性にアクセスすることができます: 文字、段落、ドキュメント、表、画像。 *targetObj* 引数には、以下のいずれかを渡すことができます: From 7a99bfe32fe4a62a51f2331954a373c195b29ac7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:30 +0200 Subject: [PATCH 116/201] New translations wp-get-attributes.md (Portuguese, Brazilian) --- .../version-21/WritePro/commands/wp-get-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md index 76cc6d196ac60f..e1394446138fd5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-get-attributes.md @@ -20,7 +20,7 @@ displayed_sidebar: docs ## Descrição -The **WP Get attributes** command returns the value of any attribute in a 4D Write Pro range, header, body, footer, table, or document. This command gives you access to any kind of 4D Write Pro internal attributes: character, paragraph, document, table, or image. +O comando **WP Get attributes** retorna o valor de qualquer atributo em um intervalo 4D de escrita Pro, cabeçalho, corpo, rodapé, tabela ou documento. Este comando lhe dá acesso a qualquer tipo de atributo interno da 4D Write Pro: caractere, parágrafo, tabela ou imagem. Em *targetObj*, você pode passar: From 016c06443092419e7cfd1a55918674198e2488fd Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:39 +0200 Subject: [PATCH 117/201] New translations wp-insert-break.md (Portuguese, Brazilian) --- .../version-21/WritePro/commands/wp-insert-break.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-break.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-break.md index ae118bb3c8a11f..8279b68a3320eb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-break.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-break.md @@ -4,7 +4,7 @@ title: WP Insert break displayed_sidebar: docs --- -**WP Insert break** ( *targetObj* ; *breakType* ; *mode* {; *rangeUpdate*} ) : Object +**WP Insert break** ( *targetObj* ; *breakType* ; *mode* {; *rangeUpdate*} ): Object From 0ed538642590d2f8d42af8f9e477d635b89d7214 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:46 +0200 Subject: [PATCH 118/201] New translations wp-insert-formula.md (French) --- .../version-21/WritePro/commands/wp-insert-formula.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md index 9ee8c596329611..2452c695e5db35 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md @@ -26,7 +26,7 @@ Dans le paramètre *targetObj*, vous pouvez passer : - une plage, ou - un élément (tableau / ligne / cellule(s) / paragraphe / corps / en-tête / pied de page / section / / sous-section / image en ligne), ou -- un document 4D Write Pro. +- a 4D Write Pro document. Dans le paramètre *formule*, passez la formule 4D à évaluer. Vous pouvez passer : From 93c0fb892da7f3ff3a3af3836b33f622ae35a99c Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:47 +0200 Subject: [PATCH 119/201] New translations wp-insert-formula.md (Spanish) --- .../version-21/WritePro/commands/wp-insert-formula.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md index 9d10fa7eb81856..aabd860a7a9bec 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md @@ -4,7 +4,7 @@ title: WP Insert formula displayed_sidebar: docs --- -**WP Insert formula** ( *targetObj* ; *formula* ; *mode* {; *rangeUpdate*} ) : Object +**WP Insert formula** ( *targetObj* ; *formula* ; *mode* {; *rangeUpdate*} ): Object From c40d5e50e2f03ead786e9966bebb9857c321e53f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:50 +0200 Subject: [PATCH 120/201] New translations wp-insert-formula.md (Portuguese, Brazilian) --- .../WritePro/commands/wp-insert-formula.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md index 9457bea1279a66..0ad5602bcedabb 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-formula.md @@ -10,7 +10,7 @@ displayed_sidebar: docs | Parâmetro | Tipo | | Descrição | | ----------- | ------ | --------------------------- | ------------------------------------------------------------------ | -| targetObj | Object | → | Intervalo ou elemento ou documento 4D Write Pro | +| targetObj | Object | → | Range or element or 4D Write Pro document | | formula | Object | → | Objeto de fórmula OU Objeto com propriedades de fórmula e nome | | mode | Number | → | Modo de inserção | | rangeUpdate | Number | → | Inclui ou exclui o conteúdo inserido dentro do intervalo | @@ -42,18 +42,18 @@ Quando você usa um objeto com uma fórmula *name*, esse nome é exibido no docu No parâmetro *mode*, passe uma das seguintes constantes para indicar o modo de inserção a ser usado: -| Parâmetros | Tipo | Valor | Comentário | -| ---------- | ------- | ----- | ---------------------------------- | -| wk append | Integer | 2 | Inserir conteúdo no final do alvo | -| wk prepend | Integer | 1 | Inserir conteúdo no início do alvo | -| wk replace | Integer | 0 | Substituir o conteúdo de destino | +| Parâmetros | Tipo | Valor | Comentário | +| ---------- | ------- | ----- | -------------------------------------- | +| wk append | Integer | 2 | Insert contents at end of target | +| wk prepend | Integer | 1 | Insert contents at beginning of target | +| wk replace | Integer | 0 | Replace target contents | - Se *targetObj* for um intervalo, você poderá usar o parâmetro opcional *rangeUpdate* para passar uma das seguintes constantes e especificar se a *fórmula* inserida está ou não incluída no intervalo resultante: -| Parâmetros | Tipo | Valor | Comentário | -| --------------------- | ------- | ----- | ------------------------------------------------------------------------------ | -| wk exclude from range | Integer | 1 | Conteúdos inseridos não incluídos no intervalo atualizado | -| wk include in range | Integer | 0 | Conteúdo inserido incluído no intervalo atualizado (padrão) | +| Parâmetros | Tipo | Valor | Comentário | +| --------------------- | ------- | ----- | ------------------------------------------------------------------------ | +| wk exclude from range | Integer | 1 | Inserted contents not included in updated range | +| wk include in range | Integer | 0 | Inserted contents included in updated range (default) | Se você não passar um parâmetro *rangeUpdate*, por padrão a *fórmula* inserida será incluída no intervalo resultante. From b38550d1224e673a7869bcc1d3b43a33a1b57ea3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:52 +0200 Subject: [PATCH 121/201] New translations wp-insert-picture.md (French) --- .../version-21/WritePro/commands/wp-insert-picture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md index d0d90de82a5262..55a80c8ca85900 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md @@ -21,7 +21,7 @@ displayed_sidebar: docs ## Description -La commande **WP Insert picture** insère *picture* ou *pictureFileObj* dans le *targetObj* spécifié en fonction des paramètres *mode* d'insertion et *rangeUpdate*, et retourne une référence à l'élément picture. L'image sera insérée comme un caractère dans le *targetObj*. +La commande **WP Insert picture** insère *picture* ou *pictureFileObj* dans le *targetObj* spécifié en fonction des paramètres *mode* d'insertion et *rangeUpdate*, et renvoie une référence à l'élément image. L'image sera insérée en tant que caractère dans *targetObj*. In *targetObj*, you can pass: From 52509ec2045dfd5909cb3c630f0db1fe7de1aa4a Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:55 +0200 Subject: [PATCH 122/201] New translations wp-insert-picture.md (Japanese) --- .../version-21/WritePro/commands/wp-insert-picture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md index 87612c74082c6b..602782c26b45ce 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md @@ -21,7 +21,7 @@ displayed_sidebar: docs ## 説明 -**WP Insert picture** コマンドは、指定した挿入モード*mode* とレンジ更新モード*rangeUpdate* に従って、*picture* または*pictureFileObj* のピクチャーを*targetObj* で指定したレンジに挿入し、ピクチャー要素への参照を返します。ピクチャーは文字として*targetObj* に挿入されます。 +**WP Insert picture** コマンドは、指定した挿入モード*mode* とレンジ更新モード*rangeUpdate* に従って、*picture* または*pictureFileObj* のピクチャーを*targetObj* で指定したレンジに挿入し、ピクチャー要素への参照を返します。 ピクチャーは文字として*targetObj* に挿入されます。 *targetObj* 引数には、以下のいずれかを渡すことができます: From 9224f052eabbafc02b636df067ba66f3997180d3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:56 +0200 Subject: [PATCH 123/201] New translations wp-insert-picture.md (Portuguese, Brazilian) --- .../WritePro/commands/wp-insert-picture.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md index 45485c2be0396f..bfd49a82779419 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-insert-picture.md @@ -10,20 +10,20 @@ displayed_sidebar: docs | Parâmetro | Tipo | | Descrição | | -------------- | ------------------------ | --------------------------- | ------------------------------------------------------------------------- | -| targetObj | Object | → | Intervalo ou elemento ou documento 4D Write Pro | +| targetObj | Object | → | Range or element or 4D Write Pro document | | picture | Imagem | → | Campo de imagem ou variável, ou caminho para o arquivo de imagem no disco | | pictureFileObj | 4D. File | → | Um objeto de arquivo representando um arquivo de imagem. | | mode | Integer | → | Modo de inserção | | rangeUpdate | Integer | → | Modo de atualização de intervalo | -| Resultado | Object | ← | Objeto referenciando a imagem | +| Resultado | Object | ← | Object referencing the picture | ## Descrição -O comando **WP Insert picture** insere uma *imagem* ou um *pictureFileObj* no *targetObj* especificado de acordo com os parâmetros *modo* de inserção passada e *rangeUpdate*, e retorna uma referência ao elemento imagem. A imagem será inserida como um caractere no *targetObj*. +O comando **WP Insert picture** insere uma *picture* ou um *pictureFileObj* no *targetObj* de acordo com os parâmetros *mode* e *rangeUpdate* , e retorna uma referência ao elemento imagem. A imagem será inserida como um caractere no *targetObj*. -Em *targetObj*, pode-se passar: +Em *targetObj*, você pode passar: - Um intervalo - Um elemento (tabela / linha / parágrafo / corpo / cabeçalho / rodapé / imagem em linha / seção / subseção) @@ -34,18 +34,18 @@ Para o segundo parâmetro, você também pode passar: - Em *picture*: - Um campo de imagem ou variável - Uma string que contém um caminho para um arquivo de imagem armazenado no disco, na sintaxe do sistema. - Se você usar uma string, você poderá passar um nome completo ou um nome de caminho relativo ao arquivo de estrutura do banco de dados. Você também pode passar um nome de arquivo, neste caso o arquivo deve estar localizado ao lado do arquivo de estrutura de banco de dados. Se você passar um nome de arquivo, você deve indicar a extensão do arquivo. + Se você usar uma string, você poderá passar um nome completo ou um nome de caminho relativo ao arquivo de estrutura do banco de dados. You can also pass a file name, in which case the file must be located next to the database structure file. Se você passar um nome de arquivo, você deve indicar a extensão do arquivo. - Em *pictureFileObj*: um objeto `File` que representa um arquivo imagem. -Qualquer formato imagem [suportado por 4D](../../FormEditor/pictures.md#native-formats-supported) pode ser usado. Você pode obter a lista de formatos de imagens disponíveis usando o comando [PICTURE CODEC LIST](../../commands-legacy/picture-codec-list.md). Se a imagem encapsular vários formatos (codecs), 4D Write Pro apenas mantém um formato para exibição e um formato para impressão (se diferente) no documento; os "melhores" formatos são selecionados automaticamente. +Qualquer formato imagem [suportado por 4D](../../FormEditor/pictures.md#native-formats-supported) pode ser usado. Você pode obter a lista de formatos de imagens disponíveis usando o comando [PICTURE CODEC LIST](../../commands-legacy/picture-codec-list.md). If the picture encapsulates several formats (codecs), 4D Write Pro only keeps one format for display and one format for printing (if different) in the document; the "best" formats are automatically selected. No parâmetro *modo*, passe uma das seguintes constantes para indicar o modo de inserção a ser usado na imagem no documento: -| Parâmetros | Tipo | Valor | Comentário | -| ---------- | ------- | ----- | ---------------------------------- | -| wk append | Integer | 2 | Inserir conteúdo no final do alvo | -| wk prepend | Integer | 1 | Inserir conteúdo no início do alvo | -| wk replace | Integer | 0 | Replace target contents | +| Parâmetros | Tipo | Valor | Comentário | +| ---------- | ------- | ----- | -------------------------------------- | +| wk append | Integer | 2 | Insert contents at end of target | +| wk prepend | Integer | 1 | Insert contents at beginning of target | +| wk replace | Integer | 0 | Replace target contents | Se *targetObj* for um intervalo, você poderá usar opcionalmente o parâmetro *rangeUpdate* para passar uma das seguintes constantes para especificar se a imagem inserida está ou não incluída no intervalo resultante: From f5fe455911cce295539371c35b4355d4402a888f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:27:58 +0200 Subject: [PATCH 124/201] New translations wp-reset-attributes.md (French) --- .../version-21/WritePro/commands/wp-reset-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md index 22f732e3cd6d70..0edc96ed790d78 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Description -La commande **WP RESET ATTRIBUTES** permet de réinitialiser la valeur d'un ou plusieurs attributs dans la plage, l'élément ou le document passé en paramètre. Cette commande permet de supprimer tout type d'attribut interne à 4D Write Pro : caractère, paragraphe, document, tableau ou image. Vous pouvez passer le nom de l'attribut à réinitialiser dans *attribName* ou vous pouvez passer une collection d'attributs dans *attribColl* pour réinitialiser plusieurs attributs à la fois. +La commande **WP RESET ATTRIBUTES** permet de réinitialiser la valeur d'un ou plusieurs attributs dans la plage, l'élément ou le document passé en paramètre. Cette commande permet de supprimer tout type d'attribut interne de 4D Write Pro : caractère, paragraphe, document, tableau ou image. Vous pouvez passer le nom de l'attribut à réinitialiser dans *attribName* ou vous pouvez passer une collection d'attributs dans *attribColl* pour réinitialiser plusieurs attributs à la fois. > Dans le cas d'une section ou d'une sous-section, l'objet *sectionOrSubsection* peut être transmis seul et tous les attributs sont réinitialisés en une seule fois. From b561eac576621f8aa0cb9d0bda2ed75740ecacad Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:00 +0200 Subject: [PATCH 125/201] New translations wp-reset-attributes.md (Spanish) --- .../version-21/WritePro/commands/wp-reset-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md index 065ee94c6e6f5f..e3c95cabba2413 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Descripción -El comando **WP RESET ATTRIBUTES** le permite restablecer el valor de uno o más atributos en el rango, elemento o documento pasado como parámetro. Este comando puede eliminar cualquier tipo de atributo interno 4D Write Pro: carácter, párrafo, documento, tabla o imagen. Puede pasar el nombre del atributo a restablecer en *attribName* o puede pasar una colección de atributos en *attribColl* para restablecer varios atributos a la vez. +El comando **WP RESET ATTRIBUTES** le permite restablecer el valor de uno o más atributos en el rango, elemento o documento pasado como parámetro. This command can remove any kind of 4D Write Pro internal attribute: character, paragraph, document, table, or image. Puede pasar el nombre del atributo a restablecer en *attribName* o puede pasar una colección de atributos en *attribColl* para restablecer varios atributos a la vez. > En el caso de una sección o subsección, el objeto *sectionOrSubsection* puede pasarse solo y todos los atributos se restablecen a la vez. From a747edcc9f407dddd2d04536e1e80dfdeb763b26 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:01 +0200 Subject: [PATCH 126/201] New translations wp-reset-attributes.md (Japanese) --- .../version-21/WritePro/commands/wp-reset-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md index 368b1df0e0f68d..a12ae76803aa41 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## 説明 -**WP RESET ATTRIBUTES** コマンドは引数として渡されたレンジ、要素、またはドキュメントの1つ以上の値をリセットすることができます。このコマンドは任意の4D Write Pro 内部属性(文字、段落、ドキュメント、表または画像)を削除することができます。 リセットしたい属性の名前を*attribName* 引数に渡すか、あるいは*attribColl* 引数に属性名のコレクションを渡すことで、複数の属性を一度にリセットすることもできます。 +**WP RESET ATTRIBUTES** コマンドは、 引数として渡されたレンジ、要素、ドキュメント内の一つ以上の属性の値をリセットすることができます。 このコマンドを使用することで、4D Write Pro の次のようなあらゆる内部属性を削除することができます: 文字、段落、ドキュメント、表、画像。 リセットしたい属性の名前を*attribName* 引数に渡すか、あるいは*attribColl* 引数に属性名のコレクションを渡すことで、複数の属性を一度にリセットすることもできます。 > セクションかサブセクションの場合、*sectionOrSubsection* 引数単体を渡すだけで、すべての属性は一度にリセットされます。 From c5bced4468bdb8b662b8d7f458d26c2386ba6960 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:03 +0200 Subject: [PATCH 127/201] New translations wp-reset-attributes.md (Portuguese, Brazilian) --- .../version-21/WritePro/commands/wp-reset-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md index 708890267fbbd2..641433ba6ee148 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-reset-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Descrição -The **WP RESET ATTRIBUTES** command allows you to reset the value of one or more attributes in the range, element, or document passed as parameter. This command can remove any kind of 4D Write Pro internal attribute: character, paragraph, document, table, or image. You can pass the attribute name to be reset in *attribName* or you can pass a collection of attributes in *attribColl* to reset multiple attributes at once. +O comando **WP RESET ATTRIBUTES** permite que você reinicie o valor de um ou mais atributos no intervalo, elemento ou documento passado como parâmetro. Este comando pode remover qualquer tipo de atributo interno 4D Write Pro: caractere, parágrafo, tabela ou imagem. You can pass the attribute name to be reset in *attribName* or you can pass a collection of attributes in *attribColl* to reset multiple attributes at once. > In the case of a section or a subsection, the *sectionOrSubsection* object can be passed alone and all the attributes are reset at once. From fe5db512abddaabdc9e11950bbcc5554db6a875f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:05 +0200 Subject: [PATCH 128/201] New translations wp-set-attributes.md (French) --- .../version-21/WritePro/commands/wp-set-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md index 43b92d746dfcbe..8c4efbe25e2be8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Description -La commande **WP SET ATTRIBUTES** permet de définir la valeur de n'importe quel attribut d'une plage, d'un élément, d'un document. Cette commande permet d'accéder à n'importe quel type d'attribut interne à 4D Write Pro : caractère, paragraphe, document, tableau ou image. +La commande **WP SET ATTRIBUTES** vous permet de définir la valeur d'un attribut de plage, élément ou document. Cette commande vous donne accès à tout type d'attribut interne 4D Write Pro : caractère, paragraphe, document, tableau ou image. Dans *targetObj*, vous pouvez passer : From bf746c39428c87261d8bbc4948aa4be30940f56d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:07 +0200 Subject: [PATCH 129/201] New translations wp-set-attributes.md (Spanish) --- .../version-21/WritePro/commands/wp-set-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md index 0d6687e596cd93..997c3cd500b662 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Descripción -El comando **WP SET ATTRIBUTES** le permite definir el valor de todo atributo en un rango, elemento, documento. Este comando le da acceso a todo de atributo interno 4D Write Pro: carácter, párrafo, documento, tabla o imagen. +El comando **WP SET ATTRIBUTES** le permite definir el valor de cualquier atributo en un rango, elemento, documento. This command gives you access to any kind of 4D Write Pro internal attribute: character, paragraph, document, table, or image. En *targetObj*, puede pasar: From e7fd62dc25e731f6c578ecf8bb035b52092b0f43 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:08 +0200 Subject: [PATCH 130/201] New translations wp-set-attributes.md (Japanese) --- .../version-21/WritePro/commands/wp-set-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md index 70c4e79cbb1085..c4458458422cee 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## 説明 -**WP SET ATTRIBUTES** コマンドを使うとレンジ、要素、あるいはドキュメントのあらゆる属性の値を設定することができます。このコマンドを使ってあらゆる4D Write Pro内部の属性(文字、段落、ドキュメント、表組、またはピクチャー)にアクセスすることができます。 +**WP SET ATTRIBUTES** コマンドは、引数として渡されたレンジ、要素、ドキュメント内の一つ以上の属性の値を設定することができます。 このコマンドを使用することで、4D Write Pro の次のようなあらゆる内部属性にアクセスすることができます: 文字、段落、ドキュメント、表、画像。 *targetObj* 引数には、以下のいずれかを渡すことができます : From c3dda3889960d20b471e75682580b54acbf70813 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:10 +0200 Subject: [PATCH 131/201] New translations wp-set-attributes.md (Portuguese, Brazilian) --- .../version-21/WritePro/commands/wp-set-attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md index bf002467fd69a2..8d0d5c0789c230 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/commands/wp-set-attributes.md @@ -19,7 +19,7 @@ displayed_sidebar: docs ## Descrição -The **WP SET ATTRIBUTES** command allows you to set the value of any attribute in a range, element, document. This command gives you access to any kind of 4D Write Pro internal attribute: character, paragraph, document, table, or image. +O comando **WP SET ATTRIBUTES** permite que você reinicie o valor de um ou mais atributos no intervalo, elemento ou documento passado como parâmetro. Este comando lhe dá acesso a qualquer tipo de atributo interno da 4D Write Pro: caractere, parágrafo, tabela ou imagem. Em *targetObj*, você pode passar: From c036143b833f1507526fd00bca4a25708133fdb9 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:17 +0200 Subject: [PATCH 132/201] New translations managing-formulas.md (French) --- .../version-21/WritePro/managing-formulas.md | 54 +++++++++---------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md index b86e2a3322962d..a92367ea1b8081 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md @@ -54,22 +54,22 @@ Vous souhaitez remplacer la sélection d'une zone de 4D Write Pro par le contenu You can insert special expressions related to document attributes in any document area (body, header, footer) using the [WP Insert formula](commands/wp-insert-formula.md) command. Within a formula, a formula context object is automatically exposed. You can use the properties of this object through [**This**](../commands/this.md): -| Propriétés | Type | Description | -| ------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [This](../commands/this.md).title | Text | Titre défini dans l'attribut wk title | -| [This](../commands/this.md).author | Text | Auteur défini dans l'attribut wk author | -| [This](../commands/this.md).subject | Text | Subject defined in wk subject attribute | -| [This](../commands/this.md).company | Text | Company defined in wk company attribute | -| [This](../commands/this.md).notes | Text | Notes defined in wk notes attribute | -| [This](../commands/this.md).dateCreation | Date | Date creation defined in wk date creation attribute | -| [This](../commands/this.md).dateModified | Date | Date modified defined in wk date modified attribute | -| [This](../commands/this.md).pageNumber (\*) | Number | Page number as it is defined:
  • - From the document start (default) or
  • - From the section page start if it is defined by section page start.
    • This formula is always dynamic; it is not affected by the [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) command. | -| [This](../commands/this.md).pageCount (\*) | Number | Page count: total count of pages.
    This formula is always dynamic; it is not affected by the [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) command. | -| [This](../commands/this.md).document | Object | Document 4D Write Pro | -| [This](../commands/this.md).data | Object | Data context of the 4D Write Pro document set by [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | -| [This](../commands/this.md).sectionIndex | Number | The Index of the section in the 4D Write Pro document starting from 1 | -| [This](../commands/this.md).pageIndex | Number | The actual page number in the 4D Write Pro document starting from 1 (regardless of the section page numbers) | -| [This](../commands/this.md).sectionName | String | The name that the user gives to the section | +| Propriétés | Type | Description | +| ------------------------------------------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [This](../commands/this.md).title | Text | Titre défini dans l'attribut wk title | +| [This](../commands/this.md).author | Text | Auteur défini dans l'attribut wk author | +| [This](../commands/this.md).subject | Text | Subject defined in wk subject attribute | +| [This](../commands/this.md).company | Text | Company defined in wk company attribute | +| [This](../commands/this.md).notes | Text | Notes defined in wk notes attribute | +| [This](../commands/this.md).dateCreation | Date | Date creation defined in wk date creation attribute | +| [This](../commands/this.md).dateModified | Date | Date modified defined in wk date modified attribute | +| [This](../commands/this.md).pageNumber (\*) | Number | Numéro de page tel qu'il est défini
  • : - à partir du début du document (par défaut) ou
  • - à partir du début de la page de la section s'il est défini par début de page de section.
    • Cette formule est toujours dynamique ; elle n'est pas affectée par la commande [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).pageCount (\*) | Number | Nombre de pages : nombre total de pages.
    Cette formule est toujours dynamique ; elle n'est pas affectée par la commande [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).document | Object | Document 4D Write Pro | +| [This](../commands/this.md).data | Object | Data context of the 4D Write Pro document set by [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | +| [This](../commands/this.md).sectionIndex | Number | The Index of the section in the 4D Write Pro document starting from 1 | +| [This](../commands/this.md).pageIndex | Number | The actual page number in the 4D Write Pro document starting from 1 (regardless of the section page numbers) | +| [This](../commands/this.md).sectionName | String | The name that the user gives to the section | :::note @@ -95,17 +95,17 @@ Par exemple, pour insérer le numéro de page dans la zone de pied de page : When used in a formula within the table, the **This** keyword gives access to different data according to the context: -| **Context** | **Expression** | **Type** | **Returns** | -| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Anywhere | [This](../commands/this.md).table | Object | Current table | -| | [This](../commands/this.md).row | Object | Current table row element | -| | [This](../commands/this.md).rowIndex | Number | Index of the current row, starting from 1 | -| When a datasource has been defined for the table | [This](../commands/this.md).table.dataSource | Objet (formula) | Datasource as a formula | -| | [This](../commands/this.md).tableData | Collection or Entity selection (usually) | Evaluated table.dataSource | -| In each data row when a table datasource returns a collection or an entity selection | [This](../commands/this.md).item.xxx | Tous | Mapped to each item of the table datasource collection or entity selection, for example **This.item.firstName** if the associated entity has the *firstName* attribute | -| | [This](../commands/this.md).itemIndex | Number | Index of the current item in the collection or entity selection, starting from 0 | -| In any row (except header rows) when a table datasource returns a collection or an entity selection | [This](../commands/this.md).previousItems | Collection or Entity selection | Items displayed on the pages before the bottom carry over row (if any) or before the row of the expression, including the page where is displayed the row containing the expression.
    This expression returns the same type of value as the **This.tableData** expression. | -| In a break row | [This](../commands/this.md).breakItems | Collection or Entity selection | Items of the collection or entity selection displayed in the rows between:
    • the current break row and the previous break row of the same level (or the start of the table) if the break row(s) are displayed after the data row.
    • the current break and the next break row of the same level (or the end of the table) if the break row(s) are displayed before the data row.
    | +| **Context** | **Expression** | **Type** | **Returns** | +| ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Anywhere | [This](../commands/this.md).table | Object | Current table | +| | [This](../commands/this.md).row | Object | Current table row element | +| | [This](../commands/this.md).rowIndex | Number | Index of the current row, starting from 1 | +| When a datasource has been defined for the table | [This](../commands/this.md).table.dataSource | Objet (formula) | Datasource as a formula | +| | [This](../commands/this.md).tableData | Collection or Entity selection (usually) | Evaluated table.dataSource | +| In each data row when a table datasource returns a collection or an entity selection | [This](../commands/this.md).item.xxx | Tous | Mapped to each item of the table datasource collection or entity selection, for example **This.item.firstName** if the associated entity has the *firstName* attribute | +| | [This](../commands/this.md).itemIndex | Number | Index of the current item in the collection or entity selection, starting from 0 | +| In any row (except header rows) when a table datasource returns a collection or an entity selection | [This](../commands/this.md).previousItems | Collection or Entity selection | Items displayed on the pages before the bottom carry over row (if any) or before the row of the expression, including the page where is displayed the row containing the expression.
    This expression returns the same type of value as the **This.tableData** expression. | +| In a break row | [This](../commands/this.md).breakItems | Collection or Entity selection | Éléments de la collection ou de l'entity selection affichés dans les lignes entre :
    • la ligne de rupture actuelle et la ligne de rupture précédente du même niveau (ou le début du tableau) si la ou les ligne(s) de rupture sont affichées après la ligne de données.
    • la ligne de rupture courante et la suivante du même niveau (ou la fin du tableau) si la ou les ligne(s) de rupture sont affichées avant la ligne de données.
    | In any other contexts, these expressions will return *undefined*. From 894db98f41e299191dd91d764959d50f8b88c98f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:19 +0200 Subject: [PATCH 133/201] New translations managing-formulas.md (Spanish) --- .../version-21/WritePro/managing-formulas.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md index 608c443e16e75e..9aef2486715052 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md @@ -54,22 +54,22 @@ Desea sustituir la selección en un área de 4D Write Pro por el contenido de un Puede insertar expresiones especiales relacionadas con los atributos del documento en cualquier área del documento (cuerpo, encabezado, pie de página) utilizando el comando [WP Insertar fórmula](commands/wp-insert-formula.md). Dentro de una fórmula, un objeto contextual de la fórmula se expone automáticamente. Puede utilizar las propiedades de este objeto a través de [**This**](../commands/this.md): -| Propiedades | Tipo | Descripción | -| ------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [This](../commands/this.md).title | Text | Título definido en el atributo wk title | -| [This](../commands/this.md).author | Text | Autor definido en el atributo wk author | -| [This](../commands/this.md).subject | Text | Asunto definido en el atributo wk subject | -| [This](../commands/this.md).company | Text | Empresa definida en el atributo wk company | -| [This](../commands/this.md).notes | Text | Notas definidas en el atributo wk notes | -| [This](../commands/this.md).dateCreation | Fecha | Fecha de creación definida en el atributo wk date creation | -| [This](../commands/this.md).dateModified | Fecha | Fecha de modificación definida en el atributo wk date modified | -| [This](../commands/this.md).pageNumber (\*) | Number | Número de página tal y como está definido
  • :- Desde el inicio del documento (por defecto) o
  • - Desde el inicio de página de sección si está definido por inicio de página de sección.
    • Esta fórmula es siempre dinámica; no se ve afectada por el comando [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | -| [This](../commands/this.md).pageCount (\*) | Number | Conteo de páginas: recuento total de páginas.
    Esta fórmula es siempre dinámica; no se ve afectada por el comando [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | -| [This](../commands/this.md).document | Object | Documento 4D Write Pro | -| [This](../commands/this.md).data | Object | Contexto de datos del documento 4D Write Pro definido por [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | -| [This](../commands/this.md).sectionIndex | Number | El índice de la sección en el documento 4D Write Pro a partir de 1 | -| [This](../commands/this.md).pageIndex | Number | El número de página real en el documento 4D Write Pro a partir de 1 (independientemente de los números de página de la sección) | -| [This](../commands/this.md).sectionName | String | El nombre que el usuario da a la sección | +| Propiedades | Tipo | Descripción | +| ------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [This](../commands/this.md).title | Text | Título definido en el atributo wk title | +| [This](../commands/this.md).author | Text | Autor definido en el atributo wk author | +| [This](../commands/this.md).subject | Text | Asunto definido en el atributo wk subject | +| [This](../commands/this.md).company | Text | Empresa definida en el atributo wk company | +| [This](../commands/this.md).notes | Text | Notas definidas en el atributo wk notes | +| [This](../commands/this.md).dateCreation | Fecha | Fecha de creación definida en el atributo wk date creation | +| [This](../commands/this.md).dateModified | Fecha | Fecha de modificación definida en el atributo wk date modified | +| [This](../commands/this.md).pageNumber (\*) | Number | Page number as it is defined:
  • - From the document start (default) or
  • - From the section page start if it is defined by section page start.
    • Esta fórmula siempre es dinámica; no se ve afectada por el comando [**FORMULAS WP FREEZE**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).pageCount (\*) | Number | Número de páginas: número total de páginas.
    Esta fórmula siempre es dinámica; no se ve afectada por el comando [**FORMULAS WP FREEZE**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).document | Object | Documento 4D Write Pro | +| [This](../commands/this.md).data | Object | Contexto de datos del documento 4D Write Pro definido por [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | +| [This](../commands/this.md).sectionIndex | Number | El índice de la sección en el documento 4D Write Pro a partir de 1 | +| [This](../commands/this.md).pageIndex | Number | El número de página real en el documento 4D Write Pro a partir de 1 (independientemente de los números de página de la sección) | +| [This](../commands/this.md).sectionName | String | El nombre que el usuario da a la sección | :::note From e55bae99ba4130ac7b8d4de9a44addc8e40e6b96 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:21 +0200 Subject: [PATCH 134/201] New translations managing-formulas.md (Japanese) --- .../version-21/WritePro/managing-formulas.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md index e4b0ae78508d88..76d36cac48e48f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md @@ -54,22 +54,22 @@ For security reasons, when formulas are pasted from a different 4D application o [WP Insert formula](commands/wp-insert-formula.md) コマンドを使用することで、あらゆるドキュメントエリア(本文、ヘッダー、フッター) にドキュメント属性に関連した特殊な式を挿入することができます。 フォーミュラ内ではフォーミュラコンテキストオブジェクトが自動的に公開されます。 [**This**](../commands/this.md) を通してこのオブジェクトのプロパティを使用することができます: -| プロパティ | 型 | 説明 | -| ------------------------------------------------------------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [This](../commands/this.md).title | Text | wk title 属性で定義されているタイトル | -| [This](../commands/this.md).author | Text | wk author 属性で定義されている作者 | -| [This](../commands/this.md).subject | Text | wk subject 属性で定義されている主題 | -| [This](../commands/this.md).company | Text | wk company 属性で定義されている会社 | -| [This](../commands/this.md).notes | Text | wk notes 属性で定義されている注記 | -| [This](../commands/this.md).dateCreation | Date | wk date creation 属性で定義されている作成日 | -| [This](../commands/this.md).dateModified | Date | wk date modified 属性で定義されている変更日 | -| [This](../commands/this.md).pageNumber (\*) | Number | 以下の場所から定義されているページ番号:
  • - ドキュメントの開始からのページ番号(デフォルト)
  • - セクションの開始から定義されている場合には、セクションの開始からのページ番号
    • このフォーミュラは常に動的です。つまり[**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) コマンドの影響を受けません。 | -| [This](../commands/this.md).pageCount (\*) | Number | ページ数: 総合のページ数。
    このフォーミュラは常に動的です。つまり[**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) コマンドの影響を受けません。 | -| [This](../commands/this.md).document | Object | 4D Write Pro ドキュメント | -| [This](../commands/this.md).data | Object | [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) コマンドで設定された4D Write Pro ドキュメントのデータコンテキスト | -| [This](../commands/this.md).sectionIndex | Number | 4D Write Pro ドキュメント内のセクションのインデックス(1から開始) | -| [This](../commands/this.md).pageIndex | Number | 4D Write Pro ドキュメント内の実際のページ番号(1から開始、セクションのページ番号とは無関係) | -| [This](../commands/this.md).sectionName | 文字列 | ユーザーが与えたセクションの名前 | +| プロパティ | 型 | 説明 | +| ------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [This](../commands/this.md).title | Text | wk title 属性で定義されているタイトル | +| [This](../commands/this.md).author | Text | wk author 属性で定義されている作者 | +| [This](../commands/this.md).subject | Text | wk subject 属性で定義されている主題 | +| [This](../commands/this.md).company | Text | wk company 属性で定義されている会社 | +| [This](../commands/this.md).notes | Text | wk notes 属性で定義されている注記 | +| [This](../commands/this.md).dateCreation | Date | wk date creation 属性で定義されている作成日 | +| [This](../commands/this.md).dateModified | Date | wk date modified 属性で定義されている変更日 | +| [This](../commands/this.md).pageNumber (\*) | Number | 定義されているページ番号:
  • - ドキュメントの開始からのページ番号(デフォルト) あるいは
  • - セクションの開始ページから定義されている場合にはセクションの開始ページからのページ番号。
    • このフォーミュラは常にダイナミックであり、[**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) コマンドの影響をうけません。 | +| [This](../commands/this.md).pageCount (\*) | Number | ページカウント: 合計のページ数。
    このフォーミュラは常にダイナミックであり、[**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) コマンドの影響をうけません。 | +| [This](../commands/this.md).document | Object | 4D Write Pro ドキュメント | +| [This](../commands/this.md).data | Object | [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) コマンドで設定された4D Write Pro ドキュメントのデータコンテキスト | +| [This](../commands/this.md).sectionIndex | Number | 4D Write Pro ドキュメント内のセクションのインデックス(1から開始) | +| [This](../commands/this.md).pageIndex | Number | 4D Write Pro ドキュメント内の実際のページ番号(1から開始、セクションのページ番号とは無関係) | +| [This](../commands/this.md).sectionName | 文字列 | ユーザーが与えたセクションの名前 | :::note From d48a04093619bce7b12c4a49423a033797b5daab Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:23 +0200 Subject: [PATCH 135/201] New translations managing-formulas.md (Portuguese, Brazilian) --- .../version-21/WritePro/managing-formulas.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md index 47523aef3f7472..1fb5a0245d7f2e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md @@ -54,22 +54,22 @@ You want to replace the selection in a 4D Write Pro area with the contents of a Você pode inserir expressões especiais relacionadas aos atributos de documento em qualquer área de documento (corpo, cabeçalho, rodapé) usando o comando [WP Insert formula](commands/wp-insert-formula.md). Within a formula, a formula context object is automatically exposed. Você pode usar as propriedades desse objeto por meio de [**This**](../commands/this.md): -| Propriedades | Tipo | Descrição | -| ------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [This](../commands/this.md).title | Text | Título definido no atributo wk title | -| [This](../commands/this.md).author | Text | Autor definido no atributo wk author | -| [This](../commands/this.md).subject | Text | Assunto definido no atributo wk subject | -| [This](../commands/this.md).company | Text | Empresa definida no atributo wk company | -| [This](../commands/this.md).notes | Text | Notas definidas no atributo wk notes | -| [This](../commands/this.md).dateCreation | Date | Data de criação definida no atributo wk date creation | -| [This](../commands/this.md).dateModified | Date | Data de modificação definida no atributo wk date modified | -| [This](../commands/this.md).pageNumber (\*) | Number | Page number as it is defined:
  • - From the document start (default) or
  • - From the section page start if it is defined by section page start.
    • This formula is always dynamic; it is not affected by the [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) command. | -| [This](../commands/this.md).pageCount (\*) | Number | Page count: total count of pages.
    This formula is always dynamic; it is not affected by the [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md) command. | -| [This](../commands/this.md).document | Object | Documento 4D Write Pro | -| [This](../commands/this.md).data | Object | Contexto dos dados do documento 4D Write Pro definido por [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | -| [This](../commands/this.md).sectionIndex | Number | The Index of the section in the 4D Write Pro document starting from 1 | -| [This](../commands/this.md).pageIndex | Number | The actual page number in the 4D Write Pro document starting from 1 (regardless of the section page numbers) | -| [This](../commands/this.md).sectionName | String | The name that the user gives to the section | +| Propriedades | Tipo | Descrição | +| ------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [This](../commands/this.md).title | Text | Título definido no atributo wk title | +| [This](../commands/this.md).author | Text | Autor definido no atributo wk author | +| [This](../commands/this.md).subject | Text | Assunto definido no atributo wk subject | +| [This](../commands/this.md).company | Text | Empresa definida no atributo wk company | +| [This](../commands/this.md).notes | Text | Notas definidas no atributo wk notes | +| [This](../commands/this.md).dateCreation | Date | Data de criação definida no atributo wk date creation | +| [This](../commands/this.md).dateModified | Date | Data de modificação definida no atributo wk date modified | +| [This](../commands/this.md).pageNumber (\*) | Number | Número de página conforme definido
  • :- A partir do início do documento (padrão) ou
  • - A partir do início da página da seção, se for definido pelo início da página da seção.
    • Esta fórmula é sempre dinâmica; não é afetada pelo comando [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).pageCount (\*) | Number | Contagem de páginas: contagem total de páginas.
    Esta fórmula é sempre dinâmica; não é afetada pelo comando [**WP FREEZE FORMULAS**](commands-legacy/wp-freeze-formulas.md). | +| [This](../commands/this.md).document | Object | Documento 4D Write Pro | +| [This](../commands/this.md).data | Object | Contexto dos dados do documento 4D Write Pro definido por [**WP SET DATA CONTEXT**](commands-legacy/wp-set-data-context.md) | +| [This](../commands/this.md).sectionIndex | Number | The Index of the section in the 4D Write Pro document starting from 1 | +| [This](../commands/this.md).pageIndex | Number | The actual page number in the 4D Write Pro document starting from 1 (regardless of the section page numbers) | +| [This](../commands/this.md).sectionName | String | The name that the user gives to the section | :::note From c367c881b2c04ed4072d2e8490aff8a866c388fa Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:28:41 +0200 Subject: [PATCH 136/201] New translations openaichatapi.md (Japanese) --- .../version-21/aikit/Classes/OpenAIChatAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md index c5a5e4be2c6c42..5bd0113af4ccbb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md @@ -14,7 +14,7 @@ title: OpenAIChatAPI | `completions` | [OpenAIChatCompletionsAPI](OpenAIChatCompletionsAPI.md) | チャット補完リクエストを管理するインスタンス。 | | `vision` | [OpenAIVision](OpenAIVision.md) | ビジョン関連のリクエストを管理するヘルパーインスタンス。 | -## 関数 +## Function ### create() From 71a9db22dd90a499ea8f7d79a12c5569f451bae6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:29:03 +0200 Subject: [PATCH 137/201] New translations openaichatcompletionsparameters.md (Spanish) --- .../aikit/Classes/OpenAIChatCompletionsParameters.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md index 2d506c2ba0ee11..e8a1b8b570eacd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md @@ -30,9 +30,9 @@ The `OpenAIChatCompletionParameters` class is designed to handle the parameters ### Propiedades de retrollamada asíncrona -| Propiedad | Tipo | Descripción | -| ------------------------------------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `onData` (or `formula`) | 4D.Function | A function to be called asynchronously when receiving data chunk. Asegúrese de que el proceso actual no termina. | +| Propiedad | Tipo | Descripción | +| ----------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `onData` (o `formula`) | 4D.Function | A function to be called asynchronously when receiving data chunk. Asegúrese de que el proceso actual no termina. | `onData` will receive as argument an [OpenAIChatCompletionsStreamResult](./OpenAIChatCompletionsStreamResult.md). From aea2c8f6f8fa538b899f150ccf5643c2437ef19d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:29:19 +0200 Subject: [PATCH 138/201] New translations openaichathelper.md (Japanese) --- .../aikit/Classes/OpenAIChatHelper.md | 110 +++++++++--------- 1 file changed, 55 insertions(+), 55 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatHelper.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatHelper.md index 57c10348740857..bbba82dc0590c0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatHelper.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatHelper.md @@ -9,26 +9,26 @@ title: OpenAIChatHelper ## プロパティ -| プロパティ名 | 型 | デフォルト値 | 説明 | -| --------------------- | --------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | -| `chat` | [OpenAIChatAPI](OpenAIChatAPI.md) | - | Open AI との通信で使用されるチャットAPI インスタンス。 | -| `systemPrompt` | [OpenAIMessage](OpenAIMessage.md) | - | チャットアシスタントのレスポンスをガイドするためのシステムプロンプトメッセージ。 | -| `numberOfMessages` | Integer | 15 | チャット履歴に保持するメッセージの最大数。 | -| `引数` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | -| `messages` | [OpenAIMessage](OpenAIMessage.md) のコレクション | [] | そのチャットセッション内でやりとりされたメッセージのコレクション。 | -| `ツール` | Collection of [OpenAITool](OpenAITool.md) | [] | List of registered OpenAI tools for function calling. | -| `autoHandleToolCalls` | Boolean | true | Boolean indicating whether tool calls are handled automatically using registered tools. | -| `lastErrors` | Collection | - | Collection containing the last errors encountered during chat operations. | +| プロパティ名 | 型 | デフォルト値 | 説明 | +| --------------------- | --------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------- | +| `chat` | [OpenAIChatAPI](OpenAIChatAPI.md) | - | Open AI との通信で使用されるチャットAPI インスタンス。 | +| `systemPrompt` | [OpenAIMessage](OpenAIMessage.md) | - | チャットアシスタントのレスポンスをガイドするためのシステムプロンプトメッセージ。 | +| `numberOfMessages` | Integer | 15 | チャット履歴に保持するメッセージの最大数。 | +| `parameters` | [OpenAIChatCompletionsParameters](OpenAIChatCompletionsParameters.md) | - | OpenAI チャット補完リクエスト用のパラメーター。 | +| `messages` | [OpenAIMessage](OpenAIMessage.md) のコレクション | [] | そのチャットセッション内でやりとりされたメッセージのコレクション。 | +| `ツール` | [OpenAITool](OpenAITool.md) のコレクション | [] | 関数呼び出し用に登録されたOpenAI ツールの一覧。 | +| `autoHandleToolCalls` | Boolean | true | 登録されたツールを使用してツール呼び出しを自動的に管理するかどうかをあらわすブール値。 | +| `lastErrors` | Collection | - | チャット操作中に発生した最後のエラーを格納したコレクション。 | ## Constructor -To create a new `OpenAIChatHelper` instance, it's best to use the `create()` method from the [OpenAI client's chat API](OpenAIChatAPI.md): +新しい `OpenAIChatHelper` インスタンスを作成するためには、[OpenAI クライアントのチャットAPI](OpenAIChatAPI.md)の `create()` メソッドを使用するのが最適です: ```4D var $chatHelper:=$client.chat.create("You are a helpful assistant.") ``` -This method creates a new chat helper with the specified system prompt and initializes it with default parameters. The system prompt defines the assistant's role and behavior throughout the conversation. +このメソッドは指定されたシステムプロンプトで新しいチャットヘルパーを作成し、デフォルトの引数で初期化します。 このシステムプロンプトが会話の間全体の、アシスタントの役割と振る舞いを定義します。 ## 関数 @@ -54,52 +54,52 @@ $result:=$chatHelper.prompt("Why 42?") **reset**() -Resets the chat context by clearing all messages and unregistering all tools. This effectively starts a fresh conversation while keeping the system prompt and parameters intact. +全てのメッセージを消去し、全てのツールの登録を解除することで、チャットコンテキストをリセットします。 これにより、システムのプロンプトとパラメータをそのままにしながら、効果的に新しい会話を始めることができます。 -#### Reset Example +#### リセットの例 ```4D $chatHelper.prompt("Hello!") -$chatHelper.reset() // Clear all previous messages and tools +$chatHelper.reset() // 以前のメッセージとツールを全て消去 ``` ### registerTool() **registerTool**(*tool* : Object; *handler* : Object) -| 引数 | 型 | 説明 | -| --------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| *tool* | Object | The tool definition object (or [OpenAITool](OpenAITool.md) instance) | -| *handler* | Object | The function to handle tool calls ([4D.Function](../../API/FunctionClass.md) or Object), optional if defined inside *tool* as *handler* property | +| 引数 | 型 | 説明 | +| --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| *tool* | Object | ツール定義オブジェクト(あるいは[OpenAITool](OpenAITool.md) インスタンス) | +| *handler* | Object | ツール呼び出しを管理する関数([4D.Function](../../API/FunctionClass.md) またはオブジェクト)、*tool* 内の *handler* プロパティで定義されている場合にはオプション。 | -Registers a tool with its handler function for automatic tool call handling. +自動ツール呼び出し関数のために、ツールとそのハンドラ関数を登録します。 -The *handler* parameter can be: +*handler* 引数には以下のものを渡すことができます: -- A **4D.Function**: Direct handler function -- An **Object**: An object containing a `formula` property matching the tool function name +- **4D.Function**: 直接ハンドラ関数 +- **オブジェクト**: ツール関数名と一致する `formula` プロパティを格納しているオブジェクト -The handler function receives an object containing the parameters passed from the OpenAI tool call. This object contains key-value pairs where the keys match the parameter names defined in the tool's schema, and the values are the actual arguments provided by the AI model. +ハンドラー関数はOpenAI ツール呼び出しから渡された引数を格納しているオブジェクトを受け取ります。 オブジェクトは、ツールのスキーマで定義されたパラメーター名とキーが一致するキーと、AI モデルから提供された実際の引数である値との、キーと値のペアを格納しています。 -#### Register Tool Example +#### ツールを登録する例題 ```4D -// Example 1: Simple registration with direct handler +// Example 1: 直接ハンドラを使用したシンプルな登録 var $tool:={type: "function"; function: {name: "get_weather"; description: "Get current weather"; parameters: {type: "object"; properties: {location: {type: "string"; description: "City name"}}}}} var $handler:=Formula(return "Sunny, 25°C in "+$1.location) $chatHelper.registerTool($tool; $handler) -// Example 2: Tool with handler property (no second parameter needed) +// Example 2: プロパティを持つtool オブジェクトを使用(この場合第2に引数は不要です) var $tool:={name: "calculate"; description: "Perform calculations"; handler: Formula(return String(Num($1.expression)))} $chatHelper.registerTool($tool) -// Example 3: Using object notation +// Example 3: オブジェクト記法を使用する $chatHelper.registerTool({tool: $tool; handler: $handler}) -// Example 4: Handler as object with formula matching tool name +// Example 4: ツール名と合致するフォーミュラを持ったオブジェクトとしてのハンドラ var $tool:={name: "getTime"; description: "Get current time"} -var $handlerObj:=cs.MyTimeTool.new() // class with a getTime function +var $handlerObj:=cs.MyTimeTool.new() // getTime 関数を持つクラス $chatHelper.registerTool($tool; $handlerObj) ``` @@ -107,19 +107,19 @@ $chatHelper.registerTool($tool; $handlerObj) **registerTools**(*toolsWithHandlers* : Variant) -| 引数 | 型 | 説明 | -| ------------------- | ------- | -------------------------------------------------------- | -| *toolsWithHandlers* | Variant | Object or Collection containing tools and their handlers | +| 引数 | 型 | 説明 | +| ------------------- | ------- | ------------------------------- | +| *toolsWithHandlers* | Variant | ツールとのそのハンドラを格納したオブジェクトまたはコレクション | -Registers multiple tools at once. The parameter can be: +複数のツールを一度に登録します。 引数には以下のものを渡すことができます: -- **Collection**: Array of tool objects (with handlers embedded or separate) -- **Object**: Object with function names as keys mapping to tool definitions -- **Object with `tools` attribute**: Object containing a `tools` collection and formula properties matching tool names +- **コレクション**: (ハンドラが埋め込んである、あるいは分離してある)ツールオブジェクトのコレクション +- **オブジェクト**: 関数名がツール定義にマッピングされているキーとするオブジェクト +- **`tools` 属性を持つオブジェクト**: `tools` コレクションと、ツール名に合致するフォーミュラプロパティを格納しているオブジェクト -#### Register Multiple Tools Example +#### 複数のツールを登録する例題 -##### Example 1: Collection format with handlers in tools +##### 例 1: ツール内のハンドルを使用したコレクションフォーマット ```4D var $weatherTool:={name: "getWeather"; description: "Get current weather"; handler: Formula(return "Sunny, 25°C in "+$1.location)} @@ -128,7 +128,7 @@ var $calculatorTool:={name: "calculate"; description: "Perform calculations"; ha $chatHelper.registerTools([$weatherTool; $calculatorTool]) ``` -##### Example 2: Object format with separate tool and handler +##### 例 2: 別個のツールとハンドラを使用したオブジェクトフォーマット ```4D var $toolsWithSeparateHandlers:={} @@ -138,15 +138,15 @@ $toolsWithSeparateHandlers.calculate:={tool: $calculatorToolDefinition; handler: $chatHelper.registerTools($toolsWithSeparateHandlers) ``` -##### Example 3: Object with tools collection attribute and formula properties +##### 例 3: tools コレクション属性とformula プロパティを持ったオブジェクト -MyTools class: +MyTools クラス: ```4D Class constructor this.tools:=[{name: "getWeather"; description: "Get current weather"}; \ - {name: "getTime"; description: "Get current time"}] // Collection of tool definitions + {name: "getTime"; description: "Get current time"}] // ツール定義のコレクション Function getWeather($parameters: Object) return "Sunny, 25°C" @@ -159,12 +159,12 @@ Function getTime($parameters: Object) $chatHelper.registerTools(cs.MyTools.new()) ``` -##### Example 4: Simple object format with tools as properties +##### 例 4: ツールをプロパティにもつシンプルなオブジェクトフォーマット ```4D var $tools:={} -$tools.getWeather:=$weatherTool // Tool with handler property -$tools.calculate:=$calculatorTool // Tool with handler property +$tools.getWeather:=$weatherTool // handler プロパティを持つTool +$tools.calculate:=$calculatorTool // handler プロパティを持つTool $chatHelper.registerTools($tools) ``` @@ -173,28 +173,28 @@ $chatHelper.registerTools($tools) **unregisterTool**(*functionName* : Text) -| 引数 | 型 | 説明 | -| -------------- | ---- | ------------------------------------------- | -| *functionName* | Text | The name of the function tool to unregister | +| 引数 | 型 | 説明 | +| -------------- | ---- | --------------- | +| *functionName* | Text | 登録を解除したいツールの関数名 | -Unregisters a specific tool by its function name. This removes the tool from the registered tools collection, clears its handler, and removes it from the parameters. +特定のツールをその関数名で指定して登録解除します。 これによってツールは登録されたツールのコレクションから削除され、ハンドラも消去され、引数からも削除されます。 -#### Unregister Tool Example +#### ツールを登録解除する例 ```4D $chatHelper.registerTool($weatherTool; $weatherHandler) -$chatHelper.unregisterTool("get_weather") // Remove the weather tool +$chatHelper.unregisterTool("get_weather") // weather ツールを削除 ``` ### unregisterTools() **unregisterTools**() -Unregisters all tools at once. This clears all tool handlers, empties the tools collection, and removes all tools from the parameters. +全てのツールを一度に登録解除します。 これはすべてのツールハンドラを消去し、tools コレクションをからにし、そして引数からも全てのツールを削除します。 -#### Unregister All Tools Example +#### 全てのツールを登録解除する例 ```4D $chatHelper.registerTools($multipleTools) -$chatHelper.unregisterTools() // Remove all tools +$chatHelper.unregisterTools() // 全てのツールを削除 ``` \ No newline at end of file From a450a21a818ab8ba8011e9f7840bdadca878be5f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:30:57 +0200 Subject: [PATCH 139/201] New translations openaitool.md (Spanish) --- .../version-21/aikit/Classes/OpenAITool.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md index 4a2bbe4632aec8..77620f6ef0ac24 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md @@ -20,7 +20,7 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. | `tipo` | Text | `"function"` | El tipo de herramienta. Currently supports `"function"`, `"custom"`, and other built-in types. | | `strict` | Boolean | `False` | Whether to enforce strict schema validation for function parameters. | -### Common Properties +### Propiedades comunes | Propiedad | Tipo | Descripción | | ------------- | ---- | ------------------------------------------------------------------------------ | @@ -46,7 +46,7 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. Crea una nueva instancia de OpenAITool. The constructor accepts both simplified format and OpenAI API format. -#### Supported formats +#### Formatos soportados **Simplified format:** From 3dc250b1a7487f1c0f98d81b19c431221c0e58fc Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Tue, 14 Oct 2025 22:30:59 +0200 Subject: [PATCH 140/201] New translations openaitool.md (Japanese) --- .../version-21/aikit/Classes/OpenAITool.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md index bc638180ea1b72..c6d1be78b53a00 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAITool.md @@ -29,9 +29,9 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. ### Function-specific Properties -| プロパティ | 型 | 説明 | -| ----- | ------ | -------------------------------------------------------------------------------- | -| `引数` | Object | Parameters definition for the function using JSON schema format. | +| プロパティ | 型 | 説明 | +| ------------ | ------ | -------------------------------------------------------------------------------- | +| `parameters` | Object | Parameters definition for the function using JSON schema format. | ## Constructor From 9bedc4cd8f38dfeaf2f182fe8e608e4830f97603 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:00:38 +0200 Subject: [PATCH 141/201] New translations collectionclass.md (French) --- .../current/API/CollectionClass.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/CollectionClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/CollectionClass.md index 5dcf2027434be2..d035141d566951 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/CollectionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/CollectionClass.md @@ -3216,15 +3216,15 @@ La fonction `.sort()` trie les éléments > Cette fonction modifie la collection d'origine. Si `.sort()` est appelé sans paramètres, seules les valeurs scalaires (nombres, textes, dates, booléens) sont triées. Les éléments sont triés par défaut par ordre croissant, en fonction de leur type. -You can also pass one of the following constants in the *ascOrDesc* parameter: +Vous pouvez également passer une des constantes suivantes dans le paramètre *ascOrDesc* : ``` -|Constant| Type|Value|Comment| -|---|---|---|---| -|ck ascending|Integer|0|Elements are ordered in ascending order (default)| -|ck descending|Integer|1|Elements are ordered in descending order| +|Constante| Type|Valeur|Comment| +|---|---|---| +|ck ascending|Integer|0|Les éléments sont classés par ordre croissant (par défaut)| +|ck descending|Integer|1|Les éléments sont classés par ordre décroissant| -This syntax orders scalar values in the collection only (other element types such as objects or collections are returned unordered). +Cette syntaxe ordonne uniquement les valeurs scalaires dans la collection (les autres types d'éléments tels que les objets ou les collections sont renvoyés non ordonnés). ``` Si la collection contient des éléments de différents types, ils sont d'abord groupés par type et triés par la suite. Les types sont renvoyés dans l'ordre suivant : From ae86a9628b7a05962ee1cdf1689ce9ca99d52500 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:00:57 +0200 Subject: [PATCH 142/201] New translations entityclass.md (French) --- .../current/API/EntityClass.md | 79 +++++++++---------- 1 file changed, 39 insertions(+), 40 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/EntityClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/EntityClass.md index 62d40f51d1a21b..3c2165231c46e3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/EntityClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/EntityClass.md @@ -335,10 +335,10 @@ vCompareResult3 (seules les différences sur les attributs touchés de $e1 sont
    Historique -| Release | Modifications | -| ------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Ajout | +| Release | Modifications | +| ------- | ------------------------ | +| 21 | Ajout des statuts 7 et 8 | +| 17 | Ajout |
    @@ -365,7 +365,7 @@ Sinon, vous pouvez passer l'option `dk force drop if stamp changed` dans le para **Résultat** -The object returned by `.drop()` contains the following properties: +L'objet renvoyé par `.drop()` contient les propriétés suivantes : | Propriété | | Type | Description | | --------------------------------- | ----------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -390,15 +390,15 @@ The object returned by `.drop()` contains the following properties: (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using entity.drop(), this error can be returned when dk force drop if stamp changed option is used. When using entity.lock(), this error can be returned when dk reload if stamp changed option is used.
    • **Associated statusText**: "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | -| `dk status validation failed` | 7 | Non fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Mild Validation Error" | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | -| `dk status serious validation error` | 8 | Fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used
  • **Associated statusText**: "Stamp has changed"
    • | -| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de entity.drop(), cette erreur peut être renvoyée lorsque l'option dk force drop if stamp changed est utilisée. Lors de l'utilisation de entity.lock(), cette erreur peut être renvoyée lorsque l'option dk reload if stamp changed est utilisée.
    • **statusText associé** : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | +| `dk status validation failed` | 7 | Erreur non fatale envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Mild Validation Error" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | +| `dk status serious validation error` | 8 | Erreur critique envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Serious Validation Error" | +| `dk status stamp has changed` | 2 | La valeur interne du stamp de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur seulement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()` : erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée
  • **statusText associé** : "Stamp has changed"
    • | +| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | #### Exemple 1 @@ -512,7 +512,7 @@ La correspondance entre l'objet et l'entité est établie à partir des noms de - Si une propriété de l'objet n'existe pas dans la dataclass, elle est ignorée. - Les types de données doivent être équivalents. S'il existe une différence de type entre l'objet et la dataclass, 4D essaie de convertir les données lorsque cela est possible (voir [`Converting data types`](Concepts/data-types.md#converting-data-types)), sinon l'attribut est laissé intact. -- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. +- La clé primaire peut être donnée telle quelle ou avec une propriété "__KEY" (remplie avec la valeur de la clé primaire). Si elle n'existe pas déjà dans la dataclass, l'entité est créée avec la valeur donnée lorsque [.save()](#save) est appelée. Si la clé primaire n'est pas fournie, l'entité est créée et la valeur de la clé primaire est affectée en fonction des règles de la base de données. L'auto-incrémentation n'est calculée que si la clé primaire est nulle. *filler* peut contenir une related entity dans les conditions suivantes : @@ -1011,13 +1011,12 @@ L'objet retourné par `.lock()` contient les propriétés suivantes : (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | -| `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option dk force drop if stamp changed est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | +| `dk status stamp has changed` | 2 | La valeur du stamp interne de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur seulement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()`: erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée

    • **statusText associé** : "Stamp has changed" | #### Exemple 1 @@ -1178,10 +1177,10 @@ L'objet retourné par `.reload( )` contient les propriétés suivantes : (\*) Les valeurs suivantes peuvent être retournées dans les propriétés *status* et *statusText* de l'objet *Résultat* en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when `dk force drop if stamp changed` option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • ***statusText associé***: "Entity does not exist anymore" | -| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    ***statusText associé*** : "Other error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option `dk force drop if stamp changed` est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • ***statusText associé***: "Entity does not exist anymore" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    ***statusText associé*** : "Other error" | #### Exemple @@ -1210,10 +1209,10 @@ L'objet retourné par `.reload( )` contient les propriétés suivantes :
    Historique -| Release | Modifications | -| ------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Ajout | +| Release | Modifications | +| ------- | ------------------------ | +| 21 | Ajout des statuts 7 et 8 | +| 17 | Ajout |
    @@ -1273,16 +1272,16 @@ L'objet retourné par `.save()` contient les propriétés suivantes : Les valeurs suivantes peuvent être retournées dans les propriétés `status` et `statusText` de l'objet Résultat en cas d'erreur : -| Constante | Valeur | Commentaire | -| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status automerge failed` | 6 | (Only if the `dk auto merge` option is used) The automatic merge option failed when saving the entity. **Associated statusText**: "Auto merge failed" | -| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). When using `.drop()`, this error can be returned when `dk force drop if stamp changed` option is used. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | -| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste. **statusText associé** : "Already locked" | -| `dk status validation failed` | 7 | Non fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Mild Validation Error" | -| `dk status serious error` | 4 | A serious error is a low-level database error (e.g. duplicated key), a hardware error, etc. **Associated statusText**: "Other error" | -| `dk status serious validation error` | 8 | Fatal error sent by the developer for a [validate event](../ORDA/orda-events.md). **Associated statusText**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | -| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | +| Constante | Valeur | Commentaire | +| ----------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status automerge failed` | 6 | (Seulement si l'option `dk auto merge` est utilisée) L'option de fusion automatique a échoué lors de la sauvegarde de l'entité. \*\*statusText associé : "Auto merge failed" | +| `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option `dk force drop if stamp changed` est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | +| `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste. **statusText associé** : "Already locked" | +| `dk status validation failed` | 7 | Erreur non fatale envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Mild Validation Error" | +| `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc. **statusText associé** : "Other error" | +| `dk status serious validation error` | 8 | Erreur critique envoyée par le développeur pour un [événement de validation](../ORDA/orda-events.md). **statusText associé**: "Serious Validation Error" | +| `dk status stamp has changed` | 2 | La valeur du marqueur interne de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()`: erreur uniquement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()`: erreur uniquement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()`: erreur uniquement si l'option `dk reload if stamp changed` n'est pas utilisée

    • **StatusText associé**: "Stamp has changed" | +| `dk status wrong permission` | 1 | Les privilèges courants ne permettent pas de supprimer l'entité. **statusText associé** : "Permission error" | #### Exemple 1 From acd0509ceee5338fe34aea49b76efedfecf037c6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:01:30 +0200 Subject: [PATCH 143/201] New translations entityclass.md (Spanish) --- .../current/API/EntityClass.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/EntityClass.md index 4fbea5520fbe57..ae8faab8fc75f9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/EntityClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/EntityClass.md @@ -338,10 +338,10 @@ vCompareResult1 (se devuelven todas las diferencias):
    Historia -| Lanzamiento | Modificaciones | -| ----------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | -------------------------- | +| 21 | Añadidos los estados 7 y 8 | +| 17 | Añadidos |
    @@ -368,7 +368,7 @@ De lo contrario, puede pasar la opción `dk force drop if stamp changed` en el p **Resultado** -The object returned by `.drop()` contains the following properties: +El objeto devuelto por `.drop()` contiene las siguientes propiedades: | Propiedad | | Tipo | Descripción | | --------------------------------- | ----------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1019,7 +1019,6 @@ El objeto devuelto por `.lock()` contiene las siguientes propiedades: | ----------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | La entidad ya no existe en los datos. Este error puede ocurrir en los siguientes casos:
  • la entidad ha sido eliminada (el marcador ha cambiado y ahora el espacio de memoria está libre)
  • la entidad ha sido eliminada y reemplazada por otra con otra clave primaria (el marcador ha cambiado y una nueva entidad ahora utiliza el espacio memoria). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Cuando se utiliza `.lock()`, este error puede ser devuelto cuando se utiliza la opción `dk reload if stamp changed`

    • **statusText asociado**: "Entity does not exist anymore" | | `dk status locked` | 3 | La entidad está bloqueada por un bloqueo pesimista. **statusText asociado**: "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | Un error grave es un error de base de datos de bajo nivel (por ejemplo, una llave duplicada), un error de hardware, etc.
    **statusText asociado**: "Other error" | | `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | @@ -1215,10 +1214,10 @@ El objeto devuelto por `.reload( )` contiene las siguientes propiedades:
    Historia -| Lanzamiento | Modificaciones | -| ----------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | -------------------------- | +| 21 | Añadidos los estados 7 y 8 | +| 17 | Añadidos |
    From 295252559d7f1278ce180d4e1f4b3f65d054550e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:02:02 +0200 Subject: [PATCH 144/201] New translations entityclass.md (Japanese) --- .../ja/docusaurus-plugin-content-docs/current/API/EntityClass.md | 1 - 1 file changed, 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md index 805fe2f6a0adad..ee2f4b82093a42 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md @@ -1020,7 +1020,6 @@ $info:=$address.getRemoteContextAttributes() | ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. `entity.lock()` を使用するとき、このエラーは `dk reload drop if stamp changed` オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | | `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" (その他のエラー) | | `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | From 572a98a8e2697fe3474a293a1a0a491536bcb5d7 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:02:34 +0200 Subject: [PATCH 145/201] New translations entityclass.md (Portuguese, Brazilian) --- .../pt/docusaurus-plugin-content-docs/current/API/EntityClass.md | 1 - 1 file changed, 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/EntityClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/EntityClass.md index b503f0a3d13253..715fbb94159c98 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/EntityClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/EntityClass.md @@ -1017,7 +1017,6 @@ O objeto retornado por `.lock()` contém as seguintes propriedades: | ----------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | A entidade não existe mais nos dados. Esse erro pode ocorrer nos seguintes casos
  • :a entidade foi descartada (o carimbo foi alterado e o espaço de memória agora está livre)
  • a entidade foi descartada e substituída por outra com outra chave primária (o carimbo foi alterado e uma nova entidade agora usa o espaço de memória). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Quando usando `. ock()`, este erro pode ser retornado quando a opção `dk reload se o carimbo mudar` é usada

    • **Associado statusText**: "Entidade não existe mais" | | `dk status locked` | 3 | A entidade está bloqueada por um bloqueio pessimista.**statusText associado**: "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | Um erro grave é um erro de banco de dados de baixo nível (por exemplo, chave duplicada), um erro de hardware, etc.
    \*\*statusText associado \*\*: "Other error" | | `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | From 209e17278698aa5f18b40759d5510c2affb1a7db Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:13:06 +0200 Subject: [PATCH 146/201] New translations forms.md (Spanish) --- .../docusaurus-plugin-content-docs/current/FormEditor/forms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 dc0b5a8bdb81ab..778f2c08cd4d61 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormEditor/forms.md @@ -155,7 +155,7 @@ Fluent UI rendering offers modern and attractive controls, support of dark/light When using 4D forms with Fluent UI rendering, you need to pay attention to the following points: -- The `FORM Window theme` command returns the actual display theme of the current form. Possible values: "Classic" or "FluentUI". If there is no current form or the command is called on macOS, and empty string is returned. +- El comando `FORM Window theme` devuelve el tema de visualización actual del formulario. Possible values: "Classic" or "FluentUI". If there is no current form or the command is called on macOS, and empty string is returned. - If [`GET STYLE SHEET INFO`](../commands-legacy/get-style-sheet-info.md) is called in the context of a form, the information returned relates to the current appearance of the form (Classic or FluentUI). If the command is called outside the context of a form, the information returned relates to the [global project settings](#application-setting). - [`SET MENU ITEM STYLE`](../commands-legacy/set-menu-item-style.md) with `Underline` *itemStyle* parameter is not supported (ignored) for pop up menus. - A focus ring can be added to picture and text [inputs](../FormObjects/input_overview.md). From 033f2c3db9e8a6e63898feb19cb85b0b75b15c6d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:14:56 +0200 Subject: [PATCH 147/201] New translations properties_action.md (French) --- .../current/FormObjects/properties_Action.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md index 35f9af9007f7a2..d55a8a9d02a490 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md @@ -13,10 +13,10 @@ Deux modes de glisser-déposer sont proposés dans 4D : - Un mode **personnalisé**, dans lequel le glisser déclenche l'événement formulaire `Sur début glisser` dans le contexte de l'objet. Custom: In this mode, any drag operation performed on the object triggers the On Begin Drag form event in the context of the object. You then manage the drag action using a method. Ce mode vous permet de mettre en place des interfaces basées sur le glisser-déposer, y compris des interfaces qui ne déplacent pas nécessairement des données mais qui peuvent effectuer tout type d'action, telle que l'ouverture de fichiers ou le lancement d'un calcul. Ce mode est basé sur un ensemble de propriétés, d'événements et de commandes spécifiques à partir du thème `Conteneur de données`. -- Un mode **automatique**, dans lequel 4D **copie** du texte ou des images directement à partir de l'objet formulaire. Il peut alors être utilisé dans la même zone 4D, entre deux zones 4D, ou entre 4D et une autre application. Par exemple, le glisser-déposer automatique vous permet de copier une valeur entre deux champs sans utiliser de programmation : +- Un mode **automatique**, dans lequel 4D **copie** du texte ou des images directement à partir de l'objet formulaire. Il peut alors être utilisé dans la même zone 4D, entre deux zones 4D, ou entre 4D et une autre application. For example, automatic drag (and drop) lets you copy a value between two fields without using programming: ![](../assets/en/FormObjects/property_automaticDragDrop.png) - ![](../assets/en/FormObjects/property_automaticDragDrop2.png) - Dans ce mode, l'événement de formulaire `On Begin Drag` n'est PAS généré. Si vous souhaitez "forcer" l'utilisation du glissement personnalisé alors que le glissement automatique est activé, maintenez la touche **Alt** (Windows) ou **Option** (macOS) enfoncée pendant l'action. Cette option n'est pas disponible pour les images. + ![](../assets/en/FormObjects/property_automaticDragDrop2.png)
    + In this mode, the `On Begin Drag` form event is NOT generated. Si vous souhaitez "forcer" l'utilisation du glissement personnalisé alors que le glissement automatique est activé, maintenez la touche **Alt** (Windows) ou **Option** (macOS) enfoncée pendant l'action. Cette option n'est pas disponible pour les images. Pour plus d'informations, reportez-vous à [Glisser-déposer](https://doc.4d.com/4Dv20/4D/20.6/Drag-and-Drop.300-7487471.en.html) dans le manuel *Langage 4D*. @@ -191,15 +191,15 @@ Dans d'autres cas (list box basées sur des sélections nommées, colonnes assoc ## Action standard -Les actions types effectuées par les objets actifs (par exemple, permettre à l'utilisateur d'accepter, d'annuler ou de supprimer des enregistrements, de passer d'un enregistrement à l'autre ou d'une page à l'autre dans un formulaire à plusieurs pages, etc.) ont été prédéfinies par 4D comme des actions standard. Elles sont décrites en détail dans la section [Actions standard](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) du *manuel de développement*. +Les actions types effectuées par les objets actifs (par exemple, permettre à l'utilisateur d'accepter, d'annuler ou de supprimer des enregistrements, de passer d'un enregistrement à l'autre ou d'une page à l'autre dans un formulaire à plusieurs pages, etc.) ont été prédéfinies par 4D comme des actions standard. Elles sont décrites en détail dans la section [Actions standard](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) du *manuel de développement*. There are also [standard actions specific to 4D Write Pro areas](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). Vous pouvez associer à la fois une action standard et une méthode projet à un objet. Dans ce cas, l'action standard est généralement exécutée après la méthode et 4D utilise cette action pour activer/désactiver l'objet en fonction du contexte courant. Lorsqu’un objet est désactivé, la méthode projet associée ne peut être exécutée. #### Grammaire JSON -| Nom | Type de données | Valeurs possibles | -| ------ | --------------- | ----------------------------------------------------------------------------------------------------------------------------- | -| action | string | Le nom d'une [action standard valide](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html). | +| Nom | Type de données | Valeurs possibles | +| ------ | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| action | string | The name of a valid [standard action](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) or [4D Write Pro standard action](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). | #### Objets pris en charge From d52bdb3b6ab0f2a0b0183316eecde557628b8597 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:15:15 +0200 Subject: [PATCH 148/201] New translations properties_action.md (Spanish) --- .../current/FormObjects/properties_Action.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md index 1e4635722fa0b1..596695ff6e0403 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md @@ -13,10 +13,10 @@ Hay dos modos de arrastrar disponibles: - **Personalizado**: en este modo, toda operación de arrastrar realizada en el objeto dispara el evento formulario `On Begin Drag` en el contexto del objeto. A continuación, gestiona la acción arrastrar utilizando un método. En el modo personalizado, básicamente toda la operación de arrastrar y soltar es realizada por el programador. Este modo le permite implementar cualquier interfaz basada en la función de arrastrar y soltar, incluidas las interfaces que no necesariamente transportan datos, sino que pueden realizar cualquier acción como abrir archivos o activar un cálculo. Este modo se basa en una combinación de propiedades, eventos y comandos específicos del tema `Portapapeles`. -- **Automático**: en este modo, 4D **copia** el texto o las imágenes directamente desde el objeto formulario. Puede utilizarse en la misma área 4D, entre dos áreas 4D o entre 4D y otra aplicación. Por ejemplo, arrastrar (y soltar) automáticamente le permite copiar un valor entre dos campos sin usar programación:\ - ![](../assets/en/FormObjects/property_automaticDragDrop.png)\ - ![](../assets/en/FormObjects/property_automaticDragDrop2.png) - En este modo, NO se genera el evento del formulario `On Begin Drag`. Si quiere "forzar" el uso del arrastre personalizado mientras está activado el arrastre automático, mantenga presionada la tecla **Alt** (Windows) o **Opción** (macOS) durante la acción. Esta opción no está disponible para las imágenes. +- **Automático**: en este modo, 4D **copia** el texto o las imágenes directamente desde el objeto formulario. Puede utilizarse en la misma área 4D, entre dos áreas 4D o entre 4D y otra aplicación. For example, automatic drag (and drop) lets you copy a value between two fields without using programming: + ![](../assets/en/FormObjects/property_automaticDragDrop.png) + ![](../assets/en/FormObjects/property_automaticDragDrop2.png)
    + In this mode, the `On Begin Drag` form event is NOT generated. Si quiere "forzar" el uso del arrastre personalizado mientras está activado el arrastre automático, mantenga presionada la tecla **Alt** (Windows) o **Opción** (macOS) durante la acción. Esta opción no está disponible para las imágenes. Para más información, consulte [Arrastrar y soltar](https://doc.4d.com/4Dv20/4D/20.6/Drag-and-Drop.300-7487471.en.html) en el manual *Lenguaje 4D*. @@ -189,15 +189,15 @@ En otros casos (list box basados en selecciones temporales, columnas asociadas a ## Acción estándar -Actividades típicas que deben realizar los objetos activos (\*por ejemplo, permitir al usuario aceptar, cancelar o eliminar registros, desplazarse entre registros o de una página a otra en un formulario multipágina, etc.) han sido predefinidas por 4D como acciones estándar. Se describen con detalle en la sección [Acciones estándar](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) de la *manual de Diseño*. +Actividades típicas que deben realizar los objetos activos (\*por ejemplo, permitir al usuario aceptar, cancelar o eliminar registros, desplazarse entre registros o de una página a otra en un formulario multipágina, etc.) han sido predefinidas por 4D como acciones estándar. Se describen con detalle en la sección [Acciones estándar](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) de la *manual de Diseño*. There are also [standard actions specific to 4D Write Pro areas](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). Puede asignar al mismo tiempo una acción estándar y un método proyecto de un objeto. En este caso, la acción estándar suele ejecutarse después del método y 4D utiliza esta acción para activar/desactivar el objeto según el contexto actual. Cuando se desactiva un objeto, no se puede ejecutar el método proyecto asociado. #### Gramática JSON -| Nombre | Tipos de datos | Valores posibles | -| ------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| action | string | El nombre de una [acción estándar válida](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html). | +| Nombre | Tipos de datos | Valores posibles | +| ------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| action | string | The name of a valid [standard action](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) or [4D Write Pro standard action](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). | #### Objetos soportados From dc49ca748861554e4498b6ab3b88c99d3dbd7d45 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:15:32 +0200 Subject: [PATCH 149/201] New translations properties_action.md (Japanese) --- .../current/FormObjects/properties_Action.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md index aad5530955644b..1a9b9c4c22932b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md @@ -13,10 +13,10 @@ title: 動作 - **カスタム**: このモードでは、オブジェクトに対しておこなわれたドラッグ操作は、当該オブジェクトのコンテキストにおいて `On Begin Drag` フォームイベントを発生させます。 これを利用して、開発者はメソッドを用いてドラッグアクションを管理しなければなりません。 つまり、カスタムモードにおいては、ドラッグ＆ドロップ操作のすべてが開発者により管理されます。 このモードでは、ドラッグ＆ドロップに基づいたあらゆるインターフェースを実装することができます。 これにはデータの転送を必ずしも伴わないものも含まれ、ファイルを開くや計算をトリガーするなどの任意のアクションを実行することができます。 このモードは専用のプロパティ、イベント、`ペーストボード` テーマのコマンド等の組み合わせに基づいています。 -- **自動**: このモードでは、ドラッグ元のフォームオブジェクトからテキストやピクチャーが 4D によって **コピー** されます。 このコピーは、同じ 4Dエリア内、2つの 4Dエリア間、4D と他のアプリケーション間で使用できます。 たとえば、自動ドラッグ (＆ドロップ) を使用して、プログラムを使用せず、2つのフィールド間で値をコピーできます: +- **自動**: このモードでは、ドラッグ元のフォームオブジェクトからテキストやピクチャーが 4D によって **コピー** されます。 このコピーは、同じ 4Dエリア内、2つの 4Dエリア間、4D と他のアプリケーション間で使用できます。 For example, automatic drag (and drop) lets you copy a value between two fields without using programming: ![](../assets/en/FormObjects/property_automaticDragDrop.png) - ![](../assets/en/FormObjects/property_automaticDragDrop2.png) - このモードでは、`On Begin Drag` フォームイベントは生成されません。 自動ドラッグが有効のときに標準のドラッグを "強制" したい場合、アクションの間 **Alt** (Windows) または **Option** (macOS) キーを押しながら操作します。 このオプションはピクチャーでは利用できません。 + ![](../assets/en/FormObjects/property_automaticDragDrop2.png)
    + In this mode, the `On Begin Drag` form event is NOT generated. 自動ドラッグが有効のときに標準のドラッグを "強制" したい場合、アクションの間 **Alt** (Windows) または **Option** (macOS) キーを押しながら操作します。 このオプションはピクチャーでは利用できません。 詳細については *4Dランゲージリファレンス* マニュアルの [ドラッグ＆ドロップ](https://doc.4d.com/4Dv20/4D/20.6/Drag-and-Drop.300-7487471.ja.html) を参照してください。 @@ -212,15 +212,15 @@ title: 動作 ## 標準アクション -アクティブオブジェクトにより実行される典型的な処理 (例: レコードの入力・取り消し・削除、レコード間の移動、マルチページフォームでのページ間の移動、など) は、4D より標準アクションとして提供されています。 詳細な情報に関しては、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.ja.html) の章を参照ください。 +アクティブオブジェクトにより実行される典型的な処理 (例: レコードの入力・取り消し・削除、レコード間の移動、マルチページフォームでのページ間の移動、など) は、4D より標準アクションとして提供されています。 詳細な情報に関しては、*デザインリファレンス* の [標準アクション](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.ja.html) の章を参照ください。 There are also [standard actions specific to 4D Write Pro areas](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). フォームオブジェクトには、標準アクションとメソッドの両方を割り当てることができます。 この場合、標準アクションは通常、メソッドの後に実行されます。また、4D はこのアクションを使用して、カレントコンテキストに応じてオブジェクトを有効化/無効化します。 フォームオブジェクトが無効化されていた場合、関連づけられたメソッドは実行されません。 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------ | ------ | ------------------------------------------------------------------------------------ | -| action | string | 有効な [標準アクション](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.ja.html) | +| 名称 | データタイプ | とりうる値 | +| ------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| action | string | The name of a valid [standard action](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) or [4D Write Pro standard action](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). | #### 対象オブジェクト From cd00725220d4cb19b015b0b432663c242e960369 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:15:48 +0200 Subject: [PATCH 150/201] New translations properties_action.md (Portuguese, Brazilian) --- .../current/FormObjects/properties_Action.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md index cbf8415a3b5a49..39960a6164d24c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md @@ -13,10 +13,10 @@ Estão disponíveis dois modos de arrastamento: - **Personalizado**: nesse modo, qualquer operação de arrastar executada no objeto aciona o evento de formulário `On Begin Drag` no contexto do objeto. Em seguida, a ação de arrastamento é gerida através de um método. No modo personalizado, basicamente toda a operação de arrastar e soltar é tratada pelo programador. Esse modo permite que você implemente qualquer interface baseada em arrastar e soltar, incluindo interfaces que não necessariamente transportam dados, mas podem executar qualquer ação, como abrir arquivos ou acionar um cálculo. Esse modo é baseado em uma combinação de propriedades, eventos e comandos específicos do tema `Pasteboard`. -- **Automático**: nesse modo, 4D **cópia** o texto ou as imagens diretamente do objeto formulário. Poderá então ser utilizado na mesma área de 4D, entre duas áreas 4D ou entre 4D e outra aplicação. Por exemplo, o arrastar (e soltar) automático permite que você copie um valor entre dois campos sem usar programação:\ - ![](../assets/en/FormObjects/property_automaticDragDrop.png)\ - ![](../assets/en/FormObjects/property_automaticDragDrop2.png) - Nesse modo, o evento de formulário `On Begin Drag` NÃO é gerado. Si quiere "forzar" el uso del arrastre personalizado mientras está activado el arrastre automático, mantenga presionada la tecla **Alt** (Windows) o **Opción** (macOS) durante la acción. Esta opção não está disponível para as imagens. +- **Automático**: nesse modo, 4D **cópia** o texto ou as imagens diretamente do objeto formulário. Poderá então ser utilizado na mesma área de 4D, entre duas áreas 4D ou entre 4D e outra aplicação. For example, automatic drag (and drop) lets you copy a value between two fields without using programming: + ![](../assets/en/FormObjects/property_automaticDragDrop.png) + ![](../assets/en/FormObjects/property_automaticDragDrop2.png)
    + In this mode, the `On Begin Drag` form event is NOT generated. Si quiere "forzar" el uso del arrastre personalizado mientras está activado el arrastre automático, mantenga presionada la tecla **Alt** (Windows) o **Opción** (macOS) durante la acción. Esta opção não está disponível para as imagens. Para más información, consulte [Arrastrar y soltar](https://doc.4d.com/4Dv20/4D/20.6/Drag-and-Drop.300-7487471.en.html) en el manual *Lenguaje 4D*. @@ -191,15 +191,15 @@ Em outros casos (list box baseados em seleções nomeadas, colunas associadas co ## Ação padrão -Atividades típicas a serem executadas por objetos ativos (\*e.g., permitindo que o usuário aceite, cancele ou exclua registros, mova entre registros ou de página para página em um formulário multi-páginas, etc.) foi predefinido por 4D como ações padrão. Eles são descritos em detalhes na seção [Ações padrão](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) do *manual de Desenho*. +Atividades típicas a serem executadas por objetos ativos (\*e.g., permitindo que o usuário aceite, cancele ou exclua registros, mova entre registros ou de página para página em um formulário multi-páginas, etc.) foi predefinido por 4D como ações padrão. Eles são descritos em detalhes na seção [Ações padrão](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) do *manual de Desenho*. There are also [standard actions specific to 4D Write Pro areas](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). Você pode atribuir uma ação padrão e um método projeto de um objeto. Neste caso, a ação padrão é geralmente executada depois que o método e o 4D usa esta ação para ativar/desativar o objeto conforme o contexto atual. Quando um objeto é desativado, o método projeto associado não pode ser executado. #### Gramática JSON -| Nome | Tipo de dados | Valores possíveis | -| ------ | ------------- | -------------------------------------------------------------------------------------------------------------------------- | -| action | string | O nome de uma [ação padrão válida](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html). | +| Nome | Tipo de dados | Valores possíveis | +| ------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| action | string | The name of a valid [standard action](https://doc.4d.com/4Dv20/4D/20.2/Standard-actions.300-6750239.en.html) or [4D Write Pro standard action](../WritePro/user-legacy/defining-a-4d-write-pro-area.md#standard-actions). | #### Objectos suportados From e32275f2704a0061c41784a330b485269c7e035b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:23:17 +0200 Subject: [PATCH 151/201] New translations $filter.md (Spanish) --- i18n/es/docusaurus-plugin-content-docs/current/REST/$filter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/REST/$filter.md b/i18n/es/docusaurus-plugin-content-docs/current/REST/$filter.md index 87fad52e60c764..42725545b33289 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/REST/$filter.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/REST/$filter.md @@ -27,7 +27,7 @@ Por ejemplo: `$filter="firstName=john AND salary>20000"` donde `firstName` y `sa ### Utilizar la propiedad params -You can also use 4D's `params` property which is a collection of values. +También puede utilizar la propiedad `params` de 4D, que es una colección de valores. **\{attribute\} {comparator} {placeholder} {AND/OR/EXCEPT} \{attribute\} {comparator} {placeholder}&$params='["{value1}","{value2}"]'** From 6602d2f5ca6ff73a876118559096bec603b35512 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:35:06 +0200 Subject: [PATCH 152/201] New translations sessions.md (French) --- .../current/WebServer/sessions.md | 68 +++++++++---------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md index 6fcb2a97a4df8a..20caa69023fa0f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Articles de blog sur le sujet -Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: @@ -344,24 +344,24 @@ sequenceDiagram FrontEnd ->>+ 4DServer: Validate() - 4DServer ->> 4DServer: Generate OTP with session.createOTP() + 4DServer ->> 4DServer: Créer OTP avec session.createOTP() Note over 4DServer: e.g. OTP is 2E5D0D5xxx - 4DServer ->> ExternalPlatform: Call the external platform giving the OTP, for example as a state parameter (depends on the platform) + 4DServer ->> ExternalPlatform: Appel de la plate-forme externe en donnant l'OTP, par exemple sous forme de paramètre state (dépend de la plate-forme) Note right of 4DServer: e.g. https://thirdPartSystem.com/validate?state=2E5D0D5xxx&redirect_uri=https://acme.com/my4DApp/completeOperation - Note right of 4DServer: The callback URL will be like: https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - ExternalPlatform ->> ExternalPlatform: Process request - ExternalPlatform ->> 4DServer: The state parameter is sent back by the third party system in the callback + Note right of 4DServer: L'URLde rappel sera du type : https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx + ExternalPlatform ->> ExternalPlatform: Traitement de la requête + ExternalPlatform ->> 4DServer: Le paramètre state est renvoyé par le système tiers dans la callback Note right of 4DServer: e.g. https://acme.com/my4DApp/completeOperation?state=2E5D0D5xxx - 4DServer ->> 4DServer: An HTTP request handler processes the URL pattern "/my4DApp/completeOperation"
    (e.g. handleOperation() function of the OperationHandler singleton, see code below) + 4DServer ->> 4DServer: Un HTTP request handler traite le motif d'URL "/my4DApp/completeOperation"
    (e.g. fonction handleOperation() du singleton OperationHandler, voir code ci-dessous) 4DServer ->> 4DServer: Session.restore() - Note over 4DServer:The state parameter is got from the received request ($req.urlQuery.state) - Note over 4DServer:The original session is retrieved by calling the restore() function - Note over 4DServer:Session object refers to the session which generated the OTP - 4DServer ->>+ FrontEnd: Restore session + Note over 4DServer:Le paramètre state est extrait de la requête reçue ($req.urlQuery.state) + Note over 4DServer:La session originale est restaurée par l'appel à la fonction restore() + Note over 4DServer: L'objet Session référence la session qui a généré l'OTP + 4DServer ->>+ FrontEnd: Restauration de la session ``` @@ -388,9 +388,9 @@ shared singleton Class constructor() Session.restore($req.urlQuery.state) ``` -### Example of email validation with $4DSID +### Exemple de validation d'email avec $4DSID -1. A user account is created in a *Users* dataclass. A *$info* object is received with the email and password. An OTP corresponding to the current session is generated. An URL is then returned with this OTP given in the $4DSID parameter. +1. Un compte d'utilisateur est créé dans une dataclass *Users*. Un objet *$info* est reçu avec l'email et le mot de passe. Un OTP correspondant à la session courante est généré. Une URL est alors renvoyée avec l'OTP indiqué dans le paramètre $4DSID. ```4d //cs.Users class @@ -401,26 +401,26 @@ var $user : cs.UsersEntity var $status : Object var $token : Text -$user:=This.new() //create a new user +$user:=This.new() //créatoin d'un user $user.fromObject($info) $status:=$user.save() -//Store information in the session -//including user creation status +//Stockage d'information dans la session +//y compris le statut de création de l'utilisateur Use (Session.storage) Session.storage.status:=New shared object("step"; "Waiting for validation email"; / "email"; $user.email; "ID"; $user.ID) End use -//Generate an OTP corresponding to the session +//Génération d'un OTP correspondant à la session $token:=Session.createOTP() -// Return an URL with a $4DSID parameter +// Renvoi d'un URL avec un paramètre $4DSID return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ``` -2. The user is sent this URL as a link in an email. The URL prefix `/validateEmail` is handled by a [custom HTTP request handler](./http-request-handler.md): +2. L'utilisateur reçoit cette URL sous la forme d'un lien dans un courrier électronique. Le préfixe d'URL `/validateEmail` est traité par un [gestionnaire de requête HTTP personnalisé](./http-request-handler.md) : ```json [ @@ -433,7 +433,7 @@ return "https://my.server.com/tools/validateEmail?$4DSID="+$token` ] ``` -The *validateEmail()* function of the RequestHandler singleton: +La fonction *validateEmail()* du singleton RequestHandler : ```4d //validateEmail class @@ -443,12 +443,12 @@ shared singleton Class constructor() Function validateEmail() : 4D.OutgoingMessage var $result:=4D.OutgoingMessage.new() - //The session which generated the OTP is retrieved - //thanks to the $4DSID parameter given in the URL + //La session qui a généré l'OTP est restaurée + //grâce au paramètre $4DSID fourni dans l'URL If (Session.storage.status.step="Waiting for validation email") $user:=ds.Users.get(Session.storage.status.ID) - $user.emailValidated() //set to true + $user.emailValidated() //fixé à vrai $result.setBody("Congratulations
    "\ +"Your email "+Session.storage.status.email+" has been validated") @@ -466,21 +466,21 @@ Function validateEmail() : 4D.OutgoingMessage ``` -Since the `$4DSID` parameter contains a valid OTP corresponding to the original session, the `Session` object refers to the session that created the OTP. +Comme le paramètre `$4DSID` contient un OTP valide correspondant à la session d'origine, l'objet `Session` référence la session qui a créé l'OTP. -A new user is created, and some information is stored in the session, especially the current step of the user account creation process (Waiting for validation email) and the user ID. +Un nouvel utilisateur est créé et des informations sont stockées dans la session, en particulier l'étape courante du processus de création du compte utilisateur (attente du courriel de validation) et l'identifiant de l'utilisateur. -### Supported contexts +### Contextes pris en charge -- Both HTTP and HTTPS schemas are supported. -- Only [scalable sessions](#enabling-web-sessions) can be reused with tokens. -- Only sessions of the host database can be reused (sessions created in component web servers cannot be restored). -- Tokens are not supported with client/server sessions or single-user sessions. +- Les schémas HTTP et HTTPS sont tous deux pris en charge. +- Seules des [sessions évolutives](#enabling-web-sessions) peuvent être réutilisées avec des tokens. +- Seules les sessions de la base de données hôte peuvent être réutilisées (les sessions créées dans les serveurs web des composants ne peuvent pas être restaurées). +- Les tokens ne sont pas pris en charge dans les sessions client/serveur ou les sessions mono-utilisateur. -### Lifespan +### Durée de vie -A session token has a lifespan, and the session itself has a lifespan. The session token lifespan can be set [at the token creation](../API/SessionClass.md#createotp). By default, the token lifespan is the same value as the [`.idleTimeout`](../API/SessionClass.md#idletimeout) value. +Un token de session a une durée de vie, et la session elle-même a une durée de vie. La durée de vie du token de session peut être définie [lors de sa création](../API/SessionClass.md#createotp). Par défaut, la durée de vie du token est la même que la valeur [`.idleTimeout`](../API/SessionClass.md#idletimeout). -A session is only restored by a token if both the session token lifespan and the session lifespan have not expired. In other cases (the session token has expired and/or the session itself has expired), a guest session is created when a web request with a session token is received. +Une session n'est restaurée par un token que si ni la durée de vie du token de session ni celle de la session n'ont expiré. Dans les autres cas (le token de session a expiré et/ou la session elle-même a expiré), une session *guest* est créée lorsqu'une requête web avec un token de session est reçue. From e6bceb6020aa4a8af3bc5acefe829a4bff374f25 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:35:23 +0200 Subject: [PATCH 153/201] New translations sessions.md (Spanish) --- .../current/WebServer/sessions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md index b2a3a87835a17c..dfb4e76c1380da 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Entradas de blog relacionadas -Para más ejemplos, por favor consulte la publicación de blog [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: @@ -477,7 +477,7 @@ Se crea un nuevo usuario y se almacena cierta información en la sesión, especi - Sólo se pueden reutilizar las sesiones de la base de datos local (las sesiones creadas en servidores web de componentes no se pueden restaurar). - Los tokens no son compatibles con las sesiones cliente/servidor ni con las sesiones monousuario. -### Lifespan +### Vida útil Un testigo de sesión tiene una vida útil, y la propia sesión tiene una vida útil. El tiempo de vida útil del token de sesión puede definirse [en la creación de tokens](../API/SessionClass.md#createotp). Por defecto, el tiempo de vida del token es el mismo valor que el valor de [`.idleTimeout`](../API/SessionClass.md#idletimeout). From 83cd57796f7ec2b3a672550076b26a2c267df492 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:35:43 +0200 Subject: [PATCH 154/201] New translations sessions.md (Japanese) --- .../current/WebServer/sessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md index aef3a4ae864205..aec14fa9fb346b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -201,7 +201,7 @@ Else End if ``` -:::note +:::tips 関連したblog 記事 [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) From cf1c97211fdaf178fda81d8b7f97dabaa8b18eb6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 04:36:01 +0200 Subject: [PATCH 155/201] New translations sessions.md (Portuguese, Brazilian) --- .../current/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/sessions.md index 2471ddb6831c51..1a02e189b920b6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Related blog posts -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +[Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From e480271d3ff3616ec075a81f67ed35caf153fbd1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:46:39 +0200 Subject: [PATCH 156/201] New translations http-request-handler.md (Spanish) --- .../current/WebServer/http-request-handler.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index facb115670bf95..e0a480493e6133 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -28,7 +28,7 @@ For security reasons, external access to the datastore can be disallowed in 4D. ::: -## How to set handlers +## Cómo definir los manejadores You can declare HTTP Request handlers: From 21205183c775e81555f281299189dce2f7411376 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:48:59 +0200 Subject: [PATCH 157/201] New translations tcpeventclass.md (Spanish) --- .../current/API/TCPEventClass.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/TCPEventClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/TCPEventClass.md index 1bd070ea6af91a..20c901bac3061d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/TCPEventClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/TCPEventClass.md @@ -81,9 +81,9 @@ La propiedad `.type` contiene el tipo del eve - `"connection"`: Indicates that a TCPConnection was successfully established. - `"data"`: indica que los datos han sido recibidos. -- `"error"`: Indicates that an error occurred during the TCPConnection. -- `"close"`: Indicates that the TCPConnection has been properly closed. -- `"terminate"`: Indicates that the TCPConnection is about to be released. +- `"error"`: indica que se ha producido un error durante la TCPConnection. +- `"close"`: indica que la TCPConnection ha sido correctamente cerrada. +- `"terminate"`: indica que el TCPConnection está a punto de ser liberado. From 71df8085bcabca40a6e9c53b2044e3c0215c7ad1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:56:56 +0200 Subject: [PATCH 158/201] New translations openaichatcompletionsmessagesapi.md (Spanish) --- .../current/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md index 9c3c1c18655023..65f84b56f8d1ba 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md @@ -19,6 +19,6 @@ The `OpenAIChatCompletionsMessagesAPI` class is designed to interact with the Op | *parámetros* | `OpenAIChatCompletionsMessagesParameters` | Parámetros para filtrar y personalizar la respuesta. | | Resultado | Variant | The retrieved messages associated with the chat completion. | -The `list()` function retrieves messages associated with a specific chat completion ID. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. +La función `list()` recupera los mensajes asociados a un ID de finalización de chat específico. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. https://platform.openai.com/docs/api-reference/chat/getMessages From b778c358cbbaadedaa8683987e276020c56da7f8 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:56:58 +0200 Subject: [PATCH 159/201] New translations openaichatcompletionsparameters.md (Spanish) --- .../OpenAIChatCompletionsParameters.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md index 2d506c2ba0ee11..db1b10b9ec0ee7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatCompletionsParameters.md @@ -13,26 +13,26 @@ The `OpenAIChatCompletionParameters` class is designed to handle the parameters ## Propiedades -| Propiedad | Tipo | Valor por defecto | Descripción | -| ----------------------- | ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | `"gpt-4o-mini"` | ID del modelo a utilizar. | -| `stream` | Boolean | `False` | Si se retransmite el progreso parcial. Si se define, los tokens se enviarán solo como datos. Fórmula de retrollamada necesaria. | -| `stream_options` | Object | `Null` | Property for stream=True. For example: `{include_usage: True}` | -| `max_completion_tokens` | Integer | `0` | The maximum number of tokens that can be generated in the completion. | -| `n` | Integer | `1` | How many completions to generate for each prompt. | -| `temperature` | Real | `-1` | Qué temperatura de muestreo utilizar, entre 0 y 2. Higher values make the output more random, while lower values make it more focused and deterministic. | -| `store` | Boolean | `False` | Whether or not to store the output of this chat completion request. | -| `reasoning_effort` | Text | `Null` | Constrains effort on reasoning for reasoning models. Currently supported values are `"low"`, `"medium"`, and `"high"`. | -| `response_format` | Object | `Null` | An object specifying the format that the model must output. Compatible with structured outputs. | -| `herramientas` | Collection | `Null` | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported. | -| `tool_choice` | Variant | `Null` | Controls which (if any) tool is called by the model. Can be `"none"`, `"auto"`, `"required"`, or specify a particular tool. | -| `prediction` | Object | `Null` | Static predicted output content, such as the content of a text file that is being regenerated. | +| Propiedad | Tipo | Valor por defecto | Descripción | +| ----------------------- | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | `"gpt-4o-mini"` | ID del modelo a utilizar. | +| `stream` | Boolean | `False` | Si se retransmite el progreso parcial. Si se define, los tokens se enviarán solo como datos. Fórmula de retrollamada necesaria. | +| `stream_options` | Object | `Null` | Property for stream=True. Por ejemplo: `{include_usage: True}` | +| `max_completion_tokens` | Integer | `0` | The maximum number of tokens that can be generated in the completion. | +| `n` | Integer | `1` | How many completions to generate for each prompt. | +| `temperature` | Real | `-1` | Qué temperatura de muestreo utilizar, entre 0 y 2. Higher values make the output more random, while lower values make it more focused and deterministic. | +| `store` | Boolean | `False` | Whether or not to store the output of this chat completion request. | +| `reasoning_effort` | Text | `Null` | Constrains effort on reasoning for reasoning models. Los valores soportados actualmente son `"low"`, `"medium"` y `"high"`. | +| `response_format` | Object | `Null` | An object specifying the format that the model must output. Compatible with structured outputs. | +| `herramientas` | Collection | `Null` | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported. | +| `tool_choice` | Variant | `Null` | Controls which (if any) tool is called by the model. Puede ser `"none"`, `"auto"`, `"required"`, o especificar una herramienta concreta. | +| `prediction` | Object | `Null` | Static predicted output content, such as the content of a text file that is being regenerated. | ### Propiedades de retrollamada asíncrona -| Propiedad | Tipo | Descripción | -| ------------------------------------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `onData` (or `formula`) | 4D.Function | A function to be called asynchronously when receiving data chunk. Asegúrese de que el proceso actual no termina. | +| Propiedad | Tipo | Descripción | +| ----------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `onData` (o `formula`) | 4D.Function | A function to be called asynchronously when receiving data chunk. Asegúrese de que el proceso actual no termina. | `onData` will receive as argument an [OpenAIChatCompletionsStreamResult](./OpenAIChatCompletionsStreamResult.md). @@ -119,7 +119,7 @@ $result := $client.chat.completions.create($messages; $params) When using `json_schema` type, you can specify: -- **`name`**: A name for the schema +- **`name`**: un nombre para el esquema - **`description`**: A description of what the schema represents - **`schema`**: The JSON schema definition - **`strict`**: Whether to enforce strict adherence to the schema From e09281c98c930d19411c152ec68588c76d51bec3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:57:05 +0200 Subject: [PATCH 160/201] New translations openaiimage.md (Spanish) --- .../current/aikit/Classes/OpenAIImage.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImage.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImage.md index 09e15a20df5e90..9009658de82b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImage.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImage.md @@ -5,17 +5,17 @@ title: OpenAIImage # OpenAIImage -The `OpenAIImage` class represents an image generated by the OpenAI API. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. +La clase `OpenAIImage` representa una imagen generada por la API OpenAI. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. https://platform.openai.com/docs/api-reference/images/object ## Propiedades -| Propiedad | Tipo | Descripción | -| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------- | -| `url` | Text | The URL of the generated image, if `response_format` is `url` (default). | -| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | -| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | +| Propiedad | Tipo | Descripción | +| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------- | +| `url` | Text | La URL de la imagen generada, si `response_format` es `url` (por defecto). | +| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | +| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | ## Funciones From 113980c28ef1055748e05065606f12bcdca926f2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:57:07 +0200 Subject: [PATCH 161/201] New translations openaiimageparameters.md (Spanish) --- .../current/aikit/Classes/OpenAIImageParameters.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md index 167f8ab9d4ac4b..d50e4af6583cb9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImageParameters.md @@ -18,8 +18,8 @@ The `OpenAIImageParameters` class is designed to configure and manage the parame | `model` | Text | "dall-e-2" | Especifica el modelo a utilizar para la generación de imágenes. | | `n` | Integer | 1 | The number of images to generate (must be between 1 and 10; only `n=1` is supported for `dall-e-3`). | | `size` | Text | "1024x1024" | El tamaño de las imágenes generadas. Debe ajustarse a las especificaciones del modelo. | -| `style` | Text | "" | The style of the generated images (must be either `vivid` or `natural`). | -| `response_format` | Text | "url" | The format for returned images, can be either `url` or `b64_json`. | +| `style` | Text | "" | El estilo de las imágenes generadas (debe ser `vivid` o `natural`). | +| `response_format` | Text | "url" | El formato de las imágenes devueltas puede ser `url` o `b64_json`. | ## Ver también From a72a5f4d721286bf0b510559e4fe293fafd263b5 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:57:08 +0200 Subject: [PATCH 162/201] New translations openaiimagesapi.md (Spanish) --- .../current/aikit/Classes/OpenAIImagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImagesAPI.md index 3797cb01095e30..4ffe3a9911bd80 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIImagesAPI.md @@ -5,7 +5,7 @@ title: OpenAIImagesAPI # OpenAIImagesAPI -The `OpenAIImagesAPI` provides functionalities to generate images using OpenAI's API. +La `OpenAIImagesAPI` ofrece funcionalidades para generar imágenes utilizando la API de OpenAI. https://platform.openai.com/docs/api-reference/images From 567bc4905330b9785d3de692c01514f198c751bb Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:57:52 +0200 Subject: [PATCH 163/201] New translations openaimessage.md (Spanish) --- .../current/aikit/Classes/OpenAIMessage.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIMessage.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIMessage.md index f8259807424811..ab4ca22c87ed49 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIMessage.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIMessage.md @@ -9,13 +9,13 @@ The `OpenAIMessage` class represents a structured message containing a role, con ## Propiedades -| Propiedad | Tipo | Descripción | -| -------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `rol` | Text | The role of the message (e.g., "user", "assistant", "system", "tool"). | -| `contenido` | Variant | The content of the message, which can be a text or a collection of objects. | -| `user` | Text | An optional property representing the user associated with the message. | -| `tool_calls` | Collection | A collection of tool calls requested by the assistant. Each tool call contains an `id`, `type`, and a `function` object. | -| `tool_call_id` | Text | The ID of the tool call that this message is responding to (used when `role` is "tool"). | +| Propiedad | Tipo | Descripción | +| -------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `rol` | Text | The role of the message (e.g., "user", "assistant", "system", "tool"). | +| `contenido` | Variant | The content of the message, which can be a text or a collection of objects. | +| `user` | Text | An optional property representing the user associated with the message. | +| `tool_calls` | Collection | A collection of tool calls requested by the assistant. Cada llamada a una herramienta contiene un objeto `id`, `type` y `function`. | +| `tool_call_id` | Text | The ID of the tool call that this message is responding to (used when `role` is "tool"). | ## Propiedades calculadas From d335d9e4c20c905ab1e5a9a51edaa8dd724fcbd3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 05:59:37 +0200 Subject: [PATCH 164/201] New translations orda-events.md (Spanish) --- .../current/ORDA/orda-events.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md index 086ad86ee9d7d0..f6b897a82a5694 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/orda-events.md @@ -1,6 +1,6 @@ --- id: orda-events -title: Events +title: Eventos ---
    Historia @@ -58,21 +58,21 @@ Con otras configuraciones remotas (p. ej. Qodly applications, [REST API requests La siguiente tabla lista los eventos ORDA junto con sus reglas. -| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | Can stop action by returning an error | -| :------------------------- | :------- | :------------------------------------------------------ | :------------------------------------------------------------------: | ------------------------------------- | -| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | no | -| Atributo tocado | Atributo | `event touched ()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | no | -| | Entity | `event touched()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | no | -| Before saving an entity | Atributo | `validateSave ()` | server | sí | -| | Entity | `validateSave()` | server | sí | -| When saving an entity | Atributo | `saving ()` | server | sí | -| | Entity | `saving()` | server | sí | -| After saving an entity | Entity | `afterSave()` | server | no | -| Before dropping an entity | Atributo | `validateDrop ()` | server | sí | -| | Entity | `validateDrop()` | server | sí | -| When dropping an entity | Atributo | `dropping ()` | server | sí | -| | Entity | `dropping()` | server | sí | -| After dropping an entity | Entity | `afterDrop()` | server | no | +| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | Can stop action by returning an error | +| :------------------------- | :------- | :------------------------------------------------------ | :---------------------------------------------------------------------------: | ------------------------------------- | +| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | no | +| Atributo tocado | Atributo | `event touched ()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | no | +| | Entity | `event touched()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | no | +| Before saving an entity | Atributo | `validateSave ()` | server | sí | +| | Entity | `validateSave()` | server | sí | +| When saving an entity | Atributo | `saving ()` | server | sí | +| | Entity | `saving()` | server | sí | +| After saving an entity | Entity | `afterSave()` | server | no | +| Before dropping an entity | Atributo | `validateDrop ()` | server | sí | +| | Entity | `validateDrop()` | server | sí | +| When dropping an entity | Atributo | `dropping ()` | server | sí | +| | Entity | `dropping()` | server | sí | +| After dropping an entity | Entity | `afterDrop()` | server | no | :::note @@ -89,12 +89,12 @@ Event functions accept a single *event* object as parameter. When the function i | "kind" | siempre | String | Event name: "touched", "validateSave", "saving", "afterSave", "validateDrop", "dropping", "afterDrop" | | | *attributeName* | Only for events implemented at attribute level ("validateSave", "saving", "validateDrop", "dropping") | String | Nombre del atributo (por ejemplo, "nombre") | | | *dataClassName* | siempre | String | Nombre de la Dataclass (*ej.* "Company") | | -| "savedAttributes" | Only in [`afterSave()`](#function-event-aftersave) | Collection of String | Names of attributes properly saved | | -| "droppedAttributes" | Only in [`afterDrop()`](#function-event-afterdrop) | Collection of String | Names of attributes properly dropped | | +| "savedAttributes" | Only in [`afterSave()`](#function-event-aftersave) | Colección de cadenas | Names of attributes properly saved | | +| "droppedAttributes" | Only in [`afterDrop()`](#function-event-afterdrop) | Colección de cadenas | Names of attributes properly dropped | | | "saveStatus" | Only in [`afterSave()`](#function-event-aftersave) | String | "success" if the save was successful, "failed" otherwise | | | "dropStatus" | Only in [`afterDrop()`](#function-event-afterdrop) | String | "success" if the drop was successful, "failed" otherwise | | -## Error object +## Objeto de error [Some event functions](#summary-table) can return an **error object** to raise an error and stop the running action. @@ -102,7 +102,7 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| Propiedad | Tipo | Descripción | Set by the developer | +| Propiedad | Tipo | Descripción | Definido por el desarrollador | | ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | | message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | From 426e92a371e01e59cbaaf746ae83a9260a2b2968 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:03:58 +0200 Subject: [PATCH 165/201] New translations tcpeventclass.md (Spanish) --- .../version-20-R10/API/TCPEventClass.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md index 1bd070ea6af91a..20c901bac3061d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/API/TCPEventClass.md @@ -81,9 +81,9 @@ La propiedad `.type` contiene el tipo del eve - `"connection"`: Indicates that a TCPConnection was successfully established. - `"data"`: indica que los datos han sido recibidos. -- `"error"`: Indicates that an error occurred during the TCPConnection. -- `"close"`: Indicates that the TCPConnection has been properly closed. -- `"terminate"`: Indicates that the TCPConnection is about to be released. +- `"error"`: indica que se ha producido un error durante la TCPConnection. +- `"close"`: indica que la TCPConnection ha sido correctamente cerrada. +- `"terminate"`: indica que el TCPConnection está a punto de ser liberado. From 9a4a7258f65344757a32d1c99cdf424b50ed106e Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:22:38 +0200 Subject: [PATCH 166/201] New translations orda-events.md (Spanish) --- .../version-20-R10/ORDA/orda-events.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md index 163716adebf666..0e431ff13cc080 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ORDA/orda-events.md @@ -51,11 +51,11 @@ Con otras configuraciones remotas (p. ej. Qodly applications, [REST API requests La siguiente tabla lista los eventos ORDA junto con sus reglas. -| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | -| :------------------------- | :------- | :------------------------------------------------------ | :------------------------------------------------------------------: | -| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | -| Atributo tocado | Atributo | `event touched ()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | -| | Entity | `event touched()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | +| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | +| :------------------------- | :------- | :------------------------------------------------------ | :---------------------------------------------------------------------------: | +| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | +| Atributo tocado | Atributo | `event touched ()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | +| | Entity | `event touched()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | :::note From d6dd4a78314105bfaaec2d2ef3ad9cc072e8b77b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:29:21 +0200 Subject: [PATCH 167/201] New translations vp-copy-to-object.md (Spanish) --- .../version-20-R10/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-copy-to-object.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-copy-to-object.md index b551849007c39b..7d54ed71a42c0f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ En *rangeObj*, pase el rango de celdas con los valores, formato y fórmulas a co Puede pasar un parámetro opcional *options* con las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | -| copyOptions | Integer | Especifica lo que se copia o mueve. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copies only the formatting.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | +| Propiedad | Tipo | Descripción | +| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | +| copyOptions | Integer | Especifica lo que se copia o mueve. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copia solo el formato.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From d97e139626ffc05ff64728b1db9459ff67c9b281 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:33:05 +0200 Subject: [PATCH 168/201] New translations vp-move-cells.md (Spanish) --- .../version-20-R10/ViewPro/commands/vp-move-cells.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-move-cells.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-move-cells.md index dd9df040b43600..adfb613719d267 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-move-cells.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/ViewPro/commands/vp-move-cells.md @@ -35,10 +35,10 @@ En *targetRange*, pase el rango de celdas donde se copiarán o moverán los valo El parámetro *options* tiene varias propiedades: -| Propiedad | Tipo | Descripción | -| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | -| pasteOptions | Integer | Especifica lo que se pega. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Pastes all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Pastes only the formatting.
    `vk clipboard options formulas`Pastes only the formulas.
    `vk clipboard options formulas and formatting`Pastes the formulas and formatting.
    `vk clipboard options values`Pastes only the values.
    `vk clipboard options value and formatting`Pastes the values and formatting.

    | +| Propiedad | Tipo | Descripción | +| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | +| pasteOptions | Integer | Especifica lo que se pega. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Pastes all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Pega solo el formato.
    `vk clipboard options formulas`Pega sólo las fórmulas.
    `vk clipboard options formulas and formatting`Pastes the formulas and formatting.
    `vk clipboard options values`Pastes only the values.
    `vk clipboard options value and formatting`Pastes the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From 8235f0c9812ad3d8346dfbe253522c362ac45456 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:37:32 +0200 Subject: [PATCH 169/201] New translations sessions.md (French) --- .../version-20-R10/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md index 65e34e8f83ca65..4e83fc460e136d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Articles de blog sur le sujet -Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From d336e2e1256b9264392656cdd252d7aca3dffab6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:37:48 +0200 Subject: [PATCH 170/201] New translations sessions.md (Spanish) --- .../version-20-R10/WebServer/sessions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md index d55cb1504a87ae..7fe5e2c40f7db0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Entradas de blog relacionadas -Para más ejemplos, por favor consulte la publicación de blog [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: @@ -471,7 +471,7 @@ Se crea un nuevo usuario y se almacena cierta información en la sesión, especi - Sólo se pueden reutilizar las sesiones de la base de datos local (las sesiones creadas en servidores web de componentes no se pueden restaurar). - Los tokens no son compatibles con las sesiones cliente/servidor ni con las sesiones monousuario. -### Lifespan +### Vida útil Un testigo de sesión tiene una vida útil, y la propia sesión tiene una vida útil. El tiempo de vida útil del token de sesión puede definirse [en la creación de tokens](../API/SessionClass.md#createotp). Por defecto, el tiempo de vida del token es el mismo valor que el valor de [`.idleTimeout`](../API/SessionClass.md#idletimeout). From 8bd4610391e6e700a41c285caf0eb72241b37bb8 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:38:05 +0200 Subject: [PATCH 171/201] New translations sessions.md (Japanese) --- .../version-20-R10/WebServer/sessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md index bc02e94eaca792..d2391813312363 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md @@ -201,7 +201,7 @@ Else End if ``` -:::note +:::tips 関連したblog 記事 [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) From 7eb7340fa84c09d42c7496f9fe0e9ce2cea58b95 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:38:23 +0200 Subject: [PATCH 172/201] New translations sessions.md (Portuguese, Brazilian) --- .../version-20-R10/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md index c1f821ac13c915..1dbedd8c5da236 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R10/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Related blog posts -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +[Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From 311088fbb8665a9b73a9f21cd8811beb61606155 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:40:46 +0200 Subject: [PATCH 173/201] New translations openaichatcompletionsmessagesapi.md (Spanish) --- .../aikit/Classes/OpenAIChatCompletionsMessagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md index 9c3c1c18655023..65f84b56f8d1ba 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md @@ -19,6 +19,6 @@ The `OpenAIChatCompletionsMessagesAPI` class is designed to interact with the Op | *parámetros* | `OpenAIChatCompletionsMessagesParameters` | Parámetros para filtrar y personalizar la respuesta. | | Resultado | Variant | The retrieved messages associated with the chat completion. | -The `list()` function retrieves messages associated with a specific chat completion ID. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. +La función `list()` recupera los mensajes asociados a un ID de finalización de chat específico. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. https://platform.openai.com/docs/api-reference/chat/getMessages From d71f7c4312642c16060555bc9ce42cd3e4e6a43d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:41:41 +0200 Subject: [PATCH 174/201] New translations openaiimage.md (Spanish) --- .../version-20-R10/aikit/Classes/OpenAIImage.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImage.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImage.md index 09e15a20df5e90..9009658de82b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImage.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImage.md @@ -5,17 +5,17 @@ title: OpenAIImage # OpenAIImage -The `OpenAIImage` class represents an image generated by the OpenAI API. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. +La clase `OpenAIImage` representa una imagen generada por la API OpenAI. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. https://platform.openai.com/docs/api-reference/images/object ## Propiedades -| Propiedad | Tipo | Descripción | -| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------- | -| `url` | Text | The URL of the generated image, if `response_format` is `url` (default). | -| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | -| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | +| Propiedad | Tipo | Descripción | +| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------- | +| `url` | Text | La URL de la imagen generada, si `response_format` es `url` (por defecto). | +| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | +| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | ## Funciones From b4db377fa1aa0c75550a533a6c337ad47c7d6e9d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:41:42 +0200 Subject: [PATCH 175/201] New translations openaiimageparameters.md (Spanish) --- .../version-20-R10/aikit/Classes/OpenAIImageParameters.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImageParameters.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImageParameters.md index 167f8ab9d4ac4b..d50e4af6583cb9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImageParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImageParameters.md @@ -18,8 +18,8 @@ The `OpenAIImageParameters` class is designed to configure and manage the parame | `model` | Text | "dall-e-2" | Especifica el modelo a utilizar para la generación de imágenes. | | `n` | Integer | 1 | The number of images to generate (must be between 1 and 10; only `n=1` is supported for `dall-e-3`). | | `size` | Text | "1024x1024" | El tamaño de las imágenes generadas. Debe ajustarse a las especificaciones del modelo. | -| `style` | Text | "" | The style of the generated images (must be either `vivid` or `natural`). | -| `response_format` | Text | "url" | The format for returned images, can be either `url` or `b64_json`. | +| `style` | Text | "" | El estilo de las imágenes generadas (debe ser `vivid` o `natural`). | +| `response_format` | Text | "url" | El formato de las imágenes devueltas puede ser `url` o `b64_json`. | ## Ver también From 0ddecb79015cf744c85506e517594df2581b2317 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 06:41:44 +0200 Subject: [PATCH 176/201] New translations openaiimagesapi.md (Spanish) --- .../version-20-R10/aikit/Classes/OpenAIImagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImagesAPI.md index 3797cb01095e30..4ffe3a9911bd80 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/aikit/Classes/OpenAIImagesAPI.md @@ -5,7 +5,7 @@ title: OpenAIImagesAPI # OpenAIImagesAPI -The `OpenAIImagesAPI` provides functionalities to generate images using OpenAI's API. +La `OpenAIImagesAPI` ofrece funcionalidades para generar imágenes utilizando la API de OpenAI. https://platform.openai.com/docs/api-reference/images From 623fd9141dceef4ac9f677d981d6f6badb8fc3b1 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 07:58:20 +0200 Subject: [PATCH 177/201] New translations zip-create-archive.md (Spanish) --- .../version-20-R10/commands/zip-create-archive.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/zip-create-archive.md index 79d2786081e8cb..8d17f8e266c9d6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R10/commands/zip-create-archive.md @@ -44,7 +44,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | | level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: cifrado AES con una clave de 192 bits.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: los datos no se encriptan (por defecto si no se define contraseña).
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | | retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | From c86dd87b4c271607c5d2e2009e4f85181f069329 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:05:35 +0200 Subject: [PATCH 178/201] New translations openaitool.md (Spanish) --- .../current/aikit/Classes/OpenAITool.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md index 4a2bbe4632aec8..77620f6ef0ac24 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAITool.md @@ -20,7 +20,7 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. | `tipo` | Text | `"function"` | El tipo de herramienta. Currently supports `"function"`, `"custom"`, and other built-in types. | | `strict` | Boolean | `False` | Whether to enforce strict schema validation for function parameters. | -### Common Properties +### Propiedades comunes | Propiedad | Tipo | Descripción | | ------------- | ---- | ------------------------------------------------------------------------------ | @@ -46,7 +46,7 @@ See [OpenAIMessage](OpenAIMessage.md) to see how to responds to a tool call. Crea una nueva instancia de OpenAITool. The constructor accepts both simplified format and OpenAI API format. -#### Supported formats +#### Formatos soportados **Simplified format:** From 260e928b46026222cec9ecf5b744bd93a840db24 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:05:36 +0200 Subject: [PATCH 179/201] New translations http-rules.md (Spanish) --- .../current/WebServer/http-rules.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md index f45b8e7388655f..e88e079122443e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-rules.md @@ -14,7 +14,7 @@ HTTP rules are supported in the following contexts: - [scalable sessions](./sessions.md#enabling-web-sessions) or [no sessions](../settings/web.md#no-sessions) are enabled, - a web server run locally by 4D or 4D Server, including those [run by components](./webServerObject.md). -## How to set rules +## Cómo definir reglas You can declare HTTP response rules: @@ -29,7 +29,7 @@ If both a **HTTPRules.json** file and a call to the [`WEB Server`](../commands/w If the URI of the request does not match any of the RegEx patterns, the web server returns a default response. -## Rules Definition +## Definición de reglas The **HTTPRules.json** file or the [`.rules`](../API/WebServerClass.md#rules) property must contain a collection of **rule objects**. From 5ee73f68536e17b2102589c2e110875e65fb7bd6 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:06:45 +0200 Subject: [PATCH 180/201] New translations entityclass.md (French) --- .../docusaurus-plugin-content-docs/version-21/API/EntityClass.md | 1 - 1 file changed, 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index 013fbf6415a56d..80a165c602664d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -1015,7 +1015,6 @@ L'objet retourné par `.lock()` contient les propriétés suivantes : | ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants:
  • l'entité a été supprimée (le marqueur a changé et l'espace mémoire est maintenant libre)
  • l'entité a été supprimée et remplacée par une autre avec une autre clé primaire (le marqueur a changé et une nouvelle entité utilise maintenant l'espace mémoire). Lors de l'utilisation de `.drop()`, cette erreur peut être retournée lorsque l'option dk force drop if stamp changed est utilisée. Lors de l'utilisation de `.lock()`, cette erreur peut être retournée lorsque l'option `dk reload if stamp changed` est utilisée

    • **statusText associé** : "Entity does not exist anymore" | | `dk status locked` | 3 | L'entité est verrouillée par un verrou pessimiste.
    **statusText associé** : "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
    **statusText associé** : "Other error" | | `dk status stamp has changed` | 2 | La valeur du marqueur interne (stamp) de l'entité ne correspond pas à celle de l'entité stockée dans les données (verrouillage optimiste).
  • avec `.save()` : erreur seulement si l'option `dk auto merge` n'est pas utilisée
  • avec `.drop()` : erreur seulement si l'option `dk force drop if stamp changed` n'est pas utilisée
  • avec `.lock()` : erreur seulement si l'option `dk reload if stamp changed` n'est pas utilisée

    • **statusText associé** : "Stamp has changed" | From 370e9ebff3b738cc16a75229b859610c324d3e2f Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:07:02 +0200 Subject: [PATCH 181/201] New translations dataclassclass.md (Spanish) --- .../version-21/API/DataClassClass.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md index 53054ee02534df..94c42c36a6ddb5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md @@ -1187,11 +1187,11 @@ Si *attributePath* designa un atributo que almacena [**objetos vectores**](../AP En este caso, el parámetro *value* debe ser un **objeto vectorial de comparación** que contenga las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| vector | [4D.Vector](../API/VectorClass.md) | Obligatorio. El vector a comparar | -| metric | Text | Opcional. [Cálculo vectorial](../API/VectorClass.md#understanding-the-different-vector-computations) a utilizar para la consulta. You can use one of the following (Text) constants:
  • `mk cosine` (default if omitted): calculates the cosine distance between vectors.
  • `mk dot`: calculates the dot similarity of vectors.
  • `mk euclidean`: calculates the Euclidean distance between vectors. | -| threshold | Real | Opcional (por defecto: 0,5). Un valor umbral utilizado para filtrar las comparaciones de vectores en función de su puntuación de similitud coseno, punto o euclídea según la "métrica" seleccionada. Es altamente recomendable elegir una similitud que se adapte mejor a su caso de uso específico para obtener resultados óptimos. | +| Propiedad | Tipo | Descripción | +| --------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| vector | [4D.Vector](../API/VectorClass.md) | Obligatorio. El vector a comparar | +| metric | Text | Opcional. [Cálculo vectorial](../API/VectorClass.md#understanding-the-different-vector-computations) a utilizar para la consulta. You can use one of the following (Text) constants:
  • `mk cosine` (default if omitted): calculates the cosine distance between vectors.
  • `mk dot`: calculates the dot similarity of vectors.
  • `mk euclidean`: calcula la distancia euclidiana entre vectores. | +| threshold | Real | Opcional (por defecto: 0,5). Un valor umbral utilizado para filtrar las comparaciones de vectores en función de su puntuación de similitud coseno, punto o euclídea según la "métrica" seleccionada. Es altamente recomendable elegir una similitud que se adapte mejor a su caso de uso específico para obtener resultados óptimos. | Sólo se admite un subconjunto de símbolos **comparadores**. Tenga en cuenta que comparan los resultados con el valor umbral: From ce56491624b45bf8d24a389afc299ade1ac3039b Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:07:14 +0200 Subject: [PATCH 182/201] New translations entityclass.md (Spanish) --- .../version-21/API/EntityClass.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index 62663527a46221..b9b3e8e9e3a566 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -338,10 +338,10 @@ vCompareResult1 (se devuelven todas las diferencias):
    Historia -| Lanzamiento | Modificaciones | -| ----------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | -------------------------- | +| 21 | Añadidos los estados 7 y 8 | +| 17 | Añadidos |
    @@ -368,7 +368,7 @@ De lo contrario, puede pasar la opción `dk force drop if stamp changed` en el p **Resultado** -The object returned by `.drop()` contains the following properties: +El objeto devuelto por `.drop()` contiene las siguientes propiedades: | Propiedad | | Tipo | Descripción | | --------------------------------- | ----------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1019,7 +1019,6 @@ El objeto devuelto por `.lock()` contiene las siguientes propiedades: | ----------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | La entidad ya no existe en los datos. Este error puede ocurrir en los siguientes casos:
  • la entidad ha sido eliminada (el marcador ha cambiado y ahora el espacio de memoria está libre)
  • la entidad ha sido eliminada y reemplazada por otra con otra clave primaria (el marcador ha cambiado y una nueva entidad ahora utiliza el espacio memoria). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Cuando se utiliza `.lock()`, este error puede ser devuelto cuando se utiliza la opción `dk reload if stamp changed`

    • **statusText asociado**: "Entity does not exist anymore" | | `dk status locked` | 3 | La entidad está bloqueada por un bloqueo pesimista. **statusText asociado**: "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | A serious error is a low-level database error (e.g. duplicated key), a hardware error, etc.
    **Associated statusText**: "Other error" | | `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | @@ -1215,10 +1214,10 @@ El objeto devuelto por `.reload( )` contiene las siguientes propiedades:
    Historia -| Lanzamiento | Modificaciones | -| ----------- | -------------------- | -| 21 | Added status 7 and 8 | -| 17 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | -------------------------- | +| 21 | Añadidos los estados 7 y 8 | +| 17 | Añadidos |
    From 8a109788bdfaf4307f947cea34f20017fe3df8ed Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:07:41 +0200 Subject: [PATCH 183/201] New translations entityclass.md (Japanese) --- .../docusaurus-plugin-content-docs/version-21/API/EntityClass.md | 1 - 1 file changed, 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index ea05954febe964..4897fd58447bba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -1020,7 +1020,6 @@ $info:=$address.getRemoteContextAttributes() | ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. `entity.lock()` を使用するとき、このエラーは `dk reload drop if stamp changed` オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | | `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | From bb11f0c31860536d40196c60dc6d35f116c4c4a9 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:08:06 +0200 Subject: [PATCH 184/201] New translations entityclass.md (Portuguese, Brazilian) --- .../docusaurus-plugin-content-docs/version-21/API/EntityClass.md | 1 - 1 file changed, 1 deletion(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index aa53eca5061903..5b354dc41f420e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -1017,7 +1017,6 @@ O objeto retornado por `.lock()` contém as seguintes propriedades: | ----------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | A entidade não existe mais nos dados. Esse erro pode ocorrer nos seguintes casos
  • :a entidade foi descartada (o carimbo foi alterado e o espaço de memória agora está livre)
  • a entidade foi descartada e substituída por outra com outra chave primária (o carimbo foi alterado e uma nova entidade agora usa o espaço de memória). When using `.drop()`, this error can be returned when dk force drop if stamp changed option is used. Quando usando `. ock()`, este erro pode ser retornado quando a opção `dk reload se o carimbo mudar` é usada

    • **Associado statusText**: "Entidade não existe mais" | | `dk status locked` | 3 | A entidade está bloqueada por um bloqueio pessimista.**statusText associado**: "Already locked" | -| `dk status mild validation error` | 7 | Can be returned by the developer only in validate events and do not require | | `dk status serious error` | 4 | A serious error is a low-level database error (e.g. duplicated key), a hardware error, etc.
    **Associated statusText**: "Other error" | | `dk status stamp has changed` | 2 | The internal stamp value of the entity does not match the one of the entity stored in the data (optimistic lock).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used

    • **Associated statusText**: "Stamp has changed" | From f414e0618b34ab3e9b8502c8961ffb1fb99e2170 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:08:54 +0200 Subject: [PATCH 185/201] New translations tcpeventclass.md (Spanish) --- .../version-21/API/TCPEventClass.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/API/TCPEventClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21/API/TCPEventClass.md index 1bd070ea6af91a..20c901bac3061d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/API/TCPEventClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/API/TCPEventClass.md @@ -81,9 +81,9 @@ La propiedad `.type` contiene el tipo del eve - `"connection"`: Indicates that a TCPConnection was successfully established. - `"data"`: indica que los datos han sido recibidos. -- `"error"`: Indicates that an error occurred during the TCPConnection. -- `"close"`: Indicates that the TCPConnection has been properly closed. -- `"terminate"`: Indicates that the TCPConnection is about to be released. +- `"error"`: indica que se ha producido un error durante la TCPConnection. +- `"close"`: indica que la TCPConnection ha sido correctamente cerrada. +- `"terminate"`: indica que el TCPConnection está a punto de ser liberado. From b85abb1f74e53a6f61b447d67f1522a75cddde93 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 08:20:16 +0200 Subject: [PATCH 186/201] New translations forms.md (Spanish) --- .../version-21/FormEditor/forms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/FormEditor/forms.md b/i18n/es/docusaurus-plugin-content-docs/version-21/FormEditor/forms.md index dc0b5a8bdb81ab..778f2c08cd4d61 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/FormEditor/forms.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/FormEditor/forms.md @@ -155,7 +155,7 @@ Fluent UI rendering offers modern and attractive controls, support of dark/light When using 4D forms with Fluent UI rendering, you need to pay attention to the following points: -- The `FORM Window theme` command returns the actual display theme of the current form. Possible values: "Classic" or "FluentUI". If there is no current form or the command is called on macOS, and empty string is returned. +- El comando `FORM Window theme` devuelve el tema de visualización actual del formulario. Possible values: "Classic" or "FluentUI". If there is no current form or the command is called on macOS, and empty string is returned. - If [`GET STYLE SHEET INFO`](../commands-legacy/get-style-sheet-info.md) is called in the context of a form, the information returned relates to the current appearance of the form (Classic or FluentUI). If the command is called outside the context of a form, the information returned relates to the [global project settings](#application-setting). - [`SET MENU ITEM STYLE`](../commands-legacy/set-menu-item-style.md) with `Underline` *itemStyle* parameter is not supported (ignored) for pop up menus. - A focus ring can be added to picture and text [inputs](../FormObjects/input_overview.md). From 0ee7a8be9a6c724d7acc27d01857ba546dde78a4 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:20:51 +0200 Subject: [PATCH 187/201] New translations zip-create-archive.md (Spanish) --- .../version-21/commands/zip-create-archive.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md index 79d2786081e8cb..8d17f8e266c9d6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md @@ -44,7 +44,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | | level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: cifrado AES con una clave de 192 bits.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: los datos no se encriptan (por defecto si no se define contraseña).
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | | retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | From 28f8c77d26b608362b5596177136b372858697a3 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:24:30 +0200 Subject: [PATCH 188/201] New translations orda-events.md (Spanish) --- .../version-21/ORDA/orda-events.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md index fa590c474ac3c6..f6b897a82a5694 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ORDA/orda-events.md @@ -58,21 +58,21 @@ Con otras configuraciones remotas (p. ej. Qodly applications, [REST API requests La siguiente tabla lista los eventos ORDA junto con sus reglas. -| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | Can stop action by returning an error | -| :------------------------- | :------- | :------------------------------------------------------ | :------------------------------------------------------------------: | ------------------------------------- | -| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | no | -| Atributo tocado | Atributo | `event touched ()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | no | -| | Entity | `event touched()` | Depends on [`local`](../ORDA/ordaClasses.md#local-functions) keyword | no | -| Before saving an entity | Atributo | `validateSave ()` | server | sí | -| | Entity | `validateSave()` | server | sí | -| When saving an entity | Atributo | `saving ()` | server | sí | -| | Entity | `saving()` | server | sí | -| After saving an entity | Entity | `afterSave()` | server | no | -| Before dropping an entity | Atributo | `validateDrop ()` | server | sí | -| | Entity | `validateDrop()` | server | sí | -| When dropping an entity | Atributo | `dropping ()` | server | sí | -| | Entity | `dropping()` | server | sí | -| After dropping an entity | Entity | `afterDrop()` | server | no | +| Evento | Nivel | Nombre de la función | (C/S) Ejecutado en | Can stop action by returning an error | +| :------------------------- | :------- | :------------------------------------------------------ | :---------------------------------------------------------------------------: | ------------------------------------- | +| Instanciación de entidades | Entity | [`constructor()`](./ordaClasses.md#class-constructor-1) | client | no | +| Atributo tocado | Atributo | `event touched ()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | no | +| | Entity | `event touched()` | Depende de la palabra clave [`local`](../ORDA/ordaClasses.md#local-functions) | no | +| Before saving an entity | Atributo | `validateSave ()` | server | sí | +| | Entity | `validateSave()` | server | sí | +| When saving an entity | Atributo | `saving ()` | server | sí | +| | Entity | `saving()` | server | sí | +| After saving an entity | Entity | `afterSave()` | server | no | +| Before dropping an entity | Atributo | `validateDrop ()` | server | sí | +| | Entity | `validateDrop()` | server | sí | +| When dropping an entity | Atributo | `dropping ()` | server | sí | +| | Entity | `dropping()` | server | sí | +| After dropping an entity | Entity | `afterDrop()` | server | no | :::note @@ -89,8 +89,8 @@ Event functions accept a single *event* object as parameter. When the function i | "kind" | siempre | String | Event name: "touched", "validateSave", "saving", "afterSave", "validateDrop", "dropping", "afterDrop" | | | *attributeName* | Only for events implemented at attribute level ("validateSave", "saving", "validateDrop", "dropping") | String | Nombre del atributo (por ejemplo, "nombre") | | | *dataClassName* | siempre | String | Nombre de la Dataclass (*ej.* "Company") | | -| "savedAttributes" | Only in [`afterSave()`](#function-event-aftersave) | Collection of String | Names of attributes properly saved | | -| "droppedAttributes" | Only in [`afterDrop()`](#function-event-afterdrop) | Collection of String | Names of attributes properly dropped | | +| "savedAttributes" | Only in [`afterSave()`](#function-event-aftersave) | Colección de cadenas | Names of attributes properly saved | | +| "droppedAttributes" | Only in [`afterDrop()`](#function-event-afterdrop) | Colección de cadenas | Names of attributes properly dropped | | | "saveStatus" | Only in [`afterSave()`](#function-event-aftersave) | String | "success" if the save was successful, "failed" otherwise | | | "dropStatus" | Only in [`afterDrop()`](#function-event-afterdrop) | String | "success" if the drop was successful, "failed" otherwise | | @@ -102,7 +102,7 @@ When an error occurs in an event, the other events are stopped at the first rais ### Error object properties -| Propiedad | Tipo | Descripción | Set by the developer | +| Propiedad | Tipo | Descripción | Definido por el desarrollador | | ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | errCode | Integer | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | | message | Text | Same as for [`Last errors`](../commands/last-errors.md) command | Sí | From 61cb614052a4d07e6f659025d8e3f8c690377bbd Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:27:44 +0200 Subject: [PATCH 189/201] New translations $filter.md (Spanish) --- .../docusaurus-plugin-content-docs/version-21/REST/$filter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$filter.md b/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$filter.md index 87fad52e60c764..42725545b33289 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$filter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/REST/$filter.md @@ -27,7 +27,7 @@ Por ejemplo: `$filter="firstName=john AND salary>20000"` donde `firstName` y `sa ### Utilizar la propiedad params -You can also use 4D's `params` property which is a collection of values. +También puede utilizar la propiedad `params` de 4D, que es una colección de valores. **\{attribute\} {comparator} {placeholder} {AND/OR/EXCEPT} \{attribute\} {comparator} {placeholder}&$params='["{value1}","{value2}"]'** From dc61796589ff53da2970b289acc1a06737434580 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:32:02 +0200 Subject: [PATCH 190/201] New translations vp-copy-to-object.md (Spanish) --- .../version-21/ViewPro/commands/vp-copy-to-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md index b551849007c39b..7d54ed71a42c0f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-copy-to-object.md @@ -31,10 +31,10 @@ En *rangeObj*, pase el rango de celdas con los valores, formato y fórmulas a co Puede pasar un parámetro opcional *options* con las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | -| copyOptions | Integer | Especifica lo que se copia o mueve. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copies only the formatting.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | +| Propiedad | Tipo | Descripción | +| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | *True* (por defecto) para mantener los valores, el formato y las fórmulas copiados después de la ejecución del comando. *False* para eliminarlos. | +| copyOptions | Integer | Especifica lo que se copia o mueve. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Copies all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Copia solo el formato.
    `vk clipboard options formulas`Copies only the formulas.
    `vk clipboard options formulas and formatting`Copies the formulas and formatting.
    `vk clipboard options values`Copies only the values.
    `vk clipboard options value and formatting`Copies the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From 803c24a832cb3033ebbd451fa7222aae92aff448 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:36:11 +0200 Subject: [PATCH 191/201] New translations vp-move-cells.md (Spanish) --- .../version-21/ViewPro/commands/vp-move-cells.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md index dd9df040b43600..adfb613719d267 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-move-cells.md @@ -35,10 +35,10 @@ En *targetRange*, pase el rango de celdas donde se copiarán o moverán los valo El parámetro *options* tiene varias propiedades: -| Propiedad | Tipo | Descripción | -| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | -| pasteOptions | Integer | Especifica lo que se pega. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Pastes all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Pastes only the formatting.
    `vk clipboard options formulas`Pastes only the formulas.
    `vk clipboard options formulas and formatting`Pastes the formulas and formatting.
    `vk clipboard options values`Pastes only the values.
    `vk clipboard options value and formatting`Pastes the values and formatting.

    | +| Propiedad | Tipo | Descripción | +| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| copy | Boolean | Determina si los valores, el formato y las fórmulas de las celdas de *originRange* se eliminan después de ejecutar el comando:
    • *False* (por defecto) para eliminarlos
    • *True* para mantenerlos
    | +| pasteOptions | Integer | Especifica lo que se pega. Possible values:

    ValueDescription
    `vk clipboard options all` (default)Pastes all data objects, including values, formatting, and formulas.
    `vk clipboard options formatting`Pega solo el formato.
    `vk clipboard options formulas`Pega sólo las fórmulas.
    `vk clipboard options formulas and formatting`Pastes the formulas and formatting.
    `vk clipboard options values`Pastes only the values.
    `vk clipboard options value and formatting`Pastes the values and formatting.

    | Se tienen en cuenta las opciones de pegado definidas en las [opciones del libro de trabajo](vp-set-workbook-options.md). From 0a07e402cbefe1812d5a1757d1468dd403b41295 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:42:11 +0200 Subject: [PATCH 192/201] New translations sessions.md (French) --- .../version-21/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index 933c2fb182d830..20caa69023fa0f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Articles de blog sur le sujet -Pour plus d'exemples, veuillez vous référer à l'article [Sessions évolutives pour les applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sessions évolutives pour applications web avancées](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From 9ec7e3d64782316d87e8149a90516fa58d7d86f5 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:42:29 +0200 Subject: [PATCH 193/201] New translations sessions.md (Spanish) --- .../version-21/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index 5652ce165f242d..dfb4e76c1380da 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Entradas de blog relacionadas -Para más ejemplos, por favor consulte la publicación de blog [Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/). +[Sesiones escalables para aplicaciones web avanzadas](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From 334a7ce86190c04ce947a0d5aad1dd924fbb940a Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:42:54 +0200 Subject: [PATCH 194/201] New translations sessions.md (Japanese) --- .../version-21/WebServer/sessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index aef3a4ae864205..aec14fa9fb346b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -201,7 +201,7 @@ Else End if ``` -:::note +:::tips 関連したblog 記事 [高度な Webアプリケーションに対応したスケーラブルセッション](https://blog.4d.com/ja/scalable-sessions-for-advanced-web-applications/) From 0e5940155cb76989fa8f9c714e9a4d0aa766596d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:43:14 +0200 Subject: [PATCH 195/201] New translations sessions.md (Portuguese, Brazilian) --- .../version-21/WebServer/sessions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index 2471ddb6831c51..1a02e189b920b6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -201,9 +201,9 @@ Else End if ``` -:::note +:::tips Related blog posts -For more examples, please refer to the [Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) bog post. +[Scalable sessions for advanced web applications](https://blog.4d.com/scalable-sessions-for-advanced-web-applications/) ::: From 443b89a6428edb13fb3a9777b9f46be4d5b9d64d Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:44:55 +0200 Subject: [PATCH 196/201] New translations openaichatcompletionsmessagesapi.md (Spanish) --- .../aikit/Classes/OpenAIChatCompletionsMessagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md index 9c3c1c18655023..65f84b56f8d1ba 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsMessagesAPI.md @@ -19,6 +19,6 @@ The `OpenAIChatCompletionsMessagesAPI` class is designed to interact with the Op | *parámetros* | `OpenAIChatCompletionsMessagesParameters` | Parámetros para filtrar y personalizar la respuesta. | | Resultado | Variant | The retrieved messages associated with the chat completion. | -The `list()` function retrieves messages associated with a specific chat completion ID. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. +La función `list()` recupera los mensajes asociados a un ID de finalización de chat específico. Lanza un error si `completionID` está vacío. If the *parameters* argument is not an instance of `OpenAIChatCompletionsMessagesParameters`, it will create a new instance using the provided parameters. https://platform.openai.com/docs/api-reference/chat/getMessages From dc3e51cf8a3b6358bc1f3281d2ed13629d587f73 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:44:58 +0200 Subject: [PATCH 197/201] New translations openaichatcompletionsparameters.md (Spanish) --- .../OpenAIChatCompletionsParameters.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md index e8a1b8b570eacd..db1b10b9ec0ee7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatCompletionsParameters.md @@ -13,20 +13,20 @@ The `OpenAIChatCompletionParameters` class is designed to handle the parameters ## Propiedades -| Propiedad | Tipo | Valor por defecto | Descripción | -| ----------------------- | ---------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `model` | Text | `"gpt-4o-mini"` | ID del modelo a utilizar. | -| `stream` | Boolean | `False` | Si se retransmite el progreso parcial. Si se define, los tokens se enviarán solo como datos. Fórmula de retrollamada necesaria. | -| `stream_options` | Object | `Null` | Property for stream=True. For example: `{include_usage: True}` | -| `max_completion_tokens` | Integer | `0` | The maximum number of tokens that can be generated in the completion. | -| `n` | Integer | `1` | How many completions to generate for each prompt. | -| `temperature` | Real | `-1` | Qué temperatura de muestreo utilizar, entre 0 y 2. Higher values make the output more random, while lower values make it more focused and deterministic. | -| `store` | Boolean | `False` | Whether or not to store the output of this chat completion request. | -| `reasoning_effort` | Text | `Null` | Constrains effort on reasoning for reasoning models. Currently supported values are `"low"`, `"medium"`, and `"high"`. | -| `response_format` | Object | `Null` | An object specifying the format that the model must output. Compatible with structured outputs. | -| `herramientas` | Collection | `Null` | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported. | -| `tool_choice` | Variant | `Null` | Controls which (if any) tool is called by the model. Can be `"none"`, `"auto"`, `"required"`, or specify a particular tool. | -| `prediction` | Object | `Null` | Static predicted output content, such as the content of a text file that is being regenerated. | +| Propiedad | Tipo | Valor por defecto | Descripción | +| ----------------------- | ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `model` | Text | `"gpt-4o-mini"` | ID del modelo a utilizar. | +| `stream` | Boolean | `False` | Si se retransmite el progreso parcial. Si se define, los tokens se enviarán solo como datos. Fórmula de retrollamada necesaria. | +| `stream_options` | Object | `Null` | Property for stream=True. Por ejemplo: `{include_usage: True}` | +| `max_completion_tokens` | Integer | `0` | The maximum number of tokens that can be generated in the completion. | +| `n` | Integer | `1` | How many completions to generate for each prompt. | +| `temperature` | Real | `-1` | Qué temperatura de muestreo utilizar, entre 0 y 2. Higher values make the output more random, while lower values make it more focused and deterministic. | +| `store` | Boolean | `False` | Whether or not to store the output of this chat completion request. | +| `reasoning_effort` | Text | `Null` | Constrains effort on reasoning for reasoning models. Los valores soportados actualmente son `"low"`, `"medium"` y `"high"`. | +| `response_format` | Object | `Null` | An object specifying the format that the model must output. Compatible with structured outputs. | +| `herramientas` | Collection | `Null` | A list of tools ([OpenAITool](OpenAITool.md)) the model may call. Only "function" type is supported. | +| `tool_choice` | Variant | `Null` | Controls which (if any) tool is called by the model. Puede ser `"none"`, `"auto"`, `"required"`, o especificar una herramienta concreta. | +| `prediction` | Object | `Null` | Static predicted output content, such as the content of a text file that is being regenerated. | ### Propiedades de retrollamada asíncrona @@ -119,7 +119,7 @@ $result := $client.chat.completions.create($messages; $params) When using `json_schema` type, you can specify: -- **`name`**: A name for the schema +- **`name`**: un nombre para el esquema - **`description`**: A description of what the schema represents - **`schema`**: The JSON schema definition - **`strict`**: Whether to enforce strict adherence to the schema From 435988ceefb299031d3af1f93d568504719f57c2 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:46:02 +0200 Subject: [PATCH 198/201] New translations openaiimage.md (Spanish) --- .../version-21/aikit/Classes/OpenAIImage.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImage.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImage.md index 09e15a20df5e90..9009658de82b79 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImage.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImage.md @@ -5,17 +5,17 @@ title: OpenAIImage # OpenAIImage -The `OpenAIImage` class represents an image generated by the OpenAI API. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. +La clase `OpenAIImage` representa una imagen generada por la API OpenAI. It provides properties for accessing the generated image in different formats and methods for converting this image to different types. https://platform.openai.com/docs/api-reference/images/object ## Propiedades -| Propiedad | Tipo | Descripción | -| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------- | -| `url` | Text | The URL of the generated image, if `response_format` is `url` (default). | -| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | -| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | +| Propiedad | Tipo | Descripción | +| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------- | +| `url` | Text | La URL de la imagen generada, si `response_format` es `url` (por defecto). | +| `b64_json` | Text | The base64-encoded JSON of the generated image, if `response_format` is `b64_json`. | +| `revised_prompt` | Variant | The prompt that was used to generate the image, if there was any revision to the prompt. | ## Funciones From 2cf0fcedf0bf56fafaf18b3e710fb8e4354419cd Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:46:03 +0200 Subject: [PATCH 199/201] New translations openaiimageparameters.md (Spanish) --- .../version-21/aikit/Classes/OpenAIImageParameters.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImageParameters.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImageParameters.md index 167f8ab9d4ac4b..d50e4af6583cb9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImageParameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImageParameters.md @@ -18,8 +18,8 @@ The `OpenAIImageParameters` class is designed to configure and manage the parame | `model` | Text | "dall-e-2" | Especifica el modelo a utilizar para la generación de imágenes. | | `n` | Integer | 1 | The number of images to generate (must be between 1 and 10; only `n=1` is supported for `dall-e-3`). | | `size` | Text | "1024x1024" | El tamaño de las imágenes generadas. Debe ajustarse a las especificaciones del modelo. | -| `style` | Text | "" | The style of the generated images (must be either `vivid` or `natural`). | -| `response_format` | Text | "url" | The format for returned images, can be either `url` or `b64_json`. | +| `style` | Text | "" | El estilo de las imágenes generadas (debe ser `vivid` o `natural`). | +| `response_format` | Text | "url" | El formato de las imágenes devueltas puede ser `url` o `b64_json`. | ## Ver también From 3824ac55446763a89d2ab208b670be98aafa13dd Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:46:05 +0200 Subject: [PATCH 200/201] New translations openaiimagesapi.md (Spanish) --- .../version-21/aikit/Classes/OpenAIImagesAPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImagesAPI.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImagesAPI.md index 3797cb01095e30..4ffe3a9911bd80 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImagesAPI.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIImagesAPI.md @@ -5,7 +5,7 @@ title: OpenAIImagesAPI # OpenAIImagesAPI -The `OpenAIImagesAPI` provides functionalities to generate images using OpenAI's API. +La `OpenAIImagesAPI` ofrece funcionalidades para generar imágenes utilizando la API de OpenAI. https://platform.openai.com/docs/api-reference/images From fe0b8eba2831e13eb4b353828e1e2eb5eb9fa971 Mon Sep 17 00:00:00 2001 From: arnaud-4d Date: Wed, 15 Oct 2025 09:46:09 +0200 Subject: [PATCH 201/201] New translations openaimessage.md (Spanish) --- .../version-21/aikit/Classes/OpenAIMessage.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIMessage.md b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIMessage.md index f8259807424811..ab4ca22c87ed49 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIMessage.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIMessage.md @@ -9,13 +9,13 @@ The `OpenAIMessage` class represents a structured message containing a role, con ## Propiedades -| Propiedad | Tipo | Descripción | -| -------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `rol` | Text | The role of the message (e.g., "user", "assistant", "system", "tool"). | -| `contenido` | Variant | The content of the message, which can be a text or a collection of objects. | -| `user` | Text | An optional property representing the user associated with the message. | -| `tool_calls` | Collection | A collection of tool calls requested by the assistant. Each tool call contains an `id`, `type`, and a `function` object. | -| `tool_call_id` | Text | The ID of the tool call that this message is responding to (used when `role` is "tool"). | +| Propiedad | Tipo | Descripción | +| -------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `rol` | Text | The role of the message (e.g., "user", "assistant", "system", "tool"). | +| `contenido` | Variant | The content of the message, which can be a text or a collection of objects. | +| `user` | Text | An optional property representing the user associated with the message. | +| `tool_calls` | Collection | A collection of tool calls requested by the assistant. Cada llamada a una herramienta contiene un objeto `id`, `type` y `function`. | +| `tool_call_id` | Text | The ID of the tool call that this message is responding to (used when `role` is "tool"). | ## Propiedades calculadas