*4D Server only*: Qodly Studio code editor (see (2))|Qodly Studio code editor| +|Coding IDE|4D IDE code editor *or* VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2))|Qodly Studio code editor| |Debugger|4D IDE debugger
*4D Server only*: Qodly Studio debugger (see [this paragraph](#using-qodly-debugger-on-4d-server))|Qodly Studio debugger| |REST/Web roles and privileges|roles.json direct edit/Qodly Studio roles and privileges editor|Qodly Studio role and privileges editor| diff --git a/docs/assets/en/Admin/buildapposxcertProj.png b/docs/assets/en/Admin/buildapposxcertProj.png index de58a3d1eb1733..0afc8cd3cd6be1 100644 Binary files a/docs/assets/en/Admin/buildapposxcertProj.png and b/docs/assets/en/Admin/buildapposxcertProj.png differ diff --git a/docs/assets/en/Debugging/break.png b/docs/assets/en/Debugging/break.png index 87f2c7ec6cc15d..f350cb995a59fd 100644 Binary files a/docs/assets/en/Debugging/break.png and b/docs/assets/en/Debugging/break.png differ diff --git a/docs/assets/en/Debugging/contextual-menu.png b/docs/assets/en/Debugging/contextual-menu.png index 35222f97254a0d..cba6de249cf77a 100644 Binary files a/docs/assets/en/Debugging/contextual-menu.png and b/docs/assets/en/Debugging/contextual-menu.png differ diff --git a/docs/assets/en/Debugging/custom-expression-icon.png b/docs/assets/en/Debugging/custom-expression-icon.png new file mode 100644 index 00000000000000..723465a0e2af57 Binary files /dev/null and b/docs/assets/en/Debugging/custom-expression-icon.png differ diff --git a/docs/assets/en/Debugging/custom-watch-pane-context-menu.png b/docs/assets/en/Debugging/custom-watch-pane-context-menu.png index f4372b543ee6b7..8718fded2a0b4c 100644 Binary files a/docs/assets/en/Debugging/custom-watch-pane-context-menu.png and b/docs/assets/en/Debugging/custom-watch-pane-context-menu.png differ diff --git a/docs/assets/en/Debugging/custom-watch-pane-display-menu.png b/docs/assets/en/Debugging/custom-watch-pane-display-menu.png new file mode 100644 index 00000000000000..21e28b40a2becf Binary files /dev/null and b/docs/assets/en/Debugging/custom-watch-pane-display-menu.png differ diff --git a/docs/assets/en/Debugging/custom-watch-pane-menu.png b/docs/assets/en/Debugging/custom-watch-pane-menu.png new file mode 100644 index 00000000000000..97e0485cac6531 Binary files /dev/null and b/docs/assets/en/Debugging/custom-watch-pane-menu.png differ diff --git a/docs/assets/en/Debugging/custom-watch-pane.png b/docs/assets/en/Debugging/custom-watch-pane.png index 282eef4ee9e9f9..e3c0e17dd9d02b 100644 Binary files a/docs/assets/en/Debugging/custom-watch-pane.png and b/docs/assets/en/Debugging/custom-watch-pane.png differ diff --git a/docs/assets/en/Debugging/debugger-default-configuration.png b/docs/assets/en/Debugging/debugger-default-configuration.png new file mode 100644 index 00000000000000..723465a0e2af57 Binary files /dev/null and b/docs/assets/en/Debugging/debugger-default-configuration.png differ diff --git a/docs/assets/en/Debugging/debugger-factory.png b/docs/assets/en/Debugging/debugger-factory.png new file mode 100644 index 00000000000000..34e97fb3ae5556 Binary files /dev/null and b/docs/assets/en/Debugging/debugger-factory.png differ diff --git a/docs/assets/en/Debugging/debugger-window-intro.png b/docs/assets/en/Debugging/debugger-window-intro.png index cf71bd2d50e871..ddc56eac8963bd 100644 Binary files a/docs/assets/en/Debugging/debugger-window-intro.png and b/docs/assets/en/Debugging/debugger-window-intro.png differ diff --git a/docs/assets/en/Debugging/debuggerWindowRemote.png b/docs/assets/en/Debugging/debuggerWindowRemote.png index 5790890448635f..a2bf8c9b7a7bce 100644 Binary files a/docs/assets/en/Debugging/debuggerWindowRemote.png and b/docs/assets/en/Debugging/debuggerWindowRemote.png differ diff --git a/docs/assets/en/Debugging/executionToolbarButtons.png b/docs/assets/en/Debugging/executionToolbarButtons.png index 3ebacf28c5868d..ba0f3543b2a69a 100644 Binary files a/docs/assets/en/Debugging/executionToolbarButtons.png and b/docs/assets/en/Debugging/executionToolbarButtons.png differ diff --git a/docs/assets/en/Debugging/pin-expression.png b/docs/assets/en/Debugging/pin-expression.png new file mode 100644 index 00000000000000..f2e18d4d1ae84c Binary files /dev/null and b/docs/assets/en/Debugging/pin-expression.png differ diff --git a/docs/assets/en/Debugging/prototype.png b/docs/assets/en/Debugging/prototype.png new file mode 100644 index 00000000000000..ef983192ecd1c3 Binary files /dev/null and b/docs/assets/en/Debugging/prototype.png differ diff --git a/docs/assets/en/Debugging/sourceCodePaneContext.png b/docs/assets/en/Debugging/sourceCodePaneContext.png index 704002e1efdbe2..62e449d25b5084 100644 Binary files a/docs/assets/en/Debugging/sourceCodePaneContext.png and b/docs/assets/en/Debugging/sourceCodePaneContext.png differ diff --git a/docs/assets/en/Debugging/watchPane.png b/docs/assets/en/Debugging/watchPane.png index b70d73b8d2d592..69183c18d0472b 100644 Binary files a/docs/assets/en/Debugging/watchPane.png and b/docs/assets/en/Debugging/watchPane.png differ diff --git a/docs/code-editor/write-class-method.md b/docs/code-editor/write-class-method.md index 04baaac1c02f51..2d413a4a04fa41 100644 --- a/docs/code-editor/write-class-method.md +++ b/docs/code-editor/write-class-method.md @@ -13,6 +13,12 @@ You can scroll through the contents of methods, classes and functions, which can The 4D Code Editor provides basic syntax error-checking. Additional error-checking is performed when the code executes. For more information on how to handle errors, see [Debugging](../Debugging/basics.md). +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## Interface ### Toolbar diff --git a/docs/commands-legacy/array-text.md b/docs/commands-legacy/array-text.md index 1abb962a40d13c..b2742067ce2074 100644 --- a/docs/commands-legacy/array-text.md +++ b/docs/commands-legacy/array-text.md @@ -54,7 +54,3 @@ This example creates an interprocess array of 50 [Text](# "A character string th ◊atValues{$vlElem}:="Element #"+String($vlElem) End for ``` - -#### See also - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/docs/commands-legacy/build-application.md b/docs/commands-legacy/build-application.md index b0a58b0b2b31f9..12c93317308c78 100644 --- a/docs/commands-legacy/build-application.md +++ b/docs/commands-legacy/build-application.md @@ -20,15 +20,15 @@ displayed_sidebar: docs The BUILD APPLICATION command launches the application generation process. It takes into account parameters set in the current build application settings file or the settings file set in the *buildAppSettings* parameter. -**Note:** This command can only work with 4D Developer (single-user). It cannot be called from 4D Server, 4D in remote mode, or a mergerd application. +**Note:** This command can only work with 4D Developer (single-user). It cannot be called from 4D Server, 4D in remote mode, or a merged application. -A build application settings file is an XML file that contains all the parameters used to generate an application. Most parameters can be seen in the Build Application dialog box (for more information, refer to the *Application builder* section of the 4D Design Reference manual). +A build application settings file is an XML file that contains all the parameters used to generate an application. Most parameters can be seen in the [Build Application dialog box](../Desktop/building.md). By default, 4D creates a build application settings file named “buildApp.4DSettings” for each database and places it in the Settings folder of the database. If the database has not yet been compiled or if the compiled code is outdated, the command will first launch the compiler process. In this case, the compiler window does not appear (unless an error occurs), only a progress bar is displayed. You can hide this progress bar using the [MESSAGES OFF](messages-off.md) command. -If you do not pass the optional buildAppSettings parameter, the command displays a standard open file dialog box, so that you can designate a build application settings file. When the dialog box has been validated, the system variable Document contains the full pathname of the open settings file. +If you do not pass the optional *buildAppSettings* parameter, the command displays a standard open file dialog box, so that you can designate a build application settings file. When the dialog box has been validated, the system variable Document contains the full pathname of the open settings file. If you pass the access path and name of an XML file for a valid application project (UTF-8 encoding), the command will use the parameters defined in the file. For more information on the structure and the keys that can be used in the build application settings file, refer to the *4D XML Keys BuildApplication* manual. diff --git a/docs/commands-legacy/data-file.md b/docs/commands-legacy/data-file.md index f7b10b541db9ae..16ded6da295ebc 100644 --- a/docs/commands-legacy/data-file.md +++ b/docs/commands-legacy/data-file.md @@ -30,6 +30,5 @@ If, for example, you are working with the database located in the folder Documen #### See also -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/docs/commands-legacy/drop-position.md b/docs/commands-legacy/drop-position.md index 5d3dc79486b33d..3cd081f6726b17 100644 --- a/docs/commands-legacy/drop-position.md +++ b/docs/commands-legacy/drop-position.md @@ -94,5 +94,4 @@ The left (destination) list box object method contains the following code: #### See also -*\_o\_DRAG AND DROP PROPERTIES* *Drag and Drop* \ No newline at end of file diff --git a/docs/commands-legacy/filter-keystroke.md b/docs/commands-legacy/filter-keystroke.md index 92ab14642e22f8..bfd511b577d112 100644 --- a/docs/commands-legacy/filter-keystroke.md +++ b/docs/commands-legacy/filter-keystroke.md @@ -86,39 +86,37 @@ As explained above, during the editing of the text area, the data source for thi // Shadow keystroke project method // Shadow keystroke ( Pointer ; Pointer ; String ) -> String // Shadow keystroke ( -> srcArea ; -> curValue ; Filter ) -> Old keystroke - C_STRING(1;$0) - var $1;$2 : Pointer +#DECLARE ($srcArea : Pointer ; $curVal : Pointer ; $filter : Text) -> $old : Text var $vtNewValue : Text - C_STRING(255;$3) // Return the original keystroke - $0:=Keystroke + $old:=Keystroke // Get the text selection range within the enterable area - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($srcArea->;$vlStart;$vlEnd) // Start working with the current value - $vtNewValue:=$2-> + $vtNewValue:=$curVal-> // Depending on the key pressed or the character entered, // Perform the appropriate actions Case of // The Backspace (Delete) key has been pressed - :(Character code($0)=Backspace) + :(Character code($old)=Backspace) // Delete the selected characters or the character at the left of the text cursor $vtNewValue:=Delete text($vtNewValue;$vlStart;$vlEnd) // An Arrow key has been pressed // Do nothing, but accept the keystroke - :(Character code($0)=Left arrow key) - :(Character code($0)=Right arrow key) - :(Character code($0)=Up arrow key) - :(Character code($0)=Down arrow key) + :(Character code($old)=Left arrow key) + :(Character code($old)=Right arrow key) + :(Character code($old)=Up arrow key) + :(Character code($old)=Down arrow key) // An acceptable character has been entered - :(Position($0;$3)=0) + :(Position($old;$filter)=0) $vtNewValue:=Insert text($vtNewValue;$vlStart;$vlEnd;$0) Else // The character is not accepted FILTER KEYSTROKE("") End case // Return the value for the next keystroke handling - $2->:=$vtNewValue + $curVal->:=$vtNewValue ``` This method uses the two following submethods: @@ -127,26 +125,25 @@ This method uses the two following submethods: // Delete text project method // Delete text ( String ; Long ; Long ) -> String // Delete text ( -> Text ; SelStart ; SelEnd ) -> New text - var $0;$1 : Text - var $2;$3 : Integer - $0:=Substring($1;1;$2-1-Num($2=$3))+Substring($1;$3) - +#DECLARE ($src : Text ; $start : Integer ; $end : Integer) -> $new : Text + $new:=Substring($src;1;$start-1-Num($start=$end))+Substring($src;$end) +``` +```4d // Insert text project method // Insert text ( String ; Long ; Long ; String ) -> String // Insert text ( -> srcText ; SelStart ; SelEnd ; Text to insert ) -> New text - var $0;$1;$4 : Text - var $2;$3 : Integer - $0:=$1 - If($2#$3) - $0:=Substring($0;1;$2-1)+$4+Substring($0;$3) +#DECLARE ($src : Text ; $start : Integer ; $end : Integer ; $toInsert : Text) -> $new : Text + $new:=$src + If($start # $end) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$end) Else Case of - :($2<=1) - $0:=$4+$0 - :($2>Length($0)) - $0:=$0+$4 + :($start<=1) + $new:=$toInsert+$new + :($start>Length($new)) + $new:=$new+$toInsert Else - $0:=Substring($0;1;$2-1)+$4+Substring($0;$2) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$start) End case End if ``` @@ -180,13 +177,13 @@ The LOOKUP DICTIONARY project method is listed below. Its purpose is to use the // LOOKUP DICTIONARY ( Pointer ; Pointer ) // LOOKUP DICTIONARY ( -> Enterable Area ; ->ShadowVariable ) - var $1;$2 : Pointer +#DECLARE ($area : Pointer ; $shadow : Pointer) var $vlStart;$vlEnd : Integer // Get the text selection range within the enterable area - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($area->;$vlStart;$vlEnd) // Get the selected text or the word on the left of the text cursor - $vtHighlightedText:=Get highlighted text($2->;$vlStart;$vlEnd) + $vtHighlightedText:=Get highlighted text($shadow->;$vlStart;$vlEnd) // Is there something to look for? If($vtHighlightedText#"") // If the text selection was the text cursor, @@ -194,14 +191,14 @@ The LOOKUP DICTIONARY project method is listed below. Its purpose is to use the If($vlStart=$vlEnd) $vlStart:=$vlStart-Length($vtHighlightedText) End if - // Look for the first avaliable dictionary entry + // Look for the first available dictionary entry QUERY([Dictionary];[Dictionary]Entry=$vtHighlightedText+"@") // Is there one? If(Records in selection([Dictionary])>0) // If so, insert it in the shadow text - $2->:=Insert text($2->;$vlStart;$vlEnd;[Dictionary]Entry) + $shadow->:=Insert text($shadow->;$vlStart;$vlEnd;[Dictionary]Entry) // Copy the shadow text to the enterable being edited - $1->:=$2-> + $area->:=$shadow-> // Set the selection just after the insert dictionary entry $vlEnd:=$vlStart+Length([Dictionary]Entry) HIGHLIGHT TEXT(vsComments;$vlEnd;$vlEnd) @@ -221,23 +218,22 @@ The Get highlighted text method is listed here: // Get highlighted text project method // Get highlighted text ( String ; Long ; Long ) -> String // Get highlighted text ( Text ; SelStart ; SelEnd ) -> highlighted text - var $0;$1 : Text - var $2;$3 : Integer - If($2<$3) - $0:=Substring($1;$2;$3-$2) +#DECLARE ($text : Text ; $start : Integer ; $end : Integer) -> $highlight : Text + If($start<$end) + $highlight:=Substring($text;$start;$end-$start) Else - $0:="" - $2:=$2-1 + $highlight:="" + $start:=$start-1 Repeat - If($2>0) - If(Position($1[[$2]];" ,.!?:;()-_–—")=0) - $0:=$1[[$2]]+$0 - $2:=$2-1 + If($start>0) + If(Position($text[[$start]];" ,.!?:;()-_–—")=0) + $highlight:=$text[[$start]]+$highlight + $start:=$start-1 Else - $2:=0 + $start:=0 End if End if - Until($2=0) + Until($start=0) End if ``` diff --git a/docs/commands-legacy/font-list.md b/docs/commands-legacy/font-list.md index ae4bfee6452ba3..0b351e173968ca 100644 --- a/docs/commands-legacy/font-list.md +++ b/docs/commands-legacy/font-list.md @@ -68,7 +68,6 @@ You want to get a list of recent fonts: #### See also -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) *Font Type List* [OBJECT SET FONT](object-set-font.md) diff --git a/docs/commands-legacy/form-set-input.md b/docs/commands-legacy/form-set-input.md index dd2784d9f89294..0c21d23750df18 100644 --- a/docs/commands-legacy/form-set-input.md +++ b/docs/commands-legacy/form-set-input.md @@ -98,7 +98,6 @@ which displays: #### See also -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/docs/commands-legacy/form-set-output.md b/docs/commands-legacy/form-set-output.md index 1726ee61487c07..4234cbf3821d48 100644 --- a/docs/commands-legacy/form-set-output.md +++ b/docs/commands-legacy/form-set-output.md @@ -64,7 +64,6 @@ The following example uses the path to a .json form to print the records in an e #### See also -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/docs/commands-legacy/get-document-properties.md b/docs/commands-legacy/get-document-properties.md index cbc909d570bfe8..00bd3f8a63dfc3 100644 --- a/docs/commands-legacy/get-document-properties.md +++ b/docs/commands-legacy/get-document-properties.md @@ -207,6 +207,4 @@ Once this is implemented in the database, we have all we need to write the proje #### See also -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/docs/commands-legacy/get-highlight.md b/docs/commands-legacy/get-highlight.md index f70dc4b74b267c..7b1c52a24c2162 100644 --- a/docs/commands-legacy/get-highlight.md +++ b/docs/commands-legacy/get-highlight.md @@ -42,8 +42,10 @@ If the object designated by the *object* parameter is not found in the form, the The following example gets the highlighted selection from the field called *\[Products\]Comments*: ```4d - GET HIGHLIGHT([Products]Comments;vFirst;vLast) - If(vFirst
[`dataClass.newSelection()`](../API/DataClassClass.md#newselection) \ No newline at end of file +[USE ENTITY SELECTION](use-entity-selection.md)
[`dataClass.newSelection()`](../API/DataClassClass.md#newselection) + +#### Properties + +| | | +| --- | --- | +| Command number | 1512 | +| Thread safe | ✓ | + diff --git a/docs/commands/dialog.md b/docs/commands/dialog.md index f1d4db5f104d2d..38e366fd037314 100644 --- a/docs/commands/dialog.md +++ b/docs/commands/dialog.md @@ -65,7 +65,7 @@ This form then reacts “normally” to user actions and is closed using a stand **Notes:** -* You can combine the use of the **DIALOG**(form;\*) syntax with the [CALL FORM](call-form.md) command to establish communication between the forms. +* You can combine the use of the **DIALOG**(form;\*) syntax with the [CALL FORM](../commands-legacy/call-form.md) command to establish communication between the forms. * You must create a window before calling the **DIALOG**(form;\*) statement. It is not possible to use the current dialog window in the process nor the window created by default for each process. Otherwise, error -9909 is generated. * When the *\** parameter is used, the window is closed automatically following a standard action or a call to the [CANCEL](../commands-legacy/cancel.md) or [ACCEPT](../commands-legacy/accept.md) command. You do not have to manage the closing of the window itself. @@ -168,7 +168,15 @@ After a call to **DIALOG**, if the dialog is accepted, OK is set to 1; if it is [ACCEPT](../commands-legacy/accept.md) [ADD RECORD](../commands-legacy/add-record.md) -[CALL FORM](call-form.md) +[CALL FORM](../commands-legacy/call-form.md) [CANCEL](../commands-legacy/cancel.md) [Form](form.md) -[Open window](../commands-legacy/open-window.md) \ No newline at end of file +[Open window](../commands-legacy/open-window.md) + +#### Properties + +| | | +| --- | --- | +| Command number | 40 | +| Thread safe | ✗ | +| Modifies variables | OK, error | diff --git a/docs/commands/form-event-code.md b/docs/commands/form-event-code.md index 5cef0cfa1cb920..663392fd424a2f 100644 --- a/docs/commands/form-event-code.md +++ b/docs/commands/form-event-code.md @@ -103,7 +103,7 @@ This example is a template for a form method. It shows each of the possible even #### Example 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](../commands-legacy/display-selection.md) or [MODIFY SELECTION](../commands-legacy/modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. ```4d //A form method @@ -142,7 +142,7 @@ This example shows the template of a form method that handles the events that ca #### Example 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. #### Example 6 @@ -344,11 +344,11 @@ As a result, the red rectangle follows the scrolling of the list box: #### See also [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md) -[Current form table](current-form-table.md) -[FILTER KEYSTROKE](filter-keystroke.md) +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md) +[Current form table](../commands-legacy/current-form-table.md) +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) [FORM Event](form-event.md) -[Get edited text](get-edited-text.md) -[Keystroke](keystroke.md) -[POST OUTSIDE CALL](post-outside-call.md) -[SET TIMER](set-timer.md) \ No newline at end of file +[Get edited text](../commands-legacy/get-edited-text.md) +[Keystroke](../commands-legacy/keystroke.md) +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md) +[SET TIMER](../commands-legacy/set-timer.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/CollectionClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/CollectionClass.md index aa1769b059c160..04e1fc353b4025 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/CollectionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/CollectionClass.md @@ -5,13 +5,12 @@ title: Collection La clase Collection gestiona variables de tipo [Collection](Concepts/dt_collection.md). -Una colección es inicializada con los comandos [`New collection`](../commands/new-collection.md) o [`New shared collection`](../commands/new-shared-collection.md). +Ejemplo 3 ### Ejemplo ```4d - var $colVar : Collection //creación de una variable 4D de tipo colección - $colVar:=New collection //inicialización de la colección y asignación a la variable 4D +Notas ``` ### Resumen @@ -58,7 +57,7 @@ Una colección es inicializada con los comandos [`New collection`](../commands/n | [](#reduceRight)
| | [](#remove)
| | [](#resize)
| -| [](#orderby)
| +| Ejemplo 2 | | [](#shift)
| | [](#slice)
| | [](#some)
| @@ -82,33 +81,27 @@ Una colección es inicializada con los comandos [`New collection`](../commands/n -| Parámetros | Tipo | | Descripción | -| ---------- | ------- | :-------------------------: | ------------------------------ | -| index | Integer | -> | Índice del elemento a devolver | -| Result | any | <- | El elemento en ese índice | +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | :-------------------------: | ----------------------------------------------------------------------------------- | +| index | Integer | -> | Índice del elemento a devolver | +| Result | any | <- | Este ejemplo devuelve las personas contratadas hace más de 90 días: | #### Descripción -La función `.at()` devuelve el elemento en la posición *index*, permitiendo enteros positivos y negativos. +Igual a > Esta función no modifica la colección original. Los números enteros negativos cuentan hacia atrás desde el último elemento de la colección. -La función devuelve Undefined si el *index* sobrepasa los límites de la colección. +Igual a #### Ejemplo ```4d -var $col : Collection -$col:=New collection(10; 20; 30; 40; 50) -$element:=$col.at(0) // 10 -$element:=$col.at(1) // 20 -$element:=$col.at(-1) // 50 -$element:=$col.at(-2) // 40 -$element:=$col.at(10) // indefinido +Lanzamiento ``` @@ -129,26 +122,26 @@ $element:=$col.at(10) // indefinido -| Parámetros | Tipo | | Descripción | -| ------------ | --------------- | :-------------------------: | ----------------------------------------------------------------------------- | -| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real, Undefined | <- | Media aritmética (promedio) de los valores de la colección | +| Parámetros | Tipo | | Descripción | +| ------------ | --------------- | :-------------------------: | ---------------------------------------------------------------- | +| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | +| Result | Real, Undefined | <- | donde: | #### Descripción -La función `.average()` devuelve la media aritmética (promedio) de los valores definidos en la instancia de la colección. +Diferente de Para el cálculo sólo se tienen en cuenta los elementos numéricos (se ignoran otros tipos de elementos). -Si la colección contiene objetos, pasa el parámetro *propertyPath* para indicar la propiedad del objeto a tener en cuenta. +Uso del paréntesis -`.average()` devuelve `undefined` si: +Number, Text, Date, Time, Boolean, Object, Collection, Picture, Pointer - la colección está vacía, - la colección no contiene elementos numéricos, -- *propertyPath* no se encuentra en la colección. +- Lanzamiento #### Ejemplo 1 @@ -187,15 +180,15 @@ Si la colección contiene objetos, pasa el parámetro *propertyPath* para indica -| Parámetros | Tipo | | Descripción | -| ---------- | ---------- | :-------------------------: | ----------------------------------------------------- | -| Result | Collection | <- | Colección original con todos los elementos eliminados | +| Parámetros | Tipo | | Descripción | +| ---------- | ---------- | :-------------------------: | ------------------------------------------- | +| Result | Collection | <- | Colección original sin elementos eliminados | #### Descripción -La función `.clear()` elimina todos los elementos de la instancia de la colección y devuelve una colección vacía. +Debe prestar atención a los siguientes aspectos de la conversión: > Esta función modifica la colección original. @@ -230,7 +223,7 @@ $vSize:=$col.length //$vSize=0 | ---------- | ---------- | :-------------------------: | ------------------------------------------------------------------------------------------------------------------------ | | col2 | Collection | -> | Colección a combinar | | index | Integer | -> | Posición a la que se deben combinar los elementos de inserción en la colección (por defecto=length+1) | -| Result | Collection | <- | Colección original que contiene elementos combinados | +| Result | Collection | <- | Colección original sin elementos eliminados | @@ -242,11 +235,11 @@ La función `.combine()` inserta eleme Por defecto, los elementos *col2* se añaden al final de la colección original. Puede pasar en *index* la posición donde desea insertar los elementos *col2* en la colección. -> **Atención**: recuerde que los elementos de la colección están numerados desde 0. +> Diferente de -- Si *index* > la longitud de la colección, el *index* inicial real será la longitud de la colección. -- Si *index* < 0, se recalcula como *index:=index+length* (se considera el desplazamiento desde el final de la colección). -- Si el valor calculado es negativo, *index* toma el valor 0. +- Ejemplo 1 +- Ejemplo 3 +- En caso de incoherencia, se aplican las siguientes reglas: #### Ejemplo @@ -275,20 +268,20 @@ $c.combine($fruits;3) //[1,2,3,"Orange","Banana","Apple","Grape",4,5,6] -| Parámetros | Tipo | | Descripción | -| ---------- | -------------------------------------------------------------- | :-------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------- | -| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos los elementos de la colección se añaden a la colección original | -| Result | Collection | <- | Nueva colección con valor(es) añadido(s) a la colección original | +| Parámetros | Tipo | | Descripción | +| ---------- | -------------------------------------------------------------- | :-------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------- | +| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos sus elementos se añaden al final de la colección original. | +| Result | Collection | <- | Colección original con valores rellenados | #### Descripción -La función.`.concat()` devuelve una nueva colección que contiene los elementos de la colección original con todos los elementos del parámetro *value* añadidos al final. +Colección compartida que se agrupa con la colección resultante > Esta función no modifica la colección original. -Si *value* es una colección, todos sus elementos se añaden al final de la colección original. Si *value* no es una colección, se añade ella misma como un nuevo elemento. +La colección devuelta contiene el elemento especificado por *startFrom* y todos los elementos subsiguientes hasta, pero sin incluir, el elemento especificado por *end*. Si sólo se especifica el parámetro *startFrom*, la colección devuelta contiene todos los elementos desde *startFrom* hasta el último elemento de la colección original. #### Ejemplo @@ -320,29 +313,29 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] -| Parámetros | Tipo | | Descripción | -| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------------------------------------------------------------------------------------- | -| option | Integer | -> | `ck resolve pointers`: resolver punteros antes de copiar,
`ck shared`: devolver una colección compartida | -| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | -| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | -| Result | Collection | <- | Copia profunda de la colección original | +| Parámetros | Tipo | | Descripción | +| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------- | +| option | Integer | -> | Ejemplo 3 | +| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | +| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | +| Result | Collection | <- | Colección original ordenada | #### Descripción -La función `.copy()` devuelve una copia profunda de la instancia de la colección.***Deep copy*** significa que los objetos o colecciones dentro de la colección original se duplican y no comparten ninguna referencia con la colección devuelta. +Uso de marcadores de posición > Esta función no modifica la colección original. -Si se pasa, el parámetro *option* puede contener una de las siguientes constantes (o ambas): +Lanzamiento | option | Descripción | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Sin embargo, puede resolver los punteros al copiar pasando la constante `ck resolve pointers`. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | +| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | | `ck shared` | Por defecto, `copy()` devuelve una colección Clásica (no compartida), incluso si el comando se aplica a una colección compartida. Pasa la constante `ck shared` para crear una colección compartida. En este caso, puede utilizar el parámetro *groupWith* para asociar la colección compartida con otra colección u objeto (ver más adelante). | -Los parámetros *groupWithCol* o *groupWithObj* permiten designar una colección o un objeto al que se debe asociar la colección resultante. +Ejemplo 2 :::note @@ -374,7 +367,7 @@ End use #### Ejemplo 2 -Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Por lo tanto, debemos hacer una copia compartida de *$sharedColl1* y designar *$sharedColl2* como grupo compartido para la copia. +Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection @@ -409,24 +402,10 @@ End use #### Ejemplo 4 -Este ejemplo ilustra el uso de la opción `ck resolve pointers`: +Primer elemento de la colección ```4d - var $col : Collection - var $p : Pointer - $p:=->$what - - $col:=New collection - $col.push(New object("alpha";"Hello";"num";1)) - $col.push(New object("beta";"You";"what";$p)) - - $col2:=$col.copy() - $col2[1].beta:="World!" - ALERT($col[0].alpha+" "+$col2[1].beta) //muestra "Hello World!" - - $what:="You!" - $col3:=$col2.copy(ck resolve pointers) - ALERT($col3[0].alpha+" "+$col3[1].what) //muestra "Hello You!" +Mayor que ``` @@ -450,13 +429,13 @@ Este ejemplo ilustra el uso de la opción `ck resolve pointers`: | Parámetros | Tipo | | Descripción | | ------------ | ---- | :-------------------------: | ---------------------------------------------------------------- | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de elementos en la colección | +| Result | Real | <- | Colección que contiene los elementos añadidos | #### Descripción -La función `.count()` devuelve el número de elementos no nulos en la colección. +Colección original sin elementos eliminados Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En este caso, sólo se tienen en cuenta los elementos que contienen el *propertyPath*. @@ -497,22 +476,22 @@ Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En | ------------ | ----------------------------------------------- | :-------------------------: | ---------------------------------------------------------------- | | value | Text, Number, Boolean, Date, Object, Collection | -> | Valor a contar | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de ocurrencias del valor | +| Result | Real | <- | Valor a contar | #### Descripción -La función `.countValues()` devuelve el número de veces que se encuentra el valor en la colección. +Mayor o igual que -Puede pasar en *value*: +Colección original ordenada - un valor escalar (texto, número, booleano, fecha), - una referencia de objeto o de colección. -Para encontrar un elemento, el tipo de *value* debe ser equivalente al tipo del elemento; el método utiliza el operador de igualdad. +Tipo -El parámetro opcional *propertyPath* permite contar valores dentro de una colección de objetos: pase en *propertyPath* la ruta de la propiedad cuyos valores quiere contar. +Resumen > Esta función no modifica la colección original. @@ -559,10 +538,10 @@ El parámetro opcional *propertyPath* permite contar valores dentro de una colec
Historia
-| Lanzamiento | Modificaciones | -| ----------- | ---------------------------- | -| 20 | Soporte de `ck count values` | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| 20 | Si se intenta eliminar un elemento de una colección vacía, el método no hace nada (no se genera ningún error). | +| v16 R6 | Añadidos |Historia
-| Lanzamiento | Modificaciones | -| ----------- | --------------------------------------------------------------------- | -| 20 R6 | Soporte de consultas utilizando las referencias de objeto o colección | -| 17 R5 | Soporte de querySettings | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------ | +| 20 R6 | Ejemplo 1 | +| 17 R5 | Soporte de querySettings | +| v16 R6 | Añadidos || Tipo de objeto | Descripción |
|---|---|
| Cadena | Ruta de acceso del atributo expresado utilizando la notación de punto, por ejemplo, "name" o "user.address.zipCode" |
| Colección de cadenas | Cada cadena de la colección representa un nivel de attributePath, por ejemplo, \["name"] o \["user","address","zipCode"]. El uso de una colección permite realizar consultas sobre atributos con nombres que no se ajustan a la notación de puntos, por ejemplo, \["4Dv17.1", "en/fr"] |
- true - the mailbox can be selected
- false - the mailbox can not be selected
- true - el buzón puede ser seleccionado
- false - el buzón de correo no puede ser seleccionado
- true - se puede crear un nivel inferior
- false - no se puede crear un nivel inferior
- true - El buzón ha sido marcado como "interesante" por el servidor. Por ejemplo, puede contener nuevos mensajes.
- false - El buzón no ha sido marcado como "interesante" por el servidor.
Historia
+ +| Lanzamiento | Modificaciones | +| ----------- | -------------- | +| 20 R8 | Clase añadida | + +| +| [](#getheader)
| +| [](#getjson)
| +| [](#getpicture)
| +| [](#gettext)
| +| [](#headers)
| +| [](#url)
| +| [](#urlPath)
| +| [](#urlQuery)
| +| [](#verb)
| + +:::note + +A 4D.IncomingMessage object is a [non-sharable](../Concepts/shared.md) object. + +::: + + + +## .getBlob() + +**.getBlob**() : Blob + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ---- | --------------------------- | ----------------------------- | +| Result | Blob | <- | Body of the request as a Blob | + + + +#### Descripción + +The `.getBlob()` function returns the body of the request as a Blob. + +If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. + + + + + +## .getHeader() + +**.getHeader**( *key* : Text ) : Text + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ---- | --------------------------- | ------------------------------------ | +| key | Text | -> | Header property to get | +| Result | Text | <- | Valor de la propiedad del encabezado | + + + +#### Descripción + +The `.getHeader()` function returns the value of the *key* header. + +:::note + +The *key* parameter is not case sensitive. + +::: + +#### Ejemplo + +```4d +var $value : Text +var $request : 4D.IncomingMessage +$value := $request.getHeader("content-type") +``` + + + + + +## .getJSON() + +**.getJSON**() : Variant + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | --------------------------- | ------------------------------------------ | +| Result | Variant | <- | JSON resolution of the body of the request | + + + +#### Descripción + +The `.getJSON()` function returns the body of the request as a JSON resolution. + +If the body has not been given as JSON valid content, an error is raised. + + + + + +## .getPicture() + +**.getPicture**() : Picture + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | --------------------------- | ------------------------------ | +| Result | Picture | <- | Body of the request as picture | + + + +#### Descripción + +The `.getPicture()` function returns the body of the request as a picture (in case of a body sent as a picture). + +The content-type must be given in the headers to indicate that the body is a picture. + +:::note + +If the request is built using the [`HTTPRequest` class](HTTPRequestClass.md), the picture must be sent in the body as a Blob with the appropriate content-type. + +::: + +If the body is not received as a valid picture, the function returns null. + + + + + +## .getText() + +**.getText**() : Text + + + +| Parámetros | Tipo | | Descripción | +| ---------- | ---- | --------------------------- | --------------------------- | +| Result | Text | <- | Body of the request as text | + + + +#### Descripción + +The `.getText()` function returns the body of the request as a text value. + +If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. + + + + + +## .headers + +**headers** : Object + +#### Descripción + +The `.headers` property contains the current headers of the incoming message as key/value pairs (strings). + +La propiedad `.headers` es de sólo lectura. + +Header names (keys) are lowercased. Note header names are case sensitive. + + + + + +## .url + +**url** : Text + +#### Descripción + +The `.url` property contains the URL of the request without the *IP:port* part and as a string. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". + +The `.url` property is read-only. + +:::note + +The "host" part of the request (*IP:port*) is provided by the [`host` header](#headers). + +::: + + + + + +## .urlPath + +**urlPath** : Collection + +#### Descripción + +The `.urlPath` property contains the URL of the request without the *IP:port* part and as a collection of strings. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. + +The `.urlPath` property is read-only. + + + + + +## .urlQuery + +**urlQuery** : Object + +#### Descripción + +The `.urlQuery` property contains the parameters of the request when they have been given in the URL as key/value pairs. + +The `.urlQuery` property is read-only. + +Parameters can be passed in the URL of requests **directly** or **as JSON contents**. + +#### Direct parameters + +Example: `http://127.0.0.1:8044/myCall?firstname=Marie&id=2&isWoman=true` + +In this case, parameters are received as stringified values in the `urlQuery` property: `urlQuery = {"firstname":"Marie" ,"id":"2" ,"isWoman":"true"}` + +#### JSON contents parameters + +Example: `http://127.0.0.1:8044/myCall/?myparams='[{"firstname": "Marie","isWoman": true,"id": 3}]'`. + +Parameters are passed in JSON format and enclosed within a collection. + +In this case, parameters are received as JSON text in the `urlQuery` property and can be parsed using [`JSON Parse`](../commands-legacy/json-parse.md). + +```4d +//urlQuery.myparams: "[{"firstname": "Marie","isWoman": true,"id": 3}]" +$test:=Value type(JSON Parse($r.urlQuery.myparams))=Is collection) //true +``` + +Special characters such as simple quotes or carriage returns must be escaped. + +Example: `http://127.0.0.1:8044/syntax/?mdcode=%60%60%604d` + +````4d +//urlQuery.mdcode = ```4d +$test:=Length($r.urlQuery.mdcode) //5 +```` + +:::note + +Parameters given in the body of the request using POST or PUT verbs are handled through dedicated functions: [`getText()`](#gettext), [`getPicture()`](#getpicture), [`getBlob()`](#getblob), [`getJSON()`](#getjson). + +::: + + + + + +## .verb + +**verb** : Text + +#### Descripción + +The `.verb` property contains the verb used by the request. + +HTTP and HTTPS request verbs include for example "get", "post", "put", etc. + +The `.verb` property is read-only. + + diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md index 4ff1cc8e2e3d29..aa48e9e13058c3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index 4ff1cc8e2e3d29..aa48e9e13058c3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md index 0f33a163b661f5..b2f2de5cc45467 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md @@ -7,7 +7,7 @@ La clase `POP3Transporter` permite recuperar mensajes de un servidor de correo P ### Objeto POP3 Transporter -POP3 Transporter objects are instantiated with the [`POP3 New transporter`](../commands/pop3-new-transporter.md) command. Ofrecen las siguientes propiedades y funciones: +Los objetos POP3 Transporter son instanciados con el comando [`POP3 New transporter`](../commands/pop3-new-transporter.md). Ofrecen las siguientes propiedades y funciones: | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -42,7 +42,7 @@ POP3 Transporter objects are instantiated with the [`POP3 New transporter`](../c #### Descripción -La función `4D.POP3Transporter.new()` crea y devuelve un nuevo objeto de tipo `4D.POP3Transporter`. It is identical to the [`POP3 New transporter`](../commands/pop3-new-transporter.md) command (shortcut). +La función `4D.POP3Transporter.new()` crea y devuelve un nuevo objeto de tipo `4D.POP3Transporter`. Es idéntico al comando [`POP3 New transporter`](../commands/pop3-new-transporter.md) (atajo). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md index 6225b2c4292b30..4d04332a838df1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SMTPTransporterClass.md @@ -7,7 +7,7 @@ La clase `SMTPTransporter` permite configurar conexiones SMTP y enviar correos e ### Objeto SMTP Transporter -SMTP Transporter objects are instantiated with the [`SMTP New transporter`](../commands/smtp-new-transporter.md) command. Ofrecen las siguientes propiedades y funciones: +Los objetos SMTP Transporter son instanciados con el comando [`SMTP New transporter`](../commands/smtp-new-transporter.md). Ofrecen las siguientes propiedades y funciones: | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -40,7 +40,7 @@ SMTP Transporter objects are instantiated with the [`SMTP New transporter`](../c #### Descripción -La función `4D.SMTPTransporter.new()` crea y devuelve un nuevo objeto del tipo `4D.SMTPTransporter`. It is identical to the [`SMTP New transporter`](../commands/smtp-new-transporter.md) command (shortcut). +La función `4D.SMTPTransporter.new()` crea y devuelve un nuevo objeto del tipo `4D.SMTPTransporter`. Es idéntico al comando [`SMTP New transporter`](../commands/smtp-new-transporter.md) (acceso directo). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md index 3a5b1f072f34d3..4f183829617b29 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -3,7 +3,7 @@ id: SessionClass title: Session --- -Session objects are returned by the [`Session`](../commands/session.md) command. Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar [privilegios](../ORDA/privileges.md). +Los objetos de sesión son devueltos por el comando [`Session`](../commands/session.md). Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar [privilegios](../ORDA/privileges.md). ### Tipos de sesiones @@ -12,7 +12,7 @@ The following types of sessions are supported by this class: - [**Sesiones usuario web**](WebServer/sessions.md): las sesiones usuario web están disponibles cuando [las sesiones escalables están activas en su proyecto](WebServer/sessions.md#enabling-sessions). Se utilizan para conexiones Web y REST, y se les pueden asignar privilegios. - [Sesiones usuario cliente remoto\*\*](../Desktop/clientServer.md#remote-user-sessions): en las aplicaciones cliente/servidor, los usuarios remotos tienen sus propias sesiones gestionadas en el servidor. - [**Sesión de procedimientos almacenados**](https://doc.4d.com/4Dv20R5/4D/20-R5/4D-Server-and-the-4D-Language.300-6932726.en.html): todos los procedimientos almacenados ejecutados en el servidor comparten la misma sesión usuario virtual. -- [**Standalone session**](../Project/overview.md#development): Local session object returned in single-user application (useful in development and test phases of client/server applications). +- [**Sesión independiente**](../Project/overview.md#development): objeto de sesión local devuelto en una aplicación de un solo usuario (útil en las fases de desarrollo y prueba de aplicaciones cliente/servidor). :::note @@ -271,11 +271,11 @@ End if #### Descripción -The `.id` property contains the unique identifier (UUID) of the user session. With 4D Server, this unique string is automatically assigned by the server for each session and allows you to identify its processes. +La propiedad `.id` contiene el identificador único (UUID) de la sesión de usuario. With 4D Server, this unique string is automatically assigned by the server for each session and allows you to identify its processes. :::tip -You can use this property to get the [`.storage`](#storage) object of a session thanks to the [`Session storage`](../commands/session-storage.md) command. +Puede utilizar esta propiedad para obtener el objeto [`.storage`](#storage) de una sesión gracias al comando [`Session storage`](../commands/session-storage.md). ::: @@ -351,12 +351,12 @@ This property is only available with remote client, stored procedure, and standa ::: -The `.info` property describes the remote client or stored procedure session on the server, or the standalone session. +La propiedad `.info` describe la sesión del cliente remoto o del procedimiento almacenado en el servidor, o la sesión autónoma. :::note - El objeto `.info` es el mismo objeto que el devuelto en la propiedad "session" por el comando [`Process activity`](../commands/process-activity.md) para sesiones de cliente remoto y procedimientos almacenados. -- The `.info` object is the same object as the one returned by the [`Session info`](../commands/session-info.md) command for a standalone session. +- El objeto `.info` es el mismo que devuelve el comando [`Session info`](../commands/session-info.md) para una sesión autónoma. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md index 0e579eed98cfa9..ab6418eaee23f2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md @@ -126,7 +126,7 @@ Esta propiedad está en **lectura-escritura**. #### Descripción -Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`. +Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`. Esta propiedad es de **solo lectura**. @@ -158,7 +158,7 @@ Esta propiedad es de **solo lectura**. La función `.trigger( )` define la propiedad `signaled` del objeto signal como **true** y despierta a todos los workers o procesos que esperan esta signal. -Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\` ya es **true**), la función no hace nada. +Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\` ya es **true**), la función no hace nada. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Backup/backup.md b/i18n/es/docusaurus-plugin-content-docs/current/Backup/backup.md index 78bd323cd76421..19b3f421e45d7b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Backup/backup.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Backup/backup.md @@ -16,7 +16,7 @@ Una copia de seguridad puede iniciarse de tres maneras: 1. Seleccione el elemento **Copia de seguridad...** en el menú **Archivo** de 4D. La ventana de copia de seguridad aparece: -  +  Puede ver la ubicación de la carpeta de copia de seguridad usando el menú emergente junto al área de "destino de copia de seguridad". Esta ubicación se define en la página **Copia de seguridad/configuración** de las Propiedades de la base. - También puede abrir el [Centro de mantenimiento y seguridad](MSC/overview.md) de 4D y mostrar la [página de copias de seguridad](MSC/backup.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/classes.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/classes.md index c3aa79e3a3f4a4..449f42d909d7a0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/classes.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/classes.md @@ -107,9 +107,9 @@ Las clases disponibles son accesibles desde sus class stores. Hay dos class stor -| Parámetros | Tipo | | Descripción | | -| ---------- | ------ | -------------------------------------- | ------------------------------------------------- | ---------------- | -| classStore | Object | &amp;larr; | Class store usuario para el proyecto o componente | | +| Parámetros | Tipo | | Descripción | | +| ---------- | ------ | - | ------------------------------------------------- | ---------------- | +| classStore | Object | ← | Class store usuario para el proyecto o componente | | El comando `cs` devuelve el almacén de clases de usuario para el proyecto o componente actual. Devuelve todas las clases de usuario [definidas](#class-definition) en el proyecto o componente abierto. Por defecto, sólo las [clases ORDA](ORDA/ordaClasses.md) están disponibles. @@ -127,9 +127,9 @@ $instance:=cs.myClass.new() -| Parámetros | Tipo | | Descripción | | -| ---------- | ------ | -------------------------------------- | -------------- | ---------------- | -| classStore | Object | &amp;larr; | Class store 4D | | +| Parámetros | Tipo | | Descripción | | +| ---------- | ------ | - | -------------- | ---------------- | +| classStore | Object | ← | Class store 4D | | El comando `4D` devuelve el almacén de clases para las clases 4D integradas. Ofrece acceso a las APIs específicas como [CryptoKey](API/CryptoKeyClass.md). @@ -158,7 +158,7 @@ Cuando una clase es [definida](#class-definition) en el proyecto, se carga en el - función [`new()`](API/ClassClass.md#new), que permite instanciar objetos de clase - propiedad [`isShared`](API/ClassClass.md#isshared), true si la clase es [compartida](#clases-compartidas) - propiedad [`isSingleton`](API/ClassClass.md#issingleton), verdadero si la clase define una [clase singleton](#singleton-classes). -- [`isSectionSingleton`](API/ClassClass.md#issectionsingleton) property, true if the class defines a [session singleton](#singleton-classes). +- propiedad [`isSectionSingleton`](API/ClassClass.md#issectionsingleton), true si la clase define un [singleton de sesión](#singleton-classes). - Propiedad [`me`](API/ClassClass.md#me), que permite instanciar y acceder a [singletons](#singleton-classes). Además, un objeto clase puede hacer referencia a un objeto [`constructor`](#class-constructor) (opcional). @@ -341,7 +341,7 @@ Una función constructora de clase acepta [parámetros](#parameters) opcionales Cuando llama a la función [`new()`](API/ClassClass.md#new), el constructor de clase es llamado con los parámetros opcionalmente pasados a la función `new()`. -Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function. +Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). El comando [`Super`](../commands/super.md) permite realizar llamadas a [`superclass`](../API/ClassClass#superclass), es decir, a la clase padre de la función. Puede crear y escribir propiedades de instancia dentro del constructor (ver ejemplo). Alternativamente, si los valores de las propiedades de instancia no dependen de los parámetros pasados al constructor, puede definirlos utilizando la palabra clave [`property`](#property). @@ -612,18 +612,18 @@ The following commands have specific features when they are used within class fu ### `Super` -The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function. Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). +El comando [`Super`](../commands/super.md) permite realizar llamadas a [`superclass`](../API/ClassClass#superclass), es decir, a la clase padre de la función. Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). -For more details, see the [`Super`](../commands/super.md) command description. +Para más detalles, vea la descripción del comando [`Super`](../commands/super.md). ### `This` -The [`This`](../commands/this.md) command returns a reference to the currently processed object. In most cases, the value of `This` is determined by how a class function is called. Usually, `This` refers to the object the function was called on, as if the function were on the object. +El comando [`This`](../commands/this.md) devuelve una referencia al objeto procesado actualmente. In most cases, the value of `This` is determined by how a class function is called. Usually, `This` refers to the object the function was called on, as if the function were on the object. Ejemplo: ```4d -//Class: ob +//Clase: ob Function f() : Integer return This.a+This.b @@ -638,7 +638,7 @@ $o.b:=3 $val:=$o.f() //8 ``` -For more details, see the [`This`](../commands/this.md) command description. +Para más detalles, vea la descripción del comando [`This`](../commands/this.md). ## Comandos de clases @@ -713,7 +713,7 @@ Si se utiliza la palabra clave `shared` en una clase usuario no compartida, se i ## Clases Singleton -Una **clase singleton** es una clase usuario que sólo produce una única instancia. For more information on the concept of singletons, please see the [Wikipedia page about singletons](https://en.wikipedia.org/wiki/Singleton_pattern). +Una **clase singleton** es una clase usuario que sólo produce una única instancia. Para más información sobre el concepto de singletons, por favor consulte la [página Wikipedia sobre los singletons](https://en.wikipedia.org/wiki/Singleton_pattern). ### Tipos de Singletons @@ -721,7 +721,7 @@ Una **clase singleton** es una clase usuario que sólo produce una única instan - a **process singleton** has a unique instance for the process in which it is instantiated, - a **shared singleton** has a unique instance for all processes on the machine. -- a **session singleton** is a shared singleton but with a unique instance for all processes in the [session](../API/SessionClass.md). Session singletons are shared within an entire session but vary between sessions. In the context of a client-server or a web application, session singletons make it possible to create and use a different instance for each session, and therefore for each user. +- un **singleton de sesión** es un singleton compartido pero con una instancia única para todos los procesos en la [sesión](../API/SessionClass.md). Session singletons are shared within an entire session but vary between sessions. In the context of a client-server or a web application, session singletons make it possible to create and use a different instance for each session, and therefore for each user. Singletons are useful to define values that need to be available from anywhere in an application, a session, or a process. @@ -745,14 +745,14 @@ Una vez instanciado, existe una clase singleton (y su singleton) siempre que exi Se declaran clases singleton añadiendo la(s) palabra(s) clave(s) apropiada(s) antes del [`Class constructor`](#class-constructor): -- To declare a (process) singleton class, write `singleton Class Constructor()`. -- To declare a shared singleton class, write `shared singleton Class constructor()`. -- To declare a session singleton class, write `session singleton Class constructor()`. +- Para declarar una clase singleton (proceso), escriba `singleton Class Constructor()`. +- Para declarar una clase singleton compartida, escribe `shared singleton Class constructor()`. +- Para declarar una clase singleton de sesión, escriba `session singleton Class constructor()`. :::note -- Session singletons are automatically shared singletons (there's no need to use the `shared` keyword in the class constructor). -- Singleton shared functions support [`onHttpGet` keyword](../ORDA/ordaClasses.md#onhttpget-keyword). +- Los singletons de sesión son automáticamente singletons compartidos (no hay necesidad de usar la palabra clave `shared` en el constructor de clases). +- Las funciones compartidas Singleton soportan [palabra clave `onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword). ::: @@ -762,7 +762,7 @@ Si necesita instanciar un singleton con parámetros, también puede llamar la fu La propiedad [`isSingleton`](../API/ClassClass.md#issingleton) de los objetos Clase permite saber si la clase es un singleton. -The [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) property of Class objects allows to know if the class is a session singleton. +La propiedad [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) de los objetos Class permite saber si la clase es un singleton de sesión. ### Ejemplos @@ -856,4 +856,4 @@ $myList := cs.ItemInventory.me.itemList #### Ver también -[Singletons in 4D](https://blog.4d.com/singletons-in-4d) (blog post)
[Session Singletons](https://blog.4d.com/introducing-session-singletons) (blog post). +[Singletons en 4D](https://blog.4d.com/singletons-in-4d) (post del blog)
[Singletons de sesión](https://blog.4d.com/introducing-session-singletons) (post del blog). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md index c057af90892ba8..e867d76d8e4ca4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md @@ -46,18 +46,18 @@ Las colecciones deben haber sido instanciadas, de lo contrario intentar leer o m La instanciación de la colección puede realizarse de una de las siguientes maneras: -- using the [`New collection`](../commands/new-collection.md) command, +- usando el comando [`New collection`](../commands/new-collection.md) - utilizando el operador `[]`. :::info -Several 4D commands and functions return collections, for example [`Monitored activity`](../commands-legacy/monitored-activity.md) or [`collection.copy`](../API/CollectionClass.md#copy). En este caso, no es necesario instanciar explícitamente la colección, el lenguaje 4D lo hace por usted. +Varios comandos y funciones 4D devuelven colecciones, por ejemplo [`Monitored activity`](../commands-legacy/monitored-activity.md) o [`collection.copy`](../API/CollectionClass.md#copy). En este caso, no es necesario instanciar explícitamente la colección, el lenguaje 4D lo hace por usted. ::: ### Comando `New collection` -The [`New collection`](../commands/new-collection.md) command creates a new empty or prefilled collection and returns its reference. +El comando [`New collection`](../commands/new-collection.md) crea una nueva colección vacía o prellenada y devuelve su referencia. Ejemplos: @@ -105,8 +105,8 @@ Si crea un literal de colección que contenga un único elemento, asegúrese de Puede crear dos tipos de colecciones: -- regular (non-shared) collections, using the [`New collection`](commands/new-collection.md) command or collection literal syntax (`[]`). Estas colecciones pueden ser editadas sin ningún control de acceso específico, pero no pueden ser compartidas entre procesos. -- shared collections, using the [`New shared collection`](commands/new-shared-collection.md) command. Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. El acceso a estas colecciones se controla mediante estructuras [`Use...End use`](Concepts/shared.md#useend-use). +- las colecciones estándar (no compartidas), utilizando el comando [`New collection`](commands/new-collection.md) o la sintaxis literal de la colección (`[]`). Estas colecciones pueden ser editadas sin ningún control de acceso específico, pero no pueden ser compartidas entre procesos. +- las colecciones compartidas, utilizando el comando [`New shared collection`](commands/new-shared-collection.md). Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. El acceso a estas colecciones se controla mediante estructuras [`Use...End use`](Concepts/shared.md#useend-use). Para más información, consulte la sección [Objetos y colecciones compartidos](shared.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_object.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_object.md index 16a56206980dc4..9e7a31ad9fd220 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_object.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_object.md @@ -47,7 +47,7 @@ La instanciación de objetos puede realizarse de una de las siguientes maneras: :::info -Several 4D commands and functions return objects, for example [`Database measures`](https://doc.4d.com/4Dv19R7/4D/19-R7/database-measures.301-5945423.en.html) or [`File`](../commands/file.md). En este caso, no es necesario instanciar explícitamente el objeto, el lenguaje 4D lo hace por usted. +Varias funciones y comandos 4D devuelven objetos, por ejemplo [`Database measures`](https://doc.4d.com/4Dv19R7/4D/19-R7/database-tilizes.301-5945423.en.html) o [`File`](../commands/file.md). En este caso, no es necesario instanciar explícitamente el objeto, el lenguaje 4D lo hace por usted. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/parameters.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/parameters.md index 3c2a6b91e83bee..48fed64ca4769b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/parameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/parameters.md @@ -451,11 +451,11 @@ Cuando los parámetros opcionales son necesarios en sus métodos, también puede Cuando pasa un parámetro, 4D siempre evalúa la expresión del parámetro en el contexto del método que llama y define el **valor resultante** en las variables locales en la función de clase o la subrutina. Las variables/parámetros locales no son los campos, variables o expresiones reales pasados por el método que llama; sólo contienen los valores que se han pasado. Las variables/parámetros locales no son los campos, variables o expresiones reales pasados por el método que llama; sólo contienen los valores que se han pasado. Por ejemplo: ```4d - //Here is some code from the method MY_METHOD -DO_SOMETHING([People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY_METHOD +DO_SOMETHING([People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Name) - //Here is the code of the method DO_SOMETHING + //Aquí está el código del método DO_SOMETHING #DECLARE($param : Text) $param:=Uppercase($param) ALERT($param) @@ -468,11 +468,11 @@ Hay dos formas de hacer que el método `DO_SOMETHING` cambie el valor del campo: 1. En lugar de pasar el campo al método, se pasa un puntero al mismo, por lo que se escribiría: ```4d - //Here is some code from the method MY_METHOD -DO_SOMETHING(->[People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY_METHOD +DO_SOMETHING(->[People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Last Name) - //Here the code of the method DO_SOMETHING + //Aquí el código del método DO_SOMETHING #DECLARE($param : Text) $param->:=Uppercase($param->) ALERT($param->) @@ -483,11 +483,11 @@ Aquí el parámetro no es el campo, sino un puntero al mismo. Therefore, within 2. En lugar de que el método `DO_SOMETHING` "haga algo", puede reescribir el método para que devuelva un valor. Por lo tanto, escribiría: ```4d - //Here is some code from the method MY METHOD - [People]Name:=DO_SOMETHING([People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY METHOD + [People]Name:=DO_SOMETHING([People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Name) - //Here the code of the method DO SOMETHING + //Aquí el código del método DO SOMETHING #DECLARE ($param : Text) -> ($result : Text) $result:=Uppercase($param) ALERT($result) @@ -499,7 +499,7 @@ This second technique of returning a value by a subroutine is called "using a fu Debe prestar atención al hecho de que los tipos de datos Objeto y Colección sólo pueden manejarse a través de una referencia (es decir, un _puntero_ interno). -Consequently, when using such data types as parameters, `$param, $return...` do not contain _values_ but _references_. Modifying the value of the `$param, $return...` parameters within the subroutine will be propagated wherever the source object or collection is used. This is the same principle as for [pointers](dt_pointer.md#pointers-as-parameters-to-methods), except that `$param, $return...` parameters do not need to be dereferenced in the subroutine. +Consequently, when using such data types as parameters, `$param, $return...` do not contain _values_ but _references_. Modifying the value of the `$param, $return...` parameters within the subroutine will be propagated wherever the source object or collection is used. Este es el mismo principio que para [los punteros](dt_pointer.md#pointers-as-parameters-to-methods), excepto que los parámetros `$param, $return...` no necesitan ser desreferenciados en la subrutina. Por ejemplo, considere el método `CreatePerson` que crea un objeto y lo envía como parámetro: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/paths.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/paths.md index fe9ec5a6e30ef0..1e648fd247850a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/paths.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/paths.md @@ -41,7 +41,7 @@ Con esta sintaxis: - los nombres de ruta absolutos empiezan por "/" - para subir una carpeta en una ruta relativa, utilice "../" delante del nombre de la ruta (por seguridad, no puede subir en el sistema de archivos). -In POSIX syntax, you will generally use `filesystem` pathnames with [`File`](../commands/file.md) and [`Folder`](../commands/folder.md) commands, for example: +En la sintaxis POSIX, generalmente usará los nombres de ruta `filesystem` con comandos [`File`](../commands/file.md) y [`Folder`](../commands/folder.md), por ejemplo: ```4d var $pathFile : 4D.File @@ -62,7 +62,7 @@ Se soportan los siguientes modelos: - el texto contiene ":" y "\" como segundo y tercer caracter, - el texto comienza con "\\". -Examples with [`Folder`](../commands/folder.md): +Ejemplos con [`Folder`](../commands/folder.md): ```4d $ok:=Folder("C:\\Monday";fk platform path).create() @@ -82,7 +82,7 @@ Se soportan los siguientes modelos (sintaxis HFS+): - los separadores de carpetas son ":" - la ruta no debe comenzar con un ":" -Examples with [`Folder`](../commands/folder.md): +Ejemplos con [`Folder`](../commands/folder.md): ```4d $ok:=Folder("macintosh hd:";fk platform path).create() @@ -93,7 +93,7 @@ $ok:=Folder("Monday:Tuesday";fk platform path).create() //un volume debe llamars ### Constructores `File` y `Folder` -[`File`](../commands/file.md) and [`Folder`](../commands/folder.md) commands only accept **absolute pathnames**. Las rutas relativas no están soportadas y devolverán errores. Por ejemplo, el siguiente código no es permitido: +Los comandos [`File`](../commands/file.md) y [`Folder`](../commands/folder.md) sólo aceptan **rutas absolutas**. Las rutas relativas no están soportadas y devolverán errores. Por ejemplo, el siguiente código no es permitido: ```4d //ERROR diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/shared.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/shared.md index a3a8f001b481ab..10af725a52701f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/shared.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/shared.md @@ -8,7 +8,7 @@ title: Objetos y colecciones compartidos Los objetos compartidos y las colecciones compartidas se almacenan en variables estándar [`Object`](dt_object.md) y [`Collection`](dt_collection.md), pero deben instanciarse utilizando comandos específicos: - para crear un objeto compartido, utilice el comando [`New shared object`](https://doc.4d.com/4dv20/help/command/en/page1471.html) o llama a la función [`new()`](../API/ClassClass.md#new) de una [clase compartida](classes.md#clases-compartidas), -- to create a shared collection, use the [`New shared collection`](../commands/new-shared-collection.md) command. +- para crear una colección compartida, utilice el comando [`New shared collection`](../commands/new-shared-collection.md). Los objetos y colecciones compartidas solo pueden contener valores escalares u otros objetos y colecciones compartidas. Sin embargo, los objetos y colecciones compartidos pueden establecerse como propiedades de objetos o colecciones estándar (no compartidos). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md index a91816761242b9..1f2e95f5ce8d1e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -49,7 +49,7 @@ var $myVar //una variable variant ``` `varName` es el nombre de la variable, debe cumplir con las [reglas 4D](Concepts/identifiers.md) sobre identificadores. -This syntax only supports [local and process variables](#local-process-and-interprocess-variables) declarations, thus excluding [interprocess variables](#interprocess-variables) (deprecated) and [arrays](Concepts/arrays.md). +Esta sintaxis solo soporta declaraciones de [variables locales y de proceso](#local-process-and-interprocess-variables), por lo que excluye [variables interproceso](#interprocess-variables) (obsoleto) y [arrays](Concepts/arrays.md). `varType` puede ser: @@ -163,7 +163,7 @@ var $a; $b : Integer:=15 //error ## Asignar los valores -Los datos pueden introducirse y copiarse en variables y arrays. Poner datos en una variable se llama **asignar los datos a la variable** y se hace con el operador de asignación (:=). El operador de asignación también se utiliza para asignar datos a campos. +Los datos pueden introducirse y copiarse en variables y arrays. Los datos pueden introducirse y copiarse en variables y arrays. El operador de asignación también se utiliza para asignar datos a campos. El operador de asignación es un primer medio para crear una variable e introducir datos en ella. Se escribe el nombre de la variable que se quiere crear a la izquierda del operador de asignación. Por ejemplo: @@ -201,7 +201,7 @@ El nombre de una variable local siempre comienza por el signo dólar ($) y puede Cuando se trabaja en un proyecto de aplicación con muchos métodos y variables, a menudo se encuentra que se necesita utilizar una variable sólo dentro del método en el que se está trabajando. Puede crear y utilizar una variable local en el método sin preocuparse de si ha utilizado el mismo nombre de variable en otro lugar. -Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. El comando `Request` puede obtener esta información. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo: +Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo: ```4d $vsID:=Request("Please enter your ID:") diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugger.md b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugger.md index 63fe48ace8d253..6ea80858e46b29 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugger.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugger.md @@ -3,10 +3,16 @@ id: debugger title: Debugger --- -El depurador es útil cuando se necesita detectar errores o controlar la ejecución de métodos. Le permite recorrer su código lentamente y examinar la información. Este proceso se llama "rastreo". +The 4D debugger is useful when you need to spot errors or monitor the execution of methods. Le permite recorrer su código lentamente y examinar la información. Este proceso se llama "rastreo".  +:::info + +If you are used to coding with **VS Code**, you can also use this editor to debug 4D code on 4D Server after installing the [4D-Debugger](https://github.com/4d/4D-Debugger-VSCode) extension. + +::: + ## Llamada al depurador Hay varias formas de conseguir que el depurador se muestre: @@ -36,7 +42,7 @@ La ventana del depurador suele aparecer en la máquina donde se ejecuta el códi :::note Notas - Si el servidor se ejecuta en modo sin interfaz, no se puede mostrar ninguna ventana de depuración en el servidor, es necesario utilizar el depurador remoto. Ver [Depuración desde máquinas remotas](./debugging-remote.md). -- You can also [attach the Qodly Studio debugger to a 4D Server application](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) if you need to debug Qodly pages in a deployed environment. +- También puede [adjuntar el depurador de Qodly Studio a una aplicación 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) si necesita depurar páginas Qodly en un entorno desplegado. ::: @@ -282,7 +288,7 @@ Para mostrar el tipo de parámetro, marque la opción **Mostrar tipos** en el me Después de desplegar la lista de parámetros, puede arrastrar y soltar los parámetros y los resultados de las funciones en el [Custom Watch Pane](#custom-watch-pane). -You can also use the [Call chain](https://doc.4d.com/4dv19/help/command/en/page1662.html) command to retrieve the call chain programmatically. +También puede utilizar el comando [Call chain](https://doc.4d.com/4dv19/help/command/en/page1662.html) para recuperar la cadena de llamadas por programación. ## Panel de vigilancia personalizado diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md index 3a2985f25d366b..0e2292591693e8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md @@ -19,7 +19,10 @@ Sólo un depurador puede depurar una aplicación 4D Server en un momento dado. S - el depurador local de 4D Server (por defecto) - si el servidor no está ejecutando sin interfaz. - el depurador de un cliente 4D remoto - si la sesión remota tiene acceso al modo Diseño. -- the [Qodly debugger](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) on 4D Server - if the server allows access to Qodly Studio. +- el [depurador Qodly](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) en el servidor 4D - si el servidor permite el acceso a Qodly Studio. +- the VS Code debugger, provided you installed the [4D-Debugger](https://github.com/4d/4D-Debugger-VSCode) extension. + +::: El depurador asociado es llamado cada vez que se encuentra un 4D Server: @@ -73,7 +76,7 @@ Para volver a conectar el depurador al servidor: > **Advertencia**: si se selecciona esta opción para un servidor que posteriormente se lanza en modo sin interfaz, el depurador no estará disponible para este servidor. -- En un cliente 4D remoto, esta opción se llama **Attach Remote Debugger At Startup**. Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Si el adjunto es aceptado (ver [Rejected attachment requests](#rejected-attachment-requests)), el depurador remoto se adjunta automáticamente al cliente 4D remoto y se muestra la opción **Detach Remote Debugger**. +- Asociar al depurador Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Depuradores adjuntos > Esta configuración se aplica por proyecto y se almacena localmente en el archivo [`.4DPreferences`](Project/architecture.md#userpreferencesusername). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Desktop/building.md b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/building.md index 42b150b3896244..c577528a07bc40 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Desktop/building.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/building.md @@ -20,7 +20,7 @@ El generador de aplicaciones le permite: Generar un paquete de proyecto puede realizarse utilizando: -- ya sea con el comando [`BUILD APPLICATION`](https://doc.4d.com/4dv20/help/command/en/page871.html), +- either the [`BUILD APPLICATION`](../commands-legacy/build-application.md) command, - o con el [diálogo Generar aplicación](#dialogo-generar-aplicacion). :::tip @@ -45,9 +45,9 @@ La generación sólo puede efectuarse una vez compilado el proyecto. Si seleccio Cada parámetro de generación de la aplicación se almacena como una llave XML en el archivo de proyecto de la aplicación llamado `buildApp.4DSettings`, ubicado en la carpeta [`Settings` del proyecto](../Project/architecture.md#settings-1). -Los parámetros por defecto se utilizan la primera vez que se utiliza la caja de diálogo del Generador de aplicaciones. El contenido del archivo proyecto se actualiza, si es necesario, al hacer clic en **Construir** o **Guardar los parámetros**. Puede definir varios archivos de parámetros XML para el mismo proyecto y utilizarlos con el comando [BUILD APPLICATION](https://doc.4d.com/4dv19/help/command/en/page871.html). +Los parámetros por defecto se utilizan la primera vez que se utiliza la caja de diálogo del Generador de aplicaciones. El contenido del archivo proyecto se actualiza, si es necesario, al hacer clic en **Construir** o **Guardar los parámetros**. You can define several other XML settings file for the same project and employ them using the [`BUILD APPLICATION`](../commands-legacy/build-application.md) command. -Las llaves XML ofrecen opciones adicionales a las que se muestran en la caja de diálogo del Generador de aplicaciones. La descripción de estas llaves se detalla en el manual [4D XML Keys BuildApplication](https://doc.4d.com/4Dv19/4D/19/4D-XML-Keys-BuildApplication.100-5447429.en.html). +Las llaves XML ofrecen opciones adicionales a las que se muestran en la caja de diálogo del Generador de aplicaciones. The description of these keys are detailed in the [4D XML Keys BuildApplication](https://doc.4d.com/4Dv20/4D/20/4D-XML-Keys-BuildApplication.100-6335734.en.html) manual. ### Archivo de historial @@ -59,9 +59,9 @@ Cuando se crea una aplicación, 4D genera un archivo de registro llamado _BuildA - Todos los errores que se han producido, - Todo problema de firma (por ejemplo, un plug-in no firmado). -La verificación de este archivo puede ayudarle a ahorrar tiempo durante los siguientes pasos de despliegue, por ejemplo, si tiene la intención de notarizar su aplicación. +Checking this file may help you saving time during the subsequent deployment steps, for example if you intend to [notarize](#about-notarization) your application on macOS. -> Utilice el comando `Get 4D file(Build application log file)` para obtener la ubicación del archivo de registro. +> Use the `Get 4D file(Build application log file)` statement to get the log file location. ## Nombre de la aplicación y carpeta de destino @@ -87,7 +87,7 @@ Esta funcionalidad crea un archivo _.4dz_ en una carpeta `Compiled Database/
(por ejemplo, This.firstName + This.lastName)_ | -| On Alternative Click |
(por ejemplo, This.firstName + This.lastName)_ | -| On Alternative Click |
" NEXT RECORD([Jockeys]) End while - WEB SEND FILE("results.htm") //Send the list to the results.htm form - //which contains a reference to the variable vLIST, - //for example + WEB SEND FILE("results.htm") //Enviar la lista al formulario results.htm + //que contiene una referencia a la variable vLIST, + //por ejemplo //... End if ``` @@ -219,9 +218,9 @@ End if El servidor web de 4D le permite recuperar datos enviados a través de peticiones POST o GET, utilizando formularios web o URLs. -Cuando el servidor web recibe una petición con datos en el encabezado o en la URL, 4D puede recuperar los valores de cualquier objeto HTML que contenga. This principle can be implemented in the case of a Web form, sent for example using [`WEB SEND FILE`](../commands-legacy/web-send-file.md) or [`WEB SEND BLOB`](../commands-legacy/web-send-blob.md), where the user enters or modifies values, then clicks on the validation button. +Cuando el servidor web recibe una petición con datos en el encabezado o en la URL, 4D puede recuperar los valores de cualquier objeto HTML que contenga. Este principio puede ser implementado en el caso de un formulario Web, enviado por ejemplo usando [`WEB SEND FILE`](../commands-legacy/web-send-file.md) o [`WEB SEND BLOB`](../commands-legacy/web-send-blob.md), donde el usuario introduce o modifica valores, luego hace clic en el botón de validación. -In this case, 4D can retrieve the values of the HTML objects found in the request using the [`WEB GET VARIABLES`](../commands-legacy/web-get-variables.md) command. El comando `WEB GET VARIABLES` recupera los valores como texto. +En este caso, 4D puede recuperar los valores de los objetos HTML encontrados en la solicitud usando el comando [`WEB GET VARIABLES`](../commands-legacy/web-get-variables.md). El comando `WEB GET VARIABLES` recupera los valores como texto. Considere el siguiente código fuente de la página HTML: @@ -282,7 +281,7 @@ Las principales características de esta página son: Examinemos el método 4D `WWW_STD_FORM_POST` que se llama cuando el usuario hace clic en uno de los botones del formulario HTML. ```4d - // Retrieval of value of variables + // Recuperación del valor de las variables ARRAY TEXT($arrNames;0) ARRAY TEXT($arrValues;0) WEB GET VARIABLES($arrNames;$arrValues) @@ -290,25 +289,25 @@ Examinemos el método 4D `WWW_STD_FORM_POST` que se llama cuando el usuario hace Case of - // The Log On button was clicked + // Se ha presionado el botón Log On :(Find in array($arrNames;"vsbLogOn")#-1) $user :=Find in array($arrNames;"vtUserName") QUERY([WWW Users];[WWW Users]UserName=$arrValues{$user}) $0:=(Records in selection([WWW Users])>0) If($0) WWW POST EVENT("Log On";WWW Log information) - // The WWW POST EVENT method saves the information in a database table + // El método WWW POST EVENT guarda la información en una tabla de la base Else $0:=WWW Register - // The WWW Register method lets a new Web user register + // El método WWW Register permite que un nuevo usuario de la Web se registre End if - // The Register button was clicked + // Se ha presionado el botón Register :(Find in array($arrNames;"vsbRegister")#-1) $0:=WWW Register - // The Information button was clicked + // Se ha presionado el botón de información :(Find in array($arrNames;"vsbInformation")#-1) WEB SEND FILE("userinfos.html") End case @@ -325,9 +324,9 @@ Tenga en cuenta que con HTML, todos los objetos son objetos de texto. Si se util El servidor web de 4D ofrece varios comandos web de bajo nivel que le permiten desarrollar un procesamiento personalizado de las solicitudes: -- the [`WEB GET HTTP BODY`](../commands-legacy/web-get-http-body.md) command returns the body as raw text, allowing any parsing you may need -- the [`WEB GET HTTP HEADER`](../commands-legacy/web-get-http-header.md) command return the headers of the request. Es útil para manejar cookies personalizadas, por ejemplo (junto con el comando `WEB SET HTTP HEADER`). -- the [`WEB GET BODY PART`](../commands-legacy/web-get-body-part.md) and [`WEB Get body part count`](../commands-legacy/web-get-body-part-count.md) commands to parse the body part of a multi-part request and retrieve text values, but also files posted, using BLOBs. +- el comando [`WEB GET HTTP BODY`](../commands-legacy/web-get-http-body.md) devuelve el cuerpo como texto crudo, permitiendo cualquier análisis que pueda necesitar +- el comando [`WEB GET HTTP HEADER`](../commands-legacy/web-get-http-header.md) devuelve los encabezados de la solicitud. Es útil para manejar cookies personalizadas, por ejemplo (junto con el comando `WEB SET HTTP HEADER`). +- los comandos [`WEB GET BODY PART`](../commands-legacy/web-get-body-part.md) y [`WEB Get body part count`](../commands-legacy/web-get-body-part-count.md) para analizar la parte del cuerpo de una petición de varias partes y recuperar los valores de texto, pero también los archivos publicados, usando BLOBs. Estos comandos se resumen en el siguiente gráfico: @@ -337,6 +336,6 @@ El servidor web de 4D ahora soporta archivos cargados con codificación chunked ## Método proyecto COMPILER_WEB -El método COMPILER\WEB, si existe, es llamado sistemáticamente cuando el servidor HTTP recibe una petición dinámica y llama al motor 4D. Este es el caso, por ejemplo, cuando el servidor web de 4D recibe un formulario publicado o una URL para procesar en [`On Web Connection`](#on-web-connection). Este método está destinado a contener directivas de digitación y/o inicialización de variables utilizadas durante los intercambios web. Es utilizado por el compilador cuando se compila la aplicación. El método COMPILER\WEB es común a todos los formularios web. Por defecto, el método COMPILER_WEB no existe. Debe crearlo explícitamente. +El método COMPILER\WEB, si existe, es llamado sistemáticamente cuando el servidor HTTP recibe una petición dinámica y llama al motor 4D. El método COMPILER\WEB, si existe, es llamado sistemáticamente cuando el servidor HTTP recibe una petición dinámica y llama al motor 4D. Este método está destinado a contener directivas de digitación y/o inicialización de variables utilizadas durante los intercambios web. Es utilizado por el compilador cuando se compila la aplicación. El método COMPILER\WEB es común a todos los formularios web. Por defecto, el método COMPILER_WEB no existe. Debe crearlo explícitamente. > También se llama al método proyecto COMPILER_WEB, si existe, para cada solicitud SOAP aceptada. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md index 1d77cc1b26c71a..26abce6533ac94 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/qodly-studio.md @@ -84,7 +84,7 @@ De acuerdo con la gestión de proyectos 4D, sólo se admiten los siguientes usos :::warning -You can open Qodly Studio, [debug](#using-qodly-debugger-on-4d-server) and edit Qodly pages directly on a 4D Server machine when a project is running in interpreted mode. This feature is only provided for testing and debugging purposes, for example to evaluate the application flow with actual data, or in multi-user environment. It must NOT be considered as a regular way to develop applications since it does not provide any control over concurrent accesses. +Puede abrir Qodly Studio, [debug](#using-qodly-debugger-on-4d-server) y editar páginas Qodly directamente en una máquina 4D Server cuando un proyecto se está ejecutando en modo interpretado. This feature is only provided for testing and debugging purposes, for example to evaluate the application flow with actual data, or in multi-user environment. It must NOT be considered as a regular way to develop applications since it does not provide any control over concurrent accesses. ::: @@ -128,15 +128,15 @@ No existe compatibilidad directa entre las aplicaciones implementadas con 4D y l ### Comparación de funcionalidades -| | Qodly Studio en 4D | Qodly Studio in Qodly Cloud platform | -| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- | -| Ver y editar tablas (clases de datos), atributos y relaciones | Editor de estructura 4D(1) | Qodly Studio Model Editor | -| Páginas Qodly | Editor de páginas Qodly Studio | Editor de páginas Qodly Studio | -| Formularios de escritorio | 4D IDE | _not supported_ | -| Lenguaje de programación | Lenguaje 4D con ORDA | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) con ORDA | -| IDE de código | 4D IDE code editor _or_ VS Code with [4D extension](https://github.com/4d/4D-Analyzer-VSCode)
_4D Server only_: Qodly Studio code editor (see (2)) | Editor de código Qodly Studio | -| Debugger | 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 | +| | Qodly Studio en 4D | Qodly Studio in Qodly Cloud platform | +| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| Ver y editar tablas (clases de datos), atributos y relaciones | Editor de estructura 4D(1) | Qodly Studio Model Editor | +| Páginas Qodly | Editor de páginas Qodly Studio | Editor de páginas Qodly Studio | +| Formularios de escritorio | 4D IDE | _not supported_ | +| Lenguaje de programación | Lenguaje 4D con ORDA | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) con ORDA | +| IDE de código | 4D IDE code editor _or_ VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
_4D Server only_: Qodly Studio code editor (see (2)) | Editor de código Qodly Studio | +| Debugger | 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.
(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)). @@ -217,13 +217,13 @@ https://www.myWebSite.com/$lib/renderer/?w=welcome You can preview your Qodly application at any moment by selecting the **Preview Qodly Application...** command in the **Windows** menu (4D Server) or in the **Design** menu (4D single-user). -This command launches the Qodly renderer on a local address in your default browser and displays the **start page** [defined in the Application settings](https://developer.qodly.com/docs/studio/settings#start-page) of Qodly Studio. +Este comando lanza el renderizador de Qodly en una dirección local en su navegador por defecto y muestra la **página de inicio** [definida en la Configuración de la aplicación](https://developer.qodly.com/docs/studio/settings#start-page) de Qodly Studio. ### Using Qodly debugger on 4D Server When using Qodly pages in a deployed 4D Server application (interpreted mode), you might encounter some cases where you need to debug your pages on the server, for example when a specific user configuration is required. In this case, you can attach the [Qodly Studio debugger](https://developer.qodly.com/docs/studio/debugging) to the 4D Server and then, benefit from its features when executing your Qodly pages. -Note that in this case, the Qodly Studio debugger will display all the code executed on the server, in accordance with the [attached debugger rule on 4D Server](../Debugging/debugging-remote.md#attached-debugger). +Tenga en cuenta que en este caso, el depurador Qodly Studio mostrará todo el código ejecutado en el servidor, de acuerdo con la [regla del depurador adjunta en el servidor 4D](. /Debugging/debugging-remote.md#attached-debugger). Para adjuntar el depurador Qodly Studio a su aplicación 4D Server en ejecución: 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 46285e1087b2aa..5f551e5c6b37b5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -84,7 +84,7 @@ Una sesión web escalable se cierra cuando: La vida útil de una cookie inactiva es de 60 minutos por defecto, lo que significa que el servidor web cerrará automáticamente las sesiones inactivas después de 60 minutos. -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. +Este tiempo de espera puede establecerse utilizando la propiedad [`.idleTimeout`](API/SessionClass.md#idletimeout) del objeto `Session` (el tiempo de espera no puede ser inferior a 60 minutos) o el parámetro _connectionInfo_ del comando [`Open datastore`](../commands/open-datastore.md). When a web session is closed, if the [`Session`](commands/session.md) command is called afterwards: @@ -100,7 +100,7 @@ Puede cerrar una sesión desde un formulario Qodly utilizando la función [**log ## Privilegios -Los privilegios pueden asociarse a sesiones de usuario web. En el servidor web, puede proporcionar un acceso o unas funcionalidades específicas en función de los privilegios de la sesión. +Fecha de caducidad de la sesión En el servidor web, puede proporcionar un acceso o unas funcionalidades específicas en función de los privilegios de la sesión. Puedes asignar privilegios utilizando la función [`.setPrivileges()`](API/SessionClass.md#setprivileges). En su código, puede comprobar los privilegios de la sesión para permitir o denegar el acceso utilizando la función [`.hasPrivilege()`](API/SessionClass.md#hasprivilege). Por defecto, las sesiones nuevas no tienen ningún privilegio: son sesiones **Invitadas** (la función [`.isGuest()`](API/SessionClass.md#isguest) devuelve true). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/command-index.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/command-index.md index 427f8ba4e1eb49..cbedc6bf156515 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/command-index.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/command-index.md @@ -23,9 +23,9 @@ title: Comandos 4D Write Pro [`WP DELETE FOOTER`](../commands-legacy/wp-delete-footer.md)
[`WP DELETE HEADER`](../commands-legacy/wp-delete-header.md)
[`WP DELETE PICTURE`](../commands-legacy/wp-delete-picture.md)
-[`WP DELETE SECTION`](wp-delete-section.md) ***New 4D 20 R7***
+[`WP DELETE SECTION`](wp-delete-section.md) ***Nuevo 4D 20 R7***
[`WP DELETE STYLE SHEET`](../commands-legacy/wp-delete-style-sheet.md)
-[`WP DELETE SUBSECTION`](wp-delete-subsection.md) ***Modified 4D 20 R7***
+[`WP DELETE SUBSECTION`](wp-delete-subsection.md) ***Modificado 4D 20 R7***
[`WP DELETE TEXT BOX`](../commands-legacy/wp-delete-text-box.md) E @@ -93,7 +93,7 @@ title: Comandos 4D Write Pro R -[`WP RESET ATTRIBUTES`](wp-reset-attributes.md) ***Modified 4D 20 R7*** +[`WP RESET ATTRIBUTES`](wp-reset-attributes.md) ***Modificado 4D 20 R7*** S diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-delete-subsection.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-delete-subsection.md index 48c2e8c2b8f8a0..300673257f3ed8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-delete-subsection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-delete-subsection.md @@ -51,9 +51,9 @@ You want to delete the first page subsection of the first section: ```4d var $section;$subsection : Object - // get first section + // obtener la primera sección $section:=WP Get section(wpDoc;1) - // Delete the subsection + // Eliminar la subsección WP DELETE SUBSECTION($section;wk first page) ``` diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-reset-attributes.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-reset-attributes.md index 978de19c1f2ed7..e95acc59fe69e5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-reset-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-reset-attributes.md @@ -9,11 +9,11 @@ displayed_sidebar: docs -| Parámetros | Tipo | | Descripción | -| ------------------- | ------ | - | ------------------------------------------------- | -| targetObj | Object | → | Range or element or 4D Write Pro document | -| sectionOrSubsection | Object | → | Section or subsection of a 4D Write Pro document | -| attribName | Text | → | Name of attribute(s) to remove | +| Parámetros | Tipo | | Descripción | +| ------------------- | ------ | - | --------------------------------------------------- | +| targetObj | Object | → | Range or element or 4D Write Pro document | +| sectionOrSubsection | Object | → | Section or subsection of a 4D Write Pro document | +| attribName | Text | → | Nombre de atributo(s) a eliminar | @@ -24,7 +24,7 @@ The **WP RESET ATTRIBUTES** command El comando Is a list devuelve TRUE si el valor pasado en *lista* es una referencia válida a una lista jerárquica. De lo contrario, devuelve FALSE. -#### Ejemplo 1 +#### Ejemplo Ver el ejemplo del comando [CLEAR LIST](clear-list.md "CLEAR LIST"). -#### Ejemplo 2 - -Ver los ejemplos del comando DRAG AND DROP PROPERTIES. - -#### Ver también - -*\_o\_DRAG AND DROP PROPERTIES* \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/new-log-file.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/new-log-file.md index c1317da7c16c24..3a43b2e74f60d0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/new-log-file.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/new-log-file.md @@ -30,6 +30,3 @@ El archivo se renombra con los números de backup´actuales de la base y el arch En caso de que se presente un error, el comando genera un código que puede interceptarse utilizando el comando [ON ERR CALL](on-err-call.md "ON ERR CALL"). -#### Ver también - -*\_o\_INTEGRATE LOG FILE* \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-action.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-action.md index bd57a992c41860..b3901475ad0f36 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-action.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-action.md @@ -27,9 +27,8 @@ displayed_sidebar: docs Si pasa el parámetro opcional *\** indica que el parámetro *objeto* es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro *objeto* es un campo o una variable. En este caso, se pasa una referencia de campo o variable en lugar de una cadena (campo o variable objeto únicamente). -En el parámetro *acción*, pase un cadena con el nombre de la acción estándar a asociar al objeto. Opcionalmente, la acción puede tener parámetros. Para mayor información sobre nombres de acciones, consulte la sección \[#title id="964"/\] en el manual de *Diseño 4D*. También puede pasar una de las siguientes constantes, que se encuentran en el tema "*Acción estándar*": +En el parámetro *acción*, pase un cadena con el nombre de la acción estándar a asociar al objeto. Opcionalmente, la acción puede tener parámetros. Para mayor información sobre nombres de acciones, consulte la sección Acción estándar en el manual de *Diseño 4D*. También puede pasar una de las siguientes constantes, que se encuentran en el tema "*Acción estándar*". -\[#table\_kst id="3229250,3229256,3229259,3229262,3229265,3233324,3229268,3229271,3229274,3229277,3229280,3232805,3229283,3229286,3229289,3249369,3247262,3233343,3233352,3233331,3249654,3233337,3233359,3233366,3233794,3229292,3229295,3229298,3229301,3229304,3229307,3229253,3229310,3229313,3229316,3229319,3229322,3229325,3229328,3229331,3229334,3229337,3229340,3233802,3229343,3229346" typeCol="false"/\] **Nota de compatibilidad**: las constantes heredadas (prefijadas por \_o\_ en el tema) están obsoletas a partir de 4D v16 R3\. Sin embargo, todavía son soportadas por compatibilidad. @@ -43,5 +42,4 @@ Usted desea asociar la acción estándar **Validate** con un botón: #### Ver también -*\_o\_OBJECT Get action* [OBJECT Get action](object-get-action.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-rgb-colors.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-rgb-colors.md index 2d4455ba2cf457..cdd0c8375eb3dd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-rgb-colors.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/object-set-rgb-colors.md @@ -104,6 +104,5 @@ Cambia a fondo transparente con un color de fuente claro: #### Ver también -*\_o\_OBJECT SET COLOR* [OBJECT GET RGB COLORS](object-get-rgb-colors.md) [Select RGB Color](select-rgb-color.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/picture-to-blob.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/picture-to-blob.md index 078e47b55e4a5d..4708d06856d212 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/picture-to-blob.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/picture-to-blob.md @@ -48,7 +48,6 @@ Desea convertir una imagen de un formato propietario a formato GIF y mostrarlo e #### Ver también -*\_o\_PICTURE TO GIF* [BLOB TO PICTURE](blob-to-picture.md) [PICTURE CODEC LIST](picture-codec-list.md) [WRITE PICTURE FILE](write-picture-file.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/print-selection.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/print-selection.md index 4572e8d3a2bd51..9dbb5b4154eba3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/print-selection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/print-selection.md @@ -60,7 +60,6 @@ El siguiente ejemplo selecciona todos los registros en la tabla \[Personas\]. El #### Ver también -*\_o\_PAGE SETUP* [ACCUMULATE](accumulate.md) [BREAK LEVEL](break-level.md) [Level](level.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/resolve-pointer.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/resolve-pointer.md index 0584d59d153e5c..564036a5ff895a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/resolve-pointer.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/resolve-pointer.md @@ -104,7 +104,6 @@ Este es un ejemplo de puntero a un array 2D: #### Ver también -*\_o\_DRAG AND DROP PROPERTIES* [Field](field.md) [Get pointer](get-pointer.md) [Is a variable](is-a-variable.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/set-document-properties.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/set-document-properties.md index 2dc35d930f3fd9..d31b455c92d0ce 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/set-document-properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/set-document-properties.md @@ -34,6 +34,4 @@ Las fechas y horas de creación y última modificación son administradas por el #### Ver también -*\_o\_SET DOCUMENT CREATOR* -*\_o\_SET DOCUMENT TYPE* [GET DOCUMENT PROPERTIES](get-document-properties.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/structure-file.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/structure-file.md index 711f4de5a99da9..dbb50d7e29a295 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/structure-file.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/structure-file.md @@ -64,7 +64,6 @@ El siguiente ejemplo puede utilizarse para saber si el método se llama desde un #### Ver también -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [COMPONENT LIST](component-list.md) [Data file](data-file.md) \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/use-character-set.md b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/use-character-set.md index 7080318764becc..61aa87f26a9788 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/use-character-set.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands-legacy/use-character-set.md @@ -42,8 +42,6 @@ La variable sistema OK toma el valor 1 si el mapa se carga correctamente, de lo #### Ver también -*\_o\_Mac to Win* -*\_o\_Win to Mac* [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) [EXPORT TEXT](export-text.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/4d.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/4d.md index 136c88ca224fc1..03a9c98f37f26d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/4d.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/4d.md @@ -10,4 +10,4 @@ displayed_sidebar: docs | ---------- | ------ | - | ---------------------------------------------- | | classStore | Object | ← | Class Store containing all built-in 4D classes | -The **4D** keyword is described in the [**Concept page for Classes**](../Concepts/classes.md#4d). +La palabra clave **4D** se describe en la [**página Concepto para Clases**](../Concepts/classes.md#4d). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/compile-project.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/compile-project.md index c30de2e84fd991..efc80429fd449b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/compile-project.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/compile-project.md @@ -54,7 +54,7 @@ Compilation errors, if any, are returned as objects in the *errors* collection. The *options* parameter is an object. Here are the available compilation options: -| **Property** | **Type** | **Description** | +| **Propiedad** | **Tipo** | **Description** | | ---------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | components | Collection | Collection of 4D.File objects to dependent components (must be already compiled) | | defaultTypeForButtons | Integer | Possible value: Is real or Is longint | @@ -62,7 +62,7 @@ The *options* parameter is an object. Here are the available compilation options | generateSymbols | Boolean | True to generate symbol information in the .symbols returned object | | generateSyntaxFile | Boolean | True to generate a [syntax file for code completion](../settings/general.md).md#generate-syntax-file-for-code-completion-when-compiled) in the \\Resources\\en.lproj folder of the project | | generateTypingMethods | Text | "reset" or "append" to generate typing methods. If value is "append", existing variable declarations won't be modified (compiler window behavior). If value is "reset" existing variable declarations are removed beforehand. | -| plugins | 4D.Folder object | Plug-ins folder to be used instead of the [Plugins folder of the current project](../Project/architecture.md#plugins). This property is only available with the *projectFile* syntax. | +| plugins | Objeto 4D.Folder | Plug-ins folder to be used instead of the [Plugins folder of the current project](../Project/architecture.md#plugins). This property is only available with the *projectFile* syntax. | | targets | Colección de cadenas | Possible values: "x86_64_generic", "arm64_macOS_lib". Pass an empty collection to execute syntax check only | | typeInference | Text | "all": The compiler deduces the types of all variables not explicitly declared, "locals": The compiler deduces the types of local variables not explicitly declared, "none": All variables must be explicitly declared in the code (legacy mode), "direct": All variables must be explicitly declared in the code ([direct typing](../Project/compiler.md#enabling-direct-typing)). | | warnings | Colección de objetos | Defines the warnings state | @@ -76,7 +76,7 @@ The *options* parameter is an object. Here are the available compilation options The object returned by **Compile project** has up to three properties: -| **Property** | **Type** | **Description** | +| **Propiedad** | **Tipo** | **Description** | | ---------------------------------------------------------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | success | Boolean | True si la acción guardar tiene éxito, false en caso contrario. | | errors | Colección de objetos | **Available only in case of error or warning**. Collection of objects describing compilation errors or warnings | @@ -95,7 +95,7 @@ The object returned by **Compile project** has up to three properties: | symbols.localVariables | Colección de objetos | List of local variables per method | | symbols.localVariables[].code | Object | [objeto código](#code-object) | | symbols.localVariables[].variables | Collection | Colección de [objetos variables](#variable-objects) | -| symbols.methods | Colección de objetos | List of methods | +| symbols.methods | Colección de objetos | Lista de métodos | | symbols.methods\[\].code | Object | [objeto código](#code-object) | | symbols.methods\[\].callCount | Number | Number of times this method has been called | | symbols.methods\[\].params | Collection | Collection of parameter types (Value type numerical codes) | @@ -107,7 +107,7 @@ For more information, see [Compilation tools](../Project/compiler.md#compilation `interprocessVariables.variables` and `processVariables.variables` contain objects with the following structure: -| **Property** | **Type** | **Description** | +| **Propiedad** | **Tipo** | **Descripción** | | -------------- | -------- | --------------------------------------------------------------------------------------------------------- | | name | Text | Name of the variable | | type | number | Type of the variable (like Value type command) | @@ -118,20 +118,20 @@ For more information, see [Compilation tools](../Project/compiler.md#compilation The `code` property in `methods.code` and `errors.code` is an object with the following properties: -| **Property** | **Type** | **Description** | -| -------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| type | Text | "projectMethod", "formObjectMethod", "formMethod", "databaseMethod", "triggerMethod", "executeOnServer" (when calling a project method with the *Execute on Server attribute*), "executeFormula" (when executing a formula via [PROCESS 4D TAGS](process-4d-tags.md) or evaluation of a formula in a 4D Write Pro document), "class", "classFunction", "formObjectExpression" (for errors occuring in expressions associated to form objects) | -| path | Text | Method path (same format as [METHOD OPEN PATH](method-open-path.md)) | -| file | 4D.File | Method file | -| | | **Returned depending on the value of the `type` property:** | -| methodName | Text | Métodos proyecto | -| tabla | Number | Number of the table (returned for a trigger, a table form method or a table form object method) | -| formName | Text | Form name (returned for a form method) | -| objectName | Text | Form object name (returned for an object method) | -| propertyName | Text | Form object property name (returned for a form object expression) | -| className | Text | Class name | -| functionName | Text | Nombre de la función de clase | -| databaseMethod | Number | Database method index | +| **Propiedad** | **Tipo** | **Description** | +| -------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| type | Text | "projectMethod", "formObjectMethod", "formMethod", "databaseMethod", "triggerMethod", "executeOnServer" (when calling a project method with the *Execute on Server attribute*), "executeFormula" (when executing a formula via [PROCESS 4D TAGS](../commands-legacy/process-4d-tags.md) or evaluation of a formula in a 4D Write Pro document), "class", "classFunction", "formObjectExpression" (for errors occuring in expressions associated to form objects) | +| path | Text | Method path (same format as [METHOD OPEN PATH](../commands-legacy/method-open-path.md)) | +| file | 4D.File | Method file | +| | | **Returned depending on the value of the `type` property:** | +| methodName | Text | Métodos proyecto | +| tabla | Number | Number of the table (returned for a trigger, a table form method or a table form object method) | +| formName | Text | Form name (returned for a form method) | +| objectName | Text | Form object name (returned for an object method) | +| propertyName | Text | Form object property name (returned for a form object expression) | +| className | Text | Class name | +| functionName | Text | Nombre de la función de clase | +| databaseMethod | Number | Database method index | #### Ejemplos @@ -191,4 +191,4 @@ var $result:=Compile project($options) #### Ver también -[BUILD APPLICATION](build-application.md) +[BUILD APPLICATION](../commands-legacy/build-application.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/create-entity-selection.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/create-entity-selection.md index 5e6e047ba447a2..0c5131c3f3cb82 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/create-entity-selection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/create-entity-selection.md @@ -20,9 +20,9 @@ displayed_sidebar: docs The `Create entity selection` command builds and returns a new, [alterable](../ORDA/entities.md#shareable-or-alterable-entity-selections) entity selection related to the dataclass matching the given *dsTable*, according to the current selection of this table. -If the current selection is sorted, an [ordered](../ORDA/dsMapping.md#ordered-or-unordered-entity-selection) entity selection is created (the order of the current selection is kept). Si la selección actual no está ordenada, se crea una selección de entidades no ordenada. +Si la selección actual está ordenada, se crea una entity selection [ordenada](../ORDA/dsMapping.md#ordered-or-unordered-entity-selection) (se mantiene el orden de la selección actual). Si la selección actual no está ordenada, se crea una selección de entidades no ordenada. -If the *dsTable* is not exposed in [`ds`](ds.md), an error is returned. Este comando no puede utilizarse con un datastore remoto. +Si *dsTable* no está expuesto en [`ds`](ds.md), se devuelve un error. Este comando no puede utilizarse con un datastore remoto. En el parámetro opcional *settings*, puede pasar un objeto que contenga la siguiente propiedad: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/cs.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/cs.md index b9c46513ee3bfa..c044fa9741f644 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/cs.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/cs.md @@ -8,4 +8,4 @@ displayed_sidebar: docs | ---------- | ------ | - | ------------------------------------------------- | | classStore | Object | ← | Class store usuario para el proyecto o componente | -The **cs** keyword is described in the [**Concept page for Classes**](../Concepts/classes.md#cs). +La palabra clave **cs** se describe en la [**página Concepto para Clases**](../Concepts/classes.md#cs). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/dialog.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/dialog.md index a6e1282b01a124..447407ab7cfcf8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/dialog.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/dialog.md @@ -61,12 +61,13 @@ The dialog is closed by the user either with an "accept" action (triggered by th Keep in mind that validation does not equal saving: if the dialog includes fields, you must explicitly call the [SAVE RECORD](../commands-legacy/save-record.md) command to save any data that has been modified. +If you pass the optional *\** parameter, the form is loaded and displayed in the last open window of the current process and the command finishes its execution while leaving the active form on the screen.\ If you pass the optional *\** parameter, the form is loaded and displayed in the last open window of the current process and the command finishes its execution while leaving the active form on the screen.\ This form then reacts “normally” to user actions and is closed using a standard action or when 4D code related to the form (object method or form method) calls the [CANCEL](../commands-legacy/cancel.md) or [ACCEPT](../commands-legacy/accept.md) command. If the current process terminates, the forms created in this way are automatically closed in the same way as if a [CANCEL](../commands-legacy/cancel.md) command had been called. This opening mode is particularly useful for displaying a floating palette with a document, without necessarily requiring another process. **Notas:** -- You can combine the use of the **DIALOG**(form;\*) syntax with the [CALL FORM](call-form.md) command to establish communication between the forms. +- You can combine the use of the **DIALOG**(form;\*) syntax with the [CALL FORM](../commands-legacy/call-form.md) command to establish communication between the forms. - You must create a window before calling the **DIALOG**(form;\*) statement. It is not possible to use the current dialog window in the process nor the window created by default for each process. Otherwise, error -9909 is generated. - When the *\** parameter is used, the window is closed automatically following a standard action or a call to the [CANCEL](../commands-legacy/cancel.md) or [ACCEPT](../commands-legacy/accept.md) command. You do not have to manage the closing of the window itself. @@ -169,7 +170,7 @@ After a call to **DIALOG**, if the dialog is accepted, OK is set to 1; if it is [ACCEPT](../commands-legacy/accept.md)\ [ADD RECORD](../commands-legacy/add-record.md)\ -[CALL FORM](call-form.md)\ +[CALL FORM](../commands-legacy/call-form.md)\ [CANCEL](../commands-legacy/cancel.md)\ [Form](form.md)\ [Open window](../commands-legacy/open-window.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/folder.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/folder.md index 2fd64113249ed3..c9767b90052884 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/folder.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/folder.md @@ -29,7 +29,7 @@ displayed_sidebar: docs #### Descripción -El comando `Folder` crea y devuelve un nuevo objeto del tipo `4D.Folder`. El comando acepta dos sintaxis: +Comentario El comando acepta dos sintaxis: **Folder ( path { ; pathType } { ; \* } )** diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/form-event-code.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/form-event-code.md index 9a5260850bf18c..14bbfc74d68d19 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/form-event-code.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/form-event-code.md @@ -102,10 +102,10 @@ This example is a template for a form method. It shows each of the possible even #### Ejemplo 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](../commands-legacy/display-selection.md) or [MODIFY SELECTION](../commands-legacy/modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. ```4d - //A form method + ////Método formulario Case of :(Form event code=On Load) $vsTheEvent:="The form is about to be displayed" @@ -141,7 +141,7 @@ This example shows the template of a form method that handles the events that ca #### Ejemplo 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. #### Ejemplo 6 @@ -342,11 +342,11 @@ As a result, the red rectangle follows the scrolling of the list box: #### Ver también [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md)\ -[Current form table](current-form-table.md)\ -[FILTER KEYSTROKE](filter-keystroke.md)\ +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md)\ +[Current form table](../commands-legacy/current-form-table.md)\ +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md)\ [FORM Event](form-event.md)\ -[Get edited text](get-edited-text.md)\ -[Keystroke](keystroke.md)\ -[POST OUTSIDE CALL](post-outside-call.md)\ -[SET TIMER](set-timer.md) +[Get edited text](../commands-legacy/get-edited-text.md)\ +[Keystroke](../commands-legacy/keystroke.md)\ +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md)\ +[SET TIMER](../commands-legacy/set-timer.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/pop3-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/pop3-new-transporter.md index 1ad320b5d093b3..335da459df3f01 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/pop3-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/pop3-new-transporter.md @@ -29,21 +29,21 @@ The `POP3 New transporter` command ](../API/POP3TransporterClass.md#acceptunsecureconnection)
| False | -| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). Not returned in *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)* object. | ninguno | -| [](../API/POP3TransporterClass.md#authenticationmode)
| se utiliza el modo de autenticación más seguro soportado por el servidor | -| [](../API/POP3TransporterClass.md#connectiontimeout)
| 30 | -| [](../API/POP3TransporterClass.md#host)
| *obligatorio* | -| [](../API/POP3TransporterClass.md#logfile)
| ninguno | -| **.password** : Text
contraseña de usuario para la autenticación en el servidor. Not returned in *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)* object. | ninguno | -| [](../API/POP3TransporterClass.md#port)
| 995 | -| [](../API/POP3TransporterClass.md#user)
| ninguno | +| *server* | Valor por defecto (si se omite) | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ | +| [](../API/POP3TransporterClass.md#acceptunsecureconnection)
| False | +| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)*. | ninguno | +| [](../API/POP3TransporterClass.md#authenticationmode)
| se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](../API/POP3TransporterClass.md#connectiontimeout)
| 30 | +| [](../API/POP3TransporterClass.md#host)
| *obligatorio* | +| [](../API/POP3TransporterClass.md#logfile)
| ninguno | +| **.password** : Text
contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)*. | ninguno | +| [](../API/POP3TransporterClass.md#port)
| 995 | +| [](../API/POP3TransporterClass.md#user)
| ninguno | #### Result -The function returns a [**POP3 transporter object**](../API/POP3TransporterClass.md#pop3-transporter-object). Todas las propiedades devueltas son de sólo lectura\*\*. +La función devuelve un [**objeto POP3 transporter**](../API/POP3TransporterClass.md#pop3-transporter-object). Todas las propiedades devueltas son de sólo lectura\*\*. > La conexión POP3 se cierra automáticamente cuando se destruye el objeto transportador. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/smtp-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/smtp-new-transporter.md index 257e18ca09fea8..11213d2f5fe731 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/smtp-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/smtp-new-transporter.md @@ -11,7 +11,7 @@ displayed_sidebar: docs | Parámetros | Tipo | | Descripción | | ---------- | ---------------------------------- | - | --------------------------------------------------------------------------------- | | server | Object | → | Información del servidor de correo | -| Resultado | 4D.SMTPTransporter | ← | [SMTP transporter object](../API/SMTPTransporterClass.md#smtp-transporter-object) | +| Resultado | 4D.SMTPTransporter | ← | [Objeto SMTP transporter](../API/SMTPTransporterClass.md#smtp-transporter-object) | @@ -29,7 +29,7 @@ displayed_sidebar: docs The `SMTP New transporter` command configures a new SMTP connection according to the *server* parameter and returns a new [SMTP transporter object](../API/SMTPTransporterClass.md#smtp-transporter-object) object. El objeto transportador devuelto se utilizará normalmente para el envío de correos electrónicos. -> Este comando no abre ninguna conexión con el servidor SMTP. The SMTP connection is actually opened when the [`.send()`](../API/SMTPTransporterClass.md#send) function is executed. +> Este comando no abre ninguna conexión con el servidor SMTP. Este comando no abre ninguna conexión con el servidor SMTP. > > La conexión SMTP se cierra automáticamente: > diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/this.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/this.md index 87ea96fb715087..2795504a240e69 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/this.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/this.md @@ -50,7 +50,7 @@ $val:=$o.a //42 En todos los casos, `This` se refiere al objeto sobre el que se ha llamado el método, como si el método fuera una función del objeto. ```4d -//Class: ob +//Clase: ob Function f() : Integer return This.a+This.b @@ -70,7 +70,7 @@ En este ejemplo, el objeto asignado a la variable $o no tiene su propia propieda #### Objeto fórmula -In the context of the execution of a formula object created by the [Formula](formula.md) or [Formula from string](formula-from-string.md) commands, `This` returns a reference to the object currently processed by the formula. +En el contexto de la ejecución de un objeto fórmula creado por los comandos [Formula](formula.md) o [Formula from string](formula-from-string.md), `This` devuelve una referencia al objeto actualmente procesado por la fórmula. For example, you want to use a project method as a formula encapsulated in an object: @@ -79,8 +79,8 @@ For example, you want to use a project method as a formula encapsulated in an ob $person.firstName:="John" $person.lastName:="Smith" $person.greeting:=Formula(Greeting) - $g:=$person.greeting("hello") // returns "hello John Smith" - $g:=$person.greeting("hi") // returns "hi John Smith" + $g:=$person.greeting("hello") // devuelve "hola John Smith" + $g:=$person.greeting("hi") // devuelve "hi John Smith" ``` With the *Greeting* project method: @@ -92,7 +92,7 @@ With the *Greeting* project method: #### List box -In the context of a list box associated to a collection or an entity selection, during the [`On Display Detail`](../Events/onDisplayDetail.md) or the [`On Data Change`](../Events/onDataChange.md) events, `This` returns a reference to the collection element or entity accessed by the list box to display the current row. +En el contexto de un list box asociado a una colección o una selección de entidades, durante los eventos [`On Display Detail`](../Events/onDisplayDetail.md) o [`On Data Change`](../Events/onDataChange.md), `This` devuelve una referencia al elemento de colección o entidad a la que accede el list box para mostrar la línea actual. :::note @@ -127,7 +127,7 @@ A collection of objects, each with this structure: ``` -In the list box, each column refers to one of the properties of the object, either directly (This.name), indirectly (This.employees.length), or through an expression (*getPicture*) in which can be used directly. The list box looks like: +En el list box, cada columna se refiere a una de las propiedades del objeto, ya sea directamente (This.name), indirectamente (This.employees.length), o a través de una expresión (*getPicture*) en la que se puede usar directamente. The list box looks like:  @@ -160,13 +160,13 @@ You build a list box of the "Collection or entity selection" type with the follo Note que: - *This.ID*, *This.Title* and *This.Date* directly refers to the corresponding attributes in the ds.Event dataclass. -- *This.meetings* is a related attribute (based upon the One To Many relation name) that returns an entity selection of the ds.Meeting dataclass. +- *This.meetings* es un atributo relacionado (basado en el nombre de una relación de Uno a Muchos) que devuelve una selección de entidad de la base de datos ds.Meeting. - **Form.eventList** is the entity selection that is attached to the list box. The initialization code can be put in the on load form event: ```4d Case of :(Form event code=On Load) - Form.eventList:=ds.Event.all() //returns an entity selection with all entities + Form.eventList:=ds.Event.all() //devuelve una selección de entidad con todas las entidades End case ``` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-18/Concepts/dt_collection.md b/i18n/es/docusaurus-plugin-content-docs/version-18/Concepts/dt_collection.md index beaafacd4cbce6..5740d2651184da 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-18/Concepts/dt_collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-18/Concepts/dt_collection.md @@ -55,7 +55,7 @@ Ejemplo: Puede crear dos tipos de colecciones: - colecciones estándar (no compartidas), utilizando el comando `New collection`. Estas colecciones pueden ser editadas sin ningún control de acceso específico, pero no pueden ser compartidas entre procesos. -- colecciones compartidas, utilizando el comando `New shared collection`. Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. These collections can be shared between processes, including preemptive threads. Para más información, consulte la sección [Objetos y colecciones compartidos](Concepts/shared.md). +- colecciones compartidas, utilizando el comando `New shared collection`. Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. El acceso a estas colecciones es controlado por estructuras `Use...End use`. Para más información, consulte la sección [Objetos y colecciones compartidos](Concepts/shared.md). ## Métodos de colección diff --git a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Reference.md b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Reference.md index 4a637b41991583..d71f72543bd140 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Reference.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Reference.md @@ -134,7 +134,7 @@ En esta página encontrará una lista completa de todas las propiedades de los o | [scrollbarHorizontal](properties_Appearance.md#horizontal-scroll-bar) | Una herramienta que permite al usuario desplazar el área de visualización hacia la izquierda o la derecha. | "visible", "hidden", "automatic" | | [scrollbarVertical](properties_Appearance.md#vertical-scroll-bar) | Una herramienta que permite al usuario mover el área de visualización hacia arriba o hacia abajo. | "visible", "hidden", "automatic" | | [selectedItemsSource](properties_DataSource.md#selected-items) | Colección de los elementos seleccionados en un list box. | Expresión de la colección | -| [selectionMode](properties_Action.md#multi-selectable) (hierarchical list)
[selectionMode](properties_ListBox.md#selection-mode) (list box)
[selectionMode](properties_Subform.md#selection-mode) (subform) | Permite la selección de múltiples registros/líneas. | "multiple", "single", "none" | +| [selectionMode](properties_Action.md#multi-selectable) (lista jerárquica)
[selectionMode](properties_ListBox.md#selection-mode) (list box)
[selectionMode](properties_Subform.md#selection-mode) (subformulario) | Permite la selección de múltiples registros/líneas. | "multiple", "single", "none" | | [shortcutAccel](properties_Entry.md#shortcut) | Especifica el sistema a utilizar, Windows o Mac. | true, false | | [shortcutAlt](properties_Entry.md#shortcut) | Designa la tecla Alt | true, false | | [shortcutCommand](properties_Entry.md#shortcut) | Designa la tecla Comando (macOS) | true, false | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Scale.md b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Scale.md index a65bb9292bf2ae..8bcd38f4b774fb 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Scale.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Scale.md @@ -31,7 +31,7 @@ Muestra/Oculta las graduaciones junto a las etiquetas. #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) --- @@ -47,7 +47,7 @@ Medición de la visualización de la escala. #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) --- @@ -67,7 +67,7 @@ Especifica la ubicación del texto mostrado de un objeto. #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) --- @@ -86,7 +86,7 @@ Valor máximo de un indicador. #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) - [Stepper](stepper.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) - [Paso a paso](stepper.md) --- @@ -102,7 +102,7 @@ Valor mínimo de un indicador. Para los steppers numéricos, esta propiedad repr #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) - [Stepper](stepper.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) - [Paso a paso](stepper.md) --- @@ -118,4 +118,4 @@ Intervalo mínimo aceptado entre los valores durante el uso. Para los steppers n #### Objetos soportados -[Thermometer](progressIndicator.md#default-thermometer) - [Ruler](ruler.md) - [Stepper](stepper.md) +[Termómetro](progressIndicator.md#default-thermometer) - [Regla](ruler.md) - [Paso a paso](stepper.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Subform.md b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Subform.md index 5746d41edf29b8..3ec9678555106e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Subform.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-18/FormObjects/properties_Subform.md @@ -149,7 +149,7 @@ Especifica la tabla a la que pertenece el subformulario Lista (si la hay). ## Modo de selección Designa la opción para permitir a los usuarios seleccionar líneas: -- **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Clicking on the list will have no effect unless the [Enterable in list](#enterable-in-list) option is enabled. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. +- **Ninguna**: las líneas no se pueden seleccionar si se elige este modo. Hacer clic en la lista no tendrá ningún efecto a menos que la opción [Editable en lista](#enterable-in-list) esté activada. Las teclas de navegación sólo hacen que la lista se desplace; no se genera el evento de formulario `On Selection Change`. - **Simple**: en este modo se puede seleccionar una línea a la vez. Si hace clic en una línea, la seleccionará. Un **Ctrl+clic** (Windows) o **Comando+clic** (macOS) en una línea cambia su estado (entre seleccionada o no). Las teclas de flecha arriba y abajo seleccionan la línea anterior/siguiente de la lista. Las otras teclas de navegación se desplazan por la lista. El evento de formulario `On Selection Change` se genera cada vez que se cambia la línea actual. - **Múltiple**: en este modo se pueden seleccionar varias líneas simultáneamente. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-19/API/CryptoKeyClass.md b/i18n/es/docusaurus-plugin-content-docs/version-19/API/CryptoKeyClass.md index 1a1e06d4c91183..9fcd9681d98626 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-19/API/CryptoKeyClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-19/API/CryptoKeyClass.md @@ -141,7 +141,7 @@ ASSERT($status.success) **.curve** : Text -Definido sólo para llaves ECDSA: el nombre de la curva normalizada de la llave. Generalmente "prime256v1" para ES256 (por defecto), "secp384r1" para ES384, "secp521r1" para ES512. +Definido sólo para llaves RSA: el tamaño de la llave en bits. . @@ -350,7 +350,7 @@ La función `.sign()` firma la representac **.size** : Integer -Definido sólo para llaves RSA: el tamaño de la llave en bits. . +Definido sólo para llaves ECDSA: el el tamaño de la llave en bits. . ## .type @@ -387,6 +387,7 @@ Contiene el nombre del tipo de llave - "RSA" **.verify**( *message* : Text ; *signature* : Text ; *options* : Object) : Object + | Parámetros | Tipo | | Descripción | | ---------- | ------ | -- | ---------------------------------------------------------------------------------------------------- | @@ -407,11 +408,11 @@ La `CryptoKey` debe contener una llave **pública** válida. | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | hash | text | Algoritmo Digest a utilizar. Por ejemplo: "SHA256", "SHA384" o "SHA512". Cuando se utiliza para producir un JWT, el tamaño del hash debe coincidir con el tamaño del algoritmo PS@, ES@, RS@ o PS@ | | pss | boolean | Utilice el Probabilistic Signature Scheme (PSS). Se ignora si la llave no es una llave RSA. Pase `true` al verificar un JWT para el algoritmo PS@ | -| encoding | text | Encoding used to convert the binary encrypted message into the result string. Can be "Base64", or "Base64URL". Por defecto es "Base64". | +| encoding | text | Codificación utilizada para convertir el mensaje binario encriptado en la cadena de resultados. Puede ser "Base64", o "Base64URL". Por defecto es "Base64". | #### *Result* -La `CryptoKey` debe contener una llave **pública** válida. +La función devuelve un objeto de estado con la propiedad `success` definida como `true` si el `message` pudo ser verificado con éxito (es decir, la firma coincide). La función devuelve un objeto de estado con la propiedad `success` definida como `true` si el `message` pudo ser verificado con éxito (es decir, la firma coincide). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-19/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-19/API/DataClassClass.md index 96df2c096d4f13..c6a2e4ba240160 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-19/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-19/API/DataClassClass.md @@ -700,7 +700,7 @@ donde: * **Text**: la cadena de fórmulas debe ir precedida de la declaración `eval( )`, para que el analizador de consultas evalúe la expresión correctamente. Por ejemplo: *"eval(length(This.lastname) >=30)"* * **Object**: el [objeto fórmula](FunctionClass.md) se pasa como un **marcador** (ver abajo). La fórmula debe haber sido creada utilizando los comandos [`Formula`](FunctionClass.md#formula) o [`Formula from string`](FunctionClass.md#formula-from-string). -> * > * Keep in mind that 4D formulas only support `&` and `|` symbols as logical operators. +> * > * > * > * > * Keep in mind that 4D formulas only support `&` and `|` symbols as logical operators. > * Si la fórmula no es el único criterio de búsqueda, el optimizador del motor de búsquedas podría procesar previamente otros criterios (por ejemplo, los atributos indexados) y, por tanto, la fórmula podría evaluarse sólo para un subconjunto de entidades. Las fórmulas en las consultas pueden recibir parámetros a través de $1. Este punto se detalla en el párrafo **Parámetro fórmula** más abajo. @@ -723,7 +723,7 @@ donde: | Condición No aplicada a una sentencia | NOT | Los paréntesis son obligatorios cuando se utiliza NOT antes de una instrucción que contiene varios operadores | | Contiene palabra clave | % | Las palabras claves pueden utilizarse en atributos de tipo texto o imagen | -* **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades o elemento en la colección. Puede ser un **marcador** (ver **Uso de marcadores** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Al utilizar un valor constante, deben respetarse las siguientes reglas: +* **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades o elemento en la colección. Puede ser un **marcador** (ver **Uso de marcadores** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Al utilizar un valor constante, deben respetarse las siguientes reglas: Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20. * La constante de tipo **texto** puede pasarse con o sin comillas simples (ver **Uso de comillas** más abajo). Para consultar una cadena dentro de otra cadena (una consulta de tipo "contiene"), utilice el símbolo de comodín (@) en el valor para aislar la cadena a buscar como se muestra en este ejemplo: "@Smith@". Las siguientes palabras claves están prohibidas para las constantes de texto: true, false. * Valores constantes de tipo **boolean**: **true** o **false** (Sensible a las mayúsculas y minúsculas). * Valores constantes de tipo **numérico**: los decimales se separan con un '.' constantes de tipo de fecha: formato "YYYY-MM-DD" @@ -737,7 +737,7 @@ donde: | O | |,||, or | * **order by attributePath**: puede incluir una declaración order by *attributePath* en la búsqueda para que los datos resultantes se ordenen de acuerdo con esa declaración. Puede utilizar varias instrucciones de ordenación, separadas por comas (por ejemplo, ordenación por *attributePath1* desc, *attributePath2* asc). Por defecto, el orden es ascendente. Pase 'desc' para definir un orden descendente y 'asc' para definir un orden ascendente. -> > *If you use this statement, the returned entity selection is ordered (for more information, please refer to [Ordered vs Unordered entity selections](ORDA/dsMapping.md#ordered-or-unordered-entity-selection)). +> > > > > *If you use this statement, the returned entity selection is ordered (for more information, please refer to [Ordered vs Unordered entity selections](ORDA/dsMapping.md#ordered-or-unordered-entity-selection)). **Utilizar comillas** @@ -821,7 +821,7 @@ Al buscar dentro de atributos de objetos dataclass que contengan colecciones, el ``` Entity 1: -ds.Class.name: "A" +ds. Class.name: "A" ds.Class.info: { "coll" : [ { "val":1, @@ -829,7 +829,7 @@ ds.Class.info: } ] } Entity 2: -ds.Class.name: "B" +ds. Class.name: "B" ds.Class.info: { "coll" : [ { "val":1, @@ -837,7 +837,7 @@ ds.Class.info: } ] } Entity 3: -ds.Class.name: "C" +ds. Class.name: "C" ds.Class.info: { "coll" : [ { "val":0, @@ -852,11 +852,11 @@ Considere los siguientes resultados: // devuelve B y C // encuentra "entidades con 0 en al menos una propiedad val" -ds.Class.query("info.coll[].val != :1";0) +ds. Class.query("info.coll[].val != :1";0) // sólo devuelve A // encuentra "entidades en las que todas las propiedades val son distintas de 0" // lo que equivale a -ds.Class.query(not("info.coll[].val = :1";0)) +ds. Class.query(not("info.coll[].val = :1";0)) ``` Si desea implementar una búsqueda que encuentre entidades en las que "al menos una propiedad sea diferente del valor **", deberá utilizar una notación especial utilizando una letra en el `[]`: @@ -877,7 +877,7 @@ Esta funcionalidad sólo está disponible en las búsquedas en clases de datos y ::: -Al buscar dentro de los atributos de objetos de clases de datos que contengan colecciones utilizando varios argumentos de consulta unidos por el operador AND, es posible que desee asegurarse de que sólo se devuelvan entidades que contengan elementos que coincidan con todos los argumentos, y no entidades en las que los argumentos puedan encontrarse en elementos diferentes. Para ello, es necesario vincular los argumentos de la búsqueda a los elementos de colección, de modo que sólo se encuentren los elementos únicos que contengan argumentos vinculados. +Para ello, es necesario vincular los argumentos de la búsqueda a los elementos de colección, de modo que sólo se encuentren los elementos únicos que contengan argumentos vinculados. Al buscar dentro de los atributos de objetos de clases de datos que contengan colecciones utilizando varios argumentos de consulta unidos por el operador AND, es posible que desee asegurarse de que sólo se devuelvan entidades que contengan elementos que coincidan con todos los argumentos, y no entidades en las que los argumentos puedan encontrarse en elementos diferentes. Por ejemplo, con las dos entidades siguientes: @@ -932,7 +932,7 @@ La fórmula debe haber sido creada con el comando `Formula` o `Formula from stri * *fórmula* se evalúa para cada entidad y debe devolver true o false. Durante la ejecución de la búsqueda, si el resultado de la fórmula no es un booleano, se considera como false. * dentro de la *fórmula*, la entidad está disponible a través del objeto `This`. * si el objeto `Formula` es **null**, se genera el error 1626 ("Esperando un texto o una fórmula"), que llama a interceptar utilizando un método instalado con `ON ERR CALL`. -> > For security reasons, formula calls within `query(`) member methods can be disallowed. Ver la descripción del parámetro *querySettings*. +> > > > > For security reasons, formula calls within `query(`) member methods can be disallowed. Ver la descripción del parámetro *querySettings*. **Pasar parámetros a fórmulas** @@ -962,13 +962,13 @@ En el parámetro *querySettings* se puede pasar un objeto que contenga opciones | attributes | Object | **attributePath**: path of attribute on which you want to execute the query. Los atributos se expresan como pares propiedad / valor, donde propiedad es el nombre del marcador de posición insertado para una ruta de atributo en *queryString* o *formula* (":placeholder") y valor puede ser una cadena o una colección de cadenas. Cada valor es una ruta que puede designar un escalar o un atributo relacionado de la dataclass o una propiedad en un campo de objeto de la dataclass
| Tipo | Descripción |
|---|---|
| String | attributePath expresado con la notación de puntos, por ejemplo: "name" o "user.address.zipCode" |
| Colección de cadenas | Cada cadena de la colección representa un nivel de attributePath, por ejemplo: \["name"] o \["user","address","zipCode"]. El uso de una colección permite consultar atributos con nombres que no se ajustan a la notación de puntos, por ejemplo, ["4Dv17.1", "en/fr"] |
| | [](#remove)
| | [](#resize)
| -| [](#orderby)
| +| Ejemplo 2 | | [](#shift)
| | [](#slice)
| | [](#some)
| @@ -230,33 +229,27 @@ Esta función modifica la colección original. -| Parámetros | Tipo | | Descripción | -| ---------- | ------- | :-------------------------: | ------------------------------ | -| index | Integer | -> | Índice del elemento a devolver | -| Result | any | <- | El elemento en ese índice | +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | :-------------------------: | ----------------------------------------------------------------------------------- | +| index | Integer | -> | Índice del elemento a devolver | +| Result | any | <- | Este ejemplo devuelve las personas contratadas hace más de 90 días: | #### Descripción -La función `.at()` devuelve el elemento en la posición *index*, permitiendo enteros positivos y negativos. +Igual a > Esta función no modifica la colección original. Los números enteros negativos cuentan hacia atrás desde el último elemento de la colección. -La función devuelve Undefined si el *index* sobrepasa los límites de la colección. +Igual a #### Ejemplo ```4d -var $col : Collection -$col:=New collection(10; 20; 30; 40; 50) -$element:=$col.at(0) // 10 -$element:=$col.at(1) // 20 -$element:=$col.at(-1) // 50 -$element:=$col.at(-2) // 40 -$element:=$col.at(10) // indefinido +Lanzamiento ``` @@ -277,26 +270,26 @@ $element:=$col.at(10) // indefinido -| Parámetros | Tipo | | Descripción | -| ------------ | --------------- | :-------------------------: | ----------------------------------------------------------------------------- | -| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real, Undefined | <- | Media aritmética (promedio) de los valores de la colección | +| Parámetros | Tipo | | Descripción | +| ------------ | --------------- | :-------------------------: | ---------------------------------------------------------------- | +| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | +| Result | Real, Undefined | <- | donde: | #### Descripción -La función `.average()` devuelve la media aritmética (promedio) de los valores definidos en la instancia de la colección. +Diferente de Para el cálculo sólo se tienen en cuenta los elementos numéricos (se ignoran otros tipos de elementos). -Si la colección contiene objetos, pasa el parámetro *propertyPath* para indicar la propiedad del objeto a tener en cuenta. +Uso del paréntesis -`.average()` devuelve `undefined` si: +Number, Text, Date, Time, Boolean, Object, Collection, Picture, Pointer - la colección está vacía, - la colección no contiene elementos numéricos, -- *propertyPath* no se encuentra en la colección. +- Lanzamiento #### Ejemplo 1 @@ -335,15 +328,15 @@ Si la colección contiene objetos, pasa el parámetro *propertyPath* para indica -| Parámetros | Tipo | | Descripción | -| ---------- | ---------- | :-------------------------: | ----------------------------------------------------- | -| Result | Collection | <- | Colección original con todos los elementos eliminados | +| Parámetros | Tipo | | Descripción | +| ---------- | ---------- | :-------------------------: | ------------------------------------------- | +| Result | Collection | <- | Colección original sin elementos eliminados | #### Descripción -La función `.clear()` elimina todos los elementos de la instancia de la colección y devuelve una colección vacía. +Debe prestar atención a los siguientes aspectos de la conversión: > Esta función modifica la colección original. @@ -378,7 +371,7 @@ $vSize:=$col.length //$vSize=0 | ---------- | ---------- | :-------------------------: | ------------------------------------------------------------------------------------------------------------------------ | | col2 | Collection | -> | Colección a combinar | | index | Integer | -> | Posición a la que se deben combinar los elementos de inserción en la colección (por defecto=length+1) | -| Result | Collection | <- | Colección original que contiene elementos combinados | +| Result | Collection | <- | Colección original sin elementos eliminados | @@ -390,11 +383,11 @@ La función `.combine()` inserta eleme Por defecto, los elementos *col2* se añaden al final de la colección original. Puede pasar en *index* la posición donde desea insertar los elementos *col2* en la colección. -> **Atención**: recuerde que los elementos de la colección están numerados desde 0. +> Diferente de -- Si *index* > la longitud de la colección, el *index* inicial real será la longitud de la colección. -- Si *index* < 0, se recalcula como *index:=index+length* (se considera el desplazamiento desde el final de la colección). -- Si el valor calculado es negativo, *index* toma el valor 0. +- Ejemplo 1 +- Ejemplo 3 +- En caso de incoherencia, se aplican las siguientes reglas: #### Ejemplo @@ -423,20 +416,20 @@ $c.combine($fruits;3) //[1,2,3,"Orange","Banana","Apple","Grape",4,5,6] -| Parámetros | Tipo | | Descripción | -| ---------- | -------------------------------------------------------------- | :-------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------- | -| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos los elementos de la colección se añaden a la colección original | -| Result | Collection | <- | Nueva colección con valor(es) añadido(s) a la colección original | +| Parámetros | Tipo | | Descripción | +| ---------- | -------------------------------------------------------------- | :-------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------- | +| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos sus elementos se añaden al final de la colección original. | +| Result | Collection | <- | Colección original con valores rellenados | #### Descripción -La función.`.concat()` devuelve una nueva colección que contiene los elementos de la colección original con todos los elementos del parámetro *value* añadidos al final. +Colección compartida que se agrupa con la colección resultante > Esta función no modifica la colección original. -Si *value* es una colección, todos sus elementos se añaden al final de la colección original. Si *value* no es una colección, se añade ella misma como un nuevo elemento. +La colección devuelta contiene el elemento especificado por *startFrom* y todos los elementos subsiguientes hasta, pero sin incluir, el elemento especificado por *end*. Si sólo se especifica el parámetro *startFrom*, la colección devuelta contiene todos los elementos desde *startFrom* hasta el último elemento de la colección original. #### Ejemplo @@ -468,29 +461,29 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] -| Parámetros | Tipo | | Descripción | -| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------------------------------------------------------------------------------------- | -| option | Integer | -> | `ck resolve pointers`: resolver punteros antes de copiar,
`ck shared`: devolver una colección compartida | -| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | -| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | -| Result | Collection | <- | Copia profunda de la colección original | +| Parámetros | Tipo | | Descripción | +| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------- | +| option | Integer | -> | Ejemplo 3 | +| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | +| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | +| Result | Collection | <- | Colección original ordenada | #### Descripción -La función `.copy()` devuelve una copia profunda de la instancia de la colección.***Deep copy*** significa que los objetos o colecciones dentro de la colección original se duplican y no comparten ninguna referencia con la colección devuelta. +Uso de marcadores de posición > Esta función no modifica la colección original. -Si se pasa, el parámetro *option* puede contener una de las siguientes constantes (o ambas): +Lanzamiento | option | Descripción | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Sin embargo, puede resolver los punteros al copiar pasando la constante `ck resolve pointers`. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | +| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | | `ck shared` | Por defecto, `copy()` devuelve una colección Clásica (no compartida), incluso si el comando se aplica a una colección compartida. Pasa la constante `ck shared` para crear una colección compartida. En este caso, puede utilizar el parámetro *groupWith* para asociar la colección compartida con otra colección u objeto (ver más adelante). | -Los parámetros *groupWithCol* o *groupWithObj* permiten designar una colección o un objeto al que se debe asociar la colección resultante. +Ejemplo 2 :::note @@ -522,7 +515,7 @@ End use #### Ejemplo 2 -Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Por lo tanto, debemos hacer una copia compartida de *$sharedColl1* y designar *$sharedColl2* como grupo compartido para la copia. +Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection @@ -557,24 +550,10 @@ End use #### Ejemplo 4 -Este ejemplo ilustra el uso de la opción `ck resolve pointers`: +Primer elemento de la colección ```4d - var $col : Collection - var $p : Pointer - $p:=->$what - - $col:=New collection - $col.push(New object("alpha";"Hello";"num";1)) - $col.push(New object("beta";"You";"what";$p)) - - $col2:=$col.copy() - $col2[1].beta:="World!" - ALERT($col[0].alpha+" "+$col2[1].beta) //muestra "Hello World!" - - $what:="You!" - $col3:=$col2.copy(ck resolve pointers) - ALERT($col3[0].alpha+" "+$col3[1].what) //muestra "Hello You!" +Mayor que ``` @@ -598,13 +577,13 @@ Este ejemplo ilustra el uso de la opción `ck resolve pointers`: | Parámetros | Tipo | | Descripción | | ------------ | ---- | :-------------------------: | ---------------------------------------------------------------- | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de elementos en la colección | +| Result | Real | <- | Colección que contiene los elementos añadidos | #### Descripción -La función `.count()` devuelve el número de elementos no nulos en la colección. +Colección original sin elementos eliminados Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En este caso, sólo se tienen en cuenta los elementos que contienen el *propertyPath*. @@ -645,22 +624,22 @@ Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En | ------------ | ----------------------------------------------- | :-------------------------: | ---------------------------------------------------------------- | | value | Text, Number, Boolean, Date, Object, Collection | -> | Valor a contar | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de ocurrencias del valor | +| Result | Real | <- | Valor a contar | #### Descripción -La función `.countValues()` devuelve el número de veces que se encuentra el valor en la colección. +Mayor o igual que -Puede pasar en *value*: +Colección original ordenada - un valor escalar (texto, número, booleano, fecha), - una referencia de objeto o de colección. -Para encontrar un elemento, el tipo de *value* debe ser equivalente al tipo del elemento; el método utiliza el operador de igualdad. +Tipo -El parámetro opcional *propertyPath* permite contar valores dentro de una colección de objetos: pase en *propertyPath* la ruta de la propiedad cuyos valores quiere contar. +Resumen > Esta función no modifica la colección original. @@ -707,10 +686,10 @@ El parámetro opcional *propertyPath* permite contar valores dentro de una colec
Historia
-| Lanzamiento | Modificaciones | -| ----------- | ---------------------------- | -| 20 | Soporte de `ck count values` | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| 20 | Si se intenta eliminar un elemento de una colección vacía, el método no hace nada (no se genera ningún error). | +| v16 R6 | Añadidos |Historia
-| Lanzamiento | Modificaciones | -| ----------- | --------------------------------------------------------------------- | -| 20 R6 | Soporte de consultas utilizando las referencias de objeto o colección | -| 17 R5 | Soporte de querySettings | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------ | +| 20 R6 | Ejemplo 1 | +| 17 R5 | Soporte de querySettings | +| v16 R6 | Añadidos || Tipo de objeto | Descripción |
|---|---|
| Cadena | Ruta de acceso del atributo expresado utilizando la notación de punto, por ejemplo, "name" o "user.address.zipCode" |
| Colección de cadenas | Cada cadena de la colección representa un nivel de attributePath, por ejemplo, \["name"] o \["user","address","zipCode"]. El uso de una colección permite realizar consultas sobre atributos con nombres que no se ajustan a la notación de puntos, por ejemplo, \["4Dv17.1", "en/fr"] |
.sum() devuelve 0 si la entity selection está vacía.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FileHandleClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FileHandleClass.md
index 85f7fc68f1333b..eebc9e51518288 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FileHandleClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FileHandleClass.md
@@ -275,7 +275,7 @@ Esta propiedad es **lectura-escritura**.
:::caution
-Cuando se crea un file handle, el valor `.offset` es un número de bytes. Sin embargo, la unidad de medida del offset difiere según la función de lectura: con [`readBlob()`](#readblob), `.offset` es un número de bytes, mientras que con [`readText()`](#readtext)/[`readLine()`](#readline) es un número de caracteres. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Por lo tanto, si comienza a leer con `readBlob()` y luego llama a `readText()`, la lectura de texto comenzará en una posición inconsistente. Por ejemplo:
+Cuando se crea un file handle, el valor `.offset` es un número de bytes. Sin embargo, la unidad de medida del offset difiere según la función de lectura: con [`readBlob()`](#readblob), `.offset` es un número de bytes, mientras que con [`readText()`](#readtext)/[`readLine()`](#readline) es un número de caracteres. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Por ejemplo:
```4d
// Abrir un fichero de texto europeo con codificación utf-16 (dos bytes por caracter)
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FolderClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FolderClass.md
index 7b54fd0de407f3..6522c30efea923 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FolderClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/FolderClass.md
@@ -3,7 +3,7 @@ id: FolderClass
title: Folder
---
-Los objetos `Folder` se crean con el comando [`Folder`](#folder). Contienen referencias a carpetas que pueden o no existir realmente en el disco. Por ejemplo, cuando ejecuta el comando `Folder` para crear una nueva carpeta, se crea un objeto `Folder` válido, pero en realidad no se almacena nada en el disco hasta que llame a la función [`folder.create()`](#create).
+Comentario Contienen referencias a carpetas que pueden o no existir realmente en el disco. Por ejemplo, cuando ejecuta el comando `Folder` para crear una nueva carpeta, se crea un objeto `Folder` válido, pero en realidad no se almacena nada en el disco hasta que llame a la función [`folder.create()`](#create).
### Ejemplo
@@ -78,7 +78,7 @@ Los objetos `Folder` admiten varios nombres de ruta, incluida la sintaxis `files
#### Descripción
-El comando `Folder` crea y devuelve un nuevo objeto del tipo `4D.Folder`. El comando acepta dos sintaxis:
+Comentario El comando acepta dos sintaxis:
**Folder ( path { ; pathType } { ; \* } )**
@@ -364,7 +364,7 @@ La función `.moveTo( )` mueve o renom
La *destinationFolder* debe existir en el disco, de lo contrario se genera un error.
-Por defecto, la carpeta conserva su nombre cuando se mueve. Si desea cambiar renombrar la carpeta desplazada, pase el nombre completo en el parámetro *newName*. El nuevo nombre debe cumplir con las reglas de nomenclatura (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.
+Por defecto, la carpeta conserva su nombre cuando se mueve. Por defecto, la carpeta conserva su nombre cuando se mueve. El nuevo nombre debe cumplir con las reglas de nomenclatura (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.
**Objeto devuelto**
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/HTTPRequestClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/HTTPRequestClass.md
index ae933993b6cd83..f37baa038890ed 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/HTTPRequestClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/HTTPRequestClass.md
@@ -478,7 +478,7 @@ La propiedad `.url` contiene la URL de
## .wait()
-**.wait**( { *time* : Real } ) : HTTPRequestClass
+**.wait**( { *time* : Real } ) : 4D.HTTPRequest
@@ -499,6 +499,6 @@ Si se pasa un parámetro *time*, la función esperará como máximo el número d
Si la respuesta del servidor ya ha llegado, la función regresa inmediatamente.
-During a `.wait()` execution, callback functions are executed, whether from other `HTTPRequest` or [`SystemWorker`](SystemWorkerClass.md) instances, or other `CALL WORKER` calls. Puede salir de un `.wait()` llamando a [`terminate()`](#terminate) desde un callback.
+Durante una ejecución `.wait()`, las funciones de retrollamada se ejecutan, ya sea desde otras instancias `HTTPRequest` o [`SystemWorker`](SystemWorkerClass.md) u otras llamadas `CALL WORKER`. Puede salir de un `.wait()` llamando a [`terminate()`](#terminate) desde un callback.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
index 4206d6de65715f..88ff2672a2f23b 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/API/SignalClass.md
@@ -198,7 +198,7 @@ Esta propiedad está en **lectura-escritura**.
#### Descripción
-Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
+Lanzamiento Lanzamiento Lanzamiento Lanzamiento Lanzamiento Cuando se crea la señal, `.signaled` es **False**. La propiedad `.signaled` se convierte en true cuando cualquier worker/proceso llama al método `.trigger()`.
Esta propiedad es de **solo lectura**.
@@ -230,7 +230,7 @@ Esta propiedad es de **solo lectura**.
La función `.trigger( )` define la propiedad `signaled` del objeto signal como **true** y despierta a todos los workers o procesos que esperan esta signal.
-Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\` ya es **true**), la función no hace nada.
+Si la señal ya está en el estado de señalización (es decir, la propiedad signaled\\\\\\` ya es **true**), la función no hace nada.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Backup/backup.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Backup/backup.md
index 5a10c7257cdd6b..08b1ccee83c19f 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Backup/backup.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Backup/backup.md
@@ -16,7 +16,7 @@ Una copia de seguridad puede iniciarse de tres maneras:
1. Seleccione el elemento **Copia de seguridad...** en el menú **Archivo** de 4D.
La ventana de copia de seguridad aparece:
- 
+ 
Puede ver la ubicación de la carpeta de copia de seguridad usando el menú emergente junto al área de "destino de copia de seguridad". Esta ubicación se define en la página **Copia de seguridad/configuración** de las Propiedades de la base.
- También puede abrir el [Centro de mantenimiento y seguridad](MSC/overview.md) de 4D y mostrar la [página de copias de seguridad](MSC/backup.md).
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/classes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/classes.md
index 018045b9957b41..57d120781bd016 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/classes.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/classes.md
@@ -331,7 +331,7 @@ Una función constructora de clase acepta [parámetros](#parameters) opcionales
Cuando llama a la función [`new()`](API/ClassClass.md#new), el constructor de clase es llamado con los parámetros opcionalmente pasados a la función `new()`.
-Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function.
+Sólo puede haber una función constructora en una clase (de lo contrario se devuelve un error). El comando [`Super`](../commands/super.md) permite realizar llamadas a [`superclass`](../API/ClassClass#superclass), es decir, a la clase padre de la función.
Puede crear y escribir propiedades de instancia dentro del constructor (ver ejemplo). Alternativamente, si los valores de las propiedades de instancia no dependen de los parámetros pasados al constructor, puede definirlos utilizando la palabra clave [`property`](#property).
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/variables.md
index 8e6d7ee54866ac..fd51621a28aaae 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/variables.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Concepts/variables.md
@@ -160,7 +160,7 @@ var $a; $b : Integer:=15 //error
## Asignar los valores
-Los datos pueden introducirse y copiarse en variables y arrays. Poner datos en una variable se llama **asignar los datos a la variable** y se hace con el operador de asignación (:=). El operador de asignación también se utiliza para asignar datos a campos.
+Los datos pueden introducirse y copiarse en variables y arrays. Los datos pueden introducirse y copiarse en variables y arrays. El operador de asignación también se utiliza para asignar datos a campos.
El operador de asignación es un primer medio para crear una variable e introducir datos en ella. Se escribe el nombre de la variable que se quiere crear a la izquierda del operador de asignación. Por ejemplo:
@@ -204,7 +204,7 @@ El nombre de una variable local siempre comienza por el signo dólar ($) y puede
Cuando se trabaja en un proyecto de aplicación con muchos métodos y variables, a menudo se encuentra que se necesita utilizar una variable sólo dentro del método en el que se está trabajando. Puede crear y utilizar una variable local en el método sin preocuparse de si ha utilizado el mismo nombre de variable en otro lugar.
-Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. El comando `Request` puede obtener esta información. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo:
+Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo:
```4d
$vsID:=Request("Please enter your ID:")
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
index 0181851a0ee5a0..c8a06914651a84 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/Debugging/debugging-remote.md
@@ -72,7 +72,7 @@ Para volver a conectar el depurador al servidor:
> **Advertencia**: si se selecciona esta opción para un servidor que posteriormente se lanza en modo sin interfaz, el depurador no estará disponible para este servidor.
-- En un cliente 4D remoto, esta opción se llama **Attach Remote Debugger At Startup**. Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Si el adjunto es aceptado (ver [Rejected attachment requests](#rejected-attachment-requests)), el depurador remoto se adjunta automáticamente al cliente 4D remoto y se muestra la opción **Detach Remote Debugger**.
+- Asociar al depurador Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Depuradores adjuntos
> Esta configuración se aplica por proyecto y se almacena localmente en el archivo [`.4DPreferences`](Project/architecture.md#userpreferencesusername).
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/buttonGrid_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/buttonGrid_overview.md
index 1fa894fa42ca83..42f6225816a18c 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/buttonGrid_overview.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/buttonGrid_overview.md
@@ -28,4 +28,4 @@ Puede asignar la [acción estándar](https://doc.4d.com/4Dv17R5/4D/17-R5/Standar
## Propiedades soportadas
-[Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Fondo](properties_CoordinatesAndSizing.md#bottom) - [Clase](properties_Object.md#css-class) - [Columnas](properties_Crop.md#columns) - [Altura](properties_CoordinatesAndSizing.md#height) - [Mensaje de ayuda](properties_Help.md#help-tip) - [Dimensionamiento horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Nombre del objeto](properties_Object.md#object-name) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Filas](properties_Crop.md#rows) - [Acción estándar](properties_Action.md#standard-action) - [Superior](properties_CoordinatesAndSizing.md#top) - [Tipo](properties_Object.md#type) - [Variable o expresión](properties_Object.md#variable-o-expresión) - [Tamaño vertical](properties_ResizingOptions.md#vertical-sizing) - [Ancho](properties_CoordinatesAndSizing.md#width) - [Visibilidad](properties_Display.md#visibilidad)
+[Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Fondo](properties_CoordinatesAndSizing.md#bottom) - [Clase](properties_Object.md#css-class) - [Columnas](properties_Crop.md#columns) - [Altura](properties_CoordinatesAndSizing.md#height) - [Mensaje de ayuda](properties_Help.md#help-tip) - [Dimensionamiento horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Nombre del objeto](properties_Object.md#object-name) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Filas](properties_Crop.md#rows) - [Acción estándar](properties_Action.md#standard-action) - [Superior](properties_CoordinatesAndSizing.md#top) - [Tipo](properties_Object.md#type) - [Variable o expresión](properties_Object.md#variable-or-expression) - [Tamaño vertical](properties_ResizingOptions.md#vertical-sizing) - [Ancho](properties_CoordinatesAndSizing.md#width) - [Visibilidad](properties_Display.md#visibilidad)
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/listbox_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/listbox_overview.md
index d350dcb233df71..d8028bc891b45b 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/listbox_overview.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R6/FormObjects/listbox_overview.md
@@ -199,30 +199,30 @@ Las propiedades soportadas dependen del tipo de list box.
| Evento formulario | Propiedades adicionales devueltas (ver [Evento formulario](https://doc.4d.com/4Dv18/4D/18/FORM-Event.301-4522191.en.html) para las propiedades principales) | Comentarios |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| On After Edit | (por ejemplo, This.firstName + This.lastName)* | -| On Alternative Click |
(por ejemplo, This.firstName + This.lastName)* | -| On Alternative Click |
| | [](#remove)
| | [](#resize)
| -| [](#orderby)
| +| Ejemplo 2 | | [](#shift)
| | [](#slice)
| | [](#some)
| @@ -82,33 +81,27 @@ Una colección es inicializada con los comandos [`New collection`](../commands/n -| Parámetros | Tipo | | Descripción | -| ---------- | ------- | :-------------------------: | ------------------------------ | -| index | Integer | -> | Índice del elemento a devolver | -| Result | any | <- | El elemento en ese índice | +| Parámetros | Tipo | | Descripción | +| ---------- | ------- | :-------------------------: | ----------------------------------------------------------------------------------- | +| index | Integer | -> | Índice del elemento a devolver | +| Result | any | <- | Este ejemplo devuelve las personas contratadas hace más de 90 días: | #### Descripción -La función `.at()` devuelve el elemento en la posición *index*, permitiendo enteros positivos y negativos. +Igual a > Esta función no modifica la colección original. Los números enteros negativos cuentan hacia atrás desde el último elemento de la colección. -La función devuelve Undefined si el *index* sobrepasa los límites de la colección. +Igual a #### Ejemplo ```4d -var $col : Collection -$col:=New collection(10; 20; 30; 40; 50) -$element:=$col.at(0) // 10 -$element:=$col.at(1) // 20 -$element:=$col.at(-1) // 50 -$element:=$col.at(-2) // 40 -$element:=$col.at(10) // indefinido +Lanzamiento ``` @@ -129,26 +122,26 @@ $element:=$col.at(10) // indefinido -| Parámetros | Tipo | | Descripción | -| ------------ | --------------- | :-------------------------: | ----------------------------------------------------------------------------- | -| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real, Undefined | <- | Media aritmética (promedio) de los valores de la colección | +| Parámetros | Tipo | | Descripción | +| ------------ | --------------- | :-------------------------: | ---------------------------------------------------------------- | +| propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | +| Result | Real, Undefined | <- | donde: | #### Descripción -La función `.average()` devuelve la media aritmética (promedio) de los valores definidos en la instancia de la colección. +Diferente de Para el cálculo sólo se tienen en cuenta los elementos numéricos (se ignoran otros tipos de elementos). -Si la colección contiene objetos, pasa el parámetro *propertyPath* para indicar la propiedad del objeto a tener en cuenta. +Uso del paréntesis -`.average()` devuelve `undefined` si: +Number, Text, Date, Time, Boolean, Object, Collection, Picture, Pointer - la colección está vacía, - la colección no contiene elementos numéricos, -- *propertyPath* no se encuentra en la colección. +- Lanzamiento #### Ejemplo 1 @@ -187,15 +180,15 @@ Si la colección contiene objetos, pasa el parámetro *propertyPath* para indica -| Parámetros | Tipo | | Descripción | -| ---------- | ---------- | :-------------------------: | ----------------------------------------------------- | -| Result | Collection | <- | Colección original con todos los elementos eliminados | +| Parámetros | Tipo | | Descripción | +| ---------- | ---------- | :-------------------------: | ------------------------------------------- | +| Result | Collection | <- | Colección original sin elementos eliminados | #### Descripción -La función `.clear()` elimina todos los elementos de la instancia de la colección y devuelve una colección vacía. +Debe prestar atención a los siguientes aspectos de la conversión: > Esta función modifica la colección original. @@ -230,7 +223,7 @@ $vSize:=$col.length //$vSize=0 | ---------- | ---------- | :-------------------------: | ------------------------------------------------------------------------------------------------------------------------ | | col2 | Collection | -> | Colección a combinar | | index | Integer | -> | Posición a la que se deben combinar los elementos de inserción en la colección (por defecto=length+1) | -| Result | Collection | <- | Colección original que contiene elementos combinados | +| Result | Collection | <- | Colección original sin elementos eliminados | @@ -242,11 +235,11 @@ La función `.combine()` inserta eleme Por defecto, los elementos *col2* se añaden al final de la colección original. Puede pasar en *index* la posición donde desea insertar los elementos *col2* en la colección. -> **Atención**: recuerde que los elementos de la colección están numerados desde 0. +> Diferente de -- Si *index* > la longitud de la colección, el *index* inicial real será la longitud de la colección. -- Si *index* < 0, se recalcula como *index:=index+length* (se considera el desplazamiento desde el final de la colección). -- Si el valor calculado es negativo, *index* toma el valor 0. +- Ejemplo 1 +- Ejemplo 3 +- En caso de incoherencia, se aplican las siguientes reglas: #### Ejemplo @@ -275,20 +268,20 @@ $c.combine($fruits;3) //[1,2,3,"Orange","Banana","Apple","Grape",4,5,6] -| Parámetros | Tipo | | Descripción | -| ---------- | -------------------------------------------------------------- | :-------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------- | -| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos los elementos de la colección se añaden a la colección original | -| Result | Collection | <- | Nueva colección con valor(es) añadido(s) a la colección original | +| Parámetros | Tipo | | Descripción | +| ---------- | -------------------------------------------------------------- | :-------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------- | +| value | Number, Text, Object, Collection, Date, Time, Boolean, Picture | -> | Valores a concatenar. Si *value* es una colección, todos sus elementos se añaden al final de la colección original. | +| Result | Collection | <- | Colección original con valores rellenados | #### Descripción -La función.`.concat()` devuelve una nueva colección que contiene los elementos de la colección original con todos los elementos del parámetro *value* añadidos al final. +Colección compartida que se agrupa con la colección resultante > Esta función no modifica la colección original. -Si *value* es una colección, todos sus elementos se añaden al final de la colección original. Si *value* no es una colección, se añade ella misma como un nuevo elemento. +La colección devuelta contiene el elemento especificado por *startFrom* y todos los elementos subsiguientes hasta, pero sin incluir, el elemento especificado por *end*. Si sólo se especifica el parámetro *startFrom*, la colección devuelta contiene todos los elementos desde *startFrom* hasta el último elemento de la colección original. #### Ejemplo @@ -320,29 +313,29 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] -| Parámetros | Tipo | | Descripción | -| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------------------------------------------------------------------------------------- | -| option | Integer | -> | `ck resolve pointers`: resolver punteros antes de copiar,
`ck shared`: devolver una colección compartida | -| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | -| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | -| Result | Collection | <- | Copia profunda de la colección original | +| Parámetros | Tipo | | Descripción | +| ------------ | ---------- | :-------------------------: | -------------------------------------------------------------- | +| option | Integer | -> | Ejemplo 3 | +| groupWithCol | Collection | -> | Colección compartida que se agrupa con la colección resultante | +| groupWithObj | Object | -> | Objeto compartido que se agrupa con la colección resultante | +| Result | Collection | <- | Colección original ordenada | #### Descripción -La función `.copy()` devuelve una copia profunda de la instancia de la colección.***Deep copy*** significa que los objetos o colecciones dentro de la colección original se duplican y no comparten ninguna referencia con la colección devuelta. +Uso de marcadores de posición > Esta función no modifica la colección original. -Si se pasa, el parámetro *option* puede contener una de las siguientes constantes (o ambas): +Lanzamiento | option | Descripción | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Sin embargo, puede resolver los punteros al copiar pasando la constante `ck resolve pointers`. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | +| `ck resolve pointers` | Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. Si la colección original contiene valores de tipo puntero, por defecto la copia también contiene los punteros. En este caso, cada puntero presente en la colección se evalúa al copiar y se utiliza su valor desreferenciado. | | `ck shared` | Por defecto, `copy()` devuelve una colección Clásica (no compartida), incluso si el comando se aplica a una colección compartida. Pasa la constante `ck shared` para crear una colección compartida. En este caso, puede utilizar el parámetro *groupWith* para asociar la colección compartida con otra colección u objeto (ver más adelante). | -Los parámetros *groupWithCol* o *groupWithObj* permiten designar una colección o un objeto al que se debe asociar la colección resultante. +Ejemplo 2 :::note @@ -374,7 +367,7 @@ End use #### Ejemplo 2 -Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Por lo tanto, debemos hacer una copia compartida de *$sharedColl1* y designar *$sharedColl2* como grupo compartido para la copia. +Queremos combinar *$sharedColl1* y *$sharedColl2*. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. Dado que pertenecen a diferentes grupos compartidos, una combinación directa daría lugar a un error. ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection @@ -409,24 +402,10 @@ End use #### Ejemplo 4 -Este ejemplo ilustra el uso de la opción `ck resolve pointers`: +Primer elemento de la colección ```4d - var $col : Collection - var $p : Pointer - $p:=->$what - - $col:=New collection - $col.push(New object("alpha";"Hello";"num";1)) - $col.push(New object("beta";"You";"what";$p)) - - $col2:=$col.copy() - $col2[1].beta:="World!" - ALERT($col[0].alpha+" "+$col2[1].beta) //muestra "Hello World!" - - $what:="You!" - $col3:=$col2.copy(ck resolve pointers) - ALERT($col3[0].alpha+" "+$col3[1].what) //muestra "Hello You!" +Mayor que ``` @@ -450,13 +429,13 @@ Este ejemplo ilustra el uso de la opción `ck resolve pointers`: | Parámetros | Tipo | | Descripción | | ------------ | ---- | :-------------------------: | ---------------------------------------------------------------- | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de elementos en la colección | +| Result | Real | <- | Colección que contiene los elementos añadidos | #### Descripción -La función `.count()` devuelve el número de elementos no nulos en la colección. +Colección original sin elementos eliminados Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En este caso, sólo se tienen en cuenta los elementos que contienen el *propertyPath*. @@ -497,22 +476,22 @@ Si la colección contiene objetos, puede pasar el parámetro *propertyPath*. En | ------------ | ----------------------------------------------- | :-------------------------: | ---------------------------------------------------------------- | | value | Text, Number, Boolean, Date, Object, Collection | -> | Valor a contar | | propertyPath | Text | -> | Ruta de la propiedad del objeto que se utilizará para el cálculo | -| Result | Real | <- | Número de ocurrencias del valor | +| Result | Real | <- | Valor a contar | #### Descripción -La función `.countValues()` devuelve el número de veces que se encuentra el valor en la colección. +Mayor o igual que -Puede pasar en *value*: +Colección original ordenada - un valor escalar (texto, número, booleano, fecha), - una referencia de objeto o de colección. -Para encontrar un elemento, el tipo de *value* debe ser equivalente al tipo del elemento; el método utiliza el operador de igualdad. +Tipo -El parámetro opcional *propertyPath* permite contar valores dentro de una colección de objetos: pase en *propertyPath* la ruta de la propiedad cuyos valores quiere contar. +Resumen > Esta función no modifica la colección original. @@ -559,10 +538,10 @@ El parámetro opcional *propertyPath* permite contar valores dentro de una colec
Historia
-| Lanzamiento | Modificaciones | -| ----------- | ---------------------------- | -| 20 | Soporte de `ck count values` | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| 20 | Si se intenta eliminar un elemento de una colección vacía, el método no hace nada (no se genera ningún error). | +| v16 R6 | Añadidos |Historia
-| Lanzamiento | Modificaciones | -| ----------- | --------------------------------------------------------------------- | -| 20 R6 | Soporte de consultas utilizando las referencias de objeto o colección | -| 17 R5 | Soporte de querySettings | -| v16 R6 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------ | +| 20 R6 | Ejemplo 1 | +| 17 R5 | Soporte de querySettings | +| v16 R6 | Añadidos || Tipo de objeto | Descripción |
|---|---|
| Cadena | Ruta de acceso del atributo expresado utilizando la notación de punto, por ejemplo, "name" o "user.address.zipCode" |
| Colección de cadenas | Cada cadena de la colección representa un nivel de attributePath, por ejemplo, \["name"] o \["user","address","zipCode"]. El uso de una colección permite realizar consultas sobre atributos con nombres que no se ajustan a la notación de puntos, por ejemplo, \["4Dv17.1", "en/fr"] |
.sum() devuelve 0 si la entity selection está vacía.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FileHandleClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FileHandleClass.md
index 85f7fc68f1333b..eebc9e51518288 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FileHandleClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FileHandleClass.md
@@ -275,7 +275,7 @@ Esta propiedad es **lectura-escritura**.
:::caution
-Cuando se crea un file handle, el valor `.offset` es un número de bytes. Sin embargo, la unidad de medida del offset difiere según la función de lectura: con [`readBlob()`](#readblob), `.offset` es un número de bytes, mientras que con [`readText()`](#readtext)/[`readLine()`](#readline) es un número de caracteres. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Por lo tanto, si comienza a leer con `readBlob()` y luego llama a `readText()`, la lectura de texto comenzará en una posición inconsistente. Por ejemplo:
+Cuando se crea un file handle, el valor `.offset` es un número de bytes. Sin embargo, la unidad de medida del offset difiere según la función de lectura: con [`readBlob()`](#readblob), `.offset` es un número de bytes, mientras que con [`readText()`](#readtext)/[`readLine()`](#readline) es un número de caracteres. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Según el conjunto de caracteres del archivo, un caracter corresponde a uno o varios bytes. Por ejemplo:
```4d
// Abrir un fichero de texto europeo con codificación utf-16 (dos bytes por caracter)
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FolderClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FolderClass.md
index 7e18727a9a1cf7..6c779f042edc9b 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FolderClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/FolderClass.md
@@ -3,7 +3,7 @@ id: FolderClass
title: Folder
---
-`Folder` objects are created with the [`Folder`](../commands/folder.md) command. Contienen referencias a carpetas que pueden o no existir realmente en el disco. Por ejemplo, cuando ejecuta el comando `Folder` para crear una nueva carpeta, se crea un objeto `Folder` válido, pero en realidad no se almacena nada en el disco hasta que llame a la función [`folder.create()`](#create).
+Los objetos `Folder` son creados con el comando [`Folder`](../commands/folder.md). Contienen referencias a carpetas que pueden o no existir realmente en el disco. Por ejemplo, cuando ejecuta el comando `Folder` para crear una nueva carpeta, se crea un objeto `Folder` válido, pero en realidad no se almacena nada en el disco hasta que llame a la función [`folder.create()`](#create).
### Ejemplo
@@ -67,9 +67,9 @@ Los objetos `Folder` admiten varios nombres de ruta, incluida la sintaxis `files
#### Descripción
-La función `4D.Folder.new()` crea y devuelve un nuevo objeto del tipo `4D.Folder`. It is identical to the [`Folder`](../commands/folder.md) command (shortcut).
+La función `4D.Folder.new()` crea y devuelve un nuevo objeto del tipo `4D.Folder`. Es idéntico al comando [`Folder`](../commands/folder.md) (atajo).
-> It is recommended to use the [`Folder`](../commands/folder.md) shortcut command instead of `4D.Folder.new()`.
+> Se recomienda utilizar el comando de acceso directo [`Folder`](../commands/folder.md) en lugar de `4D.Folder.new()`.
@@ -297,7 +297,7 @@ La función `.moveTo( )` mueve o renom
La *destinationFolder* debe existir en el disco, de lo contrario se genera un error.
-Por defecto, la carpeta conserva su nombre cuando se mueve. Si desea cambiar renombrar la carpeta desplazada, pase el nombre completo en el parámetro *newName*. El nuevo nombre debe cumplir con las reglas de nomenclatura (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.
+Por defecto, la carpeta conserva su nombre cuando se mueve. Por defecto, la carpeta conserva su nombre cuando se mueve. El nuevo nombre debe cumplir con las reglas de nomenclatura (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.
**Objeto devuelto**
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md
index bcb16c4790ee56..45c4a9150b41cc 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md
@@ -478,7 +478,7 @@ La propiedad `.url` contiene la URL de
## .wait()
-**.wait**( { *time* : Real } ) : HTTPRequestClass
+**.wait**( { *time* : Real } ) : 4D.HTTPRequest
@@ -499,6 +499,6 @@ Si se pasa un parámetro *time*, la función esperará como máximo el número d
Si la respuesta del servidor ya ha llegado, la función regresa inmediatamente.
-During a `.wait()` execution, callback functions are executed, whether from other `HTTPRequest` or [`SystemWorker`](SystemWorkerClass.md) instances, or other [`CALL WORKER`](../commands-legacy/call-worker.md) calls. Puede salir de un `.wait()` llamando a [`terminate()`](#terminate) desde un callback.
+Durante una ejecución `.wait()`, las funciones de retrollamada se ejecutan, ya sea desde otras instancias `HTTPRequest` o [`SystemWorker`](SystemWorkerClass.md) u otras llamadas [`CALL WORKER`](../commands-legacy/call-worker.md). Puede salir de un `.wait()` llamando a [`terminate()`](#terminate) desde un callback.
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/IMAPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/IMAPTransporterClass.md
index d348fb30b466ef..24a4cbcd7f27af 100644
--- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/IMAPTransporterClass.md
+++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/API/IMAPTransporterClass.md
@@ -7,7 +7,7 @@ La clase `IMAPTransporter` le permite recuperar mensajes de un servidor de corre
### Objeto IMAP Transporter
-IMAP Transporter objects are instantiated with the [IMAP New transporter](../commands/imap-new-transporter.md) command. Ofrecen las siguientes propiedades y funciones:
+Los objetos IMAP Transporter se instancian con el comando [IMAP New transporter](../commands/imap-new-transporter.md). Ofrecen las siguientes propiedades y funciones:
| |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -57,7 +57,7 @@ IMAP Transporter objects are instantiated with the [IMAP New transporter](../com
#### Descripción
-La función `4D.IMAPTransporter.new()` crea y devuelve un nuevo objeto de tipo `4D.IMAPTransporter`. It is identical to the [`IMAP New transporter`](../commands/imap-new-transporter.md) command (shortcut).
+La función `4D.IMAPTransporter.new()` crea y devuelve un nuevo objeto de tipo `4D.IMAPTransporter`. Es idéntico al comando [`IMAP New transporter`](../commands/imap-new-transporter.md) (acceso directo).
@@ -794,7 +794,7 @@ Cada objeto de la colección devuelta contiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
| ------------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \[].name | Text | Nombre del buzón. Devuelto si withBoxProperties=true o withBoxInfo=true |
-| \[].selectable | Boolean | Indicates whether or not the access rights allow the mailbox to be selected: - true - the mailbox can be selected
- false - the mailbox can not be selected
- true - el buzón puede ser seleccionado
- false - el buzón de correo no puede ser seleccionado
- true - se puede crear un nivel inferior
- false - no se puede crear un nivel inferior
- true - El buzón ha sido marcado como "interesante" por el servidor. Por ejemplo, puede contener nuevos mensajes.
- false - El buzón no ha sido marcado como "interesante" por el servidor.
[Session Singletons](https://blog.4d.com/introducing-session-singletons) (blog post). +[Singletons en 4D](https://blog.4d.com/singletons-in-4d) (post del blog)
[Singletons de sesión](https://blog.4d.com/introducing-session-singletons) (post del blog). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_collection.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_collection.md index e70edc51b89a84..1b8f0fc8bad7a0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_collection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_collection.md @@ -46,18 +46,18 @@ Las colecciones deben haber sido instanciadas, de lo contrario intentar leer o m La instanciación de la colección puede realizarse de una de las siguientes maneras: -- using the [`New collection`](../commands/new-collection.md) command, +- usando el comando [`New collection`](../commands/new-collection.md) - utilizando el operador `[]`. :::info -Several 4D commands and functions return collections, for example [`Monitored activity`](../commands-legacy/monitored-activity.md) or [`collection.copy`](../API/CollectionClass.md#copy). En este caso, no es necesario instanciar explícitamente la colección, el lenguaje 4D lo hace por usted. +Varios comandos y funciones 4D devuelven colecciones, por ejemplo [`Monitored activity`](../commands-legacy/monitored-activity.md) o [`collection.copy`](../API/CollectionClass.md#copy). En este caso, no es necesario instanciar explícitamente la colección, el lenguaje 4D lo hace por usted. ::: ### Comando `New collection` -The [`New collection`](../commands/new-collection.md) command creates a new empty or prefilled collection and returns its reference. +El comando [`New collection`](../commands/new-collection.md) crea una nueva colección vacía o prellenada y devuelve su referencia. Ejemplos: @@ -105,8 +105,8 @@ Si crea un literal de colección que contenga un único elemento, asegúrese de Puede crear dos tipos de colecciones: -- regular (non-shared) collections, using the [`New collection`](commands/new-collection.md) command or collection literal syntax (`[]`). Estas colecciones pueden ser editadas sin ningún control de acceso específico, pero no pueden ser compartidas entre procesos. -- shared collections, using the [`New shared collection`](commands/new-shared-collection.md) command. Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. El acceso a estas colecciones se controla mediante estructuras [`Use...End use`](Concepts/shared.md#useend-use). +- las colecciones estándar (no compartidas), utilizando el comando [`New collection`](commands/new-collection.md) o la sintaxis literal de la colección (`[]`). Estas colecciones pueden ser editadas sin ningún control de acceso específico, pero no pueden ser compartidas entre procesos. +- las colecciones compartidas, utilizando el comando [`New shared collection`](commands/new-shared-collection.md). Estas colecciones pueden ser compartidas entre procesos, incluidos los hilos apropiativos. El acceso a estas colecciones se controla mediante estructuras [`Use...End use`](Concepts/shared.md#useend-use). Para más información, consulte la sección [Objetos y colecciones compartidos](shared.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_object.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_object.md index 1b2c603b23be88..9ed0bcb4e34797 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/dt_object.md @@ -47,7 +47,7 @@ La instanciación de objetos puede realizarse de una de las siguientes maneras: :::info -Several 4D commands and functions return objects, for example [`Database measures`](https://doc.4d.com/4Dv19R7/4D/19-R7/database-measures.301-5945423.en.html) or [`File`](../commands/file.md). En este caso, no es necesario instanciar explícitamente el objeto, el lenguaje 4D lo hace por usted. +Varias funciones y comandos 4D devuelven objetos, por ejemplo [`Database measures`](https://doc.4d.com/4Dv19R7/4D/19-R7/database-tilizes.301-5945423.en.html) o [`File`](../commands/file.md). En este caso, no es necesario instanciar explícitamente el objeto, el lenguaje 4D lo hace por usted. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/parameters.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/parameters.md index 1812ffcc081881..16759fe6f945ab 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/parameters.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/parameters.md @@ -451,11 +451,11 @@ Cuando los parámetros opcionales son necesarios en sus métodos, también puede Cuando pasa un parámetro, 4D siempre evalúa la expresión del parámetro en el contexto del método que llama y define el **valor resultante** en las variables locales en la función de clase o la subrutina. Las variables/parámetros locales no son los campos, variables o expresiones reales pasados por el método que llama; sólo contienen los valores que se han pasado. Las variables/parámetros locales no son los campos, variables o expresiones reales pasados por el método que llama; sólo contienen los valores que se han pasado. Por ejemplo: ```4d - //Here is some code from the method MY_METHOD -DO_SOMETHING([People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY_METHOD +DO_SOMETHING([People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Name) - //Here is the code of the method DO_SOMETHING + //Aquí está el código del método DO_SOMETHING #DECLARE($param : Text) $param:=Uppercase($param) ALERT($param) @@ -468,11 +468,11 @@ Hay dos formas de hacer que el método `DO_SOMETHING` cambie el valor del campo: 1. En lugar de pasar el campo al método, se pasa un puntero al mismo, por lo que se escribiría: ```4d - //Here is some code from the method MY_METHOD -DO_SOMETHING(->[People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY_METHOD +DO_SOMETHING(->[People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Last Name) - //Here the code of the method DO_SOMETHING + //Aquí el código del método DO_SOMETHING #DECLARE($param : Text) $param->:=Uppercase($param->) ALERT($param->) @@ -483,11 +483,11 @@ Aquí el parámetro no es el campo, sino un puntero al mismo. Therefore, within 2. En lugar de que el método `DO_SOMETHING` "haga algo", puede reescribir el método para que devuelva un valor. Por lo tanto, escribiría: ```4d - //Here is some code from the method MY METHOD - [People]Name:=DO_SOMETHING([People]Name) //Let's say [People]Name value is "williams" + //Aquí hay un código del método MY METHOD + [People]Name:=DO_SOMETHING([People]Name) ///Digamos [People]El valor del nombre es "williams" ALERT([People]Name) - //Here the code of the method DO SOMETHING + //Aquí el código del método DO SOMETHING #DECLARE ($param : Text) -> ($result : Text) $result:=Uppercase($param) ALERT($result) @@ -499,7 +499,7 @@ This second technique of returning a value by a subroutine is called "using a fu Debe prestar atención al hecho de que los tipos de datos Objeto y Colección sólo pueden manejarse a través de una referencia (es decir, un *puntero* interno). -Consequently, when using such data types as parameters, `$param, $return...` do not contain *values* but *references*. Modifying the value of the `$param, $return...` parameters within the subroutine will be propagated wherever the source object or collection is used. This is the same principle as for [pointers](dt_pointer.md#pointers-as-parameters-to-methods), except that `$param, $return...` parameters do not need to be dereferenced in the subroutine. +Consequently, when using such data types as parameters, `$param, $return...` do not contain *values* but *references*. Modifying the value of the `$param, $return...` parameters within the subroutine will be propagated wherever the source object or collection is used. Este es el mismo principio que para [los punteros](dt_pointer.md#pointers-as-parameters-to-methods), excepto que los parámetros `$param, $return...` no necesitan ser desreferenciados en la subrutina. Por ejemplo, considere el método `CreatePerson` que crea un objeto y lo envía como parámetro: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/paths.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/paths.md index fe9ec5a6e30ef0..1e648fd247850a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/paths.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/paths.md @@ -41,7 +41,7 @@ Con esta sintaxis: - los nombres de ruta absolutos empiezan por "/" - para subir una carpeta en una ruta relativa, utilice "../" delante del nombre de la ruta (por seguridad, no puede subir en el sistema de archivos). -In POSIX syntax, you will generally use `filesystem` pathnames with [`File`](../commands/file.md) and [`Folder`](../commands/folder.md) commands, for example: +En la sintaxis POSIX, generalmente usará los nombres de ruta `filesystem` con comandos [`File`](../commands/file.md) y [`Folder`](../commands/folder.md), por ejemplo: ```4d var $pathFile : 4D.File @@ -62,7 +62,7 @@ Se soportan los siguientes modelos: - el texto contiene ":" y "\" como segundo y tercer caracter, - el texto comienza con "\\". -Examples with [`Folder`](../commands/folder.md): +Ejemplos con [`Folder`](../commands/folder.md): ```4d $ok:=Folder("C:\\Monday";fk platform path).create() @@ -82,7 +82,7 @@ Se soportan los siguientes modelos (sintaxis HFS+): - los separadores de carpetas son ":" - la ruta no debe comenzar con un ":" -Examples with [`Folder`](../commands/folder.md): +Ejemplos con [`Folder`](../commands/folder.md): ```4d $ok:=Folder("macintosh hd:";fk platform path).create() @@ -93,7 +93,7 @@ $ok:=Folder("Monday:Tuesday";fk platform path).create() //un volume debe llamars ### Constructores `File` y `Folder` -[`File`](../commands/file.md) and [`Folder`](../commands/folder.md) commands only accept **absolute pathnames**. Las rutas relativas no están soportadas y devolverán errores. Por ejemplo, el siguiente código no es permitido: +Los comandos [`File`](../commands/file.md) y [`Folder`](../commands/folder.md) sólo aceptan **rutas absolutas**. Las rutas relativas no están soportadas y devolverán errores. Por ejemplo, el siguiente código no es permitido: ```4d //ERROR diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/shared.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/shared.md index b327cd1de415eb..5759e617be2374 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/shared.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/shared.md @@ -8,7 +8,7 @@ title: Objetos y colecciones compartidos Los objetos compartidos y las colecciones compartidas se almacenan en variables estándar [`Object`](dt_object.md) y [`Collection`](dt_collection.md), pero deben instanciarse utilizando comandos específicos: - para crear un objeto compartido, utilice el comando [`New shared object`](https://doc.4d.com/4dv20/help/command/en/page1471.html) o llama a la función [`new()`](../API/ClassClass.md#new) de una [clase compartida](classes.md#clases-compartidas), -- to create a shared collection, use the [`New shared collection`](../commands/new-shared-collection.md) command. +- para crear una colección compartida, utilice el comando [`New shared collection`](../commands/new-shared-collection.md). Los objetos y colecciones compartidas solo pueden contener valores escalares u otros objetos y colecciones compartidas. Sin embargo, los objetos y colecciones compartidos pueden establecerse como propiedades de objetos o colecciones estándar (no compartidos). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/variables.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/variables.md index e1281fb30817b7..9669c121cf54d4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/variables.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Concepts/variables.md @@ -49,7 +49,7 @@ var $myVar //una variable variant ``` `varName` es el nombre de la variable, debe cumplir con las [reglas 4D](Concepts/identifiers.md) sobre identificadores. -This syntax only supports [local and process variables](#local-process-and-interprocess-variables) declarations, thus excluding [interprocess variables](#interprocess-variables) (deprecated) and [arrays](Concepts/arrays.md). +Esta sintaxis solo soporta declaraciones de [variables locales y de proceso](#local-process-and-interprocess-variables), por lo que excluye [variables interproceso](#interprocess-variables) (obsoleto) y [arrays](Concepts/arrays.md). `varType` puede ser: @@ -163,7 +163,7 @@ var $a; $b : Integer:=15 //error ## Asignar los valores -Los datos pueden introducirse y copiarse en variables y arrays. Poner datos en una variable se llama **asignar los datos a la variable** y se hace con el operador de asignación (:=). El operador de asignación también se utiliza para asignar datos a campos. +Los datos pueden introducirse y copiarse en variables y arrays. Los datos pueden introducirse y copiarse en variables y arrays. El operador de asignación también se utiliza para asignar datos a campos. El operador de asignación es un primer medio para crear una variable e introducir datos en ella. Se escribe el nombre de la variable que se quiere crear a la izquierda del operador de asignación. Por ejemplo: @@ -201,7 +201,7 @@ El nombre de una variable local siempre comienza por el signo dólar ($) y puede Cuando se trabaja en un proyecto de aplicación con muchos métodos y variables, a menudo se encuentra que se necesita utilizar una variable sólo dentro del método en el que se está trabajando. Puede crear y utilizar una variable local en el método sin preocuparse de si ha utilizado el mismo nombre de variable en otro lugar. -Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. El comando `Request` puede obtener esta información. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo: +Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Con frecuencia, en una aplicación, se necesitan pequeñas piezas de información del usuario. Muestra una caja de diálogo con un mensaje que solicita al usuario una respuesta. Cuando el usuario introduce la respuesta, el comando devuelve la información que el usuario introdujo. Generalmente no es necesario mantener esta información en sus métodos durante mucho tiempo. Esta es una forma típica de utilizar una variable local. Aquí un ejemplo: ```4d $vsID:=Request("Please enter your ID:") diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md index bd479a69eef688..27f0d1d6345754 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugger.md @@ -36,7 +36,7 @@ La ventana del depurador suele aparecer en la máquina donde se ejecuta el códi :::note Notas - Si el servidor se ejecuta en modo sin interfaz, no se puede mostrar ninguna ventana de depuración en el servidor, es necesario utilizar el depurador remoto. Ver [Depuración desde máquinas remotas](./debugging-remote.md). -- You can also [attach the Qodly Studio debugger to a 4D Server application](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) if you need to debug Qodly pages in a deployed environment. +- También puede [adjuntar el depurador de Qodly Studio a una aplicación 4D Server](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) si necesita depurar páginas Qodly en un entorno desplegado. ::: @@ -282,7 +282,7 @@ Para mostrar el tipo de parámetro, marque la opción **Mostrar tipos** en el me Después de desplegar la lista de parámetros, puede arrastrar y soltar los parámetros y los resultados de las funciones en el [Custom Watch Pane](#custom-watch-pane). -You can also use the [Call chain](https://doc.4d.com/4dv19/help/command/en/page1662.html) command to retrieve the call chain programmatically. +También puede utilizar el comando [Call chain](https://doc.4d.com/4dv19/help/command/en/page1662.html) para recuperar la cadena de llamadas por programación. ## Panel de vigilancia personalizado diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md index 3a2985f25d366b..484587e09605c9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Debugging/debugging-remote.md @@ -19,7 +19,7 @@ Sólo un depurador puede depurar una aplicación 4D Server en un momento dado. S - el depurador local de 4D Server (por defecto) - si el servidor no está ejecutando sin interfaz. - el depurador de un cliente 4D remoto - si la sesión remota tiene acceso al modo Diseño. -- the [Qodly debugger](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) on 4D Server - if the server allows access to Qodly Studio. +- el [depurador Qodly](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) en el servidor 4D - si el servidor permite el acceso a Qodly Studio. El depurador asociado es llamado cada vez que se encuentra un 4D Server: @@ -73,7 +73,7 @@ Para volver a conectar el depurador al servidor: > **Advertencia**: si se selecciona esta opción para un servidor que posteriormente se lanza en modo sin interfaz, el depurador no estará disponible para este servidor. -- En un cliente 4D remoto, esta opción se llama **Attach Remote Debugger At Startup**. Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Si el adjunto es aceptado (ver [Rejected attachment requests](#rejected-attachment-requests)), el depurador remoto se adjunta automáticamente al cliente 4D remoto y se muestra la opción **Detach Remote Debugger**. +- Asociar al depurador Cuando se selecciona, el cliente 4D remoto intentará automáticamente adjuntar el depurador remoto en cada conexión posterior a la misma base de datos 4D Server. Depuradores adjuntos > Esta configuración se aplica por proyecto y se almacena localmente en el archivo [`.4DPreferences`](Project/architecture.md#userpreferencesusername). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Desktop/clientServer.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Desktop/clientServer.md index 48efc82852c4a7..b7558fdffcd32f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Desktop/clientServer.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Desktop/clientServer.md @@ -87,7 +87,7 @@ Sin embargo, debe prestar atención a las siguientes diferencias de comportamien ## Sesiones de usuarios remotos -On the server, the [`Session`](../commands/session.md) command returns a `session` object describing the current user session. Este objeto se maneja a través de las funciones y propiedades de la [clase `Session`](../API/SessionClass.md). +En el servidor, el comando [`Session`](../commands/session.md) devuelve un objeto `session` que describe la sesión de usuario actual. Este objeto se maneja a través de las funciones y propiedades de la [clase `Session`](../API/SessionClass.md). ### Utilización diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Events/onDragOver.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Events/onDragOver.md index 186b06228e6483..d8e70bab387a6e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Events/onDragOver.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/Events/onDragOver.md @@ -29,10 +29,10 @@ El código que maneja un evento `On Drag Over` debe ser corto y ejecutarse rápi ### Ejemplo ```4d -//Destination object method +/Método del objeto destino #DECLARE : Integer If(Form event code=On Drag Over) - //returns 0 by default + //devuelve 0 por defecto ... If($DataType=Is picture) return -1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/buttonGrid_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/buttonGrid_overview.md index 1fa894fa42ca83..42f6225816a18c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/buttonGrid_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/buttonGrid_overview.md @@ -28,4 +28,4 @@ Puede asignar la [acción estándar](https://doc.4d.com/4Dv17R5/4D/17-R5/Standar ## Propiedades soportadas -[Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Fondo](properties_CoordinatesAndSizing.md#bottom) - [Clase](properties_Object.md#css-class) - [Columnas](properties_Crop.md#columns) - [Altura](properties_CoordinatesAndSizing.md#height) - [Mensaje de ayuda](properties_Help.md#help-tip) - [Dimensionamiento horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Nombre del objeto](properties_Object.md#object-name) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Filas](properties_Crop.md#rows) - [Acción estándar](properties_Action.md#standard-action) - [Superior](properties_CoordinatesAndSizing.md#top) - [Tipo](properties_Object.md#type) - [Variable o expresión](properties_Object.md#variable-o-expresión) - [Tamaño vertical](properties_ResizingOptions.md#vertical-sizing) - [Ancho](properties_CoordinatesAndSizing.md#width) - [Visibilidad](properties_Display.md#visibilidad) +[Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Fondo](properties_CoordinatesAndSizing.md#bottom) - [Clase](properties_Object.md#css-class) - [Columnas](properties_Crop.md#columns) - [Altura](properties_CoordinatesAndSizing.md#height) - [Mensaje de ayuda](properties_Help.md#help-tip) - [Dimensionamiento horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Nombre del objeto](properties_Object.md#object-name) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Filas](properties_Crop.md#rows) - [Acción estándar](properties_Action.md#standard-action) - [Superior](properties_CoordinatesAndSizing.md#top) - [Tipo](properties_Object.md#type) - [Variable o expresión](properties_Object.md#variable-or-expression) - [Tamaño vertical](properties_ResizingOptions.md#vertical-sizing) - [Ancho](properties_CoordinatesAndSizing.md#width) - [Visibilidad](properties_Display.md#visibilidad) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/listbox_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/listbox_overview.md index 042c8b95d543bd..8fc835fcf2e1fb 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/listbox_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/FormObjects/listbox_overview.md @@ -199,30 +199,30 @@ Las propiedades soportadas dependen del tipo de list box. | Evento formulario | Propiedades adicionales devueltas (ver [Evento formulario](https://doc.4d.com/4Dv18/4D/18/FORM-Event.301-4522191.en.html) para las propiedades principales) | Comentarios | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| On After Edit |
(por ejemplo, This.firstName + This.lastName)* | -| On Alternative Click |
(por ejemplo, This.firstName + This.lastName)* | -| On Alternative Click |
*4D Server only*: Qodly Studio code editor (see (2)) | Editor de código Qodly Studio | -| Debugger | 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 | +| | Qodly Studio en 4D | Qodly Studio in Qodly Cloud platform | +| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| Ver y editar tablas (clases de datos), atributos y relaciones | Editor de estructura 4D(1) | Qodly Studio Model Editor | +| Páginas Qodly | Editor de páginas Qodly Studio | Editor de páginas Qodly Studio | +| Formularios de escritorio | 4D IDE | *not supported* | +| Lenguaje de programación | Lenguaje 4D con ORDA | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) con ORDA | +| IDE de código | 4D IDE code editor *or* VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2)) | Editor de código Qodly Studio | +| Debugger | 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 | (1) If you click on the **Model** button in Qodly Studio, nothing happens.
(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)). (1) The **Model** item is disabled in Qodly Studio.
@@ -218,13 +218,13 @@ https://www.myWebSite.com/$lib/renderer/?w=welcome You can preview your Qodly application at any moment by selecting the **Preview Qodly Application...** command in the **Windows** menu (4D Server) or in the **Design** menu (4D single-user). -This command launches the Qodly renderer on a local address in your default browser and displays the **start page** [defined in the Application settings](https://developer.qodly.com/docs/studio/settings#start-page) of Qodly Studio. +Este comando lanza el renderizador de Qodly en una dirección local en su navegador por defecto y muestra la **página de inicio** [definida en la Configuración de la aplicación](https://developer.qodly.com/docs/studio/settings#start-page) de Qodly Studio. ### Using Qodly debugger on 4D Server When using Qodly pages in a deployed 4D Server application (interpreted mode), you might encounter some cases where you need to debug your pages on the server, for example when a specific user configuration is required. In this case, you can attach the [Qodly Studio debugger](https://developer.qodly.com/docs/studio/debugging) to the 4D Server and then, benefit from its features when executing your Qodly pages. -Note that in this case, the Qodly Studio debugger will display all the code executed on the server, in accordance with the [attached debugger rule on 4D Server](../Debugging/debugging-remote.md#attached-debugger). +Tenga en cuenta que en este caso, el depurador Qodly Studio mostrará todo el código ejecutado en el servidor, de acuerdo con la [regla del depurador adjunta en el servidor 4D](. /Debugging/debugging-remote.md#attached-debugger). Para adjuntar el depurador Qodly Studio a su aplicación 4D Server en ejecución: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WebServer/sessions.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WebServer/sessions.md index 05e9a459bc4b45..d52e835495215d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WebServer/sessions.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WebServer/sessions.md @@ -38,7 +38,7 @@ En cualquier caso, la configuración es local para la máquina; por lo que puede ## Implementación de la sesión -Cuando [se habilitan las sesiones](#enabling-sessions), se implementan mecanismos automáticos, basados en una cookie privada establecida por el propio 4D: "4DSID_*AppName*", donde *AppName* es el nombre del proyecto de la aplicación. Esta cookie hace referencia a la sesión web actual de la aplicación. +Cuando [se habilitan las sesiones](#enabling-sessions), se implementan mecanismos automáticos, basados en una cookie privada establecida por el propio 4D: "4DSID__AppName_", donde *AppName* es el nombre del proyecto de la aplicación. Esta cookie hace referencia a la sesión web actual de la aplicación. :::info @@ -46,13 +46,13 @@ El nombre de la cookie se puede obtener utilizando la propiedad [`.sessionCookie ::: -1. En cada petición del cliente web, el servidor web comprueba la presencia y el valor de la cookie privada "4DSID_*AppName*". +1. En cada petición del cliente web, el servidor web comprueba la presencia y el valor de la cookie privada "4DSID__AppName_". 2. Si la cookie tiene un valor, 4D busca la sesión que creó esta cookie entre las sesiones existentes; si se encuentra esta sesión, se reutiliza para la llamada. 3. Si la solicitud del cliente no corresponde a una sesión ya abierta: -- se crea una nueva sesión con una cookie privada "4DSID_*AppName*" en el servidor web +- se crea una nueva sesión con una cookie privada "4DSID__AppName_" en el servidor web - se crea un nuevo objeto Guest `Session` dedicado a la sesión web escalable. :::note @@ -84,7 +84,7 @@ Una sesión web escalable se cierra cuando: La vida útil de una cookie inactiva es de 60 minutos por defecto, lo que significa que el servidor web cerrará automáticamente las sesiones inactivas después de 60 minutos. -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. +Este tiempo de espera puede establecerse utilizando la propiedad [`.idleTimeout`](API/SessionClass.md#idletimeout) del objeto `Session` (el tiempo de espera no puede ser inferior a 60 minutos) o el parámetro *connectionInfo* del comando [`Open datastore`](../commands/open-datastore.md). When a web session is closed, if the [`Session`](commands/session.md) command is called afterwards: @@ -100,7 +100,7 @@ Puede cerrar una sesión desde un formulario Qodly utilizando la función [**log ## Privilegios -Los privilegios pueden asociarse a sesiones de usuario web. En el servidor web, puede proporcionar un acceso o unas funcionalidades específicas en función de los privilegios de la sesión. +Fecha de caducidad de la sesión En el servidor web, puede proporcionar un acceso o unas funcionalidades específicas en función de los privilegios de la sesión. Puedes asignar privilegios utilizando la función [`.setPrivileges()`](API/SessionClass.md#setprivileges). En su código, puede comprobar los privilegios de la sesión para permitir o denegar el acceso utilizando la función [`.hasPrivilege()`](API/SessionClass.md#hasprivilege). Por defecto, las sesiones nuevas no tienen ningún privilegio: son sesiones **Invitadas** (la función [`.isGuest()`](API/SessionClass.md#isguest) devuelve true). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/command-index.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/command-index.md index 427f8ba4e1eb49..cbedc6bf156515 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/command-index.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/command-index.md @@ -23,9 +23,9 @@ title: Comandos 4D Write Pro [`WP DELETE FOOTER`](../commands-legacy/wp-delete-footer.md)
[`WP DELETE HEADER`](../commands-legacy/wp-delete-header.md)
[`WP DELETE PICTURE`](../commands-legacy/wp-delete-picture.md)
-[`WP DELETE SECTION`](wp-delete-section.md) ***New 4D 20 R7***
+[`WP DELETE SECTION`](wp-delete-section.md) ***Nuevo 4D 20 R7***
[`WP DELETE STYLE SHEET`](../commands-legacy/wp-delete-style-sheet.md)
-[`WP DELETE SUBSECTION`](wp-delete-subsection.md) ***Modified 4D 20 R7***
+[`WP DELETE SUBSECTION`](wp-delete-subsection.md) ***Modificado 4D 20 R7***
[`WP DELETE TEXT BOX`](../commands-legacy/wp-delete-text-box.md) E @@ -93,7 +93,7 @@ title: Comandos 4D Write Pro R -[`WP RESET ATTRIBUTES`](wp-reset-attributes.md) ***Modified 4D 20 R7*** +[`WP RESET ATTRIBUTES`](wp-reset-attributes.md) ***Modificado 4D 20 R7*** S diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-delete-subsection.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-delete-subsection.md index 48c2e8c2b8f8a0..300673257f3ed8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-delete-subsection.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-delete-subsection.md @@ -51,9 +51,9 @@ You want to delete the first page subsection of the first section: ```4d var $section;$subsection : Object - // get first section + // obtener la primera sección $section:=WP Get section(wpDoc;1) - // Delete the subsection + // Eliminar la subsección WP DELETE SUBSECTION($section;wk first page) ``` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-reset-attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-reset-attributes.md index 978de19c1f2ed7..e95acc59fe69e5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-reset-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/WritePro/commands/wp-reset-attributes.md @@ -9,11 +9,11 @@ displayed_sidebar: docs -| Parámetros | Tipo | | Descripción | -| ------------------- | ------ | - | ------------------------------------------------- | -| targetObj | Object | → | Range or element or 4D Write Pro document | -| sectionOrSubsection | Object | → | Section or subsection of a 4D Write Pro document | -| attribName | Text | → | Name of attribute(s) to remove | +| Parámetros | Tipo | | Descripción | +| ------------------- | ------ | - | --------------------------------------------------- | +| targetObj | Object | → | Range or element or 4D Write Pro document | +| sectionOrSubsection | Object | → | Section or subsection of a 4D Write Pro document | +| attribName | Text | → | Nombre de atributo(s) a eliminar | @@ -24,7 +24,7 @@ The **WP RESET ATTRIBUTES** command builds and returns a new, [alterable](../ORDA/entities.md#shareable-or-alterable-entity-selections) entity selection related to the dataclass matching the given *dsTable*, according to the current selection of this table. -If the current selection is sorted, an [ordered](../ORDA/dsMapping.md#ordered-or-unordered-entity-selection) entity selection is created (the order of the current selection is kept). Si la selección actual no está ordenada, se crea una selección de entidades no ordenada. +Si la selección actual está ordenada, se crea una entity selection [ordenada](../ORDA/dsMapping.md#ordered-or-unordered-entity-selection) (se mantiene el orden de la selección actual). Si la selección actual no está ordenada, se crea una selección de entidades no ordenada. -If the *dsTable* is not exposed in [`ds`](ds.md), an error is returned. Este comando no puede utilizarse con un datastore remoto. +Si *dsTable* no está expuesto en [`ds`](ds.md), se devuelve un error. Este comando no puede utilizarse con un datastore remoto. En el parámetro opcional *settings*, puede pasar un objeto que contenga la siguiente propiedad: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/cs.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/cs.md index b9c46513ee3bfa..c044fa9741f644 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/cs.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/cs.md @@ -8,4 +8,4 @@ displayed_sidebar: docs | ---------- | ------ | - | ------------------------------------------------- | | classStore | Object | ← | Class store usuario para el proyecto o componente | -The **cs** keyword is described in the [**Concept page for Classes**](../Concepts/classes.md#cs). +La palabra clave **cs** se describe en la [**página Concepto para Clases**](../Concepts/classes.md#cs). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/folder.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/folder.md index 2fd64113249ed3..c9767b90052884 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/folder.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/folder.md @@ -29,7 +29,7 @@ displayed_sidebar: docs #### Descripción -El comando `Folder` crea y devuelve un nuevo objeto del tipo `4D.Folder`. El comando acepta dos sintaxis: +Comentario El comando acepta dos sintaxis: **Folder ( path { ; pathType } { ; \* } )** diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md index 9a5260850bf18c..964f68c76d5704 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md @@ -1,7 +1,6 @@ --- id: form-event-code title: Form event code -slug: /commands/form-event-code displayed_sidebar: docs --- @@ -102,10 +101,10 @@ This example is a template for a form method. It shows each of the possible even #### Ejemplo 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](../commands-legacy/display-selection.md) or [MODIFY SELECTION](../commands-legacy/modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. ```4d - //A form method + ////Método formulario Case of :(Form event code=On Load) $vsTheEvent:="The form is about to be displayed" @@ -141,7 +140,7 @@ This example shows the template of a form method that handles the events that ca #### Ejemplo 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. #### Ejemplo 6 @@ -342,11 +341,11 @@ As a result, the red rectangle follows the scrolling of the list box: #### Ver también [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md)\ -[Current form table](current-form-table.md)\ -[FILTER KEYSTROKE](filter-keystroke.md)\ +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md)\ +[Current form table](../commands-legacy/current-form-table.md)\ +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md)\ [FORM Event](form-event.md)\ -[Get edited text](get-edited-text.md)\ -[Keystroke](keystroke.md)\ -[POST OUTSIDE CALL](post-outside-call.md)\ -[SET TIMER](set-timer.md) +[Get edited text](../commands-legacy/get-edited-text.md)\ +[Keystroke](../commands-legacy/keystroke.md)\ +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md)\ +[SET TIMER](../commands-legacy/set-timer.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md index b48a1c75f55fbc..946403a1ad4dc0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md @@ -17,7 +17,7 @@ displayed_sidebar: docs #### Descripción -**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. Usually, you will use **FORM Event** from within a form or object method. +**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. Usually, you will use **FORM Event** from within a form or object method. **Objeto devuelto** @@ -99,4 +99,4 @@ The resulting list box when rows are selected: #### Ver también [Form Events](../Events/overview.md) -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/pop3-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/pop3-new-transporter.md index 1ad320b5d093b3..335da459df3f01 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/pop3-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/pop3-new-transporter.md @@ -29,21 +29,21 @@ The `POP3 New transporter` command ](../API/POP3TransporterClass.md#acceptunsecureconnection)
| False | -| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). Not returned in *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)* object. | ninguno | -| [](../API/POP3TransporterClass.md#authenticationmode)
| se utiliza el modo de autenticación más seguro soportado por el servidor | -| [](../API/POP3TransporterClass.md#connectiontimeout)
| 30 | -| [](../API/POP3TransporterClass.md#host)
| *obligatorio* | -| [](../API/POP3TransporterClass.md#logfile)
| ninguno | -| **.password** : Text
contraseña de usuario para la autenticación en el servidor. Not returned in *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)* object. | ninguno | -| [](../API/POP3TransporterClass.md#port)
| 995 | -| [](../API/POP3TransporterClass.md#user)
| ninguno | +| *server* | Valor por defecto (si se omite) | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ | +| [](../API/POP3TransporterClass.md#acceptunsecureconnection)
| False | +| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)*. | ninguno | +| [](../API/POP3TransporterClass.md#authenticationmode)
| se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](../API/POP3TransporterClass.md#connectiontimeout)
| 30 | +| [](../API/POP3TransporterClass.md#host)
| *obligatorio* | +| [](../API/POP3TransporterClass.md#logfile)
| ninguno | +| **.password** : Text
contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[SMTP transporter](../API/POP3TransporterClass.md#smtptransporterobject)*. | ninguno | +| [](../API/POP3TransporterClass.md#port)
| 995 | +| [](../API/POP3TransporterClass.md#user)
| ninguno | #### Result -The function returns a [**POP3 transporter object**](../API/POP3TransporterClass.md#pop3-transporter-object). Todas las propiedades devueltas son de sólo lectura\*\*. +La función devuelve un [**objeto POP3 transporter**](../API/POP3TransporterClass.md#pop3-transporter-object). Todas las propiedades devueltas son de sólo lectura\*\*. > La conexión POP3 se cierra automáticamente cuando se destruye el objeto transportador. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/smtp-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/smtp-new-transporter.md index 257e18ca09fea8..11213d2f5fe731 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/smtp-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/smtp-new-transporter.md @@ -11,7 +11,7 @@ displayed_sidebar: docs | Parámetros | Tipo | | Descripción | | ---------- | ---------------------------------- | - | --------------------------------------------------------------------------------- | | server | Object | → | Información del servidor de correo | -| Resultado | 4D.SMTPTransporter | ← | [SMTP transporter object](../API/SMTPTransporterClass.md#smtp-transporter-object) | +| Resultado | 4D.SMTPTransporter | ← | [Objeto SMTP transporter](../API/SMTPTransporterClass.md#smtp-transporter-object) | @@ -29,7 +29,7 @@ displayed_sidebar: docs The `SMTP New transporter` command configures a new SMTP connection according to the *server* parameter and returns a new [SMTP transporter object](../API/SMTPTransporterClass.md#smtp-transporter-object) object. El objeto transportador devuelto se utilizará normalmente para el envío de correos electrónicos. -> Este comando no abre ninguna conexión con el servidor SMTP. The SMTP connection is actually opened when the [`.send()`](../API/SMTPTransporterClass.md#send) function is executed. +> Este comando no abre ninguna conexión con el servidor SMTP. Este comando no abre ninguna conexión con el servidor SMTP. > > La conexión SMTP se cierra automáticamente: > diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/this.md b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/this.md index 87ea96fb715087..2795504a240e69 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/this.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20-R7/commands/this.md @@ -50,7 +50,7 @@ $val:=$o.a //42 En todos los casos, `This` se refiere al objeto sobre el que se ha llamado el método, como si el método fuera una función del objeto. ```4d -//Class: ob +//Clase: ob Function f() : Integer return This.a+This.b @@ -70,7 +70,7 @@ En este ejemplo, el objeto asignado a la variable $o no tiene su propia propieda #### Objeto fórmula -In the context of the execution of a formula object created by the [Formula](formula.md) or [Formula from string](formula-from-string.md) commands, `This` returns a reference to the object currently processed by the formula. +En el contexto de la ejecución de un objeto fórmula creado por los comandos [Formula](formula.md) o [Formula from string](formula-from-string.md), `This` devuelve una referencia al objeto actualmente procesado por la fórmula. For example, you want to use a project method as a formula encapsulated in an object: @@ -79,8 +79,8 @@ For example, you want to use a project method as a formula encapsulated in an ob $person.firstName:="John" $person.lastName:="Smith" $person.greeting:=Formula(Greeting) - $g:=$person.greeting("hello") // returns "hello John Smith" - $g:=$person.greeting("hi") // returns "hi John Smith" + $g:=$person.greeting("hello") // devuelve "hola John Smith" + $g:=$person.greeting("hi") // devuelve "hi John Smith" ``` With the *Greeting* project method: @@ -92,7 +92,7 @@ With the *Greeting* project method: #### List box -In the context of a list box associated to a collection or an entity selection, during the [`On Display Detail`](../Events/onDisplayDetail.md) or the [`On Data Change`](../Events/onDataChange.md) events, `This` returns a reference to the collection element or entity accessed by the list box to display the current row. +En el contexto de un list box asociado a una colección o una selección de entidades, durante los eventos [`On Display Detail`](../Events/onDisplayDetail.md) o [`On Data Change`](../Events/onDataChange.md), `This` devuelve una referencia al elemento de colección o entidad a la que accede el list box para mostrar la línea actual. :::note @@ -127,7 +127,7 @@ A collection of objects, each with this structure: ``` -In the list box, each column refers to one of the properties of the object, either directly (This.name), indirectly (This.employees.length), or through an expression (*getPicture*) in which can be used directly. The list box looks like: +En el list box, cada columna se refiere a una de las propiedades del objeto, ya sea directamente (This.name), indirectamente (This.employees.length), o a través de una expresión (*getPicture*) en la que se puede usar directamente. The list box looks like:  @@ -160,13 +160,13 @@ You build a list box of the "Collection or entity selection" type with the follo Note que: - *This.ID*, *This.Title* and *This.Date* directly refers to the corresponding attributes in the ds.Event dataclass. -- *This.meetings* is a related attribute (based upon the One To Many relation name) that returns an entity selection of the ds.Meeting dataclass. +- *This.meetings* es un atributo relacionado (basado en el nombre de una relación de Uno a Muchos) que devuelve una selección de entidad de la base de datos ds.Meeting. - **Form.eventList** is the entity selection that is attached to the list box. The initialization code can be put in the on load form event: ```4d Case of :(Form event code=On Load) - Form.eventList:=ds.Event.all() //returns an entity selection with all entities + Form.eventList:=ds.Event.all() //devuelve una selección de entidad con todas las entidades End case ``` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md index f973a227b3eb7b..daa719fab2ffcc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md @@ -268,13 +268,7 @@ La función devuelve Undefined si el *index* sobrepasa los límites de la colecc #### Ejemplo ```4d -var $col : Collection -$col:=New collection(10; 20; 30; 40; 50) -$element:=$col.at(0) // 10 -$element:=$col.at(1) // 20 -$element:=$col.at(-1) // 50 -$element:=$col.at(-2) // 40 -$element:=$col.at(10) // indefinido +Lanzamiento ``` diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/CryptoKeyClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/CryptoKeyClass.md index 1a1e06d4c91183..9fcd9681d98626 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/CryptoKeyClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/CryptoKeyClass.md @@ -141,7 +141,7 @@ ASSERT($status.success) **.curve** : Text -Definido sólo para llaves ECDSA: el nombre de la curva normalizada de la llave. Generalmente "prime256v1" para ES256 (por defecto), "secp384r1" para ES384, "secp521r1" para ES512. +Definido sólo para llaves RSA: el tamaño de la llave en bits. . @@ -350,7 +350,7 @@ La función `.sign()` firma la representac **.size** : Integer -Definido sólo para llaves RSA: el tamaño de la llave en bits. . +Definido sólo para llaves ECDSA: el el tamaño de la llave en bits. . ## .type @@ -387,6 +387,7 @@ Contiene el nombre del tipo de llave - "RSA" **.verify**( *message* : Text ; *signature* : Text ; *options* : Object) : Object + | Parámetros | Tipo | | Descripción | | ---------- | ------ | -- | ---------------------------------------------------------------------------------------------------- | @@ -407,11 +408,11 @@ La `CryptoKey` debe contener una llave **pública** válida. | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | hash | text | Algoritmo Digest a utilizar. Por ejemplo: "SHA256", "SHA384" o "SHA512". Cuando se utiliza para producir un JWT, el tamaño del hash debe coincidir con el tamaño del algoritmo PS@, ES@, RS@ o PS@ | | pss | boolean | Utilice el Probabilistic Signature Scheme (PSS). Se ignora si la llave no es una llave RSA. Pase `true` al verificar un JWT para el algoritmo PS@ | -| encoding | text | Encoding used to convert the binary encrypted message into the result string. Can be "Base64", or "Base64URL". Por defecto es "Base64". | +| encoding | text | Codificación utilizada para convertir el mensaje binario encriptado en la cadena de resultados. Puede ser "Base64", o "Base64URL". Por defecto es "Base64". | #### *Result* -La `CryptoKey` debe contener una llave **pública** válida. +La función devuelve un objeto de estado con la propiedad `success` definida como `true` si el `message` pudo ser verificado con éxito (es decir, la firma coincide). La función devuelve un objeto de estado con la propiedad `success` definida como `true` si el `message` pudo ser verificado con éxito (es decir, la firma coincide). diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md index 455a52e65b0369..80d23e97819e62 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md @@ -904,7 +904,7 @@ donde: * **Text**: la cadena de fórmulas debe ir precedida de la declaración `eval( )`, para que el analizador de consultas evalúe la expresión correctamente. Por ejemplo: *"eval(length(This.lastname) >=30)"* * **Object**: el [objeto fórmula](FunctionClass.md) se pasa como un **marcador** (ver abajo). La fórmula debe haber sido creada utilizando los comandos [`Formula`](FunctionClass.md#formula) o [`Formula from string`](FunctionClass.md#formula-from-string). -> * > * Keep in mind that 4D formulas only support `&` and `|` symbols as logical operators. +> * > * > * > * > * Keep in mind that 4D formulas only support `&` and `|` symbols as logical operators. > * Si la fórmula no es el único criterio de búsqueda, el optimizador del motor de búsquedas podría procesar previamente otros criterios (por ejemplo, los atributos indexados) y, por tanto, la fórmula podría evaluarse sólo para un subconjunto de entidades. Las fórmulas en las consultas pueden recibir parámetros a través de $1. Este punto se detalla en el párrafo **Parámetro fórmula** más abajo. @@ -927,7 +927,7 @@ donde: | Incluído en | IN | Devuelve los datos iguales a al menos uno de los valores de una colección o de un conjunto de valores, admite el comodín (@) | | Contiene palabra clave | % | Las palabras claves pueden utilizarse en atributos de tipo texto o imagen | -* **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades o elemento en la colección. Puede ser un **marcador** (ver **Uso de marcadores** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Al utilizar un valor constante, deben respetarse las siguientes reglas: +* **value**: el valor a comparar con el valor actual de la propiedad de cada entidad en la selección de entidades o elemento en la colección. Puede ser un **marcador** (ver **Uso de marcadores** más adelante) o cualquier expresión que coincida con la propiedad de tipo de datos. Al utilizar un valor constante, deben respetarse las siguientes reglas: Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20. * La constante de tipo **texto** puede pasarse con o sin comillas simples (ver **Uso de comillas** más abajo). Para consultar una cadena dentro de otra cadena (una consulta de tipo "contiene"), utilice el símbolo de comodín (@) en el valor para aislar la cadena a buscar como se muestra en este ejemplo: "@Smith@". Las siguientes palabras claves están prohibidas para las constantes de texto: true, false. * Valores constantes de tipo **boolean**: **true** o **false** (Sensible a las mayúsculas y minúsculas). * Valores constantes de tipo **numérico**: los decimales se separan con un '.' @@ -1024,7 +1024,7 @@ Al buscar dentro de atributos de objetos dataclass que contengan colecciones, el ``` Entity 1: -ds.Class.name: "A" +ds. Class.name: "A" ds.Class.info: { "coll" : [ { "val":1, @@ -1032,7 +1032,7 @@ ds.Class.info: } ] } Entity 2: -ds.Class.name: "B" +ds. Class.name: "B" ds.Class.info: { "coll" : [ { "val":1, @@ -1040,7 +1040,7 @@ ds.Class.info: } ] } Entity 3: -ds.Class.name: "C" +ds. Class.name: "C" ds.Class.info: { "coll" : [ { "val":0, @@ -1081,7 +1081,7 @@ Esta funcionalidad sólo está disponible en las búsquedas en clases de datos y ::: -Al buscar dentro de los atributos de objetos de clases de datos que contengan colecciones utilizando varios argumentos de consulta unidos por el operador AND, es posible que desee asegurarse de que sólo se devuelvan entidades que contengan elementos que coincidan con todos los argumentos, y no entidades en las que los argumentos puedan encontrarse en elementos diferentes. Para ello, es necesario vincular los argumentos de la búsqueda a los elementos de colección, de modo que sólo se encuentren los elementos únicos que contengan argumentos vinculados. +Para ello, es necesario vincular los argumentos de la búsqueda a los elementos de colección, de modo que sólo se encuentren los elementos únicos que contengan argumentos vinculados. Al buscar dentro de los atributos de objetos de clases de datos que contengan colecciones utilizando varios argumentos de consulta unidos por el operador AND, es posible que desee asegurarse de que sólo se devuelvan entidades que contengan elementos que coincidan con todos los argumentos, y no entidades en las que los argumentos puedan encontrarse en elementos diferentes. Por ejemplo, con las dos entidades siguientes: @@ -1207,7 +1207,7 @@ En el parámetro *querySettings* se puede pasar un objeto que contenga opciones #### Sobre queryPlan y queryPath -La información registrada en `queryPlan`/`queryPath` incluye el tipo de búsqueda (indexada y secuencial) y cada subconsulta necesaria junto con los operadores de conjunción. Las rutas de acceso de las peticiones también contienen el número de entidades encontradas y el tiempo necesario para ejecutar cada criterio de búsqueda. Puede resultarle útil analizar esta información mientras desarrolla sus aplicaciones. Generalmente, la descripción del plan de consulta y su ruta de acceso son idénticas, pero pueden diferir porque 4D puede implementar optimizaciones dinámicas cuando se ejecuta una consulta para mejorar el rendimiento. Por ejemplo, el motor 4D puede convertir dinámicamente una consulta indexada en una secuencial si estima que es más rápida. Este caso concreto puede darse cuando el número de entidades que se buscan es bajo. +La información registrada en `queryPlan`/`queryPath` incluye el tipo de búsqueda (indexada y secuencial) y cada subconsulta necesaria junto con los operadores de conjunción. Las rutas de acceso de las peticiones también contienen el número de entidades encontradas y el tiempo necesario para ejecutar cada criterio de búsqueda. Las rutas de acceso de las peticiones también contienen el número de entidades encontradas y el tiempo necesario para ejecutar cada criterio de búsqueda. Generalmente, la descripción del plan de consulta y su ruta de acceso son idénticas, pero pueden diferir porque 4D puede implementar optimizaciones dinámicas cuando se ejecuta una consulta para mejorar el rendimiento. Por ejemplo, el motor 4D puede convertir dinámicamente una consulta indexada en una secuencial si estima que es más rápida. Este caso concreto puede darse cuando el número de entidades que se buscan es bajo. Por ejemplo, si ejecuta la siguiente búsqueda: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntityClass.md index d482ef89d2cdd4..7e068ca38b18c3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntityClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntityClass.md @@ -92,8 +92,10 @@ El tipo de valor del atributo depende del tipo [kind](DataClassClass.md#attribut #### Descripción -La función `.clone()` crea en memoria una nueva entidad que hace referencia al mismo registro que la entidad original. Esta función permite actualizar las entidades por separado. -> Tenga en cuenta que toda modificación realizada a las entidades se guardará en el registro referenciado sólo cuando se ejecute la función [`.save( )`](#save). +La función `.clone()` crea en memoria una nueva entidad que hace referencia al mismo registro que la entidad original. + +This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity. +> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed. Esta función sólo puede utilizarse con entidades ya guardadas en la base de datos. No se puede llamar a una entidad recién creada (para la que [`.isNew()`](#isnew) devuelve **True**). @@ -232,7 +234,7 @@ $diff2: vCompareResult3:=$e1.diff($e2;$e1.touchedAttributes()) ``` -vCompareResult1 (se devuelven todas las diferencias): +vCompareResult3 (sólo se devuelven las diferencias en atributos tocados $e1) ```4d [ @@ -281,7 +283,7 @@ vCompareResult2 (sólo se devuelven las diferencias en $attributesToInspect) ] ``` -vCompareResult3 (sólo se devuelven las diferencias en atributos tocados $e1) +vCompareResult1 (se devuelven todas las diferencias): ```4d [ @@ -565,7 +567,7 @@ También puede utilizar una entidad relacionada dada como objeto: #### Descripción -La función `.getDataClass()` devuelve la clase de datos de la entidad. Esta función es útil al escribir código genérico. +La función `.isNew()` devuelve True si la entidad a la que se aplica acaba de ser creada y aún no se ha guardado en el almacén de datos. . #### Ejemplo @@ -973,7 +975,7 @@ El objeto devuelto por `.lock( )` contiene las siguientes propiedades: | | component signature | text | firma del componente interno (por ejemplo, "dmbg" significa el componente de la base) | | | errCode | number | Código de error | -(\*) Los siguientes valores pueden ser devueltos en las propiedades *status* y *statusText* del objeto *Result* en caso de error: +(\*) Los siguientes valores pueden ser devueltos en las propiedadese *status* y *statusText* del objeto *Result* en caso de error: | Constante | Valor | Comentario | | ----------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1137,7 +1139,7 @@ El objeto devuelto por `.reload( )` contiene las siguientes propiedades: | status(\*) | number | Código de error, ver abajo | | statusText(\*) | text | Descripción del error, ver abajo | -(\*) Los siguientes valores pueden ser devueltos en las propiedadese *status* y *statusText* del objeto *Result* en caso de error: +(\*) Los siguientes valores pueden ser devueltos en las propiedades *status* y *statusText* del objeto *Result* en caso de error: | Constante | Valor | Comentario | | ----------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -1371,7 +1373,7 @@ Sin parámetro de filtro: employeeObject:=employeeSelected.toObject() ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Lanzamiento ```4d { @@ -1402,7 +1404,7 @@ Extraer la llave primaria y el sello: employeeObject:=employeeSelected.toObject("";dk with primary key+dk with stamp) ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Lanzamiento ```4d { @@ -1504,7 +1506,7 @@ Extracción de algunas propiedades de `relatedEntities`: employeeObject:=employeeSelected.toObject("firstName, directReports.lastName") ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Lanzamiento ```4d { @@ -1532,7 +1534,7 @@ Obtenga una `relatedEntity` en un formulario simple: employeeObject:=employeeSelected.toObject($coll) ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Lanzamiento ```4d { @@ -1551,7 +1553,7 @@ Extracción de todas las propiedades de una `Entidad relacionada`: employeeObject:=employeeSelected.toObject("employer.*") ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Devuelve: ```4d { @@ -1576,7 +1578,7 @@ Extracción de algunas propiedades de una `Entidad relacionada`: employeeObject:=employeeSelected.toObject($col) ``` -Ejemplo con el tipo `relatedEntity` con una forma simple: +Devuelve: ```4d { diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md index 3c72030f002fa9..d772ffa5ca8b2e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md @@ -1108,7 +1108,7 @@ Sin embargo, hay una diferencia entre ambas afirmaciones cuando la selección es #### Descripción -La función `.getDataClass()` The `.getDataClass()` function. +La función `.isNew()` The `.getDataClass()` function. Esta función es principalmente útil en el contexto del código genérico. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md b/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md index 72f7a13df502ca..ebea23775a5e2f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md @@ -182,11 +182,11 @@ Function
(2) No compatible con los estilos [Ayuda](#help), [Plano](#flat) y [Normal](#regular). -Existen propiedades específicas adicionales, dependiendo del [estilo-de-botón](#button-styles): +Existen propiedades específicas adicionales, dependiendo del [estilo de botón](#button-styles): - Personalizar: [Ruta de fondo](properties_TextAndPicture.md#background-pathname) - [Margen horizontal](properties_TextAndPicture.md#horizontal-margin) - [Desplazamiento del icono](properties_TextAndPicture.md#icon-offset) - [Margen vertical](properties_TextAndPicture.md#vertical-margin) - Plano, Regular: [Botón por defecto](properties_Appearance.md#default-button) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md index 1c699067ae30a4..5e2b6c14a4e751 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md @@ -40,7 +40,7 @@ Si el objeto contiene otras propiedades, se ignoran. Para inicializar el objeto asociado a la lista desplegable, puede: -* Introduzca una lista de valores por defecto en las propiedades del objeto seleccionando `\<Lista Estática>` en el tema [Fuente de Datos](properties_DataSource.md) de la Lista de Propiedades. Los valores por defecto se cargan en un objeto automáticamente. +* Introduzca una lista de valores por defecto en las propiedades del objeto seleccionando `\<Static List>` en el tema [Fuente de Datos](properties_DataSource.md) de la Lista de Propiedades. Los valores por defecto se cargan en un objeto automáticamente. * Ejecutar código que crea el objeto y sus propiedades. Por ejemplo, si "myList" es la variable [](properties_Object.md#variable-or-expression) asociada a la lista desplegable, puede escribir en el evento de formulario [On Load](Events/onLoad.md): @@ -73,7 +73,7 @@ Un [array](Concepts/arrays.md) es una lista de valores en memoria a la que se ha Para inicializar el array asociado a la lista desplegable, puede: -* Introduzca una lista de valores por defecto en las propiedades del objeto seleccionando `\<Lista Estática>` en el tema [Fuente de Datos](properties_DataSource.md) de la Lista de Propiedades. Los valores por defecto se cargan en un array automáticamente. Puede referirse al array utilizando el nombre de la variable asociada al objeto. +* Introduzca una lista de valores por defecto en las propiedades del objeto seleccionando `\<Static List>` en el tema [Fuente de Datos](properties_DataSource.md) de la Lista de Propiedades. Los valores por defecto se cargan en un array automáticamente. Puede referirse al array utilizando el nombre de la variable asociada al objeto. * Antes de mostrar el objeto, ejecute el código que asigna valores a los elementos del array. Por ejemplo: @@ -124,7 +124,7 @@ Debe seleccionar cada evento que pruebe en sus sentencia Case. Los arrays siempr Si desea utilizar una lista desplegable para gestionar los valores de un área de entrada (campo listado o variable), 4D le permite hacer referencia al campo o variable directamente como [fuente de datos](properties_Object.md#variable-or-expression) de la lista desplegable. Esto facilita la gestión de los campos/variables listados. Por ejemplo, en el caso de un campo "Color" que sólo puede contener los valores "Blanco", "Azul", "Verde" o "Rojo", es posible crear una lista que contenga estos valores y asociarla a una lista desplegable que haga referencia al campo "Color" 4D. 4D se encarga entonces de gestionar automáticamente la entrada y la visualización del valor actual en el formulario. -> Si utiliza una lista jerárquica, sólo se muestra el primer nivel y se puede seleccionar. If you use a hierarchical list, only the first level is displayed and can be selected. +> Si utiliza una lista jerárquica, sólo se muestra el primer nivel y se puede seleccionar. Si quiere mostrar contenido jerárquico, necesita usar una [lista de selección jerárquica](#using-a-hierarchical-choice-list). Para asociar una lista desplegable a un campo o variable, introduzca directamente el nombre del campo o variable como campo [Variable o Expresión](properties_Object.md#variable-or-expression) de la lista desplegable en la Lista de propiedades. > No es posible utilizar esta funcionalidad con una lista desplegable de objetos o arrays. Si introduce un nombre de campo en el área "Variable o expresión", deberá utilizar una lista de selección. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md index 3a8ca8cfb848a8..21dd25cc9d811b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md @@ -86,7 +86,7 @@ Las variables o expresiones se pueden introducir o no y pueden recibir datos de | Nombre | Tipos de datos | Valores posibles | | ---------- | ------------------------- | --------------------------------------------------------------------------- | -| dataSource | cadena o array de cadenas |
Historique
+ +| Release | Modifications | +| ------- | -------------- | +| 20 R8 | Classe ajoutée | + +| +| [](#getheader)
| +| [](#getjson)
| +| [](#getpicture)
| +| [](#gettext)
| +| [](#headers)
| +| [](#url)
| +| [](#urlPath)
| +| [](#urlQuery)
| +| [](#verb)
| + +:::note + +A 4D.IncomingMessage object is a [non-sharable](../Concepts/shared.md) object. + +::: + + + +## .getBlob() + +**.getBlob**() : Blob + + + +| Paramètres | Type | | Description | +| ---------- | ---- | --------------------------- | ----------------------------- | +| Résultat | Blob | <- | Body of the request as a Blob | + + + +#### Description + +The `.getBlob()` function returns the body of the request as a Blob. + +If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. + + + + + +## .getHeader() + +**.getHeader**( *key* : Text ) : Text + + + +| Paramètres | Type | | Description | +| ---------- | ---- | --------------------------- | ---------------------------- | +| key | Text | -> | Header property to get | +| Résultat | Text | <- | Value of the header property | + + + +#### Description + +The `.getHeader()` function returns the value of the *key* header. + +:::note + +The *key* parameter is not case sensitive. + +::: + +#### Exemple + +```4d +var $value : Text +var $request : 4D.IncomingMessage +$value := $request.getHeader("content-type") +``` + + + + + +## .getJSON() + +**.getJSON**() : Variant + + + +| Paramètres | Type | | Description | +| ---------- | ------- | --------------------------- | ------------------------------------------ | +| Résultat | Variant | <- | JSON resolution of the body of the request | + + + +#### Description + +The `.getJSON()` function returns the body of the request as a JSON resolution. + +If the body has not been given as JSON valid content, an error is raised. + + + + + +## .getPicture() + +**.getPicture**() : Picture + + + +| Paramètres | Type | | Description | +| ---------- | ------- | --------------------------- | ------------------------------ | +| Résultat | Picture | <- | Body of the request as picture | + + + +#### Description + +The `.getPicture()` function returns the body of the request as a picture (in case of a body sent as a picture). + +The content-type must be given in the headers to indicate that the body is a picture. + +:::note + +If the request is built using the [`HTTPRequest` class](HTTPRequestClass.md), the picture must be sent in the body as a Blob with the appropriate content-type. + +::: + +If the body is not received as a valid picture, the function returns null. + + + + + +## .getText() + +**.getText**() : Text + + + +| Paramètres | Type | | Description | +| ---------- | ---- | --------------------------- | --------------------------- | +| Résultat | Text | <- | Body of the request as text | + + + +#### Description + +The `.getText()` function returns the body of the request as a text value. + +If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. + + + + + +## .headers + +**headers** : Object + +#### Description + +The `.headers` property contains the current headers of the incoming message as key/value pairs (strings). + +The `.headers` property is read-only. + +Header names (keys) are lowercased. Note header names are case sensitive. + + + + + +## .url + +**url** : Text + +#### Description + +The `.url` property contains the URL of the request without the *IP:port* part and as a string. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". + +The `.url` property is read-only. + +:::note + +The "host" part of the request (*IP:port*) is provided by the [`host` header](#headers). + +::: + + + + + +## .urlPath + +**urlPath** : Collection + +#### Description + +The `.urlPath` property contains the URL of the request without the *IP:port* part and as a collection of strings. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. + +The `.urlPath` property is read-only. + + + + + +## .urlQuery + +**urlQuery** : Object + +#### Description + +The `.urlQuery` property contains the parameters of the request when they have been given in the URL as key/value pairs. + +The `.urlQuery` property is read-only. + +Parameters can be passed in the URL of requests **directly** or **as JSON contents**. + +#### Direct parameters + +Example: `http://127.0.0.1:8044/myCall?firstname=Marie&id=2&isWoman=true` + +In this case, parameters are received as stringified values in the `urlQuery` property: `urlQuery = {"firstname":"Marie" ,"id":"2" ,"isWoman":"true"}` + +#### JSON contents parameters + +Example: `http://127.0.0.1:8044/myCall/?myparams='[{"firstname": "Marie","isWoman": true,"id": 3}]'`. + +Parameters are passed in JSON format and enclosed within a collection. + +In this case, parameters are received as JSON text in the `urlQuery` property and can be parsed using [`JSON Parse`](../commands-legacy/json-parse.md). + +```4d +//urlQuery.myparams: "[{"firstname": "Marie","isWoman": true,"id": 3}]" +$test:=Value type(JSON Parse($r.urlQuery.myparams))=Is collection) //true +``` + +Special characters such as simple quotes or carriage returns must be escaped. + +Example: `http://127.0.0.1:8044/syntax/?mdcode=%60%60%604d` + +````4d +//urlQuery.mdcode = ```4d +$test:=Length($r.urlQuery.mdcode) //5 +```` + +:::note + +Parameters given in the body of the request using POST or PUT verbs are handled through dedicated functions: [`getText()`](#gettext), [`getPicture()`](#getpicture), [`getBlob()`](#getblob), [`getJSON()`](#getjson). + +::: + + + + + +## .verb + +**verb** : Text + +#### Description + +The `.verb` property contains the verb used by the request. + +HTTP and HTTPS request verbs include for example "get", "post", "put", etc. + +The `.verb` property is read-only. + + diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md index c5a2db7b95bfea..914580df7960cf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index c5a2db7b95bfea..914580df7960cf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md index 242f3e3b2a3f5b..028bd3681de487 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -7,12 +7,12 @@ Les objets de session sont retournés par la commande [`Session`](../commands/se ### Types de sessions -The following types of sessions are supported by this class: +Les types de sessions suivants sont pris en charge par cette classe : - [**Session utilisateur Web**](WebServer/sessions.md) : Les sessions utilisateur Web sont disponibles lorsque [les sessions évolutives (scalable sessions) sont activées dans votre projet](WebServer/sessions.md#enabling-sessions). Elles sont utilisées pour les connexions Web et REST, et peuvent se voir attribuer des privilèges. - [**Session utilisateur client distant**](../Desktop/clientServer.md#remote-user-sessions) : Dans les applications client/serveur, les utilisateurs distants ont leurs propres sessions gérées sur le serveur. - [**Session des procédures stockées**](https://doc.4d.com/4Dv20R5/4D/20-R5/4D-Server-and-the-4D-Language.300-6932726.en.html) : Toutes les procédures stockées exécutées sur le serveur partagent la même session utilisateur virtuelle. -- [**Standalone session**](../Project/overview.md#development): Local session object returned in single-user application (useful in development and test phases of client/server applications). +- [**Session autonome**](../Project/overview.md#development) : objet session local retourné dans une application mono-utilisateur (utile dans les phases de développement et de test des applications client/serveur). :::note @@ -62,7 +62,7 @@ La disponibilité des propriétés et des fonctions de l'objet `Session` dépend :::note -This function does nothing and always returns **True** with remote client, stored procedure, and standalone sessions. +Cette fonction ne fait rien et retourne toujours **True** avec les sessions client distants, procédure stockée et autonomes. ::: @@ -142,7 +142,7 @@ $expiration:=Session.expirationDate //ex : "2021-11-05T17:10:42Z" La fonction `.getPrivileges()` renvoie une collection contenant tous les noms de privilèges associés à la session. -With remote client, stored procedure and standalone sessions, this function returns a collection only containing "WebAdmin". +Avec les sessions client distant, procédures stockées et autonomes, cette fonction retourne une collection contenant uniquement "WebAdmin". :::info @@ -238,7 +238,7 @@ $privileges := Session.getPrivileges() La fonction `.hasPrivilege()` renvoie True si le *privilege* est associé à la session, et False sinon. -With remote client, stored procedure and standalone sessions, this function always returns True, whatever the *privilege*. +Avec les sessions client distant, procédures stockées et autonomes, cette fonction retourne toujours True, quel que soit le *privilege*. #### Exemple @@ -271,11 +271,11 @@ End if #### Description -The `.id` property contains the unique identifier (UUID) of the user session. With 4D Server, this unique string is automatically assigned by the server for each session and allows you to identify its processes. +La propriété `.id` contient l'identifiant unique (UUID) de la session utilisateur. Avec 4D Server, cette chaîne unique est automatiquement assignée par le serveur à chaque session et vous permet d'identifier ses process. :::tip -You can use this property to get the [`.storage`](#storage) object of a session thanks to the [`Session storage`](../commands/session-storage.md) command. +Vous pouvez utiliser cette propriété pour obtenir l'objet [`.storage`](#storage) d'une session grâce à la commande [`Session storage`](../commands/session-storage.md) . ::: @@ -347,33 +347,33 @@ End if :::note -This property is only available with remote client, stored procedure, and standalone sessions. +Cette propriété est uniquement disponible avec les sessions clients distants, procédures stockées et autonomes. ::: -The `.info` property describes the remote client or stored procedure session on the server, or the standalone session. +La propriété `.info` décrit le client distant ou la session de procédure stockée sur le serveur, ou la session autonome. :::note -- The `.info` object is the same object as the one returned in the "session" property by the [`Process activity`](../commands/process-activity.md) command for remote client and stored procedure sessions. -- The `.info` object is the same object as the one returned by the [`Session info`](../commands/session-info.md) command for a standalone session. +- L'objet `.info` est le même objet que celui retourné dans la propriété "session" par la commande [`Process activity`](../commands/process-activity.md) pour les sessions de clients distants et procédures stockées. +- L'objet `.info` est le même objet que celui retourné par la commande [`Session info`](../commands/session-info.md) pour une session autonome. ::: L'objet `.info` contient les propriétés suivantes: -| Propriété | Type | Description | -| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| type | Text | Session type: "remote", "storedProcedure", "standalone" | -| userName | Text | Nom d'utilisateur 4D (même valeur que [`.userName`](#username)) | -| machineName | Text | Sessions distantes : nom de la machine distante. Stored procedures session: name of the server machine. Standalone session: name of the machine | -| systemUserName | Text | Sessions distantes : nom de la session système ouverte sur la machine distante. | -| IPAddress | Text | Adresse IP de la machine distante | -| hostType | Text | Type d'hôte : "windows" ou "mac" | -| creationDateTime | Date ISO 8601 | Date and time of session creation. Standalone session: date and time of application startup | -| state | Text | État de la session : "active", "postponed", "sleeping" | -| ID | Text | UUID de session (même valeur que [`.id`](#id)) | -| persistentID | Text | Remote sessions: Session's persistent ID | +| Propriété | Type | Description | +| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| type | Text | Type de session : "remote", "storedProcedure", "standalone" | +| userName | Text | Nom d'utilisateur 4D (même valeur que [`.userName`](#username)) | +| machineName | Text | Sessions distantes : nom de la machine distante. Session procédures stockées : nom de la machine serveur. Session autonome : nom de la machine | +| systemUserName | Text | Sessions distantes : nom de la session système ouverte sur la machine distante. | +| IPAddress | Text | Adresse IP de la machine distante | +| hostType | Text | Type d'hôte : "windows" ou "mac" | +| creationDateTime | Date ISO 8601 | Date et heure de création de la session. Session autonome : date et heure de démarrage de l'application | +| state | Text | État de la session : "active", "postponed", "sleeping" | +| ID | Text | UUID de session (même valeur que [`.id`](#id)) | +| persistentID | Text | Sessions distantes : ID persistant de la session | :::note @@ -409,7 +409,7 @@ L'objet `.info` contient les propriétés suivantes: :::note -This function always returns **False** with remote client, stored procedure, and standalone sessions. +Cette fonction retourne toujours **False** avec les sessions clients distants, procédures stockées et autonomes. ::: @@ -457,7 +457,7 @@ End if :::note -This function does nothing and always returns **False** with remote client, stored procedure, and standalone sessions. +Cette fonction ne fait rien et retourne toujours **False** avec les sessions client distants, procédures stockées et autonomes. ::: @@ -538,7 +538,7 @@ Cette propriété est elle-même en **lecture seulement** mais elle retourne un :::tip -You can get the `.storage` property of a session using the [`Session storage`](../commands/session-storage.md) command. +Vous pouvez obtenir la propriété `.storage` d'une session en utilisant la commande [`Session storage`](../commands/session-storage.md). ::: @@ -586,8 +586,8 @@ End use La propriété `.userName` contient le nom d'utilisateur associé à la session. Vous pouvez vous en servir pour identifier l'utilisateur dans votre code. - Avec les sessions web, cette propriété est une chaîne vide par défaut. Elle peut être définie via la propriété `privileges` de la fonction [`setPrivileges()`](#setprivileges). -- With remote and stored procedure sessions, this property returns the same user name as the [`Current user`](../commands-legacy/current-user.md) command. -- With standalone sessions, this property contains "designer" or the name set with the [`SET USER ALIAS`](../commands-legacy/set-user-alias.md) command. +- Avec les sessions clients distants et procédures stockées, cette propriété retourne le même nom d'utilisateur que la commande [`Current user`](../commands-legacy/current-user.md). +- Avec les sessions autonomes, cette propriété contient "designer" ou le nom défini avec la commande [`SET USER ALIAS`](../commands-legacy/set-user-alias.md). Cette propriété est en **lecture seule**. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/classes.md b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/classes.md index c7fd14caff2ef7..92a8c026e80fd7 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/classes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Concepts/classes.md @@ -7,7 +7,7 @@ title: Classes Le langage 4D prend en charge le concept de **classes**. Dans un langage de programmation, l'utilisation d'une classe vous permet de définir le comportement d'un objet avec des propriétés et des fonctions associées. -Une fois qu'une classe utilisateur est définie, vous pouvez **instancier des objets** de cette classe n'importe où dans votre code. Chaque objet est une instance de sa classe. Une classe peut [`étendre`](#class-extends-classname) une autre classe, et hérite ensuite de ses [fonctions](#function) et propriétés ([déclarées](#property) et [calculées](#function-get-and-function-set)). +Une fois qu'une classe utilisateur est définie, vous pouvez **instancier des objets** de cette classe n'importe où dans votre code. Chaque objet est une instance de sa classe. Chaque objet est une instance de sa classe. > Les modèles de classe 4D et JavaScript sont similaires, et basés sur une chaîne de prototypes. @@ -107,9 +107,9 @@ Les classes disponibles sont accessibles depuis leurs class stores. Il existe de -| Paramètres | Type | | Description | | -| ---------- | ------ | ------------------------------ | ------------------------------------------------------------------- | ---------------- | -| classStore | Object | ← | Class store utilisateur utilisateurs pour le projet ou le composant | | +| Paramètres | Type | | Description | | +| ---------- | ------ | - | ------------------------------------------------------------------- | ---------------- | +| classStore | Object | ← | Class store utilisateur utilisateurs pour le projet ou le composant | | La commande `cs` retourne le class store utilisateur pour le projet ou le composant courant. Elle retourne toutes les classes utilisateur [définies](#class-definition) dans le projet ou le composant ouvert. Par défaut, seules les [classes ORDA](ORDA/ordaClasses.md) du projet sont disponibles. @@ -127,9 +127,9 @@ $instance:=cs.myClass.new() -| Paramètres | Type | | Description | | -| ---------- | ------ | ------------------------------ | -------------- | ---------------- | -| classStore | Object | ← | Class store 4D | | +| Paramètres | Type | | Description | | +| ---------- | ------ | - | -------------- | ---------------- | +| classStore | Object | ← | Class store 4D | | La commande `4D` retourne le class store des classes 4D intégrées disponibles. Elle donne accès à des API spécifiques telles que [CryptoKey](API/CryptoKeyClass.md). @@ -199,7 +199,7 @@ There is no ending keyword for function code. The 4D language automatically dete Les fonctions de classe sont des propriétés spécifiques de la classe. Ce sont des objets de la classe [4D.Function](API/FunctionClass.md). Dans le fichier de définition de classe, les déclarations de fonction utilisent le mot-clé `Function` suivi du nom de la fonction. -Si la fonction est déclarée dans une [classe partagée](#shared-classes), vous pouvez utiliser le mot-clé `shared` pour que la fonction puisse être appelée sans [structure `Use. .End use`](shared.md#useend-use). Pour plus d'informations, consultez le paragraphe sur les [fonctions partagées](#shared-functions) ci-dessous. +Si les fonctions sont déclarées dans une [classe partagée](#constructeur-de-classe-partagee), vous pouvez utiliser le mot-clé `shared` avec elles afin qu'elles puissent être appelées sans la structure [`Use...End use`](shared.md#useend-use). Pour plus d'informations, consultez le paragraphe sur les [fonctions partagées](#shared-functions) ci-dessous. Le nom de la fonction doit être conforme aux [règles de nommage des objets](Concepts/identifiers.md#object-properties). @@ -341,7 +341,7 @@ Une fonction class constructor accepte des [paramètres](#parameters) facultatif Lorsque vous appelez la fonction [`new()`](API/ClassClass.md#new), le constructeur de classe est appelé avec les paramètres éventuellement passés à la fonction `new()`. -Il ne peut y avoir qu'une seule fonction constructor dans une classe (sinon une erreur est renvoyée). Un constructeur peut utiliser le mot-clé [`Super`](#super) pour appeler le constructeur de la superclass. +Il ne peut y avoir qu'une seule fonction constructor dans une classe (sinon une erreur est renvoyée). The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function. Vous pouvez créer et saisir des propriétés d'instance dans le constructeur (voir exemple). Alternativement, si les valeurs de vos propriétés d'instance ne dépendent pas des paramètres passés au constructeur, vous pouvez les définir en utilisant le mot-clé [`property`](#property). @@ -509,9 +509,9 @@ Dans le fichier de définition de la classe, les déclarations de propriétés c `Function get` retourne une valeur du type de la propriété et `Function set` prend un paramètre du type de la propriété. Les deux arguments doivent être conformes aux [paramètres de fonction](#parameters) standard. -Lorsque les deux fonctions sont définies, la propriété calculée est en **lecture-écriture**. Si seule une `Function get` est définie, la propriété calculée est en **lecture seule**. Dans ce cas, une erreur est retournée si le code tente de modifier la propriété. Si seule une `Function set` est définie, 4D retourne _undefined_ lorsque la propriété est lue. +Lorsque les deux fonctions sont définies, la propriété calculée est en **lecture-écriture**. Si seule une `Function get` est définie, la propriété calculée est en **lecture seule**. Dans ce cas, une erreur est retournée si le code tente de modifier la propriété. Dans ce cas, une erreur est retournée si le code tente de modifier la propriété. -Si les fonctions sont déclarées dans une [classe partagée](#constructeur-de-classe-partagee), vous pouvez utiliser le mot-clé `shared` avec elles afin qu'elles puissent être appelées sans la structure [`Use...End use`](shared.md#useend-use). Pour plus d'informations, consultez le paragraphe sur les [fonctions partagées](#shared-functions) ci-dessous. +Si la fonction est déclarée dans une [classe partagée](#shared-classes), vous pouvez utiliser le mot-clé `shared` pour que la fonction puisse être appelée sans [structure `Use. .End use`](shared.md#useend-use). Pour plus d'informations, consultez le paragraphe sur les [fonctions partagées](#shared-functions) ci-dessous. Le type de la propriété calculée est défini par la déclaration de type `$return` du _getter_. Il peut s'agir de n'importe quel [type de propriété valide](dt_object.md). @@ -612,7 +612,7 @@ The following commands have specific features when they are used within class fu ### `Super` -The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function. It can be called in the [class constructor](#class-constructor) or in a class function code. +The [`Super`](../commands/super.md) command allows calls to the [`superclass`](../API/ClassClass#superclass), i.e. the parent class of the function. Il ne peut y avoir qu'une seule fonction constructor dans une classe (sinon une erreur est renvoyée). For more details, see the [`Super`](../commands/super.md) command description. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugger.md b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugger.md index 28cdff55341e60..b2b0ac4d3aad44 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugger.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugger.md @@ -3,10 +3,16 @@ id: debugger title: Débogueur --- -Le débogueur est utile lorsque vous devez repérer des erreurs ou surveiller l'exécution de méthodes. Il vous permet d'avancer pas à pas dans le code et d'examiner les informations. Ce processus est appelé le "traçage". +The 4D debugger is useful when you need to spot errors or monitor the execution of methods. Il vous permet d'avancer pas à pas dans le code et d'examiner les informations. Ce processus est appelé le "traçage".  +:::info + +If you are used to coding with **VS Code**, you can also use this editor to debug 4D code on 4D Server after installing the [4D-Debugger](https://github.com/4d/4D-Debugger-VSCode) extension. + +::: + ## Appeler le débogueur Il existe plusieurs façons d'afficher le débogueur : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md index a2139ce61ce959..6d3924989290ef 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Debugging/debugging-remote.md @@ -20,6 +20,9 @@ Un seul débogueur peut déboguer une application 4D Server à un moment donné. - le débogueur local de 4D Server (par défaut) - si le serveur ne tourne pas en mode headless. - le débogueur d'un client 4D distant - si la session distante a accès au mode Développement. - the [Qodly debugger](../WebServer/qodly-studio.md#using-qodly-debugger-on-4d-server) on 4D Server - if the server allows access to Qodly Studio. +- the VS Code debugger, provided you installed the [4D-Debugger](https://github.com/4d/4D-Debugger-VSCode) extension. + +::: Le débogueur associé est appelé chaque fois que 4D Server rencontre : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/building.md b/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/building.md index 358b69cd0e1ddb..0782d56c8cd7f1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/building.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Desktop/building.md @@ -20,7 +20,7 @@ Le générateur d'applications vous permet de : Générer un package de projet peut être réalisé à l'aide de : -- soit la commande [`BUILD APPLICATION`](https://doc.4d.com/4dv20/help/command/fr/page871.html), +- either the [`BUILD APPLICATION`](../commands-legacy/build-application.md) command, - soir la [Page Application](#application) ou la [Page Client/Serveur](#client-server) de boîte de dialogue du Générateur d'application. :::tip @@ -45,9 +45,9 @@ La génération ne peut s'effectuer qu'une fois le projet compilé. Si vous sél Chaque paramètre du générateur d'application est sauvegardé en tant que clé XML dans le fichier XML du projet d'application nommé `buildApp.4DSettings`, situé dans le [dossier `Settings` du projet](../Project/architecture.md#settings-1). -Des paramètres par défaut sont utilisés lors de la première utilisation de la boîte de dialogue du Générateur d'application. Le contenu du fichier est mis à jour, si nécessaire, lorsque vous cliquez sur **Construire** ou **Enregistrer les paramètres**. Vous pouvez définir plusieurs autres fichiers de paramètres XML pour le même projet et les utiliser à l'aide de la commande [BUILD APPLICATION](https://doc.4d.com/4dv19/help/command/en/page871.html). +Des paramètres par défaut sont utilisés lors de la première utilisation de la boîte de dialogue du Générateur d'application. Le contenu du fichier est mis à jour, si nécessaire, lorsque vous cliquez sur **Construire** ou **Enregistrer les paramètres**. You can define several other XML settings file for the same project and employ them using the [`BUILD APPLICATION`](../commands-legacy/build-application.md) command. -Les clés XML fournissent des options supplémentaires à celles affichées dans la boîte de dialogue du Générateur d'application. La description de ces clés est détaillée dans le manuel [4D XML Keys BuildApplication](https://doc.4d.com/4Dv19/4D/19/4D-XML-Keys-BuildApplication.100-5447429.en.html). +Les clés XML fournissent des options supplémentaires à celles affichées dans la boîte de dialogue du Générateur d'application. The description of these keys are detailed in the [4D XML Keys BuildApplication](https://doc.4d.com/4Dv20/4D/20/4D-XML-Keys-BuildApplication.100-6335734.en.html) manual. ### Fichier journal @@ -59,9 +59,9 @@ Lorsqu'une application est créée, 4D génère un fichier journal nommé _Build - Toutes les erreurs qui se sont produites, - Tout problème de signature (par exemple, un plug-in non signé). -La vérification de ce fichier peut vous aider à gagner du temps lors des prochaines étapes de déploiement, si vous avez l'intention, par exemple, de notariser votre application. +Checking this file may help you saving time during the subsequent deployment steps, for example if you intend to [notarize](#about-notarization) your application on macOS. -> Utilisez la commande `Get 4D file (Build application log file)` pour obtenir l'emplacement du fichier journal. +> Use the `Get 4D file(Build application log file)` statement to get the log file location. ## Nom de l'application et dossier de destination @@ -87,7 +87,7 @@ Cette fonctionnalité crée un fichier _.4dz_ dans un dossier `Compiled Database Un fichier .4dz est essentiellement une version compressée du dossier du projet. Les fichiers .4dz peuvent être utilisés par 4D Server, 4D Volume Desktop (applications fusionnées) et 4D. La taille compacte et optimisée des fichiers .4dz facilite le déploiement des packages de projet. -> Lors de la génération de fichiers .4dz, 4D utilise par défaut un format zip **standard**. L'avantage de ce format est qu'il est facilement lisible par tout outil de dézippage. Si vous ne voulez pas utiliser ce format standard, ajoutez la clé XML `UseStandardZipFormat` avec la valeur `False` dans votre fichier [`buildApp.4DSettings`](#build-application-settings) (pour plus d'informations, voir le manuel [4D XML Keys BuildApplication](https://doc.4d.com/4Dv19/4D/19/4D-XML-Keys-BuildApplication.100-5447429.fr.html)). +> Lors de la génération de fichiers .4dz, 4D utilise par défaut un format zip **standard**. L'avantage de ce format est qu'il est facilement lisible par tout outil de dézippage. If you do not want to use this standard format, add the `UseStandardZipFormat` XML key with value `False` in your [`buildApp.4DSettings`](#build-application-settings) file (for more information, see the [4D XML Keys BuildApplication](https://doc.4d.com/4Dv20/4D/20/4D-XML-Keys-BuildApplication.100-6335734.en.html) manual). #### Inclure les dossiers associés @@ -99,16 +99,20 @@ Génère un composant compilé à partir de la structure. Un [composant](../Extensions/develop-components.md) est un fichier de structure 4D standard dans lequel des fonctionnalités spécifiques ont été développées. Once the component has been configured and [installed in another 4D project](../Project/components.md#basics) (the host application project), its functionalities are accessible from the host project. -Si vous avez nommé votre application _MyComponent_, 4D créera un dossier _Component_ contenant le dossier _MyComponent.4dbase_ : +If you have named your application _MyComponent_, 4D will automatically create a _Components_ folder with the following structure: -`
_4D Server only_: Qodly Studio code editor (see (2)) | Éditeur de code Qodly Studio | -| 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 | +| | Qodly Studio in 4D | Qodly Studio in Qodly Cloud platform | +| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | +| Afficher et modifier les tableaux (dataclasses), les attributs et les relations | Éditeur de structure 4D(1) | Éditeur de modèles de Qodly Studio | +| Qodly pages | Qodly Studio Page Editor | Qodly Studio Page Editor | +| Formulaires Desktop | 4D IDE | _non supporté_ | +| Langage de programmation | Langage 4D avec ORDA | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) avec ORDA | +| IDE code | 4D IDE code editor _or_ VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
_4D Server only_: Qodly Studio code editor (see (2)) | Éditeur de code Qodly Studio | +| 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 | (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)). 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. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png index de58a3d1eb1733..0afc8cd3cd6be1 100644 Binary files a/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png and b/i18n/fr/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png differ diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md b/i18n/fr/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md index 38658dde151f61..0f896547a4f311 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md @@ -13,6 +13,12 @@ Vous pouvez faire défiler le contenu des méthodes, des classes et des fonction L'éditeur de code 4D fournit un contrôle de base des erreurs de syntaxe. Un contrôle d'erreur supplémentaire est effectué lors de l'exécution du code. Pour plus d'informations sur la gestion des erreurs, voir [Débogage](../Debugging/basics.md). +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## Interface ### Toolbar (Barre d’outils) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md index 74db59b179f40f..cca38081865f11 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md @@ -54,7 +54,3 @@ Cet exemple crée un tableau interprocess de 50 éléments de type [Texte](# "Un ◊tabTexte{$vElem}:="Elément n°"+String($vElem) End for ``` - -#### Voir aussi - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md index 94a437d09a0c46..2b760ffa61e7ba 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md @@ -30,6 +30,5 @@ Si, par exemple, vous travaillez avec la base MesCDs qui se trouve dans le dossi #### Voir aussi -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md index b329ca321a7c29..8c7fe13040641d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md @@ -93,5 +93,4 @@ La méthode objet de la list box de gauche (destination) contient le code suivan #### Voir aussi -*\_o\_DRAG AND DROP PROPERTIES* *Présentation du Glisser-Déposer* \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md index cc70db823b33c3..779d94e78b6850 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md @@ -81,71 +81,68 @@ Vous disposez dans votre application de diverses zones de texte dans lesquelles Comme décrit ci-dessus, lorsque vous éditez une zone de texte, la valeur du champ ou de la variable de texte ne sera réellement modifiée que lorsque que vous l'aurez validée. Pour retrouver et insérer rapidement des entrées du glossaire dans une zone de texte alors qu'elle est en train d'être modifiée, vous devez donc créer une seconde zone "tampon" pour y placer les valeurs saisies. Vous pouvez effectuer cette opération à l'aide de la méthode projet décrite ci-dessous. Vous passez comme premiers paramètres des pointeurs vers la zone de saisie et vers la variable, puis la chaîne de caractère “interdits” comme troisième paramètre. Peu importe comment l'entrée clavier sera traitée, la méthode retourne la valeur saisie originale. Les caractères “interdits” sont les caractères que vous ne voulez pas insérer dans la zone saisissable et que vous voulez traiter en tant que caractères spéciaux. ```4d - // Méthode projet Frappe clavier tampon - // Frappe clavier tampon ( Pointeur ; Pointeur ; Alpha ) -> Alpha - // Frappe clavier tampon ( -> zoneSource ; -> valeurCourante ; Filtre ) -> Ancien frappe clavier - C_STRING(1;$0) - var $1;$2 : Pointer - var $vtNouvValeur : Text - C_STRING(255;$3) - // Retourne la frappe clavier originale - $0:=Keystroke - // Obtenir la sélection de texte dans la zone saisissable - GET HIGHLIGHT($1->;$vlDébut;$vlFin) - // Commencer à travailler sur la valeur courante - $vtNouvValeur:=$2-> - // En fonction de la touche enfoncée ou du caractère saisi, effectuer les actions appropriées + // Shadow keystroke project method + // Shadow keystroke ( Pointer ; Pointer ; String ) -> String + // Shadow keystroke ( -> srcArea ; -> curValue ; Filter ) -> Old keystroke +#DECLARE ($srcArea : Pointer ; $curVal : Pointer ; $filter : Text) -> $old : Text + var $vtNewValue : Text + // Return the original keystroke + $old:=Keystroke + // Get the text selection range within the enterable area + GET HIGHLIGHT($srcArea->;$vlStart;$vlEnd) + // Start working with the current value + $vtNewValue:=$curVal-> + // Depending on the key pressed or the character entered, + // Perform the appropriate actions Case of - // La touche Retour arrière a été enfoncée - :(Character code($0)=Backspace key) - // Supprimer les caractères sélectionnés ou le caractère à gauche du curseur - $vtNouvValeur:=Supprimer texte($vtNouvValeur;$vlDébut;$vlFin) - // Une touche "flèche" a été appuyée - // Ne faites rien sauf accepter la frappe clavier - :(Character code($0)=Left arrow key) - :(Character code($0)=Right arrow key) - :(Character code($0)=Up arrow key) - :(Character code($0)=Down arrow key) + // The Backspace (Delete) key has been pressed + :(Character code($old)=Backspace) + // Delete the selected characters or the character at the left of the text cursor + $vtNewValue:=Delete text($vtNewValue;$vlStart;$vlEnd) + // An Arrow key has been pressed + // Do nothing, but accept the keystroke + :(Character code($old)=Left arrow key) + :(Character code($old)=Right arrow key) + :(Character code($old)=Up arrow key) + :(Character code($old)=Down arrow key) - // Un caractère valide a été saisi - :(Position($0;$3)=0) - $vtNouvValeur:=Inserer texte($vtNouvValeur;$vlDébut;$vlFin;$0) + // An acceptable character has been entered + :(Position($old;$filter)=0) + $vtNewValue:=Insert text($vtNewValue;$vlStart;$vlEnd;$0) Else - // Le caractère n'est pas accepté + // The character is not accepted FILTER KEYSTROKE("") End case - // Retourner la valeur pour la prochaine gestion de la frappe clavier - $2->:=$vtNouvValeur + // Return the value for the next keystroke handling + $curVal->:=$vtNewValue ``` + Cette méthode utilise les sous-méthodes suivantes : ```4d - // Méthode projet Supprimer texte - // Supprimer texte ( Alpha ; Long ; Long ) -> Alpha - // Supprimer texte ( -> Texte ; SelDébut ; SelFin ) -> Nouveau texte - var $0;$1 : Text - var $2;$3 : Integer - $0:=Substring($1;1;$2-1-Num($2=$3))+Substring($1;$3) + // Delete text project method + // Delete text ( String ; Long ; Long ) -> String + // Delete text ( -> Text ; SelStart ; SelEnd ) -> New text +#DECLARE ($src : Text ; $start : Integer ; $end : Integer) -> $new : Text + $new:=Substring($src;1;$start-1-Num($start=$end))+Substring($src;$end) ``` - -```4d - // Méthode projet Inserer texte - // Inserer texte ( Alpha ; Long ; Long ; Alpha ) -> Alpha - // Inserer texte ( -> texteSource ; SelDébut ; SelFin ; Texte à insérer ) -> Nouveau texte - var $0;$1;$4 : Text - var $2;$3 : Integer - $0:=$1 - If($2#$3) - $0:=Substring($0;1;$2-1)+$4+Substring($0;$3) +```4d + // Insert text project method + // Insert text ( String ; Long ; Long ; String ) -> String + // Insert text ( -> srcText ; SelStart ; SelEnd ; Text to insert ) -> New text +#DECLARE ($src : Text ; $start : Integer ; $end : Integer ; $toInsert : Text) -> $new : Text + $new:=$src + If($start # $end) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$end) Else Case of - :($2<=1) - $0:=$4+$0 - :($2>Length($0)) - $0:=$0+$4 + :($start<=1) + $new:=$toInsert+$new + :($start>Length($new)) + $new:=$new+$toInsert Else - $0:=Substring($0;1;$2-1)+$4+Substring($0;$2) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$start) End case End if ``` @@ -153,21 +150,21 @@ Cette méthode utilise les sous-méthodes suivantes : Une fois que vous avez ajouté ces méthodes projet à votre base, vous pouvez les utiliser de la manière suivante : ```4d - // Méthode objet de la zone saisissable vaDescription + // vsDescription enterable area object method Case of :(FORM Event=On Load) - vaDescription:="" - vaDescriptionDouble:="" - // Etablir la liste des caractères “interdits” à traiter comme des touches spéciales - // (Dans cet exemple, seule la touche Aide est filtrée) - vaTouchesSpéciales:=Char(Help key) + vsDescription:="" + vsShadowDescription:="" + // Establish the list of the “forbidden” characters to be treated as special keys + // ( here, in this example, only the Help Key is filtered) + vsSpecialKeys:=Char(HelpKey) :(FORM Event=On Before Keystroke) - $vsKey:=Frappe clavier tampon(->vaDescription;->vaDescriptionDouble;vaTouchesSpéciales) + $vsKey:=Shadow keystroke(->vsDescription;->vsShadowDescription;vsSpecialKeys) Case of :(Character code($vsKey)=Help key) - // Faire quelque chose lorsque la touche Aide est enfoncée - // Dans cet exemple, une saisie de glossaire doit être recherchée et insérée - chercher_Glossaire(->vaDescription;->vaDescriptionDouble) + // Do something when the Help key is pressed + // Here, in this example, a Dictionary entry must be searched and inserted + LOOKUP DICTIONARY(->vsDescription;->vsShadowDescription) End case End case ``` @@ -175,37 +172,41 @@ Une fois que vous avez ajouté ces méthodes projet à votre base, vous pouvez l La méthode projet chercher\_Glossaire est listée ci-dessous (le point principal est l'utilisation de la variable tampon pour réaffecter la zone saisissable à modifier) : ```4d - // Méthode projet chercher_Glossaire - // chercher_Glossaire ( Pointeur ; Pointeur ) - // chercher_Glossaire ( -> zone saisissable ; ->variable double ) - var $1;$2 : Pointer - var $vlDébut;$vlFin : Integer - // Obtenir la sélection de texte dans la zone saisissable - GET HIGHLIGHT($1->;$vlDébut;$vlFin) - // Obtenir le texte sélectionné ou le mot situé à gauche du curseur $vtTexteSelectionne:=obtenirTexteSelectionne ($2->;$vlDébut;$vlFin) - // Y a-t-il quelque chose à rechercher ? - If($vtTexteSelectionne#"") - // Si la sélection de texte était le curseur, la sélection débute au mot situé après le curseur - If($vlDébut=$vlFin) - $vlDébut:=$vlDébut-Length($vtTexteSelectionne) + // LOOKUP DICTIONARY project method + // LOOKUP DICTIONARY ( Pointer ; Pointer ) + // LOOKUP DICTIONARY ( -> Enterable Area ; ->ShadowVariable ) + +#DECLARE ($area : Pointer ; $shadow : Pointer) + var $vlStart;$vlEnd : Integer + + // Get the text selection range within the enterable area + GET HIGHLIGHT($area->;$vlStart;$vlEnd) + // Get the selected text or the word on the left of the text cursor + $vtHighlightedText:=Get highlighted text($shadow->;$vlStart;$vlEnd) + // Is there something to look for? + If($vtHighlightedText#"") + // If the text selection was the text cursor, + // the selection now starts at the word preceeding the text cursor + If($vlStart=$vlEnd) + $vlStart:=$vlStart-Length($vtHighlightedText) End if - // Chercher la première entrée du glossaire disponible - QUERY([Glossaire];[Glossaire]Saisie=$vtTexteSelectionne+"@") - // Existe-t-elle ? - If(Records in selection([Glossaire])>0) - // Si oui, l'insérer dans la zone tampon - $2->:=Inserer texte($2->;$vlDébut;$vlFin;[Glossaire]Saisie) - // Copier le tampon dans la zone saisissable - $1->:=$2-> - // Fixer la sélection après avoir inséré l'entrée du glossaire - $vlFin:=$vlDébut+Length([Dictionnaire]Saisie) - HIGHLIGHT TEXT(vsComments;$vlFin;$vlFin) + // Look for the first available dictionary entry + QUERY([Dictionary];[Dictionary]Entry=$vtHighlightedText+"@") + // Is there one? + If(Records in selection([Dictionary])>0) + // If so, insert it in the shadow text + $shadow->:=Insert text($shadow->;$vlStart;$vlEnd;[Dictionary]Entry) + // Copy the shadow text to the enterable being edited + $area->:=$shadow-> + // Set the selection just after the insert dictionary entry + $vlEnd:=$vlStart+Length([Dictionary]Entry) + HIGHLIGHT TEXT(vsComments;$vlEnd;$vlEnd) Else - // Il n'y a pas d'entrée qui correspond dans le glossaire + // There is no corresponding entry in the Dictionary BEEP End if Else - // Il n'y a pas de texte sélectionné + // There is no highlighted text BEEP End if ``` @@ -213,29 +214,29 @@ La méthode projet chercher\_Glossaire est listée ci-dessous (le point principa La méthode obtenirTexteSelectionne est la suivante : ```4d - // Méthode objet obtenirTexteSelectionne - // obtenirTexteSelectionne ( Alpha ; Entier long ; Entier long ) -> Alpha - // obtenirTexteSelectionne ( Texte ; SelDébut ; SelFin ) -> texte sélectionné - var $0;$1 : Text - var $2;$3 : Integer - If($2<$3) - $0:=Substring($1;$2;$3-$2) + // Get highlighted text project method + // Get highlighted text ( String ; Long ; Long ) -> String + // Get highlighted text ( Text ; SelStart ; SelEnd ) -> highlighted text +#DECLARE ($text : Text ; $start : Integer ; $end : Integer) -> $highlight : Text + If($start<$end) + $highlight:=Substring($text;$start;$end-$start) Else - $0:="" - $2:=$2-1 + $highlight:="" + $start:=$start-1 Repeat - If($2>0) - If(Position($1[[$2]];" ,.!?:;()-_–—")=0) - $0:=$1[[$2]]+$0 - $2:=$2-1 + If($start>0) + If(Position($text[[$start]];" ,.!?:;()-_–—")=0) + $highlight:=$text[[$start]]+$highlight + $start:=$start-1 Else - $2:=0 + $start:=0 End if End if - Until($2=0) + Until($start=0) End if ``` + #### Voir aussi [Form event code](../commands/form-event-code.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md index b1376c9e1e9834..eefd0bed0a9e7d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md @@ -67,7 +67,6 @@ Vous souhaitez obtenir la liste des polices récentes : #### Voir aussi -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) [OBJECT SET FONT](object-set-font.md) [SET RECENT FONTS](set-recent-fonts.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md index f42e6de55350cc..6654cb67beeb86 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md @@ -94,7 +94,6 @@ Résultat : #### Voir aussi -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md index 00b345bbc2630b..6669cee41b318d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md @@ -80,7 +80,6 @@ L'exemple suivant utilise un formulaire décrit dans un fichier .json : #### Voir aussi -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md index f613e1ed0819d0..4a1121a2ad2511 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md @@ -207,6 +207,4 @@ Une fois que cela est implémenté dans votre base, il suffit d'écrire la méth #### Voir aussi -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md index cf6c602a458662..834d0dcbff4269 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md @@ -41,8 +41,10 @@ Si l'objet désigné par le paramètre *objet* n'est pas trouvé dans le formula L'exemple suivant récupère le texte sélectionné dans le champ *\[Produits\]Notes* : ```4d - GET HIGHLIGHT([Produits]Notes;vPremier;vDernier) - If(vPremier
**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" | diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-19/Concepts/classes.md b/i18n/fr/docusaurus-plugin-content-docs/version-19/Concepts/classes.md index 630e5484d9e010..50f3a8fcacd65f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-19/Concepts/classes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-19/Concepts/classes.md @@ -172,7 +172,7 @@ Function
*4D Server only*: Qodly Studio code editor (see (2)) | Éditeur de code Qodly Studio | -| 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 | +| | Qodly Studio in 4D | Qodly Studio in Qodly Cloud platform | +| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | +| Afficher et modifier les tableaux (dataclasses), les attributs et les relations | Éditeur de structure 4D(1) | Éditeur de modèles de Qodly Studio | +| Qodly pages | Qodly Studio Page Editor | Qodly Studio Page Editor | +| Formulaires Desktop | 4D IDE | *non supporté* | +| Langage de programmation | Langage 4D avec ORDA | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) avec ORDA | +| IDE code | 4D IDE code editor *or* VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2)) | Éditeur de code Qodly Studio | +| 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 | (1) If you click on the **Model** button in Qodly Studio, nothing happens.
(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)). 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. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md index fa6a69fc5acd4a..f24b1fe50c15d0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md @@ -13,6 +13,12 @@ Vous pouvez faire défiler le contenu des méthodes, des classes et des fonction L'éditeur de code 4D fournit un contrôle de base des erreurs de syntaxe. Un contrôle d'erreur supplémentaire est effectué lors de l'exécution du code. Pour plus d'informations sur la gestion des erreurs, voir [Débogage](../Debugging/basics.md). +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## Interface ### Toolbar (Barre d’outils) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md index 74db59b179f40f..ac669203c4c8d0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md @@ -55,6 +55,3 @@ Cet exemple crée un tableau interprocess de 50 éléments de type [Texte](# "Un End for ``` -#### Voir aussi - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md index 94a437d09a0c46..2b760ffa61e7ba 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md @@ -30,6 +30,5 @@ Si, par exemple, vous travaillez avec la base MesCDs qui se trouve dans le dossi #### Voir aussi -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md index b329ca321a7c29..8c7fe13040641d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md @@ -93,5 +93,4 @@ La méthode objet de la list box de gauche (destination) contient le code suivan #### Voir aussi -*\_o\_DRAG AND DROP PROPERTIES* *Présentation du Glisser-Déposer* \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/filter-keystroke.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/filter-keystroke.md index 4e61bcec799417..779d94e78b6850 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/filter-keystroke.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/filter-keystroke.md @@ -22,7 +22,7 @@ displayed_sidebar: docs Si vous passez une chaîne vide, le filtrage clavier en cours est annulé. -Vous appelez généralement **FILTER KEYSTROKE** dans une méthode formulaire ou objet lorsque vous gérez l'événement formulaire On Before Keystroke . Pour détecter les événements de frappe clavier, utilisez la commande [Form event code](form-event-code.md). Pour récupérer les caractères saisis au clavier, utilisez les fonctions [Keystroke](keystroke.md) ou [Get edited text](get-edited-text.md). +Vous appelez généralement **FILTER KEYSTROKE** dans une méthode formulaire ou objet lorsque vous gérez l'événement formulaire On Before Keystroke . Pour détecter les événements de frappe clavier, utilisez la commande [Form event code](../commands/form-event-code.md). Pour récupérer les caractères saisis au clavier, utilisez les fonctions [Keystroke](keystroke.md) ou [Get edited text](get-edited-text.md). **IMPORTANT :** Si vous voulez effectuer des opérations “à la volée” en fonction de la valeur courante de la zone saisissable en cours de modification ainsi que du caractère à saisir, rappelez-vous que le texte affiché à l'écran n'est pas encore la valeur du champ ou de la variable. La valeur saisie dans une variable ou un champ ne lui est affectée que lorsque la zone est validée (lorsque l'utilisateur appuie sur la touche **Tabulation**, clique sur un bouton, etc.). En conséquence, pensez à placer les valeurs saisies dans une variable temporaire et à travailler avec celle-ci, puis à assigner cette variable à la zone de saisie (reportez-vous à l'exemple ci-dessous). Vous pouvez également utiliser la fonction [Get edited text](get-edited-text.md). @@ -81,71 +81,68 @@ Vous disposez dans votre application de diverses zones de texte dans lesquelles Comme décrit ci-dessus, lorsque vous éditez une zone de texte, la valeur du champ ou de la variable de texte ne sera réellement modifiée que lorsque que vous l'aurez validée. Pour retrouver et insérer rapidement des entrées du glossaire dans une zone de texte alors qu'elle est en train d'être modifiée, vous devez donc créer une seconde zone "tampon" pour y placer les valeurs saisies. Vous pouvez effectuer cette opération à l'aide de la méthode projet décrite ci-dessous. Vous passez comme premiers paramètres des pointeurs vers la zone de saisie et vers la variable, puis la chaîne de caractère “interdits” comme troisième paramètre. Peu importe comment l'entrée clavier sera traitée, la méthode retourne la valeur saisie originale. Les caractères “interdits” sont les caractères que vous ne voulez pas insérer dans la zone saisissable et que vous voulez traiter en tant que caractères spéciaux. ```4d - // Méthode projet Frappe clavier tampon - // Frappe clavier tampon ( Pointeur ; Pointeur ; Alpha ) -> Alpha - // Frappe clavier tampon ( -> zoneSource ; -> valeurCourante ; Filtre ) -> Ancien frappe clavier - C_STRING(1;$0) - var $1;$2 : Pointer - var $vtNouvValeur : Text - C_STRING(255;$3) - // Retourne la frappe clavier originale - $0:=Keystroke - // Obtenir la sélection de texte dans la zone saisissable - GET HIGHLIGHT($1->;$vlDébut;$vlFin) - // Commencer à travailler sur la valeur courante - $vtNouvValeur:=$2-> - // En fonction de la touche enfoncée ou du caractère saisi, effectuer les actions appropriées + // Shadow keystroke project method + // Shadow keystroke ( Pointer ; Pointer ; String ) -> String + // Shadow keystroke ( -> srcArea ; -> curValue ; Filter ) -> Old keystroke +#DECLARE ($srcArea : Pointer ; $curVal : Pointer ; $filter : Text) -> $old : Text + var $vtNewValue : Text + // Return the original keystroke + $old:=Keystroke + // Get the text selection range within the enterable area + GET HIGHLIGHT($srcArea->;$vlStart;$vlEnd) + // Start working with the current value + $vtNewValue:=$curVal-> + // Depending on the key pressed or the character entered, + // Perform the appropriate actions Case of - // La touche Retour arrière a été enfoncée - :(Character code($0)=Backspace key) - // Supprimer les caractères sélectionnés ou le caractère à gauche du curseur - $vtNouvValeur:=Supprimer texte($vtNouvValeur;$vlDébut;$vlFin) - // Une touche "flèche" a été appuyée - // Ne faites rien sauf accepter la frappe clavier - :(Character code($0)=Left arrow key) - :(Character code($0)=Right arrow key) - :(Character code($0)=Up arrow key) - :(Character code($0)=Down arrow key) + // The Backspace (Delete) key has been pressed + :(Character code($old)=Backspace) + // Delete the selected characters or the character at the left of the text cursor + $vtNewValue:=Delete text($vtNewValue;$vlStart;$vlEnd) + // An Arrow key has been pressed + // Do nothing, but accept the keystroke + :(Character code($old)=Left arrow key) + :(Character code($old)=Right arrow key) + :(Character code($old)=Up arrow key) + :(Character code($old)=Down arrow key) - // Un caractère valide a été saisi - :(Position($0;$3)=0) - $vtNouvValeur:=Inserer texte($vtNouvValeur;$vlDébut;$vlFin;$0) + // An acceptable character has been entered + :(Position($old;$filter)=0) + $vtNewValue:=Insert text($vtNewValue;$vlStart;$vlEnd;$0) Else - // Le caractère n'est pas accepté + // The character is not accepted FILTER KEYSTROKE("") End case - // Retourner la valeur pour la prochaine gestion de la frappe clavier - $2->:=$vtNouvValeur + // Return the value for the next keystroke handling + $curVal->:=$vtNewValue ``` + Cette méthode utilise les sous-méthodes suivantes : ```4d - // Méthode projet Supprimer texte - // Supprimer texte ( Alpha ; Long ; Long ) -> Alpha - // Supprimer texte ( -> Texte ; SelDébut ; SelFin ) -> Nouveau texte - var $0;$1 : Text - var $2;$3 : Integer - $0:=Substring($1;1;$2-1-Num($2=$3))+Substring($1;$3) + // Delete text project method + // Delete text ( String ; Long ; Long ) -> String + // Delete text ( -> Text ; SelStart ; SelEnd ) -> New text +#DECLARE ($src : Text ; $start : Integer ; $end : Integer) -> $new : Text + $new:=Substring($src;1;$start-1-Num($start=$end))+Substring($src;$end) ``` - -```4d - // Méthode projet Inserer texte - // Inserer texte ( Alpha ; Long ; Long ; Alpha ) -> Alpha - // Inserer texte ( -> texteSource ; SelDébut ; SelFin ; Texte à insérer ) -> Nouveau texte - var $0;$1;$4 : Text - var $2;$3 : Integer - $0:=$1 - If($2#$3) - $0:=Substring($0;1;$2-1)+$4+Substring($0;$3) +```4d + // Insert text project method + // Insert text ( String ; Long ; Long ; String ) -> String + // Insert text ( -> srcText ; SelStart ; SelEnd ; Text to insert ) -> New text +#DECLARE ($src : Text ; $start : Integer ; $end : Integer ; $toInsert : Text) -> $new : Text + $new:=$src + If($start # $end) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$end) Else Case of - :($2<=1) - $0:=$4+$0 - :($2>Length($0)) - $0:=$0+$4 + :($start<=1) + $new:=$toInsert+$new + :($start>Length($new)) + $new:=$new+$toInsert Else - $0:=Substring($0;1;$2-1)+$4+Substring($0;$2) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$start) End case End if ``` @@ -153,21 +150,21 @@ Cette méthode utilise les sous-méthodes suivantes : Une fois que vous avez ajouté ces méthodes projet à votre base, vous pouvez les utiliser de la manière suivante : ```4d - // Méthode objet de la zone saisissable vaDescription + // vsDescription enterable area object method Case of :(FORM Event=On Load) - vaDescription:="" - vaDescriptionDouble:="" - // Etablir la liste des caractères “interdits” à traiter comme des touches spéciales - // (Dans cet exemple, seule la touche Aide est filtrée) - vaTouchesSpéciales:=Char(Help key) + vsDescription:="" + vsShadowDescription:="" + // Establish the list of the “forbidden” characters to be treated as special keys + // ( here, in this example, only the Help Key is filtered) + vsSpecialKeys:=Char(HelpKey) :(FORM Event=On Before Keystroke) - $vsKey:=Frappe clavier tampon(->vaDescription;->vaDescriptionDouble;vaTouchesSpéciales) + $vsKey:=Shadow keystroke(->vsDescription;->vsShadowDescription;vsSpecialKeys) Case of :(Character code($vsKey)=Help key) - // Faire quelque chose lorsque la touche Aide est enfoncée - // Dans cet exemple, une saisie de glossaire doit être recherchée et insérée - chercher_Glossaire(->vaDescription;->vaDescriptionDouble) + // Do something when the Help key is pressed + // Here, in this example, a Dictionary entry must be searched and inserted + LOOKUP DICTIONARY(->vsDescription;->vsShadowDescription) End case End case ``` @@ -175,37 +172,41 @@ Une fois que vous avez ajouté ces méthodes projet à votre base, vous pouvez l La méthode projet chercher\_Glossaire est listée ci-dessous (le point principal est l'utilisation de la variable tampon pour réaffecter la zone saisissable à modifier) : ```4d - // Méthode projet chercher_Glossaire - // chercher_Glossaire ( Pointeur ; Pointeur ) - // chercher_Glossaire ( -> zone saisissable ; ->variable double ) - var $1;$2 : Pointer - var $vlDébut;$vlFin : Integer - // Obtenir la sélection de texte dans la zone saisissable - GET HIGHLIGHT($1->;$vlDébut;$vlFin) - // Obtenir le texte sélectionné ou le mot situé à gauche du curseur $vtTexteSelectionne:=obtenirTexteSelectionne ($2->;$vlDébut;$vlFin) - // Y a-t-il quelque chose à rechercher ? - If($vtTexteSelectionne#"") - // Si la sélection de texte était le curseur, la sélection débute au mot situé après le curseur - If($vlDébut=$vlFin) - $vlDébut:=$vlDébut-Length($vtTexteSelectionne) + // LOOKUP DICTIONARY project method + // LOOKUP DICTIONARY ( Pointer ; Pointer ) + // LOOKUP DICTIONARY ( -> Enterable Area ; ->ShadowVariable ) + +#DECLARE ($area : Pointer ; $shadow : Pointer) + var $vlStart;$vlEnd : Integer + + // Get the text selection range within the enterable area + GET HIGHLIGHT($area->;$vlStart;$vlEnd) + // Get the selected text or the word on the left of the text cursor + $vtHighlightedText:=Get highlighted text($shadow->;$vlStart;$vlEnd) + // Is there something to look for? + If($vtHighlightedText#"") + // If the text selection was the text cursor, + // the selection now starts at the word preceeding the text cursor + If($vlStart=$vlEnd) + $vlStart:=$vlStart-Length($vtHighlightedText) End if - // Chercher la première entrée du glossaire disponible - QUERY([Glossaire];[Glossaire]Saisie=$vtTexteSelectionne+"@") - // Existe-t-elle ? - If(Records in selection([Glossaire])>0) - // Si oui, l'insérer dans la zone tampon - $2->:=Inserer texte($2->;$vlDébut;$vlFin;[Glossaire]Saisie) - // Copier le tampon dans la zone saisissable - $1->:=$2-> - // Fixer la sélection après avoir inséré l'entrée du glossaire - $vlFin:=$vlDébut+Length([Dictionnaire]Saisie) - HIGHLIGHT TEXT(vsComments;$vlFin;$vlFin) + // Look for the first available dictionary entry + QUERY([Dictionary];[Dictionary]Entry=$vtHighlightedText+"@") + // Is there one? + If(Records in selection([Dictionary])>0) + // If so, insert it in the shadow text + $shadow->:=Insert text($shadow->;$vlStart;$vlEnd;[Dictionary]Entry) + // Copy the shadow text to the enterable being edited + $area->:=$shadow-> + // Set the selection just after the insert dictionary entry + $vlEnd:=$vlStart+Length([Dictionary]Entry) + HIGHLIGHT TEXT(vsComments;$vlEnd;$vlEnd) Else - // Il n'y a pas d'entrée qui correspond dans le glossaire + // There is no corresponding entry in the Dictionary BEEP End if Else - // Il n'y a pas de texte sélectionné + // There is no highlighted text BEEP End if ``` @@ -213,32 +214,32 @@ La méthode projet chercher\_Glossaire est listée ci-dessous (le point principa La méthode obtenirTexteSelectionne est la suivante : ```4d - // Méthode objet obtenirTexteSelectionne - // obtenirTexteSelectionne ( Alpha ; Entier long ; Entier long ) -> Alpha - // obtenirTexteSelectionne ( Texte ; SelDébut ; SelFin ) -> texte sélectionné - var $0;$1 : Text - var $2;$3 : Integer - If($2<$3) - $0:=Substring($1;$2;$3-$2) + // Get highlighted text project method + // Get highlighted text ( String ; Long ; Long ) -> String + // Get highlighted text ( Text ; SelStart ; SelEnd ) -> highlighted text +#DECLARE ($text : Text ; $start : Integer ; $end : Integer) -> $highlight : Text + If($start<$end) + $highlight:=Substring($text;$start;$end-$start) Else - $0:="" - $2:=$2-1 + $highlight:="" + $start:=$start-1 Repeat - If($2>0) - If(Position($1[[$2]];" ,.!?:;()-_–—")=0) - $0:=$1[[$2]]+$0 - $2:=$2-1 + If($start>0) + If(Position($text[[$start]];" ,.!?:;()-_–—")=0) + $highlight:=$text[[$start]]+$highlight + $start:=$start-1 Else - $2:=0 + $start:=0 End if End if - Until($2=0) + Until($start=0) End if ``` + #### Voir aussi -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [Get edited text](get-edited-text.md) [Is editing text](is-editing-text.md) [Keystroke](keystroke.md) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md index b1376c9e1e9834..eefd0bed0a9e7d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md @@ -67,7 +67,6 @@ Vous souhaitez obtenir la liste des polices récentes : #### Voir aussi -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) [OBJECT SET FONT](object-set-font.md) [SET RECENT FONTS](set-recent-fonts.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md index b4dc4499eaf685..1fb102af630d76 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md @@ -819,7 +819,6 @@ En résultat, le rectangle rouge suit bien le défilement de la list box : #### Voir aussi -*\_o\_DRAG AND DROP PROPERTIES* [CALL SUBFORM CONTAINER](call-subform-container.md) [Current form table](current-form-table.md) [FILTER KEYSTROKE](filter-keystroke.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md index f42e6de55350cc..6654cb67beeb86 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md @@ -94,7 +94,6 @@ Résultat : #### Voir aussi -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md index 00b345bbc2630b..6669cee41b318d 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md @@ -80,7 +80,6 @@ L'exemple suivant utilise un formulaire décrit dans un fichier .json : #### Voir aussi -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md index f613e1ed0819d0..4a1121a2ad2511 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md @@ -207,6 +207,4 @@ Une fois que cela est implémenté dans votre base, il suffit d'écrire la méth #### Voir aussi -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md index cf6c602a458662..834d0dcbff4269 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md @@ -41,8 +41,10 @@ Si l'objet désigné par le paramètre *objet* n'est pas trouvé dans le formula L'exemple suivant récupère le texte sélectionné dans le champ *\[Produits\]Notes* : ```4d - GET HIGHLIGHT([Produits]Notes;vPremier;vDernier) - If(vPremier
[`FORM Convert to dynamic`](../commands-legacy/form-convert-to-dynamic.md)
[`FORM EDIT`](../commands-legacy/form-edit.md)
-[`FORM Event`](../commands-legacy/form-event.md)
-[`Form event code`](../commands-legacy/form-event-code.md)
+[`FORM Event`](../commands/form-event.md)
+[`Form event code`](../commands/form-event-code.md)
[`FORM FIRST PAGE`](../commands-legacy/form-first-page.md)
[`FORM Get color scheme`](../commands-legacy/form-get-color-scheme.md)
[`FORM Get current page`](../commands-legacy/form-get-current-page.md)
diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md index 88c7bae7ca737d..6f1ebbef1db4f5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md @@ -1,7 +1,6 @@ --- id: form-event-code title: Form event code -slug: /commands/form-event-code displayed_sidebar: docs --- @@ -102,7 +101,7 @@ This example is a template for a form method. It shows each of the possible even #### Exemple 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](../commands-legacy/display-selection.md) or [MODIFY SELECTION](../commands-legacy/modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. ```4d //A form method @@ -141,7 +140,7 @@ This example shows the template of a form method that handles the events that ca #### Exemple 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. #### Exemple 6 @@ -342,11 +341,11 @@ As a result, the red rectangle follows the scrolling of the list box: #### Voir également [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md)\ -[Current form table](current-form-table.md)\ -[FILTER KEYSTROKE](filter-keystroke.md)\ +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md)\ +[Current form table](../commands-legacy/current-form-table.md)\ +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md)\ [FORM Event](form-event.md)\ -[Get edited text](get-edited-text.md)\ -[Keystroke](keystroke.md)\ -[POST OUTSIDE CALL](post-outside-call.md)\ -[SET TIMER](set-timer.md) +[Get edited text](../commands-legacy/get-edited-text.md)\ +[Keystroke](../commands-legacy/keystroke.md)\ +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md)\ +[SET TIMER](../commands-legacy/set-timer.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md index 887460886e4f56..4169194a560fee 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md @@ -17,7 +17,7 @@ displayed_sidebar: docs #### Description -**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. Usually, you will use **FORM Event** from within a form or object method. +**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. Usually, you will use **FORM Event** from within a form or object method. **Objet retourné** @@ -99,4 +99,4 @@ The resulting list box when rows are selected: #### Voir également [Form Events](../Events/overview.md) -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md index 55dfeda68bde9f..845e9f37831a4b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md @@ -927,7 +927,7 @@ où : | Inclus parmi | IN | Retourne les données égales à au moins une des valeurs d'une collection ou d'un ensemble de valeurs, prend en charge le joker de recherche (@) | | Contient mot-clé | % | Les mots-clés peuvent être utilisés avec les attributs de type texte ou image | -* **value** : valeur à comparer à la valeur courante de l'attribut de chaque entité de la sélection ou élément de la collection. Peut être un **placeholder** (voir **Utiliser des placeholders** ci-dessous) ou toute expression correspondant à la propriété du type de donnée. Lorsque vous utilisez une valeur constante, les règles suivantes doivent être respectées : +* **value** : valeur à comparer à la valeur courante de l'attribut de chaque entité de la sélection ou élément de la collection. Peut être un **placeholder** (voir **Utiliser des placeholders** ci-dessous) ou toute expression correspondant à la propriété du type de donnée. Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20. Lorsque vous utilisez une valeur constante, les règles suivantes doivent être respectées : * Les valeurs constantes de type **texte** peuvent être passées avec ou sans guillemets (voir **Utilisation des guillemets** ci-dessous). Pour rechercher une chaîne dans une chaîne (recherche de type "contient"), utilisez le symbole joker (@) dans valeur pour isoler la chaîne à chercher, comme dans cet exemple : "@Smith@". Les mots-clés suivants sont interdits pour des constantes de type texte : true, false. * Valeurs constantes de type**booléen**: **true** or **false** (sensible à la casse). * Valeurs constantes de type **numérique** : les décimales doivent être séparées par un '.' diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/EntityClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/EntityClass.md index e45efb37f88504..43b88e3318a88c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/EntityClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/EntityClass.md @@ -92,8 +92,10 @@ $myEntity.save() //sauvegarder l'entity #### Description -La fonction `clone()` crée en mémoire une nouvelle entité référençant le même enregistrement que l'entité d'origine. Cette fonction vous permet de mettre à jour des entités séparément. -> A noter que toute modification apportée aux entités n'est stockée dans l'enregistrement référencé qu'au moment où la fonction [`.save( )`](#save) est exécutée. +La fonction `clone()` crée en mémoire une nouvelle entité référençant le même enregistrement que l'entité d'origine. + +This function allows you to update entities separately. Notez cependant que, pour des raisons de performance, la nouvelle entité partage la même référence d'attributs d'objets que l'entité clonée. +> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed. Cette fonction ne peut être utilisée qu'avec des entités déjà enregistrées dans la base de données. Elle ne peut pas être appelée sur une entité nouvellement créée (pour laquelle [`.isNew()`](#isnew) retourne **True**). @@ -232,7 +234,7 @@ $diff2: vCompareResult3:=$e1.diff($e2;$e1.touchedAttributes()) ``` -vCompareResult1 (toutes les différences sont retournées) : +vCompareResult3 (seules les différences sur les attributs touchés de $e1 sont retournées) ```4d [ @@ -281,7 +283,7 @@ vCompareResult2 (seules les différences sur $attributesToInspect sont retourné ] ``` -vCompareResult3 (seules les différences sur les attributs touchés de $e1 sont retournées) +vCompareResult1 (toutes les différences sont retournées) : ```4d [ @@ -443,7 +445,7 @@ Même exemple avec l'option `dk force drop if stamp changed` : La fonction `.first()` retourne une référence vers l'entité en première position dans l'entity selection à laquelle appartient l'entité. -Si l'entité n'appartient à aucune entity selection (i.e. [.getSelection( )](#getselection) retourne Null), la fonction renvoie une valeur Null. +| #### Exemple @@ -887,7 +889,7 @@ La fonction `.isNew()` renvoie Vrai si La fonction `.last()` retourne une référence vers l'entité en dernière position dans l'entity selection à laquelle appartient l'entité. -Si l'entité n'appartient à aucune entity selection (i.e. [.getSelection( )](#getselection) retourne Null), la fonction renvoie une valeur Null. +Pour plus d'informations, veuillez consulter la section [Verrouillage d'une entité](ORDA/entities.md#verrouillage-d-une-entite). #### Exemple @@ -1043,7 +1045,7 @@ Exemple avec option `dk reload if stamp changed` : La fonction `.next()` retourne une référence vers l'entité suivante dans l'entity selection à laquelle appartient l'entité. -Si l'entité n'appartient à aucune entity selection existante (i.e. [.getSelection()](#getselection) retourne Null), la fonction renvoie une valeur Null. +| S'il n'y a pas d'entité suivante valide dans l'entity selection (i.e. vous êtes sur la dernière entité de la sélection), la fonction retourne Null. Si l'entité suivante a été supprimée, la fonction renvoie l'entité valide suivante (et finalement Null). @@ -1085,9 +1087,9 @@ S'il n'y a pas d'entité suivante valide dans l'entity selection (i.e. vous ête La fonction `.previous()` retourne une référence vers l'entité précédente dans l'entity selection à laquelle appartient l'entité. -Si l'entité n'appartient à aucune entity selection existante (i.e. [.getSelection()](#getselection) retourne Null), la fonction renvoie une valeur Null. +| -S'il n'y a pas d'entité précédente valide dans l'entity selection (i.e. vous êtes sur la première entité de la sélection), la fonction retourne Null. Si l'entité précédente a été supprimée, la fonction retourne l'entité précédente valide (et finalement Null). +Si l'entité n'appartient à aucune entity selection (i.e. [.getSelection( )](#getselection) retourne Null), la fonction renvoie une valeur Null. #### Exemple @@ -1232,7 +1234,7 @@ Les valeurs suivantes peuvent être retournées dans les propriétés `status` e | Constante | Valeur | Commentaire | | ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `dk status automerge failed` | 6 | (Uniquement si l'option `dk auto merge` est utilisée) Echec du mécanisme de merge automatique lors de la sauvegarde de l'entité. **statusText associé **: "Auto merge failed". | +| `dk status automerge failed` | 6 | vrai si l'action de suppression a été effectuée avec succès, sinon Faux. | | `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 :
**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" | diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20/Concepts/classes.md b/i18n/fr/docusaurus-plugin-content-docs/version-20/Concepts/classes.md index c319c133a8f973..6a2704822de87a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20/Concepts/classes.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20/Concepts/classes.md @@ -182,11 +182,11 @@ Function
履歴
+ +| リリース | 内容 | +| ----- | ------ | +| 20 R8 | クラスを追加 | + +| +| [](#getheader)
| +| [](#getjson)
| +| [](#getpicture)
| +| [](#gettext)
| +| [](#headers)
| +| [](#url)
| +| [](#urlPath)
| +| [](#urlQuery)
| +| [](#verb)
| + +:::note + +A 4D.IncomingMessage object is a [non-sharable](../Concepts/shared.md) object. + +::: + + + +## .getBlob() + +**.getBlob**() : Blob + + + +| 引数 | 型 | | 説明 | +| --- | ---- | --------------------------- | ----------------------------- | +| 戻り値 | BLOB | <- | Body of the request as a Blob | + + + +#### 説明 + +The `.getBlob()` function returns the body of the request as a Blob. + +If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. + + + + + +## .getHeader() + +**.getHeader**( *key* : Text ) : Text + + + +| 引数 | 型 | | 説明 | +| --- | ---- | --------------------------- | ---------------------------- | +| key | Text | -> | Header property to get | +| 戻り値 | Text | <- | Value of the header property | + + + +#### 説明 + +The `.getHeader()` function returns the value of the *key* header. + +:::note + +The *key* parameter is not case sensitive. + +::: + +#### 例題 + +```4d +var $value : Text +var $request : 4D.IncomingMessage +$value := $request.getHeader("content-type") +``` + + + + + +## .getJSON() + +**.getJSON**() : Variant + + + +| 引数 | 型 | | 説明 | +| --- | ------- | --------------------------- | ------------------------------------------ | +| 戻り値 | Variant | <- | JSON resolution of the body of the request | + + + +#### 説明 + +The `.getJSON()` function returns the body of the request as a JSON resolution. + +If the body has not been given as JSON valid content, an error is raised. + + + + + +## .getPicture() + +**.getPicture**() : Picture + + + +| 引数 | 型 | | 説明 | +| --- | ------- | --------------------------- | ------------------------------ | +| 戻り値 | Picture | <- | Body of the request as picture | + + + +#### 説明 + +The `.getPicture()` function returns the body of the request as a picture (in case of a body sent as a picture). + +The content-type must be given in the headers to indicate that the body is a picture. + +:::note + +If the request is built using the [`HTTPRequest` class](HTTPRequestClass.md), the picture must be sent in the body as a Blob with the appropriate content-type. + +::: + +If the body is not received as a valid picture, the function returns null. + + + + + +## .getText() + +**.getText**() : Text + + + +| 引数 | 型 | | 説明 | +| --- | ---- | --------------------------- | --------------------------- | +| 戻り値 | Text | <- | Body of the request as text | + + + +#### 説明 + +The `.getText()` function returns the body of the request as a text value. + +If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. + + + + + +## .headers + +**headers** : Object + +#### 説明 + +The `.headers` property contains the current headers of the incoming message as key/value pairs (strings). + +The `.headers` property is read-only. + +Header names (keys) are lowercased. Note header names are case sensitive. + + + + + +## .url + +**url** : Text + +#### 説明 + +The `.url` property contains the URL of the request without the *IP:port* part and as a string. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". + +The `.url` property is read-only. + +:::note + +The "host" part of the request (*IP:port*) is provided by the [`host` header](#headers). + +::: + + + + + +## .urlPath + +**urlPath** : Collection + +#### 説明 + +The `.urlPath` property contains the URL of the request without the *IP:port* part and as a collection of strings. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. + +The `.urlPath` property is read-only. + + + + + +## .urlQuery + +**urlQuery** : Object + +#### 説明 + +The `.urlQuery` property contains the parameters of the request when they have been given in the URL as key/value pairs. + +The `.urlQuery` property is read-only. + +Parameters can be passed in the URL of requests **directly** or **as JSON contents**. + +#### Direct parameters + +Example: `http://127.0.0.1:8044/myCall?firstname=Marie&id=2&isWoman=true` + +In this case, parameters are received as stringified values in the `urlQuery` property: `urlQuery = {"firstname":"Marie" ,"id":"2" ,"isWoman":"true"}` + +#### JSON contents parameters + +Example: `http://127.0.0.1:8044/myCall/?myparams='[{"firstname": "Marie","isWoman": true,"id": 3}]'`. + +Parameters are passed in JSON format and enclosed within a collection. + +In this case, parameters are received as JSON text in the `urlQuery` property and can be parsed using [`JSON Parse`](../commands-legacy/json-parse.md). + +```4d +//urlQuery.myparams: "[{"firstname": "Marie","isWoman": true,"id": 3}]" +$test:=Value type(JSON Parse($r.urlQuery.myparams))=Is collection) //true +``` + +Special characters such as simple quotes or carriage returns must be escaped. + +Example: `http://127.0.0.1:8044/syntax/?mdcode=%60%60%604d` + +````4d +//urlQuery.mdcode = ```4d +$test:=Length($r.urlQuery.mdcode) //5 +```` + +:::note + +Parameters given in the body of the request using POST or PUT verbs are handled through dedicated functions: [`getText()`](#gettext), [`getPicture()`](#getpicture), [`getBlob()`](#getblob), [`getJSON()`](#getjson). + +::: + + + + + +## .verb + +**verb** : Text + +#### 説明 + +The `.verb` property contains the verb used by the request. + +HTTP and HTTPS request verbs include for example "get", "post", "put", etc. + +The `.verb` property is read-only. + + diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md deleted file mode 100644 index 2d6c3d8e8f89ce..00000000000000 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -id: OutgoingMessageClass -title: OutgoingMessage ---- - -The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. - -一般的に、このクラスは、[`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) キーワードで宣言され、HTTP GET リクエストを処理するように設計された関数の中で使用することができます。 このようなリクエストは、例えば、ファイルのダウンロード、画像の生成、ダウンロードなどの機能を実装するためや、ブラウザを介して任意のコンテンツタイプを受信するために使用されます。 - -このクラアスのインスタンスは4D Server 上にビルドされ、[4D REST サーバー](../REST/gettingStarted.md) によってのみブラウザに送信することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。 - -
履歴
- -| リリース | 内容 | -| ----- | ------ | -| 20 R7 | クラスを追加 | - -| -| [](#headers)
| -| [](#setbody)
| -| [](#setheader)
| -| [](#setstatus)
| -| [](#status)
| - -:::note - -A 4D.OutgoingMessage object is a [non-sharable](../Concepts/shared.md) object. - -::: - - - -## .body - -**body** : any - -#### 説明 - -The `.body` property contains the outgoing message body. `.body` プロパティでは以下のデータ型がサポートされます: - -- text -- blob -- object -- image - -`.body` プロパティは読み書き可能です。 - -`.body` プロパティはまた、[`setBody()`](#setbody) 関数を使用しても設定することができます。この場合、`content-type` ヘッダーは自動的に設定されます。 - - - - - -## .headers - -**headers** : Object - -#### 説明 - -The `.headers` property contains the current headers of the outgoing message as key/value pairs. - -The `.headers` property is read-only. To set a header, use the [`setHeader()`](#setheader) function. - - - - - -## .setBody() - -**.setBody**( *body* : any ) - - - -| 引数 | 型 | | 説明 | -| ---- | --- | -- | ---------------------------- | -| body | any | -> | Body of the outgoing message | - - - -#### 説明 - -The `.setBody()` function sets the outgoing message *body*. - -The following data types are supported in the *body*: - -- Text -- BLOB -- Object -- ピクチャー - -When this function is used, the content-type header is automatically set depending on the *body* type: - -- Content-Type:text/plain if the body is a Text -- Content-Type:application/octet-stream if body is a Blob -- Content-Type:application/json if body is an Object -- Content-Type:image/jpeg, image/gif... if body is an Image - -If *body* is not of a supported value type, an error is returned. - - - - - -## .setHeader() - -**.setHeader**( *key* : Text ; *value* : Text ) - - - -| 引数 | 型 | | 説明 | -| ----- | ---- | -- | ---------------------------- | -| key | Text | -> | Header property to set | -| value | Text | -> | Value of the header property | - - - -#### 説明 - -The `.setHeader()` function sets the outgoing message header *key* with the provided *value*. If both parameters are not Text values, an error is raised. - -When returning a 4D.OutgoingMessage object instance, 4D automatically sets some headers (e.g. `Set-Cookie` with `WASID4D=...` and `4DSID__ProjectName_=....`). - -:::note - -If you set a *value* for the "Content-Type" header *key*, make sure you call this function after the call to [`setBody()`](#setbody), because `setBody()` automatically fills this header. For a list of "Content-Type" header values, please refer to the [`WEB SEND BLOB`](../commands-legacy/web-send-blob.md) documentation. - -::: - - - - - -## .setStatus() - -**.setStatus**( *status* : Integer ) - - - -| 引数 | 型 | | 説明 | -| ------ | ------- | -- | ------------- | -| status | Integer | -> | Status to set | - - - -#### 説明 - -The `.setStatus()` function sets the `status` property with the given *status*. - -If *status* is not an integer value, an error is raised. - -For a list of HTTP status codes, please refer the [HTTP status code list on Wikipedia](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes). - - - - - -## .status - -**status** : Integer - -#### 説明 - -The `.status` property contains the current status of the outgoing message. This property can be set using the [`setStatus()`](setstatus) function. - - diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index 2d6c3d8e8f89ce..5901378f784208 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -5,9 +5,9 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -一般的に、このクラスは、[`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) キーワードで宣言され、HTTP GET リクエストを処理するように設計された関数の中で使用することができます。 このようなリクエストは、例えば、ファイルのダウンロード、画像の生成、ダウンロードなどの機能を実装するためや、ブラウザを介して任意のコンテンツタイプを受信するために使用されます。 +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. このようなリクエストは、例えば、ファイルのダウンロード、画像の生成、ダウンロードなどの機能を実装するためや、ブラウザを介して任意のコンテンツタイプを受信するために使用されます。 -このクラアスのインスタンスは4D Server 上にビルドされ、[4D REST サーバー](../REST/gettingStarted.md) によってのみブラウザに送信することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。 +このクラアスのインスタンスは4D Server 上にビルドされ、[4D REST サーバー](../REST/gettingStarted.md) によってのみブラウザに送信することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。
履歴
@@ -19,7 +19,7 @@ The `4D.OutgoingMessage` class allows you to build messages to be returned by yo ### 例題 -この例題では、`getFile()` 関数は[Datastore クラス](../ORDA/ordaClasses.md#datastore-class) に実装されており、REST リクエストによって[呼び出すことができます](../ORDA/ordaClasses.md#onhttpget-keyword)。 ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: +この例題では、`getFile()` 関数は[Datastore クラス](../ORDA/ordaClasses.md#datastore-class) に実装されており、REST リクエストによって[呼び出すことができます](../ORDA/ordaClasses.md#onhttpget-keyword)。 ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: ```4d Class extends DataStoreImplementation diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md index 6c670594abb75c..8a72e5c840d32c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md @@ -5,9 +5,9 @@ title: クラス ## 概要 -4D ランゲージでは **クラス** の概念がサポートされています。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 +4D ランゲージでは **クラス** の概念がサポートされています。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 -ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 +ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 > 4D におけるクラスモデルは JavaScript のクラスに類似しており、プロトタイプチェーンに基づきます。 @@ -41,7 +41,7 @@ $hello:=$person.sayHello() // "Hello John Doe" ### クラス定義 -4D においてユーザークラスとは、`/Project/Sources/Classes/` フォルダーに保存された専用の [メソッド](methods.md) ファイル (.4dm) によって定義されます。 ファイル名がクラス名になります。 +4D においてユーザークラスとは、`/Project/Sources/Classes/` フォルダーに保存された専用の [メソッド](methods.md) ファイル (.4dm) によって定義されます。 ファイル名がクラス名になります。 ファイル名がクラス名になります。 ファイル名がクラス名になります。 クラスを命名する際には、次のルールに留意してください: @@ -81,6 +81,8 @@ Project フォルダー Project Sources Classes Polygon.4dm - **クラス** カテゴリを選択し、 ボタンをクリックします。 - エクスプローラーウィンドウの下部にあるアクションメニュー、またはクラスグループのコンテキストメニューから **新規クラス...** を選択します。  +  +  - エクスプローラーのホームページのコンテキストメニューより **新規** > **クラス...** を選択します。 #### クラスのコードサポート @@ -96,7 +98,7 @@ Project フォルダー Project Sources Classes Polygon.4dm ## クラスストア -定義されたクラスには、クラスストアよりアクセスすることができます。 クラスストアには次の二つが存在します: +定義されたクラスには、クラスストアよりアクセスすることができます。 定義されたクラスには、クラスストアよりアクセスすることができます。 クラスストアには次の二つが存在します: - [`cs`](../commands/cs.md) - ユーザークラスストア - [`4D`](../commands/4d.md) - ビルトインクラスストア @@ -107,11 +109,11 @@ Project フォルダー Project Sources Classes Polygon.4dm -| 引数 | 型 | | 説明 | | -| ---------- | ------ | ------------------------------ | --------------------------- | ---------------- | -| classStore | Object | ← | プロジェクトまたはコンポーネントのユーザークラスストア | | +| 引数 | 型 | | 説明 | | +| ---------- | ------ | - | --------------------------- | ---------------- | +| classStore | Object | ← | プロジェクトまたはコンポーネントのユーザークラスストア | | -`cs` コマンドは、カレントプロジェクトまたはコンポーネントのユーザークラスストアを返します。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 +`cs` コマンドは、カレントプロジェクトまたはコンポーネントのユーザークラスストアを返します。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 #### 例題 @@ -127,11 +129,11 @@ $instance:=cs.myClass.new() -| 引数 | 型 | | 説明 | | -| ---------- | ------ | ------------------------------ | -------- | ---------------- | -| classStore | Object | ← | 4Dクラスストア | | +| 引数 | 型 | | 説明 | | +| ---------- | ------ | - | -------- | ---------------- | +| classStore | Object | ← | 4Dクラスストア | | -`4D` コマンドは、ビルトイン 4Dクラスのクラスストアを返します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 +`4D` コマンドは、ビルトイン 4Dクラスのクラスストアを返します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 #### 例題 @@ -151,7 +153,7 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) ## Class オブジェクト -プロジェクトにおいてクラスが [定義](#クラス定義) されていれば、それは 4Dランゲージ環境に読み込まれます。 クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: +プロジェクトにおいてクラスが [定義](#クラス定義) されていれば、それは 4Dランゲージ環境に読み込まれます。 クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: - [`name`](API/ClassClass.md#name) 文字列 - [`superclass`](API/ClassClass.md#superclass) オブジェクト (無い場合は null) @@ -197,9 +199,9 @@ There is no ending keyword for function code. The 4D language automatically dete ::: -クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 +クラス関数とは、当該クラスのプロパティです。 クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 クラス関数とは、当該クラスのプロパティです。 クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` structure](shared.md#useend-use) 構文なしで関数を呼び出せるようにできます。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 関数名は [プロパティ名の命名規則](Concepts/identifiers.md#オブジェクトプロパティ) に準拠している必要があります。 @@ -211,17 +213,17 @@ There is no ending keyword for function code. The 4D language automatically dete :::tip -アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 +アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 ::: -関数名のすぐ後に、名前とデータ型を指定して [引数](#引数) を宣言します (戻り値の宣言も可)。 例: +関数名のすぐ後に、名前とデータ型を指定して [引数](#引数) を宣言します (戻り値の宣言も可)。 例: 例: 例: ```4d Function computeArea($width : Integer; $height : Integer)->$area : Integer ``` -クラスメソッド内でオブジェクトインスタンスを参照するには `This` コマンドを使います。 例: +クラスメソッド内でオブジェクトインスタンスを参照するには `This` コマンドを使います。 例: 例: 例: ```4d Function setFullname($firstname : Text; $lastname : Text) @@ -234,9 +236,9 @@ Function getFullname()->$fullname : Text クラス関数の場合には、`Current method name` コマンドは次を返します: `_Windows上で Apple Silicon 用のコードは生成できません_ | Apple Silicon + Intel/AMD 用コード
_2種類のコンパイルコードが生成されます_ | Apple Silicon + Intel/AMD 用コード
_2種類のコンパイルコードが生成されます_ | | **自分のプロセッサ (プロセッサー名)** | Intel/AMD 用コード | Intel/AMD 用コード | Apple Silicon 用コード | -> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 +> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 ### 追加のオプション (互換性) @@ -146,21 +146,21 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ::: -直接型指定モードを有効化するには、**コンパイルパス** メニューで **自動変数定義は行わない (直接型指定)** オプションを選択します。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 +直接型指定モードを有効化するには、**コンパイルパス** メニューで **自動変数定義は行わない (直接型指定)** オプションを選択します。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 -柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 すべての変数が [`var` シンタックス](../Concepts/variables.md#変数の宣言) で宣言されていることと、メソッドや関数のパラメーターが [プロトタイプで](../Concepts/parameters.md) 宣言されていることを確認する必要があります (不足している、または無効な宣言を検出するのに [シンタックスチェック](#シンタックスチェック) 機能が役立ちます)。 +柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 すべての変数が [`var` シンタックス](../Concepts/variables.md#変数の宣言) で宣言されていることと、メソッドや関数のパラメーターが [プロトタイプで](../Concepts/parameters.md) 宣言されていることを確認する必要があります (不足している、または無効な宣言を検出するのに [シンタックスチェック](#シンタックスチェック) 機能が役立ちます)。 ## 警告 警告は、コンパイラーがシンタックスチェックをおこなう際に生成するとメッセージです。 これらのメッセージの目的は、実行時エラーを引き起こす可能性のあるステートメントに注意を向けることです。 警告によりコンパイルが中断されることはありません。 -状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 +状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 ### 警告タブ  -このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 +このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 リストを絞り込むには、**コードとラベルを検索** テキストボックスを使用して、警告ラベルやコードを検索します。 @@ -221,7 +221,7 @@ _1: 変数 $a の再定義 (550.10)_ ### Symbolファイル -コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: +コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: このドキュメントはいくつかの部分に分かれています: #### プロセスおよびインタープロセス変数のリスト @@ -268,7 +268,7 @@ _1: 変数 $a の再定義 (550.10)_ ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。 エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。 これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 @@ -288,7 +288,7 @@ _1: 変数 $a の再定義 (550.10)_ - **特定の行に関連するエラー**: これらのエラーは、コンテキスト (エラーが見つかった行) 内に説明とともに表示されます。 コンパイラーは、データ型やシンタックスに関する矛盾を含む式で見つけると、このタイプのエラーをレポートします。 コンパイラーウィンドウでは、検出された各エラーをダブルクリックすると、該当するメソッドが直接 4Dのコードエディターで開かれ、エラーを含む行が反転表示されます。 -- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: +- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: コンパイラーが全般的なエラーを生成するケースは、次の 2つです: - プロセス変数のデータ型が決定できなかった。 - 異なる 2つのオブジェクトが同じ名称である。 @@ -302,7 +302,7 @@ _1: 変数 $a の再定義 (550.10)_ コード内で間違いがないと思われる箇所に対して範囲チェックを適用したくないときもあります。 具体的には、かなりの回数繰り返されるループに関し、旧式のマシン上でコンパイル済みデータベースを実行すると、範囲チェックにより処理速度が著しく低下するおそれがあります。 関連するコードに誤りがなく、システムエラーを引き起こさないことが確実であれば、範囲チェックをローカル上で無効にすることができます。 -これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: +これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: ```4d // %R- 範囲チェックを無効化 @@ -346,11 +346,11 @@ Apple Silicon用コンパイラーは _Apple M1_ などの Apple Silicon プロ - **macOS マシン**: Apple Silicon用コンパイラーは Apple のマシン上でのみ実行可能です。 - **4D プロジェクトアーキテクチャー**: Apple Silicon用コンパイラーは [プロジェクトアーキテクチャー](architecture.md) を使った 4D開発でのみ利用できます。 -- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 _Clang_ は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 +- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 _Clang_ は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 _Clang_ は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 - Xcode や Developer Tools をマシン上でインストールされた状態で **すでに持っている場合**、それらのバージョンが 4D の要件と合っていることを確認します。 - マシンにインストールされた状態でこれらのツールを **持っていない場合**、Apple Developer の Webサイトからいずれかをダウンロードする必要があります。 -> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 +> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 いずれにせよ、要件が満たされていない場合には、4D の Apple Silicon用コンパイラーが警告を発します。 @@ -358,5 +358,5 @@ Apple Silicon用コンパイラーは _Apple M1_ などの Apple Silicon プロ Apple Silicon用コンパイラーはインクリメンタルコンパイラーです: -- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 +- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 これには時間がかかる可能性がありますが、 一度きりです。 - 以降のコンパイルにおいては、**新規または編集されたメソッド** のみが処理され、コンパイル時間を大幅に短縮します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md index a5522ba34fd5bd..9f5c75a489d96d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md @@ -11,12 +11,25 @@ title: コンポーネント ## インタープリターとコンパイル済みコンポーネント -コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 コンポーネントのパッケージフォルダーには以下のいずれかが含まれます: +Components can be interpreted or [compiled](../Desktop/building.md). -- プロジェクトフォルダー (インタープリターのコンポーネント) -- または .4DZ ファイル (コンパイル済みコンポーネント) +- インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 +- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 -インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 +### Package folder + +The package folder of a component (_MyComponent.4dbase_ folder) can contain: + +- for **interpreted components**: a standard [Project folder](../Project/architecture.md) +- for **compiled components**: + - either a "Contents" folder containing a .4DZ file, a _Resources_ folder, an _Info.plist_ file (recommended architecture) + - or directly a .4DZ file with other folders such as _Resources_. + +:::note + +The "Contents" folder architecture is recommended for components if you want to [notarize](../Desktop/building.md#about-notarization) your applications on macOS. + +::: ## コンポーネントの読み込み diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/overview.md index 65211c04ad119b..fd770e1453e82c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/overview.md @@ -7,7 +7,7 @@ Web やモバイル、デスクトップの運用形態に関わらず、デー ## プロジェクトファイル -4D プロジェクトファイルは 4D または 4D Server で開いて編集します。 4D では、ストラクチャーエディター、コードエディター、フォームエディター、メニューエディターなど、機能の充実したエディターを使ってファイルを扱うことができます。 +4D プロジェクトファイルは 4D または 4D Server で開いて編集します。 With 4D, full-featured editors are available to manage files, including a structure editor, a [Code Editor](../code-editor/write-class-method.md), a [form editor](../FormEditor/formEditor.md), a menu editor... また、人間にも解読可能なテキストファイル (JSON、XML等) 形式で提供されているため、プロジェクトの読み書きは任意のコードエディターでおこなうことも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md index 012a11cb3e1a21..e978e5fa7d90b5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md @@ -77,13 +77,14 @@ BASICモードと同様に、ユーザーは接続時に自分の名前とパス - Webサーバーが、存在しないリソースを要求する URL を受信した場合 - Webサーバーが `4DACTION/`, `4DCGI/` ... で始まる URL を受信した場合 -- Webサーバーがルートアクセス URL を受信したが、ストラクチャー設定または `WEB SET HOME PAGE` コマンドでホームページが設定されていないとき +- when the web server receives a root access URL and no home page has been set in the Settings or by means of the [`WEB SET HOME PAGE`](../commands-legacy/web-set-home-page.md) command - Webサーバーが、セミダイナミックページ内でコードを実行するタグ (`4DSCRIPT`など) を処理した場合。 次の場合には、`On Web Authentication` データベースメソッドは呼び出されません: - Webサーバーが有効な静的ページを要求する URL を受信したとき。 - when the web server receives a URL beginning with `rest/` and the REST server is launched (in this case, the authentication is handled through the [`ds.authentify` function](../REST/authUsers#force-login-mode) or (deprecated) the [`On REST Authentication` database method](REST/configuration.md#using-the-on-rest-authentication-database-method) or [Structure settings](REST/configuration.md#using-the-structure-settings)). +- when the web server receives a URL with a pattern triggering a [custom HTTP Request Handler](http-request-handler.md). ### シンタックス diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index ff577a9b7e401b..c046936e1a7855 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -66,10 +66,11 @@ The handler identifier is the couple [pattern + a verb among the verbs list]. URL patterns can be given as **prefixes** or using **regular expressions**. -- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Prefixes are considered as regular expressions already containing starting and ending `/`.\ - Ex: `"pattern" : "docs"` or `"pattern" : "docs/invoices"` +- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly.\ + Ex: `"regexPattern" : "/docs/**/index.html"` -- To declare a regular expression pattern, use the "regexPattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. +- To declare a prefix pattern, use the "pattern" property name in the HTTPHandlers.json file. Regular expressions patterns are handled directly. + Regular expressions patterns are handled directly.\ Ex: `"regexPattern" : "/docs/**/index.html"` "Pattern" and "regexPattern" properties cannot be used in the same handler definition (in this case, only the "regexPattern" property is taken into account). @@ -251,7 +252,7 @@ Then, the request handler can use this information to trigger appropriate busine ### Output: an instance of the 4D.OutgoingMessage class -The request handler can return an object instance of the [4D.OutGoingMessage class](../API/OutGoingMessageClass.md), i.e. some full web content ready for a browser to handle, such as a file content. +The request handler can return an object instance of the [4D.OutGoingMessage class](../API/OutgoingMessageClass.md), i.e. some full web content ready for a browser to handle, such as a file content. ### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md index 98bcf7e6d63c2f..f92d3dd05e553c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md @@ -55,13 +55,13 @@ You must declare these parameters: ``` -> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 +> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 の呼び出しは許可されず、メソッドの処理を終了します。 ### $url - URL extra data The first parameter ($url) is the URL entered by users in the address area of their web browser, without the host address. -イントラネット接続の場合を見てみましょう。 4D Webサーバーマシンの IPアドレスを 123.4.567.89 とします。 The following table shows the values of $url depending on the URL entered in the web browser: +イントラネット接続の場合を見てみましょう。 4D Webサーバーマシンの IPアドレスを 123.4.567.89 とします。 イントラネット接続の場合を見てみましょう。 4D Webサーバーマシンの IPアドレスを 123.4.567.89 とします。 The following table shows the values of $url depending on the URL entered in the web browser: | Webブラウザーに入力された値 | Value of parameter $url | | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | @@ -75,7 +75,7 @@ The first parameter ($url) is the URL entered by users in the address area of th ### $header - Header and Body of the HTTP request -The second parameter ($header) is the header and the body of the HTTP request sent by the web browser. この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 +The second parameter ($header) is the header and the body of the HTTP request sent by the web browser. この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 アプリケーションでこの情報を使用するには、開発者がヘッダーとボディを解析しなければなりません。 `WEB GET HTTP HEADER` や `WEB GET HTTP BODY` コマンドを使うことができます。 @@ -109,9 +109,9 @@ The $user and $password parameters receive the user name and password entered by **利用法**: URL またはフォームアクション -この URL を使用して、任意の _Param_ テキスト引数とともに _MethodName_ に指定した 4Dプロジェクトメソッドを呼び出すことができます。 The method will receive this parameter. +この URL を使用して、任意の _Param_ テキスト引数とともに _MethodName_ に指定した 4Dプロジェクトメソッドを呼び出すことができます。 The method will receive this parameter. The method will receive this parameter. -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。 属性がチェックされていない場合、Webリクエストは拒否されます。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 - `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -120,13 +120,13 @@ The $user and $password parameters receive the user name and password entered by Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インタフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 #### 例題 -この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: +この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: スタティック HTMLページに以下のコードを記述します: ```html
_4D Server のみ_: Qodly Studio コードエディター ((2) 参照) | Qodly Studio コードエディター | -| デバッガー | 4D IDE デバッガー
_4D Serverのみ_: Qodly Studio デバッガー ([この段落](#4d-server-で-qodlyデバッガーを使用する) を参照ください) | Qodly Studio デバッガー | -| REST/Web ロールとアクセス権 | roles.json の直接編集 / Qodly Studio ロールとアクセス権エディター | Qodly Studio ロールとアクセス権エディター | +| | 4D の Qodly Studio | Qodly Cloud プラットフォームの Qodly Studio | +| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | +| テーブル (データクラス)、フィールド (属性)、リレーションの表示および編集 | 4Dストラクチャーエディター(1) | Qodly Studio Model Editor | +| Qodlyページ | Qodly Studio ページエディター | Qodly Studio ページエディター | +| デスクトップフォーム | 4D IDE | _サポートされていません_ | +| プログラミング言語 | 4Dランゲージ (ORDA を使用) | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) (ORDA含) | +| コーディング IDE | 4D IDE code editor _or_ VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
_4D Server only_: Qodly Studio code editor (see (2)) | Qodly Studio コードエディター | +| デバッガー | 4D IDE デバッガー
_4D Serverのみ_: Qodly Studio デバッガー ([この段落](#4d-server-で-qodlyデバッガーを使用する) を参照ください) | Qodly Studio デバッガー | +| REST/Web ロールとアクセス権 | roles.json の直接編集 / Qodly Studio ロールとアクセス権エディター | Qodly Studio ロールとアクセス権エディター | (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)). 4Dシングルユーザーの場合、Qodly Studio で 4Dコードを開くと、シンタックスの配色がサポートされておらず、"Lsp not loaded" という警告が表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png index de58a3d1eb1733..0afc8cd3cd6be1 100644 Binary files a/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png and b/i18n/ja/docusaurus-plugin-content-docs/current/assets/en/Admin/buildapposxcertProj.png differ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md index 6f2ebf185a93cb..d61d6ff01372de 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/code-editor/write-class-method.md @@ -13,6 +13,12 @@ title: コードエディター 4Dのコードエディターは基本的なシンタックスチェック機能を提供します。 メソッド実行時には追加のエラーチェックがおこなわれます。 エラーハンドリングについての詳細は、[デバッガー](../Debugging/basics.md) の章を参照ください。 +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## インターフェース ### ツールバー diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md index 336b1961180015..cc642b048bc19e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/array-text.md @@ -57,6 +57,3 @@ ARRAY TEXTを既存の配列に適用する場合、 End for ``` -#### 参照 - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md index a04218acb62f75..04e1b58859d18d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/data-file.md @@ -30,6 +30,5 @@ Macintosh上 #### 参照 -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md index a533c2b1459c05..84d14ac78b4273 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/drop-position.md @@ -94,5 +94,4 @@ displayed_sidebar: docs #### 参照 -*\_o\_DRAG AND DROP PROPERTIES* *ドラッグ＆ドロップ* \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md index 4f71b321d08f3f..07eb662e3fd8e8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/filter-keystroke.md @@ -89,39 +89,37 @@ FILTER KEYSTROKE は以下の目的で使用できます: // Shadow keystroke project method // Shadow keystroke ( Pointer ; Pointer ; String) -> String // Shadow keystroke ( -> srcArea ; -> curValue ; Filter ) -> Old keystroke - C_STRING(1;$0) - var $1;$2 : Pointer + #DECLARE ($srcArea : Pointer ; $curVal : Pointer ; $filter : Text) -> $old : Text var $vtNewValue : Text - C_STRING(255;$3) // 元のキーストロークを返す - $0:=Keystroke + $old:=Keystroke // 入力エリア中で選択されている文字範囲を取得する - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($srcArea->;$vlStart;$vlEnd) // 現在値を処理する - $vtNewValue:=$2-> + $vtNewValue:=$curVal-> // 押されたキーまたは入力された文字に基づき、 // 適切な処理を行う Case of // (Delete) キーが押された - :(Character code($0)=Backspace) + :(Character code($old)=Backspace) // 選択されている文字あるいはカーソルの左の文字を削除 $vtNewValue:=Delete text($vtNewValue;$vlStart;$vlEnd) // 矢印キーが押されたら // 何も行わずキーストロークを受け入れる - :(Character code($0)=Left arrow key) - :(Character code($0)=Right arrow key) - :(Character code($0)=Up arrow key) - :(Character code($0)=Down arrow key) + :(Character code($old)=Left arrow key) + :(Character code($old)=Right arrow key) + :(Character code($old)=Up arrow key) + :(Character code($old)=Down arrow key) // 入力を許可する文字が入力された - :(Position($0;$3)=0) + :(Position($old;$filter)=0) $vtNewValue:=Insert text($vtNewValue;$vlStart;$vlEnd;$0) Else // 入力を許可しない FILTER KEYSTROKE("") End case // 次のキーストローク処理のために値を返す - $2->:=$vtNewValue + $curVal->:=$vtNewValue ``` このメソッドは以下のサブメソッドを使用します: @@ -130,26 +128,24 @@ FILTER KEYSTROKE は以下の目的で使用できます: // Delete text プロジェクトメソッド // Delete text ( String; Long ; Long ) -> String // Delete text ( -> Text ; SelStart ; SelEnd ) -> New text - var $0;$1 : Text - var $2;$3 : Integer - $0:=Substring($1;1;$2-1-Num($2=$3))+Substring($1;$3) + #DECLARE ($src : Text ; $start : Integer ; $end : Integer) -> $new : Text + $new:=Substring($src;1;$start-1-Num($start=$end))+Substring($src;$end) ``` ```4d // Insert text プロジェクトメソッド // Insert text ( String; Long ; Long ; String) -> String // Insert text ( -> srcText ; SelStart ; SelEnd ; Text to insert ) -> New text - var $0;$1;$4 : Text - var $2;$3 : Integer - $0:=$1 - If($2#$3) - $0:=Substring($0;1;$2-1)+$4+Substring($0;$3) + #DECLARE ($src : Text ; $start : Integer ; $end : Integer ; $toInsert : Text) -> $new : Text + $new:=$src + If($start # $end) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$end) Else Caes of - :($2<=1) - $0:=$4+$0 - :($2>Length($0)) - $0:=$0+$4 + :($start<=1) + $new:=$toInsert+$new + :($start>Length($new)) + $new:=$new+$toInsert Else $0:=Substring($0;1;$2-1)+$4+Substring($0;$2) End case @@ -185,13 +181,13 @@ LOOKUP DICTIONARYプロジェクトメソッドは以下のようなものです // LOOKUP DICTIONARY ( Pointer ; Pointer ) // LOOKUP DICTIONARY ( -> Enterable Area ; ->ShadowVariable ) - var $1;$2 : Pointer + #DECLARE ($area : Pointer ; $shadow : Pointer) var $vlStart;$vlEnd : Integer // 入力エリアの選択範囲を取得 - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($area->;$vlStart;$vlEnd) // 選択されたテキストあるいはカーソルの左側の単語を取得 - $vtHighlightedText:=Get highlighted text($2->;$vlStart;$vlEnd) + $vtHighlightedText:=Get highlighted text($shadow->;$vlStart;$vlEnd) // 検索すべきものがあるか If($vtHighlightedText#"") // テキストセレクションがカーソルなら @@ -204,9 +200,9 @@ LOOKUP DICTIONARYプロジェクトメソッドは以下のようなものです // 存在するか If(Records in selection([Dictionary])>0) // 存在すればシャドウテキストに挿入する - $2->:=Insert text($2->;$vlStart;$vlEnd;[Dictionary]Entry) + $shadow->:=Insert text($shadow->;$vlStart;$vlEnd; // シャドウテキストを編集中のエリアにコピーする - $1->:=$2-> + $area->:=$shadow-> // 挿入した辞書入力の後に選択をセットする $vlEnd:=$vlStart+Length([Dictionary]Entry) HIGHLIGHT TEXT(vsComments;$vlEnd;$vlEnd) @@ -226,23 +222,22 @@ Get highlighted text メソッド: // Get highlighted text プロジェクトメソッド // Get highlighted text ( String; Long ; Long ) -> String // Get highlighted text ( Text ; SelStart ; SelEnd ) -> highlighted text - var $0;$1 : Text - var $2;$3 : Integer - If($2<$3) - $0:=Substring($1;$2;$3-$2) +#DECLARE ($text : Text ; $start : Integer ; $end : Integer) -> $highlight : Text + If($start<$end) + $highlight:=Substring($text;$start;$end-$start) Else - $0:="" - $2:=$2-1 + $highlight:="" + $start:=$start-1 Repeat - If($2>0) - If(Position($1[[$2]];" ,.!?:;()-_")=0) - $0:=$1?$2?+$0 - $2:=$2-1 + If($start>0) + If(Position($text[[$start]];" ,.!?:;()-_–—")=0) + $highlight:=$text[[$start]]+$highlight + $start:=$start-1 Else - $2:=0 + $start:=0 End if End if - Until($2=0) + Until($start=0) End if ``` @@ -251,4 +246,4 @@ Get highlighted text メソッド: [Form event code](../commands/form-event-code.md) [Get edited text](get-edited-text.md) [Is editing text](is-editing-text.md) -[Keystroke](keystroke.md) \ No newline at end of file +[Keystroke](keystroke.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md index 65db7d28342245..4f931ffcaf242a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/font-list.md @@ -68,7 +68,6 @@ Windows環境下では、この原理は4D v15 R4から採用されています #### 参照 -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) *Font Type List* [OBJECT SET FONT](object-set-font.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md index 2ca6dde308533b..cfe626885355ba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-input.md @@ -98,7 +98,6 @@ displayed_sidebar: docs #### 参照 -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md index ca7496243dd016..836064ee4692af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/form-set-output.md @@ -64,7 +64,6 @@ displayed_sidebar: docs #### 参照 -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md index 2418a0b4e134b0..05b0b66d20cd3d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-document-properties.md @@ -203,6 +203,4 @@ displayed_sidebar: docs #### 参照 -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md index 116b5207151037..7298f273ec1f5e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/commands-legacy/get-highlight.md @@ -41,8 +41,10 @@ displayed_sidebar: docs 以下の例題を使用して、フィールド \[Products\]Comments から反転表示された部分を検出します。 ```4d - GET HIGHLIGHT([Products]Comments;vFirst;vLast) - If(vFirst
履歴
-| リリース | 内容 | -| ----- | ----------------------------- | -| 20 R8 | Support of *object* parameter | +| リリース | 内容 | +| ----- | ---------------- | +| 20 R8 | *object* 引数のサポート |履歴
-| リリース | 内容 | -| ----- | -------------------------------- | -| 20 R7 | Support of *sessionID* parameter | +| リリース | 内容 | +| ----- | ------------------- | +| 20 R7 | *sessionID* 引数のサポート |**割り当てられた statusText**: "既にロックされています" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "Other error" (その他のエラー) | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "スタンプが変更されています" | @@ -1058,24 +1060,24 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.reload()` 関数は、 エンティティの中身をメモリ内にリロードします。この時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。 エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 +`.reload()` 関数は、 エンティティの中身をメモリ内にリロードしますこの時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。 エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 **戻り値** `.reload( )` によって返されるオブジェクトには以下のプロパティが格納されます: -| プロパティ | 型 | 説明 | -| ---------------- | ------- | --------------------------------------------------------------- | -| success | boolean | リロードが成功した場合には true、それ以外は false。
***エラーの場合にのみ利用可能***: | -| status(\*) | number | エラーコード、以下参照 | -| statusText(\*) | text | エラーの詳細、以下参照 | +| プロパティ | 型 | 説明 | +| ---------------- | ------- | ---------------------------------------------------------------- | +| success | boolean | リロードが成功した場合には true、それ以外は false。
***エラーの場合にのみ利用可能***: | +| status(\*) | number | エラーコード、以下参照 | +| statusText(\*) | text | エラーの詳細、以下参照 | (\*) エラー時には *Result* オブジェクトの *status* あるいは *statusText* プロパティに以下のいずれかの値が返されます: | 定数 | 値 | 説明 | | ----------------------------------------- | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
***割り当てられた statusText***: "エンティティはもう存在しません" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
***割り当てられた statusText***: "その他のエラー" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
***割り当てられた statusText***: "その他のエラー" | #### 例題 @@ -1122,11 +1124,11 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.save()` 関数は、 エンティティの変更内容を保存します 。変更内容は、データクラスに対応するテーブル内に保存されます。 エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 +`.save()` 関数は、 エンティティの変更内容を保存します 。 変更内容は、データクラスに対応するテーブル内に保存されます。 エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 保存処理は、少なくとも一つのエンティティ属性が "touched" である (更新されている) 場合にのみ実行されます ([`.touched()`](#touched) および [`.touchedAttributes()`](#touchedattributes) 関数参照)。 そうでない場合、関数は何もしません (トリガーは呼び出されません)。 -マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.save()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 +マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.save()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。 これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 *mode* 引数を渡さなかった場合のデフォルトでは、いずれの属性に関わらず同エンティティが他のプロセスまたはユーザーによって変更されていた場合にエラーを返します (以下参照)。 @@ -1150,7 +1152,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ | lockInfo | | object | ロック元についての情報 | | | task_id | number | プロセスID | | | user_name | text | マシン上でのセッションユーザー名 | -| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。それ以外は 4Dディレクトリのユーザー名 | +| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。 それ以外は 4Dディレクトリのユーザー名 | | | host_name | text | マシン名 | | | task_name | text | プロセス名 | | | client_version | text | | @@ -1166,10 +1168,10 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ | 定数 | 値 | 説明 | | ----------------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status automerge failed` | 6 | (`dk auto merge` オプションが使用されたときのみ) エンティティを保存するときに自動マージオプションが失敗しました。
**割り当てられた statusText**: "自動マージ失敗" | +| `dk status automerge failed` | 6 | ロック解除が成功した場合には true、それ以外は false ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success には false が返されます。 | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
**割り当てられた statusText**: "エンティティはもう存在しません" | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "スタンプが変更されています" | #### 例題 1 @@ -1258,7 +1260,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.toObject()` 関数は、 エンティティからビルドされたオブジェクトを返します。 オブジェクト内部のプロパティ名はエンティティの属性名と合致します。 +データクラス属性はすべて、エンティティのプロパティとして利用可能です。 各エンティティのプロパティは、当該。 エンティティの属性値を格納します *filterString* 引数が空の文字列、あるいは "*" の場合、以下のいずれかが返されます: @@ -1268,7 +1270,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ 最初の引数として、取得するエンティティ属性を渡します。 以下のものを渡すことができます: -* *filterString*: プロパティパスをカンマで区切った文字列: "propertyPath1, propertyPath2, ..." または +* リレートエンティティズの一部のプロパティを取得します: * *filterCol*: 文字列のコレクション: \["propertyPath1","propertyPath2";...] filter 引数がリレートエンティティ型の属性を指定する場合 ([kind](DataClassClass.md#attributename) が relatedEntity): @@ -1582,7 +1584,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") #### 説明 -`.touchedAttributes()` 関数は、 メモリに読み込み後に変更されたエンティティの属性名を返します。 +`.toObject()` 関数は、 メモリに読み込み後に変更されたエンティティの属性名を返します。 この関数は、種類 ([kind](DataClassClass.md#attributename)) が `storage` あるいは `relatedEntity` である属性に適用されます。 @@ -1661,7 +1663,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") > 詳細については [エンティティロッキング](ORDA/entities.md#エンティティロッキング) を参照ください。 ロックしているプロセス内のどのエンティティからもレコードが参照されなくなった場合、自動的にレコードロックが解除されます (たとえば、エンティティのローカル参照に対してのみロックがかかっていた場合、プロセスが終了すればエンティティおよびレコードのロックは解除されます)。 -> レコードがロックされている場合、ロックしているプロセスから、ロックされたエンティティ参照に対してロックを解除する必要があります: 例: +> レコードがロックされている場合、ロックしているプロセスから、ロックされたエンティティ参照に対してロックを解除する必要があります: 例: 例: ```4d $e1:=ds.Emp.all()[0] @@ -1690,7 +1692,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") ... // 処理 $status:=$employee.unlock() If($status.success) - ALERT("エンティティのロックは解除されました。") + ALERT("エンティティのロックは解除されました。 ") End if ``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-19/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-19/Concepts/classes.md index 60dd57640a4635..2667359dc91fa8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-19/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-19/Concepts/classes.md @@ -88,8 +88,8 @@ $hello:=$person.sayHello() //"Hello John Doe" - コードエディター: - クラスは実行できません - クラスメソッドはコードのブロックです - - オブジェクトメンバーに対する **定義に移動** 操作はクラスの Function 宣言を探します。例: "$o.f()" の場合、"Function f" を見つけます。 - - クラスのメソッド宣言に対する **参照箇所を検索** 操作は、そのメソッドがオブジェクトメンバーとして使われている箇所を探します。例: "Function f" の場合 "$o.f()" を見つけます。 + - オブジェクトメンバーに対する **定義に移動** 操作はクラスの Function 宣言を探します。 例: "$o.f()" の場合、"Function f" を見つけます。 + - クラスのメソッド宣言に対する **参照箇所を検索** 操作は、そのメソッドがオブジェクトメンバーとして使われている箇所を探します。 例: "Function f" の場合 "$o.f()" を見つけます。 - ランタイムエクスプローラーおよびデバッガーにおいて、クラスメソッドは `
This の値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。
-オブジェクトのメンバーメソッドとして [フォーミュラ](../API/FunctionClass.md) が呼び出された場合、`This` はメソッドの呼び出し元であるオブジェクトを指します。 例:
+オブジェクトのメンバーメソッドとして [フォーミュラ](../API/FunctionClass.md) が呼び出された場合、`This` はメソッドの呼び出し元であるオブジェクトを指します。 例: 例:
```4d
$o:=New object("prop";42;"f";Formula(This.prop))
@@ -749,7 +751,7 @@ $o:=cs.ob.new()
$val:=$o.a //42
```
-> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。
+> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 こちらの [例題](#例題-1) を参照ください。
基本的に、`This` はメソッドの呼び出し元のオブジェクトを指します。
@@ -770,7 +772,7 @@ $val:=$o.f() //8
```
-この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。
+この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。
## クラスコマンド
@@ -790,7 +792,7 @@ $val:=$o.f() //8
## 共有クラス
-**共有クラス** を作成することができます。 共有クラスとは、クラスの [`new()`](../API/ClassClass.md#new) 関数が呼び出されたときに、[共有オブジェクト](shared.md) をインスタンス化するユーザークラスのことを指します。 共有クラスは共有オブジェクトしか作れません。
+**共有クラス** を作成することができます。 **共有クラス** を作成することができます。 共有クラスとは、クラスの [`new()`](../API/ClassClass.md#new) 関数が呼び出されたときに、[共有オブジェクト](shared.md) をインスタンス化するユーザークラスのことを指します。 共有クラスは共有オブジェクトしか作れません。 **共有クラス** を作成することができます。 **共有クラス** を作成することができます。 共有クラスとは、クラスの [`new()`](../API/ClassClass.md#new) 関数が呼び出されたときに、[共有オブジェクト](shared.md) をインスタンス化するユーザークラスのことを指します。 共有クラスは共有オブジェクトしか作れません。 共有クラスは共有オブジェクトしか作れません。
共有クラスは **共有関数** をサポートしています。共有関数は、[`Use...End use`](shared.md#useend-use) 構文なしで呼び出すことができます。
@@ -805,7 +807,7 @@ $val:=$o.f() //8
### 共有クラスの作成
-共有クラスを作成するには、[Class Constructor](#class-constructor) の前に `shared` キーワードを追加します。 例:
+共有クラスを作成するには、[Class Constructor](#class-constructor) の前に `shared` キーワードを追加します。 例: 例: 例:
```4d
// 共有クラス: Person
@@ -824,9 +826,9 @@ cs.Person.isShared // true
### 共有関数
-共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。 しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。
+共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。 しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。
-共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。 例:
+共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。 例: 例: 例:
```4d
// 共有クラス Foo
@@ -845,11 +847,11 @@ shared Function Bar($value : Integer)
## シングルトンクラス
-**シングルトンクラス** とは、インスタンスを一つのみ作成するユーザークラスです。 シングルトンに関する詳細については、[シングルトンに関する Wikipedia のページ](https://ja.wikipedia.org/wiki/Singleton_%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) を参照ください。 シングルトンは、それがインスタンス化されたプロセスにおいて一意のインスタンスを持ち、*共有* シングルトンは、そのマシン上のすべてのプロセスにおいて一意のインスタンスを持ちます。 アプリケーションやプロセス内のどこからでも利用可能な値を定義するのにシングルトンは便利です。
+**シングルトンクラス** とは、インスタンスを一つのみ作成するユーザークラスです。 シングルトンのコンセプトに関する詳細については、[シングルトンに関する Wikipedia のページ](https://ja.wikipedia.org/wiki/Singleton_%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) を参照ください。 シングルトンのコンセプトに関する詳細については、[シングルトンに関する Wikipedia のページ](https://ja.wikipedia.org/wiki/Singleton_%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) を参照ください。 シングルトンに関する詳細については、[シングルトンに関する Wikipedia のページ](https://ja.wikipedia.org/wiki/Singleton_%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) を参照ください。 シングルトンは、それがインスタンス化されたプロセスにおいて一意のインスタンスを持ち、*共有* シングルトンは、そのマシン上のすべてのプロセスにおいて一意のインスタンスを持ちます。 アプリケーションやプロセス内のどこからでも利用可能な値を定義するのにシングルトンは便利です。
-クラスのシングルトンは、初回の [`cs.*Windows上で Apple Silicon 用のコードは生成できません* | Apple Silicon + Intel/AMD 用コード
*2種類のコンパイルコードが生成されます* | Apple Silicon + Intel/AMD 用コード
*2種類のコンパイルコードが生成されます* | | **自分のプロセッサ (プロセッサー名)** | Intel/AMD 用コード | Intel/AMD 用コード | Apple Silicon 用コード | -> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 +> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 ### デフォルトの型指定 @@ -166,13 +166,13 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy 警告は、コンパイラーがシンタックスチェックをおこなう際に生成するとメッセージです。 これらのメッセージの目的は、実行時エラーを引き起こす可能性のあるステートメントに注意を向けることです。 警告によりコンパイルが中断されることはありません。 -状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 +状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 ### 警告タブ  -このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 +このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 リストを絞り込むには、**コードとラベルを検索** テキストボックスを使用して、警告ラベルやコードを検索します。 @@ -233,7 +233,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### Symbolファイル -コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: +コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: このドキュメントはいくつかの部分に分かれています: #### プロセスおよびインタープロセス変数のリスト @@ -280,7 +280,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。 エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。 これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 @@ -300,7 +300,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy - **特定の行に関連するエラー**: これらのエラーは、コンテキスト (エラーが見つかった行) 内に説明とともに表示されます。 コンパイラーは、データ型やシンタックスに関する矛盾を含む式で見つけると、このタイプのエラーをレポートします。 コンパイラーウィンドウでは、検出された各エラーをダブルクリックすると、該当するメソッドが直接 4Dのコードエディターで開かれ、エラーを含む行が反転表示されます。 -- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: +- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: コンパイラーが全般的なエラーを生成するケースは、次の 2つです: - プロセス変数のデータ型が決定できなかった。 - 異なる 2つのオブジェクトが同じ名称である。 @@ -314,7 +314,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy コード内で間違いがないと思われる箇所に対して範囲チェックを適用したくないときもあります。 具体的には、かなりの回数繰り返されるループに関し、旧式のマシン上でコンパイル済みデータベースを実行すると、範囲チェックにより処理速度が著しく低下するおそれがあります。 関連するコードに誤りがなく、システムエラーを引き起こさないことが確実であれば、範囲チェックをローカル上で無効にすることができます。 -これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: +これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: ```4d // %R- 範囲チェックを無効化 @@ -358,11 +358,11 @@ Apple Silicon用コンパイラーは *Apple M1* などの Apple Silicon プロ - **macOS マシン**: Apple Silicon用コンパイラーは Apple のマシン上でのみ実行可能です。 - **4D プロジェクトアーキテクチャー**: Apple Silicon用コンパイラーは [プロジェクトアーキテクチャー](architecture.md) を使った 4D開発でのみ利用できます。 -- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 +- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 - Xcode や Developer Tools をマシン上でインストールされた状態で **すでに持っている場合**、それらのバージョンが 4D の要件と合っていることを確認します。 - マシンにインストールされた状態でこれらのツールを **持っていない場合**、Apple Developer の Webサイトからいずれかをダウンロードする必要があります。 -> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 +> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 いずれにせよ、要件が満たされていない場合には、4D の Apple Silicon用コンパイラーが警告を発します。 @@ -370,5 +370,5 @@ Apple Silicon用コンパイラーは *Apple M1* などの Apple Silicon プロ Apple Silicon用コンパイラーはインクリメンタルコンパイラーです: -- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 +- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 これには時間がかかる可能性がありますが、 一度きりです。 - 以降のコンパイルにおいては、**新規または編集されたメソッド** のみが処理され、コンパイル時間を大幅に短縮します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/Project/components.md index b5db1c6e136f4c..4de02e167329c5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/Project/components.md @@ -11,7 +11,7 @@ title: コンポーネント ## インタープリターとコンパイル済みコンポーネント -コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 コンポーネントのパッケージフォルダーには以下のいずれかが含まれます: +Components can be interpreted or [compiled](../Desktop/building.md). コンポーネントのパッケージフォルダーには以下のいずれかが含まれます: - プロジェクトフォルダー (インタープリターのコンポーネント) - または .4DZ ファイル (コンパイル済みコンポーネント) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md index 8c12fcf12248ad..6c242e6df18960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md @@ -57,7 +57,7 @@ title: HTTPリクエストの処理 ``` -> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 +> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 の呼び出しは許可されず、メソッドの処理を終了します。 ### $1 - URL追加データ @@ -77,7 +77,7 @@ title: HTTPリクエストの処理 ### $2 - HTTPリクエストのヘッダーとボディ -二番目の引数 ($2) は、Webブラウザーから送信された HTTPリクエストのヘッダーとボディです。 この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 +二番目の引数 ($2) は、Webブラウザーから送信された HTTPリクエストのヘッダーとボディです。 この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 アプリケーションでこの情報を使用するには、開発者がヘッダーとボディを解析しなければなりません。 `WEB GET HTTP HEADER` や `WEB GET HTTP BODY` コマンドを使うことができます。 @@ -111,9 +111,9 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ **利用法**: URL またはフォームアクション -この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。 このメソッドは引数を *$1* に受け取ります。 +この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。 The method will receive this parameter. このメソッドは引数を *$1* に受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。 属性がチェックされていない場合、Webリクエストは拒否されます。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 - `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -122,13 +122,13 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インタフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 #### 例題 -この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: +この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: スタティック HTMLページに以下のコードを記述します: ```html
履歴
- -| リリース | 内容 | -| ----- | ------ | -| 20 R7 | クラスを追加 | - -| -| [](#headers)
| -| [](#setbody)
| -| [](#setheader)
| -| [](#setstatus)
| -| [](#status)
| - -:::note - -A 4D.OutgoingMessage object is a [non-sharable](../Concepts/shared.md) object. - -::: - - - -## .body - -**body** : any - -#### 説明 - -The `.body` property contains the outgoing message body. `.body` プロパティでは以下のデータ型がサポートされます: - -- text -- blob -- object -- image - -`.body` プロパティは読み書き可能です。 - -`.body` プロパティはまた、[`setBody()`](#setbody) 関数を使用しても設定することができます。この場合、`content-type` ヘッダーは自動的に設定されます。 - - - - - -## .headers - -**headers** : Object - -#### 説明 - -The `.headers` property contains the current headers of the outgoing message as key/value pairs. - -The `.headers` property is read-only. To set a header, use the [`setHeader()`](#setheader) function. - - - - - -## .setBody() - -**.setBody**( *body* : any ) - - - -| 引数 | 型 | | 説明 | -| ---- | --- | -- | ---------------------------- | -| body | any | -> | Body of the outgoing message | - - - -#### 説明 - -The `.setBody()` function sets the outgoing message *body*. - -The following data types are supported in the *body*: - -- Text -- BLOB -- Object -- ピクチャー - -When this function is used, the content-type header is automatically set depending on the *body* type: - -- Content-Type:text/plain if the body is a Text -- Content-Type:application/octet-stream if body is a Blob -- Content-Type:application/json if body is an Object -- Content-Type:image/jpeg, image/gif... if body is an Image - -If *body* is not of a supported value type, an error is returned. - - - - - -## .setHeader() - -**.setHeader**( *key* : Text ; *value* : Text ) - - - -| 引数 | 型 | | 説明 | -| ----- | ---- | -- | ---------------------------- | -| key | Text | -> | Header property to set | -| value | Text | -> | Value of the header property | - - - -#### 説明 - -The `.setHeader()` function sets the outgoing message header *key* with the provided *value*. If both parameters are not Text values, an error is raised. - -When returning a 4D.OutgoingMessage object instance, 4D automatically sets some headers (e.g. `Set-Cookie` with `WASID4D=...` and `4DSID__ProjectName_=....`). - -:::note - -If you set a *value* for the "Content-Type" header *key*, make sure you call this function after the call to [`setBody()`](#setbody), because `setBody()` automatically fills this header. For a list of "Content-Type" header values, please refer to the [`WEB SEND BLOB`](../commands-legacy/web-send-blob.md) documentation. - -::: - - - - - -## .setStatus() - -**.setStatus**( *status* : Integer ) - - - -| 引数 | 型 | | 説明 | -| ------ | ------- | -- | ------------- | -| status | Integer | -> | Status to set | - - - -#### 説明 - -The `.setStatus()` function sets the `status` property with the given *status*. - -If *status* is not an integer value, an error is raised. - -For a list of HTTP status codes, please refer the [HTTP status code list on Wikipedia](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes). - - - - - -## .status - -**status** : Integer - -#### 説明 - -The `.status` property contains the current status of the outgoing message. This property can be set using the [`setStatus()`](setstatus) function. - - diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md index 2d6c3d8e8f89ce..eea5fdc5a48e59 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/API/OutgoingMessageClass.md @@ -7,7 +7,7 @@ The `4D.OutgoingMessage` class allows you to build messages to be returned by yo 一般的に、このクラスは、[`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) キーワードで宣言され、HTTP GET リクエストを処理するように設計された関数の中で使用することができます。 このようなリクエストは、例えば、ファイルのダウンロード、画像の生成、ダウンロードなどの機能を実装するためや、ブラウザを介して任意のコンテンツタイプを受信するために使用されます。 -このクラアスのインスタンスは4D Server 上にビルドされ、[4D REST サーバー](../REST/gettingStarted.md) によってのみブラウザに送信することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。 +このクラアスのインスタンスは4D Server 上にビルドされ、[4D REST サーバー](../REST/gettingStarted.md) によってのみブラウザに送信することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。 このクラスを使用することで、HTTP 以外のテクノロジー(例: モバイルなど)を使用することができます。
履歴
@@ -19,7 +19,7 @@ The `4D.OutgoingMessage` class allows you to build messages to be returned by yo ### 例題 -この例題では、`getFile()` 関数は[Datastore クラス](../ORDA/ordaClasses.md#datastore-class) に実装されており、REST リクエストによって[呼び出すことができます](../ORDA/ordaClasses.md#onhttpget-keyword)。 ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: +この例題では、`getFile()` 関数は[Datastore クラス](../ORDA/ordaClasses.md#datastore-class) に実装されており、REST リクエストによって[呼び出すことができます](../ORDA/ordaClasses.md#onhttpget-keyword)。 ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: ここでの目的は、**testFile.pdf** ファイルをリクエストへのレスポンスとして返すことです: ```4d Class extends DataStoreImplementation diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Concepts/classes.md index f11e9f89e2f719..1a1460f9ccfcc5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Concepts/classes.md @@ -5,9 +5,9 @@ title: クラス ## 概要 -4D ランゲージでは **クラス** の概念がサポートされています。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 +4D ランゲージでは **クラス** の概念がサポートされています。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 プログラミング言語では、クラスを利用することによって、属性やメソッドなどを持つ特定のオブジェクト種を定義することができます。 -ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 +ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 ユーザークラスが定義されていれば、そのクラスのオブジェクトをコード内で **インスタンス化** することができます。 各オブジェクトは、それ自身が属するクラスのインスタンスです。 クラスは、別のクラスを [継承](#class-extends-classname) することで、その [関数](#function) と、([宣言された](#property) および [計算された](#function-get-と-function-set)) プロパティを受け継ぐことができます。 > 4D におけるクラスモデルは JavaScript のクラスに類似しており、プロトタイプチェーンに基づきます。 @@ -41,7 +41,7 @@ $hello:=$person.sayHello() // "Hello John Doe" ### クラス定義 -4D においてユーザークラスとは、`/Project/Sources/Classes/` フォルダーに保存された専用の [メソッド](methods.md) ファイル (.4dm) によって定義されます。 ファイル名がクラス名になります。 +4D においてユーザークラスとは、`/Project/Sources/Classes/` フォルダーに保存された専用の [メソッド](methods.md) ファイル (.4dm) によって定義されます。 ファイル名がクラス名になります。 ファイル名がクラス名になります。 ファイル名がクラス名になります。 クラスを命名する際には、次のルールに留意してください: @@ -81,6 +81,8 @@ Project フォルダー Project Sources Classes Polygon.4dm - **クラス** カテゴリを選択し、 ボタンをクリックします。 - エクスプローラーウィンドウの下部にあるアクションメニュー、またはクラスグループのコンテキストメニューから **新規クラス...** を選択します。  +  +  - エクスプローラーのホームページのコンテキストメニューより **新規** > **クラス...** を選択します。 #### クラスのコードサポート @@ -96,7 +98,7 @@ Project フォルダー Project Sources Classes Polygon.4dm ## クラスストア -定義されたクラスには、クラスストアよりアクセスすることができます。 クラスストアには次の二つが存在します: +定義されたクラスには、クラスストアよりアクセスすることができます。 定義されたクラスには、クラスストアよりアクセスすることができます。 クラスストアには次の二つが存在します: - [`cs`](../commands/cs.md) - ユーザークラスストア - [`4D`](../commands/4d.md) - ビルトインクラスストア @@ -107,11 +109,11 @@ Project フォルダー Project Sources Classes Polygon.4dm -| 引数 | 型 | | 説明 | | -| ---------- | ------ | ------------------------------ | --------------------------- | ---------------- | -| classStore | Object | ← | プロジェクトまたはコンポーネントのユーザークラスストア | | +| 引数 | 型 | | 説明 | | +| ---------- | ------ | - | --------------------------- | ---------------- | +| classStore | Object | ← | プロジェクトまたはコンポーネントのユーザークラスストア | | -`cs` コマンドは、カレントプロジェクトまたはコンポーネントのユーザークラスストアを返します。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 +`cs` コマンドは、カレントプロジェクトまたはコンポーネントのユーザークラスストアを返します。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 これには、プロジェクトまたはコンポーネントにて [定義](#クラス定義) されている、すべてのユーザークラスが含まれます。 デフォルトでは、 [ORDAクラス](ORDA/ordaClasses.md) のみ利用可能です。 #### 例題 @@ -127,11 +129,11 @@ $instance:=cs.myClass.new() -| 引数 | 型 | | 説明 | | -| ---------- | ------ | ------------------------------ | -------- | ---------------- | -| classStore | Object | ← | 4Dクラスストア | | +| 引数 | 型 | | 説明 | | +| ---------- | ------ | - | -------- | ---------------- | +| classStore | Object | ← | 4Dクラスストア | | -`4D` コマンドは、ビルトイン 4Dクラスのクラスストアを返します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 +`4D` コマンドは、ビルトイン 4Dクラスのクラスストアを返します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 [CryptoKey](API/CryptoKeyClass.md) などの専用 API へのアクセスを提供します。 #### 例題 @@ -151,7 +153,7 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) ## Class オブジェクト -プロジェクトにおいてクラスが [定義](#クラス定義) されていれば、それは 4Dランゲージ環境に読み込まれます。 クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: +プロジェクトにおいてクラスが [定義](#クラス定義) されていれば、それは 4Dランゲージ環境に読み込まれます。 クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: クラスとは、それ自身が ["Class" クラス](API/ClassClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: - [`name`](API/ClassClass.md#name) 文字列 - [`superclass`](API/ClassClass.md#superclass) オブジェクト (無い場合は null) @@ -197,9 +199,9 @@ There is no ending keyword for function code. The 4D language automatically dete ::: -クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 +クラス関数とは、当該クラスのプロパティです。 クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 クラス関数とは、当該クラスのプロパティです。 クラス関数とは、当該クラスのプロパティです。 クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` structure](shared.md#useend-use) 構文なしで関数を呼び出せるようにできます。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 関数名は [プロパティ名の命名規則](Concepts/identifiers.md#オブジェクトプロパティ) に準拠している必要があります。 @@ -211,17 +213,17 @@ There is no ending keyword for function code. The 4D language automatically dete :::tip -アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 +アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass."` とタイプしても、この関数は候補として提示されません 。 ::: -関数名のすぐ後に、名前とデータ型を指定して [引数](#引数) を宣言します (戻り値の宣言も可)。 例: +関数名のすぐ後に、名前とデータ型を指定して [引数](#引数) を宣言します (戻り値の宣言も可)。 例: 例: 例: ```4d Function computeArea($width : Integer; $height : Integer)->$area : Integer ``` -クラスメソッド内でオブジェクトインスタンスを参照するには `This` コマンドを使います。 例: +クラスメソッド内でオブジェクトインスタンスを参照するには `This` コマンドを使います。 例: 例: 例: ```4d Function setFullname($firstname : Text; $lastname : Text) @@ -234,9 +236,9 @@ Function getFullname()->$fullname : Text クラス関数の場合には、`Current method name` コマンドは次を返します: `*Windows上で Apple Silicon 用のコードは生成できません* | Apple Silicon + Intel/AMD 用コード
*2種類のコンパイルコードが生成されます* | Apple Silicon + Intel/AMD 用コード
*2種類のコンパイルコードが生成されます* | | **自分のプロセッサ (プロセッサー名)** | Intel/AMD 用コード | Intel/AMD 用コード | Apple Silicon 用コード | -> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 +> Apple Silicon 用にコンパイルするには、マシンに **Clang** アプリケーションをインストールする必要があります。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 Clang は最新バージョンの Xcode に含まれています。 詳細については [Apple Silicon用コンパイルの要件](#要件) を参照ください。 ### 追加のオプション (互換性) @@ -146,21 +146,21 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ::: -直接型指定モードを有効化するには、**コンパイルパス** メニューで **自動変数定義は行わない (直接型指定)** オプションを選択します。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 +直接型指定モードを有効化するには、**コンパイルパス** メニューで **自動変数定義は行わない (直接型指定)** オプションを選択します。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 このオプションが選択されると、他の互換性オプションは使用できなくなり、表示されなくなります。 -柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 すべての変数が [`var` シンタックス](../Concepts/variables.md#変数の宣言) で宣言されていることと、メソッドや関数のパラメーターが [プロトタイプで](../Concepts/parameters.md) 宣言されていることを確認する必要があります (不足している、または無効な宣言を検出するのに [シンタックスチェック](#シンタックスチェック) 機能が役立ちます)。 +柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 柔軟性と効率性を提供するため、このオプションを使用することが推奨されます。 直接型指定の概念は、すべての要素がコード内の定義されている場所で直接宣言されることを前提としています。 すべての変数が [`var` シンタックス](../Concepts/variables.md#変数の宣言) で宣言されていることと、メソッドや関数のパラメーターが [プロトタイプで](../Concepts/parameters.md) 宣言されていることを確認する必要があります (不足している、または無効な宣言を検出するのに [シンタックスチェック](#シンタックスチェック) 機能が役立ちます)。 ## 警告 警告は、コンパイラーがシンタックスチェックをおこなう際に生成するとメッセージです。 これらのメッセージの目的は、実行時エラーを引き起こす可能性のあるステートメントに注意を向けることです。 警告によりコンパイルが中断されることはありません。 -状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 +状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 状況や使用されるプログラミングスタイルによって、警告の重要性は変化します。 コンパイラーダイアログおよびコードエディター (4Dコードエディターまたは VS Code) にて、警告を有効/無効にすることができます。[警告タブ](#警告タブ) を使えばグローバルに、または [`//%W`](#ローカルに警告を無効化-有効化する) を使用することでローカルに設定できます。 ### 警告タブ  -このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 +このタブでは、どの警告をグローバルに表示するかを定義できます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 警告のリストはコード順で並べられ、ローカライズされたラベルを確認することができます。 リストを絞り込むには、**コードとラベルを検索** テキストボックスを使用して、警告ラベルやコードを検索します。 @@ -221,7 +221,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### Symbolファイル -コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: +コンパイラー設定の [**Symbolファイルを生成**](#symbolファイルを生成) オプションを選択してコンパイルすると、プロジェクトの [Logs フォルダー](Project/architecture.md#logs) 内に `ProjectName_symbols.txt` という名称の Symbolファイルが作成されます。 このドキュメントはいくつかの部分に分かれています: このドキュメントはいくつかの部分に分かれています: #### プロセスおよびインタープロセス変数のリスト @@ -268,7 +268,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 エラーファイルは、プロジェクトの [Logsフォルダー](Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。 エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。 これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 @@ -288,7 +288,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy - **特定の行に関連するエラー**: これらのエラーは、コンテキスト (エラーが見つかった行) 内に説明とともに表示されます。 コンパイラーは、データ型やシンタックスに関する矛盾を含む式で見つけると、このタイプのエラーをレポートします。 コンパイラーウィンドウでは、検出された各エラーをダブルクリックすると、該当するメソッドが直接 4Dのコードエディターで開かれ、エラーを含む行が反転表示されます。 -- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: +- **全般的なエラー**: これらのエラーは、プロジェクトのコンパイルを不可能にします。 コンパイラーが全般的なエラーを生成するケースは、次の 2つです: コンパイラーが全般的なエラーを生成するケースは、次の 2つです: - プロセス変数のデータ型が決定できなかった。 - 異なる 2つのオブジェクトが同じ名称である。 @@ -302,7 +302,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy コード内で間違いがないと思われる箇所に対して範囲チェックを適用したくないときもあります。 具体的には、かなりの回数繰り返されるループに関し、旧式のマシン上でコンパイル済みデータベースを実行すると、範囲チェックにより処理速度が著しく低下するおそれがあります。 関連するコードに誤りがなく、システムエラーを引き起こさないことが確実であれば、範囲チェックをローカル上で無効にすることができます。 -これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: +これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 これをおこなうには、範囲チェックから外すコードを特殊なコメントである `//%R-` と `//%R+` で囲みます。 `//%R-` コメントは範囲チェックを無効にし、`//%R+` はそれを再び有効にします: ```4d // %R- 範囲チェックを無効化 @@ -346,11 +346,11 @@ Apple Silicon用コンパイラーは *Apple M1* などの Apple Silicon プロ - **macOS マシン**: Apple Silicon用コンパイラーは Apple のマシン上でのみ実行可能です。 - **4D プロジェクトアーキテクチャー**: Apple Silicon用コンパイラーは [プロジェクトアーキテクチャー](architecture.md) を使った 4D開発でのみ利用できます。 -- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 +- **Xcode または Developer Tools**: コンパイルの [2つ目のステップ](#インクリメンタルコンパイルラー) において、プロジェクトを C++ コードからコンパイルするために、Apple Silicon用コンパイラーはオープンソース macOS コンパイラー **Clang** を呼び出します。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 *Clang* は Apple ネイティブライブラリを必要とします。これらは **Xcode** または **Developer Tools** パッケージより提供されています。 - Xcode や Developer Tools をマシン上でインストールされた状態で **すでに持っている場合**、それらのバージョンが 4D の要件と合っていることを確認します。 - マシンにインストールされた状態でこれらのツールを **持っていない場合**、Apple Developer の Webサイトからいずれかをダウンロードする必要があります。 -> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 +> インストール手順が簡単なため **Xcode** のインストールを推奨しています。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 よりコンパクトな **Developer Tools** をインストールしても問題ありませんが、こちらはインストール手順がやや複雑です。 いずれにせよ、要件が満たされていない場合には、4D の Apple Silicon用コンパイラーが警告を発します。 @@ -358,5 +358,5 @@ Apple Silicon用コンパイラーは *Apple M1* などの Apple Silicon プロ Apple Silicon用コンパイラーはインクリメンタルコンパイラーです: -- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 +- 初めてのコンパイルにおいては、**すべての 4Dメソッド** がコンパイルされます。 これには時間がかかる可能性がありますが、 一度きりです。 これには時間がかかる可能性がありますが、 一度きりです。 - 以降のコンパイルにおいては、**新規または編集されたメソッド** のみが処理され、コンパイル時間を大幅に短縮します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md index 0b69da42ef29b2..3f60a661a528f9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/components.md @@ -11,7 +11,7 @@ title: コンポーネント ## インタープリターとコンパイル済みコンポーネント -コンポーネントは、インタープリターまたは [コンパイル済み](../Desktop/building.md) のものが使えます。 コンポーネントのパッケージフォルダーには以下のいずれかが含まれます: +Components can be interpreted or [compiled](../Desktop/building.md). コンポーネントのパッケージフォルダーには以下のいずれかが含まれます: - プロジェクトフォルダー (インタープリターのコンポーネント) - または .4DZ ファイル (コンパイル済みコンポーネント) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/overview.md index 65211c04ad119b..fd770e1453e82c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/Project/overview.md @@ -7,7 +7,7 @@ Web やモバイル、デスクトップの運用形態に関わらず、デー ## プロジェクトファイル -4D プロジェクトファイルは 4D または 4D Server で開いて編集します。 4D では、ストラクチャーエディター、コードエディター、フォームエディター、メニューエディターなど、機能の充実したエディターを使ってファイルを扱うことができます。 +4D プロジェクトファイルは 4D または 4D Server で開いて編集します。 With 4D, full-featured editors are available to manage files, including a structure editor, a [Code Editor](../code-editor/write-class-method.md), a [form editor](../FormEditor/formEditor.md), a menu editor... また、人間にも解読可能なテキストファイル (JSON、XML等) 形式で提供されているため、プロジェクトの読み書きは任意のコードエディターでおこなうことも可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/WebServer/httpRequests.md index 8c12fcf12248ad..6c242e6df18960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/WebServer/httpRequests.md @@ -57,7 +57,7 @@ title: HTTPリクエストの処理 ``` -> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 +> インターフェース要素 を表示する 4Dコマンド (`DIALOG`、`ALERT` など) の呼び出しは許可されず、メソッドの処理を終了します。 の呼び出しは許可されず、メソッドの処理を終了します。 ### $1 - URL追加データ @@ -77,7 +77,7 @@ title: HTTPリクエストの処理 ### $2 - HTTPリクエストのヘッダーとボディ -二番目の引数 ($2) は、Webブラウザーから送信された HTTPリクエストのヘッダーとボディです。 この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 +二番目の引数 ($2) は、Webブラウザーから送信された HTTPリクエストのヘッダーとボディです。 この情報は `On Web Connection` データベースメソッドに "そのまま" 渡されることに留意してください。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 その内容は、接続を試みた Webブラウザーの仕様により異なります。 アプリケーションでこの情報を使用するには、開発者がヘッダーとボディを解析しなければなりません。 `WEB GET HTTP HEADER` や `WEB GET HTTP BODY` コマンドを使うことができます。 @@ -111,9 +111,9 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ **利用法**: URL またはフォームアクション -この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。 このメソッドは引数を *$1* に受け取ります。 +この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。 The method will receive this parameter. このメソッドは引数を *$1* に受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。 属性がチェックされていない場合、Webリクエストは拒否されます。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 - `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -122,13 +122,13 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インタフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 #### 例題 -この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: +この例題は、HTMLピクチャーオブジェクトに `/4DACTION/` URL を割り当て、ページ上でピクチャーを動的に表示する方法を説明しています。 スタティック HTMLページに以下のコードを記述します: スタティック HTMLページに以下のコードを記述します: ```html
*4D Server のみ*: Qodly Studio コードエディター ((2) 参照) | Qodly Studio コードエディター | -| デバッガー | 4D IDE デバッガー
*4D Serverのみ*: Qodly Studio デバッガー ([この段落](#4d-server-で-qodlyデバッガーを使用する) を参照ください) | Qodly Studio デバッガー | -| REST/Web ロールとアクセス権 | roles.json の直接編集 / Qodly Studio ロールとアクセス権エディター | Qodly Studio ロールとアクセス権エディター | +| | 4D の Qodly Studio | Qodly Cloud プラットフォームの Qodly Studio | +| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | +| テーブル (データクラス)、フィールド (属性)、リレーションの表示および編集 | 4Dストラクチャーエディター(1) | Qodly Studio Model Editor | +| Qodlyページ | Qodly Studio ページエディター | Qodly Studio ページエディター | +| デスクトップフォーム | 4D IDE | *サポートされていません* | +| プログラミング言語 | 4Dランゲージ (ORDA を使用) | [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) (ORDA含) | +| コーディング IDE | 4D IDE code editor *or* VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2)) | Qodly Studio コードエディター | +| デバッガー | 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" という警告が表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md index 71c1d3d9cc49c6..dd6c687bebde9a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/code-editor/write-class-method.md @@ -13,6 +13,12 @@ title: コードエディター 4Dのコードエディターは基本的なシンタックスチェック機能を提供します。 メソッド実行時には追加のエラーチェックがおこなわれます。 エラーハンドリングについての詳細は、[デバッガー](../Debugging/basics.md) の章を参照ください。 +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## インターフェース ### ツールバー diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md index 336b1961180015..cc642b048bc19e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/array-text.md @@ -57,6 +57,3 @@ ARRAY TEXTを既存の配列に適用する場合、 End for ``` -#### 参照 - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md index a04218acb62f75..04e1b58859d18d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/data-file.md @@ -30,6 +30,5 @@ Macintosh上 #### 参照 -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md index a533c2b1459c05..84d14ac78b4273 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/drop-position.md @@ -94,5 +94,4 @@ displayed_sidebar: docs #### 参照 -*\_o\_DRAG AND DROP PROPERTIES* *ドラッグ＆ドロップ* \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md index 65db7d28342245..4f931ffcaf242a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/font-list.md @@ -68,7 +68,6 @@ Windows環境下では、この原理は4D v15 R4から採用されています #### 参照 -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) *Font Type List* [OBJECT SET FONT](object-set-font.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md index 8a79945a1968f8..826c6576d5ce03 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-event-code.md @@ -840,7 +840,6 @@ On Before Keystroke と On After Keystroke イベントを処理する方法は[ #### 参照 -*\_o\_DRAG AND DROP PROPERTIES* [CALL SUBFORM CONTAINER](call-subform-container.md) [Current form table](current-form-table.md) [FILTER KEYSTROKE](filter-keystroke.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md index 2ca6dde308533b..cfe626885355ba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-input.md @@ -98,7 +98,6 @@ displayed_sidebar: docs #### 参照 -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md index ca7496243dd016..836064ee4692af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/form-set-output.md @@ -64,7 +64,6 @@ displayed_sidebar: docs #### 参照 -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md index 2418a0b4e134b0..05b0b66d20cd3d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-document-properties.md @@ -203,6 +203,4 @@ displayed_sidebar: docs #### 参照 -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md index 116b5207151037..7298f273ec1f5e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands-legacy/get-highlight.md @@ -41,8 +41,10 @@ displayed_sidebar: docs 以下の例題を使用して、フィールド \[Products\]Comments から反転表示された部分を検出します。 ```4d - GET HIGHLIGHT([Products]Comments;vFirst;vLast) - If(vFirst
[`FORM Convert to dynamic`](../commands-legacy/form-convert-to-dynamic.md)
[`FORM EDIT`](../commands-legacy/form-edit.md)
-[`FORM Event`](../commands-legacy/form-event.md)
-[`Form event code`](../commands-legacy/form-event-code.md)
+[`FORM Event`](../commands/form-event.md)
+[`Form event code`](../commands/form-event-code.md)
[`FORM FIRST PAGE`](../commands-legacy/form-first-page.md)
[`FORM Get color scheme`](../commands-legacy/form-get-color-scheme.md)
[`FORM Get current page`](../commands-legacy/form-get-current-page.md)
diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md index f3ade9de37e579..742327808b6ecb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event-code.md @@ -1,7 +1,6 @@ --- id: form-event-code title: Form event code -slug: /commands/form-event-code displayed_sidebar: docs --- @@ -9,9 +8,9 @@ displayed_sidebar: docs -| 引数 | 型 | | 説明 | -| --- | ------- | - | ----------------- | -| 戻り値 | Integer | ← | Form event number | +| 引数 | 型 | | 説明 | +| --- | ------- | - | ---------- | +| 戻り値 | Integer | ← | フォームイベント番号 | @@ -19,18 +18,18 @@ displayed_sidebar: docs #### 説明 -**Form event code** returns a numeric value identifying the type of form event that has just occurred. Usually, you will use **Form event code** from within a form or object method. +**Form event code** コマンドは、現在生成中のフォームイベントタイプを示す数値を返します。 通常フォームメソッドやオブジェクトメソッド内で**Form event code** を使用します。 -4D provides predefined constants (found in the *Form Events* theme) in order to compare the values returned by the **Form event code** command. Certain events are generic (generated for any type of object) and others are specific to a particular type of object. +4DにはForm Eventsテーマで定義された定数が用意されており、**Form event code** コマンドから返される値と比較することができます。 イベントには、一般的なイベント(任意のタイプのオブジェクトに対して生成される)と、特定タイプのオブジェクトのみに発生するイベントがあります。 -For a description of events, please refer to the [**Form Events**](../Events/overview.md) section. +イベントの詳細については[**Form Events**](../Events/overview.md) の章を参照してください。 #### 例題 1 -This example shows the On Validate event being used to automatically assign (to a field) the date that the record is modified: +この例題ではレコード更新日をOn Validateイベントで自動的に(フィールドへ)割り当てる例を示します: ```4d - //Method of a form + // フォームメソッド Case of // ... :(Form event code=On Validate) @@ -40,10 +39,10 @@ This example shows the On Validate event being used to automatically assign (to #### 例題 2 -In this example, the complete handling of a drop-down list (initialization, user clicks, and object release) is encapsulated in the method of the object: +この例題では、ドロップダウンリスト処理 (初期化, ユーザクリック, オブジェクトのリリース) をオブジェクトメソッドにカプセル化します: ```4d - //asBurgerSize Drop-down list Object Method + //asBurgerSize ドロップダウンリストのオブジェクトメソッド Case of :(Form event code=On Load) ARRAY TEXT(asBurgerSize;3) @@ -52,7 +51,7 @@ In this example, the complete handling of a drop-down list (initialization, user asBurgerSize{1}:="Large" :(Form event code=On Clicked) If(asBurgerSize#0) - ALERT("You chose a "+asBurgerSize{asBurgerSize}+" burger.") + ALERT(asBurgerSize{asBurgerSize}+" バーガーが選択されました。") End if :(Form event code=On Unload) CLEAR VARIABLE(asBurgerSize) @@ -61,94 +60,94 @@ In this example, the complete handling of a drop-down list (initialization, user #### 例題 3 -This example is a template for a form method. It shows each of the possible events that can occur when a summary report uses a form as an output form: +この例題はフォームメソッドのテンプレートです。 出力フォームとしてサマリレポートがフォームを使用する際に発生し得るイベントを示しています: ```4d - //Method of a form being used as output form for a summary report + // 概要レポートの出力フォームとして使用されているフォームのフォームメソッド $vpFormTable:=Current form table Case of //... :(Form event code=On Header) - //A header area is about to be printed + // ヘッダエリアの印刷開始 Case of :(Before selection($vpFormTable->)) - //Code for the first break header goes here + // 最初のブレークヘッダ用のコード :(Level=1) - //Code for a break header level 1 goes here + // ヘッダブレークレベル 1 用のコード :(Level=2) - //Code for a break header level 2 goes here + // ヘッダブレークレベル 2 用のコード //... End case :(Form event code=On Printing Detail) - //A record is about to be printed - //Code for each record goes here + // レコードの印刷開始 + // レコード毎のコードを記述 :(Form event code=On Printing Break) - //A break area is about to be printed + // ブレークエリアの印刷開始 Case of :(Level=0) - //Code for a break level 0 goes here + // ブレークレベル0 用のコード :(Level=1) - //Code for a break level 1 goes here + // ブレークレベル1 用のコード //... End case :(Form event code=On Printing Footer) If(End selection($vpFormTable->)) - //Code for the last footer goes here + // 最後のフッタ用のコード Else - //Code for a footer goes here + // フッタ用のコード End if End case ``` #### 例題 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +この例題は[DISPLAY SELECTION](../commands-legacy/display-selection.md) または[MODIFY SELECTION](../commands-legacy/modify-selection.md) で表示されるフォームで発生するイベントを処理するメソッドのテンプレートです。 説明的にするため、フォームウィンドウのタイトルバーにイベントの説明が表示されます: ```4d - //A form method + // フォームメソッド Case of :(Form event code=On Load) - $vsTheEvent:="The form is about to be displayed" + $vsTheEvent:="フォームが表示されようとしている" :(Form event code=On Unload) - $vsTheEvent:="The output form has been exited and is about to disappear from the screen" + $vsTheEvent:="出力フォームを抜け、スクリーンから消えようとしている" :(Form event code=On Display Detail) - $vsTheEvent:="Displaying record #"+String(Selected record number([TheTable])) + $vsTheEvent:="表示中のレコード #"+String(Selected record number([TheTable])) :(Form event code=On Menu Selected) - $vsTheEvent:="A menu item has been selected" + $vsTheEvent:="メニュー項目が選択された" :(Form event code=On Header") - $vsTheEvent:="The header area is about to be drawn" + $vsTheEvent:="ヘッダエリアが描画されようとしている" :(Form event code=On Clicked") - $vsTheEvent:="A record has been clicked" + $vsTheEvent:="レコードがクリックされた" :(Form event code=On Double Clicked") - $vsTheEvent:="A record has been double clicked" + $vsTheEvent:="レコードがダブルクリックされた" :(Form event code=On Open Detail) - $vsTheEvent:="The record #"+String(Selected record number([TheTable]))+" is double-clicked" + $vsTheEvent:="レコード #"+String(Selected record number([TheTable]))+" がダブルクリックされた" :(Form event code=On Close Detail) - $vsTheEvent:="Going back to the output form" + $vsTheEvent:="出力フォームに戻る" :(Form event code=On Activate) - $vsTheEvent:="The form's window has just become the frontmost window" + $vsTheEvent:="フォームのウィンドウが最前面になった" :(Form event code=On Deactivate) - $vsTheEvent:="The form's window is no longer the frontmost window" + $vsTheEvent:="フォームのウィンドウが最前面でなくなった" :(Form event code=On Menu Selected) - $vsTheEvent:="A menu item has been chosen" + $vsTheEvent:="メニュー項目が選択された" :(Form event code=On Outside Call) - $vsTheEvent:="A call from another has been received" + $vsTheEvent:="他のプロセスからの呼び出しを受信した" Else - $vsTheEvent:="What's going on? Event #"+String(Form event) + $vsTheEvent:="発生したイベント #"+String(Form event) End case SET WINDOW TITLE($vsTheEvent) ``` #### 例題 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +[`On Before Keystroke`](../Events/onBeforeKeystroke.md) と [`On After Keystroke`](../Events/onAfterKeystroke.md) イベントを処理する方法は[Get edited text](../commands-legacy/get-edited-text.md)、[Keystroke](../commands-legacy/keystroke.md)、そして[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) コマンドの説明を参照してください。 #### 例題 6 -This example shows how to treat clicks and double clicks in the same way in a scrollable area: +この例題は、スクロールエリアでクリックとダブルクリックを同様に扱う方法を示しています: ```4d - //asChoices scrollable area object method + // asChoices スクロール可能エリアオブジェクトメソッド Case of :(Form event code=On Load) ARRAY TEXT(asChoices;...) @@ -156,7 +155,7 @@ This example shows how to treat clicks and double clicks in the same way in a sc asChoices:=0 :((Form event code=On Clicked)|(Form event code=On Double Clicked)) If(asChoices#0) - //An item has been clicked, do something here + // 項目がクリックされたので、何らかの処理を行う //... End if //... @@ -165,10 +164,10 @@ This example shows how to treat clicks and double clicks in the same way in a sc #### 例題 7 -This example shows how to treat clicks and double clicks using a different response. Note the use of the element zero for keeping track of the selected element: +この例題では、クリックとダブルクリックで異なるレスポンスをする方法を示します。 要素0を使用して選択された項目を追跡していることに注目してください: ```4d - //asChoices scrollable area object method + // asChoices スクロール可能エリアのオブジェクトメソッド Case of :(Form event code=On Load) ARRAY TEXT(asChoices;...) @@ -178,9 +177,9 @@ This example shows how to treat clicks and double clicks using a different respo :(Form event code=On Clicked) If(asChoices#0) If(asChoices#Num(asChoices)) - //A new item has been clicked, do something here + // 新しい項目がクリックされた、何か処理を行う //... - //Save the new selected element for the next time + // 選択された新しい項目を次回のために保存しておく asChoices{0}:=String(asChoices) End if Else @@ -188,7 +187,7 @@ This example shows how to treat clicks and double clicks using a different respo End if :(Form event code=On Double Clicked) If(asChoices#0) - //An item has been double clicked, do something different here + // 項目がダブルクリックされた、別の処理をここで行う End if // ... End case @@ -196,10 +195,10 @@ This example shows how to treat clicks and double clicks using a different respo #### 例題 8 -This example shows how to maintain a status text information area from within a form method, using the [`On Getting Focus`](../Events/onGettingFocus.md) and [`On Losing Focus`](../Events/onLosingFocus.md) events: +この例題では、[`On Getting Focus`](../Events/onGettingFocus.md) と[`On Losing Focus`](../Events/onLosingFocus.md) を使用して、フォームメソッド内でステータス情報を管理します: ```4d - //[Contacts];"Data Entry" form method + //[Contacts];"Data Entry" フォームのフォームメソッド Case of :(Form event code=On Load) var vtStatusArea : Text @@ -208,10 +207,10 @@ This example shows how to maintain a status text information area from within a RESOLVE POINTER(Focus object;$vsVarName;$vlTableNum;$vlFieldNum) If(($vlTableNum#0)&($vlFieldNum#0)) Case of - :($vlFieldNum=1) //Last name field + :($vlFieldNum=1) // Last name フィールド vtStatusArea:="Enter the Last name of the Contact; it will be capitalized automatically" //... - :($vlFieldNum=10) //Zip Code field + :($vlFieldNum=10) // Zip Code フィールド vtStatusArea:="Enter a 5-digit zip code; it will be checked and validated automatically" //... End case @@ -227,13 +226,13 @@ This example shows how to maintain a status text information area from within a この例題では、レコードのデータ入力に使われるフォームで、ウィンドウを閉じるイベントを処理する方法を示します: ```4d - //Method for an input form + // 入力フォームのフォームメソッド $vpFormTable:=Current form table Case of //... :(Form event code=On Close Box) If(Modified record($vpFormTable->)) - CONFIRM("This record has been modified. Save Changes?") + CONFIRM("このレコードは更新されています。保存しますか?") If(OK=1) ACCEPT Else @@ -246,12 +245,12 @@ This example shows how to maintain a status text information area from within a End case ``` -#### Example 10 +#### 例題 10 -This example shows how to capitalize a text or alphanumeric field each time its data source value is modified: +この例題では、文字フィールドが更新されるたびに、1文字目を大文字に、それ以外を小文字に変換する方法を示します: ```4d - //[Contacts]First Name Object method + //[Contacts]First Name オブジェクトメソッド Case of //... :(Form event code=On Data Change) @@ -260,12 +259,13 @@ This example shows how to capitalize a text or alphanumeric field each time its End case ``` -#### Example 11 -The following example illustrates how to manage a deletion action in a hierarchical list: +#### 例題 11 + +以下の例題では階層リストで削除アクションを管理する方法を示します: ```4d - ... //method of hierarchical list + ... // 階層リストのメソッド :(Form event code=On Delete Action) ARRAY LONGINT($itemsArray;0) $Ref:=Selected list items(<>HL;$itemsArray;*) @@ -288,25 +288,25 @@ The following example illustrates how to manage a deletion action in a hierarchi End if ``` -#### Example 12 +#### 例題 12 -In this example, the [`On Scroll`](../Events/onScroll.md) form event allows us to synchronize the display of two pictures in a form. The following code is added in the "satellite" object method (picture field or variable): +この例題では[`On Scroll`](../Events/onScroll.md) フォームイベントを使用してフォーム中の２つのピクチャーを同期します。 以下のコードを"satellite" のオブジェクトメソッド(ピクチャーフィールドまたは変数)に記述します: ```4d Case of :(Form event code=On Scroll) - // we take the position of the left picture + // 左のピクチャーの位置を取得 OBJECT GET SCROLL POSITION(*;"satellite";vPos;hPos) - // and we apply it to the right picture + // 取得した位置を右のピクチャーに適用 OBJECT SET SCROLL POSITION(*;"plan";vPos;hPos;*) End case ``` -Result: https://www.youtube.com/watch?v=YIRfsW1BmHE +結果: https://www.youtube.com/watch?v=YIRfsW1BmHE -#### Example 13 +#### 例題 13 -You want to draw a red rectangle around the selected cell of a list box, and you want the rectangle to move along with the list box if it is scrolled vertically by the user. In the list box object method, you can write: +リストボックスで選択されたセルの周りに赤い長方形を描画し、リストボックスがユーザーによって垂直方向にスクロールされた場合には、その長方形を一緒に移動させたい場合を考えます。 その場合、リストボックスのオブジェクトメソッドに対して以下のように書きます: ```4d Case of @@ -314,18 +314,18 @@ You want to draw a red rectangle around the selected cell of a list box, and you :(Form event code=On Clicked) LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) - OBJECT SET VISIBLE(*;"RedRect";True) //initialize a red rectangle + OBJECT SET VISIBLE(*;"RedRect";True) // 赤い長方形を初期化 OBJECT SET COORDINATES(*;"RedRect";$x1;$y1;$x2;$y2) :(Form event code=On Scroll) LISTBOX GET CELL POSITION(*;"LB1";$col;$raw) LISTBOX GET CELL COORDINATES(*;"LB1";$col;$raw;$x1;$y1;$x2;$y2) OBJECT GET COORDINATES(*;"LB1";$xlb1;$ylb1;$xlb2;$ylb2) - $toAdd:=LISTBOX Get headers height(*;"LB1") //height of the header so as not to overlap it - If($ylb1+$toAdd<$y1)&($ylb2>$y2) //if we are inside the list box - //to keep it simple, we only handle headers - //but we should handle horizontal clipping - //as well as scroll bars + $toAdd:=LISTBOX Get headers height(*;"LB1") // オーバーラップしないためにヘッダーの高さを取得 + If($ylb1+$toAdd<$y1)&($ylb2>$y2) // リストボックス内にいるとき + // 単純化のため、ここではヘッダーのみを扱います + // 実際にはスクロールバーに加え、 + // 水平方向のクリッピングも管理しなければなりません。 OBJECT SET VISIBLE(*;"RedRect";True) OBJECT SET COORDINATES(*;"RedRect";$x1;$y1;$x2;$y2) Else @@ -335,18 +335,18 @@ You want to draw a red rectangle around the selected cell of a list box, and you End case ``` -As a result, the red rectangle follows the scrolling of the list box: +結果として、赤い長方形はリストボックスのスクロールに沿って移動します:  #### 参照 [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md)\ -[Current form table](current-form-table.md)\ -[FILTER KEYSTROKE](filter-keystroke.md)\ +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md)\ +[Current form table](../commands-legacy/current-form-table.md)\ +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md)\ [FORM Event](form-event.md)\ -[Get edited text](get-edited-text.md)\ -[Keystroke](keystroke.md)\ -[POST OUTSIDE CALL](post-outside-call.md)\ -[SET TIMER](set-timer.md) +[Get edited text](../commands-legacy/get-edited-text.md)\ +[Keystroke](../commands-legacy/keystroke.md)\ +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md)\ +[SET TIMER](../commands-legacy/set-timer.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md index 77376c0fe102fe..76b43ccf122c2e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/form-event.md @@ -17,34 +17,34 @@ displayed_sidebar: docs #### 説明 -**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. Usually, you will use **FORM Event** from within a form or object method. +**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred.**FORM Event** returns an object containing information about the form event that has just occurred. 通常、**FORM Event** はフォームメソッドまたはオブジェクトメソッド内にて使用します。 **返されるオブジェクト** -Each returned object includes the following main properties: +返されるオブジェクトは、それぞれ以下のメインのプロパティを格納しています: -| **プロパティ** | **型** | **Description** | -| ----------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | -| code | integer | フォームイベントの数値。 | -| description | text | Name of the form event (*e.g.* "On After Edit"). See the [**Form Events**](../Events/overview.md) section. | +| **プロパティ** | **型** | **Description** | +| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------- | +| objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | +| code | integer | フォームイベントの数値。 | +| description | text | フォームイベント名(例: "On After Edit") 詳細は[**Form Events**](../Events/overview.md) の章を参照してください。 | -For example, in the case of a click on a button, the object contains the following properties: +例えば、ボタンをクリックした場合、オブジェクトには以下のプロパティが格納されています: ```json {"code":4,"description":"On Clicked","objectName":"Button2"} ``` -The event object can contain additional properties, depending on the object for which the event occurs. For *eventObj* objects generated on: +イベントオブジェクトには、イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 これは以下のオブジェクトで生成された*eventObj* オブジェクトが対象です: -- List box or list box column objects, see the *list box documentation on developer.4d.com*. -- 4D View Pro areas, see *On VP Ready form event*. +- リストボックスまたはカラムオブジェクト。詳細は*developer.4d.com でのリストボックスのドキュメント* を参照してください。 +- 4D View Pro エリア。詳細は*On VP Ready フォームイベント* を参照してください。 -**Note:** If there is no current event, **FORM Event** returns a null object. +***注意:*** カレントのイベントが何もない場合、**FORM Event** はnull オブジェクトを返します。 #### 例題 1 -You want to handle the On Clicked event on a button: +ボタン上でOn Clicked イベントを管理したい場合を考えます: ```4d If(FORM Event.code=On Clicked) @@ -54,11 +54,11 @@ You want to handle the On Clicked event on a button: #### 例題 2 -If you set the column object name with a real attribute name of a dataclass like this: +カラムオブジェクト名に、実際のデータクラスの属性名を以下のように設定した場合:  -You can sort the column using the On Header Click event: +On Header Click イベントを使用してカラムをソートすることができます: ```4d Form.event:=FORM Event @@ -72,11 +72,11 @@ You can sort the column using the On Header Click event: #### 例題 3 -You want to handle the On Display Details on a list box object with a method set in the *Meta info expression* property: +リストボックスオブジェクトのOn Display Details イベントが発生したときに、*メタ情報式 プロパティ*に設定したメソッドを実行したい場合を考えます:  -The *setColor* method: +*setColor* メソッドの中身です: ```4d var $event;$0;$meta : Object @@ -92,11 +92,11 @@ The *setColor* method: $0:=$meta ``` -The resulting list box when rows are selected: +その結果、行が選択された際のリストボックスは以下のようになります:  #### 参照 [Form Events](../Events/overview.md) -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/process-activity.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/process-activity.md index 73d848ca5994dd..8817ed658933b9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/process-activity.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/process-activity.md @@ -8,11 +8,11 @@ displayed_sidebar: docs -| 引数 | 型 | | 説明 | -| --------- | ------- | - | -------------------------------------------------------------------------------------- | -| sessionID | Text | → | Session ID | -| options | Integer | → | Return options | -| 戻り値 | Object | ← | Snapshot of running processes and/or (4D Server only) user sessions | +| 引数 | 型 | | 説明 | +| --------- | ------- | - | -------------------------------------------------------------- | +| sessionID | Text | → | セッションID | +| options | Integer | → | 返される情報を指定するオプション | +| 戻り値 | Object | ← | 実行中のプロセスまたはユーザーセッション(4D Serverのみ) のスナップショット | @@ -26,54 +26,54 @@ displayed_sidebar: docs #### 説明 -The **Process activity** command returns a snapshot of running processes and/or (4D Server only) connected user sessions at a given time.The **Process activity** command returns a snapshot of running processes and/or (4D Server only) connected user sessions at a given time. This command returns all processes, including internal processes that are not reachable by the [Process info](process-info.md) command. +The **Process activity** command returns a snapshot of running processes and/or (4D Server only) connected user sessions at a given time.The **Process activity** command returns a snapshot of running processes and/or (4D Server only) connected user sessions at a given time.**Process activity** コマンドは特定の時刻での、実行中のプロセスや接続ユーザーセッション(4D Server のみ) のスナップショットを返します。 このコマンドは、全てのプロセスを返します。これには、[Process info](process-info.md) コマンドでもアクセスできない内部プロセスも含まれます。 このコマンドは、全てのプロセスを返します。これには、[Process info](process-info.md) コマンドでもアクセスできない内部プロセスも含まれます。 -By default when used without any parameters, **Process activity** returns an object containing the following properties: +デフォルトで、引数を渡さずに使用した場合、**Process activity** は以下のプロパティを格納したオブジェクトを返します: -- "processes", a collection of all processes -- "sessions" (4D Server only), a collection of all sessions +- "processes" には全てのプロセスのコレクションが格納されています +- "sessions" (4D Server の場合のみ) には全てのセッションのコレクションが格納されています -On 4D Server, you can filter information to be returned using the optional *sessionID* and *options* parameters: +4D Server では、オプションの*sessionID* および *options* 引数を使用することで、返される情報をフィルターすることができます: -- If you pass a user session ID in the *sessionID* parameter, the command only returns information related to this session. By default if the *options* parameter is omitted, the returned object contains a collection with all processes related to the session and a collection with a single object describing the session. If you pass an invalid session ID, a **null** object is returned. -- You can select the collection(s) to return by passing one of the following constants in the *options* parameter: +- *sessionID* 引数にユーザーセッションID を渡した場合、コマンドはそのセッションに関連した情報のみを返します。 *options* 引数が省略された場合、デフォルトで返されるオブジェクトには、セッションに関連した全てのプロセスのコレクションと、セッションの詳細を説明した単一のオブジェクトを格納したコレクションが格納されています。 無効なセッションID を渡した場合、**null** オブジェクトが返されます。 *options* 引数が省略された場合、デフォルトで返されるオブジェクトには、セッションに関連した全てのプロセスのコレクションと、セッションの詳細を説明した単一のオブジェクトを格納したコレクションが格納されています。 無効なセッションID を渡した場合、**null** オブジェクトが返されます。 +- *options* 引数に以下の定数のいづれか一つを渡すことで、返されるコレクションを選択することができます: -| 定数 | 値 | 説明 | -| ---------------------- | - | -------------------------------------------------------------------------------- | -| Processes and sessions | 0 | Returns both "processes" and "sessions" lists (default value) | -| Processes only | 1 | Returns only the "processes" list | -| Sessions only | 2 | Returns only the "sessions" list | +| 定数 | 値 | 説明 | +| ---------------------- | - | ------------------------------------------------------------------ | +| Processes and sessions | 0 | "processes" および "sessions" の両方の一覧を返します(デフォルト値)。 | +| Processes only | 1 | "processes" の一覧のみを返します。 | +| Sessions only | 2 | "sessions" の一覧のみを返します。 | :::note -When executed on 4D in remote or local mode, `Process activity` always returns the list of running processes (*sessionID* and *options* parameters are ignored). +リモート、あるいはローカルモードの4D で実行された場合、`Process activity` は実行中のプロセスの一覧のみを返します(この場合*sessionID* および *options* 引数は無視されます)。 ::: **Sessions** -The "sessions" property contains a collection of objects describing all running sessions on the server. For a description of session object properties, please refer to the [`Session info`](session-info.md) command. +"sessions" プロパティには、サーバーで実行中の全てのユーザーセッションを記述するオブジェクトのコレクションが格納されます。 セッションオブジェクトのプロパティの詳細については、[`Session info`](session-info.md) コマンドを参照してください。 セッションオブジェクトのプロパティの詳細については、[`Session info`](session-info.md) コマンドを参照してください。 -:::note Notes +:::note 注記 -- You can get the object of a session using the [Session](session.md) command. -- `Process activity` returns remote client sessions, stored procedure session and rest sessions but not Web sessions (limitation). +- セッションのオブジェクトは、[Session](session.md) コマンドを使用することで取得できます。 +- `Process activity` はリモートクライアントセッション、ストアドプロシージャーセッションおよびREST セッションを返しますが、Web セッションは返しません(制約)。 ::: **Processes** -The "processes" property contains a collection of process objects describing all running processes. For a description of process object properties, please refer to the [`Process info`](process-info.md) command. +"process"プロパティには、サーバーで実行中の全てのプロセスを記述するオブジェクトのコレクションが格納されます。 プロセスオブジェクトのプロパティの詳細な情報については、[`Process info`](process-info.md) コマンドを参照してください。 プロセスオブジェクトのプロパティの詳細な情報については、[`Process info`](process-info.md) コマンドを参照してください。 -On the server, the `Process activity` command returns an additional "session" property: +サーバー上では、`Process activity` コマンドは追加の"session" プロパティを返します: -| Additional property | 型 | 説明 | | -| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | - | -| session | Object | The [`.info`](../API/SessionClass.md#info) property of the session in which the process is running. Undefined if the `Processes only` parameter is passed. | | +| 追加のプロパティ | 型 | 説明 | | +| -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- | - | +| session | Object | プロセスが実行中のセッションの[`.info`](../API/SessionClass.md#info) プロパティ。 `Processes only` 引数が渡されていた場合には未定義となります。 `Processes only` 引数が渡されていた場合には未定義となります。 | | #### 例題 1 -You want to get the collection of all user sessions: +全てのユーザーセッションのコレクションを取得したい場合を考えます: ```4d //To be executed on the server @@ -93,10 +93,10 @@ You want to get the collection of all user sessions: #### 例題 2 -You want to get all processes related to the current session: +カレントセッションに関連した全てのプロセスを取得した場合を考えます: ```4d - // to be executed on the server + // サーバー側で実行すること var $sessionID : Text:=Session.id var $o : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/session-info.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/session-info.md index ca64b52a5a3cd6..4e42454fd8e371 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/session-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/session-info.md @@ -18,7 +18,7 @@ displayed_sidebar: docs | 引数 | 型 | | 説明 | | --------- | ------- | :-: | ----------------------------- | -| sessionID | Integer | → | Session ID | +| sessionID | Integer | → | セッションID | | 戻り値 | Object | ← | Information about the session | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/super.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/super.md index 660c3e4239e768..168c0915a47981 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/super.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/super.md @@ -19,7 +19,7 @@ displayed_sidebar: docs `Super` は次の 2つの目的のために使います: -1. Inside a [constructor code]((../Concepts/classes.md#class-constructor), `Super` is a command that allows to call the constructor of the superclass. When used in a constructor, the `Super` command appears alone and must be used before the [`This`](this.md) keyword is used. +1. `Square` クラスには、スーパークラスメソッドを呼び出すメンバーメソッドを定義します: When used in a constructor, the `Super` command appears alone and must be used before the [`This`](this.md) keyword is used. - 継承ツリーにおいて、すべてのクラスコンストラクターが正しく呼び出されていない場合には、エラー -10748 が生成されます。 呼び出しが有効であることを確認するのは、開発者の役目となります。 - スーパークラスがコンストラクトされるより先に、`This` コマンドを使った場合には、エラー -10743 が生成されます。 @@ -41,7 +41,7 @@ Super.doSomething(42) // スーパークラスにて宣言されている #### 例題 1 -クラスコンストレクター内で `Super` を使う例です。 `Rectangle` と `Square` クラス の共通要素がコンストラクター内で重複しないよう、このコマンドを呼び出します。 +クラスコンストレクター内で `Super` を使う例です。 クラスコンストレクター内で `Super` を使う例です。 `Rectangle` と `Square` クラス の共通要素がコンストラクター内で重複しないよう、このコマンドを呼び出します。 ```4d // Class: Rectangle diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/this.md b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/this.md index b9d0a18bf5dfec..9fd993db32dc1e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/this.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20-R7/commands/this.md @@ -45,7 +45,7 @@ $o:=cs.ob.new() $val:=$o.a //42 ``` -> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 See [this example](super.md#example-1). +> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` より先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 See [this example](super.md#example-1). 基本的に、`This` はメソッドの呼び出し元のオブジェクトを指します。 @@ -66,7 +66,7 @@ $val:=$o.f() //8 ``` -この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。 +この例では、変数 $o に代入されたオブジェクトは *f* プロパティを持たないため、これをクラスより継承します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。 *f* は $o のメソッドとして呼び出されるため、メソッド内の `This` は $o を指します。 #### フォーミュラオブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md index a613ad8b6b9a8b..ca5f27bb56e5bb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md @@ -927,7 +927,7 @@ attributePath|formula 比較演算子 値 | 含まれる | IN | コレクション、あるいは複数の値のうち、どれか一つの値と等しいデータを取得します。ワイルドカード (@) をサポートします。 | | キーワードを含む | % | キーワードは、文字列あるいはピクチャー型の属性内で使用されるものが対象です。 | -* **値**: コレクションの各要素、あるいはエンティティセレクションの各エンティティのプロパティのカレント値に対して比較する値。 **プレースホルダー** (後述の **プレースホルダーの使用** 参照) か、あるいはデータ型プロパティと同じ型の式を使用することができます。 定数値を使用する場合、以下の原則に従う必要があります: +* **値**: コレクションの各要素、あるいはエンティティセレクションの各エンティティのプロパティのカレント値に対して比較する値。 **プレースホルダー** (後述の **プレースホルダーの使用** 参照) か、あるいはデータ型プロパティと同じ型の式を使用することができます。 Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20. 定数値を使用する場合、以下の原則に従う必要があります: * **テキスト** テキスト型の定数値の場合は単一引用符つき、あるいはなしでも渡すことができます(後述の **引用符を使用する** 参照)。 文字列中の文字列を検索する ("含まれる" クエリ) には、ワイルドカード記号 (@) を使用して検索文字列を指定します (例: "@Smith@")。 また以下のキーワードはテキスト定数においては使用できません: true, false。 * **ブール** 型の定数値: **true** または **false** (文字の大小を区別します) * **数値** 型の定数値: 浮動小数点は '.' (ピリオド) で区切られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md index 27626e785510b3..769372d6feeb23 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md @@ -48,13 +48,13 @@ title: Entity #### 説明 -データクラス属性はすべて、エンティティのプロパティとして利用可能です。各エンティティのプロパティは、当該 エンティティの属性値を格納します。 +`.touchedAttributes()` 関数は、 メモリに読み込み後に変更されたエンティティの属性名を返します。 > データクラス属性は \[ ] を使用したシンタックスを使用することでもアクセス可能です。 この属性値タイプは属性の種類 ([](DataClassClass.md#attributename).kind; リレーションまたはストレージ) によります。 * *attributeName* で指定した属性がストレージ型の場合: `.attributeName` は *attributeName* と同じ型の値を返します。 -* *attributeName* で指定した属性がリレートエンティティ型の場合: `.attributeName` はリレートエンティティを返します。 リレートエンティティの値は、ドット記法でプロパティを繋げることでアクセス可能です。例: "myEntity.employer.employees[0].lastname" +* この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。 リレート先のエンティティそのものが変更された場合 (外部キーの変更)、リレーションの名称とそのプライマリーキー名が *attributeName* プロパティに返されます (リレーション名についての *value* および *otherValue* は空になります)。 * *attributeName* で指定した属性がリレートエンティティズ型の場合: `.attributeName` はリレートエンティティの新しいエンティティセレクションを返します。 重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 #### 例題 @@ -92,8 +92,10 @@ title: Entity #### 説明 -`.clone()` 関数は、 対象エンティティと同じレコードを参照する新規エンティティをメモリ内に作成します。 このメソッドを使用するとエンティティを個別に更新することができます。 -> エンティティに対して何らかの変更をおこなった場合、それらは [`.save( )`](#save) 関数が実行されたときのみ、参照先のレコードに保存されるという点に注意してください。 +`.clone()` 関数は、 対象エンティティと同じレコードを参照する新規エンティティをメモリ内に作成します。 + +This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity. +> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed. この関数は、すでにデータベースに保存されているエンティティに対してのみ使用可能です。 新規に作成されたエンティティ([`.isNew()`](#isnew) が **true** を返すもの) に対して呼び出すことはできません。 @@ -151,7 +153,7 @@ title: Entity コレクションに含まれるのは異なる値を持っていた属性のみです。 差異が見つからない場合、`diff()` は空のコレクションを返します。 -この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。 リレート先のエンティティそのものが変更された場合 (外部キーの変更)、リレーションの名称とそのプライマリーキー名が *attributeName* プロパティに返されます (リレーション名についての *value* および *otherValue* は空になります)。 +この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。 *attributeName* で指定した属性がリレートエンティティ型の場合: `.attributeName` はリレートエンティティを返します。 比較するどちらかのエンティティが **Null** である場合、エラーが生成されます。 @@ -281,7 +283,7 @@ vCompareResult2 ($attributesToInspect についての差異のみ返されます ] ``` -vCompareResult3 ($e1 において更新された (touch された) 属性のみが返されます) +vCompareResult1 (すべての差異が返されています): ```4d [ @@ -335,9 +337,9 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.drop()` 関数は、 データストアからエンティティに格納されているデータを削除します。データクラスに対応するテーブルからエンティティが削除される一方、 エンティティそのものはメモリ内に残るという点に注意してください。 +`.drop()` 関数は、 データストアからエンティティに格納されているデータを削除します。 データクラスに対応するテーブルからエンティティが削除される一方、 エンティティそのものはメモリ内に残るという点に注意してください。 -マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.drop()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 +マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.drop()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。 これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 *mode* 引数を渡さなかった場合のデフォルトでは、同エンティティが他のプロセスまたはユーザーによって変更されていた場合 (つまり、スタンプが変更されていた場合) にエラーを返します (以下参照)。 @@ -358,7 +360,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ | lockInfo | | object | ロック元についての情報 | | | task_id | number | プロセスID | | | user_name | text | マシン上でのセッションユーザー名 | -| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。それ以外は 4Dディレクトリのユーザー名 | +| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。 それ以外は 4Dディレクトリのユーザー名 | | | host_name | text | マシン名 | | | task_name | text | プロセス名 | | | client_version | text | | @@ -374,7 +376,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ | ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
**割り当てられた statusText**: "Already locked" (既にロックされています) | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "Other error" (その他のエラー) | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "スタンプが変更されています" | @@ -1125,24 +1127,24 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.reload()` 関数は、 エンティティの中身をメモリ内にリロードします。この時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。 エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 +`.reload()` 関数は、 エンティティの中身をメモリ内にリロードしますこの時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。 エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 **戻り値** `.reload( )` によって返されるオブジェクトには以下のプロパティが格納されます: -| プロパティ | 型 | 説明 | -| ---------------- | ------- | --------------------------------------------------------------- | -| success | boolean | リロードが成功した場合には true、それ以外は false。
***エラーの場合にのみ利用可能***: | -| status(\*) | number | エラーコード、以下参照 | -| statusText(\*) | text | エラーの詳細、以下参照 | +| プロパティ | 型 | 説明 | +| ---------------- | ------- | ---------------------------------------------------------------- | +| success | boolean | リロードが成功した場合には true、それ以外は false。
***エラーの場合にのみ利用可能***: | +| status(\*) | number | エラーコード、以下参照 | +| statusText(\*) | text | エラーの詳細、以下参照 | (\*) エラー時には *Result* オブジェクトの *status* あるいは *statusText* プロパティに以下のいずれかの値が返されます: | 定数 | 値 | 説明 | | ----------------------------------------- | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
***割り当てられた statusText***: "エンティティはもう存在しません" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
***割り当てられた statusText***: "その他のエラー" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
***割り当てられた statusText***: "その他のエラー" | #### 例題 @@ -1189,11 +1191,11 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.save()` 関数は、 エンティティの変更内容を保存します 。変更内容は、データクラスに対応するテーブル内に保存されます。 エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 +`.save()` 関数は、 エンティティの変更内容を保存します 。 変更内容は、データクラスに対応するテーブル内に保存されます。 エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 保存処理は、少なくとも一つのエンティティ属性が "touched" である (更新されている) 場合にのみ実行されます ([`.touched()`](#touched) および [`.touchedAttributes()`](#touchedattributes) 関数参照)。 そうでない場合、関数は何もしません (トリガーは呼び出されません)。 -マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.save()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 +マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.save()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。 これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 *mode* 引数を渡さなかった場合のデフォルトでは、いずれの属性に関わらず同エンティティが他のプロセスまたはユーザーによって変更されていた場合にエラーを返します (以下参照)。 @@ -1217,7 +1219,7 @@ $info:=$address.getRemoteContextAttributes() | lockInfo | | object | ロック元についての情報 | | | task_id | number | プロセスID | | | user_name | text | マシン上でのセッションユーザー名 | -| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。それ以外は 4Dディレクトリのユーザー名 | +| | user4d_alias | text | `SET USER ALIAS` で設定されていればユーザーエイリアス。 それ以外は 4Dディレクトリのユーザー名 | | | host_name | text | マシン名 | | | task_name | text | プロセス名 | | | client_version | text | | @@ -1233,9 +1235,9 @@ $info:=$address.getRemoteContextAttributes() | 定数 | 値 | 説明 | | ----------------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status automerge failed` | 6 | (`dk auto merge` オプションが使用されたときのみ) エンティティを保存するときに自動マージオプションが失敗しました。
**割り当てられた statusText**: "自動マージ失敗" | +| `dk status automerge failed` | 6 | ロック解除が成功した場合には true、それ以外は false ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success には false が返されます。 | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
**割り当てられた statusText**: "エンティティはもう存在しません" | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
**割り当てられた statusText**: "既にロックされています" | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
**割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
**割り当てられた statusText**: "スタンプが変更されています" | | `dk status wrong permission` | 1 | 現在の権限では、エンティティを保存することはできません。 **割り当てられた statusText**: "Permission Error" (権限エラー) | @@ -1326,7 +1328,7 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.toObject()` 関数は、 エンティティからビルドされたオブジェクトを返します。 オブジェクト内部のプロパティ名はエンティティの属性名と合致します。 +データクラス属性はすべて、エンティティのプロパティとして利用可能です。 各エンティティのプロパティは、当該。 エンティティの属性値を格納します *filterString* 引数が空の文字列、あるいは "*" の場合、以下のいずれかが返されます: @@ -1336,7 +1338,7 @@ $info:=$address.getRemoteContextAttributes() 最初の引数として、取得するエンティティ属性を渡します。 以下のものを渡すことができます: -* *filterString*: プロパティパスをカンマで区切った文字列: "propertyPath1, propertyPath2, ..." または +* リレートエンティティズの一部のプロパティを取得します: * *filterCol*: 文字列のコレクション: \["propertyPath1","propertyPath2";...] filter 引数がリレートエンティティ型の属性を指定する場合 ([kind](DataClassClass.md#attributename) が relatedEntity): @@ -1657,7 +1659,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") #### 説明 -`.touchedAttributes()` 関数は、 メモリに読み込み後に変更されたエンティティの属性名を返します。 +`.toObject()` 関数は、 メモリに読み込み後に変更されたエンティティの属性名を返します。 この関数は、種類 ([kind](DataClassClass.md#attributename)) が `storage` あるいは `relatedEntity` である属性に適用されます。 @@ -1736,7 +1738,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") > 詳細については [エンティティロッキング](ORDA/entities.md#エンティティロッキング) を参照ください。 ロックしているプロセス内のどのエンティティからもレコードが参照されなくなった場合、自動的にレコードロックが解除されます (たとえば、エンティティのローカル参照に対してのみロックがかかっていた場合、プロセスが終了すればエンティティおよびレコードのロックは解除されます)。 -> レコードがロックされている場合、ロックしているプロセスから、ロックされたエンティティ参照に対してロックを解除する必要があります: 例: +> レコードがロックされている場合、ロックしているプロセスから、ロックされたエンティティ参照に対してロックを解除する必要があります: 例: 例: ```4d $e1:=ds.Emp.all()[0] @@ -1765,7 +1767,7 @@ employeeObject:=employeeSelected.toObject("directReports.*") ... // 処理 $status:=$employee.unlock() If($status.success) - ALERT("エンティティのロックは解除されました。") + ALERT("エンティティのロックは解除されました。 ") End if ``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/HTTPRequestClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/HTTPRequestClass.md index 01cd5438c61828..d164a17dc0f247 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/HTTPRequestClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/HTTPRequestClass.md @@ -365,7 +365,7 @@ authentication オブジェクトは `options.serverAuthentication` または `o ## .wait() -**.wait**( { *time* : Real } ) : HTTPRequestClass +**.wait**( { *time* : Real } ) : 4D.HTTPRequest diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/classes.md index bfeeddfdfa9dd1..537ef3d4e171e6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/classes.md @@ -87,8 +87,8 @@ Project フォルダー Project Sources Classes Polygon.4dm - コードエディター: - クラスは実行できません - クラスメソッドはコードのブロックです - - オブジェクトメンバーに対する **定義に移動** 操作はクラスの Function 宣言を探します。例: "$o.f()" の場合、"Function f" を見つけます。 - - クラスのメソッド宣言に対する **参照箇所を検索** 操作は、そのメソッドがオブジェクトメンバーとして使われている箇所を探します。例: "Function f" の場合 "$o.f()" を見つけます。 + - オブジェクトメンバーに対する **定義に移動** 操作はクラスの Function 宣言を探します。 例: "$o.f()" の場合、"Function f" を見つけます。 + - クラスのメソッド宣言に対する **参照箇所を検索** 操作は、そのメソッドがオブジェクトメンバーとして使われている箇所を探します。 例: "Function f" の場合 "$o.f()" を見つけます。 - ランタイムエクスプローラーおよびデバッガーにおいて、クラスメソッドは `
História
+ +| Release | Mudanças | +| ------- | ----------------- | +| 20 R8 | Classe adicionada | + +| +| [](#getheader)
| +| [](#getjson)
| +| [](#getpicture)
| +| [](#gettext)
| +| [](#headers)
| +| [](#url)
| +| [](#urlPath)
| +| [](#urlQuery)
| +| [](#verb)
| + +:::note + +A 4D.IncomingMessage object is a [non-sharable](../Concepts/shared.md) object. + +::: + + + +## .getBlob() + +**.getBlob**() : Blob + + + +| Parâmetro | Tipo | | Descrição | +| ---------- | ---- | --------------------------- | ----------------------------- | +| Resultados | Blob | <- | Body of the request as a Blob | + + + +#### Descrição + +The `.getBlob()` function returns the body of the request as a Blob. + +If the body has not been given as a binary content, the function tries to convert the value but it can give unexpected results. + + + + + +## .getHeader() + +**.getHeader**( *key* : Text ) : Text + + + +| Parâmetro | Tipo | | Descrição | +| ---------- | ---- | --------------------------- | ---------------------------- | +| \| | Text | -> | Header property to get | +| Resultados | Text | <- | Value of the header property | + + + +#### Descrição + +The `.getHeader()` function returns the value of the *key* header. + +:::note + +The *key* parameter is not case sensitive. + +::: + +#### Exemplo + +```4d +var $value : Text +var $request : 4D.IncomingMessage +$value := $request.getHeader("content-type") +``` + + + + + +## .getJSON() + +**.getJSON**() : Variant + + + +| Parâmetro | Tipo | | Descrição | +| ---------- | ------------ | --------------------------- | ------------------------------------------ | +| Resultados | Diferente de | <- | JSON resolution of the body of the request | + + + +#### Descrição + +The `.getJSON()` function returns the body of the request as a JSON resolution. + +If the body has not been given as JSON valid content, an error is raised. + + + + + +## .getPicture() + +**.getPicture**() : Picture + + + +| Parâmetro | Tipo | | Descrição | +| ---------- | ------ | --------------------------- | ------------------------------ | +| Resultados | Imagem | <- | Body of the request as picture | + + + +#### Descrição + +The `.getPicture()` function returns the body of the request as a picture (in case of a body sent as a picture). + +The content-type must be given in the headers to indicate that the body is a picture. + +:::note + +If the request is built using the [`HTTPRequest` class](HTTPRequestClass.md), the picture must be sent in the body as a Blob with the appropriate content-type. + +::: + +If the body is not received as a valid picture, the function returns null. + + + + + +## .getText() + +**.getText**() : Text + + + +| Parâmetro | Tipo | | Descrição | +| ---------- | ---- | --------------------------- | --------------------------- | +| Resultados | Text | <- | Body of the request as text | + + + +#### Descrição + +The `.getText()` function returns the body of the request as a text value. + +If the body has not been given as a string value, the function tries to convert the value but it can give unexpected results. + + + + + +## .headers + +**headers** : Object + +#### Descrição + +The `.headers` property contains the current headers of the incoming message as key/value pairs (strings). + +The `.headers` property is read-only. + +Header names (keys) are lowercased. Note header names are case sensitive. + + + + + +## .url + +**url** : Text + +#### Descrição + +The `.url` property contains the URL of the request without the *IP:port* part and as a string. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.url` property is "/docs/invoices/today". + +The `.url` property is read-only. + +:::note + +The "host" part of the request (*IP:port*) is provided by the [`host` header](#headers). + +::: + + + + + +## .urlPath + +**urlPath** : Collection + +#### Descrição + +The `.urlPath` property contains the URL of the request without the *IP:port* part and as a collection of strings. + +For example, if the request is addressed to: "http://127.0.0.1:80/docs/invoices/today", the `.urlPath` property is ["docs", "invoices" ,"today"]. + +The `.urlPath` property is read-only. + + + + + +## .urlQuery + +**urlQuery** : Object + +#### Descrição + +The `.urlQuery` property contains the parameters of the request when they have been given in the URL as key/value pairs. + +The `.urlQuery` property is read-only. + +Parameters can be passed in the URL of requests **directly** or **as JSON contents**. + +#### Direct parameters + +Example: `http://127.0.0.1:8044/myCall?firstname=Marie&id=2&isWoman=true` + +In this case, parameters are received as stringified values in the `urlQuery` property: `urlQuery = {"firstname":"Marie" ,"id":"2" ,"isWoman":"true"}` + +#### JSON contents parameters + +Example: `http://127.0.0.1:8044/myCall/?myparams='[{"firstname": "Marie","isWoman": true,"id": 3}]'`. + +Parameters are passed in JSON format and enclosed within a collection. + +In this case, parameters are received as JSON text in the `urlQuery` property and can be parsed using [`JSON Parse`](../commands-legacy/json-parse.md). + +```4d +//urlQuery.myparams: "[{"firstname": "Marie","isWoman": true,"id": 3}]" +$test:=Value type(JSON Parse($r.urlQuery.myparams))=Is collection) //true +``` + +Special characters such as simple quotes or carriage returns must be escaped. + +Example: `http://127.0.0.1:8044/syntax/?mdcode=%60%60%604d` + +````4d +//urlQuery.mdcode = ```4d +$test:=Length($r.urlQuery.mdcode) //5 +```` + +:::note + +Parameters given in the body of the request using POST or PUT verbs are handled through dedicated functions: [`getText()`](#gettext), [`getPicture()`](#getpicture), [`getBlob()`](#getblob), [`getJSON()`](#getjson). + +::: + + + + + +## .verb + +**verb** : Text + +#### Descrição + +The `.verb` property contains the verb used by the request. + +HTTP and HTTPS request verbs include for example "get", "post", "put", etc. + +The `.verb` property is read-only. + + diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md index 39f9b4f01dd1c2..1d4465815a17f9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutGoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md index 39f9b4f01dd1c2..1d4465815a17f9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/OutgoingMessageClass.md @@ -5,7 +5,7 @@ title: OutgoingMessage The `4D.OutgoingMessage` class allows you to build messages to be returned by your application functions in response to [REST requests](../REST/REST_requests.md). If the response is of type `4D.OutgoingMessage`, the REST server does not return an object but the object instance of the `OutgoingMessage` class. -Typically, this class can be used in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. +Typically, this class can be used in custom [HTTP request handler functions](../WebServer/http-request-handler.md#function-configuration) or in functions declared with the [`onHttpGet`](../ORDA/ordaClasses.md#onhttpget-keyword) keyword and designed to handle HTTP GET requests. Such requests are used, for example, to implement features such as download file, generate and download picture as well as receiving any content-type via a browser. An instance of this class is built on 4D Server and can be sent to the browser by the [4D REST Server](../REST/gettingStarted.md) only. This class allows to use other technologies than HTTP (e.g. mobile). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebServerClass.md b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebServerClass.md index 95d0333c7319f2..917b31e481b2a9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/API/WebServerClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/API/WebServerClass.md @@ -77,7 +77,7 @@ Path of the folder where t **.characterSet** : Number
**.characterSet** : Text -The character set that the 4D Web Server should use to communicate with browsers connecting to the application. O valor padrão realmente depende da linguagem do SO. Can be a MIBEnum integer or a Name string, identifiers [defined by IANA](http://www.iana.org/assignments/character-sets/character-sets.xhtml). Aqui está a lista de identificadores correspondentes aos conjuntos de caracteres suportados pelo Servidor Web 4D: +The character set that the 4D Web Server should use to communicate with browsers connecting to the application. O valor padrão realmente depende da linguagem do SO. O valor padrão realmente depende da linguagem do SO. Aqui está a lista de identificadores correspondentes aos conjuntos de caracteres suportados pelo Servidor Web 4D: - 4 = ISO-8859-1 - 12 = ISO-8859-9 @@ -111,7 +111,7 @@ The cipher list used for the sec **.CORSEnabled** : Boolean -The CORS (*Cross-origin resource sharing*) service status for the web server. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. When enabled (True), XHR calls (e.g. REST requests) from Web pages outside the domain can be allowed in your application (you need to define the list of allowed addresses in the CORS domain list, see `CORSSettings` below). Quando desativado (False, padrão), todas as solicitações de cruzamento de sites enviadas com CORS são ignoradas. Quando habilitado (verdadeiro) e um domínio ou método não permitido envia uma solicitação de site cruzado, ele é rejeitado com uma resposta de erro "403 - proibido". +The CORS (*Cross-origin resource sharing*) service status for the web server. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. Quando desativado (False, padrão), todas as solicitações de cruzamento de sites enviadas com CORS são ignoradas. Quando habilitado (verdadeiro) e um domínio ou método não permitido envia uma solicitação de site cruzado, ele é rejeitado com uma resposta de erro "403 - proibido". Padrão: Falso (desabilitado) @@ -127,19 +127,19 @@ For more information about CORS, please refer to the [Cross-origin resource shar Contains the list of allowed hosts and methods for the CORS service (see [`CORSEnabled`](#corsenabled) property). Cada objeto deve conter uma propriedade **host** e, opcionalmente, uma propriedade **methods**: -- **host** (text, mandatory): Domain name or IP address from where external pages are allowed to send data requests to the Server via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. If *host* is not present or empty, the object is ignored. Várias sintaxes são suportadas: +- **host** (text, mandatory): Domain name or IP address from where external pages are allowed to send data requests to the Server via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Várias sintaxes são suportadas: - 192.168.5.17:8081 - 192.168.5.17 - 192.168.\* - 192.168.\*:8081 -
Disabled if one selected object position is locked by a CSS property | |  | [Distribuição](#distributing-objects) | Este botão está ligado a um menu que permite agrupar e desagrupar seleções de objetos no formulário. It is enabled (or not) depending on the objects selected.
Disabled if one selected object position is locked by a CSS property | -|  | [Level](#layering-objects) | This button is linked to a menu that allows aligning objects in the form. É ativada (ou não) em função dos objetos selecionados. | +|  | [Level](#layering-objects) | This button is linked to a menu that allows changing the level of objects in the form. É ativada (ou não) em função dos objetos selecionados. | |  | [Group/Ungroup](#grouping-objects) | Este botão está ligado a um menu que permite agrupar e desagrupar seleções de objetos no formulário. É ativada (ou não) em função dos objetos selecionados. | |  | [Display and page management](forms.html#form-pages) | Esta área permite passar de uma página de formulário para outra e adicionar páginas. Para navegar entre páginas de formulários, clique nos botões de seta, ou clique na área central e escolha a página a exibir a partir do menu que aparece. Se clicar no botão da seta para a direita enquanto é exibida a última página do formulário, 4D permite-lhe adicionar uma página. | |  | [CSS Preview](#css-preview) | Este botão é utilizado para seleccionar o Modo CSS a utilizar. | @@ -70,7 +70,7 @@ A barra de ferramentas contém os seguintes elementos: |  | [Displaying shields](#shields) | Each click on this button causes the successive display of each type of form shield. The button is also linked to a menu that allows directly selecting the type of shield to display. | |  | [Preconfigured object library](objectLibrary.html) | This button displays the preconfigured object library that provides numerous objects with certain properties that have been predefined. | |  | [List Box Builder](#list-box-builder) | Este botão cria list boxes entity selection. | -|  | [Insert fields](#insert-fields) | This button inserts all fields (except object and blob type fields) of the form table in the form, along with their labels and with respect to interface standards. | +|  | [Insert fields](#insert-fields) | Esse botão insere todos os campos (exceto os campos do tipo objeto e bolha) da tabela do formulário no formulário, juntamente com seus rótulos e de acordo com os padrões de interface. | ### Barra de objetos @@ -90,7 +90,7 @@ The object bar contains all the active and inactive objects that can be used in |  | [Splitter](FormObjects/splitters.md) / [Controle de guia](FormObjects/tabControl.md) | D | |  | [Plug-in Area](FormObjects/pluginArea_overview.md) / [Subform](FormObjects/subform_overview.md) / [Web Area](FormObjects/webArea_overview.md) / [4D Write Pro](FormObjects/writeProArea_overview.md) / [4D View Pro](FormObjects/viewProArea_overview.md) | X | -To draw an object type, select the corresponding button and then trace the object in the form. Após criar um objeto, você pode modificar seu tipo utilizando a Lista de Propriedades. Mantenha pressionada a tecla **Shift** ao desenhar para restringir o objeto a uma forma regular. Lines are constrained to horizontal, 45°, or vertical, rectangles are constrained to squares, and ovals are constrained to circles. +To draw an object type, select the corresponding button and then trace the object in the form. Após criar um objeto, você pode modificar seu tipo utilizando a Lista de Propriedades. To draw an object type, select the corresponding button and then trace the object in the form. Lines are constrained to horizontal, 45°, or vertical, rectangles are constrained to squares, and ovals are constrained to circles. The current variant of the theme is the object that will be inserted in the form. Ao clicar no lado direito de um botão, você acessa o menu de variantes: @@ -136,7 +136,7 @@ Once the object is placed in the form, you can modify its characteristics using É possível trabalhar com dois tipos de objetos nos formulários: -- **Objetos estáticos** (linhas, quadros, imagens de fundo, etc.): Esses objetos são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Estão disponíveis na barra de objetos do editor de formulários. Você também pode definir seus atributos gráficos (tamanho, cor, fonte, etc.) e suas propriedades de redimensionamento usando a Lista de propriedades. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. +- **Objetos estáticos** (linhas, quadros, imagens de fundo, etc.): Esses objetos são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Estão disponíveis na barra de objetos do editor de formulários. Estão disponíveis na barra de objetos do editor de formulários. Estão disponíveis na barra de objetos do editor de formulários. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. - **Objetos ativos**: Esses objetos executam tarefas ou funções na interface e podem assumir várias formas: campos, botões, listas roláveis, etc. Cada objeto ativo é associado com um campo ou uma variável. @@ -144,11 +144,11 @@ Once the object is placed in the form, you can modify its characteristics using Before you can perform any operation on an object (such as changing a line width or font), you need to select the object that you want to modify. -Para seleccionar um objecto utilizando a barra de ferramentas: +To select an object using the toolbar: 1. Clique na ferramenta Seta na barra de ferramentas
-Click the Arrow tool in the toolbar.
When you move the pointer into the form area, it becomes a standard arrow-shaped pointer.
Quando você move o ponteiro para a área do formulário, ele se torna um ponteiro padrão em forma de seta
. 2. Clique no objecto que deseja selecionar. As alças de redimensionamento identificam o objeto selecionado
@@ -157,7 +157,7 @@ Para selecionar um objecto utilizando a Lista de Propriedades: 1. Escolher o nome do objecto na lista pendente da Lista de Objectos localizada no topo da Lista de Propriedades. Usando estes dois métodos, pode seleccionar um objecto que esteja escondido por outros objectos ou localizado fora da área visível da janela actual. Para cancelar a seleção de um objeto, clique fora do limite do objeto ou **Shift+clique** no objeto. -> \> > It is also possible to select objects by double-clicking them in the result window of ""Find in design" operation. +> \> > > It is also possible to select objects by double-clicking them in the result window of ""Find in design" operation. ### Selecção de múltiplos objectos @@ -196,7 +196,7 @@ A caixa de diálogo "Duplicate Many" é exibida quando você seleciona um ou mai  -- Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. Por exemplo, se quiser três colunas e duas linhas de objectos, introduza 3 na área de Coluna(s) e 2 na área de Linha(s). Se quiser três novas cópias horizontais de um objecto, introduza 4 na área de Coluna(s) e deixe o valor por defeito, 1, na área de Linha(s). +- Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. Por exemplo, se quiser três colunas e duas linhas de objectos, introduza 3 na área de Coluna(s) e 2 na área de Linha(s). Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. - Para linhas e colunas, defina o offset que deseja deixar entre cada cópia. O valor deve ser expresso em pontos. It will be applied to each copy, or copies, in relation to the original object. For example, if you want to leave a vertical offset of 20 points between each object and the height of the source object is 50 points, enter 70 in the column’s “Offset” area. @@ -277,7 +277,7 @@ Para exibir essa caixa de diálogo, selecione os objetos que deseja alinhar e es - Nas áreas "Alinhamento Esquerda/Direita" e/ou "Alinhamento Superior/Inferior", clique no ícone que corresponde ao alinhamento que você deseja executar.A área de exemplo exibe os resultados da sua seleção.
-- Para executar um alinhamento que use o esquema de âncora padrão, clique em **Preview** ou **Apply**. In this case 4D uses the object that is the furthest in the alignment’s direction as the anchor and aligns the other objects to that object. Por exemplo, se quiser realizar um alinhamento correcto num conjunto de objectos, o objecto mais à direita será utilizado como âncora. OU:Para alinhar objetos a um objeto específico, selecione a opção **Alinhar em** e selecione o objeto ao qual você deseja que os outros objetos sejam alinhados na lista de objetos. In this case, the position of the reference object will not be altered.
+- Para executar um alinhamento que use o esquema de âncora padrão, clique em **Preview** ou **Apply**. Nesse caso, 4D usa o objeto que está mais distante na direção do alinhamento como âncora e alinha os outros objetos a esse objeto. Por exemplo, se quiser realizar um alinhamento correcto num conjunto de objectos, o objecto mais à direita será utilizado como âncora. OU:Para alinhar objetos a um objeto específico, selecione a opção **Alinhar em** e selecione o objeto ao qual você deseja que os outros objetos sejam alinhados na lista de objetos. In this case, the position of the reference object will not be altered.
Você pode visualizar os resultados do alinhamento clicando no botão **Preview**. Os objetos são então alinhados no editor de formulários, mas como a caixa de diálogo não desaparece, ainda é possível cancelar ou aplicar o alinhamento. @@ -314,7 +314,7 @@ Para distribuir objetos com igual espaçamento: 1. Selecione três ou mais objetos e clique na ferramenta Distribuir pretendida. -2. Na barra de ferramentas, clique na ferramenta de distribuição que corresponde à distribuição que você deseja aplicar.
OUSelecione um comando de menu de distribuição no submenu **Alinhar** no menu **Objeto** ou no menu de contexto do editor.
4D distribui os objetos apropriadamente. Objects are distributed using the distance to their centers and the largest distance between two consecutive objects is used as a reference. +2. Na barra de ferramentas, clique na ferramenta de distribuição que corresponde à distribuição que você deseja aplicar.
OUSelecione um comando de menu de distribuição no submenu **Alinhar** no menu **Objeto** ou no menu de contexto do editor.
4D distribui os objetos apropriadamente. Objects are distributed using the distance to their centers and the largest distance between two consecutive objects is used as a reference. Para distribuir objetos utilizando a caixa de diálogo Alinhar e distribuir: @@ -322,7 +322,7 @@ Para distribuir objetos utilizando a caixa de diálogo Alinhar e distribuir: 2. Seleccione el comando **Alineación** del submenú **Alinear** del menú **Objeto** o del menú contextual del editor. A seguinte caixa de diálogo é exibida: -3. Nas áreas de Alinhamento Esquerdo/Direita e/ou Topo/Bottom Alinhamento, clique no ícone de distribuição padrão: (ícone padrão de distribuição horizontal)
A área de exemplo exibe os resultados da sua seleção. +3. Nas áreas de Alinhamento Esquerdo/Direita e/ou Topo/Bottom Alinhamento, clique no ícone de distribuição padrão: (ícone padrão de distribuição horizontal)
A área de exemplo exibe os resultados da sua seleção. 4. Para executar uma distribuição que use o esquema padrão, clique em **Preview** ou _Apply_.Nesse caso, o 4D executará uma distribuição padrão, de modo que os objetos sejam dispostos com uma quantidade igual de espaço entre eles
. OU:Para executar uma distribuição específica, selecione a opção **Distribute** (por exemplo, se quiser distribuir os objetos com base na distância até o lado direito). Esta opção funciona como um interruptor. If the Distribute check box is selected, the icons located below it perform a different function:
@@ -335,7 +335,7 @@ Você pode visualizar o resultado real de suas configurações clicando no botã ### Gerenciar os planos dos objetos -You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. For example, you may have a graphic that you want to appear behind the fields in a form. O 4D oferece quatro itens de menu, **Mover para trás**, **Mover para frente**, **Subir um nível** e **Descer um nível**, que permitem que você coloque objetos em camadas no formulário. These layers also determine the default entry order (see Modifying data entry order). A figura abaixo mostra objetos à frente e atrás de outros objetos: +You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. For example, you may have a graphic that you want to appear behind the fields in a form. You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. These layers also determine the default entry order (see Modifying data entry order). A figura abaixo mostra objetos à frente e atrás de outros objetos:  @@ -375,13 +375,13 @@ In cases such as this, a custom data entry order allows you to enter the informa You can view the current entry order either using the “Entry order” shields, or by using the “Entry order” mode. No entanto, você só pode modificar a ordem de entrada usando o modo “Ordem de entrada”. -This paragraph describes viewing and modifying the entry order using the “Entry order” mode. Para obter mais informações sobre como visualizar a ordem de entrada usando escudos, consulte [Using shields](#using-shields). +This paragraph describes viewing and modifying the entry order using the “Entry order” mode. You can view the current entry order either using the “Entry order” shields, or by using the “Entry order” mode. Para ver ou alterar a ordem de entrada: 1. Selecione **Pedido de entrada** no menu **Formulário** ou clique no botão na barra de ferramentas da janela:
- Choose Entry Order from the Form menu or click on the Entry Order button in the toolbar of the window:
The pointer turns into an entry order pointer and 4D draws a line in the form showing the order in which it selects objects during data entry. A visualização e alteração da ordem de introdução de dados são as únicas acções que pode realizar até clicar em qualquer ferramenta na paleta Ferramentas.
+ O ponteiro se transforma em um ponteiro de ordem de entrada e 4D desenha uma linha na forma mostrando a ordem em que ele seleciona objetos durante a entrada de dados. A visualização e alteração da ordem de introdução de dados são as únicas acções que pode realizar até clicar em qualquer ferramenta na paleta Ferramentas.
2. Para mudar a ordem de entrada de dados, posicione o ponteiro em um objeto no formulário e, enquanto mantém pressionado o botão do mouse, arraste o ponteiro para o objeto que deseja na ordem de entrada de dados.
4D ajustará a ordem de entrada de acordo.
diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md
index f35c506b742df1..8f612b74c41059 100644
--- a/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md
+++ b/i18n/pt/docusaurus-plugin-content-docs/current/FormEditor/forms.md
@@ -18,7 +18,7 @@ Os formulários também podem conter outros formulários através das seguintes
- **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**.
- **Form Editor**: Modifique seus formulários usando o **[Form Editor] (FormEditor/formEditor.md)**.
-- **Código JSON:** Crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado] (Project/architecture.md#sources-folder). Exemplo:
+- **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture.md#sources-folder). Exemplo:
```
{
@@ -111,7 +111,7 @@ Quando um formulário é executado, os objetos são carregados e combinados na s
3. Página zero do formulário aberto
4. Página actual do formulário aberto.
-Essa ordem determina a [ordem de entrada] padrão (../FormEditor/formEditor.html#data-entry-order) dos objetos no formulário.
+Essa ordem determina a [ordem de entrada](../FormEditor/formEditor.html#data-entry-order) padrão dos objetos no formulário.
> Apenas as páginas 0 e 1 de um formulário herdado podem aparecer noutros formulários.
@@ -121,7 +121,7 @@ Para definir um formulário herdado, as propriedades [Inherited Form Name](prope
Um formulário pode herdar de um formulário de projeto, definindo a propriedade [Inherited Form Table] (properties_FormProperties.md#inherited-form-table) como `\*No es posible producir código Apple Silicon en Windows* | Código para Apple Silicon + Código para Intel/AMD
*Habrá dos códigos compilados disponibles* | Código para Apple Silicon + Código para Intel/AMD
*Habrá dos códigos compilados disponibles* | -| **O meu processador (processador)** | Código para Intel/AMD | Código para Intel/AMD | Código para Apple Silicon | +| *Opção* | *no Windows Intel/AMD* | *macOS Intel* | *no macOS Silicon* | +| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| **Todos os processadores (Intel/AMD e Apple Silicon)** | Código para Intel/AMD
*Não é possível produzir código Apple Silicon no Windows* | Código para o Apple Silicon + Código para Intel/AMD
*Dois códigos compilados estarão disponíveis* | Código para o Apple Silicon + Código para Intel/AMD
*Dois códigos compilados estarão disponíveis* | +| **O meu processador (processador)** | Código para Intel/AMD | Código para Intel/AMD | Código para Apple Silicon | -> El objetivo de compilación Apple Silicon requiere que la aplicación **Clang** esté instalada en su máquina. Clang vem com a versão mais recente do Xcode. Ver los [requisitos del compilador Silicon](#requirements) para más información. +> O alvo do compilador Apple Silicon requer que o aplicativo **Clang** esteja instalado em sua máquina. Clang vem com a versão mais recente do Xcode. Veja os [requisitos do compilador do Silício](#requerimentos) para mais informações. -### Digitação por defeito +### Digitação padrão Use esta área para definir o tipo padrão para objetos de banco de dados ambíguos. -- **Numérico**: se utiliza para forzar un tipo numérico de manera no ambigua, bien sea real o entero largo. Isso não substituirá as diretivas que você possa ter definido em seu projeto. Você pode otimizar a execução do seu banco de dados escolhendo o tipo Longint. -- **Botón**: se utiliza para forzar el tecleo de un botón de manera no ambigua, ya sea Real o Entero largo. Isso não substituirá as diretivas que você possa ter definido em seu projeto. This type applies to buttons as well as check boxes, picture buttons, button grids, radio buttons, picture pop-up menus and drop-down lists. +- **Numérico**: Usado para forçar a digitação numérica de uma forma inequívoca, seja de forma real ou longa. Isso não substituirá as diretivas que você possa ter definido em seu projeto. Você pode otimizar a execução do seu banco de dados escolhendo o tipo Longint. +- **Botão**: Usado para forçar o botão a digitar de uma forma inequívoca, seja de forma real ou longa. Isso não substituirá as diretivas que você possa ter definido em seu projeto. Este tipo se aplica a botões, bem como caixas de seleção, botões de imagem, grades de botão, botões de rádio, imagens de menus pop-up e listas suspensas. -### Compiler Methods for +### Métodos de Compilação para... -Esta área le permite renombrar los métodos del compilador que son generados automáticamente por el compilador cuando hace clic en [Declarar tipos](#generate-typing). +Esta área permite renomear os métodos do Compilador que são gerados automaticamente pelo compilador quando você clica em [Gerar Typing](#generate-typing). -Up to 5 compiler methods may be generated; a compiler method is only generated if the project contains the following items: +Até 5 métodos do compilador podem ser gerados; um método do compilador só é gerado se o projeto contiver os seguintes itens: -- **Variables**: agrupa las declaraciones de variables proceso; -- **Variables interproceso**: agrupa las declaraciones de variables interproceso; -- **Arrays**: agrupa las declaraciones de arrays de proceso; -- **Arrays interproceso**: agrupa las declaraciones de arrays interproceso; -- **Métodos**: agrupa las declaraciones de parámetros de métodos (por ejemplo `C_LONGINT(mymethod;$1;$2)`) para [parámetros de métodos declarados fuera de prototipos](../Concepts/parameters.md#method-parameters-declared-outside-prototypes). For more information, see [`Compiler_Methods` method](../Concepts/parameters.md#compiler_methods-method). +- **Variáveis**: agrupa as declarações de variáveis processam; +- **Variáveis Interprocessadas**: Grupos interprocessam declarações de variáveis entre processamentos; +- **Arrays**: Agrupa as declarações de matrizes de processo; +- **Matrizes Interprocessadas**: Grupos juntos declarações matrizes interprocessos; +- \*\*Métodos \*\*: Agrupa as declarações do parâmetro do método (por exemplo, `C_LONGINT(meumétodo;$1;$2)`) para [parâmetros de método declarados fora dos protóticos](../Concepts/parameters.md#method-parameters-declared-outside-prototypes). Para obter mais informações, consulte [método `Compiler_Methods`](../Concepts/parameters.md#compiler_methods-method). -Puede renombrar cada uno de estos métodos en las áreas correspondientes, pero siempre irán precedidos de la etiqueta `Compilador_` (no modificable). The name of each method (prefix included) must be no longer than 31 characters. También debe ser único y cumplir con [las reglas de 4D para nombrar métodos](Concepts/identifiers.md#project-methods). +Você pode renomear cada um desses métodos nas áreas correspondentes, mas eles sempre serão precedidos pela etiqueta `Compiler_` (não modificável). O nome de cada método (prefixo incluído) não deve ter mais de 31 caracteres. Deve também ser único e cumprir com [regras 4D para métodos de nomeação](Concepts/identifiers.md#project-methods). ## Avisos -Warnings are specific messages generated by the compiler when it checks the syntax. These messages are intended to draw your attention to statements that might lead to execution errors. Não impedem a compilação. +Avisos são mensagens específicas geradas pelo compilador quando verifica a sintaxe. Essas mensagens destinam-se a chamar a sua atenção para afirmações que podem levar a erros de execução. Não impedem a compilação. -Depending on circumstances and the programming style used, warnings may be more or less relevant. You can enable or disable warnings, in the compiler dialog, and in the code editors (4D code editor and VS Code), globally through the [warnings tab](#warnings-tab) or locally using [`//%W`](#disabling-and-enabling-warnings-locally). +Dependendo das circunstâncias e do estilo de programação utilizado, avisos podem ser mais ou menos relevantes. Você pode ativar ou desativar avisos, na caixa de diálogo do compilador e nos editores de código (editor de código 4D e código VS), globalmente através da [guia de avisos](#warnings-tab) ou localmente usando [`//%W`](#disabling-and-enabling-warnings-localmente). -### Warnings tab +### Aba "Avisos"  -This tab allows you to define which warnings should be displayed globally. From the list of all possible warnings with their types, their code and their localized label, ordered by warning code. +Esta aba permite definir quais avisos devem ser exibidos globalmente. Da lista de todos os possíveis avisos com seus tipos, seu código e sua etiqueta localizada, ordenados por código de aviso. Para reduzir a lista, você pode pesquisar palavras por etiquetas e códigos de aviso usando a caixa de texto **Pesquisar em códigos e rótulos** ou o ícone da lupa à esquerda. -By default, all warning types are checked and enabled. +Por padrão, todos os tipos de advertência são checados e habilitados. -When you modify a warning display status, the information is stored in the "warnings.json" file, placed in the project Settings folder. +Quando você modificar o estado de exibição de aviso, as informações são armazenadas no arquivo "warnings.json", colocado na pasta de configurações do projeto. -The **Reset to factory settings** button sets all the warning display status checkboxes to default values and deletes the "warnings.json" file. +O botão **Redefinir para as configurações de fábrica** define todas as caixas de seleção de status de exibição para valores padrão e exclui o arquivo "warnings.json". ### Desativar e ativar avisos localmente -You can control warnings in specific parts of your code by using special comments to disable or enable them. +Você pode controlar avisos em partes específicas do seu código usando comentários especiais para desativá-los ou habilitá-los. -To disable warnings, insert the following comments before and after the code section where you want to disable warnings: +Para desativar os avisos, insira os seguintes comentários antes e após a seção de código, onde você deseja desativar os avisos: ```4d -// Before the selected code part use +// Antes da parte do código selecionado, use //%W-
+- with 4D, selecione o item de menu **Dependências de Design/Projeto** (Ambiente de Desenvolvimento),
 -- with 4D Server, select the **Window/Project Dependencies** menu item.
+- with 4D Server, selecione o item de menu **Window/Project Dependencies**.
 -O painel Dependência é então exibido. Dependencies are sorted by name in alphabetical order: +O painel Dependência é então exibido. Dependências são classificadas por nome em ordem alfabética:  ### Origem da dependência -The Dependencies panel lists all project dependencies, whatever their origin, i.e. wherever they come from. The dependency origin is provided by the tag under its name: +O painel de Dependências lista todas as dependências do projeto, independentemente da sua origem, ou seja, de onde vierem. A origem da dependência é fornecida pela etiqueta sob seu nome:  As seguintes origens são possíveis: -| Origin tag | Descrição | +| Tag de origem | Descrição | | --------------------------------- | ---------------------------------------------------------------------------- | | Componente 4D | Componente 4D incorporado, armazenado na pasta `Components` da aplicação 4D | | dependencies.json | Component declared in the [`dependencies.json`](#dependenciesjson) file | -| Environment | Componente declarado no arquivo [`environnement4d.json`](#environment4djson) | +| Ambiente | Componente declarado no arquivo [`environnement4d.json`](#environment4djson) | | Componente do projeto | Componente localizado na pasta [`Components`](architecture.md#components) | **Clique com o botão direito do mouse** em uma linha de dependência e selecione **Mostrar no disco** para revelar o local de uma dependência: @@ -315,30 +315,30 @@ As seguintes origens são possíveis: :::note -This item is not displayed if the dependency is inactive because its files are not found. +Este item não é exibido se a dependência estiver inativa porque seus arquivos não foram encontrados. ::: -Component icon and location logo provide additional information: +O ícone do componente e o logotipo da localização fornecem informações adicionais: -- The component logo indicates if it is provided by 4D or a third-party developer. -- Local components can be differentiated from GitHub components by a small icon. +- O logotipo do componente indica se é fornecido por 4D ou por um desenvolvedor terceiro. +- Os componentes locais podem ser diferenciados de componentes do GitHub usando um ícone pequeno.  ### Filtragem de dependências -By default, all dependencies identified by the Dependency manager are listed, whatever their [status](#dependency-status). You can filter the displayed dependencies according to their status by selecting the appropriate tab at the top of the Dependencies panel: +Por padrão, todas as dependências identificadas pelo gerenciador de dependências são listadas, independentemente de seu [status] (#dependency-status). Você pode filtrar as dependências exibidas de acordo com o seu status, selecionando a guia apropriada na parte superior do painel Dependências:  -- **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. *Overloaded* dependencies are listed in the **Conflicts** panel, along with all conflicting dependencies. -- **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. There are many possible reasons for this status: missing files, version incompatibility... -- **Conflito**: dependências carregadas, mas que sobrecarregam pelo menos outra dependência em um [nível de prioridade](#priority) inferior. Overloaded dependencies are also displayed so that you can check the origin of the conflict and take appropriate actions. +- **Ativo**: dependências carregadas e podem ser usadas no projeto. Isso inclui dependências *overloading*, que são de fato carregadas. Dependências *Sobrecarregadas* são listadas no painel **Conflitos**, junto com todas as dependências conflitantes. +- **Inativo**: dependências que não estão carregadas no projeto e não estão disponíveis. Há muitas razões possíveis para este status: arquivos ausentes, incompatibilidade de versão... +- **Conflito**: dependências carregadas, mas que sobrecarregam pelo menos outra dependência em um [nível de prioridade](#priority) inferior. Dependências sobrecarregadas também são exibidas para que você possa verificar a origem do conflito e tomar as medidas adequadas. ### Status de dependência -Dependencies requiring the developer's attention are indicated by a **status label** at the right side of the line and a specific background color: +Dependências que exigem a atenção do desenvolvedor são indicadas por um **rótulo de status** no lado direito da linha e uma cor de fundo específica:  @@ -348,8 +348,8 @@ Estão disponíveis as seguintes etiquetas de status: - **Overloading**: a dependência está carregada e está sobrecarregando uma ou mais dependências com o mesmo nome em um [nível de prioridade] inferior (#prioridade). - **Not found**: a dependência está declarada no arquivo dependencies.json, mas não foi encontrada. - **Inactive**: a dependência não é carregada porque não é compatível com o projeto (por exemplo, o componente não é compilado para a plataforma atual). -- **Duplicated**: The dependency is not loaded because another dependency with the same name exists at the same location (and is loaded). +- **Duplicated**: a dependência não é carregada porque existe uma outra dependência com o mesmo nome no mesmo local (e é carregado). -A tooltip is displayed when you hover over the dependency line, provding additional information about the status: +Uma dica é exibida quando você passa o mouse sobre a linha de dependência, provando informações adicionais sobre o status:  diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/ClassFunctions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/ClassFunctions.md index 0a1d586a4144cf..c4462ec501df4e 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/ClassFunctions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/ClassFunctions.md @@ -3,19 +3,19 @@ id: classFunctions title: Chamada de funções de classe --- -Puede llamar a [funciones de clase de modelos de datos](ORDA/ordaClasses.md) definidas para el modelo de datos ORDA a través de sus peticiones REST, para poder beneficiarse de la API expuesta de la aplicación 4D objetivo. +Pode chamar as [funções de classe](ORDA/ordaClasses.md) definidas para o modelo de dados ORDA através dos seus pedidos REST, para poder beneficiar da API da aplicação 4D objetivo. :::note -You can also call singleton functions, see [this page]($singleton.md) for more information. +Você também pode chamar funções singleton, consulte [esta página]($singleton.md) para obter mais informações. ::: -As funções são simplesmente chamadas em pedidos POST na interface ORDA apropriada, sem (). Por ejemplo, si ha definido una función `getCity()` en la dataclass City, podría llamarla utilizando la siguiente petición: +As funções são simplesmente chamadas em pedidos POST na interface ORDA apropriada, sem (). Por exemplo, se tiver definido uma função `getCity()` na dataclass City, pode chamá-la utilizando o seguinte pedido: `/rest/City/getCity` -con los datos en el cuerpo de la petición POST: `["Aguada"]` +com dados no corpo do pedido POST: `["Aguada"]` Na linguagem 4D, esta chamada é equivalente a: @@ -23,11 +23,11 @@ Na linguagem 4D, esta chamada é equivalente a: $city:=ds. City.getCity("Aguada") ``` -> Sólo las funciones con la palabra clave `exposed` pueden ser llamadas directamente desde las peticiones REST. Ver la sección [Funciones expuestas vs. no expuestas](ORDA/ordaClasses.md#exposed-vs-non-exposed-functions). +> Apenas as funções com a palavra-chave `exposed` podem ser diretamente chamadas a partir de pedidos REST. Ver la sección [Funciones expuestas vs. no expuestas](ORDA/ordaClasses.md#exposed-vs-non-exposed-functions). ## Chamadas funções -Las funciones deben llamarse siempre utilizando peticiones **POST** (una petición GET recibirá un error). +As funções têm de ser sempre chamadas através de pedidos REST **POST** (um pedido GET dará origem a um erro). As funções são chamadas no objeto correspondente no datastore do servidor. @@ -42,35 +42,35 @@ As funções são chamadas no objeto correspondente no datastore do servidor. | [entity class](ORDA/ordaClasses.md#entity-class) | `/rest/\{dataClass\}(key)/EntityClassFunction/` | | [Classe Singleton](../Concepts/classes.md#singleton-classes) | `/rest/$singleton/SingletonClass/SingletonClassFunction` (veja [$singleton page]($singleton.md)) | -> `/rest/\{dataClass\}/Function` can be used to call either a dataclass or an entity selection function (`/rest/\{dataClass\}` returns all entities of the DataClass as an entity selection).\ +> `/rest/\{dataClass\}/Function` pode ser usado para chamar uma função de seleção de dataclass ou uma entity selection (`/rest/\{dataClass\}` retorna todas as entidades da DataClass como uma entity selection).\ > A função é pesquisada primeiro na classe de seleção de entidades. Se não for encontrado, é procurado na dataclass. Por outras palavras, se uma função com o mesmo nome for definida tanto na classe DataClass como na classe EntitySelection, a função da classe de dataClass nunca será executada. -> All 4D code called from REST requests **must be thread-safe** if the project runs in compiled mode, because the REST Server always uses preemptive processes in this case (the [*Use preemptive process* setting value](../WebServer/preemptiveWeb.md#enabling-the-preemptive-mode-for-the-web-server) is ignored by the REST Server). +> Todos os códigos 4D chamados de solicitações REST **devem ser thread-safe** se o projeto for executado em modo compilado. porque o servidor REST sempre usa processos preventivos neste caso (o valor da configuração [*usar processo preemptivo*](../WebServer/preemptiveWeb.md#enabling-the-preemptive-mode-for-the-web-server) é ignorado pelo servidor REST). ## Parâmetros -É possível enviar parâmetros para funções definidas em classes usuários ORDA. Del lado del servidor, serán recibidos en los [parámetros declarados](../Concepts/parameters.md#declaring-parameters) de las funciones clase. +É possível enviar parâmetros para funções definidas em classes usuários ORDA. Do lado do servidor, eles serão recebidos nos [parâmetros declarados](../Concepts/parameters.md#declaring-parameters) das funções da classe. As regras abaixo são válidas: -- Los parámetros deben pasarse en el **cuerpo de la petición POST** +- Os parâmetros devem ser transmitidos no **corpo do pedido POST** - Os parâmetros devem ser incluídos numa coleção (formato JSON) - Todos os tipos de dados escalares suportados nas coleções JSON podem ser passados como parâmetros. -- A entidade e a seleção de entidades podem ser passadas como parâmetros. The JSON object must contain specific attributes used by the REST server to assign data to the corresponding ORDA objects: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. +- A entidade e a seleção de entidades podem ser passadas como parâmetros. O objeto JSON deve conter atributos específicos usados pelo servidor REST para atribuir os dados aos objetos ORDA correspondentes: `__DATACLASS`, `__ENTITY`, `__ENTITIES`, `__DATASET`. -See [this example](#using-an-entity-to-be-created-on-the-server) and [this example](#receiving-an-entity-selection-as-parameter). +Veja [este exemplo](#using-an-entity-to-be-created-on-the-server) e [este exemplo](#receiving-an-entity-selection-as-parameter). ### Parâmetro de valor escalar Os parâmetros devem ser simplesmente incluídos numa coleção definida no corpo. For example, with a dataclass function `getCities()` receiving text parameters: `/rest/City/getCities` -**Parámetros en el cuerpo:** ["Aguada","Paris"] +**Parâmetros no corpo:** ["Aguda","Paris"] Todos os tipos de dados JSON são suportados nos parâmetros, incluindo os ponteiros JSON. As datas podem ser transmitidas como cadeias de caracteres no formato de data ISO 8601 (por exemplo, "2020-08-22T22:00:000Z"). ### Parâmetro da entidade -Las entidades pasadas en los parámetros son referenciadas en el servidor a través de su llave (*es decir,* propiedad __KEY). Se o parâmetro chave for omitido num pedido, é carregada uma nova entidade na memória do servidor. +As entidades passadas nos parâmetros são referenciadas no servidor através da sua chave (*ou seja*, a propriedade __KEY). Se o parâmetro chave for omitido num pedido, é carregada uma nova entidade na memória do servidor. Também é possível transmitir valores para quaisquer atributos da entidade. Estes valores serão automaticamente utilizados para a entidade tratada no servidor. > Se o pedido enviar valores de atributos modificados para uma entidade existente no servidor, a função de modelo de dados ORDA chamada será automaticamente executada no servidor com valores modificados. Esta caraterística permite-lhe, por exemplo, verificar o resultado de uma operação numa entidade, depois de aplicar todas as regras de negócio, a partir da aplicação cliente. O usuário pode então decidir guardar ou não a entidade no servidor. @@ -82,20 +82,20 @@ Também é possível transmitir valores para quaisquer atributos da entidade. Es | __ENTITY | Parâmetros | Obrigatório - Verdadeiro para indicar ao servidor que o parâmetro é uma entidade | | __KEY | misto (do mesmo tipo que a chave primária) | Facultativo - Chave primária da entidade | -- If `__KEY` is not provided, a new entity is created on the server with the given attributes. -- If `__KEY` is provided, the entity corresponding to `__KEY` is loaded on the server with the given attributes +- Se `__KEY` não for fornecido, uma nova entidade é criada no servidor com os atributos fornecidos. +- Se `__KEY` for fornecido, a entidade correspondente a `__KEY` é carregada no servidor com os atributos fornecidos -Ver los ejemplos de [creación](#creating-an-entity) o de [actualización](#updating-an-entity) de las entidades. +Veja exemplos de [criando](#creating-an-entity) ou [atualização](#updating-an-entity). #### Parâmetro de entidade relacionada -Las mismas propiedades que para un [parámetro de entidad](#entity-parameter). Além disso, a entidade relacionada deve existir e ser referenciada por __KEY que contém a sua chave primária. +Mesmas propriedades de um [parâmetro de entidade](#entity-parameter). Além disso, a entidade relacionada deve existir e ser referenciada por __KEY que contém a sua chave primária. -Ver los ejemplos para [creación](#creating-an-entity-with-a-related-entity) o [actualización](#updating-an-entity-with-a-related-entity) de las entidades con las entidades relacionadas. +Veja exemplos de [criação](#creating-an-entity-with-a-related-entity) ou [atualização](#updating-an-entity-with-a-related-entity) das entidades com entidades relacionadas. ### Parâmetro de seleção da entidade -La selección de entidades debe haber sido definida previamente utilizando [$method=entityset]($method.md#methodentityset). +A seleção da entidade deve ter sido definida previamente usando [$method=entityset]($method.md#methodentityset). > Se o pedido enviar uma seleção de entidade modificada para o servidor, a função de modelo de dados ORDA chamada será automaticamente executada no servidor com a seleção de entidade modificada. @@ -105,7 +105,7 @@ La selección de entidades debe haber sido definida previamente utilizando [$met | __DATASET | Text | Obrigatório - entitySetID (UUID) da seleção de entidades | | __ENTITIES | Parâmetros | Obrigatório - Verdadeiro para indicar ao servidor que o parâmetro é uma seleção de entidade | -Ver ejemplo para [recibir una selección de entidades](#receiving-an-entity-selection-as-parameter). +Veja um exemplo para [recebendo uma seleção de entidades](#receiving-an-entity-selection-as-parameter). ## Exemplos de petições @@ -115,7 +115,7 @@ Esta base de dados é exposta como um datastore remoto no localhost (porta 8111) ### Utilizar uma função de classe do datastore -La clase de `DataStore` US_Cities ofrece una API: +A classe de `DataStore` US_Cities fornece uma API: ``` // DataStore class @@ -140,7 +140,7 @@ Pode então executar este pedido: ### Utilização de uma função de classe de dataclass -La clase de Dataclass `City` ofrece una PI que devuelve una entidad de ciudad a partir del nombre pasado en parámetro: +A classe Dataclass `City` fornece uma API que devolve uma entidade cidade a partir de um nome passado como parâmetro: ``` // City class @@ -187,7 +187,7 @@ Le résultat est une entité: ### Utilização de uma função de classe de uma entidade -La clase de entidad `CityEntity` ofrece una API: +A classe Entity `CityEntity` fornece uma API: ``` // CityEntity class @@ -212,7 +212,7 @@ Pode então executar este pedido: ### Usar uma função de classe de uma seleção de entidade -La clase de selección de entidad `CityEntity` ofrece una API: +A classe de selection de entidade `CitySelection` fornece uma API: ``` // CitySelection class @@ -237,7 +237,7 @@ Pode então executar este pedido: ### Usando uma função de classe entitySelection e um entitySet -La clase `StudentsSelection` tine una función `getAgeAverage`: +A classe `StudentsSelection` tem uma função `getAgeAverage`: ``` // StudentsSelection Class @@ -269,7 +269,7 @@ Uma vez criado um conjunto de entidades, é possível executar este pedido: ### Usando uma função de classe de seleção de entidades e um orderBy -La clase `StudentsSelection` tiene una función `getLastSummary`: +A classe `StudentsSelection` tem uma função `getLastSummary`: ``` // StudentsSelection Class @@ -298,7 +298,7 @@ Pode então executar este pedido: ### Utilizar uma entidade a ser criada no servidor -La clase de Dataclass `Students` tiene la función `pushData()` que recibe una entidad que contiene los datos del cliente. El método `checkData()` efectúa algunos controles. Se estiverem corretas, a entidade é guardada e devolvida. +A classe Dataclass `Students` tem a função `pushData()` recebendo uma entidade contendo dados do cliente. O método `checkData()` executa alguns controles. Se estiverem corretas, a entidade é guardada e devolvida. ``` // Students Class @@ -336,7 +336,7 @@ Corpo do pedido: }] ``` -Como ninguna `__KEY` es dada, una nueva entidad Students está cargada en el servidor **con los atributos del cliente**. Como la función `pushData()` ejecuta una acción `save()`, la nueva entidad es creada. +Já que não é dada nenhuma `__KEY`, é carregada uma nova entidade Students no servidor **com os atributos recebidos do cliente**. Como a função `pushData()` executa uma ação `save()`, a nova entidade foi criada. #### Resultados @@ -374,7 +374,7 @@ Corpo do pedido: }] ``` -Como `__KEY` es dada, la entidad Students está cargada con llave primaria 55 **con el valor lastname recibido por el cliente**. Como la función ejecuta una acción `save()`, la nueva entidad es actualizada. +Uma vez que `__KEY` é fornecido, a entidade Estudantes com a chave primária 55 é carregada **com o valor do sobrenome recebido do cliente**. Como a função executa uma ação `save()`, a entidade é atualizada. #### Resultados @@ -437,7 +437,7 @@ Corpo do pedido: ### Atualização de uma entidade com uma entidade relacionada -Neste exemplo, associamos uma escola existente a uma entidade Students. La clase `StudentsEntity` tiene una API: +Neste exemplo, associamos uma escola existente a uma entidade Students. A classe `StudentsEntity` tem uma API: ``` // StudentsEntity class @@ -447,9 +447,9 @@ Class extends Entity exposed Function putToSchool() var $1, $school , $0, $status : Object - //$1 is a Schools entity + //$1 é uma entidade Schools $school:=$1 - //Associate the related entity school to the current Students entity + //Associar a entidade escola relacionada à entidade Students atual This.school:=$school $status:=This.save() @@ -457,7 +457,9 @@ exposed Function putToSchool() $0:=$status ``` -You run this request, called on a Students entity : **POST** `http://127.0.0.1:8044/rest/Students(1)/putToSchool` Body of the request: +Você executa esta solicitação, chamada em uma entidade Students: +**POST** `http://127.0.0.1:8044/rest/Students(1)/putToSchool` +Corpo da solicitação: ``` [{ @@ -479,7 +481,7 @@ You run this request, called on a Students entity : **POST** `http://127.0.0.1:8 ### Receber uma seleção de entidade como parâmetro -En la clase de Dataclass `Students`, la función `setFinalExam()` actualiza una selección de entidad recibida ($1). En realidad, actualiza el atributo *finalExam* con el valor recibido ($2). Devolve as chaves primárias das entidades atualizadas. +Na classe de Dataclass `Students`, a função `setFinalExam()` atualiza uma seleção de entidade recebida ($1). En realidad, actualiza el atributo *finalExam* con el valor recibido ($2). Devolve as chaves primárias das entidades atualizadas. ``` // Students class @@ -548,7 +550,7 @@ As entidades com chaves primárias 1 e 2 foram atualizadas. ### Utilizar uma seleção de entidade actualizada no cliente -Utilizando la función `getAgeAverage()` [definida anteriormente](#using-an-entityselection-class-function-and-an-entityset). +Usando a função `getAgeAverage()` [definida acima](#using-an-entityselection-class-function-and-an-entityset). ```4d var $remoteDS, $newStudent, $students : Object diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/dataClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/dataClass.md index 31880cb58910bf..51e3db309e16d4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/dataClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/dataClass.md @@ -16,7 +16,7 @@ Os nomes de dataclass podem ser utilizados diretamente nos pedidos REST para tra | [**\{dataClass\}/{EntitySelectionClassFunction}**](ClassFunctions.md#function-calls) | `/City/getPopulation/?$filter="ID<3"` | Executa uma função de classe de uma seleção de entidade | | [**\{dataClass\}[{key}]/{EntityClassFunction}**](ClassFunctions.md#function-calls) | `City[2]/getPopulation` | Executa uma função de classe de uma entidade | -> Las llamadas a las funciones se detallan en la sección [Llamar las funciones de la clase ORDA](ClassFunctions.md). +> Chamadas de função são detalhadas na seção [Chamada das funções de classe ORDA](ClassFunctions.md). ## \{dataClass\} @@ -24,7 +24,7 @@ Devuelve todos los datos (por defecto las 100 primeras entidades) para una clase ### Descrição -When you call this parameter in your REST request, the first 100 entities are returned unless you have specified a value using [`$top/$limit`]($top_$limit.md). +Quando você chama este parâmetro em sua solicitação REST as primeiras 100 entidades são retornadas a menos que você tenha especificado um valor usando [`$top/$limit`]($top_$limit.md). Aqui está uma descrição dos dados retornados: @@ -44,7 +44,7 @@ Cada entidade contém as propriedades abaixo: | __TIMESTAMP | Date | Registro de hora da última modificação da entidade | | __STAMP | Number | Sello interno que se necesita cuando se modifica alguno de los valores de la entidad al utilizar `$method=update`. | -Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: +Se você quiser especificar quais atributos você deseja devolver, defina-os usando a seguinte sintaxe [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: `GET /rest/Company/name,address` @@ -135,15 +135,15 @@ Retorna todas as datas para uma classe de dados específica. ## \{dataClass\}\[{key}] -Devuelve los datos de la entidad específica definida por la llave primaria de la clase de datos, *por ejemplo*, `Company[22]` o `Company[IT0911AB2200]` +Retorna os dados para a entidade específica definida pela chave primária do banco de dados, *por exemplo.*, `Company[22]` ou `Company[IT0911AB2200]` ### Descrição -Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Para más información sobre la definición de una llave primaria, consulte la sección **Modifying the Primary Key** en el **Editor del modelo de datos**. +Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Passando a classe de dados e uma chave, pode recuperar toda a informação pública para a entidade. Para más información sobre los datos devueltos, consulte [\{dataClass\}](#dataclass). -Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: +Se você quiser especificar quais atributos você deseja devolver, defina-os usando a seguinte sintaxe [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: `GET /rest/Company[1]/name,address` @@ -186,11 +186,11 @@ Retorna os dados para uma entidade na qual os valores de atributo são definidas ### Descrição -Pasando la *clase de datos* y un *atributo* junto con un valor, se puede recuperar toda la información pública de esa entidad. O valor é um valor único para o atributo, mas não é a chave primária. +Passando o *dataClass* e um *atributo* com um valor, você pode recuperar todas as informações públicas para essa entidade. O valor é um valor único para o atributo, mas não é a chave primária. `GET /rest/Company:companyCode(Acme001)` -Si quiere especificar qué atributos quiere devolver, defínalos utilizando la siguiente sintaxis [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: +Se você quiser especificar quais atributos você deseja devolver, defina-os usando a seguinte sintaxe [{attribute1, attribute2, ...}](manData.md#selecting-attributes-to-get). Por exemplo: `GET /rest/Company:companyCode(Acme001)/name,address` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md index 84f3a8445b2f42..2f13834b8cf35d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/REST/manData.md @@ -15,7 +15,7 @@ To query data directly, you can do so using the [`$filter`]($filter.md) function Com o REST API, pode realizar todas as manipulações de dados que quiser em 4D. -To add and modify entities, you can call [`$method=update`]($method.md#methodupdate). Se quiser excluir uma ou mais entidades, você pode usar [`$method=delete`]($method.md#methoddelete). +To add and modify entities, you can call [`$method=update`]($method.md#methodupdate). Sintaxe Besides retrieving a single entity in a dataclass using [\{dataClass\}({key})](dataClass.md#dataclasskey), you can also write a [class function](ClassFunctions.md#function-calls) that returns an entity selection (or a collection). @@ -63,7 +63,7 @@ Para computar todos os valores e retornar um objeto JSON: ## Chamar as funções de classe do modelo de dados -Puede llamar las [funciones de clase usuarios](ClassFunctions.md) ORDA del modelo de datos vía las peticiones POST, para poder beneficiarse del API de la aplicación objetivo. Por ejemplo, si ha definido una función `getCity()` en la dataclass City, podría llamarla utilizando la siguiente petición: +Puede llamar las [funciones de clase usuarios](ClassFunctions.md) ORDA del modelo de datos vía las peticiones POST, para poder beneficiarse del API de la aplicación objetivo. For example, if you have defined a `getCity()` function in the City dataclass class, you could call it using the following request: `/rest/City/getCity` diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/processes.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/processes.md index 5890a2b380a4b1..f7f68a0dc17eed 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/processes.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/ServerWindow/processes.md @@ -39,7 +39,7 @@ A atividade do processo é a percentagem de tempo que 4D Server dedicou a este p - Processo usuário - nome do usuário 4D, - Processo web - caminho URL, - Nome do processo, -- Number of the process (as returned by the [`New process`](https://doc.4d.com/4dv19/help/command/en/page317.html) command for example). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. +- Número do processo (como retornado pelo comando [`New process`](https://doc.4d.com/4dv19/help/command/en/page317.html), por exemplo). O número do processo é o número atribuído no servidor. No caso de um processo global, este número pode ser diferente do atribuído na máquina cliente. - Estado atual do processo, - Tempo de execução (em segundos) do processo desde a sua criação, - Percentagem de tempo que 4D Server dedicou a este processo (rácio). @@ -85,9 +85,9 @@ A página também tem cinco botões de controle que atuam nos processos selecion - **Abortar proceso**: permite abortar el proceso o los procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. -> You can also abort the selected process(es) directly without displaying the confirmation dialog box by holding down the **Alt** key while clicking on this button, or by using the [`ABORT PROCESS BY ID`](https://doc.4d.com/4dv19/help/command/en/page1634.html) command. +> Você também pode cancelar o(s) processo(s) selecionado(s) diretamente sem exibir a caixa de diálogo de confirmação, segurando a tecla **Alt** enquanto clica neste botão, ou usando o [`ABORT PROCESS BY ID`](https://doc.md.com/4dv19/help/command/en/page1634.html). -- **Pausar proceso**: permite pausar los procesos seleccionados. +- **Pausar processo**: pode ser usado para pausar os processos selecionados. - **Activar proceso**: permite reactivar los procesos seleccionados. Os processos devem ter sido colocados em pausa anteriormente (utilizando o botão acima ou por programação); caso contrário, este botão não tem qualquer efeito. - **Depurar proceso**: permite abrir en el equipo servidor una o varias ventanas de depuración para el proceso o procesos seleccionados. Quando clicar neste botão, aparece uma caixa de diálogo de aviso para que se possa confirmar ou cancelar a operação. Note que a janela do depurador só é exibida quando o código 4D for realmente executado na máquina do servidor (por exemplo, em um gatilho ou na execução de um método com o atributo "Execute on Server"). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md index 520cf676c8595a..ee624c4bd5beb3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/httpRequests.md @@ -337,6 +337,6 @@ The 4D web server supports files uploaded in chunked transfer encoding from any ## Método projeto COMPILER_WEB -O método COMPILER\_WEB, se existir, é chamado sistematicamente quando o servidor HTTP recebe uma solicitação dinâmica e chama ao motor 4D. This is the case, for example, when the 4D Web server receives a posted form or a URL to process in [`On Web Connection`](#on-web-connection). This method is intended to contain typing and/or variable initialization directives used during Web exchanges. É utilizado pelo compilador quando a aplicação é compilada. O método COMPILER\_WEB é comum a todos os formulários Web. Por defeito, o método COMPILER_WEB não existe. É necessário criá-lo explicitamente. +O método COMPILER\_WEB, se existir, é chamado sistematicamente quando o servidor HTTP recebe uma solicitação dinâmica e chama ao motor 4D. O método COMPILER\_WEB, se existir, é chamado sistematicamente quando o servidor HTTP recebe uma solicitação dinâmica e chama ao motor 4D. This method is intended to contain typing and/or variable initialization directives used during Web exchanges. É utilizado pelo compilador quando a aplicação é compilada. O método COMPILER\_WEB é comum a todos os formulários Web. Por defeito, o método COMPILER_WEB não existe. É necessário criá-lo explicitamente. > The COMPILER_WEB project method is also called, if it exists, for each SOAP request accepted. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/qodly-studio.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/qodly-studio.md index c36851000438b5..988b5c23a2a6e5 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/qodly-studio.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/qodly-studio.md @@ -113,7 +113,7 @@ The official Qodly Studio documentation is available on the [Qodly documentation You can rely on this documentation and its associated resources for developing web applications powered by Qodly forms. However, depending on implementation stage, 4D developers will either use Qodly Studio or 4D IDE (see [Feature comparison](#feature-comparison)). -Code examples are provided in [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript), but since QodlyScript inherits from the 4D Language, you won't be lost. For more information, see the [From QodlyScript to 4D Language](from-qodlyscript-to-4d.md) page. +Code examples are provided in [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript), but since QodlyScript inherits from the 4D Language, you won't be lost. Code examples are provided in [QodlyScript](https://developer.qodly.com/docs/category/qodlyscript), but since QodlyScript inherits from the 4D Language, you won't be lost. :::info diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/sessions.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/sessions.md index cdb93a4254d326..9e8895ae9a968c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/sessions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R6/WebServer/sessions.md @@ -38,7 +38,7 @@ In any cases, the setting is local to the machine; so it can be different on the ## Session implementation -Cuando [se habilitan las sesiones](#enabling-sessions), se implementan mecanismos automáticos, basados en una cookie privada establecida por el propio 4D: "4DSID_*AppName*", donde *AppName* es el nombre del proyecto de la aplicación. Este cookie faz referência à sessão web atual da aplicação. +Cuando [se habilitan las sesiones](#enabling-sessions), se implementan mecanismos automáticos, basados en una cookie privada establecida por el propio 4D: "4DSID__AppName_", donde *AppName* es el nombre del proyecto de la aplicación. Este cookie faz referência à sessão web atual da aplicação. :::info @@ -46,13 +46,13 @@ The cookie name can be get using the [`.sessionCookieName`](API/WebServerClass.m ::: -1. En cada petición del cliente web, el servidor web comprueba la presencia y el valor de la cookie privada "4DSID_*AppName*". +1. En cada petición del cliente web, el servidor web comprueba la presencia y el valor de la cookie privada "4DSID__AppName_". 2. If the cookie has a value, 4D looks for the session that created this cookie among the existing sessions; if this session is found, it is reused for the call. 3. Se a solicitação do cliente não corresponder a uma sessão já aberta: -- se crea una nueva sesión con una cookie privada "4DSID_*AppName*" en el servidor web +- se crea una nueva sesión con una cookie privada "4DSID__AppName_" en el servidor web - se crea un nuevo objeto Guest `Session` dedicado a la sesión web escalable. :::note diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/DataClassClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/DataClassClass.md index 347d6299579dfb..0f744c321627c7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/DataClassClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/DataClassClass.md @@ -940,7 +940,7 @@ Fórmulas nas consultas podem receber parâmetros através de $1. Este ponto est | Incluído em | IN | Retorna dados iguais a ao menos um dos valores de uma coleção ou de um conjunto de valores, admite o coringa (@) | | Contém palavra chave | % | As palavras chaves podem ser usadas em atributos de string ou imagem | -- **value**: o valor a comparar ao valor atual da propriedade de cada entidade na seleção de entidade. Pode ser um **marcador** (ver **Uso de marcadores** abaixo) ou qualquer expressão que coincida com a propriedade de tipo de dados. +- **value**: o valor a comparar ao valor atual da propriedade de cada entidade na seleção de entidade. Pode ser um **marcador** (ver **Uso de marcadores** abaixo) ou qualquer expressão que coincida com a propriedade de tipo de dados. Note that, in case of type mismatch with scalar types (text, date, number...), 4D will try to convert the **value** type to the attribute data type whenever possible, for an easier handling of values coming from the Internet. For example, if the string "v20" is entered as **value** to compare with an integer attribute, it will be converted to 20. Quando usar um valor constante, as regras abaixo devem ser respeitadas: - A constante de tipo texto pode ser passada com ou sem aspas simples (ver **Uso de aspas mais abaixo**). Para pesquisar uma stirng dentro de uma string (uma pesquisa "contém") use o símbolo coringa (@) em valor para isolar a string a ser pesquisada como mostrado neste exemplo: "@Smith@". As palavras chaves abaixo são proibidas para constantes de texto: true, false. - Valores constantes de tipo **booleano**: **true** ou **false** (diferencia maiúscula de minúscula). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md index 4ed44e47abf465..4d7af6a78403ef 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/EntityClass.md @@ -98,9 +98,11 @@ The attribute value type depends on the attribute [kind](DataClassClass.md#attri #### Descrição -The `.clone()` function creates in memory a new entity referencing the same record as the original entity. . +The `.clone()` function creates in memory a new entity referencing the same record as the original entity. -> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save( )`](#save) function is executed. +This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity. + +> Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed. Esta função só pode ser usada com entidades já salvas no banco de dados. Não pode ser chamado em uma entidade recém-criada (para a qual [`.isNew()`](#isnew) retorna **True**). diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md index 07cf65cff533cf..071a37106d802c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/HTTPRequestClass.md @@ -472,7 +472,7 @@ The `.url` property contains the URL o ## .wait() -**.wait**( { *time* : Real } ) : HTTPRequestClass +**.wait**( { *time* : Real } ) : 4D.HTTPRequest diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/WebServerClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/WebServerClass.md index 1338ec06b9a2d4..8956b4e9e347ae 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/WebServerClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/API/WebServerClass.md @@ -77,7 +77,7 @@ Path of the folder where t **.characterSet** : Number
**.characterSet** : Text -The character set that the 4D Web Server should use to communicate with browsers connecting to the application. O valor padrão realmente depende da linguagem do SO. Can be a MIBEnum integer or a Name string, identifiers [defined by IANA](http://www.iana.org/assignments/character-sets/character-sets.xhtml). Aqui está a lista de identificadores correspondentes aos conjuntos de caracteres suportados pelo Servidor Web 4D: +The character set that the 4D Web Server should use to communicate with browsers connecting to the application. O valor padrão realmente depende da linguagem do SO. O valor padrão realmente depende da linguagem do SO. Aqui está a lista de identificadores correspondentes aos conjuntos de caracteres suportados pelo Servidor Web 4D: - 4 = ISO-8859-1 - 12 = ISO-8859-9 @@ -111,7 +111,7 @@ The cipher list used for the sec **.CORSEnabled** : Boolean -The CORS (*Cross-origin resource sharing*) service status for the web server. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. When enabled (True), XHR calls (e.g. REST requests) from Web pages outside the domain can be allowed in your application (you need to define the list of allowed addresses in the CORS domain list, see `CORSSettings` below). Quando desativado (False, padrão), todas as solicitações de cruzamento de sites enviadas com CORS são ignoradas. Quando habilitado (verdadeiro) e um domínio ou método não permitido envia uma solicitação de site cruzado, ele é rejeitado com uma resposta de erro "403 - proibido". +The CORS (*Cross-origin resource sharing*) service status for the web server. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. Por razões de segurança, solicitações de "cross-domain" são proibidas no nível do navegador por padrão. Quando desativado (False, padrão), todas as solicitações de cruzamento de sites enviadas com CORS são ignoradas. Quando habilitado (verdadeiro) e um domínio ou método não permitido envia uma solicitação de site cruzado, ele é rejeitado com uma resposta de erro "403 - proibido". Padrão: Falso (desabilitado) @@ -127,19 +127,19 @@ For more information about CORS, please refer to the [Cross-origin resource shar Contains the list of allowed hosts and methods for the CORS service (see [`CORSEnabled`](#corsenabled) property). Cada objeto deve conter uma propriedade **host** e, opcionalmente, uma propriedade **methods**: -- **host** (text, mandatory): Domain name or IP address from where external pages are allowed to send data requests to the Server via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. If *host* is not present or empty, the object is ignored. Várias sintaxes são suportadas: +- **host** (text, mandatory): Domain name or IP address from where external pages are allowed to send data requests to the Server via CORS. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Vários atributos de domínio podem ser adicionados para criar uma lista branca. Várias sintaxes são suportadas: - 192.168.5.17:8081 - 192.168.5.17 - 192.168.\* - 192.168.\*:8081 -
Disabled if one selected object position is locked by a CSS property | |  | [Distribuição](#distributing-objects) | Este botão está ligado a um menu que permite agrupar e desagrupar seleções de objetos no formulário. It is enabled (or not) depending on the objects selected.
Disabled if one selected object position is locked by a CSS property | -|  | [Level](#layering-objects) | This button is linked to a menu that allows aligning objects in the form. É ativada (ou não) em função dos objetos selecionados. | +|  | [Level](#layering-objects) | This button is linked to a menu that allows changing the level of objects in the form. É ativada (ou não) em função dos objetos selecionados. | |  | [Group/Ungroup](#grouping-objects) | Este botão está ligado a um menu que permite agrupar e desagrupar seleções de objetos no formulário. É ativada (ou não) em função dos objetos selecionados. | |  | [Display and page management](forms.html#form-pages) | Esta área permite passar de uma página de formulário para outra e adicionar páginas. Para navegar entre páginas de formulários, clique nos botões de seta, ou clique na área central e escolha a página a exibir a partir do menu que aparece. Se clicar no botão da seta para a direita enquanto é exibida a última página do formulário, 4D permite-lhe adicionar uma página. | |  | [CSS Preview](#css-preview) | Este botão é utilizado para seleccionar o Modo CSS a utilizar. | @@ -70,7 +70,7 @@ A barra de ferramentas contém os seguintes elementos: |  | [Displaying shields](#shields) | Each click on this button causes the successive display of each type of form shield. The button is also linked to a menu that allows directly selecting the type of shield to display. | |  | [Preconfigured object library](objectLibrary.html) | This button displays the preconfigured object library that provides numerous objects with certain properties that have been predefined. | |  | [List Box Builder](#list-box-builder) | Este botão cria list boxes entity selection. | -|  | [Insert fields](#insert-fields) | This button inserts all fields (except object and blob type fields) of the form table in the form, along with their labels and with respect to interface standards. | +|  | [Insert fields](#insert-fields) | Esse botão insere todos os campos (exceto os campos do tipo objeto e bolha) da tabela do formulário no formulário, juntamente com seus rótulos e de acordo com os padrões de interface. | ### Barra de objetos @@ -90,7 +90,7 @@ The object bar contains all the active and inactive objects that can be used in |  | [Splitter](FormObjects/splitters.md) / [Controle de guia](FormObjects/tabControl.md) | D | |  | [Plug-in Area](FormObjects/pluginArea_overview.md) / [Subform](FormObjects/subform_overview.md) / [Web Area](FormObjects/webArea_overview.md) / [4D Write Pro](FormObjects/writeProArea_overview.md) / [4D View Pro](FormObjects/viewProArea_overview.md) | X | -To draw an object type, select the corresponding button and then trace the object in the form. Após criar um objeto, você pode modificar seu tipo utilizando a Lista de Propriedades. Mantenha pressionada a tecla **Shift** ao desenhar para restringir o objeto a uma forma regular. Lines are constrained to horizontal, 45°, or vertical, rectangles are constrained to squares, and ovals are constrained to circles. +To draw an object type, select the corresponding button and then trace the object in the form. Após criar um objeto, você pode modificar seu tipo utilizando a Lista de Propriedades. To draw an object type, select the corresponding button and then trace the object in the form. Lines are constrained to horizontal, 45°, or vertical, rectangles are constrained to squares, and ovals are constrained to circles. The current variant of the theme is the object that will be inserted in the form. Ao clicar no lado direito de um botão, você acessa o menu de variantes: @@ -134,7 +134,7 @@ Once the object is placed in the form, you can modify its characteristics using É possível trabalhar com dois tipos de objetos nos formulários: -- **Objetos estáticos** (linhas, quadros, imagens de fundo, etc.): Esses objetos são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Estão disponíveis na barra de objetos do editor de formulários. Você também pode definir seus atributos gráficos (tamanho, cor, fonte, etc.) e suas propriedades de redimensionamento usando a Lista de propriedades. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. +- **Objetos estáticos** (linhas, quadros, imagens de fundo, etc.): Esses objetos são geralmente usados para definir a aparência do formulário e de seus rótulos, bem como para a interface gráfica. Estão disponíveis na barra de objetos do editor de formulários. Estão disponíveis na barra de objetos do editor de formulários. Estão disponíveis na barra de objetos do editor de formulários. Os objetos estáticos não têm variáveis associadas como os objetos ativos. No entanto, é possível inserir objetos dinâmicos em objetos estáticos. - **Objetos ativos**: Esses objetos executam tarefas ou funções na interface e podem assumir várias formas: campos, botões, listas roláveis, etc. Cada objeto ativo é associado com um campo ou uma variável. @@ -142,11 +142,11 @@ Once the object is placed in the form, you can modify its characteristics using Before you can perform any operation on an object (such as changing a line width or font), you need to select the object that you want to modify. -Para seleccionar um objecto utilizando a barra de ferramentas: +To select an object using the toolbar: 1. Clique na ferramenta Seta na barra de ferramentas
-Click the Arrow tool in the toolbar. When you move the pointer into the form area, it becomes a standard arrow-shaped pointer.
Quando você move o ponteiro para a área do formulário, ele se torna um ponteiro padrão em forma de seta
. 2. Clique no objecto que deseja selecionar. As alças de redimensionamento identificam o objeto selecionado
@@ -155,7 +155,7 @@ Para selecionar um objecto utilizando a Lista de Propriedades: 1. Escolher o nome do objecto na lista pendente da Lista de Objectos localizada no topo da Lista de Propriedades. Usando estes dois métodos, pode seleccionar um objecto que esteja escondido por outros objectos ou localizado fora da área visível da janela actual. Para cancelar a seleção de um objeto, clique fora do limite do objeto ou **Shift+clique** no objeto. -> \> > It is also possible to select objects by double-clicking them in the result window of ""Find in design" operation. +> \> > > It is also possible to select objects by double-clicking them in the result window of ""Find in design" operation. ### Selecção de múltiplos objectos @@ -194,7 +194,7 @@ A caixa de diálogo "Duplicate Many" é exibida quando você seleciona um ou mai  -- Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. Por exemplo, se quiser três colunas e duas linhas de objectos, introduza 3 na área de Coluna(s) e 2 na área de Linha(s). Se quiser três novas cópias horizontais de um objecto, introduza 4 na área de Coluna(s) e deixe o valor por defeito, 1, na área de Linha(s). +- Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. Por exemplo, se quiser três colunas e duas linhas de objectos, introduza 3 na área de Coluna(s) e 2 na área de Linha(s). Na área superior, introduza o número de colunas e linhas (linhas) de objectos que pretende obter. - Para linhas e colunas, defina o offset que deseja deixar entre cada cópia. O valor deve ser expresso em pontos. It will be applied to each copy, or copies, in relation to the original object. For example, if you want to leave a vertical offset of 20 points between each object and the height of the source object is 50 points, enter 70 in the column’s “Offset” area. @@ -275,7 +275,7 @@ Para exibir essa caixa de diálogo, selecione os objetos que deseja alinhar e es - Nas áreas "Alinhamento Esquerda/Direita" e/ou "Alinhamento Superior/Inferior", clique no ícone que corresponde ao alinhamento que você deseja executar.A área de exemplo exibe os resultados da sua seleção.
-- Para executar um alinhamento que use o esquema de âncora padrão, clique em **Preview** ou **Apply**. In this case 4D uses the object that is the furthest in the alignment’s direction as the anchor and aligns the other objects to that object. Por exemplo, se quiser realizar um alinhamento correcto num conjunto de objectos, o objecto mais à direita será utilizado como âncora. OU:Para alinhar objetos a um objeto específico, selecione a opção **Alinhar em** e selecione o objeto ao qual você deseja que os outros objetos sejam alinhados na lista de objetos. In this case, the position of the reference object will not be altered.
+- Para executar um alinhamento que use o esquema de âncora padrão, clique em **Preview** ou **Apply**. Nesse caso, 4D usa o objeto que está mais distante na direção do alinhamento como âncora e alinha os outros objetos a esse objeto. Por exemplo, se quiser realizar um alinhamento correcto num conjunto de objectos, o objecto mais à direita será utilizado como âncora. OU:Para alinhar objetos a um objeto específico, selecione a opção **Alinhar em** e selecione o objeto ao qual você deseja que os outros objetos sejam alinhados na lista de objetos. In this case, the position of the reference object will not be altered.
Você pode visualizar os resultados do alinhamento clicando no botão **Preview**. Os objetos são então alinhados no editor de formulários, mas como a caixa de diálogo não desaparece, ainda é possível cancelar ou aplicar o alinhamento. @@ -312,7 +312,7 @@ Para distribuir objetos com igual espaçamento: 1. Selecione três ou mais objetos e clique na ferramenta Distribuir pretendida. -2. Na barra de ferramentas, clique na ferramenta de distribuição que corresponde à distribuição que você deseja aplicar.
OUSelecione um comando de menu de distribuição no submenu **Alinhar** no menu **Objeto** ou no menu de contexto do editor.
4D distribui os objetos apropriadamente. Objects are distributed using the distance to their centers and the largest distance between two consecutive objects is used as a reference. +2. Na barra de ferramentas, clique na ferramenta de distribuição que corresponde à distribuição que você deseja aplicar.
OUSelecione um comando de menu de distribuição no submenu **Alinhar** no menu **Objeto** ou no menu de contexto do editor.
4D distribui os objetos apropriadamente. Objects are distributed using the distance to their centers and the largest distance between two consecutive objects is used as a reference. Para distribuir objetos utilizando a caixa de diálogo Alinhar e distribuir: @@ -320,7 +320,7 @@ Para distribuir objetos utilizando a caixa de diálogo Alinhar e distribuir: 2. Seleccione el comando **Alineación** del submenú **Alinear** del menú **Objeto** o del menú contextual del editor. A seguinte caixa de diálogo é exibida: -3. Nas áreas de Alinhamento Esquerdo/Direita e/ou Topo/Bottom Alinhamento, clique no ícone de distribuição padrão: (ícone padrão de distribuição horizontal)
A área de exemplo exibe os resultados da sua seleção. +3. Nas áreas de Alinhamento Esquerdo/Direita e/ou Topo/Bottom Alinhamento, clique no ícone de distribuição padrão: (ícone padrão de distribuição horizontal)
A área de exemplo exibe os resultados da sua seleção. 4. Para executar uma distribuição que use o esquema padrão, clique em **Preview** ou *Apply*.Nesse caso, o 4D executará uma distribuição padrão, de modo que os objetos sejam dispostos com uma quantidade igual de espaço entre eles
. OU:Para executar uma distribuição específica, selecione a opção **Distribute** (por exemplo, se quiser distribuir os objetos com base na distância até o lado direito). Esta opção funciona como um interruptor. If the Distribute check box is selected, the icons located below it perform a different function:
@@ -333,7 +333,7 @@ Você pode visualizar o resultado real de suas configurações clicando no botã ### Gerenciar os planos dos objetos -You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. For example, you may have a graphic that you want to appear behind the fields in a form. O 4D oferece quatro itens de menu, **Mover para trás**, **Mover para frente**, **Subir um nível** e **Descer um nível**, que permitem que você coloque objetos em camadas no formulário. These layers also determine the default entry order (see Modifying data entry order). A figura abaixo mostra objetos à frente e atrás de outros objetos: +You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. For example, you may have a graphic that you want to appear behind the fields in a form. You will sometimes have to rearrange objects that are obstructing your view of other objects in the form. These layers also determine the default entry order (see Modifying data entry order). A figura abaixo mostra objetos à frente e atrás de outros objetos:  @@ -373,13 +373,13 @@ In cases such as this, a custom data entry order allows you to enter the informa You can view the current entry order either using the “Entry order” shields, or by using the “Entry order” mode. No entanto, você só pode modificar a ordem de entrada usando o modo “Ordem de entrada”. -This paragraph describes viewing and modifying the entry order using the “Entry order” mode. Para obter mais informações sobre como visualizar a ordem de entrada usando escudos, consulte [Using shields](#using-shields). +This paragraph describes viewing and modifying the entry order using the “Entry order” mode. You can view the current entry order either using the “Entry order” shields, or by using the “Entry order” mode. Para ver ou alterar a ordem de entrada: 1. Selecione **Pedido de entrada** no menu **Formulário** ou clique no botão na barra de ferramentas da janela:
- Choose Entry Order from the Form menu or click on the Entry Order button in the toolbar of the window:The pointer turns into an entry order pointer and 4D draws a line in the form showing the order in which it selects objects during data entry. A visualização e alteração da ordem de introdução de dados são as únicas acções que pode realizar até clicar em qualquer ferramenta na paleta Ferramentas.
+ O ponteiro se transforma em um ponteiro de ordem de entrada e 4D desenha uma linha na forma mostrando a ordem em que ele seleciona objetos durante a entrada de dados. A visualização e alteração da ordem de introdução de dados são as únicas acções que pode realizar até clicar em qualquer ferramenta na paleta Ferramentas.
2. Para mudar a ordem de entrada de dados, posicione o ponteiro em um objeto no formulário e, enquanto mantém pressionado o botão do mouse, arraste o ponteiro para o objeto que deseja na ordem de entrada de dados.4D ajustará a ordem de entrada de acordo.
diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/FormEditor/forms.md b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/FormEditor/forms.md
index 8ba31cb5294cda..6c201e1b8f20c8 100644
--- a/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/FormEditor/forms.md
+++ b/i18n/pt/docusaurus-plugin-content-docs/version-20-R7/FormEditor/forms.md
@@ -18,7 +18,7 @@ Os formulários também podem conter outros formulários através das seguintes
- **Interface de Desenvolvedor 4D:** Crie novos formulários a partir do menu **Arquivo** ou da janela **Explorador**.
- **Form Editor**: Modifique seus formulários usando o **[Form Editor] (FormEditor/formEditor.md)**.
-- **Código JSON:** Crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado] (Project/architecture.md#sources-folder). Exemplo:
+- **Código JSON:** crie e projete seus formulários usando JSON e salve os arquivos de formulário no [local apropriado](Project/architecture.md#sources-folder). Exemplo:
```
{
@@ -111,7 +111,7 @@ Quando um formulário é executado, os objetos são carregados e combinados na s
3. Página zero do formulário aberto
4. Página actual do formulário aberto.
-Essa ordem determina a [ordem de entrada] padrão (../FormEditor/formEditor.html#data-entry-order) dos objetos no formulário.
+Essa ordem determina a [ordem de entrada](../FormEditor/formEditor.html#data-entry-order) padrão dos objetos no formulário.
> Apenas as páginas 0 e 1 de um formulário herdado podem aparecer noutros formulários.
@@ -121,7 +121,7 @@ Para definir um formulário herdado, as propriedades [Inherited Form Name](prope
Um formulário pode herdar de um formulário de projeto, definindo a propriedade [Inherited Form Table] (properties_FormProperties.md#inherited-form-table) como `\History
- -|Release|Changes| -|---|---| -|20 R7|Class added| - -| -|[](#headers)
| -|[](#setbody)
| -|[](#setheader)
| -|[](#setstatus)
| -|[](#status)
| - -:::note - -A 4D.OutgoingMessage object is a [non-sharable](../Concepts/shared.md) object. - -::: - - - - - - -## .body - -**body** : any - -#### Description - -The `.body` property contains the outgoing message body. The following data types are supported in the `.body` property: - -- text -- blob -- object -- image - -The `.body` property is read-write. - -You can also set the `.body` property using the [`setBody()`](#setbody) function, in which case the `content-type` header is automatically set. - - - - - -## .headers - -**headers** : Object - -#### Description - -The `.headers` property contains the current headers of the outgoing message as key/value pairs. - -The `.headers` property is read-only. To set a header, use the [`setHeader()`](#setheader) function. - - - - - -## .setBody() - -**.setBody**( *body* : any ) - - - -|Parameter|Type||Description| -|---|--- |---|------| -|body|any |->|Body of the outgoing message| - - -#### Description - -The `.setBody()` function sets the outgoing message *body*. - - The following data types are supported in the *body*: - -- Text -- Blob -- Object -- Image - -When this function is used, the content-type header is automatically set depending on the *body* type: - -- Content-Type:text/plain if the body is a Text -- Content-Type:application/octet-stream if body is a Blob -- Content-Type:application/json if body is an Object -- Content-Type:image/jpeg, image/gif... if body is an Image - -If *body* is not of a supported value type, an error is returned. - - - - - -## .setHeader() - -**.setHeader**( *key* : Text ; *value* : Text ) - - - -|Parameter|Type||Description| -|---|--- |---|------| -|key|Text|->|Header property to set| -|value|Text|->|Value of the header property| - - -#### Description - -The `.setHeader()` function sets the outgoing message header *key* with the provided *value*. If both parameters are not Text values, an error is raised. - -When returning a 4D.OutgoingMessage object instance, 4D automatically sets some headers (e.g. `Set-Cookie` with `WASID4D=...` and `4DSID__ProjectName_=....`). - -:::note - -If you set a *value* for the "Content-Type" header *key*, make sure you call this function after the call to [`setBody()`](#setbody), because `setBody()` automatically fills this header. For a list of "Content-Type" header values, please refer to the [`WEB SEND BLOB`](../commands-legacy/web-send-blob.md) documentation. - -::: - - - - - -## .setStatus() - -**.setStatus**( *status* : Integer ) - - - -|Parameter|Type||Description| -|---|--- |---|------| -|status|Integer|->|Status to set| - - -#### Description - -The `.setStatus()` function sets the `status` property with the given *status*. - -If *status* is not an integer value, an error is raised. - -For a list of HTTP status codes, please refer the [HTTP status code list on Wikipedia](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes). - - - - - - - -## .status - -**status** : Integer - -#### Description - -The `.status` property contains the current status of the outgoing message. This property can be set using the [`setStatus()`](setstatus) function. - - diff --git a/versioned_docs/version-20-R7/Concepts/classes.md b/versioned_docs/version-20-R7/Concepts/classes.md index f61e445431386f..d019550b570c0a 100644 --- a/versioned_docs/version-20-R7/Concepts/classes.md +++ b/versioned_docs/version-20-R7/Concepts/classes.md @@ -117,7 +117,7 @@ Available classes are accessible from their class stores. Two class stores are a |Parameter|Type||Description| |---|---|---|---| -|classStore|Object|←|User class store for the project or component| +|classStore|Object|←|User class store for the project or component| The `cs` command returns the user class store for the current project or component. It returns all user classes [defined](#class-definition) in the opened project or component. By default, only project [ORDA classes](ORDA/ordaClasses.md) are available. @@ -136,7 +136,7 @@ $instance:=cs.myClass.new() |Parameter|Type||Description| |---|---|---|---| -|classStore|Object|←|4D class store| +|classStore|Object|←|4D class store| The `4D` command returns the class store for available built-in 4D classes. It provides access to specific APIs such as [CryptoKey](API/CryptoKeyClass.md). diff --git a/versioned_docs/version-20-R7/FormObjects/text.md b/versioned_docs/version-20-R7/FormObjects/text.md index 747bea46c6968f..c9c81b1d4a9f95 100644 --- a/versioned_docs/version-20-R7/FormObjects/text.md +++ b/versioned_docs/version-20-R7/FormObjects/text.md @@ -51,4 +51,4 @@ Once a text is rotated, you can still change its size or position, as well as al -[Bold](properties_Text.md#bold) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Corner radius](properties_CoordinatesAndSizing.md#corner-radius) - [Fill Color(properties_BackgroundAndBorder.md#background-color--fill-color) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Orientation](properties_Text.md#orientation) - [Right](properties_CoordinatesAndSizing.md#right) - [Title](properties_Object.md#title) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[Bold](properties_Text.md#bold) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Corner radius](properties_CoordinatesAndSizing.md#corner-radius) - [Fill Color](properties_BackgroundAndBorder.md#background-color--fill-color) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Orientation](properties_Text.md#orientation) - [Right](properties_CoordinatesAndSizing.md#right) - [Title](properties_Object.md#title) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) diff --git a/versioned_docs/version-20-R7/Notes/updates.md b/versioned_docs/version-20-R7/Notes/updates.md index f50ae89573fc96..d5c6b3984d6a47 100644 --- a/versioned_docs/version-20-R7/Notes/updates.md +++ b/versioned_docs/version-20-R7/Notes/updates.md @@ -199,7 +199,7 @@ See [**Release Notes for 4D 20.x LTS**](../../version-20/Notes/updates.md). |Library|Current version|Updated in 4D|Comment| |---|---|---|----| |BoringSSL|0aa300b|20 R6|Used for QUIC| -|CEF|128|**20 R7**|Chromium 6613| +|CEF|121|20 R5|Chromium 6167| |Hunspell|1.7.2|20|Used for spell checking in 4D forms and 4D Write Pro| |ICU|73.2|20|This major upgrade forces an automatic rebuild of alphanumeric, text and object indexes.| |libldap|2.6.7|20 R6|| diff --git a/versioned_docs/version-20-R7/Project/code-overview.md b/versioned_docs/version-20-R7/Project/code-overview.md index afe85271ef0f08..4350d5eca2fd89 100644 --- a/versioned_docs/version-20-R7/Project/code-overview.md +++ b/versioned_docs/version-20-R7/Project/code-overview.md @@ -6,8 +6,7 @@ title: Methods and classes The 4D code used across your project is written in [methods](../Concepts/methods.md) and [classes](../Concepts/classes.md). -The 4D IDE provides you with various features to create, edit, export, or delete your code. You will usually use the 4D [code editor](../code-editor/write-class-method.md) to work with your code. - +The 4D IDE provides you with various features to create, edit, export, or delete your code. You will usually use the included 4D [code editor](../code-editor/write-class-method.md) to work with your code. You can also use other editors such as **VS Code**, for which the [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode) is available. ## Creating methods diff --git a/versioned_docs/version-20-R7/Project/overview.md b/versioned_docs/version-20-R7/Project/overview.md index 758ffbb0500ca1..bbe26cf681f2dc 100644 --- a/versioned_docs/version-20-R7/Project/overview.md +++ b/versioned_docs/version-20-R7/Project/overview.md @@ -8,7 +8,7 @@ A 4D project contains all of the source code of a 4D application, whatever its d ## Project files -4D project files are open and edited using regular 4D platform applications (4D or 4D Server). With 4D, full-featured editors are available to manage files, including a structure editor, a Code Editor, a form editor, a menu editor... +4D project files are open and edited using regular 4D platform applications (4D or 4D Server). With 4D, full-featured editors are available to manage files, including a structure editor, a [Code Editor](../code-editor/write-class-method.md), a [form editor](../FormEditor/formEditor.md), a menu editor... Since projects are in human-readable, plain text files (JSON, XML, etc.), they can be read or edited manually by developers, using any code editor. diff --git a/versioned_docs/version-20-R7/WebServer/qodly-studio.md b/versioned_docs/version-20-R7/WebServer/qodly-studio.md index 0e10f7c6777c9d..6cbad2624fcc24 100644 --- a/versioned_docs/version-20-R7/WebServer/qodly-studio.md +++ b/versioned_docs/version-20-R7/WebServer/qodly-studio.md @@ -143,7 +143,7 @@ There is no direct compatibility between apps implemented with 4D and apps imple |Qodly pages|Qodly Studio Page Editor|Qodly Studio Page Editor| |Desktop forms|4D IDE|*not supported*| |Programming language|4D Language featuring ORDA|[QodlyScript](https://developer.qodly.com/docs/category/qodlyscript) featuring ORDA| -|Coding IDE|4D IDE code editor *or* VS Code with [4D extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2))|Qodly Studio code editor| +|Coding IDE|4D IDE code editor *or* VS Code with [4D-Analyzer extension](https://github.com/4d/4D-Analyzer-VSCode)
*4D Server only*: Qodly Studio code editor (see (2))|Qodly Studio code editor| |Debugger|4D IDE debugger
*4D Server only*: Qodly Studio debugger (see [this paragraph](#using-qodly-debugger-on-4d-server))|Qodly Studio debugger| |REST/Web roles and privileges|roles.json direct edit/Qodly Studio roles and privileges editor|Qodly Studio role and privileges editor| diff --git a/versioned_docs/version-20-R7/code-editor/write-class-method.md b/versioned_docs/version-20-R7/code-editor/write-class-method.md index 04baaac1c02f51..2d413a4a04fa41 100644 --- a/versioned_docs/version-20-R7/code-editor/write-class-method.md +++ b/versioned_docs/version-20-R7/code-editor/write-class-method.md @@ -13,6 +13,12 @@ You can scroll through the contents of methods, classes and functions, which can The 4D Code Editor provides basic syntax error-checking. Additional error-checking is performed when the code executes. For more information on how to handle errors, see [Debugging](../Debugging/basics.md). +:::note + +If you are used to coding with **VS Code**, you can also use this editor with 4D code after installing the [4D-Analyzer](https://github.com/4d/4D-Analyzer-VSCode) extension. + +::: + ## Interface ### Toolbar diff --git a/versioned_docs/version-20-R7/commands-legacy/activated.md b/versioned_docs/version-20-R7/commands-legacy/activated.md index cd82ef1479214c..13aa0eb4b3502a 100644 --- a/versioned_docs/version-20-R7/commands-legacy/activated.md +++ b/versioned_docs/version-20-R7/commands-legacy/activated.md @@ -20,7 +20,7 @@ displayed_sidebar: docs The **Activated** command (obsolete) returns **True** in a form method when the window containing the form becomes the frontmost window of the frontmost process. -**Note:** This command is equivalent to using [Form event code](form-event-code.md) and testing whether it returns the On Activate event. +**Note:** This command is equivalent to using [Form event code](../commands/form-event-code.md) and testing whether it returns the On Activate event. **WARNING:** Do not place a command such as [TRACE](trace.md) or [ALERT](alert.md)in the **Activated** phase of the form, as this will cause an endless loop. @@ -29,4 +29,4 @@ displayed_sidebar: docs #### See also [Deactivated](deactivated.md) -[Form event code](form-event-code.md) \ No newline at end of file +[Form event code](../commands/form-event-code.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/after.md b/versioned_docs/version-20-R7/commands-legacy/after.md index db9d459e536400..e21c2e6f13fc34 100644 --- a/versioned_docs/version-20-R7/commands-legacy/after.md +++ b/versioned_docs/version-20-R7/commands-legacy/after.md @@ -22,8 +22,8 @@ displayed_sidebar: docs In order for the **After** execution cycle to be generated, make sure that the On Validate event property for the form and/or the objects has been selected in the Design environment. -**Note:** This command is equivalent to using [Form event code](form-event-code.md) and testing whether it returns the On Validate event. +**Note:** This command is equivalent to using [Form event code](../commands/form-event-code.md) and testing whether it returns the On Validate event. #### See also -[Form event code](form-event-code.md) \ No newline at end of file +[Form event code](../commands/form-event-code.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/array-text.md b/versioned_docs/version-20-R7/commands-legacy/array-text.md index 1abb962a40d13c..4e73032e807c68 100644 --- a/versioned_docs/version-20-R7/commands-legacy/array-text.md +++ b/versioned_docs/version-20-R7/commands-legacy/array-text.md @@ -55,6 +55,3 @@ This example creates an interprocess array of 50 [Text](# "A character string th End for ``` -#### See also - -*\_o\_ARRAY STRING* \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/before-selection.md b/versioned_docs/version-20-R7/commands-legacy/before-selection.md index 426928ba00ba42..08f0371dc1aa3f 100644 --- a/versioned_docs/version-20-R7/commands-legacy/before-selection.md +++ b/versioned_docs/version-20-R7/commands-legacy/before-selection.md @@ -59,6 +59,6 @@ This form method is used during the printing of a report. It sets a variable, *v [End selection](end-selection.md) [FIRST RECORD](first-record.md) -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [PREVIOUS RECORD](previous-record.md) [PRINT SELECTION](print-selection.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/before.md b/versioned_docs/version-20-R7/commands-legacy/before.md index 5df855eb2c5424..94a080a68f6b82 100644 --- a/versioned_docs/version-20-R7/commands-legacy/before.md +++ b/versioned_docs/version-20-R7/commands-legacy/before.md @@ -22,8 +22,8 @@ displayed_sidebar: docs In order for the **Before** execution cycle to be generated, make sure that the On Load event property for the form and/or the objects has been selected in the Design environment. -**Note:** This command is equivalent to using [Form event code](form-event-code.md) and testing whether it returns the On Load event. +**Note:** This command is equivalent to using [Form event code](../commands/form-event-code.md) and testing whether it returns the On Load event. #### See also -[Form event code](form-event-code.md) \ No newline at end of file +[Form event code](../commands/form-event-code.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/call-subform-container.md b/versioned_docs/version-20-R7/commands-legacy/call-subform-container.md index ec7cd9c58d2aa1..20cfa403a186a4 100644 --- a/versioned_docs/version-20-R7/commands-legacy/call-subform-container.md +++ b/versioned_docs/version-20-R7/commands-legacy/call-subform-container.md @@ -30,5 +30,5 @@ In *event*, you can pass any predefined form event of 4D (you can use the consta #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [GOTO OBJECT](goto-object.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/contextual-click.md b/versioned_docs/version-20-R7/commands-legacy/contextual-click.md index c94ec53f5cc168..41b4837788c22b 100644 --- a/versioned_docs/version-20-R7/commands-legacy/contextual-click.md +++ b/versioned_docs/version-20-R7/commands-legacy/contextual-click.md @@ -41,5 +41,5 @@ This method, combined with a scrollable area, enables you to change the value of #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [Right click](right-click.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/data-file.md b/versioned_docs/version-20-R7/commands-legacy/data-file.md index f7b10b541db9ae..16ded6da295ebc 100644 --- a/versioned_docs/version-20-R7/commands-legacy/data-file.md +++ b/versioned_docs/version-20-R7/commands-legacy/data-file.md @@ -30,6 +30,5 @@ If, for example, you are working with the database located in the folder Documen #### See also -*\_o\_DATA SEGMENT LIST* [Application file](application-file.md) [Structure file](structure-file.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/deactivated.md b/versioned_docs/version-20-R7/commands-legacy/deactivated.md index 9cebd9a3a2502a..1eee6e088af26b 100644 --- a/versioned_docs/version-20-R7/commands-legacy/deactivated.md +++ b/versioned_docs/version-20-R7/commands-legacy/deactivated.md @@ -22,9 +22,9 @@ displayed_sidebar: docs In order for the **Deactivated** execution cycle to be generated, make sure that the On Deactivate event property of the form and/or the objects has been selected in Design environment. -**Note:** This command is equivalent to using [Form event code](form-event-code.md) and testing whether it returns the On Deactivate event. +**Note:** This command is equivalent to using [Form event code](../commands/form-event-code.md) and testing whether it returns the On Deactivate event. #### See also [Activated](activated.md) -[Form event code](form-event-code.md) \ No newline at end of file +[Form event code](../commands/form-event-code.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/display-selection.md b/versioned_docs/version-20-R7/commands-legacy/display-selection.md index 221797aaea0ef0..a4b00a25266c15 100644 --- a/versioned_docs/version-20-R7/commands-legacy/display-selection.md +++ b/versioned_docs/version-20-R7/commands-legacy/display-selection.md @@ -63,7 +63,7 @@ The following example selects all the records in the \[People\] table. It then u #### Example 2 -See example #6 for the [Form event code](form-event-code.md) command. This example shows all the tests you may need to check in order to fully monitor the events that occur during a DISPLAY SELECTION. +See example #6 for the [Form event code](../commands/form-event-code.md) command. This example shows all the tests you may need to check in order to fully monitor the events that occur during a DISPLAY SELECTION. #### Example 3 @@ -93,6 +93,6 @@ You can also use other commands, such as [PRINT SELECTION](print-selection.md), #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [MODIFY SELECTION](modify-selection.md) *Sets* \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/displayed-line-number.md b/versioned_docs/version-20-R7/commands-legacy/displayed-line-number.md index 07c67328dea515..5da170cd6017b0 100644 --- a/versioned_docs/version-20-R7/commands-legacy/displayed-line-number.md +++ b/versioned_docs/version-20-R7/commands-legacy/displayed-line-number.md @@ -45,5 +45,5 @@ This example lets you apply an alternating color to a list form displayed on scr #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [Selected record number](selected-record-number.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/drop-position.md b/versioned_docs/version-20-R7/commands-legacy/drop-position.md index 5d3dc79486b33d..3cd081f6726b17 100644 --- a/versioned_docs/version-20-R7/commands-legacy/drop-position.md +++ b/versioned_docs/version-20-R7/commands-legacy/drop-position.md @@ -94,5 +94,4 @@ The left (destination) list box object method contains the following code: #### See also -*\_o\_DRAG AND DROP PROPERTIES* *Drag and Drop* \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/end-selection.md b/versioned_docs/version-20-R7/commands-legacy/end-selection.md index 67e9e843f57f38..f9f901f1686db4 100644 --- a/versioned_docs/version-20-R7/commands-legacy/end-selection.md +++ b/versioned_docs/version-20-R7/commands-legacy/end-selection.md @@ -57,7 +57,7 @@ This form method is used during the printing of a report. It sets the variable * #### See also [Before selection](before-selection.md) -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [LAST RECORD](last-record.md) [NEXT RECORD](next-record.md) [PRINT SELECTION](print-selection.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/filter-keystroke.md b/versioned_docs/version-20-R7/commands-legacy/filter-keystroke.md index 50c72c1eb950b0..bfd511b577d112 100644 --- a/versioned_docs/version-20-R7/commands-legacy/filter-keystroke.md +++ b/versioned_docs/version-20-R7/commands-legacy/filter-keystroke.md @@ -22,7 +22,7 @@ displayed_sidebar: docs If you pass an empty string, the keystroke is cancelled and ignored. -Usually, you will call **FILTER KEYSTROKE** within a form or object method while handling an On Before Keystroke form event. To detect keystroke events, use the command [Form event code](form-event-code.md). To obtain the actual keystroke, use the commands [Keystroke](keystroke.md) or [Get edited text](get-edited-text.md). +Usually, you will call **FILTER KEYSTROKE** within a form or object method while handling an On Before Keystroke form event. To detect keystroke events, use the command [Form event code](../commands/form-event-code.md). To obtain the actual keystroke, use the commands [Keystroke](keystroke.md) or [Get edited text](get-edited-text.md). **IMPORTANT NOTE:** The command **FILTER KEYSTROKE** allows you to cancel or replace the character entered by the user with another character. On the other hand, if you want to insert more than one character for a specific keystroke, remember that the text you see on the screen is NOT YET the value of the data source field or variable for the area being edited. The data source field or variable is assigned the entered value after the data entry for the area is validated. It is therefore up to you to “shadow” the data entry into a variable and then to work with this shadow value and reassign the enterable area (see the example in this section). You can also use the [Get edited text](get-edited-text.md) command. @@ -86,39 +86,37 @@ As explained above, during the editing of the text area, the data source for thi // Shadow keystroke project method // Shadow keystroke ( Pointer ; Pointer ; String ) -> String // Shadow keystroke ( -> srcArea ; -> curValue ; Filter ) -> Old keystroke - C_STRING(1;$0) - var $1;$2 : Pointer +#DECLARE ($srcArea : Pointer ; $curVal : Pointer ; $filter : Text) -> $old : Text var $vtNewValue : Text - C_STRING(255;$3) // Return the original keystroke - $0:=Keystroke + $old:=Keystroke // Get the text selection range within the enterable area - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($srcArea->;$vlStart;$vlEnd) // Start working with the current value - $vtNewValue:=$2-> + $vtNewValue:=$curVal-> // Depending on the key pressed or the character entered, // Perform the appropriate actions Case of // The Backspace (Delete) key has been pressed - :(Character code($0)=Backspace) + :(Character code($old)=Backspace) // Delete the selected characters or the character at the left of the text cursor $vtNewValue:=Delete text($vtNewValue;$vlStart;$vlEnd) // An Arrow key has been pressed // Do nothing, but accept the keystroke - :(Character code($0)=Left arrow key) - :(Character code($0)=Right arrow key) - :(Character code($0)=Up arrow key) - :(Character code($0)=Down arrow key) + :(Character code($old)=Left arrow key) + :(Character code($old)=Right arrow key) + :(Character code($old)=Up arrow key) + :(Character code($old)=Down arrow key) // An acceptable character has been entered - :(Position($0;$3)=0) + :(Position($old;$filter)=0) $vtNewValue:=Insert text($vtNewValue;$vlStart;$vlEnd;$0) Else // The character is not accepted FILTER KEYSTROKE("") End case // Return the value for the next keystroke handling - $2->:=$vtNewValue + $curVal->:=$vtNewValue ``` This method uses the two following submethods: @@ -127,26 +125,25 @@ This method uses the two following submethods: // Delete text project method // Delete text ( String ; Long ; Long ) -> String // Delete text ( -> Text ; SelStart ; SelEnd ) -> New text - var $0;$1 : Text - var $2;$3 : Integer - $0:=Substring($1;1;$2-1-Num($2=$3))+Substring($1;$3) - +#DECLARE ($src : Text ; $start : Integer ; $end : Integer) -> $new : Text + $new:=Substring($src;1;$start-1-Num($start=$end))+Substring($src;$end) +``` +```4d // Insert text project method // Insert text ( String ; Long ; Long ; String ) -> String // Insert text ( -> srcText ; SelStart ; SelEnd ; Text to insert ) -> New text - var $0;$1;$4 : Text - var $2;$3 : Integer - $0:=$1 - If($2#$3) - $0:=Substring($0;1;$2-1)+$4+Substring($0;$3) +#DECLARE ($src : Text ; $start : Integer ; $end : Integer ; $toInsert : Text) -> $new : Text + $new:=$src + If($start # $end) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$end) Else Case of - :($2<=1) - $0:=$4+$0 - :($2>Length($0)) - $0:=$0+$4 + :($start<=1) + $new:=$toInsert+$new + :($start>Length($new)) + $new:=$new+$toInsert Else - $0:=Substring($0;1;$2-1)+$4+Substring($0;$2) + $new:=Substring($new;1;$start-1)+$toInsert+Substring($new;$start) End case End if ``` @@ -180,13 +177,13 @@ The LOOKUP DICTIONARY project method is listed below. Its purpose is to use the // LOOKUP DICTIONARY ( Pointer ; Pointer ) // LOOKUP DICTIONARY ( -> Enterable Area ; ->ShadowVariable ) - var $1;$2 : Pointer +#DECLARE ($area : Pointer ; $shadow : Pointer) var $vlStart;$vlEnd : Integer // Get the text selection range within the enterable area - GET HIGHLIGHT($1->;$vlStart;$vlEnd) + GET HIGHLIGHT($area->;$vlStart;$vlEnd) // Get the selected text or the word on the left of the text cursor - $vtHighlightedText:=Get highlighted text($2->;$vlStart;$vlEnd) + $vtHighlightedText:=Get highlighted text($shadow->;$vlStart;$vlEnd) // Is there something to look for? If($vtHighlightedText#"") // If the text selection was the text cursor, @@ -194,14 +191,14 @@ The LOOKUP DICTIONARY project method is listed below. Its purpose is to use the If($vlStart=$vlEnd) $vlStart:=$vlStart-Length($vtHighlightedText) End if - // Look for the first avaliable dictionary entry + // Look for the first available dictionary entry QUERY([Dictionary];[Dictionary]Entry=$vtHighlightedText+"@") // Is there one? If(Records in selection([Dictionary])>0) // If so, insert it in the shadow text - $2->:=Insert text($2->;$vlStart;$vlEnd;[Dictionary]Entry) + $shadow->:=Insert text($shadow->;$vlStart;$vlEnd;[Dictionary]Entry) // Copy the shadow text to the enterable being edited - $1->:=$2-> + $area->:=$shadow-> // Set the selection just after the insert dictionary entry $vlEnd:=$vlStart+Length([Dictionary]Entry) HIGHLIGHT TEXT(vsComments;$vlEnd;$vlEnd) @@ -221,29 +218,28 @@ The Get highlighted text method is listed here: // Get highlighted text project method // Get highlighted text ( String ; Long ; Long ) -> String // Get highlighted text ( Text ; SelStart ; SelEnd ) -> highlighted text - var $0;$1 : Text - var $2;$3 : Integer - If($2<$3) - $0:=Substring($1;$2;$3-$2) +#DECLARE ($text : Text ; $start : Integer ; $end : Integer) -> $highlight : Text + If($start<$end) + $highlight:=Substring($text;$start;$end-$start) Else - $0:="" - $2:=$2-1 + $highlight:="" + $start:=$start-1 Repeat - If($2>0) - If(Position($1[[$2]];" ,.!?:;()-_–—")=0) - $0:=$1[[$2]]+$0 - $2:=$2-1 + If($start>0) + If(Position($text[[$start]];" ,.!?:;()-_–—")=0) + $highlight:=$text[[$start]]+$highlight + $start:=$start-1 Else - $2:=0 + $start:=0 End if End if - Until($2=0) + Until($start=0) End if ``` #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [Get edited text](get-edited-text.md) [Is editing text](is-editing-text.md) [Keystroke](keystroke.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/font-list.md b/versioned_docs/version-20-R7/commands-legacy/font-list.md index ae4bfee6452ba3..0b351e173968ca 100644 --- a/versioned_docs/version-20-R7/commands-legacy/font-list.md +++ b/versioned_docs/version-20-R7/commands-legacy/font-list.md @@ -68,7 +68,6 @@ You want to get a list of recent fonts: #### See also -*\_o\_Font name* [FONT STYLE LIST](font-style-list.md) *Font Type List* [OBJECT SET FONT](object-set-font.md) diff --git a/versioned_docs/version-20-R7/commands-legacy/form-goto-page.md b/versioned_docs/version-20-R7/commands-legacy/form-goto-page.md index 710459498bcfd7..b5a62548060f80 100644 --- a/versioned_docs/version-20-R7/commands-legacy/form-goto-page.md +++ b/versioned_docs/version-20-R7/commands-legacy/form-goto-page.md @@ -32,7 +32,7 @@ Automatic action buttons perform the same tasks as the [FORM FIRST PAGE](form-fi Page commands can be used with input forms or with forms displayed in dialogs. Output forms use only the first page. A form always has at least one page—the first page. Remember that regardless of the number of pages a form has, only one form method exists for each form. * Use the [FORM Get current page](form-get-current-page.md) command to find out which page is being displayed. -* Use the On Page Change [Form event code](form-event-code.md) that is generated each time the current page of the form changes. +* Use the On Page Change [Form event code](../commands/form-event-code.md) that is generated each time the current page of the form changes. **Note:** When **designing** a form, you can work with pages 1 through X, as well as with page 0, in which you put objects that will appear in all of the pages. When **using** a form, and therefore when calling page commands, you work with pages 1 through X; page 0 is automatically combined with the page being displayed. diff --git a/versioned_docs/version-20-R7/commands-legacy/form-set-input.md b/versioned_docs/version-20-R7/commands-legacy/form-set-input.md index dd2784d9f89294..0c21d23750df18 100644 --- a/versioned_docs/version-20-R7/commands-legacy/form-set-input.md +++ b/versioned_docs/version-20-R7/commands-legacy/form-set-input.md @@ -98,7 +98,6 @@ which displays: #### See also -*\_o\_CREATE USER FORM* [ADD RECORD](add-record.md) [DISPLAY RECORD](display-record.md) [DISPLAY SELECTION](display-selection.md) diff --git a/versioned_docs/version-20-R7/commands-legacy/form-set-output.md b/versioned_docs/version-20-R7/commands-legacy/form-set-output.md index 1726ee61487c07..4234cbf3821d48 100644 --- a/versioned_docs/version-20-R7/commands-legacy/form-set-output.md +++ b/versioned_docs/version-20-R7/commands-legacy/form-set-output.md @@ -64,7 +64,6 @@ The following example uses the path to a .json form to print the records in an e #### See also -*\_o\_CREATE USER FORM* [DISPLAY SELECTION](display-selection.md) [EXPORT DIF](export-dif.md) [EXPORT SYLK](export-sylk.md) diff --git a/versioned_docs/version-20-R7/commands-legacy/get-document-properties.md b/versioned_docs/version-20-R7/commands-legacy/get-document-properties.md index cbc909d570bfe8..00bd3f8a63dfc3 100644 --- a/versioned_docs/version-20-R7/commands-legacy/get-document-properties.md +++ b/versioned_docs/version-20-R7/commands-legacy/get-document-properties.md @@ -207,6 +207,4 @@ Once this is implemented in the database, we have all we need to write the proje #### See also -*\_o\_Document creator* -*\_o\_Document type* [SET DOCUMENT PROPERTIES](set-document-properties.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/get-edited-text.md b/versioned_docs/version-20-R7/commands-legacy/get-edited-text.md index c502e3d86cc9e1..0ecaa05679d703 100644 --- a/versioned_docs/version-20-R7/commands-legacy/get-edited-text.md +++ b/versioned_docs/version-20-R7/commands-legacy/get-edited-text.md @@ -18,7 +18,7 @@ displayed_sidebar: docs #### Description -The **Get edited text** command is mainly to be used with the On After Edit form event to retrieve the text as it is being entered. It can also be used with the On Before Keystroke and On After Keystroke form events. For more information about those form events, please refer to the description of the command [Form event code](form-event-code.md). +The **Get edited text** command is mainly to be used with the On After Edit form event to retrieve the text as it is being entered. It can also be used with the On Before Keystroke and On After Keystroke form events. For more information about those form events, please refer to the description of the command [Form event code](../commands/form-event-code.md). The combination of this command with On Before Keystroke and On After Keystroke form events works as follows: @@ -66,5 +66,5 @@ Here is an example of how to process on the fly characters entered in a text fie #### See also -[Form event code](form-event-code.md) +[Form event code](../commands/form-event-code.md) [Is editing text](is-editing-text.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands-legacy/get-highlight.md b/versioned_docs/version-20-R7/commands-legacy/get-highlight.md index f70dc4b74b267c..7b1c52a24c2162 100644 --- a/versioned_docs/version-20-R7/commands-legacy/get-highlight.md +++ b/versioned_docs/version-20-R7/commands-legacy/get-highlight.md @@ -42,8 +42,10 @@ If the object designated by the *object* parameter is not found in the form, the The following example gets the highlighted selection from the field called *\[Products\]Comments*: ```4d - GET HIGHLIGHT([Products]Comments;vFirst;vLast) - If(vFirst
[`FORM Convert to dynamic`](../commands-legacy/form-convert-to-dynamic.md)
[`FORM EDIT`](../commands-legacy/form-edit.md)
-[`FORM Event`](../commands-legacy/form-event.md)
-[`Form event code`](../commands-legacy/form-event-code.md)
+[`FORM Event`](../commands/form-event.md)
+[`Form event code`](../commands/form-event-code.md)
[`FORM FIRST PAGE`](../commands-legacy/form-first-page.md)
[`FORM Get color scheme`](../commands-legacy/form-get-color-scheme.md)
[`FORM Get current page`](../commands-legacy/form-get-current-page.md)
diff --git a/versioned_docs/version-20-R7/commands/form-event-code.md b/versioned_docs/version-20-R7/commands/form-event-code.md index 5cef0cfa1cb920..49784531cf3a6f 100644 --- a/versioned_docs/version-20-R7/commands/form-event-code.md +++ b/versioned_docs/version-20-R7/commands/form-event-code.md @@ -1,7 +1,6 @@ --- id: form-event-code title: Form event code -slug: /commands/form-event-code displayed_sidebar: docs --- @@ -103,7 +102,7 @@ This example is a template for a form method. It shows each of the possible even #### Example 4 -This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](display-selection.md) or [MODIFY SELECTION](modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. +This example shows the template of a form method that handles the events that can occur for a form displayed using the [DISPLAY SELECTION](../commands-legacy/display-selection.md) or [MODIFY SELECTION](../commands-legacy/modify-selection.md) commands. For didactic purposes, it displays the nature of the event in the title bar of the form window. ```4d //A form method @@ -142,7 +141,7 @@ This example shows the template of a form method that handles the events that ca #### Example 5 -For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](get-edited-text.md), [Keystroke](keystroke.md) and [FILTER KEYSTROKE](filter-keystroke.md) commands. +For examples on how to handle [`On Before Keystroke`](../Events/onBeforeKeystroke.md) and [`On After Keystroke`](../Events/onAfterKeystroke.md) events, see examples for the [Get edited text](../commands-legacy/get-edited-text.md), [Keystroke](../commands-legacy/keystroke.md) and [FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) commands. #### Example 6 @@ -344,11 +343,11 @@ As a result, the red rectangle follows the scrolling of the list box: #### See also [Form Events](../Events/overview.md) -[CALL SUBFORM CONTAINER](call-subform-container.md) -[Current form table](current-form-table.md) -[FILTER KEYSTROKE](filter-keystroke.md) +[CALL SUBFORM CONTAINER](../commands-legacy/call-subform-container.md) +[Current form table](../commands-legacy/current-form-table.md) +[FILTER KEYSTROKE](../commands-legacy/filter-keystroke.md) [FORM Event](form-event.md) -[Get edited text](get-edited-text.md) -[Keystroke](keystroke.md) -[POST OUTSIDE CALL](post-outside-call.md) -[SET TIMER](set-timer.md) \ No newline at end of file +[Get edited text](../commands-legacy/get-edited-text.md) +[Keystroke](../commands-legacy/keystroke.md) +[POST OUTSIDE CALL](../commands-legacy/post-outside-call.md) +[SET TIMER](../commands-legacy/set-timer.md) \ No newline at end of file diff --git a/versioned_docs/version-20-R7/commands/form-event.md b/versioned_docs/version-20-R7/commands/form-event.md index b87dd0fef2c487..1c7114902e2240 100644 --- a/versioned_docs/version-20-R7/commands/form-event.md +++ b/versioned_docs/version-20-R7/commands/form-event.md @@ -97,4 +97,4 @@ The resulting list box when rows are selected: #### See also [Form Events](../Events/overview.md) -[Form event code](form-event-code.md) \ No newline at end of file +[Form event code](../commands/form-event-code.md) \ No newline at end of file diff --git a/versioned_docs/version-20/API/EntityClass.md b/versioned_docs/version-20/API/EntityClass.md index b521f6b557a89b..ddff41dec98957 100644 --- a/versioned_docs/version-20/API/EntityClass.md +++ b/versioned_docs/version-20/API/EntityClass.md @@ -94,9 +94,11 @@ The attribute value type depends on the attribute [kind](DataClassClass.md#attri #### Description -The `.clone()` function creates in memory a new entity referencing the same record as the original entity. This function allows you to update entities separately. +The `.clone()` function creates in memory a new entity referencing the same record as the original entity. ->Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save( )`](#save) function is executed. +This function allows you to update entities separately. Note however that, for performance reasons, the new entity shares the same reference of object attributes as the cloned entity. + +>Keep in mind that any modifications done to entities will be saved in the referenced record only when the [`.save()`](#save) function is executed. This function can only be used with entities already saved in the database. It cannot be called on a newly created entity (for which [`.isNew()`](#isnew) returns **True**). diff --git a/versioned_docs/version-20/FormObjects/text.md b/versioned_docs/version-20/FormObjects/text.md index 747bea46c6968f..c9c81b1d4a9f95 100644 --- a/versioned_docs/version-20/FormObjects/text.md +++ b/versioned_docs/version-20/FormObjects/text.md @@ -51,4 +51,4 @@ Once a text is rotated, you can still change its size or position, as well as al -[Bold](properties_Text.md#bold) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Corner radius](properties_CoordinatesAndSizing.md#corner-radius) - [Fill Color(properties_BackgroundAndBorder.md#background-color--fill-color) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Orientation](properties_Text.md#orientation) - [Right](properties_CoordinatesAndSizing.md#right) - [Title](properties_Object.md#title) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[Bold](properties_Text.md#bold) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Corner radius](properties_CoordinatesAndSizing.md#corner-radius) - [Fill Color](properties_BackgroundAndBorder.md#background-color--fill-color) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Orientation](properties_Text.md#orientation) - [Right](properties_CoordinatesAndSizing.md#right) - [Title](properties_Object.md#title) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width)