diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Develop/field-properties.md b/i18n/es/docusaurus-plugin-content-docs/current/Develop/field-properties.md index 204ad446f6257d..1c5dd4baa5040b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Develop/field-properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Develop/field-properties.md @@ -39,7 +39,7 @@ Para recuperar el nombre de la clase asociada en tiempo de ejecución, utilice l If you assign `4D.Vector` as the class of an Object type field, you define a **vector field**. Such fields store embessings and can be used to query data using AI features. See the [`4D.Vector` class](../API/VectorClass.md) documentation to see how to query with vectors. -Note that the [**4D Embedding Studio** component](corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. +Note that the [**4D Embedding Studio** component](https://corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. When you assign `4D.Vector` as the class of an Object type field, a specific icon is displayed as field type in the Structure editor: ![](../assets/en/Develop/ai-icon.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Develop/structure-tables.md b/i18n/es/docusaurus-plugin-content-docs/current/Develop/structure-tables.md index 6eab440f60dbfb..10dffdd0b0c25d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Develop/structure-tables.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Develop/structure-tables.md @@ -3,276 +3,276 @@ id: structure-tables title: Tablas --- -Tables are the foundation of every 4D database. Each table defines a collection of records that share the same set of fields and properties. In the Structure editor, tables are represented as graphic objects that you can create, rename, or delete, and whose attributes you can configure individually. +Las tablas son la base de cada base de datos 4D. Cada tabla define una colección de registros que comparten el mismo conjunto de campos y propiedades. En el editor de estructuras, las tablas se representan como objetos gráficos que puede crear, renombrar o eliminar, y cuyos atributos puede configurar individualmente. -Using the tools provided by 4D, you can: +Utilizando las herramientas proporcionadas por 4D, puede: -- Define tables and manage their primary keys and relations -- Set and edit table-level properties such as triggers, visibility, and replication -- Control naming rules and organize tables into folders for easier maintenance +- Definir tablas y administrar sus llaves y relaciones primarias +- Definir y editar propiedades a nivel de tabla como triggers, visibilidad y replicación +- Controlar las reglas de nombres y organizar las tablas en carpetas para facilitar el mantenimiento -## Creating a table +## Creación de una tabla -You can create a new table either directly in the Structure window, or via a dialog box. Direct creation is faster; but creation using the dialog box lets you specify certain parameters of the table and cancel the operation when necessary. You can also create tables using copy-paste. +Puede crear una nueva tabla directamente en la ventana de la estructura, o a través de un cuadro de diálogo. La creación directa es más rápida; pero la creación usando el cuadro de diálogo le permite especificar ciertos parámetros de la tabla y cancelar la operación cuando sea necesario. También puede crear tablas usando copiar y pegar. - Para crear una nueva tabla directamente: -1. Right-click an empty area of the Structure editor window, then choose **Add Table...** from the context menu. - **OR** - In the add objects menu of the [Structure editor toolbar](./structure-editor.md#toolbar), choose the Table option. +1. Haga clic derecho en un área vacía de la ventana del editor de estructuras, luego seleccione **Agregar tabla...** en el menú contextual. + **O** + En el menú añadir objetos de la [Barra de herramientas del editor de estructuras](./structure-editor.md#toolbar), elija la opción Tabla. -4D creates the table directly in the Structure editor. You can then change its name, add fields, etc. +4D crea la tabla directamente en el editor de estructuras. A continuación, puede cambiar su nombre, añadir campos, etc. :::note -If you want to put the table in a specific folder, you need to use the Home Page of the Explorer. +Si quiere poner la tabla en una carpeta específica, necesita usar la Página principal del Explorador. ::: -- To create a new table using the "New table" dialog box: +- Para crear una nueva tabla usando el cuadro de diálogo "Nueva tabla": -1. Choose **New > Table...** in the **File** menu (or in the **New** button of the 4D tool bar). - **OR** - On the Tables Page of the Explorer, click on the **\[+]** button. +1. Elija **Nueva > Tabla...** en el menú **Archivo** (o en el botón **Nuevo** de la barra de herramientas 4D). + **O** + En la página de tablas del explorador, haga clic en el botón **\[+]**. -The "New table" dialog box appears. 4D names the first table `Table_1` and then numbers them sequentially: +Aparece el cuadro de diálogo "Nueva tabla". 4D nombra la primera tabla `Table_1` y luego los números secuencialmente: ![](../assets/en/Develop/new-table.png) -2. (optional) Modify the [name of the table](../Concepts/identifiers.md#tables-and-fields) you want to create. -3. (optional) Specify the folder in which you want to place the new table. - By default, the table is placed at the highest level of the folder hierarchy ("Top Level"). Folders are handled in Home Page of the Explorer. -4. Click **OK** to validate. - 4D creates a new table image. It becomes the selected table image in the Structure editor window. +2. (opcional) Modifica el [nombre de la tabla](../Concepts/identifiers.md#tables-and-fields) que quiere crear. +3. (opcional) Especifique la carpeta en la que desea colocar la nueva tabla. + De forma predeterminada, la tabla se coloca en el nivel más alto de la jerarquía de carpetas ("Nivel superior"). Las carpetas se gestionan en la página principal del explorador. +4. Haga clic en **OK** para validar. + 4D crea una nueva imagen de tabla. Se convierte en la imagen de tabla seleccionada en la ventana del editor de estructuras. -- To create a new table by copy-paste: +- Para crear una nueva tabla copiando y pegando: -1. Select and copy the table(s) to be duplicated. -2. Paste the table(s) in the Structure editor window. +1. Seleccione y copie la(s) tabla(s) a duplicar. +2. Pegue la(s) tabla(s) en la ventana del editor de estructuras. -The table is pasted with all its fields and properties. +La tabla se pega con todos sus campos y propiedades. -## Renaming a table +## Renombrar una tabla -You can rename tables at any time. If you have used the old table name in a method, 4D automatically changes it to the new name provided the method is closed. If the method is open, you must make the changes yourself. Each table name must be unique in the database. +Puede renombrar tablas en cualquier momento. Si ha utilizado el nombre de tabla antiguo en un método, 4D lo cambia automáticamente al nuevo nombre siempre que el método esté cerrado. Si el método está abierto, debe hacer los cambios usted mismo. Cada nombre de tabla debe ser único en la base de datos. -You can rename a table directly in the Structure editor, in the Explorer, or using the Inspector palette. +Puede renombrar una tabla directamente en el editor de estructuras, en el explorador, o usando la paleta Inspector. -To rename a table directly (Structure editor or Tables page of the Explorer), **click twice** on the table name (if the table is already selected, click once), so that it switches to editing mode: +Para renombrar una tabla directamente (Editor de estructura o página Tablas del Explorador), **haga clic dos veces** en el nombre de la tabla (si la tabla ya está seleccionada, haga clic una vez) para que pase al modo de edición: ![](../assets/en/Develop/table-rename.png) -Enter the new name and click outside of the table. +Introduzca el nuevo nombre y haga clic fuera de la tabla. -To rename a table using the Inspector palette of the Structure editor, double-click on the table name (or select **Table Properties...** in the context menu of the table) and enter the new name in the "Name" area. +Para renombrar una tabla usando la paleta Inspector del editor de estructuras, haga doble clic en el nombre de la tabla (o seleccione **Propiedades de la tabla..** en el menú contextual de la tabla) e introduzca el nuevo nombre en el área "Nombre". ![](../assets/en/Develop/table-rename-2.png) -4D displays the name and properties of the selected table in the Inspector palette. This palette also indicates the table number. If the Inspector palette is already open but is displaying the properties of another table or another object, just select the desired table image and the palette will then display its properties. +4D muestra el nombre y las propiedades de la tabla seleccionada en la paleta Inspector. Esta paleta también indica el número de la tabla. Si la paleta Inspector ya está abierta pero muestra las propiedades de otra tabla u otro objeto, sólo tiene que seleccionar la imagen de la tabla deseada y la paleta mostrará sus propiedades. -## Deleting a table +## Eliminando una tabla -You can delete tables from your database. There are two ways of deleting tables in 4D: **permanent deletion** (the table and its data are actually removed from the database) and **non-permanent deletion** (the table is simply put into the Trash of the Explorer and may be recovered subsequently). +Puede eliminar tablas de su base de datos. Hay dos maneras de borrar tablas en 4D: **eliminación permanente** (la tabla y sus datos son realmente eliminados de la base de datos) y **eliminación no permanente** (la tabla simplemente se pone en la Papelera del Explorador y puede ser recuperada de forma continua). :::info -You can also remove tables using the [SQL engine of 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). +También puede eliminar tablas usando el [motor SQL de 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). ::: -### Permanent deletion +### Eliminación permanente -To permanently delete one or more database tables in the Structure editor: +Para eliminar permanentemente una o más tablas de la base de datos en el editor de estructuras: -Select the table(s) to be deleted then choose **Clear** from the **Edit** menu or choose **Delete** from the context menu of the table. +Seleccione la(s) tabla(s) a eliminar, luego elija **Limpiar** del menú **Editar** o elija **Eliminar** en el menú contextual de la tabla. -A warning dialog box will ask you to confirm the operation. When you click **OK**, 4D carries out the following operations: +Un cuadro de diálogo de advertencia le pedirá que confirme la operación. Cuando haga clic en **OK**, 4D realiza las siguientes operaciones: -- The table is permanently deleted from the structure. All the data associated with the table are deleted permanently from the data file. -- Any trigger method associated with the table is deleted. -- The forms and lists associated with the table are transformed into project forms and are placed in the Trash of the Explorer. +- La tabla se elimina permanentemente de la estructura. Todos los datos asociados a la tabla se eliminan permanentemente del archivo de datos. +- Cualquier método de activación asociado con la tabla se elimina. +- Los formularios y las listas asociadas a la tabla se transforman en formularios de proyecto y se colocan en la papelera del Explorador. -### Non-permanent deletion +### Eliminación no permanente -Non-permanent deletion of a table consists in putting it in the Trash of the project (which can be accessed via the Explorer), just like the file deletion mechanisms implemented by Windows and macOS. +La eliminación no permanente de una tabla consiste en ponerla en la papelera del proyecto (al que se puede acceder a través del Explorador), al igual que los mecanismos de eliminación de archivos implementados por Windows y macOS. -The table then no longer appears in the 4D editors and its contents become inaccessible but it can still be recovered so long as the Trash is not emptied. +La tabla entonces ya no aparece en los editores 4D y su contenido se vuelve inaccesible, pero todavía se puede recuperar siempre y cuando no se vacíe la Papelera. -To put one or more tables into the Trash from the Structure editor, choose the **Move to Trash** command from the context menu of the table or select the table(s) to be deleted then press the **Delete** or **Backspace** key. A confirmation dialog box appears. If you click **OK**, the table is put into the Trash. It can be recovered at any time from the Trash Page of the Explorer. +Para mover una o varias tablas a la Papelera desde el Editor de estructura, elija el comando Mover a la Papelera en el menú contextual de la tabla o seleccione las tablas que desea eliminar y presione la tecla **Suprimir** o **Retroceso**. Aparece un cuadro de diálogo de confirmación. Si hace clic en **OK**, la tabla pasa a la papelera. Se puede recuperar en cualquier momento desde la Página Papelera del Explorador. -### Numbers of deleted tables +### Números de tablas eliminadas -When a table is deleted, the other tables of the database are not renumbered, so as to avoid endangering the stability of the database. It is therefore possible, for example, to have a database with three tables numbered 2, 4 and 5. +Cuando se elimina una tabla, las otras tablas de la base de datos no se renumeran, para evitar poner en peligro la estabilidad de la base de datos. Por lo tanto, es posible, por ejemplo, tener una base de datos con tres tablas numeradas 2, 4 y 5. -Note that the numbers of permanently deleted tables are reused when new tables are created subsequently. +Tenga en cuenta que los números de tablas eliminadas permanentemente se reutilizan cuando las nuevas tablas se crean de forma simultánea. -## Table properties +## Propiedades de la tabla -You can set several properties for tables using the **Inspector palette** or, for certain properties, using the context menu for the tables. +Puede configurar varias propiedades para tablas usando la **paleta Inspector** o, para ciertas propiedades, usando el menú contextual de las tablas. ### Triggers -A [trigger](./triggers) is a method that runs automatically when certain events related to the table occur. Trigger events can be set in the **Inspector palette** or using the context menu associated with the table (right-click on the title area of the table). Check each event for which you want to [activate the trigger](./triggers#activating-and-creating-a-trigger). +Una [trigger](./triggers) es un método que se ejecuta automáticamente cuando ocurren ciertos eventos relacionados con la tabla. Los eventos trigger pueden establecerse en la **paleta Inspector** o utilizando el menú contextual asociado con la tabla (clic derecho en el área de título de la tabla). Revise cada evento para el cual quiere [activar el trigger](./triggers#activating-and-creating-a-trigger). -You can access the trigger of a table directly from the Structure editor by clicking on the **Edit...** button in the Inspector palette or by selecting **Edit Method...** in the context submenu. You can also create and display triggers with the **Methods Page** of the Explorer. +Puede acceder al trigger de una tabla directamente desde el editor de estructuras haciendo clic en la **Editar. .** botón en la paleta Inspector o seleccionando **Editar método...** en el submenú contextual. También puede crear y mostrar triggers con la **página Métodos** del Explorador. -The [information bar](./structure-editor.md#information-bar) of the **Structure editor** indicates the triggers that are activated for each table. +La [barra de información](./structure-editor.md#information-bar) del **Editor de estructuras** indica los triggers que están activados para cada tabla. ### Atributos -You can set different attributes to configure the appearance and general behavior of each table. +Puede establecer diferentes atributos para configurar la apariencia y el comportamiento general de cada tabla. #### Invisible -This option lets you make a table invisible in the Application mode and for plug-ins. You can activate this option for utility tables or tables that are not being used temporarily. +Esta opción le permite hacer una tabla invisible en el modo Aplicación y para plug-ins. Puede activar esta opción para tablas auxiliares o tablas que no se utilicen temporalmente. -Making a table invisible allows you to limit the operations that a user can perform on a table by making the table and its fields invisible in all editors and some dialog boxes that appear in the Application environment. It can also not be used by plug-ins. +Hacer invisible una tabla le permite limitar las operaciones que un usuario puede realizar en una tabla haciendo que la tabla y sus campos sean invisibles en todos los editores y algunos cuadros de diálogo que aparecen en el entorno de la aplicación. Tampoco puede ser utilizado por plug-ins. -The editors and dialog boxes concerned in the Application environment include the following: +Los editores y los cuadros de diálogo correspondientes en el entorno de la aplicación incluyen lo siguiente: -- All query editors -- Order by editor +- Todos los editores de consulta +- Ordenar por editor - [Editor de etiquetas](../Desktop/labels.md) -- Quick report editor -- Exporting and importing data dialog boxes -- Formula editor +- Editor de informes rápidos +- Cuadros de diálogo para exportar e importar datos +- Editor de fórmulas -In each of these editors, the user is unable to see or choose the table or any of its fields. For instance, the user cannot include any fields from an invisible table in a report or label. +En cada uno de estos editores, el usuario no puede ver o elegir la tabla o cualquiera de sus campos. Por ejemplo, el usuario no puede incluir ningún campo de una tabla invisible en un informe o etiqueta. :::note Notas -- When using these editors, users have the option of saving their specifications (e.g., the query or sort they created) to disk files. In this case, any specified tables or fields that are subsequently made invisible may still be used in the operation. -- Users can type the names of invisible tables and fields in the dialog box. -- It is also possible to set this attribute for each field individually. +- Al utilizar estos editores, los usuarios tienen la opción de guardar sus especificaciones (por ejemplo, la consulta o ordenación que crearon) en los archivos de disco. En este caso, todas las tablas o campos especificados que posteriormente se hagan invisibles pueden ser utilizados en la operación. +- Los usuarios pueden escribir los nombres de las tablas invisibles y los campos en el cuadro de diálogo. +- También es posible establecer este atributo para cada campo individualmente. ::: -Invisible tables and fields are displayed in *italics* in the Structure editor window. +Las tablas y campos invisibles se muestran en *cursiva* en la ventana del editor de estructuras. -#### Color of the table image +#### Color de la imagen de la tabla -A color can be attributed to each table. Using colors helps to organize the structure of a large database. For example, you could use one color for all tables that relate to customers and another for tables that relate to inventory. +Un color puede ser atribuido a cada tabla. Usar colores ayuda a organizar la estructura de una gran base de datos. Por ejemplo, puede usar un color para todas las tablas que se relacionan con los clientes y otra para tablas que se relacionan con el inventario. :::note -It is also possible to attribute a color to each field individually as well as to each relation. +También es posible atribuir un color a cada campo individualmente, así como a cada relación. ::: -To set the color of one or more tables, make your selection and then choose the color using: +Para establecer el color de una o más tablas, haga su selección y luego elija el color utilizando: -- The **Color** button of the Structure editor toolbar -- The **Color** command in the context menu of the tables -- The **Color** option in the **Inspector palette** +- El botón **Color** de la barra de herramientas del editor de estructuras +- El comando **Color** en el menú contextual de las tablas +- La opción **Color** en la **paleta Inspector** -The **Automatic** option can be used to apply the standard original color to the table. +La opción **Automática** puede utilizarse para aplicar el color original estándar a la tabla. -#### Expose as REST resource +#### Exponer como recurso REST -This option controls whether the [table is exposed to REST requests](../REST/configuration.md#exposing-tables). +Esta opción controla si la [tabla está expuesta a solicitudes REST](../REST/configuration.md#exposing-tables). :::note Notas -- You can also set this option at the level of each field of the table. -- This option is used in the context of [ORDA remote datastore features](../ORDA/remoteDatastores.md). +- También puede establecer esta opción en el nivel de cada campo de la tabla. +- Esta opción se utiliza en el contexto de las [funcionalidades de almacenamiento remoto de ORDA](../ORDA/remoteDatastores.md). ::: -#### Records definitively deleted +#### Registros eliminados definitivamente -This option lets you optimize the deletion of a selection of records made using the [`DELETE SELECTION`](../commands/delete-selection) command. +Esta opción le permite optimizar la eliminación de una selección de registros realizados utilizando el comando [`DELETE SELECTION`](../commands/delete-selection). -When 4D deletes a selection, the record markers are also deleted. A record marker is a header attached to the record that contains information relating to this record. Deleting both markers and records is slower than deleting only records. In certain cases, it may be desirable to not automatically delete the record markers. +Cuando 4D elimina una selección, los marcadores de registro también se eliminan. Un marcador de registro es un encabezado adjunto al registro que contiene información relacionada con este registro. Eliminar marcadores y registros es más lento que eliminar sólo registros. En algunos casos, puede ser deseable no eliminar automáticamente los marcadores de registro. -To accelerate the deletion of a large selection made using the [`DELETE SELECTION`](../commands/delete-selection) command, deselect the **Records definitively deleted** option. Record markers will then not be deleted. This option cannot be set by programming. +Para acelerar el borrado de una selección grande hecha utilizando el comando [`DELETE SELECCION`](../commands/delete-selection), anule la selección de **Registros definitivamente eliminados**. No se eliminarán los marcadores de registro. Esta opción no puede ser definida por programación. -#### Enable replication +#### Habilitar replicación :::info Obsoleto -Replication and synchronize mechanisms using SQL are deprecated as of 4D 20 R3. They are still supported but it is now recommended to use the [ORDA-based Global Stamp feature](../ORDA/global-stamp.md), providing a flexible and robust solution to implement replication and synchronization in 4D. +Los mecanismos de replicación y sincronización usando SQL están obsoletos a partir de 4D 20 R3. Todavía son soportados, pero ahora se recomienda usar la [función de sello global basado en ORDA](../ORDA/global-stamp.md), proporcionando una solución flexible y robusta para implementar replicación y sincronización en 4D. ::: -#### Include in Log File +#### Incluída en el archivo de registro -By default, this option is checked for all new tables created and for all tables in converted databases. Check this option in order for operations performed on the table’s data to be included in the [database log file](../Backup/log.md) (when it is generated). +De forma predeterminada, esta opción se marca para todas las nuevas tablas creadas y para todas las tablas en bases de datos convertidas. Marque esta opción para que las operaciones realizadas en los datos de la tabla sean incluidas en el [archivo de registro de la base de datos](../Backup/log.md) (cuando se genere). -This option must generally be checked for most tables. However, for optimization purposes, you can uncheck it, for example for temporary tables or tables used for importing data. +Esta opción generalmente debe ser chequeada para la mayoría de las tablas. Sin embargo, para fines de optimización, puede desmarcarlo, por ejemplo para tablas temporales o tablas utilizadas para importar datos. -It is important to note that this option only indicates that the table’s data must be journaled if the database uses a log file; it does not enable the journaling procedure itself at the database level. +Es importante tener en cuenta que esta opción sólo indica que los datos de la tabla deben ser almacenados si la base de datos utiliza un archivo de registro; no permite el procedimiento diario de transacciones en sí mismo a nivel de base de datos. :::note Notas -- This option is grayed out when the table does not have a primary key. -- 4D displays a warning icon to the right of the **Include in Log File** option when the required conditions are not met. As long as this icon is shown, journaling is not yet enabled. +- Esta opción se graba cuando la tabla no tiene una llave primaria. +- 4D muestra un icono de advertencia a la derecha de la opción **Incluir en archivo de registro** cuando no se cumplen las condiciones requeridas. Mientras se muestre este icono, el diario de transacciones aún no está habilitado. ::: -#### Encryptable +#### Cifrable -This option controls whether the data stored in the table must be encrypted on disk when [data file encryption is enabled](../MSC/encrypt.md). +Esta opción controla si los datos almacenados en la tabla deben ser cifrados en el disco cuando [el cifrado del archivo de datos está habilitado](../MSC/encrypt.md). -Since encrypting/decrypting can be time consuming, selecting the tables to encrypt allows you to optimize the performance of encrypted databases. For example, you could set only the tables that contain personal data as **Encryptable**. +Dado que el cifrado/descifrado puede llevar mucho tiempo, seleccionar las tablas para cifrar le permite optimizar el rendimiento de las bases de datos cifradas. Por ejemplo, sólo se pueden establecer las tablas que contienen datos personales como **Encriptable**. -Note that this option flags table(s); it does not perform any encryption or decryption operation. To actually encrypt or decrypt selected table(s) in the data file, you must use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command. +Tenga en cuenta que esta opción marca tabla(s); no realiza ninguna operación de cifrado o descifrado. Para cifrar o descifrar tabla(s) seleccionadas en el archivo de datos, debe usar el comando [MSC](../MSC/encrypt.md) o llamar al [`Encrypt data file`](../commands/encrypt-data-file). :::warning -- When you modify the value of this option for a table in an already encrypted database, you must also use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command to preserve data consistency. Otherwise, you will not be allowed to save data in the modified table (errors will be returned by 4D when trying to save records). -- Encryption of data stored outside of the data file is not managed by this option. +- Cuando modifica el valor de esta opción para una tabla en una base de datos ya cifrada, también debe usar el comando [MSC](../MSC/encrypt.md) o llamar a [`Encrypt data file`](../commands/encrypt-data-file) para preservar la consistencia de los datos. De lo contrario, no se le permitirá guardar datos en la tabla modificada (los errores serán devueltos por 4D al intentar guardar registros). +- El cifrado de datos almacenados fuera del archivo de datos no es administrado por esta opción. ::: ### Comentarios -The **Comments** area of the **Inspector palette** lets you store additional information about the table. These comments are available for all the developers. Note that each field and each relation has its own comments area. +El área **Comentarios** de la **paleta Inspector** le permite almacenar información adicional sobre la tabla. Estos comentarios están disponibles para todos los desarrolladores. Tenga en cuenta que cada campo y cada relación tiene su propio área de comentarios. ### SQL -- The "Schemas" menu lists all the SQL schemas specified in the database. You can use this menu to set the schema to which the table will belong (it is also possible to modify this property via SQL commands). Every database has at least one schema, named **DEFAULT_SCHEMA**. By default, all the tables belong to this schema. For more information about SQL schemas, refer to the [**Schemas** section](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) in the *4D SQL Reference guide*. -- The information area indicates whether the name of the table respects the rules regarding SQL nomenclature (for example, unlike 4D, SQL does not allow a field name to contain spaces). +- El menú "Esquemas" lista todos los esquemas SQL especificados en la base de datos. Puede usar este menú para establecer el esquema al que pertenecerá la tabla (también es posible modificar esta propiedad mediante comandos SQL). Cada base de datos tiene al menos un esquema, llamado **DEFAULT_SCHEMA**. Por defecto, todas las tablas pertenecen a este esquema. Para obtener más información sobre esquemas SQL, consulte la [sección **Esquemas**](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) en la guía de referencia *4D SQL*. +- El área de información indica si el nombre de la tabla respeta las reglas relativas a la nomenclatura SQL (por ejemplo, a diferencia de 4D, SQL no permite que un nombre de campo contenga espacios). -### Primary keys +### Llaves primarias -A primary key designates the field(s) used for uniquely identifying the records in a table. Setting a primary key is necessary for the [journaling features](../Backup/log.md). +Una llave primaria designa los campo(s) utilizados para identificar de forma única los registros en una tabla. Definir una llave primaria es necesario para las [funcionalidades del registro](../Backup/log.md). -You create, edit and/or remove primary keys directly using the context menu of the Structure editor or the [Primary key manager](#primary-key-manager). +Cree, edite y/o elimine las llaves primarias directamente usando el menú contextual del editor de estructuras o el [Administrador de llaves primarias](#primary-key-manager). -> **Note:** Primary keys can also be set using the SQL language by means of the **PRIMARY KEY** clause followed by the list of columns. +> **Nota:** las llaves primarias también pueden establecerse usando el lenguaje SQL mediante la cláusula **PRIMARY KEY** seguida por la lista de columnas. -#### Rules for using primary key fields +#### Reglas para el uso de campos llave primaria -Primary key fields should be handled with care to ensure data integrity at all times. In particular, a primary key field must respect the following rules: +Los campos llave primaria deben manejarse con cuidado para garantizar la integridad de los datos en todo momento. En particular, un campo llave primaria debe respetar las siguientes reglas: -- it must not be empty, +- no debe estar vacío, - debe ser único, -- once created, it should (in principle) never be modified, especially if: - - [Global stamp features](../ORDA/global-stamp.md) are enabled, - - [REST (or similar) feature](../REST/gettingStarted.md) is enabled, - - the database is periodically synchronized (backup or logical mirror using the [log file](../Backup/log.md)). +- una vez creado, (en principio) nunca debe ser modificado, especialmente si: + - [funcionalidades de sello global](../ORDA/global-stamp.md) están habilitadas, + - [funcionalidad REST (o similar)](../REST/gettingStarted.md) está habilitada, + - la base de datos se sincroniza periódicamente (copia de seguridad o réplica lógica usando el [archivo de registro](../Backup/log.md)). -Modifying primary key field value is highly discouraged, even if 4D allows it for specific use cases. -If you absolutely need to modify a primary key value (e.g. you used a social security number field as primary key and incorrect values have been entered), it is preferable to disable (remove) the current primary key and to add a new field used as primary key with automatic assignment. +Modificar el valor del campo llave primaria es altamente desaconsejado, incluso si 4D lo permite para casos de uso específicos. +Si es absolutamente necesario modificar un valor de llave primaria (p.e. ha usado un campo de número de seguridad social como llave primaria y se han introducido valores incorrectos), es preferible deshabilitar (eliminar) la llave primaria actual y añadir un nuevo campo usado como llave primaria con asignación automática. -Primary key fields can be long integer type or UUID format (alpha type). In most cases, we recommend the UUID format with the Auto UUID option enabled. Even though the long integer type takes up less disk space, UUIDs have many advantages, for example, facilitating the merge of independent databases, data import/export, implementation of elaborate mirror/replication strategies or synchronization with external systems. +Los campos llave primaria pueden ser de tipo entero largo o formato UUID (tipo alfa). En la mayoría de los casos, recomendamos el formato UUID con la opción Auto UUID activada. Aunque el tipo entero largo ocupa menos espacio en disco, los UUIDs tienen muchas ventajas, por ejemplo, facilitando la fusión de bases de datos independientes, importación/exportación de datos, implementación de estrategias elaboradas de réplica/replicación o sincronización con sistemas externos. -#### Setting primary keys +#### Configurando llaves primarias -To create a primary key from the Structure editor: +Para crear una llave primaria desde el editor de estructuras: -1. Select the field(s) that make up the table’s primary key. -2. Right-click and choose **Create primary key** in the context menu (this command is only displayed for fields whose type is eligible for primary keys). +1. Seleccione los campos que componen la llave primaria de la tabla. +2. Haga clic derecho y elija **Crear llave primaria** en el menú contextual (este comando sólo se muestra para campos cuyo tipo es elegible para las llaves primarias). -You cannot have more than one primary key for each table. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. +No puede tener más de una llave primaria para cada tabla. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. -The primary key is created immediately. Fields included in the primary key are *underlined* in the editor and their SQL description displays the **PRIMARY KEY** keyword. +La llave primaria se crea inmediatamente. Los campos incluidos en la llave primaria están *subrayados* en el editor y su descripción SQL muestra la palabra clave **PRIMARY KEY**. -When you create a primary key in a table that already contains records (using an existing field or adding a new one), 4D checks the conformity of all the values present or automatically performs updating operations: +Cuando crea una llave primaria en una tabla que ya contiene registros (usando un campo existente o agregando uno nuevo), 4D comprueba la conformidad de todos los valores presentes o realiza automáticamente operaciones de actualización: -- The field(s) belonging to the primary key cannot contain any duplicated values. If any duplicated values for the key exist in the table records, a warning dialog box appears to indicate that it is not possible to create the key because of this. -- If the duplicated values are blank or null values (case of an added key field), you can check the corresponding automatic generation option (for Alpha fields in or for Longint fields). - In this case, 4D examines all the records of the table and automatically assigns a calculated value to each primary key. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. +- Los campo(s) pertenecientes a la llave primaria no pueden contener ningún valor duplicado. Si existen valores duplicados para la llave en los registros de la tabla, un cuadro de diálogo de advertencia parece indicar que no es posible crear la llave por esta razón. +- Si los valores duplicados están en blanco o son nulos (como en el caso de un campo clave añadido), puede marcar la opción de generación automática correspondiente (para campos Alpha o para campos Entero largo). + En este caso, 4D examina todos los registros de la tabla y asigna automáticamente un valor calculado a cada llave primaria. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. > **Note:** The column(s) belonging to the primary key do not accept NULL values. @@ -280,11 +280,8 @@ When you create a primary key in a table that already contains records (using an To remove a primary key from a table: -1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu: - -[imagen aquí] - -A confirmation dialog box appears. Click **OK** to remove the primary key. +1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu. + Aparece un cuadro de diálogo de confirmación. Click **OK** to remove the primary key. #### Default primary key field diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/privileges.md b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/privileges.md index 2e6151f0004e5e..073e5b23ce628c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ORDA/privileges.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ORDA/privileges.md @@ -3,17 +3,15 @@ id: privileges title: Roles y privilegios --- -Proteger los datos a la vez que se permite un acceso rápido y sencillo a los usuarios autorizados es un reto importante para las aplicaciones web. La arquitectura de seguridad ORDA se implementa en el corazón de su almacén de datos y le permite definir privilegios específicos a todas las sesiones usuario REST o web para los distintos recursos de su proyecto (datastore, dataclasses, funciones, etc.). +The ORDA security architecture controls access to project resources for web and REST sessions. It lets you grant specific permissions on resources such as the datastore, dataclasses, attributes, and functions. ## Generalidades -La arquitectura de seguridad ORDA se basa en los conceptos de privilegios, acciones de permiso (read, create, etc.) y recursos. +The security model combines **privileges**, **actions** (such as `read` and `create`), and **resources**. -Cuando los usuarios web o REST se registran, su sesión se carga automáticamente con los privilegios asociados. Los privilegios se asignan a la sesión mediante la función [`session.setPrivileges()`](../API/SessionClass.md#setprivileges). +Assign privileges to a **session** using [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges). -Cada solicitud de usuario enviada dentro de la sesión se evalúa en función de los privilegios definidos en el archivo `roles.json` del proyecto. - -Si un usuario intenta ejecutar una acción y no tiene los derechos de acceso adecuados, se genera un error de privilegio o, en el caso de que falte el permiso de Lectura en los atributos, no se envían. +Each request is checked against the permissions defined in the project's `roles.json` file. An unauthorized action raises a privilege error. Attributes without read permission are omitted from the response. ![schema](../assets/en/ORDA/privileges-schema.png) @@ -23,50 +21,30 @@ Si un usuario intenta ejecutar una acción y no tiene los derechos de acceso ade ::: -## Resources - -Puede asignar acciones de permiso específicas a los siguientes recursos en su proyecto: +:::info -- el [datastore](../ORDA/dsMapping.md#datastore) -- las [clases de datos](../ORDA/dsMapping.md#dataclass) -- los [atributos](../ORDA/dsMapping.md#attribute) (incluidos [calculados](./ordaClasses.md#computed-attributes-1) y [alias](./ordaClasses.md#alias-attributes-1)) -- funciones de las [clases del modelo de datos](../ORDA/ordaClasses.md) -- funciones [singleton](../REST/$singleton.md) +Los permisos controlan el acceso a los objetos o funciones del almacén de datos. Si desea filtrar los datos leídos según algún criterio, puede considerar [restringir las selecciones de entidades](entities.md#restricting-entity-selections) que puede ser más apropiado en este caso. -Cada vez que se accede a un recurso dentro de una sesión (sin importar la forma en que se acceda), 4D verifica que la sesión tenga los permisos apropiados y rechaza el acceso si no está autorizado. +::: -## Permisos +## Alcance -Un permiso es la capacidad de realizar una acción sobre un recurso. Por ejemplo, *ejecutar la función ds.miTabla.miFuncion()* representa un **permiso**. Los permisos se definen para el proyecto en el archivo [`roles.json`](#rolesjson-file). Cada permiso se puede dar a uno o más [privilegios](#privileges-and-roles). +Permissions apply to **web and REST sessions**: [REST requests](../REST/gettingStarted.md), including [Qodly pages](https://developer.4d.com/qodly/4DQodlyPro/pageLoaders/pageLoaderOverview), and **4D code executed in a web process**. This includes [exposed functions](./ordaClasses.md), [HTTP request handlers](../WebServer/http-request-handler.md), the [On Web Connection database method](../commands/on-web-connection-database-method), and any code they call. For example, an allowed function call still fails if the function reads a dataclass for which the session has no read permission. -Cuando **no se haya definido ningún permiso específico** para un recurso, el acceso al mismo puede ser automáticamente **sin restricciones** o **restringido**, dependiendo del [modo predeterminado definido para el proyecto](#restriction-modes). +:::info Exception -### Acciones de autorización +The **execute** permission of a [shared singleton](../Concepts/classes.md#shared-singleton) or [singleton function](../Concepts/classes.md#singleton-classes) is checked only when the function is [called through REST](../REST/$singleton.md). When 4D code running in a web session directly calls it (`cs.MySingleton.me.myFunction()`), no permission is checked, unlike dataclass, entity, entity selection and datastore functions, which are checked in both cases. -Las acciones disponibles están relacionadas con el recurso de destino. +::: -| Acciones | Almacén de datos | dataclass | atributo | función del modelo de datos o función singleton | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **create** | Crear entidad en cualquier clase de datos | Crear entidad en esta clase de datos | Crea una entidad con un valor diferente del valor por defecto permitido para este atributo (ignorado para atributos alias). | n/a | -| **read** | Leer atributos en cualquier dataclass | Leer atributos en esta clase de datos | Lea el contenido de este atributo | n/a | -| **update** | Actualizar atributos en cualquier clase de datos. | Actualiza los atributos de esta clase de datos. | Actualiza el contenido de este atributo (ignorado para atributos alias). | n/a | -| **drop** | Borrar datos en cualquier clase de datos. | Borrar los datos de esta clase de datos. | Eliminar un valor no nulo para este atributo (excepto para alias y atributo calculado). | n/a | -| **execute** | Ejecutar toda función en el proyecto (almacén de datos, clase de datos, selección de entidades, entidad, singleton) | Ejecuta cualquier función en la clase de datos. Las funciones dataclass, las funciones entidad y las funciones selección de entidades se tratan como funciones dataclass | n/a | Ejecutar esta función | -| **promote** | n/a | n/a | n/a | Asocia un privilegio determinado durante la ejecución de la función. Asocia un privilegio determinado durante la ejecución de la función. Por seguridad, sólo se añade el privilegio al proceso que ejecuta la función, no a toda la sesión. | +Permissions never apply to [desktop session code](../Desktop/sessions.md) (standalone, client/server, stored procedures) or [tool4d](../Admin/cli.md#tool4d). -:::note Notas +:::warning -- Una [alias](./ordaClasses.md#alias-attributes-1) puede leerse tan pronto como los privilegios de sesión permitan el acceso al alias en sí. incluso si los privilegios de sesión no permiten el acceso a los atributos resolviendo el alias. -- Se puede acceder a un [atributo calculado](./ordaClasses.md#computed-attributes-1) incluso si no hay permisos en los atributos sobre los que se construye. -- Puede asignar una acción de permiso a una clase singleton (tipo `singleton`), en cuyo caso se aplicará a todas sus funciones expuestas, o a una función singleton (tipo `singletonMethod`). -- Puede definir/eliminar la acción **promote** dinámicamente a un proceso web utilizando las funciones [`promote()`](../API/SessionClass.md#promote) y [`demote()`](../API/SessionClass.md#demote). -- Valores por defecto: en la implementación actual, solo *Null* está disponible como valor por defecto. -- En modo REST [force login](../REST/authUsers.md#force-login-mode), la función [`authentify()`](../REST/authUsers.md#function-authentify) es siempre ejecutable por usuarios invitados, cualquiera que sea la configuración de permisos. +When a permission entry references an undeclared [privilege](#privileges-and-roles), 4D logs an error and ignores the entry. In this case, the permission is ignored. If the [restricted mode by default](#restriction-modes) is not enabled, the resource is accessible to `guest` sessions. ::: -Los parámetros de permisos requieren ser consistentes, en particular los permisos **update** y **drop** también necesitan el permiso **read** (pero **create** no lo necesita). - ### MCP tools The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: @@ -95,23 +73,53 @@ MCP clients authenticated with the "salesReader" privilege can read the Customer } ``` -### Permisos heredados +### MCP tools -Una acción de permiso definida en un nivel determinado se hereda por defecto en los niveles inferiores, pero se pueden establecer varios permisos: +The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: -- Una acción de permiso definida a nivel de almacén de datos se asigna automáticamente a todas las clases de datos. Una acción de permiso definida a nivel de almacén de datos se asigna automáticamente a todas las clases de datos. -- Una acción de permiso definida a nivel de clase de datos anula la configuración del almacén de datos (si existe). Por defecto, todos los atributos de la clase de datos heredan de los permisos de la clase de datos. -- A diferencia de los permisos de clase de datos, una acción de permiso definida a nivel de atributo no anula los permisos de clase de datos padre, sino que se añade a ellos. Por ejemplo, si asignó el privilegio "general" a una clase de datos y el privilegio "detail" a un atributo de la clase de datos, tanto el privilegio "general" como el privilegio "detail" deben definirse en la sesión para acceder al atributo. +- A [custom tool](../WebServer/mcp-server.md#custom-tools) (`exposed MCP Function`) requires the **execute** permission on its function, and benefits from its **promote** permission. +- The [built-in CRUD tools](../WebServer/mcp-server.md#built-in-crud-tools) require the **read**, **create**, **update**, or **drop** permission on the dataclass, and the attribute permissions apply. Each attribute of a path used in a filter, a sort, or a projection requires the **read** permission. +- The CRUD tools are listed only if the session has at least one data permission on a dataclass, and the `describeModel` tool only describes the dataclasses on which the session has a data permission, with their readable or writable attributes. +- A tool, a dataclass, or an attribute that the session cannot access is reported as if it did not exist. -:::info +#### Ejemplo -Los permisos controlan el acceso a los objetos o funciones del almacén de datos. Si desea filtrar los datos leídos según algún criterio, puede considerar [restringir las selecciones de entidades](entities.md#restricting-entity-selections) que puede ser más apropiado en este caso. +MCP clients authenticated with the "salesReader" privilege can read the Customer and Order dataclasses with the CRUD tools, and call the tools published by the `OrderManager` singleton (for example `OrderManager-getYearTotal`): -::: +```json +{ + "privileges": [{"privilege": "salesReader", "includes": []}], + "roles": [], + "permissions": { + "allowed": [ + {"applyTo": "Customer", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "Order", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "OrderManager", "type": "singleton", "execute": ["salesReader"]} + ] + }, + "restrictedByDefault": true +} +``` + +## Resources + +4D checks the session's permissions whenever a resource is accessed. The following resources can have specific permissions: + +| Recurso | `applyTo` | `tipo` | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ----------------- | +| [Datastore](./dsMapping.md#datastore) | `ds` | `datastore` | +| [Datastore class function](./ordaClasses.md#datastore-class) | `ds.` | `method` | +| [Dataclass](./dsMapping.md#dataclass) | `` | `dataclass` | +| [Attribute](./dsMapping.md#attribute) (including [computed](./ordaClasses.md#computed-attributes-1) and [alias](./ordaClasses.md#alias-attributes-1)) | `.` | `atributo` | +| [Dataclass, entity or entity selection function](./ordaClasses.md) | `.` | `method` | +| [Shared singleton](../Concepts/classes.md#shared-singleton) (all its exposed functions) | `` | `singleton` | +| [Singleton function](../Concepts/classes.md#singleton-classes) | `.` | `singletonMethod` | + +Use the `applyTo` and `type` values shown in the table when defining permissions in [`roles.json`](#rolesjson-file). -### Asignación de permisos a las funciones de la clase ORDA +:::note Asignación de permisos a las funciones de la clase ORDA -Al configurar los permisos, las funciones de clase ORDA se declaran en el elemento `applyTo` usando la siguiente sintaxis: +In `roles.json`, identify an ORDA class function in `applyTo` with this syntax: ```json . @@ -126,13 +134,13 @@ Class extends Entity ... ``` -... tiene que escribir: +Use this value: ```json "applyTo":"City.getPopulation" ``` -Significa que no puede utilizar los mismos nombres de función en las distintas clases ORDA (entidad, selección de entidad, dataclass) si desea que se les asignen privilegios. En este caso, debe utilizar nombres de función distintos. Por ejemplo, si has creado una función "drop" en ambas clases `cs.CityEntity` y `cs.CitySelection`, necesita darles nombres diferentes como `dropEntity()` y `dropSelection()`. A continuación, puede escribir en el archivo "roles.json": +Because permissions identify functions by dataclass and function name, functions with the same name in different ORDA classes (entity, entity selection, dataclass) cannot be assigned different privileges. Give them distinct names instead. For example, name the functions `dropEntity()` and `dropSelection()` in `cs.CityEntity` and `cs.CitySelection`, respectively: ```json "permissions": { @@ -151,22 +159,82 @@ Significa que no puede utilizar los mismos nombres de función en las distintas "name" ] } - ] + ] + } +} ``` +::: + +## Permisos + +A **permission** allows an action on a resource; for example, executing `ds.myTable.myFunction()`. Permissions are defined in [`roles.json`](#rolesjson-file) and granted to one or more [privileges](#privileges-and-roles). + +If no permission is defined for a resource, access depends on the project's [restriction mode](#restriction-modes). + +### Acciones de autorización + +Available actions depend on the resource: + +| Acción | Datastore | Dataclass | Atributo | Function | +| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **create** | Create entities in any dataclass | Create entities in this dataclass | Create an entity with a non-default value for this attribute (ignored for alias attributes) | n/a | +| **read** | Leer atributos en cualquier dataclass | Leer atributos en esta clase de datos | Read this attribute's content | n/a | +| **update** | Actualizar atributos en cualquier clase de datos | Actualiza los atributos de esta clase de datos | Update this attribute's content (ignored for alias attributes) | n/a | +| **drop** ("Delete" in Qodly Studio) | Borrar datos en cualquier clase de datos | Borrar los datos de esta clase de datos | Delete a non-null value for this attribute (except for alias and computed attributes) | n/a | +| **execute** | Execute any function on the project (datastore, dataclass, entity selection, entity, or singleton) | Execute any function on the dataclass; dataclass, entity, and entity selection functions are treated as dataclass functions | n/a | Ejecutar esta función | +| **promote** | n/a | n/a | n/a | Temporarily add a privilege for the duration of the function call. Only the process executing the function receives it, not the whole session. Use [`promote()`](../API/SessionClass.md#promote) and [`demote()`](../API/SessionClass.md#demote) to set or remove this action dynamically in a web process. | + +### Permission rules + +- **update** and **drop** require **read** on the resource; **create** does not. +- A function can be **promoted** by multiple privileges. During execution, it receives the combined permissions of all those privileges; there is no priority order. +- An [alias attribute](./ordaClasses.md#alias-attributes-1) can be read if the session has permission to read the alias, even if it cannot read the attributes the alias resolves to. +- A [computed attribute](./ordaClasses.md#computed-attributes-1) can be accessed even if its underlying attributes have no permissions. +- In REST [force login mode](../REST/authUsers.md#force-login-mode), guest users can always execute [`authentify()`](../REST/authUsers.md#function-authentify), regardless of the permissions configuration. + +### Permisos heredados + +Permission actions are inherited according to the following rules: + +1. Permissions descend **datastore → dataclass → attribute / function**, and **datastore → singleton → singleton function**. +2. Resolution is **per action**. Defining `read` on a dataclass does not change how `create`, `update`, `drop` or `execute` are resolved for it. +3. **Dataclass replaces datastore**. A permission defined on a dataclass for an action replaces the datastore permission for that action. Privileges granted the action only on the datastore lose it on that dataclass. +4. **Function replaces dataclass**. An `execute` permission defined on a function replaces the dataclass (and datastore) `execute` permission for that function. Entity and entity selection functions follow the same rule as dataclass functions. +5. **Singleton replaces datastore**, **singleton function replaces singleton**. +6. **Datastore function replaces datastore**. +7. **Attribute adds to its parent**. To act on an attribute that has its own permission, a session needs a privilege granted by the attribute permission **and** a privilege granted the action on the dataclass (directly or through the datastore). +8. An action granted to **no privilege** (for example, `"read": []`) is "not set", so the permission at the level above applies. It does not mean "nobody". To deny the action, use [restricted mode](#restriction-modes) without defining that permission, or grant it to a privilege that no session receives. + +Permissions only grant access; there is no explicit deny. A dataclass or function permission can therefore narrow a broader datastore permission by replacing it. An attribute permission is additive: it grants access to that attribute only when the session also has the action on its dataclass. + +:::tip Recommended practice + +- Assign access to sessions through **roles** with `Session.setPrivileges({roles: [...]})`. Define roles around business profiles; privileges are the reusable building blocks. [Qodly Studio](https://developer.4d.com/qodly/4DQodlyPro/roles/overview) displays effective permissions by role. +- If an administration role needs full access, include every privilege in it except a lock privilege, if used. Add each new privilege to that role: a dataclass-level permission can replace a broader datastore permission. +- Review the effect of privilege changes on every role. In Qodly Studio, **Detailed Permission Review** shows a role's effective access; a role with no privileges can help you review guest-only access. + +::: + ## Privilegios y roles -Un \*\*privilegio \*\* es la capacidad técnica de ejecutar \*\*acciones \*\* en \*\*recursos \*\*, mientras que un **rol** es un privilegio publicado para ser utilizado por un administrador. Básicamente, un rol reúne varios privilegios para definir un perfil de usuario empresarial. Por ejemplo, "manageInvoices" podría ser un privilegio mientras que "secretary" podría ser un rol (que incluye "manageInvoices" y otros privilegios). +A **privilege** grants actions on resources. A **role** groups privileges into a business profile that an administrator can assign to a session. + +For example, `manageInvoices` could be a privilege and `secretary` a role that includes it and other privileges. Assign roles to sessions with [`Session.setPrivileges({roles: [...]})`](../API/SessionClass.md#setprivileges); the role grants all its privileges. + +Privileges can be granted permission on multiple action-resource combinations, and an action can be granted to multiple privileges. + +Define privileges and roles in [`roles.json`](#rolesjson-file), then grant roles to sessions with `Session.setPrivileges()`. -Un privilegio o un rol pueden asociarse a varias combinaciones "acción + recurso". Se pueden asociar varios privilegios a una acción. Un privilegio puede incluir otros privilegios. +### Including privileges -- Usted **crea** privilegios y/o roles en el archivo `roles.json` (ver abajo). **Configura** su alcance asignándolos a acción(es) de permiso aplicadas a recurso(s). +A privilege can include other privileges using the `includes` property in `roles.json`. Inclusion is transitive and one-way: if A includes B, and B includes C, A receives the permissions of B and C. -- Usted **autoriza** los privilegios y/o roles para cada sesión usuario usando la función [`.setPrivileges()`](../API/SessionClass.md#setprivileges) de la clase `Session`. +[`Session.getPrivileges()`](../API/SessionClass.md#getprivileges) returns the expanded collection (for example, A, B, and C) in no guaranteed order. Declare an included privilege before the privilege that includes it; otherwise, 4D drops the inclusion and logs an error. ### Ejemplo -Para permitir un rol en una sesión: +This authentication function assigns the user's role to the session: ```4d @@ -176,61 +244,65 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T Session.clearPrivileges() - $result:="Está autentificado como Invitado" + $result:="You are authenticated as Guest" $user:=ds.Users.query("identifier = :1"; $identifier).first() If ($user#Null) If (Verify password hash($password; $user.password)) Session.setPrivileges(New object("roles"; $user.role)) - $result:="Está autentificado como "+$user.role + $result:="Your are authenticated as "+$user.role End if End if ``` +## `guest` privilege + +`guest` is built in; declaring a privilege named `Guest` is an error ("privilege already defined"). Sessions without privileges (`Session.isGuest() = True`) receive the permissions granted to `guest`. + +Permissions granted to `guest` are available to every session, regardless of its other privileges. Do not grant `guest` access that should be withheld from other sessions, and account for its permissions when restricting access at the dataclass level. + ## archivo `roles.json` -El archivo `roles.json` describe todos los parámetros de seguridad web del proyecto. La sintaxis del archivo `roles.json` es la siguiente: - -| Nombre de propiedad | | | Tipo | Obligatorio | Descripción | -| ------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------ | -| privileges | | | Colección de objetos `privilege` | X | Lista de privilegios definidos | -| | \[].privilege | | Text | | Nombre del privilegio | -| | \[].includes | | Colección de cadenas | | Lista de nombres de privilegios incluidos | -| roles | | | Colección de objetos `role` | | Lista de roles definidos | -| | \[].role | | Text | | Nombre del rol | -| | \[].privileges | | Colección de cadenas | | Lista de nombres de privilegios incluidos | -| permissions | | | Object | X | Lista de acciones permitidas | -| | allowed | | Colección de objetos `permission` | | Lista de permisos permitidos | -| | | \[].applyTo | Text | X | Targeted [resource](#resources) name | -| | | \[].type | Text | X | Tipo de [recurso](#resources): "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | -| | | \[].read | Colección de cadenas | | Lista de privilegios | -| | | \[].create | Colección de cadenas | | Lista de privilegios | -| | | \[].update | Colección de cadenas | | Lista de privilegios | -| | | \[].drop | Colección de cadenas | | Lista de privilegios | -| | | \[].execute | Colección de cadenas | | Lista de privilegios | -| | | \[].promote | Colección de cadenas | | Lista de privilegios | -| restrictedByDefault | | | Boolean | | Si es true, se niega el acceso a recursos sin permisos explícitos | -| forceLogin | | | Boolean | | Si es true, activa el modo ["forceLogin"](../REST/authUsers.md#force-login-mode) | - -:::caution Recordatorio - -- El nombre de privilegio "WebAdmin" está reservado a la aplicación. No se recomienda utilizar este nombre para los privilegios personalizados. -- los nombres de `privileges` y `roles` no son sensibles a mayúsculas y minúsculas. +The project's web security settings are defined in `roles.json`: + +| Propiedad | Tipo | Requerido | Descripción | +| ------------------------------- | -------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `privileges` | Collection of privilege objects | Sí | Defined privileges. Each object has a `privilege` name and can have an `includes` collection of privilege names. | +| `roles` | Collection of role objects | No | Defined roles. Each object has a `role` name and a `privileges` collection of privilege names. | +| `permissions.allowed` | Collection of permission objects | Sí | Permissions assigned to resources. | +| `permissions.allowed[].applyTo` | Text | Sí | Target [resource](#resources) name. | +| `permissions.allowed[].type` | Text | Sí | [Resource](#resources) type: `datastore`, `dataclass`, `attribute`, `method`, `singletonMethod`, or `singleton`. | +| `permissions.allowed[].read` | Colección de cadenas | No | Privileges granted read access. | +| `permissions.allowed[].create` | Colección de cadenas | No | Privileges granted create access. | +| `permissions.allowed[].update` | Colección de cadenas | No | Privileges granted update access. | +| `permissions.allowed[].drop` | Colección de cadenas | No | Privileges granted delete access. | +| `permissions.allowed[].execute` | Colección de cadenas | No | Privileges granted execute access. | +| `permissions.allowed[].promote` | Colección de cadenas | No | Privileges temporarily granted during function execution. | +| `restrictedByDefault` | Boolean | No | If `true`, access to resources without explicit permissions is denied. | +| `forceLogin` | Boolean | No | If `true`, enables [force login mode](../REST/authUsers.md#force-login-mode). | + +:::note Notas + +- The `WebAdmin` privilege name is reserved for the application; do not use it for custom privileges. +- Privilege and role names are case-insensitive. Unknown names passed to [`.setPrivileges()`](../API/SessionClass.md#setprivileges) are ignored. +- Qodly Studio can add an optional `id` property to privileges and roles to preserve references when they are renamed. +- Multiple entries with the same `applyTo` are not merged: the last entry wins without an error. Define only one entry per resource. +- A resource entry that grants no actions has no effect. ::: -### Ubicación y contenido del archivo por defecto +### Default location and content -Cuando se crea un nuevo proyecto, se genera un archivo `roles.json` por defecto en: +New projects generate `roles.json` at: ``` /Project/Sources/ ``` -Ver la sección [Arquitectura](../Project/architecture.md#sources). +See the [Architecture](../Project/architecture.md#sources) section for details. Contenido predeterminado: @@ -262,7 +334,7 @@ Contenido predeterminado: :::note Compatibilidad -En versiones anteriores, el archivo `roles.json` no fue creado por defecto. A partir de 4D 20 R6, al abrir un proyecto existente que no contiene un archivo `roles.json` o los parámetros `"forceLogin": true`, el botón **Activar la autenticación REST mediante la función ds.authentify()** está disponible en la página [**Funcionalidades web** de la caja de diálogo Parámetros](../settings/web.md#access). Este botón actualiza automáticamente su configuración de seguridad (es posible que tenga que modificar su código, [ver esta publicación del blog](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/)). +In releases before 4D 20 R6, `roles.json` was not created by default. In 4D 20 R6 and later, opening an existing project without a `roles.json` file or `"forceLogin": true` setting makes the **Activate REST authentication through ds.authentify() function** button available on the [Web Features page of the Settings dialog box](../settings/web.md#access). This button upgrades the security settings; you may need to modify your code. Ver [esta entrada del blog](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/). ::: @@ -274,66 +346,116 @@ En Qodly Studio for 4D, el modo de conexión se puede definir utilizando la opci ## Modos de restricción -La propiedad `restrictedByDefault` configura cómo cada [recurso](#resources) es accedido cuando [ningún permiso específico está definido para el](#permissions): +`restrictedByDefault` determines access to a [resource](#resources) when no [specific permission](#permissions) is defined: -- **Modo sin restricciones** (`restrictedByDefault`: **false**): los recursos sin permisos definidos son accesibles a todas las peticiones. Este modo es adecuado para entornos de desarrollo donde el acceso se puede restringir gradualmente. -- **Modo restringido** (`restrictedByDefault`: **true**): los recursos sin permisos definidos están bloqueados por defecto. Este modo se recomienda para entornos de producción donde el acceso debe ser otorgado explícitamente. +- **Unrestricted mode** (`restrictedByDefault: false`): Resources without defined permissions are accessible to all requests. +- **Restricted mode** (`restrictedByDefault: true`): Resources without defined permissions are blocked. Access is granted explicitly, and the [permission inheritance rules](#inherited-permissions) still apply. :::note Compatibilidad -- Al **crear un nuevo proyecto**, la propiedad `restrictedByDefault` se establece en **false** en el archivo *roles.json* (ver abajo). Tenga en cuenta que esta configuración está hecha a medida para un inicio rápido y un desarrollo fluido. En un entorno de producción, [se recomienda definir las propiedades `restrictedByDefault` y `forceLogin` en **true**](#recommended-configuration). -- En **proyectos convertidos desde versiones anteriores**, al habilitar el acceso a Qodly Studio mediante el [cuadro de diálogo de configuración con un solo clic](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration), se añade la propiedad `restrictedByDefault` con el valor **true** en el archivo *roles.json*. +- New projects set `restrictedByDefault` to `false` by default; see [recommended configurations](#recommended-configuration). +- For projects converted from earlier releases, enabling access to Qodly Studio through the [One-click configuration dialog](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration) adds `restrictedByDefault: true` to `roles.json`. ::: -### Configuración recomendada {#recommended-configuration} +### Restriction strategies + +#### Lock everything and open gradually + +Choose either restricted mode or a lock privilege to close access by default: + +| | Restricted mode | Lock privilege | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| Setting | `"restrictedByDefault": true` (Qodly Studio: **Restrict Access By Default**) | `"restrictedByDefault": false`, with every action on `ds` granted to a privilege that no session receives (for example, `none`) | +| What is closed | Every resource without a permission | Every resource that inherits datastore permissions | +| How to open | Grant permissions on the datastore, dataclasses, attributes, and functions | Grant permissions on dataclasses and functions to replace the lock | +| If 4D drops an invalid entry | The resource stays closed | The resource falls back to the lock and stays closed | +| Importante | Explicitly grant access to public resources, usually to `guest`, including the login function unless [force login](../REST/authUsers.md#force-login-mode) is used, and [HTTP request handlers](../WebServer/http-request-handler.md) called before login. In this mode, Qodly Studio's role review is currently incorrect. | Never assign the lock privilege to a role, including the administration role. | + +Both approaches close access by default and follow the same inheritance and replacement rules. A lock privilege makes the lock visible in the editor; restricted mode requires no extra privilege. + +#### Open everything, restrict gradually + +Set unrestricted mode (`"restrictedByDefault": false`), grant `guest` read access to `ds`, then restrict sensitive dataclasses with dataclass-level permissions. + +Remember that [guest](#guest-privilege) permissions apply to every session. Without a lock privilege, an invalid entry dropped by 4D leaves the resource open in unrestricted mode. -Dependiendo de su entorno, los parámetros recomendados son: +#### Configuración recomendada {#recommended-configuration} -- **Producción**: defina tanto `restrictedByDefault` como [`forceLogin`](../REST/authUsers.md#force-login-mode) como **true**. Esto garantiza la máxima seguridad al requerir autenticación de usuario y permisos explícitamente definidos para el acceso a recursos. -- **Desarrollo**: defina `restrictedByDefault` y [`forceLogin`](../REST/authUsers.md#force-login-mode) como **false**. Esto permite un acceso más fácil durante el desarrollo y la depuración, con la posibilidad de aplicar gradualmente restricciones. +Use these settings as a starting point: + +- **Development**: Set both properties to `false` for easier access while developing and debugging. Apply restrictions gradually as needed. +- **Production**: Set `restrictedByDefault` and [`forceLogin`](../REST/authUsers.md#force-login-mode) to `true` so that users must authenticate and resource access must be explicitly granted. + +## Permission errors ### Archivo `Roles_Errors.json` -El archivo `roles.json` es analizado por 4D al inicio. Debe reiniciar la aplicación si desea que se tengan en cuenta las modificaciones en este archivo. +4D parses `roles.json` at startup. Restart the application for changes to take effect. -En caso de error(es) al analizar el archivo `roles.json`, 4D carga el proyecto pero desactiva la protección de acceso global - esto permite al desarrollador acceder a los archivos y solucionar el error. Se genera un archivo de error llamado `Roles_Errors.json` en la [`carpeta Logs del proyecto`](../Project/architecture.md#logs) y describe la(s) línea(s) de error. Este archivo se elimina automáticamente cuando el archivo `roles.json` deja de contener errores. +If parsing fails, 4D writes the errors to `Roles_Errors.json` in the project's [`Logs` folder](../Project/architecture.md#logs). It deletes this file after `roles.json` is corrected. -Se recomienda comprobar al inicio si existe un archivo `Roles_Errors.json` en la carpeta [Logs](../Project/architecture.md#logs), lo que significa que se ha producido un error de análisis y que los accesos no estarán limitados. Puede escribir, por ejemplo: +Check at startup, especially in production, whether `Roles_Errors.json` exists. Its presence indicates a parsing error, and permissions may not be enforced as intended. Puede escribir, por ejemplo: ```4d title="/Sources/DatabaseMethods/onStartup.4dm" If (Not(File("/LOGS/"+"Roles_Errors.json").exists)) -… -Else // puede evitar que el proyecto abra +... +Else // you can prevent the project to open ALERT("The roles.json file is malformed or contains inconsistencies, the application will quit.") QUIT 4D End if ``` -## Ejemplo de configuración de privilegios +Permission errors are returned as follows: -```json title="/Project/Sources/roles.json" +| Ruta | read / create / update / drop refused | execute refused | +| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | +| REST | HTTP 401 with message | **HTTP 500** with message (singleton: "Bad permission...") | +| Code (web session) | Read: error 1557 (dataclass) or 1607 (attribute). Create: error 1608 when assigning an attribute to a new entity if create is restricted by a permission; in restricted mode without permission, `save()` returns `success: false` and `statusText: "Permission Error"`. Update/drop: error 1557 when loading the entity (both require read). | Error 1561 | + +## Ejemplo +This example grants a broad set of permissions through a `manager` privilege, while the `payroll` privilege grants read access to the sensitive `Salaries` dataclass. + +```json title="roles.json" { - "forceLogin": true, - "restrictedByDefault": true, - "permissions": { - "allowed": [ - { - "applyTo": "People", - "type": "dataclass", - "read": [ - "viewPeople" - ] - } - ] - }, - "privileges": [ - { - "privilege": "viewPeople", - "includes": [] - } - ], - "roles": [] + "forceLogin": true, + "restrictedByDefault": true, + "privileges": [ + {"privilege": "payroll", "includes": []}, + {"privilege": "manager", "includes": []} + ], + "roles": [ + {"role": "administrator", "privileges": ["manager", "payroll"]} + ], + "permissions": { + "allowed": [ + { + "applyTo": "ds", + "type": "datastore", + "read": ["manager"], + "create": ["manager"], + "update": ["manager"], + "drop": ["manager"], + "execute": ["manager"] + }, + { + "applyTo": "Salaries", + "type": "dataclass", + "read": ["payroll"] + } + ] + } } + ``` + +Here are the resulting rules: + +| Session | Read Salaries | Create Salaries | Update/drop Salaries | Read other dataclasses | +| -------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------- | +| `manager` | Refused (the `Salaries` read permission replaces the datastore permission) | Allowed (inherited from the datastore) | Refused (read is required) | Allowed | +| `payroll` | Allowed | Refused (the datastore permission is granted only to `manager`) | Refused | Refused | +| `administrator` role | Allowed | Allowed | Allowed | Allowed | + +The `Salaries` read permission replaces the datastore read permission, so `manager` alone cannot read that dataclass. The `administrator` role receives the combined permissions of `manager` and `payroll`. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/mcp-server.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/mcp-server.md index c12d986d534c03..7eb6a6ddcccfb6 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/mcp-server.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/mcp-server.md @@ -22,7 +22,7 @@ You do not need to write the MCP layer: 4D generates the tool catalog, converts ## Enabling the MCP server -The MCP server is disabled by default. It requires: +The MCP server is disabled by default. Requiere: - the web server of the host application (the MCP server is not available on [component web servers](webServerObject.md)), - [scalable sessions](sessions.md#enabling-web-sessions). If scalable sessions are disabled, the MCP server does not start, 4D logs a message in the [diagnostic log](../Debugging/debugLogFiles.md#4ddiagnosticlogtxt), and `/mcp` answers 404. @@ -76,18 +76,18 @@ Responses are `application/json`. Every result contains a `resultType` property The following methods are supported: -| Método | Token required | Descripción | -| ----------------- | -------------- | --------------------------------------------------------------------------------------------- | -| `server/discover` | No | Returns the capabilities of the server (see below) | -| `ping` | No | Returns an empty result | -| `tools/list` | Sí | Returns the [tool catalog](#tool-catalog) of the session | -| `tools/call` | Sí | Calls a [custom tool](#calling-a-custom-tool) or a [built-in CRUD tool](#built-in-crud-tools) | +| Método | Se necesita un token | Descripción | +| ----------------- | -------------------- | --------------------------------------------------------------------------------------------- | +| `server/discover` | No | Returns the capabilities of the server (see below) | +| `ping` | No | Returns an empty result | +| `tools/list` | Sí | Returns the [tool catalog](#tool-catalog) of the session | +| `tools/call` | Sí | Calls a [custom tool](#calling-a-custom-tool) or a [built-in CRUD tool](#built-in-crud-tools) | Clients may call `tools/list` and `tools/call` directly, without calling `server/discover` first. The legacy `initialize` request of previous MCP revisions is not supported. #### `server/discover` -The `server/discover` result is the same for all callers. It contains: +The `server/discover` result is the same for all callers. Contiene: | Propiedad | Descripción | | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -117,7 +117,7 @@ $request.wait() 4D checks each request in the following order, before running any code of the application. The first failing check gives the answer: -| Check | Estado HTTP | JSON-RPC error | +| Check | Estado HTTP | Error JSON-RPC | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -------------- | | MCP server disabled | 404, no body | | | Plain HTTP not allowed (see [Secure connections](#secure-connections)) | 404, no body | | @@ -128,7 +128,7 @@ $request.wait() | JSON-RPC notification (no `id`): accepted, nothing is executed | 202, no body | | | Missing `MCP-Protocol-Version`, `Mcp-Method` or `Mcp-Name` header, or header that does not match the body. A legacy `initialize` request gets a message naming the `2026-07-28` revision | 400 | `-32020` | | Unsupported protocol version (`data.supported` lists the supported versions) | 400 | `-32022` | -| Unknown method | 404 | `-32601` | +| Método desconocido | 404 | `-32601` | Then, for methods that require a token: @@ -155,7 +155,7 @@ Requests with an `Origin` header are refused (403) to protect the server against #### Proxies and public URL -4D publishes some URLs (OAuth metadata and endpoints, binary URLs). Their base is: +4D publishes some URLs (OAuth metadata and endpoints, binary URLs). Su base es: - [`mcp.publicURL`](../API/WebServerClass.md#mcp) if it is set (recommended when the server is reachable under several names), - otherwise the scheme and the `Host` header of the request. The `X-Forwarded-Proto` and `X-Forwarded-Host` headers are only used when the request comes from a proxy listed in `mcp.trustedProxies`. @@ -220,7 +220,7 @@ Requests are stateless, but 4D keeps one web session per token and caller IP add - Its privileges are those of the token. Then 4D calls the [`ds.mcpAuthenticated()`](../ORDA/ordaClasses.md#function-mcpauthenticated) function of your DataStore class, if defined, once per session: you can use it to fill [`Session.storage`](../API/SessionClass.md#storage) from the information stored with the token. - The session closes after the [inactivity timeout of web sessions](sessions.md#session-lifetime), when its token is revoked or expires, or when the MCP server is disabled. Its license is then released. -### OAuth 2.1 mode +### Modo OAuth 2.1 In OAuth mode, 4D is the OAuth authorization server: users log in from their AI client through a 4D login page, without any external identity provider. The OAuth mode is enabled when your DataStore class defines the [`mcpGrant()`](../ORDA/ordaClasses.md#function-mcpgrant) function. Fine-Grained Tokens remain accepted. @@ -282,7 +282,7 @@ To protect the login page against password guessing: - after 10 failed logins from one caller IP address within 15 minutes, this address gets a 429 status for 15 minutes, - after 20 failed logins for one user name within 15 minutes, this user name is refused for 15 minutes, with the same message as a wrong password. -## Authorization +## Autorización The MCP server uses the [`roles.json`](../ORDA/privileges.md) file of the project, exactly as the REST server. There is nothing specific to MCP to configure: @@ -463,10 +463,10 @@ exposed MCP Function cancel() : Text The built-in CRUD tools let a client read and write the data of the datastore without custom code. They are listed when the session has at least one data permission (**read**, **create**, **update**, or **drop**) on a dataclass, and each call requires the corresponding permission: -| Tool | Arguments | Resultado | Permission | +| Tool | Argumentos | Resultado | Permission | | -------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------- | | `describeModel` | Ninguno | The dataclasses the session can access, their readable or writable attributes, and their relations to these dataclasses | Any data permission | -| `getEntity` | `dataClass`, `key`, `attributes` | The entity | read | +| `getEntity` | `dataClass`, `key`, `attributes` | La entidad | read | | `queryEntities` | `dataClass`, `filter`, `params`, `attributes`, `orderBy`, `limit`, `skip` | `{entities, total, skip, nextSkip}` | read | | `aggregateEntities` | `dataClass`, `attribute`, `filter`, `params` | `count`, and with `attribute`: `countNotNull`, `sum`, `average`, `min`, `max` | read | | `addEntity` | `dataClass`, `data` | The created entity | create | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md index a42f379e7bb104..b7e78504d36b67 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md @@ -51,24 +51,24 @@ Los objetos devueltos tienen propiedades que puede leer para obtener informació Los objetos de atributo devueltos contienen las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| autoFilled | Boolean | True si el valor del atributo es rellenado automáticamente por 4D. Corresponde a las siguientes propiedades de campo 4D: "Autoincremento" para campos de tipo numérico y "Auto UUID" para campos UUID (alfa). No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | -| exposed | Boolean | True si el atributo está expuesto en REST | -| fieldNumber | integer | Número de campo 4D interno del atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | -| fieldType | Integer | Tipo de campo de base de datos 4D del atributo. Depende del atributo `kind`. Valores posibles:
  • si `.kind` = "storage": tipo de campo 4D correspondiente, ver [`Value type`](../commands/value-type)
  • si `.kind` = "relatedEntity": 38 (`is object`)
  • si `.kind` = "relatedEntities": 42 (`is collection`)
  • si `.kind` = "calculated" o "alias" = igual que arriba, dependiendo del valor resultante (tipo de campo, relatedEntity o relatedEntities)
    • | -| indexed | Boolean | True si hay un índice B-tree o Cluster B-tree en el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | -| inverseName | Text | Nombre del atributo que se encuentra al otro lado de la relación. Sólo se devuelve cuando `.kind` = "relatedEntity" o "relatedEntities". | -| keywordIndexed | Boolean | True si existe un índice de palabras clave en el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | -| kind | Text | Categoría del atributo. Valores posibles:
  • "storage": atributo de almacenamiento (o escalar), es decir, un atributo que almacena un valor, no una referencia a otro atributo
  • "calculated": atributo calculado, es decir, definido a través de una [`función get`](../ORDA/ordaClasses.md#function-get-attributename)
  • "alias": atributo construido sobre [otro atributo](../ORDA/ordaClasses.md#alias-attributes-1)
  • "relatedEntity": atributo de relación N -> 1 (referencia a una entidad)
  • "relatedEntities": atributo de relación 1 -> N (referencia a una selección de entidades)
    • | -| mandatory | Boolean | True si se rechaza la entrada de valores null para el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". Nota: esta propiedad corresponde a la propiedad de campo "Rechazar entrada de valor NULL" a nivel de base de datos 4D. No tiene relación con la propiedad "Obligatorio" existente, que es una opción de control de entrada de datos para una tabla. | -| name | Text | Nombre del atributo como cadena | -| path | Text | Ruta de [un atributo alias](../ORDA/ordaClasses.md#alias-attributes-1) basada en una relación | -| readOnly | Boolean | True si el atributo es de sólo lectura. Por ejemplo, los atributos calculados sin la [función `set`](../ORDA/ordaClasses.md#function-set-attributename) son de solo lectura. | -| relatedDataClass | Text | Nombre del dataclass relacionado con el atributo. Sólo se devuelve cuando `.kind` = "relatedEntity" o "relatedEntities". | -| type | Text | Tipo de valor conceptual del atributo, útil para la programación genérica. Depende del atributo `kind`. Valores posibles:
  • si `.kind` = "storage": "blob", "bool", "date", "image", "number", "object" o "string". "number" se devuelve para todo tipo numérico, incluyendo duración; "string" se devuelve para los tipos de atributos uuid, alfa y texto; los atributos "blob" son [objetos blob](../Concepts/dt_blob.md#blob-types).
  • si `.kind` = "relatedEntity": nombre de la clase de datos relacionada
  • si `.kind` = "relatedEntities": nombre de la clase de datos relacionada + sufijo "Selection"
  • si `.kind` = "calculated" o "alias": igual que en los casos anteriores, dependiendo del resultado
    • | -| unique | Boolean | True si el valor del atributo debe ser único. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | -| classID | Text | Disponible sólo si `.type = "object"` y se ha especificado una clase en el editor de estructuras.
    Devuelve el nombre de la clase utilizada para instanciar el objeto. | +| Propiedad | Tipo | Descripción | +| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| autoFilled | Boolean | True si el valor del atributo es rellenado automáticamente por 4D. Corresponde a las siguientes propiedades de campo 4D: "Autoincremento" para campos de tipo numérico y "Auto UUID" para campos UUID (alfa). No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | +| exposed | Boolean | True si el atributo está expuesto en REST | +| fieldNumber | integer | Número de campo 4D interno del atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | +| fieldType | Integer | Tipo de campo de base de datos 4D del atributo. Depende del atributo `kind`. Valores posibles:
  • si `.kind` = "storage": tipo de campo 4D correspondiente, ver [`Value type`](../commands/value-type)
  • si `.kind` = "relatedEntity": 38 (`is object`)
  • si `.kind` = "relatedEntities": 42 (`is collection`)
  • si `.kind` = "calculated" o "alias" = igual que arriba, dependiendo del valor resultante (tipo de campo, relatedEntity o relatedEntities)
    • | +| indexed | Boolean | True si hay un índice B-tree o Cluster B-tree en el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | +| inverseName | Text | Nombre del atributo que se encuentra al otro lado de la relación. Sólo se devuelve cuando `.kind` = "relatedEntity" o "relatedEntities". | +| keywordIndexed | Boolean | True si existe un índice de palabras clave en el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | +| kind | Text | Categoría del atributo. Valores posibles:
  • "storage": atributo de almacenamiento (o escalar), es decir, un atributo que almacena un valor, no una referencia a otro atributo
  • "calculated": atributo calculado, es decir, definido a través de una [`función get`](../ORDA/ordaClasses.md#function-get-attributename)
  • "alias": atributo construido sobre [otro atributo](../ORDA/ordaClasses.md#alias-attributes-1)
  • "relatedEntity": atributo de relación N -> 1 (referencia a una entidad)
  • "relatedEntities": atributo de relación 1 -> N (referencia a una selección de entidades)
    • | +| mandatory | Boolean | True si se rechaza la entrada de valores null para el atributo. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". Nota: esta propiedad corresponde a la propiedad de campo "Rechazar entrada de valor NULL" a nivel de base de datos 4D. No tiene relación con la propiedad "Obligatorio" existente, que es una opción de control de entrada de datos para una tabla. | +| name | Text | Nombre del atributo como cadena | +| path | Text | Ruta de [un atributo alias](../ORDA/ordaClasses.md#alias-attributes-1) basada en una relación | +| readOnly | Boolean | True si el atributo es de sólo lectura. Por ejemplo, los atributos calculados sin la [función `set`](../ORDA/ordaClasses.md#function-set-attributename) son de solo lectura. | +| relatedDataClass | Text | Nombre del dataclass relacionado con el atributo. Sólo se devuelve cuando `.kind` = "relatedEntity" o "relatedEntities". | +| type | Text | Tipo de valor conceptual del atributo, útil para la programación genérica. Depende del atributo `kind`. Valores posibles:
  • si `.kind` = "storage": "blob", "bool", "date", "image", "number", "object" o "string". "number" se devuelve para todo tipo numérico, incluida la duración; "string" se devuelve para los tipos de atributo uuid, alpha y text; los atributos "blob" son [objetos blob](../Concepts/dt_blob.md#blob-types).
  • si `.kind` = "relatedEntity": nombre de la dataClass relacionada
  • si `.kind` = "relatedEntities": nombre de la dataClass relacionada + sufijo "Selection
  • si `.kind` = "calculated" o "alias": lo mismo que arriba, dependiendo del resultado
    • | +| unique | Boolean | True si el valor del atributo debe ser único. No se devuelve si `.kind` = "relatedEntity" o "relatedEntities". | +| classID | Text | Disponible sólo si `.type = "object"` y se ha especificado una clase en el editor de estructuras.
    Devuelve el nombre de la clase utilizada para instanciar el objeto. | :::tip @@ -644,40 +644,40 @@ El método proyecto ***SearchDuplicate*** busca valores duplicados en cualquier | Parámetros | Tipo | | Descripción | | ---------- | ---------- | --------------------------- | --------------------------- | -| Resultado | Collection | <- | Collection of index objects | +| Resultado | Collection | <- | Colección de objetos índice | #### Descripción -The `.getIndexes()` function returns a collection of all indexes related to the dataclass. +La función `.getIndexes()` devuelve una colección de todos los índices relacionados con la clase de datos. -Each index is an object of the collection. Indexes are returned in the creation/modification order. An empty collection is returned if there is no index in the dataclass. +Cada índice es un objeto de la colección. Los índices se muestran en el orden en que se crearon o modificaron. Se devuelve una colección vacía si no hay ningún índice en la clase de datos. **Colección devuelta** -Each object of the returned collection has the following properties: +Cada objeto de la colección devuelta tiene las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| ---------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| type | Integer | Index type: -1 = Keywords, 0 = default, 1 = Standard B-Tree, 3 = Cluster B-Tree, 4 = Cosine, 5 = Dot, 6 = Euclidean. If the index is set to Automatic, the type property represents the type of the indexing algorithm used | -| automatic | Boolean | True if "automatic" index is selected | -| name | Text | Index name if defined | -| kind | Text | "keywords" if *keyword index* checked, otherwise "regular" | -| attributes | Collection | Index attribute or list of attributes (for composite index) | -| UUID | Text | Index UUID | -| uniqueKey | Boolean | True if index has the Unique key property | +| Propiedad | Tipo | Descripción | +| ---------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| type | Integer | Tipo de índice: -1 = Palabras clave, 0 = predeterminado, 1 = B-Tree estándar, 3 = B-Tree en clúster, 4 = Coseno, 5 = Punto, 6 = Euclídico. Si el índice se establece en Automático, la propiedad de tipo representa el tipo de algoritmo de indexación usado | +| automatic | Boolean | True si el índice "automático" está seleccionado | +| name | Text | Nombre del índice, si está definido | +| kind | Text | "palabras clave" si la casilla *índice de palabras clave* está marcada, de lo contrario "regular" | +| attributes | Collection | Atributo de índice o lista de atributos (para índice compuesto) | +| UUID | Text | Índice UUID | +| uniqueKey | Boolean | True si el índice tiene la propiedad de clave única | :::tip Entrada de blog relacionada -[Managing 4D Indexes Programmatically with getIndexes()](https://blog.4d.com/managing-4d-indexes-programmatically-with-getindexes) +[Gestión de índices 4D por programación con getIndexes()](https://blog.4d.com/managing-4d-indexes-programmatically-with-getindexes) ::: #### Ejemplo -Considering the following table: +Considerando la siguiente tabla: ![table-indexes](../assets/en/API/table-index.png) @@ -799,7 +799,7 @@ La función `.getInfo()` devuelve #### Descripción -La función `.getRemoteCache()` devuelve un objeto que contiene el contenido de la caché ORDA para una clase de datos. +La función `.setRemoteCacheSettings()` define el tiempo de espera y el tamaño máximo de la caché ORDA para una dataclass.. Llamar a esta función desde una aplicación monopuesto de 4D devuelve `Null`. @@ -965,12 +965,12 @@ Cuando se crea, la selección de entidades no contiene ninguna entidad (`mySelec
    Historia -| Lanzamiento | Modificaciones | -| ----------- | ------------------------------------------------------ | -| 21 | Soporte de los objetos 4D.Vector | -| 17 R6 | Soporte de los parámetros Formula | -| 17 R5 | Soporte de los marcadores de posición para los valores | -| 17 | Añadidos | +| Lanzamiento | Modificaciones | +| ----------- | ------------------------------------------------ | +| 21 | Soporte de los objetos 4D.Vector | +| 17 R6 | Soporte de los parámetros Formula | +| 17 R5 | Soporte de los marcadores para los valores | +| 17 | Añadidos |
    @@ -1102,18 +1102,18 @@ El uso de marcadores de posición en las búsquedas **se recomienda** por las si 1. Evita la inserción de código malicioso: si utiliza directamente variables completadas por el usuario dentro de la cadena de búsqueda, un usuario podría modificar las condiciones de búsqueda introduciendo argumentos de búsqueda adicionales. Por ejemplo, imagine una cadena de búsqueda como: -```4d - $vquery:="status = 'public' & name = "+myname //el usuario introduce su nombre - $result:=$col.query($vquery) -``` + ```4d + $vquery:="status = 'public' & name = "+myname //el usuario introduce su nombre + $result:=$col.query($vquery) + ``` Esta búsqueda parece segura ya que se filtran los datos no públicos. Sin embargo, si el usuario introduce en el área *myname* algo como *"smith OR status='private'*, la cadena de consulta se modificaría en el paso de interpretación y podría devolver datos privados. Cuando se utilizan marcadores de posición, no es posible anular las condiciones de seguridad: -```4d - $result:=$col.query("status='public' & name=:1";myname) -``` + ```4d + $result:=$col.query("status='public' & name=:1";myname) + ``` En este caso, si el usuario introduce *smith OR status='private'* en el área *myname*, no se interpretará en la cadena de búsqueda, sino que sólo se pasará como valor. La búsqueda de una persona llamada "smith OR status='private'" simplemente fallará. @@ -1121,10 +1121,10 @@ En este caso, si el usuario introduce *smith OR status='private'* en el área *m 3. Permite el uso de variables o expresiones en los argumentos de búsqueda. Ejemplos: -```4d -$result:=$col.query("address.city = :1 & name =:2";$city;$myVar+"@") -$result2:=$col.query("company.name = :1";"John's Pizzas") -``` + ```4d + $result:=$col.query("address.city = :1 & name =:2";$city;$myVar+"@") + $result2:=$col.query("company.name = :1";"John's Pizzas") + ``` ### Búsqueda de valores null @@ -1294,11 +1294,11 @@ Si *attributePath* designa un atributo que almacena [**objetos vectores**](../AP En este caso, el parámetro *value* debe ser un **objeto vectorial de comparación** que contenga las siguientes propiedades: -| Propiedad | Tipo | Descripción | -| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| vector | [4D.Vector](../API/VectorClass.md) | Obligatorio. El vector a comparar | -| metric | Text | Opcional. [Cálculo vectorial](../API/VectorClass.md#understanding-the-different-vector-computations) a utilizar para la consulta. Puede utilizar una de las siguientes constantes (de texto):
  • `mk cosine` (valor por defecto si no se especifica): calcula la [similitud coseno](./VectorClass.md#cosinesimilarity) entre vectores.
  • `mk dot`: calcula la [similitud escalar](VectorClass.md#dotsimilarity) de los vectores.
  • `mk euclidean`: calcula la [distancia euclidiana](./VectorClass.md#euclideandistance) entre vectores. | -| threshold | Real | Opcional (por defecto: 0,5). Un valor umbral utilizado para filtrar las comparaciones de vectores en función de su puntuación de similitud coseno, punto o euclídea según la "métrica" seleccionada. Es altamente recomendable elegir una similitud que se adapte mejor a su caso de uso específico para obtener resultados óptimos. | +| Propiedad | Tipo | Descripción | +| --------- | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| vector | [4D.Vector](../API/VectorClass.md) | Obligatorio. El vector a comparar | +| metric | Text | Opcional. [Cálculo vectorial](../API/VectorClass.md#understanding-the-different-vector-computations) a utilizar para la consulta. Puede utilizar una de las siguientes constantes (Texto):
  • `mk cosine` (valor por defecto si no se especifica): calcula la [similitud coseno](./VectorClass.md#cosinesimilarity) entre vectores.
  • `mk dot`: calcula la [similitud escalar](VectorClass.md#dotsimilarity) entre vectores.
  • `mk euclidean`: calcula la [distancia euclidiana](./VectorClass.md#euclideandistance) entre vectores. | +| threshold | Real | Opcional (por defecto: 0,5). Un valor umbral utilizado para filtrar las comparaciones de vectores en función de su puntuación de similitud coseno, punto o euclídea según la "métrica" seleccionada. Es altamente recomendable elegir una similitud que se adapte mejor a su caso de uso específico para obtener resultados óptimos. | Sólo se admite un subconjunto de símbolos **comparadores**. Tenga en cuenta que comparan los resultados con el valor umbral: @@ -1772,7 +1772,7 @@ var $results := ds.MyTable.query("myVectorField <= :1 AND salary>100000 order by #### Descripción -La función `.setRemoteCacheSettings()` define el tiempo de espera y el tamaño máximo de la caché ORDA para una dataclass.. +La función `.getRemoteCache()` devuelve un objeto que contiene el contenido de la caché ORDA para una clase de datos.. En el parámetro *settings*, pase un objeto con las siguientes propiedades: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md index 204ad446f6257d..1c5dd4baa5040b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md @@ -39,7 +39,7 @@ Para recuperar el nombre de la clase asociada en tiempo de ejecución, utilice l If you assign `4D.Vector` as the class of an Object type field, you define a **vector field**. Such fields store embessings and can be used to query data using AI features. See the [`4D.Vector` class](../API/VectorClass.md) documentation to see how to query with vectors. -Note that the [**4D Embedding Studio** component](corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. +Note that the [**4D Embedding Studio** component](https://corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. When you assign `4D.Vector` as the class of an Object type field, a specific icon is displayed as field type in the Structure editor: ![](../assets/en/Develop/ai-icon.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md index 6eab440f60dbfb..10dffdd0b0c25d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md @@ -3,276 +3,276 @@ id: structure-tables title: Tablas --- -Tables are the foundation of every 4D database. Each table defines a collection of records that share the same set of fields and properties. In the Structure editor, tables are represented as graphic objects that you can create, rename, or delete, and whose attributes you can configure individually. +Las tablas son la base de cada base de datos 4D. Cada tabla define una colección de registros que comparten el mismo conjunto de campos y propiedades. En el editor de estructuras, las tablas se representan como objetos gráficos que puede crear, renombrar o eliminar, y cuyos atributos puede configurar individualmente. -Using the tools provided by 4D, you can: +Utilizando las herramientas proporcionadas por 4D, puede: -- Define tables and manage their primary keys and relations -- Set and edit table-level properties such as triggers, visibility, and replication -- Control naming rules and organize tables into folders for easier maintenance +- Definir tablas y administrar sus llaves y relaciones primarias +- Definir y editar propiedades a nivel de tabla como triggers, visibilidad y replicación +- Controlar las reglas de nombres y organizar las tablas en carpetas para facilitar el mantenimiento -## Creating a table +## Creación de una tabla -You can create a new table either directly in the Structure window, or via a dialog box. Direct creation is faster; but creation using the dialog box lets you specify certain parameters of the table and cancel the operation when necessary. You can also create tables using copy-paste. +Puede crear una nueva tabla directamente en la ventana de la estructura, o a través de un cuadro de diálogo. La creación directa es más rápida; pero la creación usando el cuadro de diálogo le permite especificar ciertos parámetros de la tabla y cancelar la operación cuando sea necesario. También puede crear tablas usando copiar y pegar. - Para crear una nueva tabla directamente: -1. Right-click an empty area of the Structure editor window, then choose **Add Table...** from the context menu. - **OR** - In the add objects menu of the [Structure editor toolbar](./structure-editor.md#toolbar), choose the Table option. +1. Haga clic derecho en un área vacía de la ventana del editor de estructuras, luego seleccione **Agregar tabla...** en el menú contextual. + **O** + En el menú añadir objetos de la [Barra de herramientas del editor de estructuras](./structure-editor.md#toolbar), elija la opción Tabla. -4D creates the table directly in the Structure editor. You can then change its name, add fields, etc. +4D crea la tabla directamente en el editor de estructuras. A continuación, puede cambiar su nombre, añadir campos, etc. :::note -If you want to put the table in a specific folder, you need to use the Home Page of the Explorer. +Si quiere poner la tabla en una carpeta específica, necesita usar la Página principal del Explorador. ::: -- To create a new table using the "New table" dialog box: +- Para crear una nueva tabla usando el cuadro de diálogo "Nueva tabla": -1. Choose **New > Table...** in the **File** menu (or in the **New** button of the 4D tool bar). - **OR** - On the Tables Page of the Explorer, click on the **\[+]** button. +1. Elija **Nueva > Tabla...** en el menú **Archivo** (o en el botón **Nuevo** de la barra de herramientas 4D). + **O** + En la página de tablas del explorador, haga clic en el botón **\[+]**. -The "New table" dialog box appears. 4D names the first table `Table_1` and then numbers them sequentially: +Aparece el cuadro de diálogo "Nueva tabla". 4D nombra la primera tabla `Table_1` y luego los números secuencialmente: ![](../assets/en/Develop/new-table.png) -2. (optional) Modify the [name of the table](../Concepts/identifiers.md#tables-and-fields) you want to create. -3. (optional) Specify the folder in which you want to place the new table. - By default, the table is placed at the highest level of the folder hierarchy ("Top Level"). Folders are handled in Home Page of the Explorer. -4. Click **OK** to validate. - 4D creates a new table image. It becomes the selected table image in the Structure editor window. +2. (opcional) Modifica el [nombre de la tabla](../Concepts/identifiers.md#tables-and-fields) que quiere crear. +3. (opcional) Especifique la carpeta en la que desea colocar la nueva tabla. + De forma predeterminada, la tabla se coloca en el nivel más alto de la jerarquía de carpetas ("Nivel superior"). Las carpetas se gestionan en la página principal del explorador. +4. Haga clic en **OK** para validar. + 4D crea una nueva imagen de tabla. Se convierte en la imagen de tabla seleccionada en la ventana del editor de estructuras. -- To create a new table by copy-paste: +- Para crear una nueva tabla copiando y pegando: -1. Select and copy the table(s) to be duplicated. -2. Paste the table(s) in the Structure editor window. +1. Seleccione y copie la(s) tabla(s) a duplicar. +2. Pegue la(s) tabla(s) en la ventana del editor de estructuras. -The table is pasted with all its fields and properties. +La tabla se pega con todos sus campos y propiedades. -## Renaming a table +## Renombrar una tabla -You can rename tables at any time. If you have used the old table name in a method, 4D automatically changes it to the new name provided the method is closed. If the method is open, you must make the changes yourself. Each table name must be unique in the database. +Puede renombrar tablas en cualquier momento. Si ha utilizado el nombre de tabla antiguo en un método, 4D lo cambia automáticamente al nuevo nombre siempre que el método esté cerrado. Si el método está abierto, debe hacer los cambios usted mismo. Cada nombre de tabla debe ser único en la base de datos. -You can rename a table directly in the Structure editor, in the Explorer, or using the Inspector palette. +Puede renombrar una tabla directamente en el editor de estructuras, en el explorador, o usando la paleta Inspector. -To rename a table directly (Structure editor or Tables page of the Explorer), **click twice** on the table name (if the table is already selected, click once), so that it switches to editing mode: +Para renombrar una tabla directamente (Editor de estructura o página Tablas del Explorador), **haga clic dos veces** en el nombre de la tabla (si la tabla ya está seleccionada, haga clic una vez) para que pase al modo de edición: ![](../assets/en/Develop/table-rename.png) -Enter the new name and click outside of the table. +Introduzca el nuevo nombre y haga clic fuera de la tabla. -To rename a table using the Inspector palette of the Structure editor, double-click on the table name (or select **Table Properties...** in the context menu of the table) and enter the new name in the "Name" area. +Para renombrar una tabla usando la paleta Inspector del editor de estructuras, haga doble clic en el nombre de la tabla (o seleccione **Propiedades de la tabla..** en el menú contextual de la tabla) e introduzca el nuevo nombre en el área "Nombre". ![](../assets/en/Develop/table-rename-2.png) -4D displays the name and properties of the selected table in the Inspector palette. This palette also indicates the table number. If the Inspector palette is already open but is displaying the properties of another table or another object, just select the desired table image and the palette will then display its properties. +4D muestra el nombre y las propiedades de la tabla seleccionada en la paleta Inspector. Esta paleta también indica el número de la tabla. Si la paleta Inspector ya está abierta pero muestra las propiedades de otra tabla u otro objeto, sólo tiene que seleccionar la imagen de la tabla deseada y la paleta mostrará sus propiedades. -## Deleting a table +## Eliminando una tabla -You can delete tables from your database. There are two ways of deleting tables in 4D: **permanent deletion** (the table and its data are actually removed from the database) and **non-permanent deletion** (the table is simply put into the Trash of the Explorer and may be recovered subsequently). +Puede eliminar tablas de su base de datos. Hay dos maneras de borrar tablas en 4D: **eliminación permanente** (la tabla y sus datos son realmente eliminados de la base de datos) y **eliminación no permanente** (la tabla simplemente se pone en la Papelera del Explorador y puede ser recuperada de forma continua). :::info -You can also remove tables using the [SQL engine of 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). +También puede eliminar tablas usando el [motor SQL de 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). ::: -### Permanent deletion +### Eliminación permanente -To permanently delete one or more database tables in the Structure editor: +Para eliminar permanentemente una o más tablas de la base de datos en el editor de estructuras: -Select the table(s) to be deleted then choose **Clear** from the **Edit** menu or choose **Delete** from the context menu of the table. +Seleccione la(s) tabla(s) a eliminar, luego elija **Limpiar** del menú **Editar** o elija **Eliminar** en el menú contextual de la tabla. -A warning dialog box will ask you to confirm the operation. When you click **OK**, 4D carries out the following operations: +Un cuadro de diálogo de advertencia le pedirá que confirme la operación. Cuando haga clic en **OK**, 4D realiza las siguientes operaciones: -- The table is permanently deleted from the structure. All the data associated with the table are deleted permanently from the data file. -- Any trigger method associated with the table is deleted. -- The forms and lists associated with the table are transformed into project forms and are placed in the Trash of the Explorer. +- La tabla se elimina permanentemente de la estructura. Todos los datos asociados a la tabla se eliminan permanentemente del archivo de datos. +- Cualquier método de activación asociado con la tabla se elimina. +- Los formularios y las listas asociadas a la tabla se transforman en formularios de proyecto y se colocan en la papelera del Explorador. -### Non-permanent deletion +### Eliminación no permanente -Non-permanent deletion of a table consists in putting it in the Trash of the project (which can be accessed via the Explorer), just like the file deletion mechanisms implemented by Windows and macOS. +La eliminación no permanente de una tabla consiste en ponerla en la papelera del proyecto (al que se puede acceder a través del Explorador), al igual que los mecanismos de eliminación de archivos implementados por Windows y macOS. -The table then no longer appears in the 4D editors and its contents become inaccessible but it can still be recovered so long as the Trash is not emptied. +La tabla entonces ya no aparece en los editores 4D y su contenido se vuelve inaccesible, pero todavía se puede recuperar siempre y cuando no se vacíe la Papelera. -To put one or more tables into the Trash from the Structure editor, choose the **Move to Trash** command from the context menu of the table or select the table(s) to be deleted then press the **Delete** or **Backspace** key. A confirmation dialog box appears. If you click **OK**, the table is put into the Trash. It can be recovered at any time from the Trash Page of the Explorer. +Para mover una o varias tablas a la Papelera desde el Editor de estructura, elija el comando Mover a la Papelera en el menú contextual de la tabla o seleccione las tablas que desea eliminar y presione la tecla **Suprimir** o **Retroceso**. Aparece un cuadro de diálogo de confirmación. Si hace clic en **OK**, la tabla pasa a la papelera. Se puede recuperar en cualquier momento desde la Página Papelera del Explorador. -### Numbers of deleted tables +### Números de tablas eliminadas -When a table is deleted, the other tables of the database are not renumbered, so as to avoid endangering the stability of the database. It is therefore possible, for example, to have a database with three tables numbered 2, 4 and 5. +Cuando se elimina una tabla, las otras tablas de la base de datos no se renumeran, para evitar poner en peligro la estabilidad de la base de datos. Por lo tanto, es posible, por ejemplo, tener una base de datos con tres tablas numeradas 2, 4 y 5. -Note that the numbers of permanently deleted tables are reused when new tables are created subsequently. +Tenga en cuenta que los números de tablas eliminadas permanentemente se reutilizan cuando las nuevas tablas se crean de forma simultánea. -## Table properties +## Propiedades de la tabla -You can set several properties for tables using the **Inspector palette** or, for certain properties, using the context menu for the tables. +Puede configurar varias propiedades para tablas usando la **paleta Inspector** o, para ciertas propiedades, usando el menú contextual de las tablas. ### Triggers -A [trigger](./triggers) is a method that runs automatically when certain events related to the table occur. Trigger events can be set in the **Inspector palette** or using the context menu associated with the table (right-click on the title area of the table). Check each event for which you want to [activate the trigger](./triggers#activating-and-creating-a-trigger). +Una [trigger](./triggers) es un método que se ejecuta automáticamente cuando ocurren ciertos eventos relacionados con la tabla. Los eventos trigger pueden establecerse en la **paleta Inspector** o utilizando el menú contextual asociado con la tabla (clic derecho en el área de título de la tabla). Revise cada evento para el cual quiere [activar el trigger](./triggers#activating-and-creating-a-trigger). -You can access the trigger of a table directly from the Structure editor by clicking on the **Edit...** button in the Inspector palette or by selecting **Edit Method...** in the context submenu. You can also create and display triggers with the **Methods Page** of the Explorer. +Puede acceder al trigger de una tabla directamente desde el editor de estructuras haciendo clic en la **Editar. .** botón en la paleta Inspector o seleccionando **Editar método...** en el submenú contextual. También puede crear y mostrar triggers con la **página Métodos** del Explorador. -The [information bar](./structure-editor.md#information-bar) of the **Structure editor** indicates the triggers that are activated for each table. +La [barra de información](./structure-editor.md#information-bar) del **Editor de estructuras** indica los triggers que están activados para cada tabla. ### Atributos -You can set different attributes to configure the appearance and general behavior of each table. +Puede establecer diferentes atributos para configurar la apariencia y el comportamiento general de cada tabla. #### Invisible -This option lets you make a table invisible in the Application mode and for plug-ins. You can activate this option for utility tables or tables that are not being used temporarily. +Esta opción le permite hacer una tabla invisible en el modo Aplicación y para plug-ins. Puede activar esta opción para tablas auxiliares o tablas que no se utilicen temporalmente. -Making a table invisible allows you to limit the operations that a user can perform on a table by making the table and its fields invisible in all editors and some dialog boxes that appear in the Application environment. It can also not be used by plug-ins. +Hacer invisible una tabla le permite limitar las operaciones que un usuario puede realizar en una tabla haciendo que la tabla y sus campos sean invisibles en todos los editores y algunos cuadros de diálogo que aparecen en el entorno de la aplicación. Tampoco puede ser utilizado por plug-ins. -The editors and dialog boxes concerned in the Application environment include the following: +Los editores y los cuadros de diálogo correspondientes en el entorno de la aplicación incluyen lo siguiente: -- All query editors -- Order by editor +- Todos los editores de consulta +- Ordenar por editor - [Editor de etiquetas](../Desktop/labels.md) -- Quick report editor -- Exporting and importing data dialog boxes -- Formula editor +- Editor de informes rápidos +- Cuadros de diálogo para exportar e importar datos +- Editor de fórmulas -In each of these editors, the user is unable to see or choose the table or any of its fields. For instance, the user cannot include any fields from an invisible table in a report or label. +En cada uno de estos editores, el usuario no puede ver o elegir la tabla o cualquiera de sus campos. Por ejemplo, el usuario no puede incluir ningún campo de una tabla invisible en un informe o etiqueta. :::note Notas -- When using these editors, users have the option of saving their specifications (e.g., the query or sort they created) to disk files. In this case, any specified tables or fields that are subsequently made invisible may still be used in the operation. -- Users can type the names of invisible tables and fields in the dialog box. -- It is also possible to set this attribute for each field individually. +- Al utilizar estos editores, los usuarios tienen la opción de guardar sus especificaciones (por ejemplo, la consulta o ordenación que crearon) en los archivos de disco. En este caso, todas las tablas o campos especificados que posteriormente se hagan invisibles pueden ser utilizados en la operación. +- Los usuarios pueden escribir los nombres de las tablas invisibles y los campos en el cuadro de diálogo. +- También es posible establecer este atributo para cada campo individualmente. ::: -Invisible tables and fields are displayed in *italics* in the Structure editor window. +Las tablas y campos invisibles se muestran en *cursiva* en la ventana del editor de estructuras. -#### Color of the table image +#### Color de la imagen de la tabla -A color can be attributed to each table. Using colors helps to organize the structure of a large database. For example, you could use one color for all tables that relate to customers and another for tables that relate to inventory. +Un color puede ser atribuido a cada tabla. Usar colores ayuda a organizar la estructura de una gran base de datos. Por ejemplo, puede usar un color para todas las tablas que se relacionan con los clientes y otra para tablas que se relacionan con el inventario. :::note -It is also possible to attribute a color to each field individually as well as to each relation. +También es posible atribuir un color a cada campo individualmente, así como a cada relación. ::: -To set the color of one or more tables, make your selection and then choose the color using: +Para establecer el color de una o más tablas, haga su selección y luego elija el color utilizando: -- The **Color** button of the Structure editor toolbar -- The **Color** command in the context menu of the tables -- The **Color** option in the **Inspector palette** +- El botón **Color** de la barra de herramientas del editor de estructuras +- El comando **Color** en el menú contextual de las tablas +- La opción **Color** en la **paleta Inspector** -The **Automatic** option can be used to apply the standard original color to the table. +La opción **Automática** puede utilizarse para aplicar el color original estándar a la tabla. -#### Expose as REST resource +#### Exponer como recurso REST -This option controls whether the [table is exposed to REST requests](../REST/configuration.md#exposing-tables). +Esta opción controla si la [tabla está expuesta a solicitudes REST](../REST/configuration.md#exposing-tables). :::note Notas -- You can also set this option at the level of each field of the table. -- This option is used in the context of [ORDA remote datastore features](../ORDA/remoteDatastores.md). +- También puede establecer esta opción en el nivel de cada campo de la tabla. +- Esta opción se utiliza en el contexto de las [funcionalidades de almacenamiento remoto de ORDA](../ORDA/remoteDatastores.md). ::: -#### Records definitively deleted +#### Registros eliminados definitivamente -This option lets you optimize the deletion of a selection of records made using the [`DELETE SELECTION`](../commands/delete-selection) command. +Esta opción le permite optimizar la eliminación de una selección de registros realizados utilizando el comando [`DELETE SELECTION`](../commands/delete-selection). -When 4D deletes a selection, the record markers are also deleted. A record marker is a header attached to the record that contains information relating to this record. Deleting both markers and records is slower than deleting only records. In certain cases, it may be desirable to not automatically delete the record markers. +Cuando 4D elimina una selección, los marcadores de registro también se eliminan. Un marcador de registro es un encabezado adjunto al registro que contiene información relacionada con este registro. Eliminar marcadores y registros es más lento que eliminar sólo registros. En algunos casos, puede ser deseable no eliminar automáticamente los marcadores de registro. -To accelerate the deletion of a large selection made using the [`DELETE SELECTION`](../commands/delete-selection) command, deselect the **Records definitively deleted** option. Record markers will then not be deleted. This option cannot be set by programming. +Para acelerar el borrado de una selección grande hecha utilizando el comando [`DELETE SELECCION`](../commands/delete-selection), anule la selección de **Registros definitivamente eliminados**. No se eliminarán los marcadores de registro. Esta opción no puede ser definida por programación. -#### Enable replication +#### Habilitar replicación :::info Obsoleto -Replication and synchronize mechanisms using SQL are deprecated as of 4D 20 R3. They are still supported but it is now recommended to use the [ORDA-based Global Stamp feature](../ORDA/global-stamp.md), providing a flexible and robust solution to implement replication and synchronization in 4D. +Los mecanismos de replicación y sincronización usando SQL están obsoletos a partir de 4D 20 R3. Todavía son soportados, pero ahora se recomienda usar la [función de sello global basado en ORDA](../ORDA/global-stamp.md), proporcionando una solución flexible y robusta para implementar replicación y sincronización en 4D. ::: -#### Include in Log File +#### Incluída en el archivo de registro -By default, this option is checked for all new tables created and for all tables in converted databases. Check this option in order for operations performed on the table’s data to be included in the [database log file](../Backup/log.md) (when it is generated). +De forma predeterminada, esta opción se marca para todas las nuevas tablas creadas y para todas las tablas en bases de datos convertidas. Marque esta opción para que las operaciones realizadas en los datos de la tabla sean incluidas en el [archivo de registro de la base de datos](../Backup/log.md) (cuando se genere). -This option must generally be checked for most tables. However, for optimization purposes, you can uncheck it, for example for temporary tables or tables used for importing data. +Esta opción generalmente debe ser chequeada para la mayoría de las tablas. Sin embargo, para fines de optimización, puede desmarcarlo, por ejemplo para tablas temporales o tablas utilizadas para importar datos. -It is important to note that this option only indicates that the table’s data must be journaled if the database uses a log file; it does not enable the journaling procedure itself at the database level. +Es importante tener en cuenta que esta opción sólo indica que los datos de la tabla deben ser almacenados si la base de datos utiliza un archivo de registro; no permite el procedimiento diario de transacciones en sí mismo a nivel de base de datos. :::note Notas -- This option is grayed out when the table does not have a primary key. -- 4D displays a warning icon to the right of the **Include in Log File** option when the required conditions are not met. As long as this icon is shown, journaling is not yet enabled. +- Esta opción se graba cuando la tabla no tiene una llave primaria. +- 4D muestra un icono de advertencia a la derecha de la opción **Incluir en archivo de registro** cuando no se cumplen las condiciones requeridas. Mientras se muestre este icono, el diario de transacciones aún no está habilitado. ::: -#### Encryptable +#### Cifrable -This option controls whether the data stored in the table must be encrypted on disk when [data file encryption is enabled](../MSC/encrypt.md). +Esta opción controla si los datos almacenados en la tabla deben ser cifrados en el disco cuando [el cifrado del archivo de datos está habilitado](../MSC/encrypt.md). -Since encrypting/decrypting can be time consuming, selecting the tables to encrypt allows you to optimize the performance of encrypted databases. For example, you could set only the tables that contain personal data as **Encryptable**. +Dado que el cifrado/descifrado puede llevar mucho tiempo, seleccionar las tablas para cifrar le permite optimizar el rendimiento de las bases de datos cifradas. Por ejemplo, sólo se pueden establecer las tablas que contienen datos personales como **Encriptable**. -Note that this option flags table(s); it does not perform any encryption or decryption operation. To actually encrypt or decrypt selected table(s) in the data file, you must use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command. +Tenga en cuenta que esta opción marca tabla(s); no realiza ninguna operación de cifrado o descifrado. Para cifrar o descifrar tabla(s) seleccionadas en el archivo de datos, debe usar el comando [MSC](../MSC/encrypt.md) o llamar al [`Encrypt data file`](../commands/encrypt-data-file). :::warning -- When you modify the value of this option for a table in an already encrypted database, you must also use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command to preserve data consistency. Otherwise, you will not be allowed to save data in the modified table (errors will be returned by 4D when trying to save records). -- Encryption of data stored outside of the data file is not managed by this option. +- Cuando modifica el valor de esta opción para una tabla en una base de datos ya cifrada, también debe usar el comando [MSC](../MSC/encrypt.md) o llamar a [`Encrypt data file`](../commands/encrypt-data-file) para preservar la consistencia de los datos. De lo contrario, no se le permitirá guardar datos en la tabla modificada (los errores serán devueltos por 4D al intentar guardar registros). +- El cifrado de datos almacenados fuera del archivo de datos no es administrado por esta opción. ::: ### Comentarios -The **Comments** area of the **Inspector palette** lets you store additional information about the table. These comments are available for all the developers. Note that each field and each relation has its own comments area. +El área **Comentarios** de la **paleta Inspector** le permite almacenar información adicional sobre la tabla. Estos comentarios están disponibles para todos los desarrolladores. Tenga en cuenta que cada campo y cada relación tiene su propio área de comentarios. ### SQL -- The "Schemas" menu lists all the SQL schemas specified in the database. You can use this menu to set the schema to which the table will belong (it is also possible to modify this property via SQL commands). Every database has at least one schema, named **DEFAULT_SCHEMA**. By default, all the tables belong to this schema. For more information about SQL schemas, refer to the [**Schemas** section](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) in the *4D SQL Reference guide*. -- The information area indicates whether the name of the table respects the rules regarding SQL nomenclature (for example, unlike 4D, SQL does not allow a field name to contain spaces). +- El menú "Esquemas" lista todos los esquemas SQL especificados en la base de datos. Puede usar este menú para establecer el esquema al que pertenecerá la tabla (también es posible modificar esta propiedad mediante comandos SQL). Cada base de datos tiene al menos un esquema, llamado **DEFAULT_SCHEMA**. Por defecto, todas las tablas pertenecen a este esquema. Para obtener más información sobre esquemas SQL, consulte la [sección **Esquemas**](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) en la guía de referencia *4D SQL*. +- El área de información indica si el nombre de la tabla respeta las reglas relativas a la nomenclatura SQL (por ejemplo, a diferencia de 4D, SQL no permite que un nombre de campo contenga espacios). -### Primary keys +### Llaves primarias -A primary key designates the field(s) used for uniquely identifying the records in a table. Setting a primary key is necessary for the [journaling features](../Backup/log.md). +Una llave primaria designa los campo(s) utilizados para identificar de forma única los registros en una tabla. Definir una llave primaria es necesario para las [funcionalidades del registro](../Backup/log.md). -You create, edit and/or remove primary keys directly using the context menu of the Structure editor or the [Primary key manager](#primary-key-manager). +Cree, edite y/o elimine las llaves primarias directamente usando el menú contextual del editor de estructuras o el [Administrador de llaves primarias](#primary-key-manager). -> **Note:** Primary keys can also be set using the SQL language by means of the **PRIMARY KEY** clause followed by the list of columns. +> **Nota:** las llaves primarias también pueden establecerse usando el lenguaje SQL mediante la cláusula **PRIMARY KEY** seguida por la lista de columnas. -#### Rules for using primary key fields +#### Reglas para el uso de campos llave primaria -Primary key fields should be handled with care to ensure data integrity at all times. In particular, a primary key field must respect the following rules: +Los campos llave primaria deben manejarse con cuidado para garantizar la integridad de los datos en todo momento. En particular, un campo llave primaria debe respetar las siguientes reglas: -- it must not be empty, +- no debe estar vacío, - debe ser único, -- once created, it should (in principle) never be modified, especially if: - - [Global stamp features](../ORDA/global-stamp.md) are enabled, - - [REST (or similar) feature](../REST/gettingStarted.md) is enabled, - - the database is periodically synchronized (backup or logical mirror using the [log file](../Backup/log.md)). +- una vez creado, (en principio) nunca debe ser modificado, especialmente si: + - [funcionalidades de sello global](../ORDA/global-stamp.md) están habilitadas, + - [funcionalidad REST (o similar)](../REST/gettingStarted.md) está habilitada, + - la base de datos se sincroniza periódicamente (copia de seguridad o réplica lógica usando el [archivo de registro](../Backup/log.md)). -Modifying primary key field value is highly discouraged, even if 4D allows it for specific use cases. -If you absolutely need to modify a primary key value (e.g. you used a social security number field as primary key and incorrect values have been entered), it is preferable to disable (remove) the current primary key and to add a new field used as primary key with automatic assignment. +Modificar el valor del campo llave primaria es altamente desaconsejado, incluso si 4D lo permite para casos de uso específicos. +Si es absolutamente necesario modificar un valor de llave primaria (p.e. ha usado un campo de número de seguridad social como llave primaria y se han introducido valores incorrectos), es preferible deshabilitar (eliminar) la llave primaria actual y añadir un nuevo campo usado como llave primaria con asignación automática. -Primary key fields can be long integer type or UUID format (alpha type). In most cases, we recommend the UUID format with the Auto UUID option enabled. Even though the long integer type takes up less disk space, UUIDs have many advantages, for example, facilitating the merge of independent databases, data import/export, implementation of elaborate mirror/replication strategies or synchronization with external systems. +Los campos llave primaria pueden ser de tipo entero largo o formato UUID (tipo alfa). En la mayoría de los casos, recomendamos el formato UUID con la opción Auto UUID activada. Aunque el tipo entero largo ocupa menos espacio en disco, los UUIDs tienen muchas ventajas, por ejemplo, facilitando la fusión de bases de datos independientes, importación/exportación de datos, implementación de estrategias elaboradas de réplica/replicación o sincronización con sistemas externos. -#### Setting primary keys +#### Configurando llaves primarias -To create a primary key from the Structure editor: +Para crear una llave primaria desde el editor de estructuras: -1. Select the field(s) that make up the table’s primary key. -2. Right-click and choose **Create primary key** in the context menu (this command is only displayed for fields whose type is eligible for primary keys). +1. Seleccione los campos que componen la llave primaria de la tabla. +2. Haga clic derecho y elija **Crear llave primaria** en el menú contextual (este comando sólo se muestra para campos cuyo tipo es elegible para las llaves primarias). -You cannot have more than one primary key for each table. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. +No puede tener más de una llave primaria para cada tabla. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. -The primary key is created immediately. Fields included in the primary key are *underlined* in the editor and their SQL description displays the **PRIMARY KEY** keyword. +La llave primaria se crea inmediatamente. Los campos incluidos en la llave primaria están *subrayados* en el editor y su descripción SQL muestra la palabra clave **PRIMARY KEY**. -When you create a primary key in a table that already contains records (using an existing field or adding a new one), 4D checks the conformity of all the values present or automatically performs updating operations: +Cuando crea una llave primaria en una tabla que ya contiene registros (usando un campo existente o agregando uno nuevo), 4D comprueba la conformidad de todos los valores presentes o realiza automáticamente operaciones de actualización: -- The field(s) belonging to the primary key cannot contain any duplicated values. If any duplicated values for the key exist in the table records, a warning dialog box appears to indicate that it is not possible to create the key because of this. -- If the duplicated values are blank or null values (case of an added key field), you can check the corresponding automatic generation option (for Alpha fields in or for Longint fields). - In this case, 4D examines all the records of the table and automatically assigns a calculated value to each primary key. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. +- Los campo(s) pertenecientes a la llave primaria no pueden contener ningún valor duplicado. Si existen valores duplicados para la llave en los registros de la tabla, un cuadro de diálogo de advertencia parece indicar que no es posible crear la llave por esta razón. +- Si los valores duplicados están en blanco o son nulos (como en el caso de un campo clave añadido), puede marcar la opción de generación automática correspondiente (para campos Alpha o para campos Entero largo). + En este caso, 4D examina todos los registros de la tabla y asigna automáticamente un valor calculado a cada llave primaria. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. > **Note:** The column(s) belonging to the primary key do not accept NULL values. @@ -280,11 +280,8 @@ When you create a primary key in a table that already contains records (using an To remove a primary key from a table: -1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu: - -[imagen aquí] - -A confirmation dialog box appears. Click **OK** to remove the primary key. +1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu. + Aparece un cuadro de diálogo de confirmación. Click **OK** to remove the primary key. #### Default primary key field diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md index 13661feec448d8..00fa06ae078750 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md @@ -31,6 +31,24 @@ En Windows, el concepto de "opción recomendada" no está soportado: sólo el bo --- +## Display formula source as symbol + +Displays source text of formulas as symbols when expressions are shown as references. + +#### Gramática JSON + +| Nombre | Tipos de datos | Valores posibles | +| ---------------------- | -------------- | -------------------------------------------- | +| displayFormulaAsSymbol | boolean | true (por defecto), false | + +#### Objetos soportados + +[Área 4D Write Pro](writeProArea_overview.md) + +#### Comandos + +[WP Get view properties](../WritePro/commands-legacy/wp-get-view-properties.md) - [WP SET VIEW PROPERTIES](../WritePro/commands-legacy/wp-set-view-properties.md) + ## Ocultar rectángulo de enfoque Durante la ejecución, un campo o toda área introducible es delimitada por un rectángulo de selección cuando tiene el foco (a través de la tecla Tab o un simple clic). Puede ocultar este rectángulo activando esta propiedad. Ocultar el rectángulo de enfoque puede ser útil en el caso de interfaces específicas. @@ -137,7 +155,7 @@ Define la resolución de la pantalla para el contenido del área 4D Write Pro. P --- -## Mostrar el fondo +## Show background and anchored elements Muestra/oculta tanto las imágenes de fondo como el color de fondo. @@ -157,6 +175,24 @@ Muestra/oculta tanto las imágenes de fondo como el color de fondo. --- +## Show empty or unsupported images + +Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). + +#### Gramática JSON + +| Nombre | Tipos de datos | Valores posibles | +| --------------- | -------------- | -------------------------------------------- | +| showEmptyImages | boolean | true (por defecto), false | + +#### Objetos soportados + +[Área 4D Write Pro](writeProArea_overview.md) + +#### Comandos + +[WP Get view properties](../WritePro/commands-legacy/wp-get-view-properties.md) - [WP SET VIEW PROPERTIES](../WritePro/commands-legacy/wp-set-view-properties.md) + ## Mostrar los pies de página Muestra/oculta los pies de página cuando el [modo visualización de la página ](#view-mode) está definido como "Página". @@ -325,6 +361,26 @@ Con la propiedad Mostrar referencias activada, se muestra la referencia: --- +## Show table borders + +Displays internal and external table borders as dotted lines when these borders are partially or totally invisible. This facilitates page layout (more accessible, more visual resizing) and data entry (convenient in the case of merged cells, for example). + +![](../assets/en/FormObjects/visible.png) + +#### Gramática JSON + +| Nombre | Tipos de datos | Valores posibles | +| ---------------- | -------------- | -------------------------------------------- | +| showTableBorders | boolean | true, false (por defecto) | + +#### Objetos soportados + +[Área 4D Write Pro](writeProArea_overview.md) + +#### Comandos + +[WP Get view properties](../WritePro/commands-legacy/wp-get-view-properties.md) - [WP SET VIEW PROPERTIES](../WritePro/commands-legacy/wp-set-view-properties.md) + ## Mostrar regla vertical Muestra/oculta la regla vertical cuando la vista del documento está en modo [Página](#view-mode). @@ -355,7 +411,7 @@ Cuando los controles de pestañas con una dirección personalizada se muestran e | Nombre | Tipos de datos | Valores posibles | | --------------- | -------------- | ---------------- | -| labelsPlacement | boolean | "top", "bottom" | +| labelsPlacement | text | "top", "bottom" | #### Objetos soportados diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md index e4892cea1b9a15..4b68b8d642d182 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md @@ -90,9 +90,9 @@ Las variables o expresiones se pueden introducir o no y pueden recibir datos de #### Gramática JSON -| Nombre | Tipos de datos | Valores posibles | -| ---------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | cadena o array de cadenas |
  • Variable 4D, nombre de campo o cualquier expresión.
  • Cadena vacía para [variables dinámicas](#dynamic-variables).
  • Array de cadenas (colección de nombres de arrays) para una columna de [listbox jerárquico](listbox_overview.md#hierarchical-list-boxes)
    • | +| Nombre | Tipos de datos | Valores posibles | +| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | cadena o array de cadenas |
  • Variable, nombre de campo o cualquier expresión 4D.
  • Cadena vacía para las [variables dinámicas](#dynamic-variables).
  • Array de cadenas (colección de nombres de array) para una columna de [listbox jerárquico](listbox_overview.md#hierarchical-list-boxes)]
    • | ### Expresiones diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/privileges.md b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/privileges.md index 0c8d1141597dd8..a23ede3289c37b 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/privileges.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/ORDA/privileges.md @@ -3,17 +3,15 @@ id: privileges title: Rôles et privilèges --- -Protéger les données tout en permettant un accès rapide et facile aux utilisateurs autorisés est un défi majeur pour les applications web. L'architecture de sécurité ORDA est implémentée au cœur de votre datastore et vous permet de définir des privilèges spécifiques à toutes les sessions utilisateur web ou REST pour les différentes ressources de votre projet (datastore, dataclasses, fonctions, etc.). +The ORDA security architecture controls access to project resources for web and REST sessions. It lets you grant specific permissions on resources such as the datastore, dataclasses, attributes, and functions. ## Vue d’ensemble -L'architecture de sécurité ORDA est basée sur les concepts de privilèges, d'actions de permission (lecture, création, etc.) et de ressources. +The security model combines **privileges**, **actions** (such as `read` and `create`), and **resources**. -Lorsque les utilisateurs web ou REST sont enregistrés, leur session est automatiquement chargée avec les privilèges associés. Les privilèges sont assignés à la session en utilisant la fonction [`session.setPrivileges()`](../API/SessionClass.md#setprivileges). +Assign privileges to a **session** using [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges). -Chaque requête utilisateur envoyée dans la session est évaluée par rapport aux privilèges définis dans le fichier `roles.json` du projet. - -Si un utilisateur tente d'exécuter une action et ne dispose pas des droits d'accès appropriés, une erreur de privilège est générée ou, en cas de permission de lecture manquante sur les attributs, ils ne sont pas envoyés. +Each request is checked against the permissions defined in the project's `roles.json` file. An unauthorized action raises a privilege error. Attributes without read permission are omitted from the response. ![schema](../assets/en/ORDA/privileges-schema.png) @@ -23,50 +21,30 @@ Si un utilisateur tente d'exécuter une action et ne dispose pas des droits d'ac ::: -## Resources - -Vous pouvez assigner des actions de permission spécifiques aux ressources suivantes dans votre projet : +:::info -- le [datastore](../ORDA/dsMapping.md#datastore) -- les [dataclasses](../ORDA/dsMapping.md#dataclass) -- les [attributs](../ORDA/dsMapping.md#attribute) (y compris [calculés](./ordaClasses.md#computed-attributes-1) et [alias](./ordaClasses.md#alias-attributes-1)) -- les fonctions des [classes du modèle de données](../ORDA/ordaClasses.md) -- les fonctions [singleton](../REST/$singleton.md) +Les permissions contrôlent l'accès aux objets ou fonctions du datastore. Si vous voulez filtrer les données de lecture selon certains critères, vous pouvez envisager d'utiliser les [entity selections restreintes](entities.md#restricting-entity-selections) qui peuvent être plus appropriées dans ce cas. -Chaque fois qu'on accède à une ressource dans une session (quelle que soit la manière dont on y accède), 4D vérifie que la session dispose des autorisations appropriées et rejette l'accès s'il n'est pas autorisé. +::: -## Permissions +## Portée -Une permission est la possibilité d'effectuer une action sur une ressource. Par exemple, *exécuter la fonction ds.myTable.myFunction()* représente une **permission**. Les permissions sont définies pour le projet dans le fichier [`roles.json`](#rolesjson-file). Chaque permission peut être accordée à un ou plusieurs [privileges](#privileges-and-roles). +Permissions apply to **web and REST sessions**: [REST requests](../REST/gettingStarted.md), including [Qodly pages](https://developer.4d.com/qodly/4DQodlyPro/pageLoaders/pageLoaderOverview), and **4D code executed in a web process**. This includes [exposed functions](./ordaClasses.md), [HTTP request handlers](../WebServer/http-request-handler.md), the [On Web Connection database method](../commands/on-web-connection-database-method), and any code they call. For example, an allowed function call still fails if the function reads a dataclass for which the session has no read permission. -Quand **aucune permission spécifique** n'a été définie pour une ressource, l'accès à la ressource peut être automatiquement **sans restriction** ou **restreint** selon le [mode par défaut défini pour le projet](#restriction-modes). +:::info Exception -### Actions de permission +The **execute** permission of a [shared singleton](../Concepts/classes.md#shared-singleton) or [singleton function](../Concepts/classes.md#singleton-classes) is checked only when the function is [called through REST](../REST/$singleton.md). When 4D code running in a web session directly calls it (`cs.MySingleton.me.myFunction()`), no permission is checked, unlike dataclass, entity, entity selection and datastore functions, which are checked in both cases. -Les actions disponibles sont liées à la ressource cible. +::: -| Actions | datastore | dataclass | attribut | fonction du modèle de données ou fonction singleton | -| ----------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **create** | Créer une entité dans n'importe quelle dataclass | Créer une entité dans cette dataclass | Créer une entité avec une valeur différente de la valeur par défaut autorisée pour cet attribut (ignoré pour les attributs alias). | n/a | -| **read** | Lire les attributs de n'importe quelle dataclass | Lire les attributs de cette dataclass | Lire ce contenu d'attribut | n/a | -| **update** | Mettre à jour les attributs dans n'importe quelle dataclass. | Mettre à jour les attributs de cette dataclass. | Mettre à jour le contenu de cet attribut (ignoré pour les attributs alias). | n/a | -| **drop** | Supprimer des données dans n'importe quelle dataclass. | Supprimer des données dans cette dataclass. | Supprimer une valeur non nulle pour cet attribut (sauf pour les attributs alias et calculés). | n/a | -| **execute** | Exécuter n'importe quelle fonction du projet (datastore, dataclass, entity selection, entité, singleton) | Exécuter n'importe quelle fonction de dataclass. Les fonctions de dataclass, d'entité et d'entity selection sont considérées comme des fonctions de dataclass | n/a | Exécuter cette fonction | -| **promote** | n/a | n/a | n/a | Associe un privilège donné lors de l'exécution de la fonction. Associe un privilège donné lors de l'exécution de la fonction. Par mesure de sécurité, seul le process exécutant la fonction reçoit le privilège, et non toute la session. | +Permissions never apply to [desktop session code](../Desktop/sessions.md) (standalone, client/server, stored procedures) or [tool4d](../Admin/cli.md#tool4d). -:::note Notes +:::warning -- Un [alias](./ordaClasses.md#alias-attributes-1) peut être lu dès que les privilèges de la session autorisent l'accès à l'alias lui-même, même si les privilèges de la session n'autorisent pas l'accès aux attributs résolvant l'alias. -- Un [attribut calculé](./ordaClasses.md#computed-attributes-1) est accessible même si les attributs sur lesquels il est construit ne font l'objet d'aucune autorisation. -- Vous pouvez assigner une action de permission à une classe singleton (type `singleton`), auquel cas elle sera appliquée à toutes ses fonctions exposées, ou bien à une fonction de singleton (type `singletonMethod`). -- Vous pouvez définir/supprimer l'action **promote** dynamiquement pour un process web en utilisant les fonctions [`promote()`](../API/SessionClass.md#promote) et [`demote()`](../API/SessionClass.md#demote). -- Valeurs par défaut : dans l'implémentation actuelle, seul *Null* est disponible en tant que valeur par défaut. -- En mode REST [force login](../REST/authUsers.md#force-login-mode), la fonction [`authentify()`](../REST/authUsers.md#function-authentify) est toujours exécutable par les utilisateurs guest, quelle que soit la configuration des permissions. +When a permission entry references an undeclared [privilege](#privileges-and-roles), 4D logs an error and ignores the entry. In this case, the permission is ignored. If the [restricted mode by default](#restriction-modes) is not enabled, the resource is accessible to `guest` sessions. ::: -Le paramétrage des permissions nécessite d'être cohérent, en particulier les permissions **update** et **drop** ont également besoin d'une permission **read** (mais **create** n'en a pas besoin). - ### MCP tools The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: @@ -95,23 +73,53 @@ MCP clients authenticated with the "salesReader" privilege can read the Customer } ``` -### Permissions héritées +### MCP tools -Une action de permission définie à un certain niveau est héritée par défaut aux niveaux inférieurs, mais plusieurs niveaux de permissions peuvent être définis : +The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: -- Une action de permission définie au niveau du datastore est automatiquement assignée à toutes les dataclass. Une action de permission définie au niveau du datastore est automatiquement assignée à toutes les dataclass. -- Une action de permission définie au niveau dataclass remplace le paramétrage du datastore (le cas échéant). Par défaut, tous les attributs de la dataclass héritent des permissions de la dataclass. -- Contrairement aux permissions des dataclass, une action de permission définie au niveau de l'attribut ne remplace pas la permission de la dataclass parente, mais y est ajoutée. Par exemple, si vous avez attribué le privilège "général" à une dataclass et le privilège "détail" à un attribut de la dataclass, les deux privilèges, "général" et "détail", doivent être définis dans la session afin d'accéder à l'attribut. +- A [custom tool](../WebServer/mcp-server.md#custom-tools) (`exposed MCP Function`) requires the **execute** permission on its function, and benefits from its **promote** permission. +- The [built-in CRUD tools](../WebServer/mcp-server.md#built-in-crud-tools) require the **read**, **create**, **update**, or **drop** permission on the dataclass, and the attribute permissions apply. Each attribute of a path used in a filter, a sort, or a projection requires the **read** permission. +- The CRUD tools are listed only if the session has at least one data permission on a dataclass, and the `describeModel` tool only describes the dataclasses on which the session has a data permission, with their readable or writable attributes. +- A tool, a dataclass, or an attribute that the session cannot access is reported as if it did not exist. -:::info +#### Exemple -Les permissions contrôlent l'accès aux objets ou fonctions du datastore. Si vous voulez filtrer les données de lecture selon certains critères, vous pouvez envisager d'utiliser les [entity selections restreintes](entities.md#restricting-entity-selections) qui peuvent être plus appropriées dans ce cas. +MCP clients authenticated with the "salesReader" privilege can read the Customer and Order dataclasses with the CRUD tools, and call the tools published by the `OrderManager` singleton (for example `OrderManager-getYearTotal`): -::: +```json +{ + "privileges": [{"privilege": "salesReader", "includes": []}], + "roles": [], + "permissions": { + "allowed": [ + {"applyTo": "Customer", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "Order", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "OrderManager", "type": "singleton", "execute": ["salesReader"]} + ] + }, + "restrictedByDefault": true +} +``` + +## Resources + +4D checks the session's permissions whenever a resource is accessed. The following resources can have specific permissions: + +| Ressource | `applyTo` | `type` | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ----------------- | +| [Datastore](./dsMapping.md#datastore) | `ds` | `datastore` | +| [Datastore class function](./ordaClasses.md#datastore-class) | `ds.` | `method` | +| [Dataclass](./dsMapping.md#dataclass) | `` | `dataclass` | +| [Attribute](./dsMapping.md#attribute) (including [computed](./ordaClasses.md#computed-attributes-1) and [alias](./ordaClasses.md#alias-attributes-1)) | `.` | `attribut` | +| [Dataclass, entity or entity selection function](./ordaClasses.md) | `.` | `method` | +| [Shared singleton](../Concepts/classes.md#shared-singleton) (all its exposed functions) | `` | `singleton` | +| [Singleton function](../Concepts/classes.md#singleton-classes) | `.` | `singletonMethod` | + +Use the `applyTo` and `type` values shown in the table when defining permissions in [`roles.json`](#rolesjson-file). -### Attribution de permissions aux fonctions de la classe ORDA +:::note Attribution de permissions aux fonctions de la classe ORDA -Lors de la configuration des permissions, les fonctions de classe ORDA sont déclarées dans l'élément `applyTo` en utilisant la syntaxe suivante : +In `roles.json`, identify an ORDA class function in `applyTo` with this syntax: ```json . @@ -126,13 +134,13 @@ Class extends Entity ... ``` -... vous devez écrire : +Use this value: ```json "applyTo":"City.getPopulation" ``` -Cela signifie que vous ne pouvez pas utiliser les mêmes noms de fonctions dans les différentes classes ORDA (entité, entity selection, dataclass) si vous souhaitez que des privilèges leur soient attribués. Dans ce cas, vous devez utiliser des noms de fonction distincts. Par exemple, si vous avez créé une fonction "drop" dans les classes `cs.CityEntity` et `cs.CitySelection`, vous devez leur donner des noms différents tels que `dropEntity()` et `dropSelection()`. Vous pouvez ensuite écrire dans le fichier "roles.json" : +Because permissions identify functions by dataclass and function name, functions with the same name in different ORDA classes (entity, entity selection, dataclass) cannot be assigned different privileges. Give them distinct names instead. For example, name the functions `dropEntity()` and `dropSelection()` in `cs.CityEntity` and `cs.CitySelection`, respectively: ```json "permissions": { @@ -151,22 +159,82 @@ Cela signifie que vous ne pouvez pas utiliser les mêmes noms de fonctions dans "name" ] } - ] + ] + } +} ``` +::: + +## Permissions + +A **permission** allows an action on a resource; for example, executing `ds.myTable.myFunction()`. Permissions are defined in [`roles.json`](#rolesjson-file) and granted to one or more [privileges](#privileges-and-roles). + +If no permission is defined for a resource, access depends on the project's [restriction mode](#restriction-modes). + +### Actions de permission + +Available actions depend on the resource: + +| Action | Datastore | Dataclass | Attribut | Function | +| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **create** | Create entities in any dataclass | Create entities in this dataclass | Create an entity with a non-default value for this attribute (ignored for alias attributes) | n/a | +| **read** | Lire les attributs de n'importe quelle dataclass | Lire les attributs de cette dataclass | Read this attribute's content | n/a | +| **update** | Mettre à jour les attributs dans n'importe quelle dataclass | Mettre à jour les attributs de cette dataclass | Update this attribute's content (ignored for alias attributes) | n/a | +| **drop** ("Delete" in Qodly Studio) | Supprimer des données dans n'importe quelle dataclass | Supprimer des données dans cette dataclass | Delete a non-null value for this attribute (except for alias and computed attributes) | n/a | +| **execute** | Execute any function on the project (datastore, dataclass, entity selection, entity, or singleton) | Execute any function on the dataclass; dataclass, entity, and entity selection functions are treated as dataclass functions | n/a | Exécuter cette fonction | +| **promote** | n/a | n/a | n/a | Temporarily add a privilege for the duration of the function call. Only the process executing the function receives it, not the whole session. Use [`promote()`](../API/SessionClass.md#promote) and [`demote()`](../API/SessionClass.md#demote) to set or remove this action dynamically in a web process. | + +### Permission rules + +- **update** and **drop** require **read** on the resource; **create** does not. +- A function can be **promoted** by multiple privileges. During execution, it receives the combined permissions of all those privileges; there is no priority order. +- An [alias attribute](./ordaClasses.md#alias-attributes-1) can be read if the session has permission to read the alias, even if it cannot read the attributes the alias resolves to. +- A [computed attribute](./ordaClasses.md#computed-attributes-1) can be accessed even if its underlying attributes have no permissions. +- In REST [force login mode](../REST/authUsers.md#force-login-mode), guest users can always execute [`authentify()`](../REST/authUsers.md#function-authentify), regardless of the permissions configuration. + +### Permissions héritées + +Permission actions are inherited according to the following rules: + +1. Permissions descend **datastore → dataclass → attribute / function**, and **datastore → singleton → singleton function**. +2. Resolution is **per action**. Defining `read` on a dataclass does not change how `create`, `update`, `drop` or `execute` are resolved for it. +3. **Dataclass replaces datastore**. A permission defined on a dataclass for an action replaces the datastore permission for that action. Privileges granted the action only on the datastore lose it on that dataclass. +4. **Function replaces dataclass**. An `execute` permission defined on a function replaces the dataclass (and datastore) `execute` permission for that function. Entity and entity selection functions follow the same rule as dataclass functions. +5. **Singleton replaces datastore**, **singleton function replaces singleton**. +6. **Datastore function replaces datastore**. +7. **Attribute adds to its parent**. To act on an attribute that has its own permission, a session needs a privilege granted by the attribute permission **and** a privilege granted the action on the dataclass (directly or through the datastore). +8. An action granted to **no privilege** (for example, `"read": []`) is "not set", so the permission at the level above applies. It does not mean "nobody". To deny the action, use [restricted mode](#restriction-modes) without defining that permission, or grant it to a privilege that no session receives. + +Permissions only grant access; there is no explicit deny. A dataclass or function permission can therefore narrow a broader datastore permission by replacing it. An attribute permission is additive: it grants access to that attribute only when the session also has the action on its dataclass. + +:::tip Recommended practice + +- Assign access to sessions through **roles** with `Session.setPrivileges({roles: [...]})`. Define roles around business profiles; privileges are the reusable building blocks. [Qodly Studio](https://developer.4d.com/qodly/4DQodlyPro/roles/overview) displays effective permissions by role. +- If an administration role needs full access, include every privilege in it except a lock privilege, if used. Add each new privilege to that role: a dataclass-level permission can replace a broader datastore permission. +- Review the effect of privilege changes on every role. In Qodly Studio, **Detailed Permission Review** shows a role's effective access; a role with no privileges can help you review guest-only access. + +::: + ## Privilèges et Rôles -Un **privilège** est la capacité technique d'exécuter des **actions** sur des **ressources**, tandis qu'un **rôle** est un privilège public destiné à être utilisé par un administrateur. Fondamentalement, un rôle rassemble plusieurs privilèges pour définir un profil utilisateur métier. Par exemple, "manageInvoices" pourrait être un privilège tandis que "secrétaire" pourrait être un rôle (qui inclut "manageInvoices" et d'autres privilèges). +A **privilege** grants actions on resources. A **role** groups privileges into a business profile that an administrator can assign to a session. + +For example, `manageInvoices` could be a privilege and `secretary` a role that includes it and other privileges. Assign roles to sessions with [`Session.setPrivileges({roles: [...]})`](../API/SessionClass.md#setprivileges); the role grants all its privileges. + +Privileges can be granted permission on multiple action-resource combinations, and an action can be granted to multiple privileges. + +Define privileges and roles in [`roles.json`](#rolesjson-file), then grant roles to sessions with `Session.setPrivileges()`. -Un privilège ou un rôle peut être associé à plusieurs combinaisons "action + ressource". Plusieurs privilèges peuvent être associés à une action. Un privilège peut inclure d'autres privilèges. +### Including privileges -- Vous **créez** des privilèges et/ou des rôles dans le fichier `roles.json` (voir ci-dessous). Vous **configurez** leur portée en les assignant aux actions de permission appliquées aux ressources. +A privilege can include other privileges using the `includes` property in `roles.json`. Inclusion is transitive and one-way: if A includes B, and B includes C, A receives the permissions of B and C. -- Vous **autorisez** les privilèges et/ou les rôles pour chaque session utilisateur à l'aide de la fonction [`.setPrivileges()`](../API/SessionClass.md#setprivileges) de la classe `Session`. +[`Session.getPrivileges()`](../API/SessionClass.md#getprivileges) returns the expanded collection (for example, A, B, and C) in no guaranteed order. Declare an included privilege before the privilege that includes it; otherwise, 4D drops the inclusion and logs an error. ### Exemple -Pour permettre un rôle dans une session : +This authentication function assigns the user's role to the session: ```4d @@ -176,7 +244,7 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T Session.clearPrivileges() - $result:="Your are authenticated as Guest" + $result:="You are authenticated as Guest" $user:=ds.Users.query("identifier = :1"; $identifier).first() @@ -190,47 +258,51 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T ``` +## `guest` privilege + +`guest` is built in; declaring a privilege named `Guest` is an error ("privilege already defined"). Sessions without privileges (`Session.isGuest() = True`) receive the permissions granted to `guest`. + +Permissions granted to `guest` are available to every session, regardless of its other privileges. Do not grant `guest` access that should be withheld from other sessions, and account for its permissions when restricting access at the dataclass level. + ## `roles.json` -La syntaxe du fichier `roles.json` est la suivante: Le fichier `roles.json` décrit l'ensemble des paramètres de sécurité du projet. - -| Nom de propriété | | | Type | Obligatoire | Description | -| ------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | -------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| privileges | | | Collection d'objets `privilege` | X | Liste de privilèges définis | -| | \[].privilege | | Text | | Nom de privilège | -| | \[].includes | | Collection de chaînes | | Liste de noms de privilèges inclus | -| roles | | | Collection d'objets `role` | | Liste de rôles définis | -| | \[].role | | Text | | Nom de rôle | -| | \[].privileges | | Collection de chaînes | | Liste de noms de privilèges inclus | -| permissions | | | Object | X | Liste d'actions autorisées | -| | allowed | | Collection d'objets `permission` | | Liste de permissions autorisées | -| | | \[].applyTo | Text | X | Nom de [ressource](#resources) cible | -| | | \[].type | Text | X | Type de [ressource](#ressources) : "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | -| | | \[].read | Collection de chaînes | | Liste de privilèges | -| | | \[].create | Collection de chaînes | | Liste de privilèges | -| | | \[].update | Collection de chaînes | | Liste de privilèges | -| | | \[].drop | Collection de chaînes | | Liste de privilèges | -| | | \[].execute | Collection de chaînes | | Liste de privilèges | -| | | \[].promote | Collection de chaînes | | Liste de privilèges | -| restrictedByDefault | | | Boolean | | Si true, l'accès aux ressources sans permission explicite est refusé | -| forceLogin | | | Boolean | | Si true, active le mode ["forceLogin"](../REST/authUsers.md#force-login-mode) | - -:::caution Rappel - -- Le nom de privilège "WebAdmin" est réservé à l'application. Il est déconseillé d'utiliser ce nom pour les privilèges personnalisés. -- Les noms de `privileges` et de `roles` ne sont pas sensibles à la casse. +The project's web security settings are defined in `roles.json`: + +| Propriété | Type | Obligatoire | Description | +| ------------------------------- | -------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `privilèges` | Collection of privilege objects | Oui | Defined privileges. Each object has a `privilege` name and can have an `includes` collection of privilege names. | +| `rôles` | Collection of role objects | Non | Defined roles. Each object has a `role` name and a `privileges` collection of privilege names. | +| `permissions.allowed` | Collection of permission objects | Oui | Permissions assigned to resources. | +| `permissions.allowed[].applyTo` | Text | Oui | Target [resource](#resources) name. | +| `permissions.allowed[].type` | Text | Oui | [Resource](#resources) type: `datastore`, `dataclass`, `attribute`, `method`, `singletonMethod`, or `singleton`. | +| `permissions.allowed[].read` | Collection de chaînes | Non | Privileges granted read access. | +| `permissions.allowed[].create` | Collection de chaînes | Non | Privileges granted create access. | +| `permissions.allowed[].update` | Collection de chaînes | Non | Privileges granted update access. | +| `permissions.allowed[].drop` | Collection de chaînes | Non | Privileges granted delete access. | +| `permissions.allowed[].execute` | Collection de chaînes | Non | Privileges granted execute access. | +| `permissions.allowed[].promote` | Collection de chaînes | Non | Privileges temporarily granted during function execution. | +| `restrictedByDefault` | Boolean | Non | If `true`, access to resources without explicit permissions is denied. | +| `forceLogin` | Boolean | Non | If `true`, enables [force login mode](../REST/authUsers.md#force-login-mode). | + +:::note Notes + +- The `WebAdmin` privilege name is reserved for the application; do not use it for custom privileges. +- Privilege and role names are case-insensitive. Unknown names passed to [`.setPrivileges()`](../API/SessionClass.md#setprivileges) are ignored. +- Qodly Studio can add an optional `id` property to privileges and roles to preserve references when they are renamed. +- Multiple entries with the same `applyTo` are not merged: the last entry wins without an error. Define only one entry per resource. +- A resource entry that grants no actions has no effect. ::: -### Emplacement et contenu du fichier par défaut +### Default location and content -Lorsqu'un nouveau projet est créé, un fichier `roles.json` par défaut est généré à cet emplacement : +New projects generate `roles.json` at: ``` /Project/Sources/ ``` -Voir la section [Architecture](../Project/architecture.md#sources) . +See the [Architecture](../Project/architecture.md#sources) section for details. Contenu par défaut : @@ -262,7 +334,7 @@ Contenu par défaut : :::note Compatibilité -Dans les versions précédentes, le fichier `roles.json` n'était pas créé par défaut. Depuis 4D 20 R6, lors de l'ouverture d'un projet existant qui ne contient pas de fichier `roles.json` ou les paramètres `"forceLogin" : true`, le bouton **Activer l'authentification REST via la fonction ds.authentify()** est disponible dans la page [**Fonctionnalités Web** de la boîte de dialogue Paramètres](../settings/web.md#access). Ce bouton met automatiquement à jour vos paramètres de sécurité (vous devrez peut-être modifier votre code, [voir cet article de blog](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/)). +In releases before 4D 20 R6, `roles.json` was not created by default. In 4D 20 R6 and later, opening an existing project without a `roles.json` file or `"forceLogin": true` setting makes the **Activate REST authentication through ds.authentify() function** button available on the [Web Features page of the Settings dialog box](../settings/web.md#access). This button upgrades the security settings; you may need to modify your code. Plus d'informations dans [cet article de blog](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/). ::: @@ -274,66 +346,116 @@ Dans Qodly Studio pour 4D, le mode de connexion peut être réglé en utilisant ## Modes de restriction -La propriété `restrictedByDefault` configure la manière dont chaque [ressource](#resources) est accessible lorsqu'[aucune permission spécifique n'est définie pour elle](#permissions) : +`restrictedByDefault` determines access to a [resource](#resources) when no [specific permission](#permissions) is defined: -- **Mode sans restriction** (`restrictedByDefault`: **false**) : les ressources sans permissions définies sont accessibles à toutes les requêtes. Ce mode convient aux environnements de développement où l'accès peut être progressivement restreint. -- **Mode restreint** (`restrictedByDefault` : **true**) : Les ressources qui n'ont pas de permissions définies sont bloquées par défaut. Ce mode est recommandé pour les environnements de production où l'accès doit être explicitement accordé. +- **Unrestricted mode** (`restrictedByDefault: false`): Resources without defined permissions are accessible to all requests. +- **Restricted mode** (`restrictedByDefault: true`): Resources without defined permissions are blocked. Access is granted explicitly, and the [permission inheritance rules](#inherited-permissions) still apply. :::note Compatibilité -- Lors de la **création d'un projet**, la propriété `restrictedByDefault` est mise à **false** dans le fichier *roles.json* (voir ci-dessous). Gardez à l'esprit que cette configuration est conçue pour un démarrage rapide et un développement fluide. Dans un environnement de production, [il est recommandé de définir les propriétés `restrictedByDefault` et `forceLogin` à **true**](#recommended-configuration). -- Dans les **projets convertis à partir de versions précédentes** ; lors de l'activation de l'accès à Qodly Studio en utilisant le [Dialogue de configuration en un clic](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration), la propriété `restrictedByDefault` est ajoutée avec la valeur **true** dans le fichier *roles.json*. +- New projects set `restrictedByDefault` to `false` by default; see [recommended configurations](#recommended-configuration). +- For projects converted from earlier releases, enabling access to Qodly Studio through the [One-click configuration dialog](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration) adds `restrictedByDefault: true` to `roles.json`. ::: -### Configuration recommandée {#recommended-configuration} +### Restriction strategies + +#### Lock everything and open gradually + +Choose either restricted mode or a lock privilege to close access by default: + +| | Restricted mode | Lock privilege | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| Setting | `"restrictedByDefault": true` (Qodly Studio: **Restrict Access By Default**) | `"restrictedByDefault": false`, with every action on `ds` granted to a privilege that no session receives (for example, `none`) | +| What is closed | Every resource without a permission | Every resource that inherits datastore permissions | +| How to open | Grant permissions on the datastore, dataclasses, attributes, and functions | Grant permissions on dataclasses and functions to replace the lock | +| If 4D drops an invalid entry | The resource stays closed | The resource falls back to the lock and stays closed | +| Important | Explicitly grant access to public resources, usually to `guest`, including the login function unless [force login](../REST/authUsers.md#force-login-mode) is used, and [HTTP request handlers](../WebServer/http-request-handler.md) called before login. In this mode, Qodly Studio's role review is currently incorrect. | Never assign the lock privilege to a role, including the administration role. | + +Both approaches close access by default and follow the same inheritance and replacement rules. A lock privilege makes the lock visible in the editor; restricted mode requires no extra privilege. + +#### Open everything, restrict gradually + +Set unrestricted mode (`"restrictedByDefault": false`), grant `guest` read access to `ds`, then restrict sensitive dataclasses with dataclass-level permissions. + +Remember that [guest](#guest-privilege) permissions apply to every session. Without a lock privilege, an invalid entry dropped by 4D leaves the resource open in unrestricted mode. -En fonction de votre environnement, les paramètres recommandés sont les suivants : +#### Configuration recommandée {#recommended-configuration} -- **Production** : Configurez les deux options `restrictedByDefault` et [`forceLogin`](../REST/authUsers.md#force-login-mode) à **true**. Cela garantit une sécurité maximale en exigeant l'authentification de l'utilisateur et des permissions explicitement définies pour l'accès aux ressources. -- **Développement** : Configurez les deux options `restrictedByDefault` et [`forceLogin`](../REST/authUsers.md#force-login-mode) à **false**. Cela permet un accès plus facile pendant le développement et le débogage, avec la possibilité d'appliquer progressivement des restrictions. +Use these settings as a starting point: + +- **Development**: Set both properties to `false` for easier access while developing and debugging. Apply restrictions gradually as needed. +- **Production**: Set `restrictedByDefault` and [`forceLogin`](../REST/authUsers.md#force-login-mode) to `true` so that users must authenticate and resource access must be explicitly granted. + +## Permission errors ### `Roles_Errors.json` -Le fichier `roles.json` est analysé par 4D au démarrage. Vous devez redémarrer l'application pour que les modifications dans ce fichier soient prises en compte. +4D parses `roles.json` at startup. Restart the application for changes to take effect. -En cas d'erreur(s) lors de l'analyse du fichier `roles.json`, 4D charge le projet mais désactive la protection globale d'accès - cela permet au développeur d'accéder aux fichiers et de corriger l'erreur. Un fichier d'erreur nommé `Roles_Errors.json` est généré dans le [dossier `Logs` du projet](../Project/architecture.md#logs) et décrit les lignes d'erreur. Ce fichier est automatiquement supprimé lorsque le fichier `roles.json` ne contient plus d'erreur. +If parsing fails, 4D writes the errors to `Roles_Errors.json` in the project's [`Logs` folder](../Project/architecture.md#logs). It deletes this file after `roles.json` is corrected. -Il est recommandé de vérifier au démarrage si un fichier `Roles_Errors.json` existe dans le dossier [Logs](.. Project/architecture.md#logs), ce qui signifie qu'il y a eu une erreur d'analyse et que les accès ne seront pas limités. Vous pouvez écrire par exemple : +Check at startup, especially in production, whether `Roles_Errors.json` exists. Its presence indicates a parsing error, and permissions may not be enforced as intended. Vous pouvez écrire par exemple : ```4d title="/Sources/DatabaseMethods/onStartup.4dm" If (Not(File("/LOGS/"+"Roles_Errors.json").exists)) -… -Else // vous pouvez empêcher l'ouverture du projet +... +Else // you can prevent the project to open ALERT("The roles.json file is malformed or contains inconsistencies, the application will quit.") QUIT 4D End if ``` -## Exemple de configuration de privilèges +Permission errors are returned as follows: -```json title="/Project/Sources/roles.json" +| Chemin | read / create / update / drop refused | execute refused | +| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | +| REST | HTTP 401 with message | **HTTP 500** with message (singleton: "Bad permission...") | +| Code (web session) | Read: error 1557 (dataclass) or 1607 (attribute). Create: error 1608 when assigning an attribute to a new entity if create is restricted by a permission; in restricted mode without permission, `save()` returns `success: false` and `statusText: "Permission Error"`. Update/drop: error 1557 when loading the entity (both require read). | Error 1561 | + +## Exemple +This example grants a broad set of permissions through a `manager` privilege, while the `payroll` privilege grants read access to the sensitive `Salaries` dataclass. + +```json title="roles.json" { - "forceLogin": true, - "restrictedByDefault": true, - "permissions": { - "allowed": [ - { - "applyTo": "People", - "type": "dataclass", - "read": [ - "viewPeople" - ] - } - ] - }, - "privileges": [ - { - "privilege": "viewPeople", - "includes": [] - } - ], - "roles": [] + "forceLogin": true, + "restrictedByDefault": true, + "privileges": [ + {"privilege": "payroll", "includes": []}, + {"privilege": "manager", "includes": []} + ], + "roles": [ + {"role": "administrator", "privileges": ["manager", "payroll"]} + ], + "permissions": { + "allowed": [ + { + "applyTo": "ds", + "type": "datastore", + "read": ["manager"], + "create": ["manager"], + "update": ["manager"], + "drop": ["manager"], + "execute": ["manager"] + }, + { + "applyTo": "Salaries", + "type": "dataclass", + "read": ["payroll"] + } + ] + } } + ``` + +Here are the resulting rules: + +| Session | Read Salaries | Create Salaries | Update/drop Salaries | Read other dataclasses | +| -------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------- | +| `manager` | Refused (the `Salaries` read permission replaces the datastore permission) | Allowed (inherited from the datastore) | Refused (read is required) | Allowed | +| `payroll` | Allowed | Refused (the datastore permission is granted only to `manager`) | Refused | Refused | +| `administrator` role | Allowed | Allowed | Allowed | Allowed | + +The `Salaries` read permission replaces the datastore read permission, so `manager` alone cannot read that dataclass. The `administrator` role receives the combined permissions of `manager` and `payroll`. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md index f08dc3ec40ae67..d77bb0a533bb79 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md @@ -39,7 +39,7 @@ Pour récupérer le nom de la classe associée lors de l'exécution, utilisez la If you assign `4D.Vector` as the class of an Object type field, you define a **vector field**. Such fields store embessings and can be used to query data using AI features. See the [`4D.Vector` class](../API/VectorClass.md) documentation to see how to query with vectors. -Note that the [**4D Embedding Studio** component](corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. +Note that the [**4D Embedding Studio** component](https://corner.4d.com/component/4d-embedding-studio) can help you configuring and updating your 4D.Vector fields. When you assign `4D.Vector` as the class of an Object type field, a specific icon is displayed as field type in the Structure editor: ![](../assets/en/Develop/ai-icon.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md index 8224303ce891d7..dfc44bf0faa3ca 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md @@ -280,11 +280,8 @@ When you create a primary key in a table that already contains records (using an To remove a primary key from a table: -1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu: - -[picture here] - -A confirmation dialog box appears. Click **OK** to remove the primary key. +1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu. + A confirmation dialog box appears. Click **OK** to remove the primary key. #### Default primary key field diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md index 7c3e93bf6673e3..c033f9f0490b41 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md @@ -90,9 +90,9 @@ Les variables ou expressions peuvent être saisissables ou non saisissables et p #### Grammaire JSON -| Nom | Type de données | Valeurs possibles | -| ---------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | texte, ou tableau de textes |
  • variable, nom de champ, ou toute expression 4D.
  • Chaîne vide pour [variables dynamiques](#dynamic-variables).
  • Tableau de chaînes (collection de noms de tableau) pour une [colonne de listbox hiérarchique](listbox_overview.md#hierarchical-list-boxes)
    • | +| Nom | Type de données | Valeurs possibles | +| ---------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | texte, ou tableau de textes |
  • Variable, nom de champ, ou toute expression 4D.
  • Chaîne vide pour les [variables dynamiques](#dynamic-variables).
  • Tableau de textes (collection de noms de tableaux) pour une colonne de [listbox hiérarchique](listbox_overview.md#hierarchical-list-boxes)]
    • | ### Expressions @@ -178,7 +178,7 @@ Saisissez une expression qui renvoie une collection ou une entity selection. En La collection ou l'entity selection doit être disponible pour le formulaire lors de son chargement. Chaque élément de la collection ou de chaque entité de l'entity selection sera associé(e) à une ligne de list box et sera disponible en tant qu'objet via le mot-clé [`This`](../Concepts/classes.md#this) : - si vous avez utilisé une collection d'objets, vous pouvez appeler **This** dans l'expression datasource pour accéder à chaque valeur de propriété, par exemple `This.`. -- si vous avez utilisé une entity selection, vous pouvez appeler **This** dans l'expression detasource pour accéder à chaque valeur d'attribut, par exemple `This.`. +- si vous avez utilisé une entity selection, vous pouvez appeler **This** dans l'expression datasource pour accéder à chaque valeur d'attribut, par exemple `This.`. > Si vous avez utilisé une collection de valeurs scalaires (et non des objets), 4D vous permet d'afficher chaque valeur en appelant **This.value** dans l'expression datasource. Cependant, dans ce cas, vous ne pourrez pas modifier les valeurs ou accéder à l'objet courant (voir ci-dessous). diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/CollectionClass.md index 0f0beb31d4fb8c..d45fdec7eabbfd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/CollectionClass.md @@ -376,7 +376,7 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] #### 例題 1 -通常の (非共有の) コレクション *$lastnames \* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames\*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -398,7 +398,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と\*$sharedColl2\* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と *$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/DataClassClass.md index e65ca78f9e2de8..82e969df01b16f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/DataClassClass.md @@ -483,7 +483,7 @@ $ds.Persons.clearRemoteCache() :::info -*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません）。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 +*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません)。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/DataStoreClass.md index 10b2390af98d77..f2e1e089932d9c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/DataStoreClass.md @@ -938,7 +938,7 @@ var $clients:=ds.listOAuthGrants().query("userName = :1"; "jsmith").extract("cli 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: -- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 .4Dindx ファイル) で暗号化されます。 +- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 - 暗号化可能テーブルから読み出したすべてのデータは、メモリ内で復号化されます。 **戻り値** diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/EmailObjectClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/EmailObjectClass.md index 7e055ae1d93fde..9405930a399a0b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/EmailObjectClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/EmailObjectClass.md @@ -5,8 +5,7 @@ title: Email 4Dにおけるメールの作成・送信・受信は `Email` オブジェクトの操作よっておこなわれます。 -*transporter* クラス関数を使ってメールを取得する際に、 -`Email` オブジェクトが作成されます。 +*transporter* クラス関数を使ってメールを取得する際に、`Email` オブジェクトが作成されます。 - IMAP - [`.getMail()`](IMAPTransporterClass.md#getmail) および [`.getMails()`](IMAPTransporterClass.md#getmails) 関数は IMAPサーバーからメールを受信します。 - POP3 - [`.getMail()`](POP3TransporterClass.md#getmail) 関数は POP3サーバーからメールを受信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md index c017b8ae6dafee..96568cf6c36824 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntityClass.md @@ -530,7 +530,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: - オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換) 参照)、それ以外の場合にはその属性は更新されません。 - プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -907,9 +907,9 @@ $info:=$address.getRemoteContextAttributes()
    -| 引数 | 型 | | 説明 | -| --- | ------- | :-------------------------: | ------------------------------------------------------ | -| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。 それ以外は false。それ以外は false。 | +| 引数 | 型 | | 説明 | +| --- | ------- | :-------------------------: | ----------------------------------------- | +| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。それ以外は false。 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntitySelectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntitySelectionClass.md index 4f3de0ca16a700..e804a98ef8cee7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/EntitySelectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/EntitySelectionClass.md @@ -2046,9 +2046,9 @@ pathObjects コレクションには必要な数だけオブジェクトを追 | ranges[].start | Integer | レンジ内の先頭エンティティのインデックス (位置) | | ranges[].end | Integer | レンジ内の最終エンティティのインデックス (位置) | -`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。 インデックスは 0 起点です。インデックスは 0 起点です。 +`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。インデックスは 0 起点です。 -元のエンティティセレクションと *entitySelection* の両方が空であった場合、空のエンティティセレクションが返されます。 元のエンティティセレクションが空であった場合、*entitySelection* への参照、あるいは *entity* のみを格納したエンティティセレクションが返されます。 +呼び出し対象のエンティティセレクション、または *selectedEntities* のエンティティセレクションが空の場合、関数は `ranges` に空のコレクションを返します。 #### 例題 @@ -2091,7 +2091,7 @@ $result2:=$invoices.selected($creditSel) | 引数 | 型 | | 説明 | | --------- | ---------------------------------- | :-------------------------: | ---------------------------------------------------------- | -| startFrom | Integer | -> | 処理を開始するインデックス) | +| startFrom | Integer | -> | 処理を開始するインデックス | | end | Integer | -> | 終了インデックス (含まれない) | | 戻り値 | 4D.EntitySelection | <- | 抜粋エンティティを格納した新しいエンティティセレクション (シャロウ・コピー) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPAgentClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPAgentClass.md index 421e7dc69222a1..0c2acba006e0c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPAgentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPAgentClass.md @@ -78,7 +78,7 @@ HTTPAgent のオプションは [HTTPRequest のオプション](HTTPRequestClas | プロパティ | 型 | デフォルト | 説明 | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) "storeCertificateName" によって上書き可能(下記参照) | +| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) | | keepAlive | Boolean | true | 当該エージェントについて keep-alive を有効にします | | maxSockets | Integer | 65535 | サーバーあたりの最大ソケット数 | | maxTotalSockets | Integer | 65535 | エージェントの最大ソケット数 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPRequestClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPRequestClass.md index a8e26576653baf..b07cd437c2b688 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPRequestClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/HTTPRequestClass.md @@ -13,7 +13,7 @@ title: HTTPRequest -`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 +`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 ### 非同期プログラミング @@ -197,7 +197,7 @@ macOS では、新しいアプリケーション(新しい [UUID](./FileClass.md | プロパティ | 型 | 説明 | | --------------------- | ---- | ------------------------------------------------------------------------------------- | -| .data | blob | 取得データ。取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | +| .data | blob | 取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | | .type | text | イベントの種類。取り得る値: "response", "error", "headers", "data", または "terminate | #### authentication オブジェクト @@ -311,9 +311,9 @@ authentication オブジェクトは `options.serverAuthentication` または `o
    履歴 -| リリース | 内容 | -| ----- | ----------------------------------------------------------------------- | -| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 `.rawHeaders` プロパティの追加 | +| リリース | 内容 | +| ----- | ------------------------------------------------ | +| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/IMAPTransporterClass.md index f1bcae74518a81..2f89762aeaa556 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/IMAPTransporterClass.md @@ -1129,12 +1129,12 @@ ID = 1のメッセージを取得します:
    -| 引数 | 型 | | 説明 | -| ---------- | ------- | :-------------------------: | --------------------------------------------------------------------------------------- | -| msgNumber | Integer | -> | メッセージのシーケンス番号 | -| msgID | Text | -> | メッセージの固有ID | -| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 false 時にはメッセージの状態は変化しません。 | -| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB | +| 引数 | 型 | | 説明 | +| ---------- | ------- | :-------------------------: | ------------------------------------------------------------- | +| msgNumber | Integer | -> | メッセージのシーケンス番号 | +| msgID | Text | -> | メッセージの固有ID | +| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 | +| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB |
    @@ -1656,13 +1656,11 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" - **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。複数指定する場合にはスペースで区切ります。例: `searchCriteria = KEYWORD \Flagged \Draft` -- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    +- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md index b30429e9518ac2..966b86e3f90370 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/IncomingMessageClass.md @@ -255,7 +255,7 @@ $value := $request.getHeader("content-type") `.headers` プロパティは、読み出し専用です。 -ヘッダー名(キー)は全て小文字となっています。ヘッダー名は全て大文字・小文字は区別されます。 +ヘッダー名(キー)は全て小文字となっています。ヘッダー名では大文字と小文字が区別されることに注意してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/MailAttachmentClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/MailAttachmentClass.md index abecd7ff0205b9..c78d14bff47244 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/MailAttachmentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/MailAttachmentClass.md @@ -75,7 +75,7 @@ Attachment オブジェクトは、次の読み取り専用プロパティや、 #### 説明 -`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。 二つの値が利用可能です: 二つの値が利用可能です: +`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。二つの値が利用可能です: - "inline": 添付ファイルはメッセージコンテンツ内に、"cid"の場所にレンダリングされます。レンダリングの結果はメールクライアントによって異なります。 - "attachment": 添付ファイルはメッセージ内でリンクとして提供されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/MethodClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/MethodClass.md index 9f03f77f4ca4a2..32528380c7f948 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/MethodClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/MethodClass.md @@ -124,7 +124,7 @@ End if `4D.Method.new()` 関数は、 *source* 引数のコードからビルドされた新しい `4D.Method` 型のオブジェクトを作成して返します。 -*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシークエンス](../Concepts/quick-tour.md#エスケープシークエンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 +*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシーケンス](../Concepts/quick-tour.md#エスケープシーケンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 オプションの *name* 引数には、4D デバッガーあるいはランタイムエクスプローラーに表示されるメソッドの名前を渡します。この引数を省略した場合、メソッド名は、 "anonymous" として表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md index 3a1d979fedf3a9..4a4227bdc46a1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/POP3TransporterClass.md @@ -202,7 +202,7 @@ POP3 Transporter オブジェクトは [POP3 New transporter](../commands/pop3-n | 引数 | 型 | | 説明 | | ---------- | ------- | :-------------------------: | ------------------------------------------------------------ | | msgNumber | Integer | -> | リスト中のメッセージの番号 | -| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false） | +| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false) | | 戻り値 | Object | <- | [Email オブジェクト](EmailObjectClass.md#email-オブジェクト) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md index 16436167a27e98..00b62f4139b453 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md @@ -394,7 +394,7 @@ Session.quotas.nbEntitySets:=50 #### 説明 -`.outBytesPerMin` プロパティにはWeb サーバーが1分間に送信できる最大バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 +`.outBytesPerMin` プロパティには Web サーバーが 1分間に送信できる最大バイト数が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 スコープ: [サーバーグローバルレベル](./WebServerClass.md#スコープレベル) @@ -408,8 +408,7 @@ Session.quotas.nbEntitySets:=50 #### 説明 -`.outBytesPerMinPerSession` プロパティにはWeb サーバーがセッションに対して -1分間に送信できる最大の総バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 +`.outBytesPerMinPerSession` プロパティにはWeb サーバーがセッションに対して 1分間に送信できる最大の総バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 スコープ: [セッションデフォルトレベル](./WebServerClass.md#スコープレベル) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md index e78e77632f3a30..e505b7c7c7f202 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -18,7 +18,7 @@ Session オブジェクトは [`Session`](../commands/session) コマンドに このクラスは以下の種類のセッションをサポートしています: -- [**Web user sessions**](../WebServer/sessions.md): Web user sessions are available when [scalable sessions are enabled in your project](../WebServer/sessions.md#enabling-web-sessions). They are used for Web connections (including REST access and [MCP server](../WebServer/mcp-server.md) access), and are controlled by assigned [privileges](../ORDA/privileges.md). +- [**Webユーザーセッション**](../WebServer/sessions.md): [プロジェクトにおいてスケーラブルセッションが有効化されている](../WebServer/sessions.md#webセッションの有効化) 場合、Webユーザーセッションが利用可能です。 They are used for Web connections (including REST access and [MCP server](../WebServer/mcp-server.md) access), and are controlled by assigned [privileges](../ORDA/privileges.md). - [**リモートユーザー セッション**](../Desktop/sessions.md#リモートユーザーセッション): クライアント/サーバーアプリケーションでは、リモートユーザーは、クライアントおよびサーバーから管理される独自のセッションを持ちます。 - [**ストアドプロシージャーセッション**](../Desktop/sessions.md#ストアドプロシージャーセッション): サーバー上で実行される全てのストアドプロシージャーセッションの仮想ユーザーセッション。 - [**スタンドアロンセッション**](../Desktop/sessions.md#standalone-sessions): シングルユーザーアプリケーションで返されるローカルのセッションオブジェクト(クライアント/サーバーアプリケーションの開発およびテストフェーズにおいて有用です)。 @@ -83,7 +83,7 @@ Session オブジェクトは [`Session`](../commands/session) コマンドに :::note 注記 - 権限は、この関数が実行された[セッションの種類](#セッションの種類) に関わらず、Web アクセスを通して実行されたコードにのみ適用されるという点に注意してください。 -- この関数は [roles.json](../ORDA/privileges.md#rolesjsonファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 +- この関数は [roles.json](../ORDA/privileges.md#rolesjson-ファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 - セキュリティ上の理由から、この関数はリモートユーザーセッションのクライアント側から呼び出すことはできません(エラーが返されます)。 ::: @@ -529,7 +529,7 @@ End if | hostType | Text | ホストのタイプ: "windows"、"mac"、あるいは "browser" | | creationDateTime | 日付 (ISO 8601) | セッション作成の日時(スタンドアロンセッション: アプリケーションのスタートアップの日時) | | state | Text | セッションの状態: "active", "postponed", "sleeping" | -| ID | Text | セッションUUID ([`.id`](#id) と同じ値)) | +| ID | Text | セッションUUID ([`.id`](#id) と同じ値) | | persistentID | Text | リモート/クライアントセッション: セッションの永続的なID | | unreachableSince | Integer | リモートセッション: ピアが到達不能になってから経過した秒数。 4D Server 上では、この属性は[`Process activity.sessions`](../commands/process-activity) プロパティ内から読み出し可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/API/SystemWorkerClass.md b/i18n/ja/docusaurus-plugin-content-docs/current/API/SystemWorkerClass.md index c924b3a83fecaf..11683c6e0d1e58 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/API/SystemWorkerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/API/SystemWorkerClass.md @@ -3,7 +3,7 @@ id: SystemWorkerClass title: SystemWorker --- -システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 +システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 `SystemWorker` クラスは、`4D` クラスストアにて提供されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/about.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/about.md index 96236d111fcf81..86efb2a3370abf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/about.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/about.md @@ -1,9 +1,9 @@ --- id: about -title: 4Dは独自のプログラミング言語を持っています。 +title: 4D ランゲージについて --- -1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: +4Dは独自のプログラミング言語を持っています。1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: - クエリや並べ替えなどのレコード管理エディターにプログラムでアクセスする - データベースの情報をもとに複雑なレポートやラベルを作成・印刷する @@ -17,9 +17,9 @@ title: 4Dは独自のプログラミング言語を持っています。 ## 4D ランゲージとは -4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。 このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 +4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 -4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。 言葉を交わすために言語のすべてを知る必要がないのと同じです。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 +4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 ## なぜランゲージを使用するのか @@ -42,7 +42,7 @@ title: 4Dは独自のプログラミング言語を持っています。 4D ランゲージのコマンドを使用して標準のレコード管理エディターにアクセスできます。たとえば、デザインモードにおいて「クエリ」ツールバーボタンを使って開けるクエリエディターは、`QUERY` コマンドを使用することでも表示されます。さらに、QUERY コマンドを使用すれば、エディターを開かなくても指定したデータを検索できるのです。たとえば `QUERY ([People];[People]Last Name="Smith")` と記述すると、データベースから "Smith" という名前の人物をすべて検索します。 -ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 +4D ランゲージはとてもパワフルです。ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 4D ランゲージは、ほとんどのタスクを簡単に実行できるようデザインされています。レコードの追加、並べ替え、データの検索などの操作がシンプルなコマンドで提供されています。さらにコマンドを使用してシリアルポートのコントロール、ディスク上のドキュメントの読み込み、高度なトランザクション処理等を行うこともできるのです。 @@ -56,6 +56,6 @@ title: 4Dは独自のプログラミング言語を持っています。 従来の言語を使用して開発を行う場合、まず念入りに計画を立てる必要があります。実際、計画の立案は開発の重要な工程の1つです。 4D においては、プロジェクトのあらゆる部分でいつでもランゲージを使いはじめることができます。たとえば、初めにフォームにメソッドを追加し、いくつかのメソッドをあとから追加することができます。アプリケーションがより高度になったら、メニューから実行するプロジェクトメソッドを追加することもできます。 4D ランゲージは好きなだけ利用することができます。他の多くのデータベースのような "すべてか無か" ではありません。 -従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。 作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 +従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 従来の言語は、コマンドの記述方法を制限するなどして、融通性に欠けることが多いのに対し、 4D ランゲージは伝統に縛られることなく進化していきます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/arrays.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/arrays.md index f7776999dbd998..06e67dfacdd1a9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/arrays.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/arrays.md @@ -3,7 +3,7 @@ id: arrays title: 配列 --- -**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 +**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 :::tip @@ -35,7 +35,7 @@ ARRAY INTEGER(aiAnArray;0) ## 配列要素への値の代入 -配列中の要素は中カッコ ({… }) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: +配列中の要素は中カッコ ({…}) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: ```4d ARRAY TEXT(atNames;5) @@ -97,7 +97,7 @@ atNames{$vlElem} というシンタックスに注目してください。 atNam 上のコードで作成した atTopics 配列について、次のことが言えます: - atTopics は、2次元配列です。 -- atTopics{8}{5} は、 8行5列目の要素です。 8行5列目の要素です。 +- atTopics{8}{5} は、 8行5列目の要素です。 - atTopics{20} は 20行目を指し、それ自体が 1次元の配列です。 - `Size of array(atTopics)` は、行数の 100を返します。 - `Size of array(atTopics{17})` は、17行目の列数である50を返します。 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 e0d92f48e4db75..3aa3f93ec0896c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/classes.md @@ -160,7 +160,7 @@ Class オブジェクトそのものは [共有オブジェクト](shared.md) クラス関数とは、当該クラスのプロパティです。クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use) なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 クライアント/サーバーアプリケーションのコンテキストにおいては、 `local` または `server` キーワードを使用することで、どちらのマシン上で関数を実行すべきかを指定することができます。これらのキーワードはORDA データモデル関数と共有シングルトン/セッションシングルトン関数でのみ使用することができます。詳細については、後述の [local および server 関数](#local-および-server) の項目を参照ください。 @@ -312,11 +312,11 @@ Function getRectArea($width : Integer; $height : Integer) : Integer `shared` キーワードを使うと**共有クラス** が作成されます。共有クラスは、共有オブジェクトのインスタンス化にのみ使われます。詳細については、後述の [共有クラス](#共有クラス) の項目を参照ください。 -`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 +`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 :::note -[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-class) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 +[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-クラス) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 ::: @@ -388,7 +388,7 @@ $o:=cs.MyClass.new("John";42) :::info -`property` キーワードは、クラス関数内の `Function` および `Class constructor` ブロック外でのみ使用できます。 +`property` キーワードは、クラス関数において `Function` および `Class constructor` ブロック外でのみ使用できます。 ::: @@ -422,7 +422,7 @@ property fuzzy // バリアント :::note -宣言と同時に色かするプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: +宣言と同時に初期化するプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: ```4d // 共有クラス内 @@ -889,7 +889,7 @@ $val:=$o.f() //8 共有クラスは **共有関数** をサポートしています。共有関数は、[`Use...End use`](shared.md#useend-use) 構文なしで呼び出すことができます。 -クラスが共有クラスかどうかは、Classオブジェクトの .[`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 +クラスが共有クラスかどうかは、Classオブジェクトの [`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 :::info @@ -921,7 +921,7 @@ cs.Person.isShared // true 共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 -共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します 。例: +共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。例: ```4d //共有クラス Foo @@ -987,9 +987,9 @@ shared Function Bar($value : Integer) シングルトンを引数付きでインスタンス化する必要がある場合には、[`new()`](../API/ClassClass.md#new) 関数を呼び出すこともできます。この場合、アプリケーションの起動時に実行されるコードでシングルトンをインスタンス化することが推奨されます。 -クラスがシングルトンクラスかどうかは、Classオブジェクトの .[`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 +クラスがシングルトンクラスかどうかは、Classオブジェクトの [`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 -クラスがセッションシングルトンかどうかは、Classオブジェクトの .[`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 +クラスがセッションシングルトンかどうかは、Classオブジェクトの [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 ### 公開されたシングルトン関数 @@ -1094,7 +1094,7 @@ $myList := cs.ItemInventory.me.itemList ## `local` および `server` -[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) におていは、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 +[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) においては、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 シンタックスは次の通りです: @@ -1176,7 +1176,7 @@ End if ::: -`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) ストリーム可能でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 +`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 この機能は、特に[リモートユーザーセッション](../Desktop/sessions.md#リモートユーザーセッション) のコンテキストにおいて有用で、これを使用することでビジネスロジックを[セッションシングルトン](../Concepts/classes.md#session-singleton) に実装することでセッションの全てのプロセス間でこれを共有することができ、結果として[`Session`](../commands/session) コマンドの機能を拡張することが可能になります。この場合、全てのセッション情報がサーバーに集められる様に、関連するビジネスロジックが**サーバー上で**実行されるようにしたい場合があるかもしれません。 @@ -1191,7 +1191,7 @@ End if - シングルトン *S1* はクライアント上でインスタンス化されます(名前は *s1* ) - *s1.function()* はクライアント上で実行されます。 -その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタン上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 +その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタンス上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/components.md index 038574b53c76d9..5fc0c66422018e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/components.md @@ -3,7 +3,7 @@ id: components title: コンポーネント --- -4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 +4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルを表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 ## コンポーネントのインストール diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/data-types.md index 85cf87224117e2..287288ccd1a4a8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/data-types.md @@ -7,25 +7,25 @@ title: データタイプの概要 この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: -| データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | -| ----------------------------------------------------- | -------------------------- | -------- | ------------------------ | ----------------------- | -| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | -| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | -| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | -| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | -| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | -| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | -| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | -| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | -| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | -| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | -| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | -| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | -| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | -| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | -| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | +| データタイプ | データベース (1) | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | +| ----------------------------------------------------- | ----------------------------- | -------- | ------------------------ | ----------------------- | +| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | +| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | +| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | +| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | +| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | +| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | +| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | +| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | +| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | +| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | +| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | +| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | +| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | +| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | +| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | (1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 @@ -38,7 +38,7 @@ title: データタイプの概要 以下のコマンドを使用することで、フィールドや変数の型を調べることができます: - フィールドやスカラー変数に対しては、[`Type`](../commands/type) コマンド -- 式対しては、[`Value type`](../commands/value-type) コマンド +- 式に対しては、[`Value type`](../commands/value-type) コマンド ## デフォルト値 @@ -63,7 +63,7 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的 な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 @@ -75,9 +75,9 @@ Object型、Collection型、Pointer型、Picture型の変数は、デフォル | -------------------------- | -------- | ----- | ------ | ------ | ------ | | 文字列 (1) | | `Num` | `Date` | `Time` | `Bool` | | 数値 (2) | `String` | | | | `Bool` | -| Date | `String` | | | | `Bool` | -| Time | `String` | | | | `Bool` | -| Boolean | | `Num` | | | | +| 日付 | `String` | | | | `Bool` | +| 時間 | `String` | | | | `Bool` | +| ブール | | `Num` | | | | (1) JSON形式の文字列は `JSON Parse` コマンドを使ってスカラーデータ、オブジェクト、あるいはコレクションに変換することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_blob.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_blob.md index 9c3f9b36ab6164..f5c1e4961a9587 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_blob.md @@ -140,7 +140,7 @@ $type:= OB Instance of($myObject.blob; 4D.Blob) // true // 4D.Blob から スカラーBLOB への変換 $myBlob:= $myObject.blob -$type:= +$type:= Value type($myBlob) // Blob ``` > `4D.Blob` をスカラーBLOB に変換する際に、`4D.Blob` のサイズがスカラーBLOB の最大サイズを超える場合、結果のスカラーBLOB は空になります。たとえば、スカラーBLOB の最大サイズが 2GB の場合、2.5GB の `4D.Blob` をスカラーBLOB に変換すると、空の BLOB が得られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_boolean.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_boolean.md index a43fa87dd4188d..1db75d8479b445 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_boolean.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_boolean.md @@ -58,7 +58,7 @@ myBoolean:=(myButton=1) | false | true | true | | false | false | false | -**Tip:** 式1と式2の排他的結合子演算を実行する必要がある場合、次の評価式を使用します: +**Tip:** 式1と式2の排他的論理和を実行する必要がある場合、次の評価式を使用します: ```4d (Expr1|Expr2) & Not(Expr1 & Expr2) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md index 78edeeb2a3d3e3..81641dbb6f281d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_collection.md @@ -29,7 +29,7 @@ collectionRef[expression] $myVar:=myCol[0] ``` -コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます: +コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられます: ```4d var myCol : Collection @@ -105,14 +105,14 @@ $users:=[{name: "Alice"; \ 二種類のコレクションを作成することができます: -- [`New collection`](../../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared collection`](../../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 +- [`New collection`](../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared collection`](../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例' `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例: `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -233,7 +233,7 @@ var $c3:=$c1 // 同じインスタンスへの参照 :::note -Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md##blob-の自動変換) され、またその逆も然りです。 +Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md#blob-の自動変換) され、またその逆も然りです。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_date.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_date.md index f2a035f22c1012..0ea510888eaa2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_date.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_date.md @@ -11,7 +11,7 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付リテラル -日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) 下記に、日付定数の例を示します: +日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) を使って記述します。下記に、日付定数の例を示します: ```4d !1976-01-01! @@ -30,23 +30,23 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付演算子 -| 演算 | シンタックス | 戻り値 | 式 | 値 | -| ----- | ------------------------------------- | ------- | --------------------------- | ------------ | -| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | -| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | -| 日付の減算 | Date – Number | Date | !2017-01-20! !2017-01-20! | !2017-01-11! | -| 等しい | Date = Date | Boolean | !2017-01-20! = !2017-01-01! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 異なる | Date # Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 大きい | Date > Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 小さい | Date < Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 以上 | Date >= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-01!>=!2017-01-20! | false | -| 以下 | Date <= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | +| 演算 | シンタックス | 戻り値 | 式 | 値 | +| ----- | ------------------------------------- | ------- | ----------------------------------------------------- | ------------ | +| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | +| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | +| 日付の減算 | Date – Number | Date | !2017-01-20! - 9 | !2017-01-11! | +| 等しい | Date = Date | Boolean | !2017-01-20! =!2017-01-20! | true | +| | | | !2017-01-20! = !2017-01-01! | false | +| 異なる | Date # Date | Boolean | !2017-01-20! # !2017-01-01! | true | +| | | | !2017-01-20! # !2017-01-20! | false | +| 大きい | Date > Date | Boolean | !2017-01-20! > !2017-01-01! | true | +| | | | !2017-01-20! > !2017-01-20! | false | +| 小さい | Date < Date | Boolean | !2017-01-20! < !2017-01-20! | true | +| | | | !2017-01-20! < !2017-01-20! | false | +| 以上 | Date >= Date | Boolean | !2017-01-20! >=!2017-01-01! | true | +| | | | !2017-01-01!>=!2017-01-20! | false | +| 以下 | Date <= Date | Boolean | !2017-01-20! <= !2017-01-20! | true | +| | | | !2017-01-20! <= !2017-01-01! | false | ## JavaScriptからの日付の変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_null_undefined.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_null_undefined.md index 00cb15c3e76501..cea54a9eeece33 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_null_undefined.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_null_undefined.md @@ -23,7 +23,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ フィールドは、未定義にはできません (フィールドの場合、`Undefined` コマンドは常に False を返します)。 -未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。 ただし以下の場合には生成されません: +未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。ただし以下の場合には生成されません: - 未定義の値を(配列を除く)変数に代入することは、変数に対して[`CLEAR VARIABLE`](../commands/clear-variable) を呼び出すのと同じ効果があります: @@ -41,7 +41,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ - ブール: False - 文字列: "" - 数値: 0 - - 日付: 日付: 日付: 日付: 日付: 日付: "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" + - 日付: !00-00-00! "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" - 時間: 0 (ミリ秒単位) - 未定義、Null: 変化なし @@ -51,7 +51,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ $o.a:=$o.b //$o.a=0 ``` -- 未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +- 未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 - 未定義の値を引数としてプロジェクトメソッドに渡した場合、宣言された引数の型に応じて、0 あるいは "" (空の文字列) へと自動変換されます。 @@ -97,7 +97,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ | | Null `#` Undefined | Boolean | a.nullProp `#` b.undefinedProp | false | | | Null `#` *scalar value* | Boolean | a.nullProp `#` 42 | true | -*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でもnull でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: +*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でも null でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: ```4d var $object : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_number.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_number.md index c5b5eb5fb1e708..d41770f6dc818a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_number.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_number.md @@ -71,7 +71,7 @@ title: Number (実数、整数) - 10 % 2は、0を返します。 10 は 2 で割り切れるからです。 - 10 % 3は、1を返します。 余りが 1 だからです。 -- 10.5 % 2は、0を返します。 余りが整数ではない (0.25) からです。 +- 10.5 % 2は、0を返します。 余りが整数ではない (0.5) からです。 :::warning @@ -85,7 +85,7 @@ title: Number (実数、整数) ### 実数の比較 -2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 +2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細に関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_object.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_object.md index 539c6959bafc90..5355381c4edb89 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_object.md @@ -9,16 +9,16 @@ title: Object - プロパティ値は以下のどれかの型で表現されます: - 数値 (実数、整数、等) - - text + - テキスト - null - - boolean + - ブール - ポインター (`JSON Stringify` コマンドの使用、またはコピーの際に評価されます) - 日付 (日付型あるいは ISO日付フォーマット文字列) - オブジェクト(1) (オブジェクトは入れ子にすることができます) - ピクチャー(2) - - collection + - コレクション -(1) [\*\* ストリーム不可能なオブジェクト\*\*](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 +(1) [**ストリーム不可能なオブジェクト**](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 (2) デバッガー内でテキストとして表示したり、JSON へと書き出されたりした場合、ピクチャー型のオブジェクトプロパティは "[object Picture]" と表されます。 @@ -53,7 +53,7 @@ title: Object ### `New object` コマンド -[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規コレクションを作成し、その参照を返します。 +[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規オブジェクトを作成し、その参照を返します。 例: @@ -110,12 +110,12 @@ $col:=$o.col[5] // 6 二種類のオブジェクトを作成することができます: -- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) コレクション。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有コレクション。共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 +- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) オブジェクト。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有オブジェクト。共有オブジェクトはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例' `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例: `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -213,7 +213,7 @@ ASSERT($o1=$o2) // True ### Null 値 -オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。 例: +オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。例: ```4d myObject.address.zip:=Null @@ -224,7 +224,7 @@ ASSERT($o1=$o2) // True ### 未定義の値 -オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 詳細については [Null と 未定義](dt_null_undefined.md) を参照ください。 @@ -305,7 +305,7 @@ $doc:=Null // $docが占有するリソースを解放します しかしながら、オブジェクトのテキストストリーミングには、以下の様な制約があります: -- 循環参照(自分自身をプロパティとして格納してるオブジェクト)はサポートされおらず、エラーを返します +- 循環参照 (自分自身をプロパティとして格納してるオブジェクト) はサポートされておらず、エラーを返します - クラスのオブジェクトは文字列化した際にどのクラスであるかという情報は失われます - [Entity](../API/EntityClass.md) などのネイティブな4D クラスオブジェクトはJSON として表現はできず、"[object \]" と返されます。例: "[object Entity]" diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_picture.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_picture.md index d401064c25c817..c4e4dfa184132b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_picture.md @@ -32,8 +32,8 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを | -------- | ------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 水平連結 | Pict1 + Pict2 | Picture | Pict1 の右側に Pict2 を追加します | | 垂直連結 | Pict1 / Pict2 | Picture | Pict1 の下側に Pict2 を追加します | -| 排他的論理和 | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | -| 包括的論理和 | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | +| 排他的重ね合わせ | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | +| 包括的重ね合わせ | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | | 水平移動 | Picture + Number | Picture | 指定ピクセル分、ピクチャーを横に移動します。 | | 垂直移動 | Picture / Number | Picture | 指定ピクセル分、ピクチャーを縦に移動します。 | | リサイズ | Picture \* Number | Picture | 割合によってピクチャーをサイズ変更します。 | @@ -70,7 +70,7 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを ![](../assets/en/Concepts/concatVer.en.png) ![](../assets/en/Concepts/concatVer2.en.png) -排他的論理和 +排他的重ね合わせ ```4d Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 @@ -78,7 +78,7 @@ Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 ![](../assets/en/Concepts/superimpoExc.fr.png) -包括的論理和 +包括的重ね合わせ ```4d Pict3:=Pict1|Pict2 // 同じサイズの二つのピクチャーを重ね合わせた上でそのマスクの結果を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_pointer.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_pointer.md index 50ae7d97a89de3..be475e2ce46d56 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_pointer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_pointer.md @@ -3,7 +3,7 @@ id: pointer title: Pointer --- -ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、またはフィールドへの参照です。ポインタータイプのフィールドは、存在しません。 +ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、フィールド、またはオブジェクトへの参照です。ポインタータイプのフィールドは、存在しません。 ポインターは、(プログラミングにおける) データを参照するための高度な方法を提供します。 4D ランゲージ使用時にテーブル・フィールド・変数・配列等にアクセスするには、単純に名前を用います。ですが、名前を使用しないでデータを参照する、またはアクセスした方が便利な場合もあります。ポインターを使うとこれが実現できます。 @@ -20,7 +20,7 @@ title: Pointer | 変数 | vpVar:=->Variable | ALERT(vpVar->) | vpVar->:="John" | | 配列 | vpArr:=->Array | SORT ARRAY(vpArr->;>) | COPY ARRAY (Arr;vpArr->) | | 配列要素 | vpElem:=->Array{1} | ALERT (vpElem->) | vpElem->:="John" | -| Object | vpObj:=->myObject | ALERT (vpObj->myProp) | vpObj->myProp:="John" | +| オブジェクト | vpObj:=->myObject | ALERT (vpObj->myProp) | vpObj->myProp:="John" | ## ポインターの使用例 @@ -47,7 +47,7 @@ $MyPointer-> 前述の式は、"Hello" という文字列を返します。ポインター記号 (->) をポインターの後につけると、参照先の値を取得することができます。これをデリファレンス (参照外し) と呼びます。 -ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、オリジナルの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: +ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、もとの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: ```4d ALERT($MyPointer->) @@ -59,7 +59,7 @@ $MyPointer を使用して $MyVar の値を変更することもできます。 $MyPointer->:="Goodbye" ``` -この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。 両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: +この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: ```4d ALERT($MyPointer->) @@ -154,7 +154,7 @@ $FieldPtr:=Field(1;2) OBJECT SET FONT($FieldPtr->;"Arial") ``` -### 変数へのポインター +### ローカル変数へのポインター プロセス変数またはローカル変数のポインターを使う場合、参照される変数はポインターが使用される時点ですでに定義されていなければなりません。ローカル変数は、それらを作成したメソッドの実行が終わると破棄され、プロセス変数もそれを作成したプロセスの終了時に削除される点に留意してください。存在しない変数をポインターで呼び出そうとすると、インタープリターモードでは (「変数が設定されていません」という内容の) シンタックスエラーが起きます。コンパイルモードでは、さらに重大なエラーが発生する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_string.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_string.md index 22aa6f7cc67387..3d357f5aba0a4a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_string.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_string.md @@ -10,7 +10,7 @@ title: String ## 文字列リテラル -文字列リテラル定数は、次のように二重引用符 ("...") 文字列定数の例を次に示します: +文字列リテラル定数は、次のように二重引用符 ("...") で囲んで表します。文字列定数の例を次に示します: ```4d "レコード追加" @@ -24,21 +24,21 @@ title: String 以下のエスケープシーケンスを文字列内で使用できます: -| エスケープシーケンス | 意味する文字 | -| ---------- | --------------------------- | -| \n | LF (行送り) | -| \t | HT (タブ) | -| \r | CR (改行) | -| \\\\ | | -| \\" | " (引用符) | +| エスケープシーケンス | 意味する文字 | +| --------------------------------------- | --------------------------- | +| \n | LF (行送り) | +| \t | HT (タブ) | +| \r | CR (改行) | +| \\\\|\ (バックスラッシュ) | | +| \\" | " (引用符) | -**注:** \ (バックスラッシュ) は Windows でパス名の区切り文字として使用されています。しかし “C:\MyDocuments\New” と入力した場合、4Dは二番目のバックスラッシュは "\N" (行送り) と解釈してしまい、“C:\\\MyDocuments\New”を表示します。 このようなケースでは開発者がバックスラッシュを2つ入力するようにしなければなりません。 +**注:** \ (バックスラッシュ) は Windows ではパス名の区切り文字としても使用されています。そのため、パス名において、4D のエスケープシーケンスで使用される文字の前にバックスラッシュを挿入したいときは、\\\ のようにバックスラッシュを 2つ入力しなければなりません (例: "\N" (行送り) と解釈されないよう、"C:\\\MyDocuments\\\New.txt" と表します)。 ### 行末の自動正規化 データベース内で管理されているテキストが複数のプラットフォームで正常に処理されるようにするため、4D は改行文字を自動的に正規化し、それらが単一の文字( `\r` 、キャリッジリターン)に収まる様にします。この正規化は、標準テキストまたはマルチスタイルテキストをホストするフォームオブジェクト(変数またはフィールド)レベルにおいて実行されます。ネイティブではない改行文字、あるいは複数の改行文字の混用(例えば `\r\n` など)は、単一の `\r` とみなされます。なお、XML 標準(マルチスタイルテキストフォーマット)に準拠するため、[スタイル付きテキストコマンド](../commands/theme/Styled_Text.md) は、オブジェクトに割り当てられていないテキスト変数の行末文字も正規化するという点に注意してください。 -この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが用意になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を公領する必要があります。 +この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが容易になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を考慮する必要があります。 ## 文字列演算子 @@ -64,7 +64,7 @@ title: String ## 文字列比較の詳細 - 文字列は文字ごとに比較されます (後述の [キーワード](dt_string.md#キーワード) による検索の場合を除きます)。 -- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。大文字と小文字を区別して比較するには、文字コードで比較してください。たとえば、次の式は `FALSE` です: ```4d Character code("A")=Character code("a") @@ -90,7 +90,7 @@ Character code("A")=Character code("a") "abcdefghij"="abc@" ``` -一方、どのような場合でも、ワイルドカードを 2つ連続して使用した文字列比較は常に FALSE を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +ただし、複数の文字を比較する目的のワイルドカード記号は、比較演算子の右側の式で使用しなければなりません。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: ```4d "abc@"="abcdefghij" @@ -128,7 +128,7 @@ Character code("A")=Character code("a") 以下のようにすると、式は意図したように評価されます: ```4d -(Character code($vsValue[[Length($vsValue)]])=64) +(Character code($vsValue[[Length($vsValue)]])#64) ``` **注:** ストラクチャー設定のデータベースページには、文字列に @ 記号が含まれているとき、それをどう解釈するかを指定するオプションが提供されています。 @@ -184,7 +184,7 @@ End if ### 無効な文字列参照に関する注意 -文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。 +文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。長さが足りない場合: - インタープリターモードでは構文エラーは発生しません。 - コンパイルモードで範囲チェックオプションを無効にしている場合には、メモリ領域を破壊するおそれがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_time.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_time.md index 0d04c4a95edf86..4b731c331977bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_time.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_time.md @@ -7,7 +7,7 @@ title: Time 時間は 24時間制です。 -時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す総秒数です。 +時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す深夜0時からの総秒数です。 **注:** *4Dランゲージリファレンス* マニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。 @@ -25,7 +25,7 @@ title: Time ?13:01:59? // 午後1時1分59秒 ``` -空の時間は、?00.00.00? のように指定します。 +空の時間は、?00:00:00? のように指定します。 **Tip:** コードエディターでは空の時間を入力するためのショートカットが提供されています。空の時間を入力するには、疑問符 (?) の入力後に Enterキーを押します。 @@ -34,26 +34,26 @@ title: Time | 演算 | シンタックス | 戻り値 | 式 | 値 | | --------------------------- | ------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | 加算 (足し算) | Time + Time | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? | -| 減算 (引き算) | Time – Time | Time | ?02:03:04? ?01:02:03? | ?01:01:01? | +| 減算 (引き算) | Time – Time | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? | | 加算 (足し算) | Time + Number | Number | ?02:03:04? + 65 | 7449 | -| 減算 (引き算) | Time – Number | Number | ?02:03:04? ?01:02:03? | 7319 | -| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? ?01:02:03? | 14768 | -| 除算 (割り算) | Time / Number | Number | ?02:03:04? ?01:02:03? | 3692 | -| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? ?02:03:04? | 3692 | +| 減算 (引き算) | Time – Number | Number | ?02:03:04? – 65 | 7319 | +| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? \* 2 | 14768 | +| 除算 (割り算) | Time / Number | Number | ?02:03:04? / 2 | 3692 | +| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? \ 2 | 3692 | | モジューロ | Time % Time | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? | | モジューロ | Time % Number | Number | ?02:03:04? % 2 | 0 | -| 等しい | Time = Time | Boolean | ?01:02:03? >=?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 異なる | Time # Time | Boolean | ?01:02:03? ?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 大きい | Time > Time | Boolean | ?01:02:03? > ?01:02:03? | true | +| 等しい | Time = Time | Boolean | ?01:02:03? = ?01:02:03? | true | +| | | | ?01:02:03? = ?01:02:04? | false | +| 異なる | Time # Time | Boolean | ?01:02:03? # ?01:02:04? | true | +| | | | ?01:02:03? # ?01:02:03? | false | +| 大きい | Time > Time | Boolean | ?01:02:04? > ?01:02:03? | true | | | | | ?01:02:03? > ?01:02:03? | false | | 小さい | Time < Time | Boolean | ?01:02:03? < ?01:02:04? | true | | | | | ?01:02:03? < ?01:02:03? | false | | 以上 | Time >= Time | Boolean | ?01:02:03? >=?01:02:03? | true | | | | | ?01:02:03? >=?01:02:04? | false | | 以下 | Time <= Time | Boolean | ?01:02:03? <=?01:02:03? | true | -| | | | ?01:02:03? <=?01:02:03? | false | +| | | | ?01:02:04? <=?01:02:03? | false | ### 例題 1 @@ -78,7 +78,7 @@ $vhSoon:=Time(Current time+3600) ### 例題 2 -モジューロ演算子を使用できます。 とくに24時間フォーマットを考慮した時間の追加に便利です: +モジューロ演算子を使用できます。とくに24時間フォーマットを考慮した時間の追加に便利です: ```4d $t1:=?23:00:00? // 23時です diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_variant.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_variant.md index d987830b9a641f..c2279417430f47 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_variant.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/dt_variant.md @@ -37,7 +37,7 @@ $vtype:=Type($variant) // 12 (Is variant) $vtypeVal:=Value type($variant) // 1 (Is real) ``` -変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。 ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: +変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: ```4d C_VARIANT($v) @@ -48,7 +48,7 @@ $t:=Type($v) // 12 (Is variant) 代入元の変数はバリアント型ですが $t2:=Type($v2) // 2 (Is text) 代入先の変数はテキスト型です ``` -バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) この場合、引数の値の型の確認作業が必要になります: +バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) を宣言するのに使用できます。この場合、引数の値の型の確認作業が必要になります: ```4d #DECLARE ($param : Variant) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/error-handling.md index 7db089561d8327..4ac97bc4d102a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/error-handling.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/error-handling.md @@ -23,9 +23,9 @@ title: エラー処理 ## 予測可能なエラーvs予測不可能なエラー {#predictable-vs-unpredictable-errors} -[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドを実装する) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 +[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドの実装) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 -もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、プロパティに値(例: `dk status serious error` - "その他のエラー")も返すことがあり得るという点に注意してください。 +もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、`status` と `statusText` プロパティに値 (例: `dk status serious error` - "その他のエラー") を返すこともあり得るという点に注意してください。 ## エラー処理メソッドの実装 @@ -45,7 +45,7 @@ ON ERR CALL("IO_Errors";ek local) // ローカルなエラー処理メソッド ON ERR CALL("";ek local) // ローカルプロセスにおいてエラーの検知を中止します ``` -[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。 エラー処理メソッドを一時的に変更し、後で復元することができます: +[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。エラー処理メソッドを一時的に変更し、後で復元することができます: ```4d $methCurrent:=Method called on error(ek local) @@ -98,7 +98,7 @@ ON ERR CALL("componentHandler";ek errors from components) // コンポーネン ::: - [`Last errors`](../commands/last-errors) コマンドは4D アプリケーション内で発生したエラーのカレントのスタックのコレクションを返します。 -- the [`Call chain`](../commands/call-chain) command that returns a collection of objects describing each step of the method call chain within the current process. +- [`Call chain`](../commands/call-chain) コマンドは、カレントプロセス内におけるメソッド呼び出しチェーンの各ステップを説明するオブジェクトのコレクションを返します。 #### 例題 @@ -229,7 +229,7 @@ End try - エラーがスローされなかった場合には、対応する `End try` キーワードの後へとコード実行が継続されます。 `Catch` と `End try` キーワード間のコードは実行されません。 - コードブロックの実行が *非遅延エラー* をスローした場合、実行フローは停止し、対応する `Catch` コードブロックを実行します。 -- コードブロックが *非遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 +- コードブロックが *遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 - 遅延エラーが `Try` ブロックから直接スローされた場合、実行フローは `Try` ブロックの終わりまで継続し、対応する `Catch` ブロックは実行しません。 :::note @@ -290,14 +290,14 @@ Function createInvoice($customer : cs.customerEntity; $items : Collection; $invo コード実行を妨げる例外は4D によって返されますが、その原因はOS、デバイス、4D カーネル、コード内の[`throw`](../commands/throw) など、様々な要因が考えられます。そのため、3つの要素によって定義されます: - **コンポーネント署名**。エラーの起きた場所を表します(署名の一覧については[`Last errors`](../commands/last-errors) を参照してください) -- **メッセージ**。エラーがなぜ起きたかを説明します。 +- **メッセージ**。エラーがなぜ起きたかを説明します - **コード**。コンポーネントによって返される任意の数値です。 エラーと特にその原因の完全な詳細を取得するには、[4D エラーダイアログボックス](../Debugging/basics.md) あるいは[`Last errors`](../commands/last-errors.md) コマンドを使用することができます。 ### エラーダイアログボックス -[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボランをクリックします: +[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボタンをクリックします: ![copy-button](../assets/en/Concepts/error.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/flow-control.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/flow-control.md index ad3bb638ee730b..026db9b741ab61 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/flow-control.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/flow-control.md @@ -7,7 +7,7 @@ title: 制御フロー - **シーケンシャル**: シーケンシャル構造は単純な線形構造です。シーケンスとは、4Dが最初から最後まで次々に実行する一連のステートメントです。オブジェクトメソッドで頻繁に使用される1行から成るルーチンはもっとも簡単なシーケンシャル構造の例です。例: `[People]lastName:=Uppercase([People]lastName)` - **分岐**: 分岐構造は、条件をテストし、その結果に基づいて異なる流れにメソッドを導きます。条件は true または false に評価されるブール式です。 [`If...Else...End if`](#ifelseend-if) 構文は分岐構造の一例で、処理フローを二つに分岐します。 [`Case of...Else...End case`](#case-ofelseend-case) 構文も分岐構造の一つで、処理フローをもっとたくさん分岐することができます。 -- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これに実現するために、4D は以下のループ構造を備えています: +- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これを実現するために、4D は以下のループ構造を備えています: - [`While...End while`](#whileend-while) - [`Repeat...Until`](#repeatuntil) @@ -16,7 +16,7 @@ title: 制御フロー ループを制御する方法には、条件が満たされるまでループする方法と、指定した回数だけループする方法の2通りがあります。各ループ構造はいずれの方法にも用いることができますが、`While` ループと `Repeat` ループは条件が満たされるまで繰り返す場合に、`For` ループは指定した回数だけループする場合の利用に適切です。 `For each...End for each` ループは両方を組み合わせることが可能で、オブジェクトやコレクション内でループするために設計されています。 -**注:** 4Dはプログラム構造 (If/While/For/Caes of/Repeat/For each) を512レベルまで入れ子で記述できます。 +**注:** 4Dはプログラム構造 (If/While/For/Case of/Repeat/For each) を512レベルまで入れ子で記述できます。 ## If...Else...End if @@ -268,7 +268,7 @@ vResult = 1の判定により他の条件を見る前に分岐するので、第 一般に、`While...End while` ループに入る手前で、ブール式で判定する値を初期化しておきます。値を初期化するとは適切な値に設定するということで、通常はブール式が true になるように設定してからループに入ります。 -ブール式は、ループ内の要素を使って設定されなければなりません。 そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 +ブール式は、ループ内の要素を使って設定されなければなりません。そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 ```4d NeverStop:=True @@ -309,7 +309,7 @@ Until(Boolean_Expression) #### 例題 -以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数　`OK` を初期化する `CONFIRM` コマンドはありません。 +以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数 `OK` を初期化する `CONFIRM` コマンドはありません。 ```4d Repeat @@ -375,7 +375,7 @@ End for End for ``` -4. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +4. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d FIRST RECORD([aTable]) @@ -424,7 +424,7 @@ End for End for ``` -8. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +8. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d LAST RECORD([aTable]) @@ -552,7 +552,7 @@ End for End for each ``` -`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の \*Expression \* を対象に反復処理をおこなうことができます: +`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の *Expression* を対象に反復処理をおこなうことができます: - コレクション: コレクションの各要素をループします - エンティティセレクション: 各エンティティをループします @@ -562,8 +562,8 @@ End for | | コレクション内のループ | エンティティセレクション内のループ | オブジェクト内のループ | | ------------------------------------ | ------------------------------------- | ----------------- | ------------- | -| Current_Item の型 | コレクション要素と同じ型の変数 | Entity | テキスト変数 | -| Expression の型 | (同じ型の要素を持つ) コレクション | エンティティセレクション | Object | +| Current_Item の型 | コレクション要素と同じ型の変数 | エンティティ | テキスト変数 | +| Expression の型 | (同じ型の要素を持つ) コレクション | エンティティセレクション | オブジェクト | | ループ数 (デフォルト) | コレクションの要素数 | セレクション内のエンティティ数 | オブジェクトのプロパティ数 | | begin / end パラメーターをサポート | ◯ | ◯ | × | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/identifiers.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/identifiers.md index 59353fc439a0af..8437bd7d41b2fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/identifiers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/identifiers.md @@ -75,7 +75,7 @@ Function getArea($width : Integer; $height : Integer)-> $area : Integer - 1文字目は、文字、数字、あるいはアンダースコア(_) でなければなりません。 - その後の文字には、文字・数字・アンダースコア(_)・スペースが使用できます。 - 予約語を使用しないでください。予約語にはコマンド名 (`Date`, `Time` 等)、キーワード (`If`, `For` 等)、そして定数 (`Euro`, `Black`, `Friday` 等) が含まれます。 -- 大文字・小文字は区別されます。 +- 大文字・小文字は区別されません。 例: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/interpreted.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/interpreted.md index 168d45256e64a6..36d3d5fe595e29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/interpreted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/interpreted.md @@ -27,7 +27,7 @@ title: インタープリターモードとコンパイル済みモード | 変数や配列のデータタイプは変更できません。 | 変数や配列のデータタイプは変更可能です (推奨されません) | | 1次元配列を2次元配列に、また2次元配列を1次元配列に変更することはできません。 | 可能です。 | | コンパイラーにより変数のタイプ定義はおこなわれますが、フォーム上の変数のようにデータタイプが明確でない場合は、宣言によって変数のデータタイプを指定するべきです。 | | -| `Undefined` 関数は、常に False を返します。 変数は常に定義されています。変数は常に定義されています。 | | +| `Undefined` 関数は、常に False を返します。変数は常に定義されています。 | | | メソッドの "プリエンプティブプロセスで実行可能" プロパティにチェックを入れていた場合、コードは他のスレッドアンセーフなコマンドやメソッドを呼び出してはいけません。 | プリエンプティブプロセスプロパティは無視されます。 | | 特定のループの場合、割り込みを可能にするには `IDLE` コマンドが必要です。 | いつでも割り込み可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md index 1baedda0c29499..aa24982323112d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: -- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 -- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#ternary-operator) (a ? b : c\\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2 + 3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#三項演算子) (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -24,7 +24,7 @@ title: 演算子 $myNumber:=3 // 3 を $myNumber 変数に代入 $myDate:=!2026/01/21! // 日付リテラルを代入 $myLength:=Length("Acme") // コマンドの結果(4) を $myLength に代入 -$col:=New collection //$col をからのコレクションで初期化 +$col:=New collection //$col を空のコレクションで初期化 $myObject:={ a:2 ; b:$col } // オブジェクト参照を $myObject に代入 $myObject.a:=3 // オブジェクトプロパティに値を代入 ``` @@ -97,7 +97,7 @@ $a+=2 // $a=3 - オブジェクトプロパティあるいはコレクション要素としてのピクチャー - 配列のインデックス変数 -"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()-+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 +"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()->+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 > [テキストの文字インデックス](dt_string.md#文字参照記号) および [BLOB のバイトインデックス](dt_blob.md#スカラーblob-のバイトへのアクセス) では、これらの演算子はサポートされません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/ordering.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/ordering.md index 85480bfae8c0c4..c2ef7b7780de6c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/ordering.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/ordering.md @@ -1,17 +1,17 @@ --- id: ordering -title: コレクションとオブジェクトの並び替え +title: コレクションとオブジェクトの並べ替え --- 一連のデータをソートするために、4D はデータの型に応じて定義された比較条件を適用することで、それぞれの値を他の値と比較します([並べ替えルール](#並べ替えルール) を参照してください)。このプロセスは全ての要素に渡って総合的な並べ替えを確立するためのソートアルゴリズムに依存しています。全てのデータが同じ [データ型](./data-types.md) に所属している場合、比較ルールは単純で正確に定義されています。 -しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は戦略的な並べ替えスキームを適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 +しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は階層化された並べ替え方式を適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 ## 並べ替え機能 4D ランゲージには、コレクション要素、オブジェクト属性をソートしたり、あるいは順序づけされた結果のためのソートを作成することに依存する複数の機構を提供します: -- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (明示的なキーと並べ替え指定を使用した複数条件並べ替え)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによる並べ替え)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な並べかリレーションによるインプレースなソート) +- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (キーと順序を明示的に指定する多条件ソート)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによるソート)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な順序関係によるインプレースなソート) - **エンティティセレクションの並べ替え用関数**: [`entitySelection.orderBy()`](../API/EntitySelectionClass.md#orderby)、コレクションと同じ並べ替えルールを適用します。 - **並べ替え付きのクエリ関数**: [`entitySelection.query()`](../API/EntitySelectionClass.md#query)、 [`dataClass.query()`](../API/DataClassClass.md#query) に対して `order by attributePath` キーワードを使用すると決定的な順序で結果を返します。 - **順序依存の統計関数**: [`collection.max()`](../API/CollectionClass.md#max)、 [`collection.min()`](../API/CollectionClass.md#min)、 [`entitySelection.max()`](../API/EntitySelectionClass.md#max)、 [`entitySelection.min()`](../API/EntitySelectionClass.md#min)、 これらは極値を識別するために順序関係に依存します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/parameters.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/parameters.md index f5a7b17e67088b..4fa0cc4a54af31 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/parameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/parameters.md @@ -19,7 +19,7 @@ ALERT("Hello") $area:=$o.getArea(50;100) ``` -また、プロジェクトメソッド `DO SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: +また、プロジェクトメソッド `DO_SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: ```4d DO_SOMETHING($WithThis;$AndThat;$ThisWay) @@ -35,7 +35,7 @@ EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/20!) // その際に引数として日付リテラル !05/05/20! を渡します ``` -メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* コードは以下のようになります: +メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* という変数に値を返します。コードは以下のようになります: ```4d MyLength:=Length("How did I get here?") @@ -226,7 +226,7 @@ Function returnHello Result:=MySum("000";1;2;200) // "203" ``` -0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: +0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: ```4d // foo メソッド @@ -480,16 +480,16 @@ ALERT([People]Name) ALERT($param) ``` -`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 +`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Name フィールドの値には影響しません。 もし `DO_SOMETHING` メソッド内でフィールドの値を変更したいのであれば、2通りのやり方があります: -1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。 この場合、以下のようにコードを書きます: +1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。この場合、以下のようにコードを書きます: ```4d // MY_METHOD メソッド DO_SOMETHING(->[People]Name) // [People]Name の値が "williams" だとします -ALERT([People]Last Name) +ALERT([People]Name) // DO_SOMETHING メソッド #DECLARE($param : Text) @@ -518,7 +518,7 @@ ALERT($param->) オブジェクトやコレクションのデータタイプは参照 (つまり、内部的な *ポインター*) を介した形でのみ扱われることに注意が必要です。 -したがって、`$param、$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 +したがって、`$param`、`$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 次の例では、`CreatePerson` メソッドはオブジェクトを作成したのち、それを引数として `ChangeAge` に渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/quick-tour.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/quick-tour.md index 1873d1227142a1..f63e68d10eb4fa 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/quick-tour.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/quick-tour.md @@ -31,7 +31,7 @@ $myHour:=?08:12:55? // 時間リテラルを代入します 代入演算 (:=) は必ず他の演算と区別しなければなりません。代入演算子は、被演算子を組み合わせて新しい一つのものにするのではなく、演算子の右側の式の値を左側の変数やフィールドにコピーします。 -**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 +**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 ## 変数 @@ -64,7 +64,7 @@ MyOtherDate:=Current date+30 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new") ``` -コレクションやオブジェクトにコマンドが属している場合、それらは名前付き関数であり、ドット記法を用いて使用します。例: +コレクションやオブジェクトにコマンドが属している場合、それらは関数と呼ばれ、ドット記法を用いて使用します。例: ```4d $c:=New collection(1;2;3;4;5) @@ -105,7 +105,7 @@ vRef:=Open document("PassFile";"TEXT";Read Mode) // ドキュメントを読み 4D が提供するたくさんのビルトインコマンドを使って、独自の **プロジェクトメソッド** を組み立てることができます。プロジェクトメソッドとはユーザー定義のメソッドで、コマンドや演算子などの要素から成り立ちます。プロジェクトメソッドは汎用性のあるメソッドですが、そうではない他の種類のメソッドも存在します: オブジェクトメソッド、フォームメソッド、テーブルメソッド (トリガー)、データベースメソッド。 -メソッドは、一つ以上のステートメントで構成されます。 ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 +メソッドは、一つ以上のステートメントで構成されます。ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 たとえば、次のステートメントは確認ダイアログボックスを表示します: @@ -144,7 +144,7 @@ $out:=Uppercase($in) データタイプのうち、文字タイプと数値タイプは、複数の類似するフィールドタイプに対応する点に注意してください。これらのフィールドにデータが格納されるとき、4D ランゲージはフィールドタイプに合致するデータタイプへとデータを自動的に変換します。反対に、たとえば整数フィールドのデータを呼び出すと、そのデータは自動的に数値タイプとして扱われます。つまり、4D ランゲージを使用する際に、類似するフィールドタイプを厳密に区別する必要はありません。 -しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。 しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 +しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 あるタイプとして格納したデータを、別のタイプとして使用する場合があります。 4D ランゲージには、データタイプを変換するためのコマンドが用意されています。たとえば、数値で始まり、"abc" 等の文字で終了する部品番号を作成する必要がある場合、以下のように記述することができます: @@ -258,7 +258,7 @@ This.name:="Square" 数値演算子は、使用可能な演算子のうちの 1種にすぎません。 4Dは、数値・テキスト・日付・ピクチャー等、異なるタイプのデータを扱うために、各データタイプで演算を実行するための演算子を備えています。 -対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。例えば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: +対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。たとえば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: | データタイプ | 演算 | 例題 | | ------ | --------------------------- | --------------------------------------------------------------------- | @@ -272,11 +272,11 @@ This.name:="Square" コマンド・演算子・変数・フィールド・オブジェクトプロパティ・コレクション要素等、複数のランゲージの要素を組み合わせて式は構成されます。式により、ステートメント (メソッドの 1文や 1行) を構成します。データが必要なとき、式が必要になります。 -式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります : +式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります。これには以下が含まれます: - フォーミュラエディター (フォーミュラによるクエリや並べ替えなど) - `EXECUTE FORMULA` コマンド -- フォームオブジェクトやウィジェットのデータソースとして +- プロパティリスト内で、フォームオブジェクトやウィジェットのデータソースとして - デバッガー内で式の値を確認することができます - クイックレポートエディターでカラムにフォーミュラを使用することができます @@ -284,30 +284,30 @@ This.name:="Square" 生成する値のタイプによって、式のタイプを定義することができます。式のタイプは複数あります。様々なタイプの式の例を以下に示します。 -| 式 | 型 | 説明 | -| ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | -| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | -| [People]Name + "様" | Text | 2つの文字列の結合です。 [People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | -| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | -| 4 | Number | これは数値定数 4です。 | -| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。 乗算演算子の (\*) を使用しています。数値の 8を返します。 | -| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | -| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | -| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | -| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | -| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | -| true | Boolean | このコマンドはブール値の true (真) を返します。 | -| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | -| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | -| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | -| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | -| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | -| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | -| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | -| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | -| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | -| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | +| 式 | 型 | 説明 | +| ------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | +| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | +| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | +| [People]Name + "様" | Text | 2つの文字列の結合です。[People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | +| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | +| 4 | Number | これは数値定数 4です。 | +| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。乗算演算子の (\*) を使用しています。数値の 8を返します。 | +| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | +| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | +| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | +| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | +| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | +| true | Boolean | このコマンドはブール値の true (真) を返します。 | +| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | +| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | +| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | +| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | +| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | +| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | +| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | +| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | +| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | +| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | ### 代入可能な式vs代入不可の式 {#assignable-vs-non-assignable-expressions} @@ -428,9 +428,10 @@ End for - 中カッコ `{ }` は、任意のパラメーターを示します。例えば、`.delete({ option : Integer })` は *option* 引数は関数を呼び出す際に省略可能であることを意味します。 - `any` キーワードは、あらゆる型(数値、テキスト、ブール、日付、時間、オブジェクト、コレクション、など) の値が可能な引数に対して使用されます。 -- これは *value* 引数は、テキスト型または実数型または日付型または時間型を受け付けるということを意味します。 +- パラメーターが複数の型を受け入れることができる場合、それらはカンマ区切りで列挙されます。例: `value : Text Real, Date, Time`。 + これは *value* が、テキスト型または実数型または日付型または時間型を受け付けるということを意味します。 - **可変長引数**: `...param : Type` という表記は、同じ型の引数を 0 から無制限に受け付けることを意味します。たとえば、`.concat( value : any { ;...valueN : any }) : Collection` という表記の場合、あらゆる型の引数を数に制限なく関数に渡すことができます。 -- **可変長のグループ引数**: `{; ...(param1 : Type ; param2 : Type)}` という表記は、グループの引数を1つから無制限に受け付けることを意味します。例えば、`COLLECTION TO ARRAY ( collection : Collection ; array : Array {; propertyName : Text}{; ...(array : Array ; propertyName : Text) })` という表記は、値またはテキスト型配列のペアを無制限にコマンドに渡すことができるということを意味します。 +- **可変長のグループ引数**: `{; ...(param1 : Type ; param2 : Type)}` という表記は、グループの引数を1つから無制限に受け付けることを意味します。たとえば、`COLLECTION TO ARRAY ( collection : Collection ; array : Array {; propertyName : Text}{; ...(array : Array ; propertyName : Text) })` という表記は、配列とテキストの組を無制限にコマンドに渡すことができるということを意味します。 ### 引数の型の説明 @@ -442,30 +443,30 @@ End for | any | サポートされるあらゆるデータ型を受け付ける引数 | JSON Stringify($value)
    $col.push(6;New object("firstname";"John")) | | 配列 | 同じ型の複数の値を格納する変数。 | ARRAY TEXT($arr;10) | | BLOB 配列 | BLOB 値を格納した配列。 | ARRAY BLOB($data;10) | -| BLOB | バイナリデータを保存するために使用される、バイナリーラージオブジェクト。 | BLOB TO DOCUMENT($blob;"file.bin") | -| Boolean | 論理値: True または False。 | If (OK=1) | +| BLOB | バイナリーデータを保存するために使用される、バイナリーラージオブジェクト。 | BLOB TO DOCUMENT($blob;"file.bin") | +| ブール | 論理値: True または False。 | If (OK=1) | | ブール配列 | ブール値を格納した配列。 | ARRAY BOOLEAN($flags;10) | | クラス名(例: 4D.File) | クラスインスタンスを作成または操作するために使用されるクラス型への参照。 | $file:=File("/RESOURCES/NovelCover1.jpg") | -| Collection | 複数の型を格納可能な、順番付きの値のリスト。 | New collection("A";"B";"C") | -| Date | カレンダーの日付値。 | $vDate:=Current date | +| コレクション | 複数の型を格納可能な、順番付きの値のリスト。 | New collection("A";"B";"C") | +| 日付 | カレンダーの日付値。 | $vDate:=Current date | | 日付配列 | 日付値を格納した配列。 | ARRAY DATE($dates;10) | | 式 | 式の形であればなんでも可能 | SET PROCESS VARIABLE($vlProcess;vtCurStatus;"") | | フィールド | テーブルに属しているフィールドへの参照。 | ORDER BY([Person];[Person]Name) | -| Integer | 小数部分を除いた整数。 | $Sel:=ds.Employee.newSelection(dk keep ordered) | +| 整数 | 小数部分を除いた整数。 | $Sel:=ds.Employee.newSelection(dk keep ordered) | | 整数配列 | 整数値を格納した配列。 | ARRAY INTEGER($numbers;10) | | 倍長整数配列 | 倍長整数値を格納した配列。 | ARRAY LONGINT($values;10) | | オブジェクト配列 | オブジェクト型を格納した配列。 | ARRAY OBJECT($objects;10) | -| Object | キー/値のペアで構成された構造化されたデータコンテナ。 | $entity.fromObject($o) | +| オブジェクト | キー/値のペアで構成された構造化されたデータコンテナ。 | $entity.fromObject($o) | | 演算子 | 必ず \* 。 | QUERY([Person];[Person]Name="Smith";\*) | | ピクチャー配列 | ピクチャーを格納した配列。 | ARRAY PICTURE($images;10) | -| Picture | グラフィカルな画像の値。 | READ PICTURE FILE($pic;"image.png") | +| ピクチャー | グラフィカルな画像の値。 | READ PICTURE FILE($pic;"image.png") | | ポインター配列 | ポインターを格納した配列。 | ARRAY POINTER($ptrs;10) | -| Pointer | 他の変数、フィールド、オブジェクトへの参照。 | If(Is nil pointer($ptr)) | +| ポインター | 他の変数、フィールド、オブジェクトへの参照。 | If(Is nil pointer($ptr)) | | 実数配列 | 実数を格納した配列。 | ARRAY REAL($values;10) | -| Real | 浮動小数点数値。 | $vlResult:=Int(123.4) | +| 実数 | 浮動小数点数値。 | $vlResult:=Int(123.4) | | テーブル | データベーステーブルへの参照。 | ALL RECORDS([Person]) | -| Text | テキストデータを表現する一連の文字列。 | ALERT("Hello world") | +| テキスト | テキストデータを表現する一連の文字列。 | ALERT("Hello world") | | テキスト配列 | テキスト値を格納した配列。 | ARRAY TEXT($names;10) | -| Time | 時間、分、秒を表した時間値。 | 現在の時刻 | +| 時間 | 時間、分、秒を表した時間値。 | Current time | | 時間配列 | 時間値を格納した配列。 | ARRAY TIME($times;10) | | 変数 | 値を受け取り可能(代入可能)な、"任意"の型の書き込み可能な変数。 | SET PICTURE METADATA(vPicture;IPTC keywords;$arrTkeywords) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/shared.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/shared.md index c014e59e558b1f..a54bb6ee016a81 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/shared.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/shared.md @@ -82,7 +82,7 @@ End Use ### ストレージ -**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 +**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンプティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 `ストレージ` オブジェクトは標準の共有オブジェクトとは異なり、共有オブジェクト/コレクションがプロパティとして追加されたときでも共有グループを作成しないという点に注意してください。この例外的な振る舞いにより、**ストレージ** オブジェクトを使用するたびに、リンクされている共有オブジェクト/コレクションをすべてロックせずに済みます。 @@ -102,10 +102,10 @@ End Use 共有オブジェクトおよび共有コレクションは、プロセス間の (とくに \*[プリエンプティブプロセス](../Develop/preemptive.md)\*間の) 通信ができるように設計されています。これらはプロセスから他のプロセスへ、参照型の引数として渡すことができます。共有オブジェクトおよび共有コレクションを扱う際には、複数プロセスによる同時アクセスを避けるために、必ずそれらを `Use...End use` キーワードでくくる必要があります。 -- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のプすべてのロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 +- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のすべてのプロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 - *statement(s)* で実行されるステートメントは、Shared_object_or_Shared_collection のプロパティ/要素に対して、競合アクセスのリスクなしに変更も実行することができます。 - *Shared_object_or_Shared_collection* に他の共有オブジェクトあるいはコレクションがプロパティとして追加された場合、それらも同じ共有グループとして連結されます。 -- \*\*Use...End use \*\* 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 +- **Use...End use** 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 - **End use** は、*Shared_object_or_Shared_collection* プロパティおよび、同じグループのすべてのオブジェクトのロックを解除します。 - 4D コード内では、複数の **Use...End use** 構文を入れ子にすることができます。グループの場合、**Use** を使用するごとにグループのロックカウンターが 1 増加し、 **End use** ごとに 1 減少します。最後の **End use** によってロックカウンターが 0 になった場合にのみ、すべてのプロパティ/要素のロックが解除されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md index 017bca860210a3..b5c5643c78efdd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Concepts/variables.md @@ -59,23 +59,23 @@ var $myVar // バリアント型変数 サポートされている `varType` 値の一覧です: -| varType | 内容 | -| ---------------------------------------------- | -------------------------------- | -| `Text` | テキスト値 | -| `Date` | 日付値 | -| `Time` | 時間値 | -| `Boolean` | ブール値 | -| `Integer` | 倍長整数値 | -| `Real` | 実数値 | -| `Pointer` | ポインター値 | -| `Picture` | ピクチャー値 | -| `Blob` | スカラーBLOB値 | -| `Collection` | コレクション値 | -| `Variant` | バリアント値 | -| `Object` | デフォルトクラスのオブジェクト | -| `4D.` | 4Dクラス名のオブジェクト | -| `cs.` | ユーザークラス名のオブジェクト | -| `cs.`cs. | `` コンポーネントクラス名のオブジェクト | +| varType | 内容 | +| --------------------------- | -------------------------------- | +| `Text` | テキスト値 | +| `Date` | 日付値 | +| `Time` | 時間値 | +| `Boolean` | ブール値 | +| `Integer` | 倍長整数値 | +| `Real` | 実数値 | +| `Pointer` | ポインター値 | +| `Picture` | ピクチャー値 | +| `Blob` | スカラーBLOB値 | +| `Collection` | コレクション値 | +| `Variant` | バリアント値 | +| `Object` | デフォルトクラスのオブジェクト | +| `4D.` | 4Dクラス名のオブジェクト | +| `cs.` | ユーザークラス名のオブジェクト | +| `cs.` | `` コンポーネントクラス名のオブジェクト | :::note 互換性 @@ -184,7 +184,7 @@ MyNumber:=3 ## ローカル、プロセス、およびインタープロセス変数 -**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 +**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 ### ローカル変数 @@ -249,18 +249,18 @@ MyNumber:=3 システム変数は [4Dコマンド](../commands/command-index) によって使用されます。コマンドがシステム変数に影響を与えるかどうかを確認するには、コマンドの説明の "システム変数およびセット" の項目を参照ください。 -| システム変数名 | 型 | 説明 | -| ------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | -| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | -| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | -| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | -| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | -| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | -| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | -| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | +| システム変数名 | 型 | 説明 | +| ------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | +| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | +| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | +| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | +| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | +| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | +| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | +| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/building.md b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/building.md index ce46baa310eb71..dccdfd953fa069 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/building.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/building.md @@ -674,7 +674,7 @@ userPrefs:=Get 4D folder(Active 4D Folder) #### データリンクモードの設定 -コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、 \*\*アプリケーション名 \*\* でリンクされます。 +コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、**アプリケーション名** でリンクされます。 異なるデータファイルを使用するために組み込みアプリを複製する場合には、この方法は適さないかもしれません。複製されたアプリは同じアプリケーションユーザー設定フォルダーを共有するため、同じデータファイルを使用することになります (最後に使用されたファイルが開かれるため、データファイル名を変更した場合でも結果は同じです)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/clientServer.md index fb0201dee4c660..66f85111cda68d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/clientServer.md @@ -30,7 +30,7 @@ title: クライアント/サーバー 1. 次のいずれかの方法をおこないます: - Welcome ウィザードにて **4D Serverに接続** を選択します。 - - **ファイル** メニューより \*\*開く ＞ リモートプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **リモートプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 4D Server に接続するためのダイアログが表示されます。ダイアログには **最近使用**、**利用可**、および **カスタム** という、3つのタブがあります。 @@ -216,7 +216,7 @@ title: クライアント/サーバー #### サーバー上で禁止されるコマンド -以下はサーバー上で実行されるストアドプロシージャー内で使用すべきでないコマンドのリストです。以下のコマンドの1つををストアドプロシージャー内で使用したら、4D Server 上で使ってはいけないというアラートが表示されます。エラーは#67 が返ります。[`ON ERR CALL`](../commands/on-err-call) コマンドでインストールされたメソッドを通し、受け取ることができます。 +以下はサーバー上で実行されるストアドプロシージャー内で使用すべきでないコマンドのリストです。以下のコマンドの1つをストアドプロシージャー内で使用したら、4D Server 上で使ってはいけないというアラートが表示されます。エラーは#67 が返ります。[`ON ERR CALL`](../commands/on-err-call) コマンドでインストールされたメソッドを通し、受け取ることができます。 [`ADD RECORD`](../commands/add-record) [`APPEND MENU ITEM`](../commands/append-menu-item) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md index 301999fe23cbf6..25e56e6993e155 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md @@ -5,7 +5,7 @@ title: ドラッグ&ドロップ ## 概要 -4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラック＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラック＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラック＆ドロップすることが出来ます。 +4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラッグ＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラッグ＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラッグ＆ドロップすることが出来ます。 またオブジェクトを4Dフォームと他のアプリケーション間でドラッグ＆ドロップできます。例えば PNGピクチャーを 4D のピクチャーフィールドにドラッグ＆ドロップできます。またワードプロセッサーアプリケーションでテキストを選択し、4D のテキスト変数やリストボックスなどにドロップできます。 @@ -42,7 +42,7 @@ title: ドラッグ&ドロップ :::note 注記 - デフォルトで、ピクチャーフィールドや変数の場合は、ピクチャーとその参照は両方ともドラッグされます。変数やフィールドの参照のみをドラッグしたい場合は、**Alt** ボタン(Windows) または **Option** ボタン(macOS) を押す必要があります。 -- 配列型リストボックスオブジェクトで“カスタム”のドラック可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 +- 配列型リストボックスオブジェクトで“カスタム”のドラッグ可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 - ドラッグとドロップの両方ができるオブジェクトは、開発者が禁止しない限り、自分自身にもドロップできます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/labels.md b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/labels.md index 83da396a907891..70073d18ad1a8d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/labels.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Desktop/labels.md @@ -55,7 +55,7 @@ title: ラベル ### ラベルプレビューエリア -このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ)) を指定できます)。 +このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ) で指定できます)。 - ラベルにはフィールドをドラッグすることができます。 - 一つ目のフィールドの上に他のフィールドをドロップする事で二つのフィールドを結合する事もできます。これらは自動的にスペースで区切られます。
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/field-properties.md b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/field-properties.md index 03bddec21cce98..1defcb370930a6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/field-properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/field-properties.md @@ -39,7 +39,7 @@ title: フィールド オブジェクト型フィールドのクラスとして`4D.Vector` を割り当てた場合、**ベクトルフィールド** を定義します。このようなフィールドは埋め込みを保存し、AI 機能を使用してデータをクエリすることに使用することができます。ベクトルに対してどのようにクエリを行うかについては[`4D.Vector` クラス](../API/VectorClass.md) のドキュメンテーションをご覧ください。 -また[**4D Embedding Studio** コンポーネント](corner.4d.com/component/4d-embedding-studio) を使用すると、4D.Vector フィールドを設定したり更新したりするに役立ちます。 +また[**4D Embedding Studio** コンポーネント](https://corner.4d.com/component/4d-embedding-studio) を使用すると、4D.Vector フィールドを設定したり更新したりするに役立ちます。 オブジェクト型フィールドに対して`4D.Vector` クラスを割り当てると、ストラクチャーエディター内において特定のアイコンがフィールドの型として表示されるようになります: ![](../assets/en/Develop/ai-icon.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-indexes.md b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-indexes.md index 768fde33f81465..900653e927faf4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-indexes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-indexes.md @@ -82,7 +82,7 @@ QUERY([PICTURES];[PICTURES]Photos %"cats") - **ユークリッド**: このベクトルインデックスは [ユークリッド距離](../API/VectorClass.md#異なるベクトル計算を理解する) 計算に対して最適化されています。 - **自動**: 標準のオブジェクトインデックスタイプ([上記参照](#標準インデックス))。 Null ベクトルを管理したい場合にはこのインデックスタイプを選択できます。その場合、自動的に使用されます。 -You can select one or more index types for your vector fields, the appropriate index will be automatically used depending on the actual computation. For optimization reasons, it is recommended to only select necessary index types. +ベクトルフィールドに対しては一つまた複数のインデックスタイプを割り当てることができ、実際の計算に応じて適切なインデックスが自動的に使用されます。ただし最適化のため、必要なインデックスタイプのみを選択することが推奨されます。 :::tip 関連したblog 記事 @@ -90,84 +90,82 @@ You can select one or more index types for your vector fields, the appropriate i ::: -:::warning Limitation: Vector indexes and transactions +:::warning 制約: ベクトルインデックスとトランザクション -Vector indexes are not compatible with [transaction processing](../Develop/transactions). When vector-indexed records are inserted, updated, or deleted within a transaction, the corresponding index changes are not committed or rolled back with the transaction. As a result, the vector index may become inconsistent with the database state after a rollback, and search results may not reflect the persisted data. +ベクトルインデックスは[トランザクションの処理](../Develop/transactions) とは互換性がありません。トランザクション中にベクトルインデックスがつきレコードが追加、更新、削除された場合、対応するインデックスの変更はそのトランザクションとともにコミットまたはロールバックされることはありません。結果として、ベクトルインデックスはロールバック後にデータベースの状態と不整合になる可能性があり、検索結果には永続的なデータが反省されない可能性があります。 ::: -## Index List +## インデックスリスト -The ![](../assets/en/Develop/index-list.png) button of the toolbar in the Structure editor displays the Index List window. This window displays the list of all the indexes of the structure, regardless of their type: +ストラクチャーエディターのツールバーにある![](../assets/en/Develop/index-list.png) ボタンをクリックすると、インデックスリストウィンドウが表示されます。このウィンドウはタイプに関わらず、ストラクチャのすべてのインデックスを表示します: ![](../assets/en/Develop/index-window.png) -The Index List can be used to view the main properties of the indexes: +インデックスリストを使用して、インデックスの主なプロパティを確認することができます: -- **Type:** Index type. Each type of index (B-tree, Cluster B-tree, Keyword, Euclidean, Cosine, Dot) is depicted with a different icon. -- **Description:** Table and field(s) of index. For a composite index, this list contains all the fields of the index. -- **Name:** Index name. This property is used in particular by the language commands. You can change or add an index name by double-clicking in this column. +- **タイプ:** インデックスのタイプ。それぞれインデックスのタイプ(Bツリー、クラスターBツリー、キーワード、ユークリッド、コサイン、ドット) がそれぞれ異なるアイコンで表示されます。 +- **詳細:** インデックスのテーブルとフィールド。複合インデックスに対しては、リストにはインデックスに使用される全てのフィールドが含まれます。 +- **名前:** インデックスの名前。このプロパティは特にランゲージコマンドにおいて使用されます。この列をダブルクリックすることでインデックス名を変更または追加することができます。 -The **[+]** button displays the index property dialog box and allows you to edit the selected index or to add a new index when no index was selected. -The **[-]** button deletes the selected index (a confirmation dialog box appears). -This button can be used more particularly to delete composite indexes. +**[+]** ボタンをクリックすると、選択されたインデックスに対して編集するためのインデックスプロパティダイアログボックスを表示するか、インデックスが何も選択されていない場合には新しいインデックスを追加します。 +**[-]** ボタンは選択したインデックスを削除します(確認ダイアログが表示されます)。 +このボタンは特に複合インデックスを削除するために使用されます。 -Two additional commands are available in the menu associated with the tool button (enabled when an index is selected: +ツールボタンに割り当てられた2つのメニューを使用できます(インデックスが選択されている場合にのみ使用できます): -- **Edit:** Displays the properties of the selected index in the index property dialog box (see next paragraph). This command has the same effect as double-clicking on a row of the list (except for in the name area). -- **Rebuild:** Can be used to delete and rebuild the selected index. A confirmation dialog box appears when you select this command. +- **編集:** インデックスプロパティダイアログボックスに選択したインデックスのプロパティを表示します (次段落参照)。このダイアログはリスト中のインデックスをダブルクリックすることでも表示できます (名前エリアを除く)。 +- **再構築:** 選択したインデックスを再構築するために使用されます。このコマンドを選択すると、確認ダイアログボックスが表示されます。 -## Creating an index +## インデックスの作成 -To create a **standard index** directly: +**標準のインデックス** を直接作成する: -1. Select a field then choose a value from the "Index" menu of the **Inspector palette**. - **OR** - Right-click on the field then select a value from the **Index>** submenu of the context menu. +1. フィールドを選択し、**インスペクターパレット**の"インデックス"メニューから選択します。**または** + フィールドを右クリックし、コンテキストメニューの**インデックス>** サブメニューから選択します。 -To create a **composite index** or any other type of index using the index creation dialog box: +インデックス作成ダイアログボックスを使用して**複合インデックス** や他のタイプのインデックスを作成するためには: -1. Select several fields while holding down the **Shift** key (for adjacent selection) or **Ctrl** (Windows) or **Command** (macOS) button then right click on one of the fields and select **New Composite Index...** in the context menu. - **OR** - Select the **New Index...** in the context menu of the table or select **Index** in the add objects menu of the Structure editor tool bar. +1. **Shift** キー(連続した選択)、あるいは**Ctrl** (Windows) または **Command** (macOS) ボタンを押しながら複数のフィールドを選択し、うち一つのフィールドを右クリックしてコンテキストメニューから**新規複合インデックス...** を選択します。**または** + テーブルのコンテキストメニューから**新規インデックス...** を選択するか、ストラクチャーエディターツールバーのオブジェクト追加メニューを使用して、**インデックス** オプションを選択します。 -The index configuration dialog box then appears. +インデックス設定ダイアログが表示されます。 ![](../assets/en/Develop/index-add.png) -It contains the following elements: +このダイアログには以下の要素が含まれます: -- **Table:** List of all the database tables. Choose the table to which the index will belong from this menu. -- **Name:** Index name entry area. This name is used by the 4D language commands. -- **Type:** Selection menu for type of index to be created. If you keep the "Automatic" option, 4D will automatically choose the index type according to the contents of the field. -- **List of Fields:** This area is used to specify the field(s) associated with the index. It can contain a field by default depending on the current selection in the editor. +- **テーブル:** データベース中のすべてのテーブルのリスト。このメニューから、インデックスが属するテーブルを選択します。 +- **名称:** インデックス名の入力エリア。この名前は4D ランゲージコマンドによって使用されます。 +- **タイプ:** 作成するインデックスのタイプを選択するメニュー。"自動"を選択すると、フィールドの内容に基づき、4D が自動でインデックスタイプを決定します。 +- **フィールドリスト:** このエリアで、インデックスに割り当てるフィールドを指定します。ストラクチャーエディターでフィールドを選択していると、あらかじめそのフィールドがこのリストに設定されます。 -To add a field to the index, click on the **[+]** button. The list of fields of the selected table is displayed so that you can indicate the field to be added to the index. +インデックスにフィールドを追加するには **[+]** ボタンをクリックします。選択したテーブルのフィールドリストが表示され、インデックスに追加するフィールドを指定できます。 -- If you want to create a composite index, add each field to be included in the index successively. Once the list is completed, you can reorder the fields using the arrow buttons or using drag and drop. -- If you create a composite index based on primary key fields, make sure you put the fields in the same order in the primary key and in the index. -- If you have chosen the “Keyword Index” type, only Alpha, Text, or Picture fields can be selected. Also in this case, you can include only one field in the index. +- 複合インデックスを作成するには、インデックスに含めるフィールドを複数選択します。フィールドリストが完成したら、矢印ボタンやドラッグ＆ドロップを使用してフィールドの並びを変更できます。 +- 主キーフィールドをもとに複合インデックスを作成する場合、フィールドの並び順が主キーとインデックスとで同じ順番になるようにしてください。 +- “キーワードインデックス”タイプは文字やテキスト、またはピクチャーフィールドタイプでのみ使用できます。またこの場合、インデックスに含めることができるのは1つのフィールドのみです。 -To delete a field from the index, select it in the list and click on the **[-]** button. +インデックスからフィールドを削除するには、リスト中でそれを選択し、 **[-]** ボタンをクリックします。 -Once the index has been configured, click on **OK** to generate the index. +インデックスの設定ができたら、**OK** ボタンをクリックするとインデックスが生成されます。 -## Deleting an index in the Structure editor +## ストラクチャーエディターでインデックスを削除する -You can delete indexes that are no longer useful at any time. This can be carried out directly in the Structure editor or using the [Index List](#index-list) window. +利用しなくなったインデックスはいつでも削除できます。削除はストラクチャーエディター上で直接、または[インデックスリスト](#インデックスリスト) ウィンドウ上で行うことができます。 -To delete a standard index in the Structure editor: +ストラクチャーエディター内で標準インデックスを削除するには: -1. Select the field associated with the index you want to delete, then choose the **None** or uncheck the **Keyword Index** option (for a keyword index) in the Index menu of the **Inspector palette** - **OR** - Right-click on the field associated with the index, then choose the **None** or uncheck the **Keywords** option from the **Index>** submenu of the context menu. +1. 削除するインデックスが割り当てられているフィールドを選択し、**インスペクターパレット** のインデックスメニューから**なし** を選択するか、**キーワードインデックス** オプションのチェックを外します(キーワードインデックスの場合)。 + **または** + 削除するインデックスが割り当てられているフィールド上で右クリックし、コンテキストメニューから**インデックス>** から**なし** を選択するか、**キーワード** オプションのチェックを外します。 -The deletion (and viewing) of a composite index can only be carried out from the List Index window, see above. +複合インデックスの削除(と表示)は、リストインデックスウィンドウを通してのみ実行可能です。詳細は上記を参照してください。 -## Reindexing a field +## インデックスの再構築 -You can reindex a field at any time; in other words, rebuild the index table(s) associated with it, in accordance with the data present. This can be useful in the case of application maintenance. +フィールドのインデックスをいつでも再構築できます。これは言い換えると、そのインデックスに対応するインデックステーブルを、現在のデータを使用して再構築することを意味します。これはアプリケーションメンテナンスの際に利用できます。 -Reindexing can be carried out using the **Rebuild** command in the [Index List](#index-list) window. +インデックスの再構築は[インデックスリスト](#インデックスリスト) ウィンドウの**再構築** コマンドを使用して行います。 -Note that modifying the [data language](../settings/database.md#text-comparison) or maintenance operations such as [compacting](../MSC/compact.md) will also cause the indexes to be rebuilt. +[データ言語](../settings/database.md#テキスト比較) の変更や、データの[圧縮](../MSC/compact.md) などのメンテナンス処理においても、インデックスの再構築が行われることに留意してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-tables.md b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-tables.md index 57dae33dbf2d43..70735ccd1c37b4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-tables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Develop/structure-tables.md @@ -3,366 +3,362 @@ id: structure-tables title: テーブル --- -Tables are the foundation of every 4D database. Each table defines a collection of records that share the same set of fields and properties. In the Structure editor, tables are represented as graphic objects that you can create, rename, or delete, and whose attributes you can configure individually. +テーブルは全ての4D データベースの基盤です。それぞれのテーブルは、同じフィールドとプロパティの集合を共有するレコードの集合を定義します。ストラクチャーエディターでは、テーブルはグラフィカルなオブジェクトとして表示され、作成、名称変更、削除が可能で、またその属性を個別に設定することが可能です。 -Using the tools provided by 4D, you can: +4D が提供するツールを使用して、以下のようなことを行えます: -- Define tables and manage their primary keys and relations -- Set and edit table-level properties such as triggers, visibility, and replication -- Control naming rules and organize tables into folders for easier maintenance +- テーブルを定義し、その主キーやリレーションを管理する +- トリガ、表示状態、複製などのテーブルレベルのプロパティを設定し編集する +- 命名規則を管理しテーブルをフォルダに管理しメンテナンスを容易にする -## Creating a table +## テーブルの作成 -You can create a new table either directly in the Structure window, or via a dialog box. Direct creation is faster; but creation using the dialog box lets you specify certain parameters of the table and cancel the operation when necessary. You can also create tables using copy-paste. +直接ストラクチャウィンドウで、あるいはダイアログボックス経由で、テーブルを作成することができます。直接の作成は素早く行えますが、ダイアログボックスを 使用した作成ではテーブルの特定のパラメターを設定したり、必要であれば作成をキャンセルすることができます。またコピー/ペーストでテーブルを作成する こともできます。 -- To create a new table directly: +- 新規テーブルを直接作成するには: -1. Right-click an empty area of the Structure editor window, then choose **Add Table...** from the context menu. - **OR** - In the add objects menu of the [Structure editor toolbar](./structure-editor.md#toolbar), choose the Table option. +1. ストラクチャーエディターウィンドウの空のエリアで右クリックをし、コンテキストメニューから**テーブル追加...** を選択します。 + **または** + [ストラクチャーエディターツールバー](./structure-editor.md#ツールバー) のオブジェクト追加メニューから、テーブルを選択します。 -4D creates the table directly in the Structure editor. You can then change its name, add fields, etc. +4Dは直接ストラクチャーエディター内にテーブルを作成します。その後、名前を変更したりフィールドを追加したりできます。 :::note -If you want to put the table in a specific folder, you need to use the Home Page of the Explorer. +テーブルを特定のフォルダーに入れたい場合、エクスプローラーのホームページを使用します。 ::: -- To create a new table using the "New table" dialog box: +- “新規テーブル”ダイアログボックスを使用してテーブルを作成するには: -1. Choose **New > Table...** in the **File** menu (or in the **New** button of the 4D tool bar). - **OR** - On the Tables Page of the Explorer, click on the **\[+]** button. +1. **ファイル**メニューの **新規 > テーブル...** コマンドを選択します (または4Dツールバーの**新規**ボタンをクリックします)。 + **または** + エクスプローラーのテーブルページで、 **\[+]** ボタンをクリックします。 -The "New table" dialog box appears. 4D names the first table `Table_1` and then numbers them sequentially: +"新規テーブル"ダイアログボックスが表示されます。 4D は最初のテーブルに `Table_1` と名前をつけ、それ以降は順番に番号を振っていきます: ![](../assets/en/Develop/new-table.png) -2. (optional) Modify the [name of the table](../Concepts/identifiers.md#tables-and-fields) you want to create. -3. (optional) Specify the folder in which you want to place the new table. - By default, the table is placed at the highest level of the folder hierarchy ("Top Level"). Folders are handled in Home Page of the Explorer. -4. Click **OK** to validate. - 4D creates a new table image. It becomes the selected table image in the Structure editor window. +2. (任意) 作成する[テーブルの名称](../Concepts/identifiers.md#テーブルとフィールド) を変更します。 +3. (任意) 新しいテーブルを配置するフォルダーを選択します。 + デフォルトでテーブルはフォルダー階層のトップレベルに配置されます。フォルダーはエクスプローラーのホームページ内で管理されます。 +4. **OK** をクリックします。 + 4D は新しいテーブルイメージを作成します。それがストラクチャーエディターウィンドウ内で選択されます。 -- To create a new table by copy-paste: +- コピー/ペーストでテーブルを作成するには: -1. Select and copy the table(s) to be duplicated. -2. Paste the table(s) in the Structure editor window. +1. 複製するテーブルを選択し、コピーします。 +2. ストラクチャーウィンドウ内でテーブルを貼り付けします。 -The table is pasted with all its fields and properties. +テーブルはすべてのフィールドとプロパティとともにペーストされます。 -## Renaming a table +## テーブルの名称変更 -You can rename tables at any time. If you have used the old table name in a method, 4D automatically changes it to the new name provided the method is closed. If the method is open, you must make the changes yourself. Each table name must be unique in the database. +テーブルはいつでも名称変更できます。古いテーブル名がメソッド中で使用されていた場合、4D は自動でそれを新しい名称で置き換えます(メソッドがエディタで開かれていてはいけません)。メソッドが開かれている場合、手作業で変更を行う必要があります。データベース内でテーブル名はユ ニークでなければなりません。 -You can rename a table directly in the Structure editor, in the Explorer, or using the Inspector palette. +テーブル名の変更はストラクチャーエディター、エクスプローラー、またはインスペクターパレットを使用して直接行うことができます。 -To rename a table directly (Structure editor or Tables page of the Explorer), **click twice** on the table name (if the table is already selected, click once), so that it switches to editing mode: +(ストラクチャーエディターまたはエクスプローラーのテーブルページを使用して)テーブル名を直接変更するには、テーブル名を2回クリックし(テーブルが既に選択されている場合は1回クリック)、編集モードにスイッチします: ![](../assets/en/Develop/table-rename.png) -Enter the new name and click outside of the table. +新しい名称を入力し、テーブルの外側をクリックします。 -To rename a table using the Inspector palette of the Structure editor, double-click on the table name (or select **Table Properties...** in the context menu of the table) and enter the new name in the "Name" area. +ストラクチャーエディターのインスペクターパレットを使用して名称変更するには、テーブル名をダブルクリック(またはテーブルイメージ上で右クリックをし、コンテキストメニューから\*\*テーブルプロパティ...\*\*を選択)し、"名称"エリアに新しい名前を入力します。 ![](../assets/en/Develop/table-rename-2.png) -4D displays the name and properties of the selected table in the Inspector palette. This palette also indicates the table number. If the Inspector palette is already open but is displaying the properties of another table or another object, just select the desired table image and the palette will then display its properties. +4D はインスペクターパレット内に選択されたテーブルの名前とプロパティを表示します。このパレットにはテーブル番号も表示されます。インスペクターペレット が既に開かれていて、他のテーブルや他のオブジェクトのプロパティを表示している場合には、名称変更したいテーブルのテーブルイメージを選択すると、パ レットにそのテーブルのプロパティが表示されます。 -## Deleting a table +## テーブルの削除 -You can delete tables from your database. There are two ways of deleting tables in 4D: **permanent deletion** (the table and its data are actually removed from the database) and **non-permanent deletion** (the table is simply put into the Trash of the Explorer and may be recovered subsequently). +テーブルはデータベースから削除することができます。 4D では二つの方法でテーブルを削除できます: **恒久的削除** (テーブルおよびそのデータが実際にデータベースから取り除かれる削除) と**非恒久的削除** (テーブルが単にエクスプローラーのゴミ箱に置かれあとで元に戻すことができる削除) の二つです。 :::info -You can also remove tables using the [SQL engine of 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). +テーブルの削除は[4D のSQL エンジン](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.ja.html) を使用して行うこともできます。 ::: -### Permanent deletion +### 恒久的削除 -To permanently delete one or more database tables in the Structure editor: +ストラクチャーエディターで一つまたは複数のテーブルを恒久的に削除するには: -Select the table(s) to be deleted then choose **Clear** from the **Edit** menu or choose **Delete** from the context menu of the table. +削除するテーブルを選択し、**編集**メニューから**クリア**を選択するか、テーブルのコンテキストメニューから**削除**を選択します。 -A warning dialog box will ask you to confirm the operation. When you click **OK**, 4D carries out the following operations: +警告ダイアログが表示され、処理を続行するか確認されます。 **OK** をクリックすると、4D は以下の処理を行います: -- The table is permanently deleted from the structure. All the data associated with the table are deleted permanently from the data file. -- Any trigger method associated with the table is deleted. -- The forms and lists associated with the table are transformed into project forms and are placed in the Trash of the Explorer. +- テーブルは恒久的にストラクチャーから削除されます。またデータファイルから、そのテーブル関連するデータが恒久的に削除されます。 +- テーブルのトリガーメソッドが削除されます。 +- テーブルに関連づけられていたテーブルフォームとリストフォームはプロジェクトフォームとなり、エクスプローラーのゴミ箱に移動されます。 -### Non-permanent deletion +### 非恒久的削除 -Non-permanent deletion of a table consists in putting it in the Trash of the project (which can be accessed via the Explorer), just like the file deletion mechanisms implemented by Windows and macOS. +テーブルの非恒久的削除は、プロジェクトのゴミ箱(エクスプローラーからアクセス可能)に、削除するテーブルを移動することで行われます。これはWindows やmacOS に実装されたファイル削除のメカニズムと同様のものです。 -The table then no longer appears in the 4D editors and its contents become inaccessible but it can still be recovered so long as the Trash is not emptied. +これを行うとテーブルは4Dのエディターに表示されず、その内容にアクセスすることもできなくなりますが、ゴミ箱を空にしない限り元に戻すことが可能です。 -To put one or more tables into the Trash from the Structure editor, choose the **Move to Trash** command from the context menu of the table or select the table(s) to be deleted then press the **Delete** or **Backspace** key. A confirmation dialog box appears. If you click **OK**, the table is put into the Trash. It can be recovered at any time from the Trash Page of the Explorer. +ストラクチャーエディターから一つまたは複数のテーブルをゴミ箱に移動するには、テーブルのコンテキストメニューから**ゴミ箱に移動**コマンドを選択するか、削除するテーブルを選択し、**Delete** または**Backspace** キーを押します。確認ダイアログが表示されます。 **OK** をクリックすると、テーブルはゴミ箱に移動されます。ゴミ箱を空にしない限りエクスプローラーのゴミ箱ページからいつでも元に戻すことができます。 -### Numbers of deleted tables +### 削除されたテーブルの番号 -When a table is deleted, the other tables of the database are not renumbered, so as to avoid endangering the stability of the database. It is therefore possible, for example, to have a database with three tables numbered 2, 4 and 5. +テーブルが削除されても、データベースの安定性を損ねることを避けるために、データベース中の他のテーブルの番号は変更されません。そのため例えば3 つのテーブルがあるデータベースにおいて、それらのテーブル番号が2, 4 および 5であるといったことが起こり得ます。 -Note that the numbers of permanently deleted tables are reused when new tables are created subsequently. +恒久的に削除されたテーブルのテーブル番号は、新しくテーブルが作成されるときに再利用される点に留意してください。 -## Table properties +## テーブルプロパティ -You can set several properties for tables using the **Inspector palette** or, for certain properties, using the context menu for the tables. +**インスペクターパレット**を使用してテーブルのプロパティを設定できます。また特定のプロパティについてはテーブルのコンテキストメニューからも設定できます。 ### Triggers -A [trigger](./triggers) is a method that runs automatically when certain events related to the table occur. Trigger events can be set in the **Inspector palette** or using the context menu associated with the table (right-click on the title area of the table). Check each event for which you want to [activate the trigger](./triggers#activating-and-creating-a-trigger). +[trigger](./triggers) はテーブルに関連する特定のイベントが発生した際に自動で実行されるメソッドです。トリガーイベントは**インスペクターパレット** またはテーブルに割り当てられたコンテキストメニューを使用(テーブルのタイトルエリアを右クリック)して設定できます。[有効にしたいトリガー](./triggers#トリガーのアクティブ化と作成) のイベントにチェックします。 -You can access the trigger of a table directly from the Structure editor by clicking on the **Edit...** button in the Inspector palette or by selecting **Edit Method...** in the context submenu. You can also create and display triggers with the **Methods Page** of the Explorer. +テーブルのトリガーには、ストラクチャーエディターのテーブルインスペクターパレットで**編集...**ボタンをクリックするか、テーブルのコンテキストメニューから**メソッド編集...**サブメニューを選択します。エクスプローラーの**メソッドページ**を使用してトリガーを作成および表示ができます。 -The [information bar](./structure-editor.md#information-bar) of the **Structure editor** indicates the triggers that are activated for each table. +**ストラクチャーエディター**の[情報バー](./structure-editor.md#情報バー) には有効にされているトリガーがテーブルごとに表示されます。 ### 属性 -You can set different attributes to configure the appearance and general behavior of each table. +アピアランスや一般的な振る舞いを指定するために、テーブルごとに異なる属性を設定できます。 #### 非表示 -This option lets you make a table invisible in the Application mode and for plug-ins. You can activate this option for utility tables or tables that are not being used temporarily. +このオプションを使用して、アプリケーションモードおよびプラグインからテーブルを見えなくできます。このオプションはユーティリティテーブルや、一時的に使用しないテーブルに対して使用できます。 -Making a table invisible allows you to limit the operations that a user can perform on a table by making the table and its fields invisible in all editors and some dialog boxes that appear in the Application environment. It can also not be used by plug-ins. +テーブルを非表示にすることで、アプリケーションモードのすべてのエディター上やいくつかのダイアログボックスでそのテーブルとフィールドが非表示になり、ユーザーがテーブルに対して行うことのできる処理を制限できます。またプラグインから使用することもできなくなります。 -The editors and dialog boxes concerned in the Application environment include the following: +アプリケーションモードにおいて関連するエディターやダイアログボックスは以下の通りです: -- All query editors -- Order by editor -- [Label editor](../Desktop/labels.md) -- Quick report editor -- Exporting and importing data dialog boxes -- Formula editor +- すべてのクエリーエディター +- 並び替えエディター +- [ラベルエディター](../Desktop/labels.md) +- クイックレポートエディター +- データの読み込みと書き出しダイアログボックス +- フォーミュラエディター -In each of these editors, the user is unable to see or choose the table or any of its fields. For instance, the user cannot include any fields from an invisible table in a report or label. +これらのエディターそれぞれで、ユーザーはテーブルやそのフィールドを見たり選択したりすることはできません。例えばレポートやラベルに非表示テーブルのフィールドを含めることはできません。 :::note 注記 -- When using these editors, users have the option of saving their specifications (e.g., the query or sort they created) to disk files. In this case, any specified tables or fields that are subsequently made invisible may still be used in the operation. -- Users can type the names of invisible tables and fields in the dialog box. -- It is also possible to set this attribute for each field individually. +- これらのエディターを使用する際、ユーザーは設定をディスクファイルに保存することができます (例えば作成したクエリや並び替え設定)。その設定ファイルが使用される場合、設定が作成された後に非表示にされたテーブルやフィールドは、あとの操作でも使用することが可能です。 +- ユーザーはフォーミュラエディターダイアログボックスに非表示テーブルやフィールド名をタイプ入力することが可能です。 +- またこの属性をそれぞれのフィールドに対して個別に設定することも可能です。 ::: -Invisible tables and fields are displayed in *italics* in the Structure editor window. +非表示テーブルとフィールドはストラクチャーエディターウィンドウ内で*イタリック* で表示されます。 -#### Color of the table image +#### テーブルイメージのカラー -A color can be attributed to each table. Using colors helps to organize the structure of a large database. For example, you could use one color for all tables that relate to customers and another for tables that relate to inventory. +テーブルイメージごとにカラーを割り当てることができます。カラーを使用すると、大きなデータベースストラクチャーでグループを視認しやすくできます。例えば顧客や顧客にリレートするすべてのテーブルに同じカラーを設定し、在庫や在庫にリレートするすべてのテーブルに別のカラーを割り当てることができます。 :::note -It is also possible to attribute a color to each field individually as well as to each relation. +個々のフィールドやリレーションにカラーを割り当てることもできます。 ::: -To set the color of one or more tables, make your selection and then choose the color using: +テーブルにカラーを設定するには、テーブルを選択し、以下の方法でカラーを選択します: -- The **Color** button of the Structure editor toolbar -- The **Color** command in the context menu of the tables -- The **Color** option in the **Inspector palette** +- ストラクチャーエディターツールバーの**カラー**ボタン +- テーブルのコンテキストメニューの**カラー**コマンド +- **インスペクターパレット**の**カラー**オプション -The **Automatic** option can be used to apply the standard original color to the table. +**自動**オプションを使用すると、テーブルのデフォルトカラーが使用されます。 -#### Expose as REST resource +#### REST リソースとして公開 -This option controls whether the [table is exposed to REST requests](../REST/configuration.md#exposing-tables). +このオプションは、[テーブルがREST リクエストに対して公開されるかどうか](../REST/configuration.md#テーブルの公開) を管理します。 :::note 注記 -- You can also set this option at the level of each field of the table. -- This option is used in the context of [ORDA remote datastore features](../ORDA/remoteDatastores.md). +- このオプションは、テーブルのフィールドレベルで個別に設定することもできます。 +- このオプションは [ORDA のリモートデータストア機能](../ORDA/remoteDatastores.md)のコンテキストにおいて使用されます。 ::: -#### Records definitively deleted +#### レコードを完全に削除 -This option lets you optimize the deletion of a selection of records made using the [`DELETE SELECTION`](../commands/delete-selection) command. +このオプションを使用すると、[`DELETE SELECTION`](../commands/delete-selection) コマンドを使用して選択したレコードを削除する際の動作を最適化できます。 -When 4D deletes a selection, the record markers are also deleted. A record marker is a header attached to the record that contains information relating to this record. Deleting both markers and records is slower than deleting only records. In certain cases, it may be desirable to not automatically delete the record markers. +4Dはレコードのセレクションを削除する際、レコードマーカーも削除します。レコードマーカーはそのレコードに関連する情報を含む、レコードに添付されたヘッダーです。マーカーとレコード両方を削除するのは、レコードだけを削除するよりも時間がかかります。特定の場合においては、レコードマーカーを自動では削除しないほうに設定した方がよいこともあります。 -To accelerate the deletion of a large selection made using the [`DELETE SELECTION`](../commands/delete-selection) command, deselect the **Records definitively deleted** option. Record markers will then not be deleted. This option cannot be set by programming. +[`DELETE SELECTION`](../commands/delete-selection) を使用して実行される大量のセレクションの削除を加速するために、**レコードを完全に削除** オプションの選択を解除できます。そうするとレコードマーカーは削除されなくなります。このオプションをプログラムで設定することはできません。 -#### Enable replication +#### 複製を有効にする :::info 非推奨 -Replication and synchronize mechanisms using SQL are deprecated as of 4D 20 R3. They are still supported but it is now recommended to use the [ORDA-based Global Stamp feature](../ORDA/global-stamp.md), providing a flexible and robust solution to implement replication and synchronization in 4D. +SQL を使用した複製と同期の機構は4D 20 R3 以降は非推奨となっています。これらはまだサポートされていますが、現在は[ORDA ベースのグローバルスタンプ機能](../ORDA/global-stamp.md) を使用することが推奨されます。この機能は4D 内において複製と同期を実装するための柔軟で堅牢なソリューションを提供します。 ::: -#### Include in Log File +#### ログファイルに含める -By default, this option is checked for all new tables created and for all tables in converted databases. Check this option in order for operations performed on the table’s data to be included in the [database log file](../Backup/log.md) (when it is generated). +このオプションは、作成された全ての新しいテーブルと変換されたデータベースにおいては、デフォルトでチェックがされています。テーブルのデータに対して行われたオペレーションを、全て[データベースのログファイル](../Backup/log.md)(作成時)に含めたい場合にはこのオプションにチェックを入れて下さい。 -This option must generally be checked for most tables. However, for optimization purposes, you can uncheck it, for example for temporary tables or tables used for importing data. +このオプションは一般的に、ほとんどのテーブルにおいてチェックされるべきものです。しかしながら、最適化の観点から、例えばデータをインポートするために一時的に使用するテーブルなどではチェックを外すこともできます。 -It is important to note that this option only indicates that the table’s data must be journaled if the database uses a log file; it does not enable the journaling procedure itself at the database level. +このオプションは、データベースがログファイルを使用する場合には、そのテーブルのデータがログに記録されなければならないという指示にすぎず、データベースレベルでのデータログ処理そのものを有効化するスイッチではないということに留意して下さい。 :::note 注記 -- This option is grayed out when the table does not have a primary key. -- 4D displays a warning icon to the right of the **Include in Log File** option when the required conditions are not met. As long as this icon is shown, journaling is not yet enabled. +- このオプションはテーブルがプライマリーキーを持っていない場合にはグレーになって選択することができません。 +- 必要要件を満たしていない場合は、**ログファイルに含める** のオプションの横に警告アイコンが表示されます。このアイコンが表示されている限り、データログは有効化されていません。 ::: -#### Encryptable +#### 暗号化可能 -This option controls whether the data stored in the table must be encrypted on disk when [data file encryption is enabled](../MSC/encrypt.md). +このオプションは、[データファイル暗号化が有効化された](../MSC/encrypt.md) 際に、テーブルに保存されたデータがディスク上で暗号化されるべきかどうかを管理します。 -Since encrypting/decrypting can be time consuming, selecting the tables to encrypt allows you to optimize the performance of encrypted databases. For example, you could set only the tables that contain personal data as **Encryptable**. +暗号化 / 復号化は時間がかかることがあるため、暗号化するテーブルを選択することで暗号化されたデータベースの操作を最適化することができます。例えば、個人データを格納しているデータのみを**暗号化可能**に設定する、とすることが可能です。 -Note that this option flags table(s); it does not perform any encryption or decryption operation. To actually encrypt or decrypt selected table(s) in the data file, you must use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command. +このオプションはテーブルにフラグを立てるだけであり、実際の暗号化/復号化操作を実行するわけではないことに注意してください。実際にデータファイル内で選択されたテーブルを暗号化あるいは復号化するためには、[MSC](../MSC/encrypt.md) あるいは[`Encrypt data file`](../commands/encrypt-data-file) コマンドを使用しなければなりません。 :::warning -- When you modify the value of this option for a table in an already encrypted database, you must also use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command to preserve data consistency. Otherwise, you will not be allowed to save data in the modified table (errors will be returned by 4D when trying to save records). -- Encryption of data stored outside of the data file is not managed by this option. +- 既に暗号化されているデータベース内でこのオプションの値を変更した場合、データの一貫性を保つために必ず[MSC](../MSC/encrypt.md) か[`Encrypt data file`](../commands/encrypt-data-file) コマンドを使用しなければなりません。使用しない場合、編集したテーブル内にデータを保存することができません(レコードを保存しようとした場合、4D はエラーを返します)。 +- データファイルの外部に保存されているデータの暗号化は、このオプションによる管理できません。 ::: ### コメント -The **Comments** area of the **Inspector palette** lets you store additional information about the table. These comments are available for all the developers. Note that each field and each relation has its own comments area. +**インスペクターパレット**の**コメント**エリアにはテーブルに関する追加の情報を格納できます。このコメントはすべての開発者が利用できます。各フィールドおよびリレーションごとにコメントエリアがあります。 ### SQL -- The "Schemas" menu lists all the SQL schemas specified in the database. You can use this menu to set the schema to which the table will belong (it is also possible to modify this property via SQL commands). Every database has at least one schema, named **DEFAULT_SCHEMA**. By default, all the tables belong to this schema. For more information about SQL schemas, refer to the [**Schemas** section](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) in the *4D SQL Reference guide*. -- The information area indicates whether the name of the table respects the rules regarding SQL nomenclature (for example, unlike 4D, SQL does not allow a field name to contain spaces). +- “スキーマ”メニューにはデータベースに定義されたすべてのSQL スキーマが一覧されます。このメニューを使用して、テーブルが属するスキーマを指定できます (このプロパティはSQL コマンドを使用して変更することもできます)。すべてのデータベースには最低1つの、**DEFAULT_SCHEMA** という名前のスキーマがあります。デフォルトですべてのテーブルはこのスキーマに属します。 SQL スキーマに関する詳細は*4D SQL リファレンス* の[**スキーマ** の章](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.ja.html#148386) を参照してください。 +- 情報エリアは、テーブル名がSQL の命名規則に沿っているかどうかを表示します (例えば4D と異なり、SQL ではフィールド名にスペースを含めることはできません)。 -### Primary keys +### プライマリーキー(主キー) -A primary key designates the field(s) used for uniquely identifying the records in a table. Setting a primary key is necessary for the [journaling features](../Backup/log.md). +プライマリーキー(主キー)は、テーブル内のレコードを個別に識別するために使用されるフィールドを指定します。[データログ機能](../Backup/log.md) を使用するためにはプライマリーキーを設定しなければなりません。 -You create, edit and/or remove primary keys directly using the context menu of the Structure editor or the [Primary key manager](#primary-key-manager). +ストラクチャーエディターのコンテキストメニューまたは[プライマリーキーマネージャー](#プライマリーキー-主キー-マネージャー) を使用して、直接プライマリーキーを作成/編集/削除することができます。 -> **Note:** Primary keys can also be set using the SQL language by means of the **PRIMARY KEY** clause followed by the list of columns. +> **注:** プライマリーキーは、SQL ランゲージにて**PRIMARY KEY** 節のあとカラムのリストを記述することでも作成することができます。 -#### Rules for using primary key fields +#### プライマリーキーフィールドの使用ルール -Primary key fields should be handled with care to ensure data integrity at all times. In particular, a primary key field must respect the following rules: +プライマリーキーフィールドは、データの整合性を保証するために常に細心の注意で管理すべきものです。具体的には、プライマリーキーフィールドは以下のルールを遵守する必要があります: -- it must not be empty, -- it must be unique, -- once created, it should (in principle) never be modified, especially if: - - [Global stamp features](../ORDA/global-stamp.md) are enabled, - - [REST (or similar) feature](../REST/gettingStarted.md) is enabled, - - the database is periodically synchronized (backup or logical mirror using the [log file](../Backup/log.md)). +- 空であってはいけません。 +- 固有(重複不可)でなければなりません。 +- 一度作成されたら、原則として変更してはなりません。以下のような場合には絶対変更してなりません: + - [グローバルスタンプ機能](../ORDA/global-stamp.md) が有効化されている + - [REST (あるいはそれに似た)機能](../REST/gettingStarted.md) が有効化されている + - データベースが([ログファイル](../Backup/log.md) を使用したバックアップあるいは論理ミラーを使用して)定期的に同期されている。 -Modifying primary key field value is highly discouraged, even if 4D allows it for specific use cases. -If you absolutely need to modify a primary key value (e.g. you used a social security number field as primary key and incorrect values have been entered), it is preferable to disable (remove) the current primary key and to add a new field used as primary key with automatic assignment. +プライマリーキーフィールドを変更することは、たとえ4D が特殊な場合に対して許可しているとしても、変更しないことが強く推奨されます。 +どうしてもプライマリーキーフィールドを変更しなくてはいけない場合(例：マイナンバーをプライマリーキーとして指定してしまい、誤った番号を入力してしまった、等)でも、変更する代わりにカレントのプライマリーキーを無効化(削除)して自動割り当てをつけた新しいフィールドを追加してプライマリーキーフィールドとして使用する方が望ましいです。 -Primary key fields can be long integer type or UUID format (alpha type). In most cases, we recommend the UUID format with the Auto UUID option enabled. Even though the long integer type takes up less disk space, UUIDs have many advantages, for example, facilitating the merge of independent databases, data import/export, implementation of elaborate mirror/replication strategies or synchronization with external systems. +プライマリーキーフィールドは、倍長整数型がUUIDフォーマット(文字型)が選べます。多くの場合、自動UUIDオプションを有効化したUUIDフォーマットの方が推奨されます。倍長整数型の方が使用するディスク容量が小さいのですが、UUID には他の多くの利点があります。例えば、独立したデータベースの統合が容易であったり、データの読み込み/書き出し、精巧なミラー/複製戦略の実装、あるいは外部システムとの同期、などにおいて有利です。 -#### Setting primary keys +#### プライマリーキーの設定 -To create a primary key from the Structure editor: +ストラクチャーエディターからプライマリーキーを作成するためには、以下の手順に従って下さい: -1. Select the field(s) that make up the table’s primary key. -2. Right-click and choose **Create primary key** in the context menu (this command is only displayed for fields whose type is eligible for primary keys). +1. テーブルのプライマリーキーを構成するフィールド(複数も可)を選択します。 +2. 右クリックでコンテキストメニューを表示し、**主キーを作成**を選択します(このコマンドは主キーとして使用可能な型のフィールドに対してのみ表示されます)。 -You cannot have more than one primary key for each table. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. +一つのテーブルにつき二つ以上のプライマリーキーを作成することはできません。プライマリーキーが既にテーブルにおいて指定されている場合、既存のプライマリーキーは無効化されるという旨の警告ダイアログボックスが表示されます。 -The primary key is created immediately. Fields included in the primary key are *underlined* in the editor and their SQL description displays the **PRIMARY KEY** keyword. +プライマリーキーは直ちに作成されます。プライマリーキーに含まれるフィールドはエディター上では下線が引かれ、インスペクターのSQL の詳細には**PRIMARY KEY** のキーワードが入ります。 -When you create a primary key in a table that already contains records (using an existing field or adding a new one), 4D checks the conformity of all the values present or automatically performs updating operations: +既にレコードが存在するテーブルに主キーを作成した場合(既存フィールドを使用、あるいは新規に追加した場合)、4D は存在している全ての値の適合性をチェックするか、あるいは自動的にアップデート操作を実行します: -- The field(s) belonging to the primary key cannot contain any duplicated values. If any duplicated values for the key exist in the table records, a warning dialog box appears to indicate that it is not possible to create the key because of this. -- If the duplicated values are blank or null values (case of an added key field), you can check the corresponding automatic generation option (for Alpha fields in or for Longint fields). - In this case, 4D examines all the records of the table and automatically assigns a calculated value to each primary key. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. +- 主キーに属しているフィールド内では重複している値を持つ事はできません。テーブルのレコード内に重複している値が存在していた場合、この値の為に主キーを作成する事ができない旨を示す警告ダイアログボックスが表示されます。 +- 重複した値が空の値、またはヌル値(追加されたフィールド)だった場合、それに対応する自動生成オプションをチェックする事ができます(文字フィールドでの自動UUID、または倍長整数フィールドでの自動インクリメント)。 + この場合、4D はテーブルの全てのレコードを検査し計算された値をそれぞれの主キーに自動的に割り当てます。ただし処理はシーケンシャルであり、レコードの数が大量であった場合、この処理に長い時間を要することがあるという点に注意して下さい。 -> **Note:** The column(s) belonging to the primary key do not accept NULL values. +> **注:** プライマリーキーに所属するカラムは、ヌル値を受け付けません。 -#### Removing primary keys +#### プライマリーキーの削除 -To remove a primary key from a table: +テーブルからプライマリーキーを削除するためには、以下の手順に従って下さい: -1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu: +1. プライマリーキーを含むテーブルを右クリックしてコンテキストメニューを表示し、**主キーを削除**を選択します。確認ダイアログが表示されます。プライマリーキーを削除するためには**OK**をクリックします。 -[picture here] +#### デフォルトのプライマリーキーフィールド -A confirmation dialog box appears. Click **OK** to remove the primary key. +新規に作成されるテーブルには全てデフォルトでプライマリーキーが含まれています。このフィールドは、デフォルトで名前が **"ID"** の倍長整数型のフィールドであり、特に以下の属性を持ちます: -#### Default primary key field +- 重複不可 +- ヌル値の入力を拒否 +- 自動インクリメント +- 自動インデックス -Every new table created in the database contains a primary key by default. This field, named **"ID"** by default, is of the Longint type, and has, in particular, the following attributes: - -- Unique, -- Reject NULL value input, -- Autoincrement, -- Automatic index. - -You can use this field as is, or change its name and/or its properties if you want (for example, you may want to use an UUID field). You can also delete it if you want to use another field (or fields) as primary key(s). However, it is strongly recommended to keep at least one primary key in each 4D table. +このフィールドはそのまま使用することもできますし、必要に応じて名前やプロパティを変更する事もできます (例えば UUID フィールドを使用する等)。また、他のフィールドをプライマリーキーとして使用する場合はプライマリーキーを削除することはできます。ただし、全ての 4D テーブルに最低一つずつプライマリーキーを用意しておくことが強く推奨されます。 :::note -In the [Structure page of the Preferences](../Preferences/structure.md), you can modify the name and type of the primary keys that are created by default. +[環境設定のストラクチャーページ](../Preferences/structure.md) にて、プライマリーキーのデフォルトの名前と型を変更することができます。 ::: :::info -Default primary keys are not added to tables that are created using the SQL **CREATE TABLE** command, or tables that are imported into the database. +デフォルトのプライマリーキーは、SQL **CREATE TABLE** コマンドを使用して作成されたテーブルやデータベースにインポートされたテーブルには追加されません。 ::: ## プライマリーキー(主キー)マネージャー -The **Primary key manager** is an assistant intended to facilitate the resolution of errors related to the presence of tables without primary keys, particularly in the context of a journaled database: +**プライマリーキー管理** (プライマリーキーマネージャー)というアシスタントウィンドウは、特にログを使用しているデータベースにおいて、プライマリーキーがないテーブルに起因するエラーの解消を手助けするためのものです: ![](../assets/en/Develop/pk-manager.png) -You can use this assistant to: +このアシスタントには以下の様な機能があります: -- diagnose the compatibility of each database table with the 4D journaling mechanism, -- propose a correction for each table found that is not compatible, more particularly by creating a primary key. +- データベースのそれぞれのテーブルと 4D のデータログのメカニズムとの競合性を検証します。 +- データログのメカニズム合致しないテーブルに対してそれぞれに解決方法を提示します。具体的にはプライマリーキーの作成です。 -### Accessing assistant +### アシスタントを表示 -There are two ways to display the **Primary key manager** window: +**プライマリーキー管理** ウィンドウを表示する方法は二通りあります: -- From the **Primary key error window**: click on the **Run assistant** button to display the assistant window. +- **プライマリーキーエラーウィンドウ** から表示: **アシスタントを起動**ボタンをクリックしてアシスタントウィンドウを表示します。 -**Note:** The Primary key manager is displayed in Design mode. If the database starts in Application mode, the assistant does not appear right away and you will need to switch to Design mode. +**注:** プライマリーキー管理はデザインモードで表示されます。データベースがアプリケーションモードで開かれた場合はアシスタントは直ちには表示されず、デザインモードへと切り替える必要があります。 -- From the **Structure editor**: click on the button in the [toolbar](./structure-editor.md#toolbar) of this window to display the assistant. +- **ストラクチャーエディター**から: ウィンドウの[ツールバー](./structure-editor.md#ツールバー) 内の新しいボタン をクリックするとアシスタントを表示できます。 -### Using the assistant +### アシスタントの使用 -The **Primary key manager** window displays a line for every table in the database: +**プライマリーキー管理**ウィンドウではデータベース内の全てのテーブルに関しての情報が行となって表示されます: ![](../assets/en/Develop/pk-1.png) -The assistant does not take tables placed in the Trash into account. +アシスタントはごみ箱に入っているテーブルは検知しません。 -The icon at the head of each line indicates whether the table requires the attention of the user: +それぞれの行の先頭にあるアイコンはテーブルの状態をユーザーに知らせます: -| アイコン | ステータス | 説明 | -| -------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ![](../assets/en/Develop/pk-icon1.png) | OK | A valid primary key is set for the table. | -| ![](../assets/en/Develop/pk-icon2.png) | No primary key, eligible field(s) | The table does not have a primary key but contains at least one field that could become the primary key. | -| ![](../assets/en/Develop/pk-icon3.png) | No primary key, no eligible fields | The table does not have a primary key and does not have any fields that could become one (you will have to create a primary key field). | -| ![](../assets/en/Develop/pk-icon4.png) | 警告 | The table does not have a primary key but it is not journaled ("Include in Log File" option disabled for the table). It is possible to hide tables that have this status by unchecking the option to display warnings. | +| アイコン | ステータス | 説明 | +| -------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| ![](../assets/en/Develop/pk-icon1.png) | OK | テーブルには有効なプライマリーキーがあります。 | +| ![](../assets/en/Develop/pk-icon2.png) | プライマリーキーなし、使用可能なフィールド有り | テーブルにはプライマリーキーがないものの、プライマリーキーとして使用できるフィールドが少なくとも一つは含まれています。 | +| ![](../assets/en/Develop/pk-icon3.png) | プライマリーキーも使用可能なフィールドもなし | テーブルにはプライマリーキーも、プライマリーキーとして使用できるフィールドもありません(プライマリーキーフィールドを作成する必要があります)。 | +| ![](../assets/en/Develop/pk-icon4.png) | 警告 | テーブルにはプライマリーキーがありませんが、データのログを取りません("ログファイルに含める"のオプションのチェックが外されています)。この状態のテーブルは、警告アイコンをクリックすることによって非表示にできます。 | -For each journaled table that does not have a primary key, the assistant displays a menu to set the action to be performed. You can choose from the following options: +データログを残すテーブルでプライマリーキーがないものに関して、アシスタントはそれぞれに実行すべきアクションを表示します。以下の選択肢から選ぶことができます: -- **Ignore:** does not modify the table. The errors are not corrected and the status of the table is not changed. Use this option if you wish to intervene later, or if you want to create the primary key outside of the assistant. This option is necessary in particular when you want to create a primary key based on several fields in the table. +- **無視:** テーブルに何も変更を加えません。エラーは修正されず、テーブルの状態は変更されません。後でエラーを修正したい場合、またはアシスタントを使用せずにエラーを修正したい場合などにはこのオプションを選択して下さい。このオプションは特に、複数のテーブルをもとにプライマリーキーを作成したい場合に必要です。 -- **Use existing field** (only shown for tables with at least one field eligible to be a primary key): designates one of the table fields as the primary key. When you choose this option, the assistant suggests the most appropriate field by default. If you want to use another field or if the assistant fails to identify a particularly suitable field (the assistant displays *Select a field*), click on the second menu in the row to display the list of eligible fields. +- **既存のフィールドを使用**(プライマリーキーとして使用可能なフィールドが少なくとも一つはあるテーブルにおいてのみ表示): テーブルのフィールドのどれかをプライマリーキーとして指定します。このオプションを選択すると、アシスタントはデフォルトでプライマリーキーとして最適なフィールドを選択して提示します。他のフィールドを使用したい場合、またはアシスタントが適切なフィールドを識別するのに失敗した場合(この場合アシスタントは *選択可能なフィールド* を表示します) などは、行の中の二つ目のメニューをクリックして選択可能なフィールドのリストを表示して下さい。 -- **Create a new field:** creates a new primary key field in the table. This field will have the same characteristics as the one [added by default when a new table is created](#default-primary-key-field). By default, the assistant proposes to create a field of the Longint type, named “ID”. You can modify the name and type of default primary key fields in the [Preferences](../Preferences/structure.md#primary-key). You can also change the name and/or type of the field directly in the Primary key manager window. +- **新規フィールドを作成:** テーブル内に新しいプライマリーキーを作成します。このフィールドは[新規テーブルが作成されたときのもの](#デフォルトのプライマリーキーフィールド) と同じ属性を持ちます。デフォルトでは、アシスタントは "ID" という名前の倍長整数型のフィールドが提示されます。このデフォルトのプライマリーキーの名前と型は[環境設定](../Preferences/structure.md#プライマリーキー)から変更することができます。プライマリーキー管理ウィンドウ内で直接テーブルの名前/型を変更することもできます。 -- **Do not log this table:** unchecks the [**Include in Log File**](#include-in-log-file) option for the table. You can choose this option in the case of temporary tables. After you validate this dialog box, a “Warning” status is assigned to the table. +- **このテーブルはログに含めない:** このテーブルに関しては[**ログファイルに含める**](#ログファイルに含める) のチェックを外します。一時的なテーブルなどの場合にこのオプションを選択することができます。ダイアログボックスを確定させると、"警告"の状態がテーブルへと適用されできます。 -Once you have made your settings, click on **Apply...** to apply the changes to the database or **Close** to close the dialog box without modifying the database. When you click on **Apply...**, a confirmation dialog box appears listing the operations to be performed; you can either confirm or cancel the operation. +設定が完了したら**適用...** をクリックして変更をデータベースに適用するか、データベースを変更せずに閉じる場合には**閉じる**をクリックして下さい。**適用...** をクリックすると、実行されるオペレーションの一覧がダイアログボックスに表示され、適用かキャンセルがクリックできます。 -If you have designated existing fields as primary keys, 4D checks each table to make sure that its existing data respects the rules concerning uniqueness and null values for this type of field. If, for example, a field contains duplicate values or null values, an error is generated. You will need to find and remove these anomalies before you can enable journaling for the data. +既存のフィールドをプライマリーキーとして使用した場合、4D はそれぞれのテーブルに関して、既存のデータがそのフィールドの型の固有性やヌル値の設定とあてはまるかどうかを検証します。もし、例えばフィールドが複製値やヌル値を含んでいた場合、エラーが生成されます。データログを有効にするためにはこれらのエラーを探して削除する必要があります。 :::note -In order to facilitate the correction of errors related to primary keys, the primary key values are displayed in the [**Activity analysis** page of the Maintenance and Security Center](../MSC/analysis.md). +プライマリーキーに関するエラーの修正を容易にするために、プライマリーキーの値は[MSCの **アクティビティ解析ページ**](../MSC/analysis.md) の中に表示されています。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md index 76ddea797f7bfe..ff8eaa6d2868fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/onAfterEdit.md @@ -62,11 +62,11 @@ title: On After Edit #### action = DragFillBlock -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | 自動入力のために使用されるレンジ | -| autoFillType | longint | 自動入力のために使用される値。
  • 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | -| fillDirection | longint | フィルの方向
  • フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | +| プロパティ | 型 | 説明 | +| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | 自動入力のために使用されるレンジ | +| autoFillType | longint | 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | +| fillDirection | longint | フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | #### action = formulaChanged diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md index 4199e1678f8fd5..5a10667da64faf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Extensions/develop-components.md @@ -17,7 +17,7 @@ title: コンポーネントの開発 :::note -他の別のマトリックスプロジェクトを開くことなく、[ホストプロジェクトから直接コンポーネントを作成](#コンポーネントの作成) することができます。 +他の別のマトリクスプロジェクトを開くことなく、[ホストプロジェクトから直接コンポーネントを作成](#コンポーネントの作成) することができます。 ::: @@ -260,19 +260,19 @@ $rect:=cs.eGeometry._Rectangle.new(10;20) [コンポーネント名前空間](#コンポーネント名前空間の宣言) を入力しない場合、シンタックスファイル生成のオプションがチェックされていても、クラスや公開メソッド用のリソースは生成されません。 -When your class functions and class constructors are documented with a [comment block above their declaration](../Concepts/classes.md#function-comments), the syntax file also contains their description and parameter comments (`MCP:` lines are never included). Host projects then display them as plain text in the code completion and help of the compiled component. For example, with the following function in a component class: +クラス関数やクラスコンストラクターが[宣言部分の上にあるコメントブロック内にドキュメントが記述されている](../Concepts/classes.md#関数コメント) 場合、シンタックスファイルにはその詳細と引数のコメントが含まれます(`MCP:` の行が含まれることはありません)。ホストプロジェクトはそれらをコード保管の中に平文テキストとして表示し、またコンパイルされたコンポーネントのヘルプにも表示します。例えば、コンポーネントのクラスに以下のような関数があった場合: ```4d // Class: Tools -// Scales a value by a factor -// $value: value to scale -// $factor: multiplier to apply +// 値を指定された倍数で増幅する +// $value: 増幅する値 +// $factor: 適用する倍率 Function scale($value : Real; $factor : Real) : Real return $value*$factor ``` -a host project that types `cs.MyComponent.Tools.new().scale(` sees "Scales a value by a factor" and the `$value:` and `$factor:` lines below the signature. +ホストプロジェクトにおいて`cs.MyComponent.Tools.new().scale(` と入力すると、その署名の下に"値を指定された倍数で増幅する" および `$value:` と `$factor:` の行が表示されます。 ## 変数の渡し方 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/pictures.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/pictures.md index 0d21d56de45194..d7e13327bd0267 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/pictures.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/pictures.md @@ -57,10 +57,10 @@ title: ピクチャー 高解像度が自動的に優先されますが、スクリーンやピクチャーの dpi *(\*)*、およびピクチャー形式によって、動作に違いが生じることがあります: -| 演算 | 動作 | -| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
  • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
  • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    • | -| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | +| 演算 | 動作 | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    | +| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | *(\*) 通常は macOS = 72dpi, Windows = 96dpi* diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Action.md index 6d9cbd7c33c021..e4a5e1851c7b3f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_Action.md @@ -5,7 +5,7 @@ title: 動作 ## メソッド -フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 +フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 メソッドが関連づけられているフォームに関わるイベントが発生した場合、4D は自動的にフォームメソッドを呼び出します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormProperties.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormProperties.md index 573e0869ca0eb3..df6571c758adc6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormProperties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormEditor/properties_FormProperties.md @@ -33,9 +33,9 @@ title: フォームプロパティ #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| --- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| css | string または collection | CSS file path(s) provided as:
  • a string (a file for both platforms)
  • a collection of strings (a list of files for both platform)
  • a collection of {"path":string;"media":"mac" | "windows"} objects
    • | +| 名称 | データタイプ | とりうる値 | +| --- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| css | string または collection | CSSファイルパス:
  • 文字列 (両方のプラットフォーム用に 1ファイル)
  • 文字列のコレクション (両プラットフォーム用のファイルのリスト)
  • {"path":string;"media":"mac" | "windows"} オブジェクトのコレクション
    • | --- diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md index e43126adf81519..e596055f56a975 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md @@ -28,7 +28,25 @@ title: ボタングリッド ## プロパティ一覧 -[Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Columns](properties_Crop.md#columns) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Rows](properties_Crop.md#rows) - [Standard action](properties_Action.md#standard-action) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Width](properties_CoordinatesAndSizing.md#width) - [Visibility](properties_Display.md#visibility) +¥[タイプ](properties_Object.md#タイプ) - +[オブジェクト名](properties_Object.md#オブジェクト名) - +[変数あるいは式](properties_Object.md#変数あるいは式) - +[CSSクラス](properties_Object.md#cssクラス) - +[行](properties_Crop.md#行) - +[列](properties_Crop.md#列) - +[左](properties_CoordinatesAndSizing.md#左) - +[上](properties_CoordinatesAndSizing.md#上) - +[右](properties_CoordinatesAndSizing.md#右) - +[下](properties_CoordinatesAndSizing.md#下) - +[幅](properties_CoordinatesAndSizing.md#幅) - +[高さ](properties_CoordinatesAndSizing.md#高さ) - +[横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - +[縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - +[表示状態](properties_Display.md#表示状態) - +[境界線カラー](./properties_BackgroundAndBorder.md#border-color) - +[境界線スタイル](properties_BackgroundAndBorder.md#border-line-style) - +[ヘルプTips](properties_Help.md#ヘルプtips) - +[標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/dropdownList_Overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/dropdownList_Overview.md index d2ce308c14c9e5..03c56440836808 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/dropdownList_Overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/dropdownList_Overview.md @@ -165,7 +165,7 @@ Form.myDrop.index //3 ## プロパティ一覧 -[Alpha Format](properties_Display.md#alpha-format) - [Bold](properties_Text.md#bold) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Data Type (expression type)](properties_DataSource.md#data-type-expression-type) - [Data Type (list)](properties_DataSource.md#data-type-list) - [Date Format](properties_Display.md#date-format) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Not rendered](properties_Display.md#not-rendered) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Standard action](properties_Action.md#standard-action) - [Save value](properties_Object.md#save-value) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [値を記憶](properties_Object.md#値を記憶) - [CSSクラス](properties_Object.md#cssクラス) - [データタイプ (セレクションおよびコレクションリストボックス列)](properties_DataSource.md#データタイプ-(リスト)) - [データタイプ](properties_DataSource.md#データタイプ-リスト) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [文字フォーマット](properties_Display.md#文字フォーマット) - [日付フォーマット](properties_Display.md#日付フォーマット) - [時間フォーマット](properties_Display.md#時間フォーマット) - [表示状態](properties_Display.md#表示状態) - [レンダリングしない](properties_Display.md#レンダリングしない) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [横揃え](properties_Text.md#横揃え) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index 88276225178be4..fd94cf34329db2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -145,7 +145,7 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) ## プロパティ一覧 -[Bold](properties_Text.md#bold) - [Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Draggable](properties_Action.md#draggable) - [Droppable](properties_Action.md#droppable) - [Enterable](properties_Entry.md#enterable) - [Entry Filter](properties_Entry.md#entry-filter) - [Fill Color](properties_BackgroundAndBorder.md#background-color--fill-color) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Hide focus rectangle](properties_Appearance.md#hide-focus-rectangle) - [Horizontal Scroll Bar](properties_Appearance.md#horizontal-scroll-bar) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Multi-selectable](properties_Action.md#multi-selectable) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Vertical Scroll Bar](properties_Appearance.md#vertical-scroll-bar) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [CSSクラス](properties_Object.md#cssクラス) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [入力可](properties_Entry.md#入力可) - [フォーカス可](properties_Entry.md#フォーカス可) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [表示状態](properties_Display.md#表示状態) - [フォーカスの四角を隠す](properties_Appearance.md#フォーカスの四角を隠す) - [横スクロールバー](properties_Appearance.md#横スクロールバー) - [縦スクロールバー](properties_Appearance.md#縦スクロールバー) - [塗りカラー](properties_BackgroundAndBorder.md#背景色-塗りカラー) - [境界線カラー](./properties_BackgroundAndBorder.md#境界線カラー) - [境界線スタイル](properties_BackgroundAndBorder.md#border-line-style) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [ドラッグ有効](properties_Action.md#ドラッグ有効) - [ドロップ有効](properties_Action.md#ドロップ有効) - [複数選択可](properties_Action.md#複数選択可) - [ヘルプTips](properties_Help.md#ヘルプtips) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox-object.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox-object.md index 661b8c6161573e..40ffa3326faa80 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox-object.md @@ -27,7 +27,7 @@ LIST TO ARRAY("ListName";varCol) ## セレクションリストボックス -このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+“ ”[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 +このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+" "[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 それぞれの行はセレクションのレコードを基に評価されます。セレクションは **カレントセレクション** または **命名セレクション**です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md index b5221f8ba1c50b..b1895b698f6a10 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md @@ -241,14 +241,14 @@ JSON フォームにおいて、リストボックスに次のハイライトセ 標準ソートのサポートは、リストボックスのタイプに依存します: -| リストボックスタイプ | 標準ソートのサポート | コメント | -| ------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | -| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | -| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。 この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照) | -| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | -| 命名セレクション | × | | -| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | +| リストボックスタイプ | 標準ソートのサポート | コメント | +| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | +| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | +| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    | +| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | +| 命名セレクション | × | | +| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | ### カスタムソート @@ -368,7 +368,7 @@ End if ### プレビューモード -プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。 とくに、表示されている以上の行を印刷することはできません。 +プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。とくに、表示されている以上の行を印刷することはできません。 ### 詳細モード diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pictureButton_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pictureButton_overview.md index 848e55ef1e4e7e..e4c2dce8b83f0c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pictureButton_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pictureButton_overview.md @@ -60,7 +60,7 @@ title: ピクチャーボタン ## プロパティ一覧 -[Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Button Style](properties_TextAndPicture.md#button-style) - [Class](properties_Object.md#css-class) - [Columns](properties_Crop.md#columns) - [Focusable](properties_Entry.md#focusable) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Loop back to first frame](properties_Animation.md#loop-back-to-first-frame) - [Object Name](properties_Object.md#object-name) - [Pathname](properties_Picture.md#pathname) - [Right](properties_CoordinatesAndSizing.md#right) - [Rows](properties_Crop.md#rows) - [Shortcut](properties_Entry.md#shortcut) - [Standard action](properties_Action.md#standard-action) - [Switch back when released](properties_Animation.md#switch-back-when-released) - [Switch continuously on clicks](properties_Animation.md#switch-continuously-on-clicks) - [Switch every x seconds](properties_Animation.md#switch-every-x-seconds) - [Title](properties_Object.md#title) - [Switch when roll over](properties_Animation.md#switch-when-roll-over) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Use Last frame as disabled](properties_Animation.md#use-last-frame-as-disabled) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [タイトル](properties_Object.md#タイトル) - [CSSクラス](properties_Object.md#cssクラス) - [ボタンスタイル](properties_TextAndPicture.md#ボタンスタイル) - [パス名](properties_Picture.md#パス名) - [マウス押下中は自動更新](properties_Animation.md#マウス押下中は自動更新) - [先頭フレームに戻る](properties_Animation.md#先頭フレームに戻る) - [ロールオーバー効果](properties_Animation.md#ロールオーバー効果) - [無効時に最終フレームを使用](properties_Animation.md#無効時に最終フレームを使用) - [アニメーション間隔 (tick)](properties_Animation.md#アニメーション間隔-tick) - [行](properties_Crop.md#行) - [列](properties_Crop.md#列) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [ショートカット](properties_Entry.md#ショートカット) - [フォーカス可](properties_Entry.md#フォーカス可) - [表示状態](properties_Display.md#表示状態) - [境界線カラー](./properties_BackgroundAndBorder.md#境界線カラー) - [境界線スタイル](properties_BackgroundAndBorder.md#border-line-style) - [イタリック](properties_Text.md#イタリック) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md index 72c03b3f377a79..0803087d378973 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md @@ -23,7 +23,27 @@ title: ピクチャーポップアップメニュー ## プロパティ一覧 -[Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) -[Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Columns](properties_Crop.md#columns) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Left](properties_CoordinatesAndSizing.md#left) - [Object Name](properties_Object.md#object-name) - [Pathname](properties_Picture.md#pathname) - [Right](properties_CoordinatesAndSizing.md#right) - [Rows](properties_Crop.md#rows)- [Standard action](properties_Action.md#standard-action) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - +[オブジェクト名](properties_Object.md#オブジェクト名) - +[変数あるいは式](properties_Object.md#変数あるいは式) - +[CSSクラス](properties_Object.md#cssクラス) - +[パス名](properties_Picture.md#パス名) - +[行](properties_Crop.md#行) - +[列](properties_Crop.md#列) - +[左](properties_CoordinatesAndSizing.md#左) - +[上](properties_CoordinatesAndSizing.md#上) - +[右](properties_CoordinatesAndSizing.md#右) - +[下](properties_CoordinatesAndSizing.md#下) - +[幅](properties_CoordinatesAndSizing.md#幅) - +[高さ](properties_CoordinatesAndSizing.md#高さ) - +[横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - +[縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - +[表示状態](properties_Display.md#表示状態) - +[境界線カラー](./properties_BackgroundAndBorder.md#境界線カラー) - +[境界線スタイル](properties_BackgroundAndBorder.md#境界線スタイル) - +[太字](properties_Text.md#太字) - +[ヘルプTips](properties_Help.md#ヘルプtips) - +[標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pluginArea_overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pluginArea_overview.md index 0a12aba9dcd421..9637bfb4d8e6ce 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pluginArea_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/pluginArea_overview.md @@ -19,7 +19,7 @@ title: プラグインエリア ## プロパティ一覧 -[Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Advanced Properties](properties_Plugins.md) - [Class](properties_Object.md#css-class) - [Draggable](properties_Action.md#draggable) - [Droppable](properties_Action.md#droppable) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Height](properties_CoordinatesAndSizing.md#height) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Left](properties_CoordinatesAndSizing.md#left) - [Method](properties_Action.md#method) - [Object Name](properties_Object.md#object-name) - [Plug-in Kind](properties_Object.md#plug-in-kind) - [Right](properties_CoordinatesAndSizing.md#right) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibilty](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [プラグインの種類](properties_Object.md#プラグインの種類) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [CSSクラス](properties_Object.md#cssクラス) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [フォーカス可](properties_Entry.md#フォーカス可) - [表示状態](properties_Display.md#表示状態) - [境界線カラー](./properties_BackgroundAndBorder.md#境界線カラー) - [境界線スタイル](properties_BackgroundAndBorder.md#border-line-style) - [詳細設定](properties_Plugins.md) - [ドラッグ有効](properties_Action.md#ドラッグ有効) - [ドロップ有効](properties_Action.md#ドロップ有効) - [メソッド](properties_Action.md#メソッド) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/progressIndicator.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/progressIndicator.md index 3d7458f20538f8..b00234de9ddf83 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/progressIndicator.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/progressIndicator.md @@ -39,7 +39,39 @@ title: 進捗インジケーター ### プロパティ一覧 -[Barber shop](properties_Scale.md#barber-shop) - [Bold](properties_Text.md#bold) - [Border color](./properties_BackgroundAndBorder.md#border-color) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) -[Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Display graduation](properties_Scale.md#display-graduation) - [Enterable](properties_Entry.md#enterable) - [Execute object method](properties_Action.md#execute-object-method) - [Expression Type](properties_Object.md#expression-type) (only "integer", "number", "date", or "time") - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Italic](properties_Text.md#italic) - [Graduation step](properties_Scale.md#graduation-step) -[Help Tip](properties_Help.md#help-tip) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Label Location](properties_Scale.md#label-location) - [Left](properties_CoordinatesAndSizing.md#left) - [Maximum](properties_Scale.md#maximum) - [Minimum](properties_Scale.md#minimum) - [Number Format](properties_Display.md#number-format) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Step](properties_Scale.md#step) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - +[オブジェクト名](properties_Object.md#オブジェクト名) - +[式の型](properties_Object.md#式の型式タイプ) ("整数", "数値", "日付", "時間" のみ) - +[変数あるいは式](properties_Object.md#変数あるいは式) - +[CSSクラス](properties_Object.md#cssクラス) - +[最小](properties_Scale.md#最小) - +[最大](properties_Scale.md#最大) - +[目盛りのステップ](properties_Scale.md#目盛りのステップ) - +[ステップ](properties_Scale.md#ステップ) - +[ラベル位置](properties_Scale.md#ラベル位置) - +[目盛りを表示](properties_Scale.md#目盛りを表示) - +[バーバーショップ](properties_Scale.md#バーバーショップ) - +[表示状態](properties_Display.md#表示状態) - +[上](properties_CoordinatesAndSizing.md#上) - +[右](properties_CoordinatesAndSizing.md#右) - +[下](properties_CoordinatesAndSizing.md#下) - +[幅](properties_CoordinatesAndSizing.md#幅) - +[高さ](properties_CoordinatesAndSizing.md#高さ) - +[横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - +[縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - +[入力可](properties_Entry.md#入力可) - +[数値フォーマット](properties_Display.md#数値フォーマット) - +[表示状態](properties_Display.md#表示状態) - +[境界線カラー](./properties_BackgroundAndBorder.md#境界線カラー) - +[境界線スタイル](properties_BackgroundAndBorder.md#border-line-style) - +[フォント](properties_Text.md#フォント) - +[フォントサイズ](properties_Text.md#フォントサイズ) - +[太字](properties_Text.md#太字) - +[イタリック](properties_Text.md#イタリック) - +[下線](properties_Text.md#下線) - +[フォントカラー](properties_Text.md#フォントカラー) - +[ヘルプTips](properties_Help.md#ヘルプtips) - +[オブジェクトメソッド実行](properties_Action.md#オブジェクトメソッド実行) ### サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md index de6d70877b2e96..bfc0f24f59d090 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Action.md @@ -22,9 +22,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dragging | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dragging | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト @@ -54,9 +54,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dropping | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dropping | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Appearance.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Appearance.md index 9b2c69735e83bb..8d0f4a40388fbc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Appearance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Appearance.md @@ -29,9 +29,9 @@ Windows上では "推奨選択肢" の概念はサポートされていないた [カスタムボタン](button_overview.md#カスタム) - [通常ボタン](button_overview.md#通常) - [フラットボタン](button_overview.md#フラット) -## Display formula source as symbol +## フォーミュラのソースを記号として表示 -Displays source text of formulas as symbols when expressions are shown as references. +式が参照として表示される場合、フォーミュラのソーステキストを記号として表示します。 #### JSON 文法 @@ -153,7 +153,7 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show background and anchored elements +## 背景とアンカーされた要素を表示 ページの背景画像および背景色を表示/非表示にします。 @@ -171,9 +171,9 @@ Displays source text of formulas as symbols when expressions are shown as refere [WP Get view properties](../WritePro/commands-legacy/wp-get-view-properties.md) - [WP SET VIEW PROPERTIES](../WritePro/commands-legacy/wp-set-view-properties.md) -## Show empty or unsupported images +## 空またはサポートされていない画像を表示 -Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). +読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示したり非表示にします。 #### JSON 文法 @@ -355,9 +355,9 @@ HTML WYSIWYG ビューを有効/無効にします。 このビューでは、 [WP Get view properties](../WritePro/commands-legacy/wp-get-view-properties.md) - [WP SET VIEW PROPERTIES](../WritePro/commands-legacy/wp-set-view-properties.md) -## Show table borders +## 表組みの境界線を表示 -Displays internal and external table borders as dotted lines when these borders are partially or totally invisible. This facilitates page layout (more accessible, more visual resizing) and data entry (convenient in the case of merged cells, for example). +境界線が部分的または完全に非表示になっている場合には、表組の内部および外部の境界線を点線として表示します。これによりページレイアウト(よりアクセスしやすく、視覚的にリサイズしやすく)およびデータ入力(結合されたセルなどの場合に便利に)が容易になります。 ![](../assets/en/FormObjects/visible.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Object.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Object.md index 3369cec50c56b2..50fc0397990391 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_Object.md @@ -139,9 +139,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | +| 名称 | データタイプ | とりうる値 | +| ---------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | ### 式 @@ -212,9 +212,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。 *配列/セレクションリストボックスのみ*: "integer", "object"
    • *配列/セレクションリストボックスのみ*: "integer", "object" | +| 名称 | データタイプ | とりうる値 | +| ------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。*配列/セレクションリストボックスのみ*: "integer", "object"
    • | #### 対象オブジェクト @@ -274,7 +274,7 @@ title: オブジェクト コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。 -コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、 [`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: +コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、[`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: - オブジェクトのコレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: `This.`。 - エンティティセレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: `This.`。 @@ -392,15 +392,15 @@ title: オブジェクト | 計算タイプ | Num | Text | Date | Time | Bool | Pict | フッター変数の型 | | ---------------------------------------- | --- | ---- | ---- | ---- | ---- | ---- | -------- | -| 最小 | X | X | X | X | X | | 列の型と同じ | -| 最大 | X | X | X | X | X | | 列の型と同じ | -| 合計 | X | | | X | X | | 列の型と同じ | -| カウント | X | X | X | X | X | X | Integer | -| 平均 | X | | | X | | | Real | -| 標準偏差(\*) | X | | | X | | | Real | -| 分散(\*) | X | | | X | | | Real | -| 平方和(\*) | X | | | X | | | Real | -| カスタム (JSON では "none") | X | X | X | X | X | X | 制限なし | +| 最小 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 最大 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 合計 | ○ | | | ○ | ○ | | 列の型と同じ | +| カウント | ○ | ○ | ○ | ○ | ○ | ○ | Integer | +| 平均 | ○ | | | ○ | | | Real | +| 標準偏差(\*) | ○ | | | ○ | | | Real | +| 分散(\*) | ○ | | | ○ | | | Real | +| 平方和(\*) | ○ | | | ○ | | | Real | +| カスタム (JSON では "none") | ○ | ○ | ○ | ○ | ○ | ○ | 制限なし | (\*) 配列型のリストボックスのみ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_RangeOfValues.md b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_RangeOfValues.md index 6f831301bb79f7..0e327f89c49a16 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_RangeOfValues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/FormObjects/properties_RangeOfValues.md @@ -11,28 +11,27 @@ title: 値の範囲 - テキスト/文字列 - 数値/整数 -- date -- time -- boolean +- 日付 +- 時間 +- ブール -4D provides stamps for generating default values for a date, a time, and a sequence number. 日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: +日付、時刻、シーケンス番号については、4D が提供する記号を使用することができます。日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: -| スタンプ | 意味 | -| ---- | ------- | -| #D | 本日の日付 | -| #H | 現在の時刻 | -| #N | シーケンス番号 | +| 記号 | 意味 | +| -- | ------- | +| #D | 本日の日付 | +| #H | 現在の時刻 | +| #N | シーケンス番号 | -カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。 For more information, refer to the [Autoincrement](../Develop/structure-fields#autoincrement) paragraph. +カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。詳細については [自動インクリメント](../Develop/structure-fields#自動インクリメント) を参照ください。 -> このプロパティと、リストボックス列に固定値を表示させるための -> "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 +> このプロパティと、リストボックス列に固定値を表示させるための "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | -| defaultValue | string | Any value and/or a stamp as a string: "#D", "#H", "#N", "42", "true"... | +| 名称 | データタイプ | とりうる値 | +| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------ | +| defaultValue | string | 任意の値や、特定の記号の文字列: "#D", "#H", "#N", "42", "true"... | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/GettingStarted/creating.md b/i18n/ja/docusaurus-plugin-content-docs/current/GettingStarted/creating.md index 6efe720ddc5eae..cb674d031cf94b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/GettingStarted/creating.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/GettingStarted/creating.md @@ -11,12 +11,12 @@ title: プロジェクトの作成・開始 1. 4D または 4D Server を起動します。 2. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*新規 > プロジェクト...\*\*を選択します: ![](../assets/en/getStart/projectCreate-1.png) - - (4D のみ) **新規** ツールバーボタンより \*\*プロジェクト...\*\*を選択します:

    ![](../assets/en/getStart/projectCreate-2.png)
    標準の **保存** ダイアログが表示され、4D プロジェクトの名前と保存場所を指定します。 + - **ファイル** メニューより **新規** > **プロジェクト...** を選択します: ![](../assets/en/getStart/projectCreate-1.png) + - (4D のみ) **新規** ツールバーボタンより **プロジェクト...** を選択します:

    ![](../assets/en/getStart/projectCreate-2.png)
    標準の **保存** ダイアログが表示され、4Dプロジェクトの名前と保存場所を指定します。 :::note -**データベース...** および **ストラクチャー定義を使用したデータベス...** の項目は、環境設定において[**バイナリー形式のデータベース作成を有効化する** オプション](../Preferences/general.md#バイナリー形式のデータベース作成を有効化する) をチェックしている場合にのみ利用可能です。 +**データベース...** および **ストラクチャー定義を使用したデータベース...** の項目は、環境設定において[**バイナリー形式のデータベース作成を有効化する** オプション](../Preferences/general.md#バイナリー形式のデータベース作成を有効化する) をチェックしている場合にのみ利用可能です。 ::: @@ -37,7 +37,7 @@ OS によって許可されている名称であれば使用可能です。し 1. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*開く ＞ ローカルプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **ローカルプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 - Welcome ウィザードにて **ローカルアプリケーションプロジェクトを開く** を選択します。 標準のファイルを開くためのダイアログが表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/encrypt.md b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/encrypt.md index 4e35b338fa43cd..e013daddc5aa76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/encrypt.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/encrypt.md @@ -47,7 +47,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう 暗号化プロセスが正常に完了した場合、暗号化ページは 暗号化メンテナンスオペレーション ボタンを表示します。 -**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデーファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 +**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデータファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 ## 暗号化メンテナンスオペレーション @@ -86,7 +86,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ### パスフレーズを変更してデータを再暗号化する -この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスプレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 +この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスフレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 1. **パスフレーズを変更してデータを再暗号化する** をクリックします。 2. カレントのデータ暗号化キーを入力します。 @@ -110,7 +110,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ## 暗号化キーを保存する -4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。 なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 +4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 新しいパスフレーズが提供されるたびに暗号化キーを保存することができます: @@ -121,7 +121,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう :::caution -[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。 できない場合には、エラーが発生します。 +[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。できない場合には、エラーが発生します。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/overview.md index 000f1c827ccdce..bf793a36332bd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/MSC/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/MSC/overview.md @@ -14,7 +14,7 @@ MSCウィンドウを開く方法は幾つかあります。アクセスの方 メンテナンスモードでは、MSCウィンドウだけが表示されます (4Dアプリケーションはプロジェクトを開きません)。つまり、損傷が激しいため 4D が標準モードで開けないプロジェクトにもアクセスできるということです。さらに、特定の操作 (圧縮、修復など) はプロジェクトをメンテナンスモードで開くことを要求します ([アクセス権](#アクセス権) 参照)。 -次の 2つの場所から、MSC をメインテナンスモードで開くことができます: +次の 2つの場所から、MSC をメンテナンスモードで開くことができます: - **標準の開くダイアログボックス** 標準のプロジェクトを開くダイアログボックスには **開く** ボタンに関連付けられているメニューに **Maintenance & Security Center** オプションが含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Menus/sdi.md b/i18n/ja/docusaurus-plugin-content-docs/current/Menus/sdi.md index 587307a3951187..e91acd22715013 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Menus/sdi.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Menus/sdi.md @@ -17,7 +17,7 @@ SDIモードは以下の実行環境に限り利用可能です: - Windows - 組み込みの [スタンドアロン](../Desktop/building#スタンドアロンアプリケーションをビルド) または [クライアント](../Desktop/building#クライアントアプリケーションをビルド) 4Dアプリケーション -- **実行** メニューにて提供されている [\*\* アプリケーションをテスト\*\* 機能](bars.md#メニューバーのプレビュー) から利用可能です。 +- **実行** メニューにて提供されている [**アプリケーションをテスト** 機能](bars.md#メニューバーのプレビュー) から利用可能です。 ## SDIモードの有効化 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/glossary.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/glossary.md index 02a56829aa7a83..c26b75cdd753dc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/glossary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/glossary.md @@ -127,7 +127,7 @@ $myClass.query("name = smith") ## ミックスデータ型 -このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : +このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。これには以下が含まれます: - 数値 - テキスト @@ -211,9 +211,9 @@ ORDA オブジェクトとは関わりのないユーザークラス。 シャロウコピーは、要素の構造のみを複製し、同じ内部参照を保持します。シャロウコピーのあと、二つのコレクションに格納された個々の要素は同じものが共有されています。ディープコピー も合わせて参照してください。 -## スタンプ +## 記号 -"オプティミステック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 +"オプティミスティック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 ## ストレージ属性 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md index 08a6d646795196..dc6b76048c5606 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ORDA/privileges.md @@ -3,17 +3,15 @@ id: privileges title: ロールと権限 --- -データ保護と、承認ユーザーによる迅速かつ容易なデータアクセスを両立することは、Webアプリケーションにとって大きな課題です。 ORDA のセキュリティアーキテクチャーはデータストアの中心に実装されており、プロジェクト内のさまざまなリソース (データストア、データクラス、関数など) に対して、すべての Web または REST ユーザーセッションに特定の権限を定義することができます。 +The ORDA security architecture controls access to project resources for web and REST sessions. It lets you grant specific permissions on resources such as the datastore, dataclasses, attributes, and functions. ## 概要 -ORDA のセキュリティアーキテクチャーは、権限、許諾アクション (read、create など)、およびリソースの概念に基づいています。 +The security model combines **privileges**, **actions** (such as `read` and `create`), and **resources**. -Webユーザーまたは RESTユーザーがログインすると、そのセッションには自動的に関連する権限がロードされます。権限は、[`session.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数によって、セッションに割り当てられます。 +Assign privileges to a **session** using [`Session.setPrivileges()`](../API/SessionClass.md#setprivileges). -セッション内で送信されるユーザーリクエストは、プロジェクトの `roles.json` ファイルで定義された権限に対して評価されます。 - -権限外のアクションをユーザーが実行しようとすると、権限エラーが生成されるか、あるいは読み取り権限がない属性の場合にはそのデータは送信されません。 +Each request is checked against the permissions defined in the project's `roles.json` file. An unauthorized action raises a privilege error. Attributes without read permission are omitted from the response. ![schema](../assets/en/ORDA/privileges-schema.png) @@ -23,50 +21,30 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ ::: -## リソース - -プロジェクト内の以下のリソースに対して、許諾アクションと権限名を割り当てることができます (この設定をパーミッションと呼びます): +:::info -- [データストア](../ORDA/dsMapping.md#データストア) -- [データクラス](../ORDA/dsMapping.md#データクラス) -- [属性](../ORDA/dsMapping.md#属性) ([計算属性](./ordaClasses.md#計算属性-1) および [エイリアス属性](./ordaClasses.md#エイリアス属性-1)を含む) -- [データモデルクラス](../ORDA/ordaClasses.md) の関数 -- [シングルトン](../REST/$singleton.md) 関数 +パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。 -セッションがリソースにアクセスするたびに (アクセス形式に関係なく)、4D はセッションの権限を確認し、許可されていない場合にはアクセスを拒否します。 +::: -## パーミッション +## スコープ -パーミッションとは、リソースに対してアクションを実行できる能力のことです。例えば、 *ds.myTable.myFunction() を実行できる* というのは、**パーミッション** を表します。権限は、プロジェクトに対して [`roles.json`](#rolesjson-file) ファイル内にて定義されます。各パーミッションには一つまたは複数の [権限](#privileges-and-roles) を与えることができます。 +Permissions apply to **web and REST sessions**: [REST requests](../REST/gettingStarted.md), including [Qodly pages](https://developer.4d.com/qodly/4DQodlyPro/pageLoaders/pageLoaderOverview), and **4D code executed in a web process**. This includes [exposed functions](./ordaClasses.md), [HTTP request handlers](../WebServer/http-request-handler.md), the [On Web Connection database method](../commands/on-web-connection-database-method), and any code they call. For example, an allowed function call still fails if the function reads a dataclass for which the session has no read permission. -リソースに対して **特定のパーミッションが定義されていない** 場合には、リソースに対してのアクセスは、[プロジェクトで定義されているデフォルトのモード](#制限モード)によって自動的に **無制限** か **制限付き** に設定されます。 +:::info Exception -### 許諾アクション +The **execute** permission of a [shared singleton](../Concepts/classes.md#shared-singleton) or [singleton function](../Concepts/classes.md#singleton-classes) is checked only when the function is [called through REST](../REST/$singleton.md). When 4D code running in a web session directly calls it (`cs.MySingleton.me.myFunction()`), no permission is checked, unlike dataclass, entity, entity selection and datastore functions, which are checked in both cases. -利用可能なアクションは対象となるリソースによります。 +::: -| アクション | データストア | データクラス | 属性 | データモデル関数またはシングルトン関数 | -| ----------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -| **create** | 任意のデータクラスにおいてエンティティを作成 | 当該データクラスにおいてエンティティを作成 | 当該属性に許可されたデフォルト値とは異なる値を持つエンティティを作成 (エイリアス属性の場合は無視されます) | n/a | -| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | 当該属性を読み取り | n/a | -| **update** | 任意のデータクラスにおいて属性を更新 | 当該データクラスにおいて属性を更新 | 当該属性を更新 (エイリアス属性の場合は無視されます) | n/a | -| **drop** | 任意のデータクラスにおいてデータを削除 | 当該データクラスにおいてデータを削除 | 当該属性の null でない値を削除 (エイリアス属性と計算属性を除く) | n/a | -| **execute** | プロジェクトの任意の関数を実行 (データストア、データクラス、エンティティセレクション、エンティティ、シングルトン) | データクラスの任意の関数を実行。データクラス関数、エンティティ関数、エンティティセレクション関数は、データクラスの関数として扱われます。 | n/a | 当該関数を実行 | -| **promote** | n/a | n/a | n/a | 関数の実行に指定の権限を関連付けます。権限は一時的に追加され、関数の実行終了時に削除されます。セキュリティ上、セッション全体ではなく、当該関数を実行するプロセスのみに権限が追加されます。 | +Permissions never apply to [desktop session code](../Desktop/sessions.md) (standalone, client/server, stored procedures) or [tool4d](../Admin/cli.md#tool4d). -:::note 注記 +:::warning -- エイリアス属性の元である属性に対するアクセス権をセッションが持っていない場合でも、[エイリアス属性](./ordaClasses.md#エイリアス属性-1) へのアクセス権があれば、これを読み取ることができます。 -- 計算属性を構成する属性に対するアクセス権をセッションが持っていない場合でも、[計算属性](./ordaClasses.md#計算属性-1) へのアクセス権があれば、これを読み取ることができます。 -- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型）に適用されます。 -- [`promote()`](../API/SessionClass.md#promote) および [`demote()`](../API/SessionClass.md#demote) 関数を使用することで、Web プロセスに対して動的に **promote** アクションを設定/削除することができます。 -- デフォルト値: 現在の実装では、*Null* のみデフォルト値として利用可能です。 -- REST の [強制ログインモード](../REST/authUsers.md#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。 +When a permission entry references an undeclared [privilege](#privileges-and-roles), 4D logs an error and ignores the entry. In this case, the permission is ignored. If the [restricted mode by default](#restriction-modes) is not enabled, the resource is accessible to `guest` sessions. ::: -権限の設定には一貫性が必要です。特に、**update** および **drop** 権限は**read** 権限も必要とします(ただし**create** はそれを必要としません)。 - ### MCP tools The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: @@ -95,23 +73,53 @@ MCP clients authenticated with the "salesReader" privilege can read the Customer } ``` -### 継承されたパーミッション +### MCP tools -あるレベルにおいて定義されたパーミッションは基本的に下位レベルに継承されますが、パーミッションは複数のレベルで設定することもできます: +The same permissions apply to the sessions of the [MCP server](../WebServer/mcp-server.md), with nothing specific to configure: -- データストアレベルで定義されたパーミッションは、自動的にすべてのデータクラスに割り当てられます。データストアレベルで定義された*execute* 権限アクションは、[シングルトン](../REST/$singleton.md) 関数を含めてプロジェクトの全ての関数に対して適用されます。 -- データクラスレベルで定義されたパーミッションは、データストアの設定をオーバーライドします (あれば)。デフォルトでは、データクラスのすべての属性が、データクラスのパーミッションを継承します。 -- データクラスとは異なり、属性レベルで定義されたパーミッションは、親のデータクラスの設定をオーバーライドするのではなく、それに追加されます。たとえば、同じ許諾アクションに対し、データクラスのレベルでは "general" という権限名を、データクラスの属性のレベルでは "detail" という権限名を割り当てた場合、その属性にアクセスするには、セッションに "general" と "detail" の両方の権限が設定されている必要があります。 +- A [custom tool](../WebServer/mcp-server.md#custom-tools) (`exposed MCP Function`) requires the **execute** permission on its function, and benefits from its **promote** permission. +- The [built-in CRUD tools](../WebServer/mcp-server.md#built-in-crud-tools) require the **read**, **create**, **update**, or **drop** permission on the dataclass, and the attribute permissions apply. Each attribute of a path used in a filter, a sort, or a projection requires the **read** permission. +- The CRUD tools are listed only if the session has at least one data permission on a dataclass, and the `describeModel` tool only describes the dataclasses on which the session has a data permission, with their readable or writable attributes. +- A tool, a dataclass, or an attribute that the session cannot access is reported as if it did not exist. -:::info +#### 例題 -パーミッションは、データストアオブジェクトや関数へのアクセスを制御します。特定の条件に基づいて読み取りデータをフィルタリングしたい場合は、[制限付エンティティセレクション](entities.md#制限付エンティティセレクション) の利用がより適切かもしれません。 +MCP clients authenticated with the "salesReader" privilege can read the Customer and Order dataclasses with the CRUD tools, and call the tools published by the `OrderManager` singleton (for example `OrderManager-getYearTotal`): -::: +```json +{ + "privileges": [{"privilege": "salesReader", "includes": []}], + "roles": [], + "permissions": { + "allowed": [ + {"applyTo": "Customer", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "Order", "type": "dataclass", "read": ["salesReader"]}, + {"applyTo": "OrderManager", "type": "singleton", "execute": ["salesReader"]} + ] + }, + "restrictedByDefault": true +} +``` + +## リソース + +4D checks the session's permissions whenever a resource is accessed. The following resources can have specific permissions: + +| リソース | `applyTo` | `type` | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- | ----------------- | +| [Datastore](./dsMapping.md#datastore) | `ds` | `データストア` | +| [Datastore class function](./ordaClasses.md#datastore-class) | `ds.` | `method` | +| [Dataclass](./dsMapping.md#dataclass) | `` | `データクラス` | +| [Attribute](./dsMapping.md#attribute) (including [computed](./ordaClasses.md#computed-attributes-1) and [alias](./ordaClasses.md#alias-attributes-1)) | `.` | `属性` | +| [Dataclass, entity or entity selection function](./ordaClasses.md) | `.` | `method` | +| [Shared singleton](../Concepts/classes.md#shared-singleton) (all its exposed functions) | `` | `singleton` | +| [Singleton function](../Concepts/classes.md#singleton-classes) | `.` | `singletonMethod` | + +Use the `applyTo` and `type` values shown in the table when defining permissions in [`roles.json`](#rolesjson-file). -### ORDA クラス関数の権限の設定 +:::note ORDA クラス関数の権限の設定 -パーミッションを設定する際、ORDA クラス関数の権限は、以下の形式で `applyTo` 要素に記述します: +In `roles.json`, identify an ORDA class function in `applyTo` with this syntax: ```json . @@ -126,13 +134,13 @@ Class extends Entity ... ``` -... 以下のように記述します: +Use this value: ```json "applyTo":"City.getPopulation" ``` -これはつまり、関数に対して権限を割り当てたい場合には、異なるORDA クラス(エンティティ、エンティティセレクション、データクラス)間で同じ関数名を使用することができないということです。この場合には、異なる関数名を使用する必要があります。たとえば、`cs.CityEntity` および `cs.CitySelection` クラスの両方に "drop" 関数を作成するのであれば、`dropEntity()`、`dropSelection()` といった具合に別々の関数名を設定する必要があります。その後で、 "roles.json" ファイルに以下のように記述することができます: +Because permissions identify functions by dataclass and function name, functions with the same name in different ORDA classes (entity, entity selection, dataclass) cannot be assigned different privileges. Give them distinct names instead. For example, name the functions `dropEntity()` and `dropSelection()` in `cs.CityEntity` and `cs.CitySelection`, respectively: ```json "permissions": { @@ -151,22 +159,82 @@ Class extends Entity "name" ] } - ] + ] + } +} ``` +::: + +## パーミッション + +A **permission** allows an action on a resource; for example, executing `ds.myTable.myFunction()`. Permissions are defined in [`roles.json`](#rolesjson-file) and granted to one or more [privileges](#privileges-and-roles). + +If no permission is defined for a resource, access depends on the project's [restriction mode](#restriction-modes). + +### 許諾アクション + +Available actions depend on the resource: + +| 動作 | データストア | データクラス | 属性 | Function | +| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **create** | Create entities in any dataclass | Create entities in this dataclass | Create an entity with a non-default value for this attribute (ignored for alias attributes) | n/a | +| **read** | 任意のデータクラスにおいて属性を読み取り | 当該データクラスにおいて属性を読み取り | Read this attribute's content | n/a | +| **update** | Update attributes in any dataclass | Update attributes in this dataclass | Update this attribute's content (ignored for alias attributes) | n/a | +| **drop** ("Delete" in Qodly Studio) | Delete data in any dataclass | Delete data in this dataclass | Delete a non-null value for this attribute (except for alias and computed attributes) | n/a | +| **execute** | Execute any function on the project (datastore, dataclass, entity selection, entity, or singleton) | Execute any function on the dataclass; dataclass, entity, and entity selection functions are treated as dataclass functions | n/a | 当該関数を実行 | +| **promote** | n/a | n/a | n/a | Temporarily add a privilege for the duration of the function call. Only the process executing the function receives it, not the whole session. Use [`promote()`](../API/SessionClass.md#promote) and [`demote()`](../API/SessionClass.md#demote) to set or remove this action dynamically in a web process. | + +### Permission rules + +- **update** and **drop** require **read** on the resource; **create** does not. +- A function can be **promoted** by multiple privileges. During execution, it receives the combined permissions of all those privileges; there is no priority order. +- An [alias attribute](./ordaClasses.md#alias-attributes-1) can be read if the session has permission to read the alias, even if it cannot read the attributes the alias resolves to. +- A [computed attribute](./ordaClasses.md#computed-attributes-1) can be accessed even if its underlying attributes have no permissions. +- In REST [force login mode](../REST/authUsers.md#force-login-mode), guest users can always execute [`authentify()`](../REST/authUsers.md#function-authentify), regardless of the permissions configuration. + +### 継承されたパーミッション + +Permission actions are inherited according to the following rules: + +1. Permissions descend **datastore → dataclass → attribute / function**, and **datastore → singleton → singleton function**. +2. Resolution is **per action**. Defining `read` on a dataclass does not change how `create`, `update`, `drop` or `execute` are resolved for it. +3. **Dataclass replaces datastore**. A permission defined on a dataclass for an action replaces the datastore permission for that action. Privileges granted the action only on the datastore lose it on that dataclass. +4. **Function replaces dataclass**. An `execute` permission defined on a function replaces the dataclass (and datastore) `execute` permission for that function. Entity and entity selection functions follow the same rule as dataclass functions. +5. **Singleton replaces datastore**, **singleton function replaces singleton**. +6. **Datastore function replaces datastore**. +7. **Attribute adds to its parent**. To act on an attribute that has its own permission, a session needs a privilege granted by the attribute permission **and** a privilege granted the action on the dataclass (directly or through the datastore). +8. An action granted to **no privilege** (for example, `"read": []`) is "not set", so the permission at the level above applies. It does not mean "nobody". To deny the action, use [restricted mode](#restriction-modes) without defining that permission, or grant it to a privilege that no session receives. + +Permissions only grant access; there is no explicit deny. A dataclass or function permission can therefore narrow a broader datastore permission by replacing it. An attribute permission is additive: it grants access to that attribute only when the session also has the action on its dataclass. + +:::tip Recommended practice + +- Assign access to sessions through **roles** with `Session.setPrivileges({roles: [...]})`. Define roles around business profiles; privileges are the reusable building blocks. [Qodly Studio](https://developer.4d.com/qodly/4DQodlyPro/roles/overview) displays effective permissions by role. +- If an administration role needs full access, include every privilege in it except a lock privilege, if used. Add each new privilege to that role: a dataclass-level permission can replace a broader datastore permission. +- Review the effect of privilege changes on every role. In Qodly Studio, **Detailed Permission Review** shows a role's effective access; a role with no privileges can help you review guest-only access. + +::: + ## 権限とロール -**権限** とは、**リソース** に対して **アクション** を実行する技術的な能力であり、**ロール** は、管理者が使用するために公開された権限のことです。基本的にロールとは、ビジネスユーザーのプロフィールを定義するためにいくつかの権限を集めたものです。たとえば、"manageInvoices" (請求書管理) は権限の例で、"secretary" (秘書) は ("manageInvoices" および他の権限を持つ) ロールの例です。 +A **privilege** grants actions on resources. A **role** groups privileges into a business profile that an administrator can assign to a session. + +For example, `manageInvoices` could be a privilege and `secretary` a role that includes it and other privileges. Assign roles to sessions with [`Session.setPrivileges({roles: [...]})`](../API/SessionClass.md#setprivileges); the role grants all its privileges. -権限は、複数の "リソース+アクション" の組み合わせと関連付けることができます。また、一つのアクションに複数の権限を関連付けることができます。権限は、他の権限を含むことができます。 +Privileges can be granted permission on multiple action-resource combinations, and an action can be granted to multiple privileges. -- 権限やロールの **作成** は `roles.json` ファイル内にておこないます (後述参照)。アクセス権の範囲を **設定** するには、リソースに適用される許諾アクションに権限名を割り当てます。 +Define privileges and roles in [`roles.json`](#rolesjson-file), then grant roles to sessions with `Session.setPrivileges()`. -- 各ユーザーセッションに権限やロールを **許可** するには、`Session` クラスの [`.setPrivileges()`](../API/SessionClass.md#setprivileges) 関数を使用します。 +### Including privileges + +A privilege can include other privileges using the `includes` property in `roles.json`. Inclusion is transitive and one-way: if A includes B, and B includes C, A receives the permissions of B and C. + +[`Session.getPrivileges()`](../API/SessionClass.md#getprivileges) returns the expanded collection (for example, A, B, and C) in no guaranteed order. Declare an included privilege before the privilege that includes it; otherwise, 4D drops the inclusion and logs an error. ### 例題 -セッションにおいて特定のロールを許可します: +This authentication function assigns the user's role to the session: ```4d @@ -176,62 +244,65 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T Session.clearPrivileges() - $result:="ゲストとしてログインしています" + $result:="You are authenticated as Guest" $user:=ds.Users.query("identifier = :1"; $identifier).first() If ($user#Null) If (Verify password hash($password; $user.password)) Session.setPrivileges(New object("roles"; $user.role)) - $result:=$user.role+"としてログインしています" + $result:="Your are authenticated as "+$user.role End if End if - ``` +## `guest` privilege + +`guest` is built in; declaring a privilege named `Guest` is an error ("privilege already defined"). Sessions without privileges (`Session.isGuest() = True`) receive the permissions granted to `guest`. + +Permissions granted to `guest` are available to every session, regardless of its other privileges. Do not grant `guest` access that should be withheld from other sessions, and account for its permissions when restricting access at the dataclass level. + ## `roles.json` ファイル -`roles.json` ファイルは、プロジェクトのWeb セキュリティ設定の全体を記述します。 `roles.json` ファイルの構文は次のとおりです: - -| プロパティ名 | | | 型 | 必須 | 説明 | -| ------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------ | -| privileges | | | `privilege` オブジェクトの Collection | X | 定義された権限のリスト | -| | \[].privilege | | Text | | アクセス権の名称 | -| | \[].includes | | String の Collection | | 内包する権限名のリスト | -| roles | | | `role` オブジェクトの Collection | | 定義されたロールのリスト | -| | \[].role | | Text | | ロール名 | -| | \[].privileges | | String の Collection | | 内包する権限名のリスト | -| permissions | | | Object | X | 設定されたパーミッションのリスト | -| | allowed | | `permission` オブジェクトの Collection | | 許可されたパーミッションのリスト | -| | | \[].applyTo | Text | X | 対象の [リソース](#リソース) 名 | -| | | \[].type | Text | X | [リソース](#リソース) タイプ: "datastore", "dataclass", "attribute", "method", "singletonMethod", "singleton" | -| | | \[].read | String の Collection | | 権限名のリスト | -| | | \[].create | String の Collection | | 権限名のリスト | -| | | \[].update | String の Collection | | 権限名のリスト | -| | | \[].drop | String の Collection | | 権限名のリスト | -| | | \[].execute | String の Collection | | 権限名のリスト | -| | | \[].promote | String の Collection | | 権限名のリスト | -| restrictedByDefault | | | Boolean | | True 時、明示的なパーミッションがないリソースへのアクセスは拒否されます。 | -| forceLogin | | | Boolean | | True 時、["forceLogin" モード(強制ログインモード)](../REST/authUsers.md#強制ログインモード)が有効化されます。 | - -:::caution 注記 - -- "WebAdmin" 権限名は、アプリケーションによって予約されています。この名前をカスタムの権限名に使用することは推奨されません。 -- `privileges` および `roles` の名称においては文字の大小が区別されます。 +The project's web security settings are defined in `roles.json`: + +| プロパティ | 型 | 必須 | 説明 | +| ------------------------------- | -------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| `privileges` | Collection of privilege objects | ◯ | Defined privileges. Each object has a `privilege` name and can have an `includes` collection of privilege names. | +| `ロール` | Collection of role objects | × | Defined roles. Each object has a `role` name and a `privileges` collection of privilege names. | +| `permissions.allowed` | Collection of permission objects | ◯ | Permissions assigned to resources. | +| `permissions.allowed[].applyTo` | Text | ◯ | Target [resource](#resources) name. | +| `permissions.allowed[].type` | Text | ◯ | [Resource](#resources) type: `datastore`, `dataclass`, `attribute`, `method`, `singletonMethod`, or `singleton`. | +| `permissions.allowed[].read` | String の Collection | × | Privileges granted read access. | +| `permissions.allowed[].create` | String の Collection | × | Privileges granted create access. | +| `permissions.allowed[].update` | String の Collection | × | Privileges granted update access. | +| `permissions.allowed[].drop` | String の Collection | × | Privileges granted delete access. | +| `permissions.allowed[].execute` | String の Collection | × | Privileges granted execute access. | +| `permissions.allowed[].promote` | String の Collection | × | Privileges temporarily granted during function execution. | +| `restrictedByDefault` | Boolean | × | If `true`, access to resources without explicit permissions is denied. | +| `forceLogin` | Boolean | × | If `true`, enables [force login mode](../REST/authUsers.md#force-login-mode). | + +:::note 注記 + +- The `WebAdmin` privilege name is reserved for the application; do not use it for custom privileges. +- Privilege and role names are case-insensitive. Unknown names passed to [`.setPrivileges()`](../API/SessionClass.md#setprivileges) are ignored. +- Qodly Studio can add an optional `id` property to privileges and roles to preserve references when they are renamed. +- Multiple entries with the same `applyTo` are not merged: the last entry wins without an error. Define only one entry per resource. +- A resource entry that grants no actions has no effect. ::: -### デフォルトのファイルの場所と内容 +### Default location and content -新規プロジェクト作成時、デフォルトの `roles.json` ファイルは、以下の場所に生成されます: +New projects generate `roles.json` at: ``` /Project/Sources/ ``` -[アーキテクチャー](../Project/architecture.md#sources) を参照ください。 +See the [Architecture](../Project/architecture.md#sources) section for details. デフォルトの内容: @@ -263,7 +334,7 @@ exposed Function authenticate($identifier : Text; $password : Text)->$result : T :::note 互換性 -以前のリリースでは、`roles.json` ファイルはデフォルトで作成されませんでした。 4D 20 R6 以降、`roles.json`ファイルを含まない、または `"forceLogin": true` の設定が含まれていない既存のプロジェクトを開く場合、[設定ダイアログボックスの **Web機能** ページ](../settings/web.md#アクセス権) で **ds.authentify() 関数を通しての REST認証を有効化** ボタンが利用可能になります。このボタンはセキュリティ設定を自動的にアップグレードします (コードを修正する必要があるかもしれません。[このブログ記事を参照ください](https://blog.4d.com/ja/force-login-becomes-default-for-all-rest-auth))。 +In releases before 4D 20 R6, `roles.json` was not created by default. In 4D 20 R6 and later, opening an existing project without a `roles.json` file or `"forceLogin": true` setting makes the **Activate REST authentication through ds.authentify() function** button available on the [Web Features page of the Settings dialog box](../settings/web.md#access). This button upgrades the security settings; you may need to modify your code. [こちらの blog 記事](https://blog.4d.com/force-login-becomes-default-for-all-rest-auth/) をご覧ください。 ::: @@ -275,67 +346,116 @@ Qodly Studio for 4D においては、ログインモードはRoles and Privileg ## 制限モード -`restrictedByDefault` プロパティは、[リソース](#resources) に対して[特定のパーミッションが定義されていない時](#パーミッション) にどのようにしてそれにアクセスできるかを設定します: +`restrictedByDefault` determines access to a [resource](#resources) when no [specific permission](#permissions) is defined: -- **無制限モード** (`restrictedByDefault`: **false**): リソースに対して定義されたパーミッションがなくても、全てのリクエストがそれにアクセス可能です。このモードは例えば、アクセスを徐々に制限していけばいいような開発環境に適しています。 -- **制限モード** (`restrictedByDefault`: **true**): 定義されたパーミッションがないリソースは、デフォルトでブロックされます。このモードは例えば、アクセス権が明示的に与えられなければならないような、プロダクション環境に対して推奨されます。 +- **Unrestricted mode** (`restrictedByDefault: false`): Resources without defined permissions are accessible to all requests. +- **Restricted mode** (`restrictedByDefault: true`): Resources without defined permissions are blocked. Access is granted explicitly, and the [permission inheritance rules](#inherited-permissions) still apply. :::note 互換性 -- **新規プロジェクト作成時**、この `restrictedByDefault` プロパティは*roles.json* ファイルの中で**false** に設定されています(以下参照)。この設定は、すぐに、かつスムーズに開発を始められるようにすることが目的であることに注意して下さい。プロダクション環境においては、[`restrictedByDefault` および `forceLogin` プロパティを **true** に設定することが推奨されます](#recommended-configuration)。 -- **以前のリリースから変換されたプロジェクトの場合**、 Qodly Studio へのアクセスを[ワンクリック設定ダイアログ](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration) を使用して有効化した場合、 `restrictedByDefault` プロパティは、 *roles.json* ファイル内に値が **true** の状態で追加されます。 +- New projects set `restrictedByDefault` to `false` by default; see [recommended configurations](#recommended-configuration). +- For projects converted from earlier releases, enabling access to Qodly Studio through the [One-click configuration dialog](https://developer.4d.com/qodly/4DQodlyPro/gettingStarted#one-click-configuration) adds `restrictedByDefault: true` to `roles.json`. ::: -### 推奨される設定{#recommended-configuration} +### Restriction strategies + +#### Lock everything and open gradually + +Choose either restricted mode or a lock privilege to close access by default: + +| | Restricted mode | Lock privilege | +| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| Setting | `"restrictedByDefault": true` (Qodly Studio: **Restrict Access By Default**) | `"restrictedByDefault": false`, with every action on `ds` granted to a privilege that no session receives (for example, `none`) | +| What is closed | Every resource without a permission | Every resource that inherits datastore permissions | +| How to open | Grant permissions on the datastore, dataclasses, attributes, and functions | Grant permissions on dataclasses and functions to replace the lock | +| If 4D drops an invalid entry | The resource stays closed | The resource falls back to the lock and stays closed | +| 重要 | Explicitly grant access to public resources, usually to `guest`, including the login function unless [force login](../REST/authUsers.md#force-login-mode) is used, and [HTTP request handlers](../WebServer/http-request-handler.md) called before login. In this mode, Qodly Studio's role review is currently incorrect. | Never assign the lock privilege to a role, including the administration role. | + +Both approaches close access by default and follow the same inheritance and replacement rules. A lock privilege makes the lock visible in the editor; restricted mode requires no extra privilege. + +#### Open everything, restrict gradually + +Set unrestricted mode (`"restrictedByDefault": false`), grant `guest` read access to `ds`, then restrict sensitive dataclasses with dataclass-level permissions. + +Remember that [guest](#guest-privilege) permissions apply to every session. Without a lock privilege, an invalid entry dropped by 4D leaves the resource open in unrestricted mode. + +#### 推奨される設定{#recommended-configuration} -環境によって、推奨される設定は以下のようになります: +Use these settings as a starting point: -- **プロダクション環境**: `restrictedByDefault` および [`forceLogin`](../REST/authUsers.md#force-login-mode) を両方とも **true** に設定する。この設定によりリソースへのアクセスにはユーザー認証と明示的に定義されたパーミッションが必要になり、最大限のセキュリティを保証します。 -- **開発環境**: `restrictedByDefault` および [`forceLogin`](../REST/authUsers.md#force-login-mode) を両方とも **false** に設定する。この設定により、開発およびデバッグ中は簡単にアクセスすることができ、それでいて後から徐々に制限を厳しくしていくという方法が可能になります。 +- **Development**: Set both properties to `false` for easier access while developing and debugging. Apply restrictions gradually as needed. +- **Production**: Set `restrictedByDefault` and [`forceLogin`](../REST/authUsers.md#force-login-mode) to `true` so that users must authenticate and resource access must be explicitly granted. + +## Permission errors ### `Roles_Errors.json` ファイル -`roles.json` ファイルは、4D 起動時に解析されます。このファイルへの変更を反映させるには、アプリケーションを再起動する必要があります。 +4D parses `roles.json` at startup. Restart the application for changes to take effect. -`roles.json` ファイルを解析する際にエラーが発生した場合、4D はプロジェクトを読み込みますが、グローバルアクセス保護は無効になります。これにより、開発者はエラー修正のためファイルにアクセスすることができます。また、`Roles_Errors.json` という名前のエラーファイルが [プロジェクトの `Logs` フォルダー](../Project/architecture.md#logs) に生成され、エラー行が記述されています。このファイルは、`roles.json` ファイルのエラーがすべて修正されると、自動的に削除されます。 +If parsing fails, 4D writes the errors to `Roles_Errors.json` in the project's [`Logs` folder](../Project/architecture.md#logs). It deletes this file after `roles.json` is corrected. -`Roles_Errors.json` ファイルが [Logs フォルダー](../Project/architecture.md#logs) に存在するかどうか、起動時に確認することをお勧めします。存在する場合、解析エラーが発生し、アクセスが制限されないことを意味します。たとえば、次のように書くことができます: +Check at startup, especially in production, whether `Roles_Errors.json` exists. Its presence indicates a parsing error, and permissions may not be enforced as intended. たとえば、次のように書くことができます: ```4d title="/Sources/DatabaseMethods/onStartup.4dm" If (Not(File("/LOGS/"+"Roles_Errors.json").exists)) -… -Else // プロジェクトが開かれるのを防ぐことができます - ALERT("roles.json ファイルが不正なため、アプリケーションを終了します。") +... +Else // you can prevent the project to open + ALERT("The roles.json file is malformed or contains inconsistencies, the application will quit.") QUIT 4D End if - ``` -## 権限設定の例 +Permission errors are returned as follows: -```json title="/Project/Sources/roles.json" +| パス | read / create / update / drop refused | execute refused | +| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | +| REST | HTTP 401 with message | **HTTP 500** with message (singleton: "Bad permission...") | +| Code (web session) | Read: error 1557 (dataclass) or 1607 (attribute). Create: error 1608 when assigning an attribute to a new entity if create is restricted by a permission; in restricted mode without permission, `save()` returns `success: false` and `statusText: "Permission Error"`. Update/drop: error 1557 when loading the entity (both require read). | Error 1561 | + +## 例題 +This example grants a broad set of permissions through a `manager` privilege, while the `payroll` privilege grants read access to the sensitive `Salaries` dataclass. + +```json title="roles.json" { - "forceLogin": true, - "restrictedByDefault": true, - "permissions": { - "allowed": [ - { - "applyTo": "People", - "type": "dataclass", - "read": [ - "viewPeople" - ] - } - ] - }, - "privileges": [ - { - "privilege": "viewPeople", - "includes": [] - } - ], - "roles": [] + "forceLogin": true, + "restrictedByDefault": true, + "privileges": [ + {"privilege": "payroll", "includes": []}, + {"privilege": "manager", "includes": []} + ], + "roles": [ + {"role": "administrator", "privileges": ["manager", "payroll"]} + ], + "permissions": { + "allowed": [ + { + "applyTo": "ds", + "type": "datastore", + "read": ["manager"], + "create": ["manager"], + "update": ["manager"], + "drop": ["manager"], + "execute": ["manager"] + }, + { + "applyTo": "Salaries", + "type": "dataclass", + "read": ["payroll"] + } + ] + } } + ``` + +Here are the resulting rules: + +| Session | Read Salaries | Create Salaries | Update/drop Salaries | Read other dataclasses | +| -------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------- | ---------------------- | +| `manager` | Refused (the `Salaries` read permission replaces the datastore permission) | Allowed (inherited from the datastore) | Refused (read is required) | Allowed | +| `payroll` | Allowed | Refused (the datastore permission is granted only to `manager`) | Refused | Refused | +| `administrator` role | Allowed | Allowed | Allowed | Allowed | + +The `Salaries` read permission replaces the datastore read permission, so `manager` alone cannot read that dataclass. The `administrator` role receives the combined permissions of `manager` and `payroll`. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/compiler.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/compiler.md index ed981216eb2228..b41331669cd5fb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/compiler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/compiler.md @@ -69,7 +69,7 @@ When the compilation succeeds, the compiler also generates the `Project/DerivedD ::: -コンパイル中のコンポーネントの一覧がコンパイラウィンドウ内に表示されます。コンポーネント内でエラーが検知された場合、そのコンパイルは停止されますがその他のコンポーネントに対しての処理は継続されます。 +コンパイル中のコンポーネントの一覧がコンパイラーウィンドウ内に表示されます。コンポーネント内でエラーが検知された場合、そのコンパイルは停止されますがその他のコンポーネントに対しての処理は継続されます。 - コンポーネントに少なくとも一つのエラーがある場合には**太字**で表示され、エラーリストを展開して表示することができます。 - コンポーネントに少なくとも一つの警告がある場合には、警告のリストを展開して表示することができます。 @@ -80,7 +80,7 @@ When the compilation succeeds, the compiler also generates the `Project/DerivedD ホストプロジェクトからのコンパイルの対象になり得るためには、コンポーネントは以下の要件に合致している必要があります: - コンポーネントは[プロジェクトアーキテクチャー](../Project/architecture.md) を使用している -- コンポーネントの[インタープリタコード](../Concepts/interpreted.md) が利用可能であり、コンポーネントが[コンパイルモードで実行中](#run-compiled) ではない +- コンポーネントの[インタープリターコード](../Concepts/interpreted.md) が利用可能であり、コンポーネントが[コンパイルモードで実行中](#run-compiled) ではない - コンポーネントが[直接型指定](#直接型指定の有効化) 宣言を使用している。 :::note @@ -345,7 +345,7 @@ Function scale($value : Real; $factor : Real) : Real ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.xml` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 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 0702fcad827c72..2e5cce67053f90 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md @@ -22,7 +22,7 @@ title: 依存関係 - **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。[プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 - **コンパイル版コンポーネント**の場合: - - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー推奨されるアーキテクチャー) + - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー (推奨されるアーキテクチャー) - *Resources* などの他のフォルダーを格納している.4DZ ファイル。 :::note @@ -90,7 +90,7 @@ title: 依存関係 **優先度高** 1. [プロジェクトの **Components** フォルダー](architecture.md#components) に置かれているコンポーネント -2. dependencies.json\*\*ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 +2. **dependencies.json**ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 3. 内部のユーザー4Dコンポーネント (4D NetKit、4D SVG など) **優先度低** @@ -505,7 +505,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ [GitHub または GitLab 依存関係](#components-stored-on-git-hosting-platforms) を追加する場合: -1. パネルのフッターエリア内の\*\*[+]\*\* をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 +1. パネルのフッターエリア内の **[+]** をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 ![dependency-add-git](../assets/en/Project/dependency-add-git.png) @@ -614,7 +614,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ これに加えて、単一の依存関係あるいは全ての依存関係に対して、いつでも更新をチェックすることができます: -- 単一の依存関係に対して更新をチェクするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 +- 単一の依存関係に対して更新をチェックするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 ![check component](../assets/en/Project/check-component-one.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$entityset.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$entityset.md index 191d18512b9287..633d4704c073ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$entityset.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$entityset.md @@ -93,7 +93,7 @@ title: $entityset ## $entityset/$release -[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します). +[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します。 ### 説明 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$filter.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$filter.md index c9e152f4e7e709..d1faeac4f05451 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/$filter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/$filter.md @@ -23,7 +23,7 @@ title: $filter **\{attribute\} {comparator} {value} {AND/OR/EXCEPT} \{attribute\} {comparator} {value}** -たとえば: `$filter="firstName=john AND salary>20000"` （`firstName` および `salary` は Employee データクラスの属性です)。 +たとえば: `$filter="firstName=john AND salary>20000"` (`firstName` および `salary` は Employee データクラスの属性です)。 ### paramsプロパティの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md index 6a84eede161efe..657a3c0f726e83 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/ClassFunctions.md @@ -10,8 +10,7 @@ REST リクエストを使って、ORDA データモデルに定義されてい - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 -POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、 -よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 +POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 ## 関数の呼び出し diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/REST/configuration.md b/i18n/ja/docusaurus-plugin-content-docs/current/REST/configuration.md index 5665216ee1b06e..0bba35e45972d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/REST/configuration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/REST/configuration.md @@ -72,7 +72,7 @@ REST 経由でアクセス可能なデータストアオブジェクトを制限 2. フィールドの **RESTリソースとして公開** オプションの選択を解除します。
    ![alt-text](../assets/en/REST/field.png)
    - Repeat this for each field whose exposure needs to be modified. + 公開設定を変更する各フィールドに対して、この手順を繰り返します。 > あるフィールドが REST を通してアクセス可能であるためには、その親テーブルも公開されている必要があります。親テーブルが公開されていない場合、各フィールドの公開設定に関わらず、すべてのフィールドがアクセス不可になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md index 85bd17028b0890..00f65b61dd81e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ServerWindow/real-time-monitor.md @@ -9,7 +9,7 @@ title: リアルタイムモニターページ > このページは、サーバーマシンの管理ウィンドウにありますが、リモートの 4Dマシンからも見られます。リモートマシンの場合は、サーバーマシン上で実行されている操作のデータを表示します。 -データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます。 +データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます)。 各行について、以下の情報が表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Tags/transformation-tags.md b/i18n/ja/docusaurus-plugin-content-docs/current/Tags/transformation-tags.md index dc98e8c94fccd7..dcd9855d063c4d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Tags/transformation-tags.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Tags/transformation-tags.md @@ -45,7 +45,7 @@ title: 変換タグ ### 再起的処理 -4Dタグは繰り返し解釈されます。 4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: +4Dタグは繰り返し解釈されます。4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: ```html @@ -61,7 +61,7 @@ title: 変換タグ ### "." を小数点として使用 -4D は常にピリオド文字 (.) `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 +4D は常にピリオド文字 (.) を小数点として使用して、 `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 ## 4DBASE @@ -631,7 +631,7 @@ return String(Current date) #### 代替シンタックス: `$4DTEXT(expression)` -タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: +タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: ```html

    へようこそ！

    diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/classes.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/classes.md index a8fa417ac13cf7..45c42624fbbc85 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/classes.md @@ -213,7 +213,7 @@ title: クラス **.borderHorizontal** : [cs.ViewPro.LineBorder](#lineborder) -`.borderBottom` プロパティは、 表の横の外枠線を定義します 。 +`.borderHorizontal` プロパティは、 表の横の外枠線を定義します 。 ### .borderVertical diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md index b3f7839d769622..c4402d1853e2f4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md @@ -26,7 +26,7 @@ title: VP SET ALLOWED METHODS `VP SET ALLOWED METHODS` コマンドは、4D View Pro フォーミュラから呼び出し可能なプロジェクトメソッドを指定します。このコマンドは、呼び出し後のセッション中に初期化される 4D View Pro エリアすべてに対して適用されます。同じセッション中において異なる設定で初期化をするために、複数回呼び出すこともできます。 -セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照)。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 +セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照))。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 *methodObj* には、4D View Pro エリア内で定義したいファンクションの名前をプロパティとして格納しているオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/configuring.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/configuring.md index 4534ca6d08685f..d4840e3838f306 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/configuring.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/configuring.md @@ -141,7 +141,7 @@ title: 4D View Pro エリアの設定 | 0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 | | 。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 | | , | 数値内に千区切りのカンマを表示します。数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 | -| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | +| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( や _) のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | | @ | テキストのフォーマット文字。セル内のすべてのテキストにフォーマットを適用します。 | "\[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 | | \* | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0\*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、\*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 | | " " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 | @@ -165,17 +165,17 @@ VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_ 4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています: -| 定数 | 値 | 説明 | -| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | -| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | -| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | -| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。 アメリカ合衆国でのデフォルトパターン: "MMMM dd" | -| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。 アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | -| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm" | -| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | -| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | -| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。 アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | +| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | +| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | +| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" | +| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | +| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" | +| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | +| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | +| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | #### 例題 @@ -339,9 +339,9 @@ VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time"; | firstPageNumber | longint | 最初のページに印刷するページ番号。 デフォルト値 = 1 | | pageOrder | longint | ページの印刷順。とりうる値: `vk print page order auto` (デフォルト), `vk print page order down then over`, `vk print page order over then down`. | | pageRange | text | 印刷されるページの範囲 | -| qualityFactor | longint | 印刷の品質指定 (1 - 8)。印刷の品質指定 (1 - 8)。 高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    デフォルト値 = 2

    | -| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    デフォルト値 = true

    | -| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    デフォルト値 = 1

    | +| qualityFactor | longint | 印刷の品質指定 (1 - 8)。高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    | +| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    | +| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    | ### 用紙サイズ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/formulas.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/formulas.md index c116d1342e49e5..07d3871922968b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/formulas.md @@ -217,7 +217,7 @@ $o.DRIVERS_LICENCE.parameters.push(New object("name"; "ID"; "type"; Is longint)) サポートされている引数の型の詳細については、[VP SET CUSTOM FUNCTIONS](commands/vp-set-custom-functions) コマンドの説明を参照ください。 -引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、 それらの型は自動的に変換されます。 +引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、それらの型は自動的に変換されます。 日付およびオブジェクト引数は次のように扱われます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md index c8a25208010148..3af63f8bcebdd4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/ViewPro/getting-started.md @@ -8,7 +8,7 @@ title: はじめに ![](../assets/en/ViewPro/vpSpreadsheet.png) スプレッドシートとは、セルのグリッドを格納したアプリケーションのことで、これらのセルに情報を入力したり、計算を実行させたり、あるいはピクチャーを表示したりすることができます。 4D View Proは、4Dに統合された [SpreadJS スプレッドシートソリューション](https://developer.mescius.com/spreadjs) に基づいて動作します。
    -(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します） +(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します) :::note 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 d6d10cc16b7cac..c96f14eac97f63 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/authentication.md @@ -150,7 +150,7 @@ BASICモードと同様に、ユーザーは接続時に自分の名前とパス `$IPClient` 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 #### $IPServer - サーバーIP アドレス 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 85b2cec25b2465..e9df1e44ef2ee1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/httpRequests.md @@ -85,7 +85,7 @@ title: HTTPリクエストの処理 $BrowserIP 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 ### $ServerIP - サーバーIP アドレス @@ -99,8 +99,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ ## /4DACTION -\*\*/4DACTION/\*\**MethodName*
    -\*\*/4DACTION/\*\**MethodName/Param* +**/4DACTION/***MethodName*
    +**/4DACTION/***MethodName/Param* | 引数 | 型 | | 説明 | | ---------- | ---- | :-: | --------------------- | @@ -111,8 +111,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。メソッドはこの引数を受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 -- `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。属性がチェックされていない場合、Webリクエストは拒否されます。 +- `/4DACTION/MethodName/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -120,7 +120,7 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND TEXT` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インターフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 @@ -150,7 +150,7 @@ WEB SEND BLOB($BLOB;"image/png") ### 4DACTION を使用してフォームをポスト -4D Webサーバーでは、ポストされたフォームを使用することもできます。 これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 +4D Webサーバーでは、ポストされたフォームを使用することもできます。これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 フォームは 2つのメソッドを使用してサブミットできます (4D では両方のタイプを使用できます): diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md index f45fb1de24ae42..994dc802e2efe1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/sessions.md @@ -3,7 +3,7 @@ id: sessions title: Webセッション --- -4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 +4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 Webセッションでは、以下のことが可能です: @@ -28,8 +28,7 @@ Webセッションでは、以下のことが可能です: Webセッションは次のものに使用されます: -- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する - [Web アプリケーション](gettingStarted.md) +- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する [Web アプリケーション](gettingStarted.md) - [リモートデータストア](../ORDA/remoteDatastores.md) や [Qodly ページ](https://developer.4d.com/qodly/) が使用する [REST API](../REST/authUsers.md) への呼び出し。 ## Webセッションの有効化 {#enabling-web-sessions} @@ -38,13 +37,13 @@ Webセッションは次のものに使用されます: - ストラクチャー設定の Web / オプション (I) ページの **スケーラブルセッション** を使用する (永続的な設定): ![alt-text](../assets/en/WebServer/settingsSession.png) -このオプションは、新規プロジェクトではデフォルトで選択されています。これは、 **セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 +このオプションは、新規プロジェクトではデフォルトで選択されています。これは、**セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 -- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します）。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 +- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します)。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 > メインの Webサーバーのセッションモードは、[`WEB SET OPTION`](../commands/web-set-option) コマンドを使って設定することもできます。 -いずれの場合も、設定はマシンに対しローカルなものです。 つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 +いずれの場合も、設定はマシンに対しローカルなものです。つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 > **互換性について**: 4D v18 R6 以前の 4Dバージョンで作成されたプロジェクトでは、**旧式セッション** オプションが使用できます (詳細については、[doc.4d.com](https://doc.4d.com) の Webサイトを参照ください)。 @@ -58,13 +57,13 @@ Webセッションは次のものに使用されます: ::: -1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID__AppName_" cookie の存在と値をチェックします。 +1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID_*AppName*" cookie の存在と値をチェックします。 2. cookie に値がある場合、4D は既存セッションの中からこのクッキーを作成したセッションを探し、見つかった場合には再利用します。 3. クライアントからのリクエストが、すでに開かれているセッションに対応していない場合: -- プライベートな "4DSID__AppName_" cookie を持つ新しいセッションが Webサーバー上に作成されます。 +- プライベートな "4DSID_*AppName*" cookie を持つ新しいセッションが Webサーバー上に作成されます。 - 新しいゲスト `Session` オブジェクトが作成され、このスケーラブルWebセッション専用に使用されます。 :::note @@ -488,7 +487,7 @@ Function validateEmail() : 4D.OutgoingMessage セッショントークンにはライフスパン(有効期限)があり、またセッション自身にもライフスパンがあります。セッショントークンのライフスパンは、[トークン作成時](../API/SessionClass.md#createotp) に設定することが可能です。デフォルトで、トークンのライフスパンは[`.idleTimeout`](../API/SessionClass.md#idletimeout) の値と同じ値となっています。 -セッショントークンのライフパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 +セッショントークンのライフスパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md index a330c809b15b83..13b57a83ba90d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/templates.md @@ -69,14 +69,14 @@ title: テンプレートページ 内部的には、パーサーは UTF-16 文字列で動作しますが、解析するデータは異なる方法でエンコードされている場合があります。タグにテキストが含まれている場合 (`4DHTML` など)、提供されている情報 (charset) や出所に応じて、4D は必要に応じてデータを変換します。以下に、HTMLページに含まれるタグを 4D が解析する場合と、おこなわれる変換を示します: -| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | -| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND TEXT` | X | - | 変換は不要です。 | -| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | +| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | +| ---------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND FILE` | ○ | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND TEXT` | ○ | - | 変換は不要です。 | +| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `` タグによる挿入 | ○ | ○ | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | (\*) 4DHTML、4DTEXT、4DEVALタグにおいては、代替の $ベースシンタックスが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md index ead05535cfbb3c..0c25f6b1adaef9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WebServer/webServerConfig.md @@ -64,7 +64,7 @@ Webサーバー用の TLS証明書ファイルが置かれているフォルダ | ---------------- | -------------------------------------------------- | ---- | | webServer オブジェクト | [`cipherSuite`](API/WebServerClass.md#ciphersuite) | Text | -セキュアプロトコルに使用される暗号リストです。 Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 +セキュアプロトコルに使用される暗号リストです。Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 > 4D が使用するデフォルトの暗号リストは、`SET DATABASE PARAMETER` コマンドを使用してセッションごとに変更することができます。この場合、変更は 4Dアプリケーション全体に適用されます (Webサーバー・SQLサーバー・クライアント/サーバー接続、HTTPクライアント、セキュアプロトコルを使用するすべての 4Dコマンドを含む)。 @@ -133,7 +133,7 @@ Webサーバーの HTTPリクエストログファイル (アプリケーショ | 設定できる場所 | 名称 | コメント | | ------------------- | ---------------------------------------------------------- | ----------------- | -| webServer オブジェクト | [`defaultHomepage`](API/WebServerClass.md#defaulthomepage) | Text | +| webServer オブジェクト | [`defaultHomepage`](API/WebServerClass.md#defaulthomepage) | テキスト | | `WEB SET HOME PAGE` | | Webプロセス毎に異なる設定が可能 | | 設定ダイアログボックス | [設定ページ / デフォルトホームページ](../settings/web.md#デフォルトホームページ) | | @@ -161,7 +161,7 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" | `WEB SET OPTION` | `Web CORS enabled` | 0 (デフォルト値; 無効) または 1 (有効) | | 設定ダイアログボックス | [オプション (II) ページ / CORSを有効化](../settings/web.md#corsを有効化) | デフォルトではチェックなし | -4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 +4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。後述の CORSSettings 参照)。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 無効化されている場合 (デフォルト) には、CORS で送信されたサイト間リクエストはすべて無視されます。 @@ -255,7 +255,7 @@ HTTP接続を受け付ける IP (TCP) ポート番号。デフォルトで、4D デフォルトでない HTTPポート番号を使用して公開された Webアプリケーションに接続するには、Webブラウザーで入力するアドレスにポート番号を含めなければなりません。アドレスの後にコロンに続けてポート番号を指定します。たとえば、HTTPポート番号 8080を使用する場合、"123.4.567.89:8080" のように書きます。 -> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。 また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 +> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 0 を指定すると、4D はデフォルトの HTTPポート番号 80を使用します。 @@ -320,7 +320,7 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。デフォル - **TCPポートが使用済みでも警告は出ません**
    サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 -定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 +定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - **IPv4-マップされた IPv6アドレス**
    プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 @@ -456,9 +456,9 @@ Webサーバーの PFS利用可否状況 ([TLS](Admin/tls.md#perfect-forward-sec ## 一時的なコンテキストを再利用する (リモートモード) -| 設定できる場所 | 名称 | コメント | -| ----------- | --------------------------------------------------------------------------------------------------------------------- | ---- | -| 設定ダイアログボックス | [[オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | +| 設定できる場所 | 名称 | コメント | +| ----------- | ------------------------------------------------------------------------------------------ | ---- | +| 設定ダイアログボックス | [オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | > このオプションは、**セッションなし** オプションがチェックされている場合にのみ利用できます。 @@ -524,9 +524,9 @@ User-Agent: デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 -- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアパッケージを含むフォルダーです (4Dリモートモード)。 - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 -- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。置きます。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/managing-formulas.md b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/managing-formulas.md index ce1649c081b77c..7cd11889334857 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/managing-formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/WritePro/managing-formulas.md @@ -6,7 +6,7 @@ slug: /WritePro/formulas ## 概要 -4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは4D コマンドなどの4D フォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 +4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは 4Dコマンドなどの 4Dフォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 4D Write Pro エリアへのフォーミュラの挿入には [**WP Insert formula**](commands/wp-insert-formula.md) コマンドを使用し、フォーミュラの読み出しには[**WP Get formulas**](commands-legacy/wp-get-formulas.md) コマンドを使用します。また、[**WP Get text**](commands-legacy/wp-get-text.md) コマンドを使用することでも返されます。 @@ -191,7 +191,7 @@ slug: /WritePro/formulas ### 参照を名前で表示 -フォーミュラには名前を割り当てることができ、これによって4D Write Proテンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 +フォーミュラには名前を割り当てることができ、これによって4D Write Pro テンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 例えば、以下のフォーミュラ参照はデフォルトではソーステキストとして表示されます: @@ -201,7 +201,7 @@ slug: /WritePro/formulas ![](../assets/en/WritePro/wp-formulas6.png) -フォーミュラに名前を割り当てるためには、 [WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: +フォーミュラに名前を割り当てるためには、[WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: ```4d // ドキュメント内に昨日の日付を挿入する diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatAPI.md b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatAPI.md index afb23bcb930605..5a30faa1791b01 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/aikit/Classes/OpenAIChatAPI.md @@ -22,7 +22,7 @@ title: OpenAIChatAPI | 引数 | 型 | 説明 | | -------------- | --------------------------------------- | ------------------------- | -| *systemPrompt* | Text | チャットを初期化するシステムプロント。 | +| *systemPrompt* | Text | チャットを初期化するシステムプロンプト。 | | 戻り値 | [OpenAIChatHelper](OpenAIChatHelper.md) | チャットのやり取りを管理するヘルパーインスタンス。 | #### 使用例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/server/menus.md b/i18n/ja/docusaurus-plugin-content-docs/current/server/menus.md index a4b9a959a1fbeb..335ae2a53ae99a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/server/menus.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/server/menus.md @@ -5,7 +5,7 @@ title: メニュー 4D Server アプリケーションのインタフェースは以下のメニューで構成されています: **ファイル**、**編集**、**ウィンドウ**、**ヘルプ**。 macOS ではいくつかのコマンドは**4D Server** メニュー (アプリケーションメニュー) に置かれます。 -## File +## ファイル ### 新規 @@ -67,7 +67,7 @@ macOS では**終了**コマンドは**4D Server** メニュー (アプリケー :::note -macos では、**環境設定... \*\* コマンドは**4D Server\*\* メニュー (アプリケーションメニュー) 内にあります。 +macos では、**環境設定...** コマンドは **4D Server** メニュー (アプリケーションメニュー) 内にあります。 ::: @@ -137,4 +137,4 @@ macos では、**環境設定... \*\* コマンドは**4D Server\*\* メニュ ### 4D Serverについて... -このコマンドは\*\*4D Server について... \*\* ウィンドウを表示します。 +このコマンドは **4D Server について...** ウィンドウを表示します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/server/service.md b/i18n/ja/docusaurus-plugin-content-docs/current/server/service.md index 05d3608f3cf2e5..c4b416a832cfba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/server/service.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/server/service.md @@ -5,7 +5,7 @@ title: サービスとして登録 Windowsにおいて、4D Server をサービスとして起動することができます。 -サービスとして登録された4D Server アプリケーションはマシンの開始時に自動で、ユーザセッションが開かれる前に、カレントのプロジェクトを使用して起動されます。またユーザがセッションを終了したときも、データベースは閉じられません。 +サービスとして登録された 4D Server アプリケーションはマシンの開始時に自動で、ユーザーセッションが開かれる前に、カレントのプロジェクトを使用して起動されます。またユーザがセッションを終了したときも、データベースは閉じられません。 この動作により、マシンの再起動が必要になるような出来事の場合でも、4D Server が実行されるようにすることができます。またメンテナンスをリモートで行うことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/ai.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/ai.md index 87bef924be3328..67e8f3d64ebdf4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/ai.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/ai.md @@ -59,7 +59,7 @@ AI プロバイダーを追加するには: ### APIキー -(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報をが必要になる場合もあります。 +(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報が必要になる場合もあります。 ### 組織 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md index d6c4ba18023c01..0a03a6c9f7dd3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/interface.md @@ -66,7 +66,7 @@ title: インターフェースページ ### Windows 上でFluent UI を使用 -このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトでWindows クラシクUI レンダリングテーマが使用されます。 +このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトで Windows クラシック UI レンダリングテーマが使用されます。 > このオプションはWindows でのみ使用され、macOS では何の効果もありません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md index 2a88a210dfdf79..ec13f3b380c87e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md @@ -523,7 +523,7 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] #### 例題 1 -通常の (非共有の) コレクション *$lastnames \* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames\*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -545,7 +545,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と\*$sharedColl2\* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と *$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md index 557edf3c2212d6..a333b87746d6c2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md @@ -881,7 +881,7 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: -- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 .4Dindx ファイル) で暗号化されます。 +- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 - 暗号化可能テーブルから読み出したすべてのデータは、メモリ内で復号化されます。 **戻り値** 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 58ffac4cae9996..afec15a7cf3444 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 @@ -527,7 +527,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: - オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換) 参照)、それ以外の場合にはその属性は更新されません。 - プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -904,9 +904,9 @@ $info:=$address.getRemoteContextAttributes()
    -| 引数 | 型 | | 説明 | -| --- | ------- | :-------------------------: | ------------------------------------------------------ | -| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。 それ以外は false。それ以外は false。 | +| 引数 | 型 | | 説明 | +| --- | ------- | :-------------------------: | ----------------------------------------- | +| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。それ以外は false。 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md index dbfa5161d29993..9376e6f21139ca 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntitySelectionClass.md @@ -2069,9 +2069,9 @@ pathObjects コレクションには必要な数だけオブジェクトを追 | ranges[].start | Integer | レンジ内の先頭エンティティのインデックス (位置) | | ranges[].end | Integer | レンジ内の最終エンティティのインデックス (位置) | -`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。 インデックスは 0 起点です。インデックスは 0 起点です。 +`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。インデックスは 0 起点です。 -元のエンティティセレクションと *entitySelection* の両方が空であった場合、空のエンティティセレクションが返されます。 元のエンティティセレクションが空であった場合、*entitySelection* への参照、あるいは *entity* のみを格納したエンティティセレクションが返されます。 +呼び出し対象のエンティティセレクション、または *selectedEntities* のエンティティセレクションが空の場合、関数は `ranges` に空のコレクションを返します。 #### 例題 @@ -2114,7 +2114,7 @@ $result2:=$invoices.selected($creditSel) | 引数 | 型 | | 説明 | | --------- | ---------------------------------- | :-------------------------: | ---------------------------------------------------------- | -| startFrom | Integer | -> | 処理を開始するインデックス) | +| startFrom | Integer | -> | 処理を開始するインデックス | | end | Integer | -> | 終了インデックス (含まれない) | | 戻り値 | 4D.EntitySelection | <- | 抜粋エンティティを格納した新しいエンティティセレクション (シャロウ・コピー) | 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 e6b501840d311c..bed269df324323 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 @@ -5,7 +5,7 @@ title: HTTPRequest `HTTPRequest` クラスを使って、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を扱うことができます。このオブジェクトは、HTTPサーバーへのリクエストの設定と送信、および HTTPサーバーのレスポンスを処理するのに使用します。 -`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 +`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。
    履歴 @@ -180,7 +180,7 @@ HTTPRequest オブジェクトは次のプロパティや関数を提供しま | プロパティ | 型 | 説明 | | --------------------- | ---- | ------------------------------------------------------------------------------------- | -| .data | blob | 取得データ。取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | +| .data | blob | 取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | | .type | text | イベントの種類。取り得る値: "response", "error", "headers", "data", または "terminate | #### authentication オブジェクト @@ -282,9 +282,9 @@ authentication オブジェクトは `options.serverAuthentication` または `o
    履歴 -| リリース | 内容 | -| ----- | ----------------------------------------------------------------------- | -| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 `.rawHeaders` プロパティの追加 | +| リリース | 内容 | +| ----- | ------------------------------------------------ | +| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md index 15d7b6af897691..46b4044ea68623 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md @@ -1186,12 +1186,12 @@ ID = 1のメッセージを取得します:
    -| 引数 | 型 | | 説明 | -| ---------- | ------- | :-------------------------: | --------------------------------------------------------------------------------------- | -| msgNumber | Integer | -> | メッセージのシーケンス番号 | -| msgID | Text | -> | メッセージの固有ID | -| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 false 時にはメッセージの状態は変化しません。 | -| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB | +| 引数 | 型 | | 説明 | +| ---------- | ------- | :-------------------------: | ------------------------------------------------------------- | +| msgNumber | Integer | -> | メッセージのシーケンス番号 | +| msgID | Text | -> | メッセージの固有ID | +| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 | +| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB |
    @@ -1699,13 +1699,11 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" - **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。複数指定する場合にはスペースで区切ります。例: `searchCriteria = KEYWORD \Flagged \Draft` -- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    +- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/MailAttachmentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/MailAttachmentClass.md index c53453942b6866..b00f4d04dee225 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/MailAttachmentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/MailAttachmentClass.md @@ -217,7 +217,7 @@ $transporter.send($email) #### 説明 -`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。 二つの値が利用可能です: 二つの値が利用可能です: +`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。二つの値が利用可能です: - "inline": 添付ファイルはメッセージコンテンツ内に、"cid"の場所にレンダリングされます。レンダリングの結果はメールクライアントによって異なります。 - "attachment": 添付ファイルはメッセージ内でリンクとして提供されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/SystemWorkerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/SystemWorkerClass.md index 8578d3dd8652ac..4f1d1f54af14e8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/SystemWorkerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/SystemWorkerClass.md @@ -3,7 +3,7 @@ id: SystemWorkerClass title: SystemWorker --- -システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 +システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 `SystemWorker` クラスは、`4D` クラスストアにて提供されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/about.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/about.md index 96236d111fcf81..86efb2a3370abf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/about.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/about.md @@ -1,9 +1,9 @@ --- id: about -title: 4Dは独自のプログラミング言語を持っています。 +title: 4D ランゲージについて --- -1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: +4Dは独自のプログラミング言語を持っています。1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: - クエリや並べ替えなどのレコード管理エディターにプログラムでアクセスする - データベースの情報をもとに複雑なレポートやラベルを作成・印刷する @@ -17,9 +17,9 @@ title: 4Dは独自のプログラミング言語を持っています。 ## 4D ランゲージとは -4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。 このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 +4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 -4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。 言葉を交わすために言語のすべてを知る必要がないのと同じです。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 +4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 ## なぜランゲージを使用するのか @@ -42,7 +42,7 @@ title: 4Dは独自のプログラミング言語を持っています。 4D ランゲージのコマンドを使用して標準のレコード管理エディターにアクセスできます。たとえば、デザインモードにおいて「クエリ」ツールバーボタンを使って開けるクエリエディターは、`QUERY` コマンドを使用することでも表示されます。さらに、QUERY コマンドを使用すれば、エディターを開かなくても指定したデータを検索できるのです。たとえば `QUERY ([People];[People]Last Name="Smith")` と記述すると、データベースから "Smith" という名前の人物をすべて検索します。 -ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 +4D ランゲージはとてもパワフルです。ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 4D ランゲージは、ほとんどのタスクを簡単に実行できるようデザインされています。レコードの追加、並べ替え、データの検索などの操作がシンプルなコマンドで提供されています。さらにコマンドを使用してシリアルポートのコントロール、ディスク上のドキュメントの読み込み、高度なトランザクション処理等を行うこともできるのです。 @@ -56,6 +56,6 @@ title: 4Dは独自のプログラミング言語を持っています。 従来の言語を使用して開発を行う場合、まず念入りに計画を立てる必要があります。実際、計画の立案は開発の重要な工程の1つです。 4D においては、プロジェクトのあらゆる部分でいつでもランゲージを使いはじめることができます。たとえば、初めにフォームにメソッドを追加し、いくつかのメソッドをあとから追加することができます。アプリケーションがより高度になったら、メニューから実行するプロジェクトメソッドを追加することもできます。 4D ランゲージは好きなだけ利用することができます。他の多くのデータベースのような "すべてか無か" ではありません。 -従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。 作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 +従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 従来の言語は、コマンドの記述方法を制限するなどして、融通性に欠けることが多いのに対し、 4D ランゲージは伝統に縛られることなく進化していきます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/arrays.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/arrays.md index a4d7ea23e3f920..f3a066416796ae 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/arrays.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/arrays.md @@ -3,7 +3,7 @@ id: arrays title: 配列 --- -**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 +**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 > ほとんどの場合において、**配列** より **コレクション** の利用が推奨されます。コレクションは配列より柔軟なだけでなく、たくさんの専用メソッドを持ちます。詳細については、[コレクション](Concepts/dt_collection.md) を参照してください。 @@ -31,7 +31,7 @@ ARRAY INTEGER(aiAnArray;0) ## 配列要素への値の代入 -配列中の要素は中カッコ ({… }) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: +配列中の要素は中カッコ ({…}) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: ```4d ARRAY TEXT(atNames;5) @@ -93,7 +93,7 @@ atNames{$vlElem} というシンタックスに注目してください。 atNam 上のコードで作成した atTopics 配列について、次のことが言えます: - atTopics は、2次元配列です。 -- atTopics{8}{5} は、 8行5列目の要素です。 8行5列目の要素です。 +- atTopics{8}{5} は、 8行5列目の要素です。 - atTopics{20} は 20行目を指し、それ自体が 1次元の配列です。 - `Size of array(atTopics)` は、行数の 100を返します。 - `Size of array(atTopics{17})` は、17行目の列数である50を返します。 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 482a8b647cf937..b21a9a38568af8 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 @@ -377,7 +377,7 @@ $o:=cs.MyClass.new("John";42) :::info -`property` キーワードは、クラス関数内の `Function` および `Class constructor` ブロック外でのみ使用できます。 +`property` キーワードは、クラス関数において `Function` および `Class constructor` ブロック外でのみ使用できます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md index 13ad04d36241ac..6e896394d1a7d5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md @@ -7,25 +7,25 @@ title: データタイプの概要 この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: -| データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md#var-キーワードによる宣言) | [`C_` または `ARRAY` 宣言](variables.md#c_-指示子による宣言) | -| ----------------------------------------------------- | -------------------------- | -------- | --------------------------------------- | ----------------------------------------------- | -| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | -| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `C_TEXT`, `ARRAY TEXT` | -| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `C_DATE`, `ARRAY DATE` | -| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `C_TIME`, `ARRAY TIME` | -| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `C_BOOLEAN`, `ARRAY BOOLEAN` | -| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | -| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `C_LONGINT`, `ARRAY LONGINT` | -| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | -| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `C_REAL`, `ARRAY REAL` | -| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `C_POINTER`, `ARRAY POINTER` | -| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `C_PICTURE`, `ARRAY PICTURE` | -| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `C_BLOB`, `ARRAY BLOB` | -| [オブジェクト](Concepts/dt_object.md) | ◯ | ◯ | `Object` | `C_OBJECT`, `ARRAY OBJECT` | -| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | `C_COLLECTION` | -| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | `C_VARIANT` | +| データタイプ | データベース (1) | ランゲージ | [`var` 宣言](variables.md#var-キーワードによる宣言) | [`C_` または `ARRAY` 宣言](variables.md#c_-指示子による宣言) | +| ----------------------------------------------------- | ----------------------------- | -------- | --------------------------------------- | ----------------------------------------------- | +| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | +| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `C_TEXT`, `ARRAY TEXT` | +| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `C_DATE`, `ARRAY DATE` | +| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `C_TIME`, `ARRAY TIME` | +| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `C_BOOLEAN`, `ARRAY BOOLEAN` | +| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | +| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `C_LONGINT`, `ARRAY LONGINT` | +| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | +| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `C_REAL`, `ARRAY REAL` | +| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `C_POINTER`, `ARRAY POINTER` | +| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `C_PICTURE`, `ARRAY PICTURE` | +| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `C_BLOB`, `ARRAY BLOB` | +| [オブジェクト](Concepts/dt_object.md) | ◯ | ◯ | `Object` | `C_OBJECT`, `ARRAY OBJECT` | +| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | `C_COLLECTION` | +| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | `C_VARIANT` | (1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 @@ -54,7 +54,7 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的 な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_blob.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_blob.md index 239bc92a11bccb..554882b1efb29a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_blob.md @@ -140,7 +140,7 @@ $type:= OB Instance of($myObject.blob; 4D.Blob) // true // 4D.Blob から スカラーBLOB への変換 $myBlob:= $myObject.blob -$type:= +$type:= Value type($myBlob) // Blob ``` > `4D.Blob` をスカラーBLOB に変換する際に、`4D.Blob` のサイズがスカラーBLOB の最大サイズを超える場合、結果のスカラーBLOB は空になります。たとえば、スカラーBLOB の最大サイズが 2GB の場合、2.5GB の `4D.Blob` をスカラーBLOB に変換すると、空の BLOB が得られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_boolean.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_boolean.md index a43fa87dd4188d..1db75d8479b445 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_boolean.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_boolean.md @@ -58,7 +58,7 @@ myBoolean:=(myButton=1) | false | true | true | | false | false | false | -**Tip:** 式1と式2の排他的結合子演算を実行する必要がある場合、次の評価式を使用します: +**Tip:** 式1と式2の排他的論理和を実行する必要がある場合、次の評価式を使用します: ```4d (Expr1|Expr2) & Not(Expr1 & Expr2) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_collection.md index efc8b4a74f5a44..1635801f5b7b11 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_collection.md @@ -29,7 +29,7 @@ collectionRef[expression] $myVar:=myCol[0] ``` -コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます: +コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられます: ```4d var myCol : Collection @@ -106,7 +106,7 @@ $users:=[{name: "Alice"; \ 二種類のコレクションを作成することができます: - [`New collection`](API/CollectionClass.md#new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared collection`](API/CollectionClass.md#new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 +- [`New shared collection`](API/CollectionClass.md#new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_date.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_date.md index 9189c0abff8a68..b8037df74fbf93 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_date.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_date.md @@ -11,7 +11,7 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付リテラル -日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) 下記に、日付定数の例を示します: +日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) を使って記述します。下記に、日付定数の例を示します: ```4d !1976-01-01! @@ -30,20 +30,20 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付演算子 -| 演算 | シンタックス | 戻り値 | 式 | 値 | -| ----- | ------------------------------------- | ------- | --------------------------- | ------------ | -| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | -| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | -| 日付の減算 | Date – Number | Date | !2017-01-20! !2017-01-20! | !2017-01-11! | -| 等しい | Date = Date | Boolean | !2017-01-20! = !2017-01-01! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 異なる | Date # Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 大きい | Date > Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 小さい | Date < Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 以上 | Date >= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-01!>=!2017-01-20! | false | -| 以下 | Date <= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | +| 演算 | シンタックス | 戻り値 | 式 | 値 | +| ----- | ------------------------------------- | ------- | ----------------------------------------------------- | ------------ | +| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | +| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | +| 日付の減算 | Date – Number | Date | !2017-01-20! - 9 | !2017-01-11! | +| 等しい | Date = Date | Boolean | !2017-01-20! =!2017-01-20! | true | +| | | | !2017-01-20! = !2017-01-01! | false | +| 異なる | Date # Date | Boolean | !2017-01-20! # !2017-01-01! | true | +| | | | !2017-01-20! # !2017-01-20! | false | +| 大きい | Date > Date | Boolean | !2017-01-20! > !2017-01-01! | true | +| | | | !2017-01-20! > !2017-01-20! | false | +| 小さい | Date < Date | Boolean | !2017-01-20! < !2017-01-20! | true | +| | | | !2017-01-20! < !2017-01-20! | false | +| 以上 | Date >= Date | Boolean | !2017-01-20! >=!2017-01-01! | true | +| | | | !2017-01-01!>=!2017-01-20! | false | +| 以下 | Date <= Date | Boolean | !2017-01-20! <= !2017-01-20! | true | +| | | | !2017-01-20! <= !2017-01-01! | false | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_null_undefined.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_null_undefined.md index 4dae09b152a07a..f8474b9dafa558 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_null_undefined.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_null_undefined.md @@ -23,7 +23,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ フィールドは、未定義にはできません (フィールドの場合、`Undefined` コマンドは常に False を返します)。 -未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。 ただし以下の場合には生成されません: +未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。ただし以下の場合には生成されません: - 未定義の値を (配列を除く) 変数に割り当てることは、[`CLEAR VARIABLE`](https://doc.4d.com/4dv20/help/command/ja/page89.html) コマンドを使うのと同じ効果があります: @@ -41,7 +41,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ - ブール: False - 文字列: "" - 数値: 0 - - 日付: 日付: 日付: 日付: 日付: 日付: "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" + - 日付: !00-00-00! "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" - 時間: 0 (ミリ秒単位) - 未定義、Null: 変化なし @@ -51,7 +51,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ $o.a:=$o.b //$o.a=0 ``` -- 未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +- 未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 - 未定義の値を引数としてプロジェクトメソッドに渡した場合、宣言された引数の型に応じて、0 あるいは "" (空の文字列) へと自動変換されます。 @@ -97,7 +97,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ | | Null `#` Undefined | Boolean | a.nullProp `#` b.undefinedProp | false | | | Null `#` *scalar value* | Boolean | a.nullProp `#` 42 | true | -*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でもnull でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: +*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でも null でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: ```4d var $object : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_number.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_number.md index 125228e988317a..75e2ddbdda1e4f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_number.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_number.md @@ -65,7 +65,7 @@ title: 数値 (実数、倍長整数、整数) - 10 % 2は、0を返します。 10 は 2 で割り切れるからです。 - 10 % 3は、1を返します。 余りが 1 だからです。 -- 10.5 % 2は、0を返します。 余りが整数ではない (0.25) からです。 +- 10.5 % 2は、0を返します。 余りが整数ではない (0.5) からです。 :::warning diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_object.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_object.md index 8d2a936b310430..6ba385839c7e59 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_object.md @@ -111,7 +111,7 @@ $col:=$o.col[5] // 6 二種類のオブジェクトを作成することができます: - [`New object`](https://doc.4d.com/4Dv20/4D/20/New-object.301-6237618.ja.html) コマンド、またはオブジェクトリテラルのシンタックス `{}` 使用して作成する通常 (非共有) オブジェクト。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New object`](https://doc.4d.com/4Dv20/4D/20/New-object.301-6237618.ja.html) コマンド、またはオブジェクトリテラルのシンタックス `{}` 使用して作成する通常 (非共有) オブジェクト。 通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 +- [`New object`](https://doc.4d.com/4Dv20/4D/20/New-object.301-6237618.ja.html) コマンド、またはオブジェクトリテラルのシンタックス `{}` 使用して作成する通常 (非共有) オブジェクト。 通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。共有オブジェクトはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## プロパティ{#properties} @@ -183,7 +183,7 @@ $col:=$o.col[5] // 6 ### Null 値 -オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。 例: +オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。例: ```4d myObject.address.zip:=Null @@ -194,7 +194,7 @@ $col:=$o.col[5] // 6 ### 未定義の値 -オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 詳細については [Null と 未定義](dt_null_undefined.md) を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_picture.md index e03baf3935ae90..79d48f23a05ca0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_picture.md @@ -33,8 +33,8 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを | -------- | ------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 水平連結 | Pict1 + Pict2 | Picture | Pict1 の右側に Pict2 を追加します | | 垂直連結 | Pict1 / Pict2 | Picture | Pict1 の下側に Pict2 を追加します | -| 排他的論理和 | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | -| 包括的論理和 | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | +| 排他的重ね合わせ | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | +| 包括的重ね合わせ | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | | 水平移動 | Picture + Number | Picture | 指定ピクセル分、ピクチャーを横に移動します。 | | 垂直移動 | Picture / Number | Picture | 指定ピクセル分、ピクチャーを縦に移動します。 | | リサイズ | Picture \* Number | Picture | 割合によってピクチャーをサイズ変更します。 | @@ -71,7 +71,7 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを ![](../assets/en/Concepts/concatVer.en.png) ![](../assets/en/Concepts/concatVer2.en.png) -排他的論理和 +排他的重ね合わせ ```4d Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 @@ -79,7 +79,7 @@ Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 ![](../assets/en/Concepts/superimpoExc.fr.png) -包括的論理和 +包括的重ね合わせ ```4d Pict3:=Pict1|Pict2 // 同じサイズの二つのピクチャーを重ね合わせた上でそのマスクの結果を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_pointer.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_pointer.md index 1d9ba198b3a121..be475e2ce46d56 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_pointer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_pointer.md @@ -3,7 +3,7 @@ id: pointer title: Pointer --- -ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、またはフィールドへの参照です。ポインタータイプのフィールドは、存在しません。 +ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、フィールド、またはオブジェクトへの参照です。ポインタータイプのフィールドは、存在しません。 ポインターは、(プログラミングにおける) データを参照するための高度な方法を提供します。 4D ランゲージ使用時にテーブル・フィールド・変数・配列等にアクセスするには、単純に名前を用います。ですが、名前を使用しないでデータを参照する、またはアクセスした方が便利な場合もあります。ポインターを使うとこれが実現できます。 @@ -47,7 +47,7 @@ $MyPointer-> 前述の式は、"Hello" という文字列を返します。ポインター記号 (->) をポインターの後につけると、参照先の値を取得することができます。これをデリファレンス (参照外し) と呼びます。 -ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、オリジナルの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: +ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、もとの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: ```4d ALERT($MyPointer->) @@ -59,7 +59,7 @@ $MyPointer を使用して $MyVar の値を変更することもできます。 $MyPointer->:="Goodbye" ``` -この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。 両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: +この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: ```4d ALERT($MyPointer->) @@ -154,7 +154,7 @@ $FieldPtr:=Field(1;2) OBJECT SET FONT($FieldPtr->;"Arial") ``` -### 変数へのポインター +### ローカル変数へのポインター プロセス変数またはローカル変数のポインターを使う場合、参照される変数はポインターが使用される時点ですでに定義されていなければなりません。ローカル変数は、それらを作成したメソッドの実行が終わると破棄され、プロセス変数もそれを作成したプロセスの終了時に削除される点に留意してください。存在しない変数をポインターで呼び出そうとすると、インタープリターモードでは (「変数が設定されていません」という内容の) シンタックスエラーが起きます。コンパイルモードでは、さらに重大なエラーが発生する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_time.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_time.md index 390e3dc18ced86..ca6ffc508daba8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_time.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_time.md @@ -7,7 +7,7 @@ title: Time 時間は 24時間制です。 -時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す総秒数です。 +時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す深夜0時からの総秒数です。 **注:** *4Dランゲージリファレンス* マニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。 @@ -25,7 +25,7 @@ title: Time ?13:01:59? // 午後1時1分59秒 ``` -空の時間は、?00.00.00? のように指定します。 +空の時間は、?00:00:00? のように指定します。 **Tip:** コードエディターでは空の時間を入力するためのショートカットが提供されています。空の時間を入力するには、疑問符 (?) の入力後に Enterキーを押します。 @@ -34,26 +34,26 @@ title: Time | 演算 | シンタックス | 戻り値 | 式 | 値 | | --------------------------- | ------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | 加算 (足し算) | Time + Time | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? | -| 減算 (引き算) | Time – Time | Time | ?02:03:04? ?01:02:03? | ?01:01:01? | +| 減算 (引き算) | Time – Time | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? | | 加算 (足し算) | Time + Number | Number | ?02:03:04? + 65 | 7449 | -| 減算 (引き算) | Time – Number | Number | ?02:03:04? ?01:02:03? | 7319 | -| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? ?01:02:03? | 14768 | -| 除算 (割り算) | Time / Number | Number | ?02:03:04? ?01:02:03? | 3692 | -| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? ?02:03:04? | 3692 | +| 減算 (引き算) | Time – Number | Number | ?02:03:04? – 65 | 7319 | +| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? \* 2 | 14768 | +| 除算 (割り算) | Time / Number | Number | ?02:03:04? / 2 | 3692 | +| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? \ 2 | 3692 | | モジューロ | Time % Time | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? | | モジューロ | Time % Number | Number | ?02:03:04? % 2 | 0 | -| 等しい | Time = Time | Boolean | ?01:02:03? >=?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 異なる | Time # Time | Boolean | ?01:02:03? ?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 大きい | Time > Time | Boolean | ?01:02:03? > ?01:02:03? | true | +| 等しい | Time = Time | Boolean | ?01:02:03? = ?01:02:03? | true | +| | | | ?01:02:03? = ?01:02:04? | false | +| 異なる | Time # Time | Boolean | ?01:02:03? # ?01:02:04? | true | +| | | | ?01:02:03? # ?01:02:03? | false | +| 大きい | Time > Time | Boolean | ?01:02:04? > ?01:02:03? | true | | | | | ?01:02:03? > ?01:02:03? | false | | 小さい | Time < Time | Boolean | ?01:02:03? < ?01:02:04? | true | | | | | ?01:02:03? < ?01:02:03? | false | | 以上 | Time >= Time | Boolean | ?01:02:03? >=?01:02:03? | true | | | | | ?01:02:03? >=?01:02:04? | false | | 以下 | Time <= Time | Boolean | ?01:02:03? <=?01:02:03? | true | -| | | | ?01:02:03? <=?01:02:03? | false | +| | | | ?01:02:04? <=?01:02:03? | false | ### 例題 1 @@ -78,7 +78,7 @@ $vhSoon:=Time(Current time+3600) ### 例題 2 -モジューロ演算子を使用できます。 とくに24時間フォーマットを考慮した時間の追加に便利です: +モジューロ演算子を使用できます。とくに24時間フォーマットを考慮した時間の追加に便利です: ```4d $t1:=?23:00:00? // 23時です diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_variant.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_variant.md index 2bd8bceb2d1757..bba34e04c439d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_variant.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/dt_variant.md @@ -37,7 +37,7 @@ $vtype:=Type($variant) // 12 (Is variant) $vtypeVal:=Value type($variant) // 1 (Is real) ``` -変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。 ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: +変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: ```4d C_VARIANT($v) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/error-handling.md index 9cf1aeb20bb9ef..19f16e69d2ea7b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/error-handling.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/error-handling.md @@ -40,7 +40,7 @@ ON ERR CALL("IO_Errors";ek local) // ローカルなエラー処理メソッド ON ERR CALL("";ek local) // ローカルプロセスにおいてエラーの検知を中止します ``` -[`Method called on error`](https://doc.4d.com/4dv19/help/command/en/page704.html) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。 エラー処理メソッドを一時的に変更し、後で復元することができます: +[`Method called on error`](https://doc.4d.com/4dv19/help/command/en/page704.html) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。エラー処理メソッドを一時的に変更し、後で復元することができます: ```4d $methCurrent:=Method called on error(ek local) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/flow-control.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/flow-control.md index c293f1468ed6eb..746f9248535e43 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/flow-control.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/flow-control.md @@ -7,7 +7,7 @@ title: 制御フロー - **シーケンシャル**: シーケンシャル構造は単純な線形構造です。シーケンスとは、4Dが最初から最後まで次々に実行する一連のステートメントです。オブジェクトメソッドで頻繁に使用される1行から成るルーチンはもっとも簡単なシーケンシャル構造の例です。例: `[People]lastName:=Uppercase([People]lastName)` - **分岐**: 分岐構造は、条件をテストし、その結果に基づいて異なる流れにメソッドを導きます。条件は true または false に評価されるブール式です。 [`If...Else...End if`](#ifelseend-if) 構文は分岐構造の一例で、処理フローを二つに分岐します。 [`Case of...Else...End case`](#case-ofelseend-case) 構文も分岐構造の一つで、処理フローをもっとたくさん分岐することができます。 -- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これに実現するために、4D は以下のループ構造を備えています: +- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これを実現するために、4D は以下のループ構造を備えています: - [`While...End while`](#whileend-while) - [`Repeat...Until`](#repeatuntil) @@ -16,7 +16,7 @@ title: 制御フロー ループを制御する方法には、条件が満たされるまでループする方法と、指定した回数だけループする方法の2通りがあります。各ループ構造はいずれの方法にも用いることができますが、`While` ループと `Repeat` ループは条件が満たされるまで繰り返す場合に、`For` ループは指定した回数だけループする場合の利用に適切です。 `For each...End for each` ループは両方を組み合わせることが可能で、オブジェクトやコレクション内でループするために設計されています。 -**注:** 4Dはプログラム構造 (If/While/For/Caes of/Repeat/For each) を512レベルまで入れ子で記述できます。 +**注:** 4Dはプログラム構造 (If/While/For/Case of/Repeat/For each) を512レベルまで入れ子で記述できます。 ## If...Else...End if @@ -268,7 +268,7 @@ vResult = 1の判定により他の条件を見る前に分岐するので、第 一般に、`While...End while` ループに入る手前で、ブール式で判定する値を初期化しておきます。値を初期化するとは適切な値に設定するということで、通常はブール式が true になるように設定してからループに入ります。 -ブール式は、ループ内の要素を使って設定されなければなりません。 そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 +ブール式は、ループ内の要素を使って設定されなければなりません。そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 ```4d NeverStop:=True @@ -309,7 +309,7 @@ Until(Boolean_Expression) #### 例題 -以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数　`OK` を初期化する `CONFIRM` コマンドはありません。 +以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数 `OK` を初期化する `CONFIRM` コマンドはありません。 ```4d Repeat @@ -375,7 +375,7 @@ End for End for ``` -4. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +4. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d FIRST RECORD([aTable]) @@ -424,7 +424,7 @@ End for End for ``` -8. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +8. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d LAST RECORD([aTable]) @@ -552,7 +552,7 @@ End for End for each ``` -`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の \*Expression \* を対象に反復処理をおこなうことができます: +`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の *Expression* を対象に反復処理をおこなうことができます: - コレクション: コレクションの各要素をループします - エンティティセレクション: 各エンティティをループします diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/identifiers.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/identifiers.md index 6ec87cb894139a..8c44570be59071 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/identifiers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/identifiers.md @@ -75,7 +75,7 @@ Function getArea($width : Integer; $height : Integer)-> $area : Integer - 1文字目は、文字、数字、あるいはアンダースコア(_) でなければなりません。 - その後の文字には、文字・数字・アンダースコア(_)・スペースが使用できます。 - 予約語を使用しないでください。予約語にはコマンド名 (`Date`, `Time` 等)、キーワード (`If`, `For` 等)、そして定数 (`Euro`, `Black`, `Friday` 等) が含まれます。 -- 大文字・小文字は区別されます。 +- 大文字・小文字は区別されません。 例: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/interpreted.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/interpreted.md index 168d45256e64a6..36d3d5fe595e29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/interpreted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/interpreted.md @@ -27,7 +27,7 @@ title: インタープリターモードとコンパイル済みモード | 変数や配列のデータタイプは変更できません。 | 変数や配列のデータタイプは変更可能です (推奨されません) | | 1次元配列を2次元配列に、また2次元配列を1次元配列に変更することはできません。 | 可能です。 | | コンパイラーにより変数のタイプ定義はおこなわれますが、フォーム上の変数のようにデータタイプが明確でない場合は、宣言によって変数のデータタイプを指定するべきです。 | | -| `Undefined` 関数は、常に False を返します。 変数は常に定義されています。変数は常に定義されています。 | | +| `Undefined` 関数は、常に False を返します。変数は常に定義されています。 | | | メソッドの "プリエンプティブプロセスで実行可能" プロパティにチェックを入れていた場合、コードは他のスレッドアンセーフなコマンドやメソッドを呼び出してはいけません。 | プリエンプティブプロセスプロパティは無視されます。 | | 特定のループの場合、割り込みを可能にするには `IDLE` コマンドが必要です。 | いつでも割り込み可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/methods.md index b1f8885f4dfa2e..45dc289ede2b34 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/methods.md @@ -5,7 +5,7 @@ title: メソッド メソッドとは、1つ以上の動作を実行するコードのことです。メソッドは、1つ以上のステートメントで構成されます。 -ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する) することができます。 +ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する)することができます)。 メソッドは最大 2GBのテキストまたは、32000行まで記述できます。 @@ -17,7 +17,7 @@ title: メソッド | ------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **プロジェクトメソッド** | 呼び出しに応じて ([プロジェクトメソッドの呼び出し](#calling-project-methods) 参照) | ◯ | 任意のアクションを実行するためのコードです。作成されたプロジェクトメソッドは、そのプロジェクトのランゲージの一部となります。 | | **オブジェクト (ウィジェット) メソッド** | メソッドが設定されたフォームオブジェクトに関連したイベント発生時に | × | フォームオブジェクト (ウィジェットとも呼びます) のプロパティです。 | -| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | +| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | | **トリガー** (別名 *テーブルメソッド*) | テーブルのレコード操作 (追加・削除・修正) の度に | × | テーブルのプロパティです。トリガーは、データベースのレコードに対して「不正な」操作がおこなわれることを防ぎます。 | | **データベースメソッド** | 作業セッションのイベント発生時に | ○ (既定) | 4D には 16のデータベースメソッドがあります。 | | **クラス** | [**クラス関数**](classes.md#function) は、オブジェクトインスタンスのコンテキストにおいて呼び出されます。 | ◯ | クラス関数にはビルトインのものと (*例:* `collection.orderBy()` や `entity.save()`)、開発者によって作成されるものがあります。 [**クラス**](classes.md) 参照。[**クラス**](classes.md) 参照。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/operators.md index 83c5bb29fb354a..649244ecf66b27 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: -- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 -- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#ternary-operator) (a ? b : c\\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2 + 3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#三項演算子) (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -93,7 +93,7 @@ $a+=2 // $a=3 - オブジェクトプロパティあるいはコレクション要素としてのピクチャー - 配列のインデックス変数 -"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()-+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 +"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()->+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 > [テキストの文字インデックス](dt_string.md#文字参照記号) および [BLOB のバイトインデックス](dt_blob.md#スカラーblob-のバイトへのアクセス) では、これらの演算子はサポートされません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/parameters.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/parameters.md index a0d93f77ac2fed..685eb8a4527dd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/parameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/parameters.md @@ -19,7 +19,7 @@ ALERT("Hello") $area:=$o.getArea(50;100) ``` -また、プロジェクトメソッド `DO SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: +また、プロジェクトメソッド `DO_SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: ```4d DO_SOMETHING($WithThis;$AndThat;$ThisWay) @@ -35,7 +35,7 @@ EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/20!) // その際に引数として日付リテラル !05/05/20! を渡します ``` -メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* コードは以下のようになります: +メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* という変数に値を返します。コードは以下のようになります: ```4d MyLength:=Length("How did I get here?") @@ -471,11 +471,11 @@ ALERT([People]Name) ALERT($1) ``` -`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $1 の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 +`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $1 の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 もし `DO_SOMETHING` メソッド内でフィールドの値を変更したいのであれば、2通りのやり方があります: -1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。 この場合、以下のようにコードを書きます: +1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。この場合、以下のようにコードを書きます: ```4d // MY_METHOD メソッド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/quick-tour.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/quick-tour.md index 974a37f6645060..1aa80f9d307110 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/quick-tour.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/quick-tour.md @@ -31,7 +31,7 @@ $myHour:=?08:12:55? // 時間リテラルを代入します 代入演算 (:=) は必ず他の演算と区別しなければなりません。代入演算子は、被演算子を組み合わせて新しい一つのものにするのではなく、演算子の右側の式の値を左側の変数やフィールドにコピーします。 -**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 +**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 ## 変数 @@ -64,7 +64,7 @@ MyOtherDate:=Current date+30 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new") ``` -コレクションやオブジェクトにコマンドが属している場合、それらは名前付き関数であり、ドット記法を用いて使用します。例: +コレクションやオブジェクトにコマンドが属している場合、それらは関数と呼ばれ、ドット記法を用いて使用します。例: ```4d $c:=New collection(1;2;3;4;5) @@ -105,7 +105,7 @@ vRef:=Open document("PassFile";"TEXT";Read Mode) // ドキュメントを読み 4D が提供するたくさんのビルトインコマンドを使って、独自の **プロジェクトメソッド** を組み立てることができます。プロジェクトメソッドとはユーザー定義のメソッドで、コマンドや演算子などの要素から成り立ちます。プロジェクトメソッドは汎用性のあるメソッドですが、そうではない他の種類のメソッドも存在します: オブジェクトメソッド、フォームメソッド、テーブルメソッド (トリガー)、データベースメソッド。 -メソッドは、一つ以上のステートメントで構成されます。 ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 +メソッドは、一つ以上のステートメントで構成されます。ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 たとえば、次のステートメントは確認ダイアログボックスを表示します: @@ -144,7 +144,7 @@ $out:=Uppercase($in) データタイプのうち、文字タイプと数値タイプは、複数の類似するフィールドタイプに対応する点に注意してください。これらのフィールドにデータが格納されるとき、4D ランゲージはフィールドタイプに合致するデータタイプへとデータを自動的に変換します。反対に、たとえば整数フィールドのデータを呼び出すと、そのデータは自動的に数値タイプとして扱われます。つまり、4D ランゲージを使用する際に、類似するフィールドタイプを厳密に区別する必要はありません。 -しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。 しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 +しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 あるタイプとして格納したデータを、別のタイプとして使用する場合があります。 4D ランゲージには、データタイプを変換するためのコマンドが用意されています。たとえば、数値で始まり、"abc" 等の文字で終了する部品番号を作成する必要がある場合、以下のように記述することができます: @@ -258,7 +258,7 @@ This.name:="Square" 数値演算子は、使用可能な演算子のうちの 1種にすぎません。 4Dは、数値・テキスト・日付・ピクチャー等、異なるタイプのデータを扱うために、各データタイプで演算を実行するための演算子を備えています。 -対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。例えば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: +対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。たとえば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: | データタイプ | 演算 | 例題 | | ------ | --------------------------- | --------------------------------------------------------------------- | @@ -272,11 +272,11 @@ This.name:="Square" コマンド・演算子・変数・フィールド・オブジェクトプロパティ・コレクション要素等、複数のランゲージの要素を組み合わせて式は構成されます。式により、ステートメント (メソッドの 1文や 1行) を構成します。データが必要なとき、式が必要になります。 -式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります : +式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります。これには以下が含まれます: - フォーミュラエディター (フォーミュラによるクエリや並べ替えなど) - `EXECUTE FORMULA` コマンド -- フォームオブジェクトやウィジェットのデータソースとして +- プロパティリスト内で、フォームオブジェクトやウィジェットのデータソースとして - デバッガー内で式の値を確認することができます - クイックレポートエディターでカラムにフォーミュラを使用することができます @@ -284,30 +284,30 @@ This.name:="Square" 生成する値のタイプによって、式のタイプを定義することができます。式のタイプは複数あります。様々なタイプの式の例を以下に示します。 -| 式 | 型 | 説明 | -| ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | -| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | -| [People]Name + "様" | Text | 2つの文字列の結合です。 [People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | -| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | -| 4 | Number | これは数値定数 4です。 | -| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。 乗算演算子の (\*) を使用しています。数値の 8を返します。 | -| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | -| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | -| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | -| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | -| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | -| true | Boolean | このコマンドはブール値の true (真) を返します。 | -| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | -| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | -| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | -| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | -| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | -| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | -| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | -| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | -| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | -| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | +| 式 | 型 | 説明 | +| ------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | +| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | +| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | +| [People]Name + "様" | Text | 2つの文字列の結合です。[People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | +| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | +| 4 | Number | これは数値定数 4です。 | +| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。乗算演算子の (\*) を使用しています。数値の 8を返します。 | +| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | +| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | +| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | +| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | +| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | +| true | Boolean | このコマンドはブール値の true (真) を返します。 | +| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | +| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | +| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | +| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | +| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | +| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | +| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | +| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | +| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | +| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | ### 代入可能な式vs代入不可の式 {#assignable-vs-non-assignable-expressions} diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/shared.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/shared.md index d2c5c4d04705d1..f881aa3486ba86 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/shared.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/shared.md @@ -80,7 +80,7 @@ End Use ### ストレージ -**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](https://doc.4d.com/4dv19R/help/command/en/page1525.html) コマンドによって返されます。このオブジェクトは、他のプリエンティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 +**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](https://doc.4d.com/4dv19R/help/command/en/page1525.html) コマンドによって返されます。このオブジェクトは、他のプリエンプティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 `ストレージ` オブジェクトは標準の共有オブジェクトとは異なり、共有オブジェクト/コレクションがプロパティとして追加されたときでも共有グループを作成しないという点に注意してください。この例外的な振る舞いにより、**ストレージ** オブジェクトを使用するたびに、リンクされている共有オブジェクト/コレクションをすべてロックせずに済みます。 @@ -100,10 +100,10 @@ End Use 共有オブジェクトおよび共有コレクションは、プロセス間の (とくに **プリエンプティブ4Dプロセス** 間の) 通信ができるように設計されています 。これらはプロセスから他のプロセスへ、参照型の引数として渡すことができます。共有オブジェクトおよび共有コレクションを扱う際には、複数プロセスによる同時アクセスを避けるために、必ずそれらを `Use...End use` キーワードでくくる必要があります。 -- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のプすべてのロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 +- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のすべてのプロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 - *statement(s)* で実行されるステートメントは、Shared_object_or_Shared_collection のプロパティ/要素に対して、競合アクセスのリスクなしに変更も実行することができます。 - *Shared_object_or_Shared_collection* に他の共有オブジェクトあるいはコレクションがプロパティとして追加された場合、それらも同じ共有グループとして連結されます。 -- \*\*Use...End use \*\* 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 +- **Use...End use** 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 - **End use** は、*Shared_object_or_Shared_collection* プロパティおよび、同じグループのすべてのオブジェクトのロックを解除します。 - 4D コード内では、複数の **Use...End use** 構文を入れ子にすることができます。グループの場合、**Use** を使用するごとにグループのロックカウンターが 1 増加し、 **End use** ごとに 1 減少します。最後の **End use** によってロックカウンターが 0 になった場合にのみ、すべてのプロパティ/要素のロックが解除されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/variables.md index 30bff8d7468c55..b50c7b1cf12a99 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/variables.md @@ -66,23 +66,23 @@ var $myVar // バリアント型変数 サポートされている `varType` 値の一覧です: -| varType | 内容 | -| ---------------------------------------------- | --------------------------------------------------------------- | -| `Text` | テキスト値 | -| `Date` | 日付値 | -| `Time` | 時間値 | -| `Boolean` | ブール値 | -| `Integer` | 倍長整数値 | -| `Real` | 実数値 | -| `Pointer` | ポインター値 | -| `Picture` | ピクチャー値 | -| `Blob` | スカラーBLOB値 | -| `Collection` | コレクション値 | -| `Variant` | バリアント値 | -| `Object` | デフォルトクラス (4D.Object) のオブジェクト | -| `4D.` | 4Dクラス名のオブジェクト | -| `cs.` | ユーザークラス名のオブジェクト | -| `cs.`cs. | `` コンポーネントクラス名のオブジェクト | +| varType | 内容 | +| --------------------------- | --------------------------------------------------------------- | +| `Text` | テキスト値 | +| `Date` | 日付値 | +| `Time` | 時間値 | +| `Boolean` | ブール値 | +| `Integer` | 倍長整数値 | +| `Real` | 実数値 | +| `Pointer` | ポインター値 | +| `Picture` | ピクチャー値 | +| `Blob` | スカラーBLOB値 | +| `Collection` | コレクション値 | +| `Variant` | バリアント値 | +| `Object` | デフォルトクラス (4D.Object) のオブジェクト | +| `4D.` | 4Dクラス名のオブジェクト | +| `cs.` | ユーザークラス名のオブジェクト | +| `cs.` | `` コンポーネントクラス名のオブジェクト | #### 例題 @@ -166,7 +166,7 @@ atNames{1}:="Richard" ## ローカル、プロセス、およびインタープロセス変数 -**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 +**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 ### ローカル変数 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/building.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/building.md index aa9855eb092963..e54c99940596f8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/building.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/building.md @@ -636,7 +636,7 @@ userPrefs:=Get 4D folder(Active 4D Folder) #### データリンクモードの設定 -コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、 \*\*アプリケーション名 \*\* でリンクされます。 +コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、**アプリケーション名** でリンクされます。 異なるデータファイルを使用するために組み込みアプリを複製する場合には、この方法は適さないかもしれません。複製されたアプリは同じアプリケーションユーザー設定フォルダーを共有するため、同じデータファイルを使用することになります (最後に使用されたファイルが開かれるため、データファイル名を変更した場合でも結果は同じです)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/clientServer.md index de6ee752de3700..3ee82c6fa91f56 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Desktop/clientServer.md @@ -30,7 +30,7 @@ title: クライアント/サーバー管理 1. 次のいずれかの方法をおこないます: - Welcome ウィザードにて **4D Serverに接続** を選択します。 - - **ファイル** メニューより \*\*開く ＞ リモートプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **リモートプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 4D Server に接続するためのダイアログが表示されます。ダイアログには **最近使用**、**利用可**、および **カスタム** という、3つのタブがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterEdit.md index 9b6d9edf74fd52..e7aeb927cf1167 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterEdit.md @@ -62,11 +62,11 @@ title: On After Edit #### action = DragFillBlock -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | 自動入力のために使用されるレンジ | -| autoFillType | longint | 自動入力のために使用される値。
  • 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | -| fillDirection | longint | フィルの方向
  • フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | +| プロパティ | 型 | 説明 | +| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | 自動入力のために使用されるレンジ | +| autoFillType | longint | 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | +| fillDirection | longint | フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | #### action = formulaChanged diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/pictures.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/pictures.md index 91c4a353bac8a5..0b31578b4a8ad8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/pictures.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/pictures.md @@ -57,10 +57,10 @@ title: ピクチャー 高解像度が自動的に優先されますが、スクリーンやピクチャーの dpi *(\*)*、およびピクチャー形式によって、動作に違いが生じることがあります: -| 演算 | 動作 | -| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
  • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
  • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    • | -| [自動サイズ](https://doc.4d.com/4Dv19/4D/19/Setting-object-display-properties.300-5416671.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | +| 演算 | 動作 | +| ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    | +| [自動サイズ](https://doc.4d.com/4Dv19/4D/19/Setting-object-display-properties.300-5416671.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | *(\*) 通常は macOS = 72dpi, Windows = 96dpi* diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_Action.md index 6d9cbd7c33c021..e4a5e1851c7b3f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_Action.md @@ -5,7 +5,7 @@ title: 動作 ## メソッド -フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 +フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 メソッドが関連づけられているフォームに関わるイベントが発生した場合、4D は自動的にフォームメソッドを呼び出します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_FormProperties.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_FormProperties.md index ea1d5444c14fe0..26a908cbfd87ce 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_FormProperties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormEditor/properties_FormProperties.md @@ -33,9 +33,9 @@ title: フォームプロパティ #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| --- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| css | string または collection | CSS file path(s) provided as:
  • a string (a file for both platforms)
  • a collection of strings (a list of files for both platform)
  • a collection of {"path":string;"media":"mac" | "windows"} objects
    • | +| 名称 | データタイプ | とりうる値 | +| --- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| css | string または collection | CSSファイルパス:
  • 文字列 (両方のプラットフォーム用に 1ファイル)
  • 文字列のコレクション (両プラットフォーム用のファイルのリスト)
  • {"path":string;"media":"mac" | "windows"} オブジェクトのコレクション
    • | --- diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md index 4647365dcbfd94..b533d1f8d22c07 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/dropdownList_Overview.md @@ -165,4 +165,4 @@ Form.myDrop.index //3 ## プロパティ一覧 -[Alpha Format](properties_Display.md#alpha-format) - [Bold](properties_Text.md#bold) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Data Type (expression type)](properties_DataSource.md#data-type-expression-type) - [Data Type (list)](properties_DataSource.md#data-type-list) - [Date Format](properties_Display.md#date-format) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Not rendered](properties_Display.md#not-rendered) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Standard action](properties_Action.md#standard-action) - [Save value](properties_Object.md#save-value) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [値を記憶](properties_Object.md#値を記憶) - [CSSクラス](properties_Object.md#cssクラス) - [データタイプ (セレクションおよびコレクションリストボックス列)](properties_DataSource.md#データタイプ-(リスト)) - [データタイプ](properties_DataSource.md#データタイプ-リスト) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [文字フォーマット](properties_Display.md#文字フォーマット) - [日付フォーマット](properties_Display.md#日付フォーマット) - [時間フォーマット](properties_Display.md#時間フォーマット) - [表示状態](properties_Display.md#表示状態) - [レンダリングしない](properties_Display.md#レンダリングしない) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [横揃え](properties_Text.md#横揃え) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox-object.md index 2b9c696d11b5d8..21ac622c9e1265 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox-object.md @@ -28,7 +28,7 @@ LIST TO ARRAY("ListName";varCol) ## セレクションリストボックス -このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+“ ”[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。カラムをプログラムで変更するには、`LISTBOX SET COLUMN FORMULA` および `LISTBOX INSERT COLUMN FORMULA` コマンドを使用します。 +このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+" "[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。カラムをプログラムで変更するには、`LISTBOX SET COLUMN FORMULA` および `LISTBOX INSERT COLUMN FORMULA` コマンドを使用します。 それぞれの行はセレクションのレコードを基に評価されます。セレクションは **カレントセレクション** または **命名セレクション**です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md index 866148543dd980..cb5ad5a7a5cddd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md @@ -241,14 +241,14 @@ JSON フォームにおいて、リストボックスに次のハイライトセ 標準ソートのサポートは、リストボックスのタイプに依存します: -| リストボックスタイプ | 標準ソートのサポート | コメント | -| ------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Object の Collection | ◯ |
  • "This.a" or "This.a.b" columns are sortable.
  • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • | -| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | -| エンティティセレクション | ◯ |
  • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
  • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
  • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
  • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。 この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    • この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照) | -| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | -| 命名セレクション | × | | -| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | +| リストボックスタイプ | 標準ソートのサポート | コメント | +| ------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Object の Collection | ◯ |
  • "This.a" or "This.a.b" columns are sortable.
  • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • | +| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | +| エンティティセレクション | ◯ |
  • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
  • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
  • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
  • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    • | +| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | +| 命名セレクション | × | | +| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | ### カスタムソート @@ -369,7 +369,7 @@ End if ### プレビューモード -プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。 とくに、表示されている以上の行を印刷することはできません。 +プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。とくに、表示されている以上の行を印刷することはできません。 ### 詳細モード diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Action.md index b2df8c1fabc1ac..3d4b59df7cfb1f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Action.md @@ -22,9 +22,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dragging | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dragging | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト @@ -50,9 +50,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dropping | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dropping | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Appearance.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Appearance.md index f02c765f93f176..fb4452b23bb9fc 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Appearance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Appearance.md @@ -31,9 +31,9 @@ Windows上では "推奨選択肢" の概念はサポートされていないた --- -## Display formula source as symbol +## フォーミュラのソースを記号として表示 -Displays source text of formulas as symbols when expressions are shown as references. +式が参照として表示される場合、フォーミュラのソーステキストを記号として表示します。 #### JSON 文法 @@ -133,7 +133,7 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show background and anchored elements +## 背景とアンカーされた要素を表示 ページの背景画像および背景色を表示/非表示にします。 @@ -149,9 +149,9 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show empty or unsupported images +## 空またはサポートされていない画像を表示 -Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). +読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示したり非表示にします。 #### JSON 文法 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md index b690a348fba9a5..cc4566473c3bba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_Object.md @@ -135,9 +135,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | +| 名称 | データタイプ | とりうる値 | +| ---------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | ### 式 @@ -221,9 +221,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。 *配列/セレクションリストボックスのみ*: "integer", "object"
    • *配列/セレクションリストボックスのみ*: "integer", "object" | +| 名称 | データタイプ | とりうる値 | +| ------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。*配列/セレクションリストボックスのみ*: "integer", "object"
    • | #### 対象オブジェクト @@ -283,7 +283,7 @@ title: オブジェクト コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。 -コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、 [`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: +コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、[`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: - オブジェクトのコレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: `This.`。 - エンティティセレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: `This.`。 @@ -393,15 +393,15 @@ This property sets the type of calculation to be done in a [column footer](./lis | 計算タイプ | Num | Text | Date | Time | Bool | Pict | フッター変数の型 | | ---------------------------------------- | --- | ---- | ---- | ---- | ---- | ---- | -------- | -| 最小 | X | X | X | X | X | | 列の型と同じ | -| 最大 | X | X | X | X | X | | 列の型と同じ | -| 合計 | X | | | X | X | | 列の型と同じ | -| カウント | X | X | X | X | X | X | Integer | -| 平均 | X | | | X | | | Real | -| 標準偏差(\*) | X | | | X | | | Real | -| 分散(\*) | X | | | X | | | Real | -| 平方和(\*) | X | | | X | | | Real | -| カスタム (JSON では "none") | X | X | X | X | X | X | 制限なし | +| 最小 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 最大 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 合計 | ○ | | | ○ | ○ | | 列の型と同じ | +| カウント | ○ | ○ | ○ | ○ | ○ | ○ | Integer | +| 平均 | ○ | | | ○ | | | Real | +| 標準偏差(\*) | ○ | | | ○ | | | Real | +| 分散(\*) | ○ | | | ○ | | | Real | +| 平方和(\*) | ○ | | | ○ | | | Real | +| カスタム (JSON では "none") | ○ | ○ | ○ | ○ | ○ | ○ | 制限なし | (\*) 配列型のリストボックスのみ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_RangeOfValues.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_RangeOfValues.md index d4c8830f3247ff..e2c8677611ee44 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_RangeOfValues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/FormObjects/properties_RangeOfValues.md @@ -11,22 +11,21 @@ title: 値の範囲 - テキスト/文字列 - 数値/整数 -- date -- time -- boolean +- 日付 +- 時間 +- ブール 日付、時刻、シーケンス番号については、4D が提供する記号を使用することができます。日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: -| スタンプ | 意味 | -| ---- | ------- | -| #D | 本日の日付 | -| #H | 現在の時刻 | -| #N | シーケンス番号 | +| 記号 | 意味 | +| -- | ------- | +| #D | 本日の日付 | +| #H | 現在の時刻 | +| #N | シーケンス番号 | カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。詳細は [自動インクリメント](https://doc.4d.com/4Dv18/4D/18/Field-properties.300-4575567.ja.html#976029) の段落を参照してください。 -> このプロパティと、リストボックス列に固定値を表示させるための -> "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 +> このプロパティと、リストボックス列に固定値を表示させるための "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 #### JSON 文法 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/GettingStarted/creating.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/GettingStarted/creating.md index f3cd66d3d83a0e..07ed71ed890dda 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/GettingStarted/creating.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/GettingStarted/creating.md @@ -36,7 +36,7 @@ OS によって許可されている名称であれば使用可能です。し 1. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*開く ＞ ローカルプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **ローカルプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 - Welcome ウィザードにて **ローカルアプリケーションプロジェクトを開く** を選択します。 標準のファイルを開くためのダイアログが表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/encrypt.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/encrypt.md index 4e35b338fa43cd..e013daddc5aa76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/encrypt.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/encrypt.md @@ -47,7 +47,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう 暗号化プロセスが正常に完了した場合、暗号化ページは 暗号化メンテナンスオペレーション ボタンを表示します。 -**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデーファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 +**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデータファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 ## 暗号化メンテナンスオペレーション @@ -86,7 +86,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ### パスフレーズを変更してデータを再暗号化する -この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスプレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 +この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスフレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 1. **パスフレーズを変更してデータを再暗号化する** をクリックします。 2. カレントのデータ暗号化キーを入力します。 @@ -110,7 +110,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ## 暗号化キーを保存する -4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。 なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 +4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 新しいパスフレーズが提供されるたびに暗号化キーを保存することができます: @@ -121,7 +121,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう :::caution -[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。 できない場合には、エラーが発生します。 +[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。できない場合には、エラーが発生します。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/overview.md index 000f1c827ccdce..bf793a36332bd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/MSC/overview.md @@ -14,7 +14,7 @@ MSCウィンドウを開く方法は幾つかあります。アクセスの方 メンテナンスモードでは、MSCウィンドウだけが表示されます (4Dアプリケーションはプロジェクトを開きません)。つまり、損傷が激しいため 4D が標準モードで開けないプロジェクトにもアクセスできるということです。さらに、特定の操作 (圧縮、修復など) はプロジェクトをメンテナンスモードで開くことを要求します ([アクセス権](#アクセス権) 参照)。 -次の 2つの場所から、MSC をメインテナンスモードで開くことができます: +次の 2つの場所から、MSC をメンテナンスモードで開くことができます: - **標準の開くダイアログボックス** 標準のプロジェクトを開くダイアログボックスには **開く** ボタンに関連付けられているメニューに **Maintenance & Security Center** オプションが含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Menus/sdi.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Menus/sdi.md index b60adf0727ed0c..f60ebc5dd11f33 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Menus/sdi.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Menus/sdi.md @@ -17,7 +17,7 @@ SDIモードは以下の実行環境に限り利用可能です: - Windows - 組み込みの [スタンドアロン](../Desktop/building#スタンドアロンアプリケーションをビルド) または [クライアント](../Desktop/building#クライアントアプリケーションをビルド) 4Dアプリケーション -- **実行** メニューにて提供されている [\*\* アプリケーションをテスト\*\* 機能](bars.md#メニューバーのプレビュー) から利用可能です。 +- **実行** メニューにて提供されている [**アプリケーションをテスト** 機能](bars.md#メニューバーのプレビュー) から利用可能です。 ## SDIモードの有効化 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ORDA/glossary.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ORDA/glossary.md index bfa2d6b19d74c6..539743577f0450 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ORDA/glossary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ORDA/glossary.md @@ -127,7 +127,7 @@ $myClass.query("name = smith") ## ミックスデータ型 -このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : +このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。これには以下が含まれます: - number - text @@ -211,9 +211,9 @@ ORDA オブジェクトとは関わりのないユーザークラス。 シャロウコピーは、要素の構造のみを複製し、同じ内部参照を保持します。シャロウコピーのあと、二つのコレクションに格納された個々の要素は同じものが共有されています。ディープコピー も合わせて参照してください。 -## スタンプ +## 記号 -"オプティミステック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 +"オプティミスティック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 ## ストレージ属性 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Project/compiler.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Project/compiler.md index 10dda54aee6129..4c5903e0cc15d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Project/compiler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Project/compiler.md @@ -226,7 +226,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.xml` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/REST/$filter.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/REST/$filter.md index 867f1586c39708..4cea8e78dd5ed3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/REST/$filter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/REST/$filter.md @@ -23,7 +23,7 @@ title: $filter **\{attribute\} {comparator} {value} {AND/OR/EXCEPT} \{attribute\} {comparator} {value}** -たとえば: `$filter="firstName=john AND salary>20000"` （`firstName` および `salary` は Employee データクラスの属性です)。 +たとえば: `$filter="firstName=john AND salary>20000"` (`firstName` および `salary` は Employee データクラスの属性です)。 ### paramsプロパティの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ServerWindow/real-time-monitor.md index efdc71c414a0c2..fd307a4f9c7acb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ServerWindow/real-time-monitor.md @@ -9,7 +9,7 @@ title: リアルタイムモニターページ > このページは、サーバーマシンの管理ウィンドウにありますが、リモートの 4Dマシンからも見られます。リモートマシンの場合は、サーバーマシン上で実行されている操作のデータを表示します。 -データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます。 +データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます)。 各行について、以下の情報が表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Tags/tags.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Tags/tags.md index bdd5ac379b14e6..df2d1449c1d212 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Tags/tags.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Tags/tags.md @@ -46,7 +46,7 @@ title: 変換タグ ### 再起的処理 -4Dタグは繰り返し解釈されます。 4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: +4Dタグは繰り返し解釈されます。4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: ```html @@ -62,7 +62,7 @@ title: 変換タグ ### "." を小数点として使用 -4D は常にピリオド文字 (.) `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 +4D は常にピリオド文字 (.) を小数点として使用して、 `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 ## 4DBASE @@ -635,7 +635,7 @@ No name has been found. #### 代替シンタックス: `$4DTEXT(expression)` -タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: +タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: ```html

    へようこそ！

    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/classes.md index a8fa417ac13cf7..45c42624fbbc85 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/classes.md @@ -213,7 +213,7 @@ title: クラス **.borderHorizontal** : [cs.ViewPro.LineBorder](#lineborder) -`.borderBottom` プロパティは、 表の横の外枠線を定義します 。 +`.borderHorizontal` プロパティは、 表の横の外枠線を定義します 。 ### .borderVertical diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/configuring.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/configuring.md index 8260accc1a46cb..e159f794e2973c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/configuring.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/configuring.md @@ -141,7 +141,7 @@ For example, when using the [VP SET VALUE](method-list.md#vp-set-value) or [VP S | 0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 | | 。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 | | , | 数値内に千区切りのカンマを表示します。数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 | -| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | +| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( や _) のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | | @ | テキストのフォーマット文字。セル内のすべてのテキストにフォーマットを適用します。 | "\[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 | | \* | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0\*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、\*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 | | " " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 | @@ -165,17 +165,17 @@ VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_ 4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています: -| 定数 | 値 | 説明 | -| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | -| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | -| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | -| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。 アメリカ合衆国でのデフォルトパターン: "MMMM dd" | -| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。 アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | -| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm" | -| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | -| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | -| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。 アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | +| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | +| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | +| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" | +| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | +| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" | +| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | +| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | +| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | #### 例題 @@ -339,9 +339,9 @@ VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time"; | firstPageNumber | longint | 最初のページに印刷するページ番号。 デフォルト値 = 1 | | pageOrder | longint | ページの印刷順。とりうる値: `vk print page order auto` (デフォルト), `vk print page order down then over`, `vk print page order over then down`. | | pageRange | text | 印刷されるページの範囲 | -| qualityFactor | longint | 印刷の品質指定 (1 - 8)。印刷の品質指定 (1 - 8)。 高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    デフォルト値 = 2

    | -| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    デフォルト値 = true

    | -| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    デフォルト値 = 1

    | +| qualityFactor | longint | 印刷の品質指定 (1 - 8)。高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    | +| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    | +| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    | ### 用紙サイズ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/formulas.md index a5eb70130d6a7b..1c1635b976e27d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/formulas.md @@ -217,7 +217,7 @@ $o.DRIVERS_LICENCE.parameters.push(New object("name"; "ID"; "type"; Is longint)) サポートされている引数の型の詳細については、[VP SET CUSTOM FUNCTIONS](method-list.md#vp-set-custom-functions) メソッドの説明を参照ください。 -> 引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、 それらの型は自動的に変換されます。 *jstype* の日付は、4Dコードでは 2つのプロパティを持つ [オブジェクト](Concepts/dt_object.md) として渡されます: +> 引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、それらの型は自動的に変換されます。 *jstype* の日付は、4Dコードでは 2つのプロパティを持つ [オブジェクト](Concepts/dt_object.md) として渡されます: > > | プロパティ | 型 | 説明 | > | ----- | ---- | --------------------------- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/method-list.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/method-list.md index dfb09791ac6759..444d56a1ce2c87 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/method-list.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/ViewPro/method-list.md @@ -4717,7 +4717,7 @@ VP SET ACTIVE CELL($activeCell) `VP SET ALLOWED METHODS` コマンドは、4D View Pro フォーミュラから呼び出し可能なプロジェクトメソッドを指定します。このコマンドは、呼び出し後のセッション中に初期化される 4D View Pro エリアすべてに対して適用されます。同じセッション中において異なる設定で初期化をするために、複数回呼び出すこともできます。 -セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照)。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 +セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照))。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 *methodObj* には、4D View Pro エリア内で定義したいファンクションの名前をプロパティとして格納しているオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/authentication.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/authentication.md index 3e44d9d0e009ac..8c2d4f66b9207a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/authentication.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/authentication.md @@ -152,7 +152,7 @@ Alternatively, you can use the [named parameters](Concepts/parameters.md) syntax `$3` 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 #### $4 - サーバー IPアドレス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/httpRequests.md index bf9a1231f0aea4..6640a02067fb84 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/httpRequests.md @@ -87,7 +87,7 @@ Alternatively, you can use the [named parameters](../Concepts/parameters.md) syn $3 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 ### $4 - サーバー IPアドレス @@ -101,8 +101,8 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ ## /4DACTION -\*\*/4DACTION/\*\**MethodName*
    -\*\*/4DACTION/\*\**MethodName/Param* +**/4DACTION/***MethodName*
    +**/4DACTION/***MethodName/Param* | 引数 | 型 | | 説明 | | ---------- | ---- | :-: | --------------------- | @@ -113,8 +113,8 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。このメソッドは引数を *$1* に受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 -- `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。属性がチェックされていない場合、Webリクエストは拒否されます。 +- `/4DACTION/MethodName/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -122,7 +122,7 @@ $4 引数は 4D Webサーバーによってリクエストされた IPアドレ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND TEXT` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インターフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 @@ -152,7 +152,7 @@ WEB SEND BLOB($BLOB;"image/png") ### 4DACTION を使用してフォームをポスト -4D Webサーバーでは、ポストされたフォームを使用することもできます。 これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 +4D Webサーバーでは、ポストされたフォームを使用することもできます。これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 フォームは 2つのメソッドを使用してサブミットできます (4D では両方のタイプを使用できます): diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/sessions.md index 342dcd2e2d07fe..ee7349fabbaf89 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/sessions.md @@ -20,13 +20,13 @@ Webサーバーのユーザーセッションでは、以下のことが可能 - ストラクチャー設定の Web / オプション (I) ページの **スケーラブルセッション** を使用する (永続的な設定): ![alt-text](../assets/en/WebServer/settingsSession.png) -このオプションは、新規プロジェクトではデフォルトで選択されています。これは、 **セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 +このオプションは、新規プロジェクトではデフォルトで選択されています。これは、**セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 -- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します）。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 +- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します)。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 > メインの Webサーバーのセッションモードは、`WEB SET OPTION` コマンドを使って設定することもできます。 -いずれの場合も、設定はマシンに対しローカルなものです。 つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 +いずれの場合も、設定はマシンに対しローカルなものです。つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 > **互換性について**: 4D v18 R6 以前の 4Dバージョンで作成されたプロジェクトでは、**旧式セッション** オプションが使用できます (詳細については、[doc.4d.com](https://doc.4d.com) の Webサイトを参照ください)。 @@ -36,13 +36,13 @@ Webサーバーのユーザーセッションでは、以下のことが可能 > この cookie の名前は、[`.sessionCookieName`](API/WebServerClass.md#sessioncookiename) プロパティを使用して取得できます。 -1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID__AppName_" cookie の存在と値をチェックします。 +1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID_*AppName*" cookie の存在と値をチェックします。 2. cookie に値がある場合、4D は既存セッションの中からこのクッキーを作成したセッションを探し、見つかった場合には再利用します。 3. クライアントからのリクエストが、すでに開かれているセッションに対応していない場合: -- プライベートな "4DSID__AppName_" cookie を持つ新しいセッションが Webサーバー上に作成されます。 +- プライベートな "4DSID_*AppName*" cookie を持つ新しいセッションが Webサーバー上に作成されます。 - 新しいゲスト `Session` オブジェクトが作成され、このスケーラブルWebセッション専用に使用されます。 The current `Session` object can then be accessed through the [`Session`](API/SessionClass.md#session) command in the code of any web processes. @@ -76,7 +76,7 @@ When a scalable web session is closed, if the [`Session`](API/SessionClass.md#se セッションには、権限を関連付けることができます。セッションの権限に応じて、特定のアクセスや機能を Webサーバー上で提供することができます。 -You can assign privileges usign the [`.setPrivileges()`](API/SessionClass.md#setprivileges) function. コード内では、[`.hasPrivilege()`](API/SessionClass.md#hasprivilege) 関数を使ってセッションの権限をチェックし、アクセスを許可または拒否することができます。 By default, new sessions do not have any privilege: they are **guest** sessions ([`.isGuest()`](API/SessionClass.md#isguest) function returns true). +You can assign privileges usign the [`.setPrivileges()`](API/SessionClass.md#setprivileges) function. コード内では、[`.hasPrivilege()`](API/SessionClass.md#hasprivilege) 関数を使ってセッションの権限をチェックし、アクセスを許可または拒否することができます。 By default, new sessions do not have any privilege: they are **guest** sessions ([`.isGuest()`](API/SessionClass.md#isguest) function returns true). > 現在の実装では (v18 R6)、"WebAdmin" アクセス権のみ利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/templates.md index 0a5e0caa7efdca..1a2a31ffc6295e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/WebServer/templates.md @@ -69,14 +69,14 @@ title: テンプレートページ 内部的には、パーサーは UTF-16 文字列で動作しますが、解析するデータは異なる方法でエンコードされている場合があります。タグにテキストが含まれている場合 (`4DHTML` など)、提供されている情報 (charset) や出所に応じて、4D は必要に応じてデータを変換します。以下に、HTMLページに含まれるタグを 4D が解析する場合と、おこなわれる変換を示します: -| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | -| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND TEXT` | X | - | 変換は不要です。 | -| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | +| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | +| ---------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND TEXT` | X | - | 変換は不要です。 | +| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | (\*) 4DHTML、4DTEXT、4DEVALタグにおいては、代替の $ベースシンタックスが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/creating-using-macros.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/creating-using-macros.md index 58ac043f685831..f02efc9cec3fb0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/creating-using-macros.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/creating-using-macros.md @@ -21,7 +21,7 @@ title: マクロの作成と利用 - マシンのアクティブ4Dフォルダー。この場合、マクロはすべてのデータベースで共有されます。**注:** アクティブ4Dフォルダーの位置は OS により異なります。詳細については、*4Dランゲージリファレンス* マニュアルの [Get 4D folder](https://doc.4d.com/4Dv19R4/4D/19-R4/Get-4D-folder.301-5739515.ja.html) コマンドの説明を参照ください。 - データベースストラクチャーファイルと同階層。マクロは、このストラクチャーにのみ読み込まれます。 -- コンポーネントの場合: データベースの **Components** フォルダーと同階層。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 +- コンポーネントの場合: データベースの **Components** フォルダーの中。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 これら 3つの場所は同時に利用可能です。 各場所に "Macros v2" フォルダーをインストールできます。マクロは以下の順番でロードされます: 4Dフォルダー、ストラクチャーファイル、コンポーネント1 ... コンポーネントX。 @@ -152,7 +152,7 @@ XML仕様に準拠し、いくつかのタグは属性を含むことがあり マクロのサポートは 4Dのバージョンごとに変わることがあります。カスタマイズされたマクロを管理しつつ、異なるバージョンの互換性を保持するために、4Dは以前のバージョンのマクロを取り除くことはしません。最新機能を使用したい場合は、適切にバージョンを調整する必要があります。 -### method の選択テキスト変数 +### メソッドのテキスト選択変数 選択されたテキストは [GET MACRO PARAMETER](https://doc.4d.com/4dv19/help/command/ja/page997.html) と [SET MACRO PARAMETER](https://doc.4d.com/4dv19/help/command/ja/page998.html) コマンドを使用して管理することが推奨されます。これらのコマンドを使用すると、ホストプロジェクトとコンポーネント間でテキストを相互に交換することができ、マクロの管理専用のコンポーネントを作成することができます。マクロでこのモードを有効にするには、macro 要素内で version 属性に値 2 を指定しなければなりません。この場合、4D は旧式の _textSel, _textReplace 等の定義済み変数を管理しなくなり、[GET MACRO PARAMETER](https://doc.4d.com/4dv19/help/command/ja/page997.html) と [SET MACRO PARAMETER](https://doc.4d.com/4dv19/help/command/ja/page998.html) が利用可能になります。属性は以下のように定義します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/write-class-method.md index 411426f966dc1f..724df09c3fdcc0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/code-editor/write-class-method.md @@ -27,12 +27,12 @@ title: コードエディター | **すべて折りたたむ / すべて展開** | ![expand-collapse-button](../assets/en/code-editor/expand-collapse-all.png) | これらのボタンを使用してコードの制御フロー構造を折りたたんだり展開したりできます。 | | **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](./overview.md#project-method-properties) ダイアログボックスを表示します(プロジェクトモードのみ)。 | | **最新のクリップボードの値** | ![last-clipboard-values-icon](../assets/en/code-editor/last-clipboard-values.png) | 直近でクリップボードに保存された値を表示します。 | -| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、 [これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | +| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、[これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | | **ナビゲーションドロップダウン** | ![code-navigation-icons](../assets/en/code-editor/tags.png) | 自動的にタグ付けされたコンテンツや手動で宣言されたマーカーを使用して、メソッドやクラス内を移動できます。後述参照。 | ### 編集エリア -このエリアを使用してコードを 入力/編集 します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 +このエリアを使用してコードを入力/編集します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 この編集エリアの表示はカスタマイズできます。カスタマイズした内容は、すべてのコードエディターに反映されます: @@ -68,10 +68,10 @@ title: コードエディター ![](../assets/en/code-editor/list-area.png) -- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示\非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 +- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示/非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 - すべてのウィンドウでリストを非表示にするには、次の方法があります: - - メソッド メニューの **表示** ＞ **リスト** オプションの選択を解除する + - **メソッド**メニューの **表示** ＞ **リスト** オプションの選択を解除する - **環境設定** の **メソッド** ページで **オプション** ＞ **リスト表示** の選択を解除する。**環境設定** ダイアログボックスでおこなった変更は、開かれているメソッドやクラス、関数を一度閉じて再度開いたときに反映されます。 #### リストのタイプ @@ -135,9 +135,9 @@ title: コードエディター - **行**: 行番号 - **階層**: 階層番号 (プログラム構造の階層レベル)。先頭のレベルは 0 です。この数値は、コード中でエラーが発生した際にインタープリターから提供されるのでデバッグ時に利用できます。 - **文字**: 行内の文字位置。 -- ![](../assets/en/code-editor/show-hide-list.png): Hide/display lists. +- ![](../assets/en/code-editor/show-hide-list.png): リストの表示/非表示。 -4Dコマンド、関数や変数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: +4Dコマンド、関数や引数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: ![](../assets/en/code-editor/status-bar-bold.png) ### ナビゲーションドロップダウン @@ -202,7 +202,7 @@ title: コードエディター メソッドやクラスのタグをアルファベット順に表示するには、次のいずれかを実行します: - ドロップダウンツールを **右クリックする** -- macOS では **option**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 +- macOS では **Cmd**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 > 関数内のタグは、親項目と一緒に移動します。 @@ -218,7 +218,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | **ショートカット** | **アクション** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| **選択およびナビゲージョン** | | +| **選択およびナビゲーション** | | | ダブルクリック | ランゲージ要素名を選択します。 | | [Alt]+ダブルクリック | スペースを含むランゲージ要素名 (定数、メソッドなど) を選択します。 | | [Shift]+[右矢印] | 選択範囲を作成し、一文字ずつ右に拡大します。 または、選択範囲を一文字ずつ左から縮小します。 | @@ -241,7 +241,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | [PgDn] | メソッドをページ単位で下にスクロールします (挿入カーソル位置は変更されません)。 | | [**イントロスペクション**](#定義を開く) | | | [Ctrl]+K または [Alt]+ダブルクリック | [**定義を開く**](#定義を開く) コマンドと同じ。 | -| トークン上で \[Ctrl\] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | +| トークン上で [Ctrl] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | | [**検索と置換**](#検索と置換) | | | [Ctrl]+F | 検索 | | [Ctrl]+G | 次を検索 | @@ -350,7 +350,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method > **環境設定** の **メソッド** ページで、**() と閉じる } ) ] " を自動で挿入** オプションをチェックしている場合、4D はひとつ以上の必須の引数を持つ4D コマンド、キーワード、プロジェクトメソッドの後ろに (提案、あるいは補完を受け入れたあとに) 自動的に **()** を追加します: > ![](../assets/en/code-editor/insert-and-closing-1.png) -> ![](../assets/en/code-editor/insert-and-closing-2.png) -例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: +自動補完機能は、コード構造 (例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: ![](../assets/en/code-editor/autocomplete-code-structures.png) 複数の候補がある場合、**Tab** キーを押すと 4D はそのポップアップリストを表示します: @@ -361,7 +361,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method デフォルトでは、値を選択したあとに区切り文字 `( ; : = < [ {` を入力すると、自動で値の候補も (区切り文字の前に) 挿入されます。 値のあとには区切り文字がつき、データの入力の準備ができた状態になります。 -![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** key --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) +![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** キー --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) > この区切り文字を使った候補の自動入力は、**環境設定** の **メソッド** ＞ **オプション** で無効にできます。 @@ -440,7 +440,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ### 置換 -*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ \*\* 置換...\*\* を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 +*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ **置換...** を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 *置換* エリアには、上の検索エリアの文字を置換する文字列を入力します。 @@ -496,11 +496,9 @@ Windows では、日本語や中国語を入力するために IME (Input Method - **4D コマンドドキュメンテーション**: 4D のコマンドや関数にマウスを重ねると、コマンドシンタックスと簡単な説明がヘルプTip に表示されます。 ![](../assets/en/code-editor/status-bar-description.png) - ![](../assets/en/code-editor/status-bar-description.png) - **変数型と詳細**: 変数にマウスを重ねると、その変数の型と (メソッド内で明示的に宣言されている場合)、付随したコメントが (あれば) ヘルプTip に表示されます。 ![](../assets/en/code-editor/variable-type.png) - ![](../assets/en/code-editor/variable-type.png) - **プロジェクトメソッドまたは関数**: プロジェクトメソッドまたはクラス関数にマウスを重ねると、以下の内容がヘルプTip に表示されます: @@ -522,7 +520,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ![](../assets/en/code-editor/comment-uncomment-1.png) --> ![](../assets/en/code-editor/comment-uncomment-2.png) -選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。 この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 +選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 > **コメント/アンコメント** コマンドは行全体に適用されます。行の一部のみをコメント化することはできません。 @@ -622,7 +620,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ::: -**定義を開く.....** コマンドの効果は、ターゲット要素によって異なります: +**定義を開く...** コマンドの効果は、ターゲット要素によって異なります: - プロジェクトメソッドの場合、コードエディターの新しいウィンドウ内にメソッドのコンテンツが表示されます。 - クラス名またはクラス関数の場合、コードエディター内にクラスが表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/CollectionClass.md index 0f0beb31d4fb8c..d45fdec7eabbfd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/CollectionClass.md @@ -376,7 +376,7 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] #### 例題 1 -通常の (非共有の) コレクション *$lastnames \* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames\*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -398,7 +398,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と\*$sharedColl2\* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と *$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataClassClass.md index 13b884f59d0e89..d593d8fc27d6cd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataClassClass.md @@ -482,7 +482,7 @@ $ds.Persons.clearRemoteCache() :::info -*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません）。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 +*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません)。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataStoreClass.md index ef4eeee12b03de..38e5725579a385 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/DataStoreClass.md @@ -746,7 +746,7 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAリクエス 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: -- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 .4Dindx ファイル) で暗号化されます。 +- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 - 暗号化可能テーブルから読み出したすべてのデータは、メモリ内で復号化されます。 **戻り値** diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EmailObjectClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EmailObjectClass.md index 7e055ae1d93fde..9405930a399a0b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EmailObjectClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EmailObjectClass.md @@ -5,8 +5,7 @@ title: Email 4Dにおけるメールの作成・送信・受信は `Email` オブジェクトの操作よっておこなわれます。 -*transporter* クラス関数を使ってメールを取得する際に、 -`Email` オブジェクトが作成されます。 +*transporter* クラス関数を使ってメールを取得する際に、`Email` オブジェクトが作成されます。 - IMAP - [`.getMail()`](IMAPTransporterClass.md#getmail) および [`.getMails()`](IMAPTransporterClass.md#getmails) 関数は IMAPサーバーからメールを受信します。 - POP3 - [`.getMail()`](POP3TransporterClass.md#getmail) 関数は POP3サーバーからメールを受信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntityClass.md index c017b8ae6dafee..96568cf6c36824 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntityClass.md @@ -530,7 +530,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: - オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換) 参照)、それ以外の場合にはその属性は更新されません。 - プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -907,9 +907,9 @@ $info:=$address.getRemoteContextAttributes()
    -| 引数 | 型 | | 説明 | -| --- | ------- | :-------------------------: | ------------------------------------------------------ | -| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。 それ以外は false。それ以外は false。 | +| 引数 | 型 | | 説明 | +| --- | ------- | :-------------------------: | ----------------------------------------- | +| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。それ以外は false。 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntitySelectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntitySelectionClass.md index 4f3de0ca16a700..e804a98ef8cee7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntitySelectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/EntitySelectionClass.md @@ -2046,9 +2046,9 @@ pathObjects コレクションには必要な数だけオブジェクトを追 | ranges[].start | Integer | レンジ内の先頭エンティティのインデックス (位置) | | ranges[].end | Integer | レンジ内の最終エンティティのインデックス (位置) | -`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。 インデックスは 0 起点です。インデックスは 0 起点です。 +`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。インデックスは 0 起点です。 -元のエンティティセレクションと *entitySelection* の両方が空であった場合、空のエンティティセレクションが返されます。 元のエンティティセレクションが空であった場合、*entitySelection* への参照、あるいは *entity* のみを格納したエンティティセレクションが返されます。 +呼び出し対象のエンティティセレクション、または *selectedEntities* のエンティティセレクションが空の場合、関数は `ranges` に空のコレクションを返します。 #### 例題 @@ -2091,7 +2091,7 @@ $result2:=$invoices.selected($creditSel) | 引数 | 型 | | 説明 | | --------- | ---------------------------------- | :-------------------------: | ---------------------------------------------------------- | -| startFrom | Integer | -> | 処理を開始するインデックス) | +| startFrom | Integer | -> | 処理を開始するインデックス | | end | Integer | -> | 終了インデックス (含まれない) | | 戻り値 | 4D.EntitySelection | <- | 抜粋エンティティを格納した新しいエンティティセレクション (シャロウ・コピー) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPAgentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPAgentClass.md index 421e7dc69222a1..0c2acba006e0c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPAgentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPAgentClass.md @@ -78,7 +78,7 @@ HTTPAgent のオプションは [HTTPRequest のオプション](HTTPRequestClas | プロパティ | 型 | デフォルト | 説明 | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) "storeCertificateName" によって上書き可能(下記参照) | +| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) | | keepAlive | Boolean | true | 当該エージェントについて keep-alive を有効にします | | maxSockets | Integer | 65535 | サーバーあたりの最大ソケット数 | | maxTotalSockets | Integer | 65535 | エージェントの最大ソケット数 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPRequestClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPRequestClass.md index a8e26576653baf..b07cd437c2b688 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPRequestClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/HTTPRequestClass.md @@ -13,7 +13,7 @@ title: HTTPRequest
    -`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 +`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 ### 非同期プログラミング @@ -197,7 +197,7 @@ macOS では、新しいアプリケーション(新しい [UUID](./FileClass.md | プロパティ | 型 | 説明 | | --------------------- | ---- | ------------------------------------------------------------------------------------- | -| .data | blob | 取得データ。取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | +| .data | blob | 取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | | .type | text | イベントの種類。取り得る値: "response", "error", "headers", "data", または "terminate | #### authentication オブジェクト @@ -311,9 +311,9 @@ authentication オブジェクトは `options.serverAuthentication` または `o
    履歴 -| リリース | 内容 | -| ----- | ----------------------------------------------------------------------- | -| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 `.rawHeaders` プロパティの追加 | +| リリース | 内容 | +| ----- | ------------------------------------------------ | +| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IMAPTransporterClass.md index f1bcae74518a81..2f89762aeaa556 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IMAPTransporterClass.md @@ -1129,12 +1129,12 @@ ID = 1のメッセージを取得します:
    -| 引数 | 型 | | 説明 | -| ---------- | ------- | :-------------------------: | --------------------------------------------------------------------------------------- | -| msgNumber | Integer | -> | メッセージのシーケンス番号 | -| msgID | Text | -> | メッセージの固有ID | -| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 false 時にはメッセージの状態は変化しません。 | -| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB | +| 引数 | 型 | | 説明 | +| ---------- | ------- | :-------------------------: | ------------------------------------------------------------- | +| msgNumber | Integer | -> | メッセージのシーケンス番号 | +| msgID | Text | -> | メッセージの固有ID | +| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 | +| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB |
    @@ -1656,13 +1656,11 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" - **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。複数指定する場合にはスペースで区切ります。例: `searchCriteria = KEYWORD \Flagged \Draft` -- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    +- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IncomingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IncomingMessageClass.md index b30429e9518ac2..966b86e3f90370 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IncomingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/IncomingMessageClass.md @@ -255,7 +255,7 @@ $value := $request.getHeader("content-type") `.headers` プロパティは、読み出し専用です。 -ヘッダー名(キー)は全て小文字となっています。ヘッダー名は全て大文字・小文字は区別されます。 +ヘッダー名(キー)は全て小文字となっています。ヘッダー名では大文字と小文字が区別されることに注意してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MailAttachmentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MailAttachmentClass.md index abecd7ff0205b9..c78d14bff47244 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MailAttachmentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MailAttachmentClass.md @@ -75,7 +75,7 @@ Attachment オブジェクトは、次の読み取り専用プロパティや、 #### 説明 -`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。 二つの値が利用可能です: 二つの値が利用可能です: +`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。二つの値が利用可能です: - "inline": 添付ファイルはメッセージコンテンツ内に、"cid"の場所にレンダリングされます。レンダリングの結果はメールクライアントによって異なります。 - "attachment": 添付ファイルはメッセージ内でリンクとして提供されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MethodClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MethodClass.md index 9f03f77f4ca4a2..32528380c7f948 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MethodClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/MethodClass.md @@ -124,7 +124,7 @@ End if `4D.Method.new()` 関数は、 *source* 引数のコードからビルドされた新しい `4D.Method` 型のオブジェクトを作成して返します。 -*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシークエンス](../Concepts/quick-tour.md#エスケープシークエンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 +*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシーケンス](../Concepts/quick-tour.md#エスケープシーケンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 オプションの *name* 引数には、4D デバッガーあるいはランタイムエクスプローラーに表示されるメソッドの名前を渡します。この引数を省略した場合、メソッド名は、 "anonymous" として表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/POP3TransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/POP3TransporterClass.md index 3a1d979fedf3a9..4a4227bdc46a1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/POP3TransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/POP3TransporterClass.md @@ -202,7 +202,7 @@ POP3 Transporter オブジェクトは [POP3 New transporter](../commands/pop3-n | 引数 | 型 | | 説明 | | ---------- | ------- | :-------------------------: | ------------------------------------------------------------ | | msgNumber | Integer | -> | リスト中のメッセージの番号 | -| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false） | +| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false) | | 戻り値 | Object | <- | [Email オブジェクト](EmailObjectClass.md#email-オブジェクト) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SessionClass.md index 12d3df79889823..7c53ea9344d0ea 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SessionClass.md @@ -83,7 +83,7 @@ Session オブジェクトは [`Session`](../commands/session) コマンドに :::note 注記 - 権限は、この関数が実行された[セッションの種類](#セッションの種類) に関わらず、Web アクセスを通して実行されたコードにのみ適用されるという点に注意してください。 -- この関数は [roles.json](../ORDA/privileges.md#rolesjsonファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 +- この関数は [roles.json](../ORDA/privileges.md#rolesjson-ファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 - セキュリティ上の理由から、この関数はリモートユーザーセッションのクライアント側から呼び出すことはできません(エラーが返されます)。 ::: @@ -528,7 +528,7 @@ End if | hostType | Text | ホストのタイプ: "windows"、"mac"、あるいは "browser" | | creationDateTime | 日付 (ISO 8601) | セッション作成の日時(スタンドアロンセッション: アプリケーションのスタートアップの日時) | | state | Text | セッションの状態: "active", "postponed", "sleeping" | -| ID | Text | セッションUUID ([`.id`](#id) と同じ値)) | +| ID | Text | セッションUUID ([`.id`](#id) と同じ値) | | persistentID | Text | リモート/クライアントセッション: セッションの永続的なID | | unreachableSince | Integer | リモートセッション: ピアが到達不能になってから経過した秒数。 4D Server 上では、この属性は[`Process activity.sessions`](../commands/process-activity) プロパティ内から読み出し可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SystemWorkerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SystemWorkerClass.md index c924b3a83fecaf..11683c6e0d1e58 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SystemWorkerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/API/SystemWorkerClass.md @@ -3,7 +3,7 @@ id: SystemWorkerClass title: SystemWorker --- -システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 +システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 `SystemWorker` クラスは、`4D` クラスストアにて提供されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/about.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/about.md index 96236d111fcf81..86efb2a3370abf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/about.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/about.md @@ -1,9 +1,9 @@ --- id: about -title: 4Dは独自のプログラミング言語を持っています。 +title: 4D ランゲージについて --- -1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: +4Dは独自のプログラミング言語を持っています。1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: - クエリや並べ替えなどのレコード管理エディターにプログラムでアクセスする - データベースの情報をもとに複雑なレポートやラベルを作成・印刷する @@ -17,9 +17,9 @@ title: 4Dは独自のプログラミング言語を持っています。 ## 4D ランゲージとは -4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。 このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 +4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 -4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。 言葉を交わすために言語のすべてを知る必要がないのと同じです。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 +4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 ## なぜランゲージを使用するのか @@ -42,7 +42,7 @@ title: 4Dは独自のプログラミング言語を持っています。 4D ランゲージのコマンドを使用して標準のレコード管理エディターにアクセスできます。たとえば、デザインモードにおいて「クエリ」ツールバーボタンを使って開けるクエリエディターは、`QUERY` コマンドを使用することでも表示されます。さらに、QUERY コマンドを使用すれば、エディターを開かなくても指定したデータを検索できるのです。たとえば `QUERY ([People];[People]Last Name="Smith")` と記述すると、データベースから "Smith" という名前の人物をすべて検索します。 -ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 +4D ランゲージはとてもパワフルです。ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 4D ランゲージは、ほとんどのタスクを簡単に実行できるようデザインされています。レコードの追加、並べ替え、データの検索などの操作がシンプルなコマンドで提供されています。さらにコマンドを使用してシリアルポートのコントロール、ディスク上のドキュメントの読み込み、高度なトランザクション処理等を行うこともできるのです。 @@ -56,6 +56,6 @@ title: 4Dは独自のプログラミング言語を持っています。 従来の言語を使用して開発を行う場合、まず念入りに計画を立てる必要があります。実際、計画の立案は開発の重要な工程の1つです。 4D においては、プロジェクトのあらゆる部分でいつでもランゲージを使いはじめることができます。たとえば、初めにフォームにメソッドを追加し、いくつかのメソッドをあとから追加することができます。アプリケーションがより高度になったら、メニューから実行するプロジェクトメソッドを追加することもできます。 4D ランゲージは好きなだけ利用することができます。他の多くのデータベースのような "すべてか無か" ではありません。 -従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。 作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 +従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 従来の言語は、コマンドの記述方法を制限するなどして、融通性に欠けることが多いのに対し、 4D ランゲージは伝統に縛られることなく進化していきます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/arrays.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/arrays.md index f7776999dbd998..06e67dfacdd1a9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/arrays.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/arrays.md @@ -3,7 +3,7 @@ id: arrays title: 配列 --- -**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 +**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 :::tip @@ -35,7 +35,7 @@ ARRAY INTEGER(aiAnArray;0) ## 配列要素への値の代入 -配列中の要素は中カッコ ({… }) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: +配列中の要素は中カッコ ({…}) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: ```4d ARRAY TEXT(atNames;5) @@ -97,7 +97,7 @@ atNames{$vlElem} というシンタックスに注目してください。 atNam 上のコードで作成した atTopics 配列について、次のことが言えます: - atTopics は、2次元配列です。 -- atTopics{8}{5} は、 8行5列目の要素です。 8行5列目の要素です。 +- atTopics{8}{5} は、 8行5列目の要素です。 - atTopics{20} は 20行目を指し、それ自体が 1次元の配列です。 - `Size of array(atTopics)` は、行数の 100を返します。 - `Size of array(atTopics{17})` は、17行目の列数である50を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/classes.md index 8a90a8aa83645e..8932ee9304e004 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/classes.md @@ -160,7 +160,7 @@ Class オブジェクトそのものは [共有オブジェクト](shared.md) クラス関数とは、当該クラスのプロパティです。クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use) なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 クライアント/サーバーアプリケーションのコンテキストにおいては、 `local` または `server` キーワードを使用することで、どちらのマシン上で関数を実行すべきかを指定することができます。これらのキーワードはORDA データモデル関数と共有シングルトン/セッションシングルトン関数でのみ使用することができます。詳細については、後述の [local および server 関数](#local-および-server) の項目を参照ください。 @@ -310,11 +310,11 @@ Function getRectArea($width : Integer; $height : Integer) : Integer `shared` キーワードを使うと**共有クラス** が作成されます。共有クラスは、共有オブジェクトのインスタンス化にのみ使われます。詳細については、後述の [共有クラス](#共有クラス) の項目を参照ください。 -`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 +`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 :::note -[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-class) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 +[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-クラス) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 ::: @@ -386,7 +386,7 @@ $o:=cs.MyClass.new("John";42) :::info -`property` キーワードは、クラス関数内の `Function` および `Class constructor` ブロック外でのみ使用できます。 +`property` キーワードは、クラス関数において `Function` および `Class constructor` ブロック外でのみ使用できます。 ::: @@ -420,7 +420,7 @@ property fuzzy // バリアント :::note -宣言と同時に色かするプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: +宣言と同時に初期化するプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: ```4d // 共有クラス内 @@ -642,7 +642,7 @@ $val:=$o.f() //8 共有クラスは **共有関数** をサポートしています。共有関数は、[`Use...End use`](shared.md#useend-use) 構文なしで呼び出すことができます。 -クラスが共有クラスかどうかは、Classオブジェクトの .[`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 +クラスが共有クラスかどうかは、Classオブジェクトの [`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 :::info @@ -674,7 +674,7 @@ cs.Person.isShared // true 共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 -共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します 。例: +共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。例: ```4d //共有クラス Foo @@ -740,9 +740,9 @@ shared Function Bar($value : Integer) シングルトンを引数付きでインスタンス化する必要がある場合には、[`new()`](../API/ClassClass.md#new) 関数を呼び出すこともできます。この場合、アプリケーションの起動時に実行されるコードでシングルトンをインスタンス化することが推奨されます。 -クラスがシングルトンクラスかどうかは、Classオブジェクトの .[`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 +クラスがシングルトンクラスかどうかは、Classオブジェクトの [`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 -クラスがセッションシングルトンかどうかは、Classオブジェクトの .[`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 +クラスがセッションシングルトンかどうかは、Classオブジェクトの [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 ### 公開されたシングルトン関数 @@ -847,7 +847,7 @@ $myList := cs.ItemInventory.me.itemList ## `local` および `server` -[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) におていは、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 +[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) においては、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 シンタックスは次の通りです: @@ -929,7 +929,7 @@ End if ::: -`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) ストリーム可能でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 +`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 この機能は、特に[リモートユーザーセッション](../Desktop/sessions.md#リモートユーザーセッション) のコンテキストにおいて有用で、これを使用することでビジネスロジックを[セッションシングルトン](../Concepts/classes.md#session-singleton) に実装することでセッションの全てのプロセス間でこれを共有することができ、結果として[`Session`](../commands/session) コマンドの機能を拡張することが可能になります。この場合、全てのセッション情報がサーバーに集められる様に、関連するビジネスロジックが**サーバー上で**実行されるようにしたい場合があるかもしれません。 @@ -944,7 +944,7 @@ End if - シングルトン *S1* はクライアント上でインスタンス化されます(名前は *s1* ) - *s1.function()* はクライアント上で実行されます。 -その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタン上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 +その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタンス上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/components.md index f4423e826ad8fd..984f35f5d6a476 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/components.md @@ -3,7 +3,7 @@ id: components title: コンポーネント --- -4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 +4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルを表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 ## コンポーネントのインストール diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/data-types.md index 85cf87224117e2..6e460c6c1200fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/data-types.md @@ -7,25 +7,25 @@ title: データタイプの概要 この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: -| データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | -| ----------------------------------------------------- | -------------------------- | -------- | ------------------------ | ----------------------- | -| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | -| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | -| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | -| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | -| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | -| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | -| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | -| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | -| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | -| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | -| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | -| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | -| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | -| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | -| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | +| データタイプ | データベース (1) | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | +| ----------------------------------------------------- | ----------------------------- | -------- | ------------------------ | ----------------------- | +| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | +| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | +| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | +| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | +| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | +| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | +| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | +| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | +| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | +| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | +| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | +| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | +| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | +| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | +| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | (1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 @@ -38,7 +38,7 @@ title: データタイプの概要 以下のコマンドを使用することで、フィールドや変数の型を調べることができます: - フィールドやスカラー変数に対しては、[`Type`](../commands/type) コマンド -- 式対しては、[`Value type`](../commands/value-type) コマンド +- 式に対しては、[`Value type`](../commands/value-type) コマンド ## デフォルト値 @@ -63,7 +63,7 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的 な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_blob.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_blob.md index 9c3f9b36ab6164..f5c1e4961a9587 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_blob.md @@ -140,7 +140,7 @@ $type:= OB Instance of($myObject.blob; 4D.Blob) // true // 4D.Blob から スカラーBLOB への変換 $myBlob:= $myObject.blob -$type:= +$type:= Value type($myBlob) // Blob ``` > `4D.Blob` をスカラーBLOB に変換する際に、`4D.Blob` のサイズがスカラーBLOB の最大サイズを超える場合、結果のスカラーBLOB は空になります。たとえば、スカラーBLOB の最大サイズが 2GB の場合、2.5GB の `4D.Blob` をスカラーBLOB に変換すると、空の BLOB が得られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_boolean.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_boolean.md index a43fa87dd4188d..1db75d8479b445 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_boolean.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_boolean.md @@ -58,7 +58,7 @@ myBoolean:=(myButton=1) | false | true | true | | false | false | false | -**Tip:** 式1と式2の排他的結合子演算を実行する必要がある場合、次の評価式を使用します: +**Tip:** 式1と式2の排他的論理和を実行する必要がある場合、次の評価式を使用します: ```4d (Expr1|Expr2) & Not(Expr1 & Expr2) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_collection.md index 68e153ea375349..cd2b8b18962b5d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_collection.md @@ -29,7 +29,7 @@ collectionRef[expression] $myVar:=myCol[0] ``` -コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます: +コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられます: ```4d var myCol : Collection @@ -105,14 +105,14 @@ $users:=[{name: "Alice"; \ 二種類のコレクションを作成することができます: -- [`New collection`](../../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared collection`](../../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 +- [`New collection`](../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared collection`](../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例' `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例: `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -233,7 +233,7 @@ var $c3:=$c1 // 同じインスタンスへの参照 :::note -Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md##blob-の自動変換) され、またその逆も然りです。 +Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md#blob-の自動変換) され、またその逆も然りです。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_date.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_date.md index f2a035f22c1012..0ea510888eaa2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_date.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_date.md @@ -11,7 +11,7 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付リテラル -日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) 下記に、日付定数の例を示します: +日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) を使って記述します。下記に、日付定数の例を示します: ```4d !1976-01-01! @@ -30,23 +30,23 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付演算子 -| 演算 | シンタックス | 戻り値 | 式 | 値 | -| ----- | ------------------------------------- | ------- | --------------------------- | ------------ | -| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | -| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | -| 日付の減算 | Date – Number | Date | !2017-01-20! !2017-01-20! | !2017-01-11! | -| 等しい | Date = Date | Boolean | !2017-01-20! = !2017-01-01! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 異なる | Date # Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 大きい | Date > Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 小さい | Date < Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 以上 | Date >= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-01!>=!2017-01-20! | false | -| 以下 | Date <= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | +| 演算 | シンタックス | 戻り値 | 式 | 値 | +| ----- | ------------------------------------- | ------- | ----------------------------------------------------- | ------------ | +| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | +| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | +| 日付の減算 | Date – Number | Date | !2017-01-20! - 9 | !2017-01-11! | +| 等しい | Date = Date | Boolean | !2017-01-20! =!2017-01-20! | true | +| | | | !2017-01-20! = !2017-01-01! | false | +| 異なる | Date # Date | Boolean | !2017-01-20! # !2017-01-01! | true | +| | | | !2017-01-20! # !2017-01-20! | false | +| 大きい | Date > Date | Boolean | !2017-01-20! > !2017-01-01! | true | +| | | | !2017-01-20! > !2017-01-20! | false | +| 小さい | Date < Date | Boolean | !2017-01-20! < !2017-01-20! | true | +| | | | !2017-01-20! < !2017-01-20! | false | +| 以上 | Date >= Date | Boolean | !2017-01-20! >=!2017-01-01! | true | +| | | | !2017-01-01!>=!2017-01-20! | false | +| 以下 | Date <= Date | Boolean | !2017-01-20! <= !2017-01-20! | true | +| | | | !2017-01-20! <= !2017-01-01! | false | ## JavaScriptからの日付の変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_null_undefined.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_null_undefined.md index 00cb15c3e76501..cea54a9eeece33 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_null_undefined.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_null_undefined.md @@ -23,7 +23,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ フィールドは、未定義にはできません (フィールドの場合、`Undefined` コマンドは常に False を返します)。 -未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。 ただし以下の場合には生成されません: +未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。ただし以下の場合には生成されません: - 未定義の値を(配列を除く)変数に代入することは、変数に対して[`CLEAR VARIABLE`](../commands/clear-variable) を呼び出すのと同じ効果があります: @@ -41,7 +41,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ - ブール: False - 文字列: "" - 数値: 0 - - 日付: 日付: 日付: 日付: 日付: 日付: "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" + - 日付: !00-00-00! "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" - 時間: 0 (ミリ秒単位) - 未定義、Null: 変化なし @@ -51,7 +51,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ $o.a:=$o.b //$o.a=0 ``` -- 未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +- 未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 - 未定義の値を引数としてプロジェクトメソッドに渡した場合、宣言された引数の型に応じて、0 あるいは "" (空の文字列) へと自動変換されます。 @@ -97,7 +97,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ | | Null `#` Undefined | Boolean | a.nullProp `#` b.undefinedProp | false | | | Null `#` *scalar value* | Boolean | a.nullProp `#` 42 | true | -*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でもnull でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: +*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でも null でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: ```4d var $object : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_number.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_number.md index c5b5eb5fb1e708..d41770f6dc818a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_number.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_number.md @@ -71,7 +71,7 @@ title: Number (実数、整数) - 10 % 2は、0を返します。 10 は 2 で割り切れるからです。 - 10 % 3は、1を返します。 余りが 1 だからです。 -- 10.5 % 2は、0を返します。 余りが整数ではない (0.25) からです。 +- 10.5 % 2は、0を返します。 余りが整数ではない (0.5) からです。 :::warning @@ -85,7 +85,7 @@ title: Number (実数、整数) ### 実数の比較 -2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 +2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細に関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_object.md index 539c6959bafc90..10cfa0a615b6ff 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_object.md @@ -18,7 +18,7 @@ title: Object - ピクチャー(2) - collection -(1) [\*\* ストリーム不可能なオブジェクト\*\*](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 +(1) [**ストリーム不可能なオブジェクト**](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 (2) デバッガー内でテキストとして表示したり、JSON へと書き出されたりした場合、ピクチャー型のオブジェクトプロパティは "[object Picture]" と表されます。 @@ -53,7 +53,7 @@ title: Object ### `New object` コマンド -[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規コレクションを作成し、その参照を返します。 +[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規オブジェクトを作成し、その参照を返します。 例: @@ -110,12 +110,12 @@ $col:=$o.col[5] // 6 二種類のオブジェクトを作成することができます: -- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) コレクション。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有コレクション。共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 +- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) オブジェクト。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有オブジェクト。共有オブジェクトはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例' `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例: `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -213,7 +213,7 @@ ASSERT($o1=$o2) // True ### Null 値 -オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。 例: +オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。例: ```4d myObject.address.zip:=Null @@ -224,7 +224,7 @@ ASSERT($o1=$o2) // True ### 未定義の値 -オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 詳細については [Null と 未定義](dt_null_undefined.md) を参照ください。 @@ -305,7 +305,7 @@ $doc:=Null // $docが占有するリソースを解放します しかしながら、オブジェクトのテキストストリーミングには、以下の様な制約があります: -- 循環参照(自分自身をプロパティとして格納してるオブジェクト)はサポートされおらず、エラーを返します +- 循環参照 (自分自身をプロパティとして格納してるオブジェクト) はサポートされておらず、エラーを返します - クラスのオブジェクトは文字列化した際にどのクラスであるかという情報は失われます - [Entity](../API/EntityClass.md) などのネイティブな4D クラスオブジェクトはJSON として表現はできず、"[object \]" と返されます。例: "[object Entity]" diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_picture.md index d401064c25c817..c4e4dfa184132b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_picture.md @@ -32,8 +32,8 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを | -------- | ------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 水平連結 | Pict1 + Pict2 | Picture | Pict1 の右側に Pict2 を追加します | | 垂直連結 | Pict1 / Pict2 | Picture | Pict1 の下側に Pict2 を追加します | -| 排他的論理和 | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | -| 包括的論理和 | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | +| 排他的重ね合わせ | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | +| 包括的重ね合わせ | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | | 水平移動 | Picture + Number | Picture | 指定ピクセル分、ピクチャーを横に移動します。 | | 垂直移動 | Picture / Number | Picture | 指定ピクセル分、ピクチャーを縦に移動します。 | | リサイズ | Picture \* Number | Picture | 割合によってピクチャーをサイズ変更します。 | @@ -70,7 +70,7 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを ![](../assets/en/Concepts/concatVer.en.png) ![](../assets/en/Concepts/concatVer2.en.png) -排他的論理和 +排他的重ね合わせ ```4d Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 @@ -78,7 +78,7 @@ Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 ![](../assets/en/Concepts/superimpoExc.fr.png) -包括的論理和 +包括的重ね合わせ ```4d Pict3:=Pict1|Pict2 // 同じサイズの二つのピクチャーを重ね合わせた上でそのマスクの結果を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_pointer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_pointer.md index 50ae7d97a89de3..8997c5db04196c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_pointer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_pointer.md @@ -3,7 +3,7 @@ id: pointer title: Pointer --- -ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、またはフィールドへの参照です。ポインタータイプのフィールドは、存在しません。 +ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、フィールド、またはオブジェクトへの参照です。ポインタータイプのフィールドは、存在しません。 ポインターは、(プログラミングにおける) データを参照するための高度な方法を提供します。 4D ランゲージ使用時にテーブル・フィールド・変数・配列等にアクセスするには、単純に名前を用います。ですが、名前を使用しないでデータを参照する、またはアクセスした方が便利な場合もあります。ポインターを使うとこれが実現できます。 @@ -47,7 +47,7 @@ $MyPointer-> 前述の式は、"Hello" という文字列を返します。ポインター記号 (->) をポインターの後につけると、参照先の値を取得することができます。これをデリファレンス (参照外し) と呼びます。 -ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、オリジナルの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: +ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、もとの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: ```4d ALERT($MyPointer->) @@ -59,7 +59,7 @@ $MyPointer を使用して $MyVar の値を変更することもできます。 $MyPointer->:="Goodbye" ``` -この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。 両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: +この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: ```4d ALERT($MyPointer->) @@ -154,7 +154,7 @@ $FieldPtr:=Field(1;2) OBJECT SET FONT($FieldPtr->;"Arial") ``` -### 変数へのポインター +### ローカル変数へのポインター プロセス変数またはローカル変数のポインターを使う場合、参照される変数はポインターが使用される時点ですでに定義されていなければなりません。ローカル変数は、それらを作成したメソッドの実行が終わると破棄され、プロセス変数もそれを作成したプロセスの終了時に削除される点に留意してください。存在しない変数をポインターで呼び出そうとすると、インタープリターモードでは (「変数が設定されていません」という内容の) シンタックスエラーが起きます。コンパイルモードでは、さらに重大なエラーが発生する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_string.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_string.md index 22aa6f7cc67387..3d357f5aba0a4a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_string.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_string.md @@ -10,7 +10,7 @@ title: String ## 文字列リテラル -文字列リテラル定数は、次のように二重引用符 ("...") 文字列定数の例を次に示します: +文字列リテラル定数は、次のように二重引用符 ("...") で囲んで表します。文字列定数の例を次に示します: ```4d "レコード追加" @@ -24,21 +24,21 @@ title: String 以下のエスケープシーケンスを文字列内で使用できます: -| エスケープシーケンス | 意味する文字 | -| ---------- | --------------------------- | -| \n | LF (行送り) | -| \t | HT (タブ) | -| \r | CR (改行) | -| \\\\ | | -| \\" | " (引用符) | +| エスケープシーケンス | 意味する文字 | +| --------------------------------------- | --------------------------- | +| \n | LF (行送り) | +| \t | HT (タブ) | +| \r | CR (改行) | +| \\\\|\ (バックスラッシュ) | | +| \\" | " (引用符) | -**注:** \ (バックスラッシュ) は Windows でパス名の区切り文字として使用されています。しかし “C:\MyDocuments\New” と入力した場合、4Dは二番目のバックスラッシュは "\N" (行送り) と解釈してしまい、“C:\\\MyDocuments\New”を表示します。 このようなケースでは開発者がバックスラッシュを2つ入力するようにしなければなりません。 +**注:** \ (バックスラッシュ) は Windows ではパス名の区切り文字としても使用されています。そのため、パス名において、4D のエスケープシーケンスで使用される文字の前にバックスラッシュを挿入したいときは、\\\ のようにバックスラッシュを 2つ入力しなければなりません (例: "\N" (行送り) と解釈されないよう、"C:\\\MyDocuments\\\New.txt" と表します)。 ### 行末の自動正規化 データベース内で管理されているテキストが複数のプラットフォームで正常に処理されるようにするため、4D は改行文字を自動的に正規化し、それらが単一の文字( `\r` 、キャリッジリターン)に収まる様にします。この正規化は、標準テキストまたはマルチスタイルテキストをホストするフォームオブジェクト(変数またはフィールド)レベルにおいて実行されます。ネイティブではない改行文字、あるいは複数の改行文字の混用(例えば `\r\n` など)は、単一の `\r` とみなされます。なお、XML 標準(マルチスタイルテキストフォーマット)に準拠するため、[スタイル付きテキストコマンド](../commands/theme/Styled_Text.md) は、オブジェクトに割り当てられていないテキスト変数の行末文字も正規化するという点に注意してください。 -この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが用意になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を公領する必要があります。 +この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが容易になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を考慮する必要があります。 ## 文字列演算子 @@ -64,7 +64,7 @@ title: String ## 文字列比較の詳細 - 文字列は文字ごとに比較されます (後述の [キーワード](dt_string.md#キーワード) による検索の場合を除きます)。 -- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。大文字と小文字を区別して比較するには、文字コードで比較してください。たとえば、次の式は `FALSE` です: ```4d Character code("A")=Character code("a") @@ -90,7 +90,7 @@ Character code("A")=Character code("a") "abcdefghij"="abc@" ``` -一方、どのような場合でも、ワイルドカードを 2つ連続して使用した文字列比較は常に FALSE を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +ただし、複数の文字を比較する目的のワイルドカード記号は、比較演算子の右側の式で使用しなければなりません。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: ```4d "abc@"="abcdefghij" @@ -128,7 +128,7 @@ Character code("A")=Character code("a") 以下のようにすると、式は意図したように評価されます: ```4d -(Character code($vsValue[[Length($vsValue)]])=64) +(Character code($vsValue[[Length($vsValue)]])#64) ``` **注:** ストラクチャー設定のデータベースページには、文字列に @ 記号が含まれているとき、それをどう解釈するかを指定するオプションが提供されています。 @@ -184,7 +184,7 @@ End if ### 無効な文字列参照に関する注意 -文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。 +文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。長さが足りない場合: - インタープリターモードでは構文エラーは発生しません。 - コンパイルモードで範囲チェックオプションを無効にしている場合には、メモリ領域を破壊するおそれがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_time.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_time.md index 0d04c4a95edf86..4b731c331977bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_time.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_time.md @@ -7,7 +7,7 @@ title: Time 時間は 24時間制です。 -時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す総秒数です。 +時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す深夜0時からの総秒数です。 **注:** *4Dランゲージリファレンス* マニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。 @@ -25,7 +25,7 @@ title: Time ?13:01:59? // 午後1時1分59秒 ``` -空の時間は、?00.00.00? のように指定します。 +空の時間は、?00:00:00? のように指定します。 **Tip:** コードエディターでは空の時間を入力するためのショートカットが提供されています。空の時間を入力するには、疑問符 (?) の入力後に Enterキーを押します。 @@ -34,26 +34,26 @@ title: Time | 演算 | シンタックス | 戻り値 | 式 | 値 | | --------------------------- | ------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | 加算 (足し算) | Time + Time | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? | -| 減算 (引き算) | Time – Time | Time | ?02:03:04? ?01:02:03? | ?01:01:01? | +| 減算 (引き算) | Time – Time | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? | | 加算 (足し算) | Time + Number | Number | ?02:03:04? + 65 | 7449 | -| 減算 (引き算) | Time – Number | Number | ?02:03:04? ?01:02:03? | 7319 | -| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? ?01:02:03? | 14768 | -| 除算 (割り算) | Time / Number | Number | ?02:03:04? ?01:02:03? | 3692 | -| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? ?02:03:04? | 3692 | +| 減算 (引き算) | Time – Number | Number | ?02:03:04? – 65 | 7319 | +| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? \* 2 | 14768 | +| 除算 (割り算) | Time / Number | Number | ?02:03:04? / 2 | 3692 | +| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? \ 2 | 3692 | | モジューロ | Time % Time | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? | | モジューロ | Time % Number | Number | ?02:03:04? % 2 | 0 | -| 等しい | Time = Time | Boolean | ?01:02:03? >=?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 異なる | Time # Time | Boolean | ?01:02:03? ?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 大きい | Time > Time | Boolean | ?01:02:03? > ?01:02:03? | true | +| 等しい | Time = Time | Boolean | ?01:02:03? = ?01:02:03? | true | +| | | | ?01:02:03? = ?01:02:04? | false | +| 異なる | Time # Time | Boolean | ?01:02:03? # ?01:02:04? | true | +| | | | ?01:02:03? # ?01:02:03? | false | +| 大きい | Time > Time | Boolean | ?01:02:04? > ?01:02:03? | true | | | | | ?01:02:03? > ?01:02:03? | false | | 小さい | Time < Time | Boolean | ?01:02:03? < ?01:02:04? | true | | | | | ?01:02:03? < ?01:02:03? | false | | 以上 | Time >= Time | Boolean | ?01:02:03? >=?01:02:03? | true | | | | | ?01:02:03? >=?01:02:04? | false | | 以下 | Time <= Time | Boolean | ?01:02:03? <=?01:02:03? | true | -| | | | ?01:02:03? <=?01:02:03? | false | +| | | | ?01:02:04? <=?01:02:03? | false | ### 例題 1 @@ -78,7 +78,7 @@ $vhSoon:=Time(Current time+3600) ### 例題 2 -モジューロ演算子を使用できます。 とくに24時間フォーマットを考慮した時間の追加に便利です: +モジューロ演算子を使用できます。とくに24時間フォーマットを考慮した時間の追加に便利です: ```4d $t1:=?23:00:00? // 23時です diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_variant.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_variant.md index d987830b9a641f..c2279417430f47 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_variant.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/dt_variant.md @@ -37,7 +37,7 @@ $vtype:=Type($variant) // 12 (Is variant) $vtypeVal:=Value type($variant) // 1 (Is real) ``` -変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。 ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: +変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: ```4d C_VARIANT($v) @@ -48,7 +48,7 @@ $t:=Type($v) // 12 (Is variant) 代入元の変数はバリアント型ですが $t2:=Type($v2) // 2 (Is text) 代入先の変数はテキスト型です ``` -バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) この場合、引数の値の型の確認作業が必要になります: +バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) を宣言するのに使用できます。この場合、引数の値の型の確認作業が必要になります: ```4d #DECLARE ($param : Variant) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/error-handling.md index 7db089561d8327..4ac97bc4d102a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/error-handling.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/error-handling.md @@ -23,9 +23,9 @@ title: エラー処理 ## 予測可能なエラーvs予測不可能なエラー {#predictable-vs-unpredictable-errors} -[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドを実装する) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 +[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドの実装) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 -もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、プロパティに値(例: `dk status serious error` - "その他のエラー")も返すことがあり得るという点に注意してください。 +もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、`status` と `statusText` プロパティに値 (例: `dk status serious error` - "その他のエラー") を返すこともあり得るという点に注意してください。 ## エラー処理メソッドの実装 @@ -45,7 +45,7 @@ ON ERR CALL("IO_Errors";ek local) // ローカルなエラー処理メソッド ON ERR CALL("";ek local) // ローカルプロセスにおいてエラーの検知を中止します ``` -[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。 エラー処理メソッドを一時的に変更し、後で復元することができます: +[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。エラー処理メソッドを一時的に変更し、後で復元することができます: ```4d $methCurrent:=Method called on error(ek local) @@ -98,7 +98,7 @@ ON ERR CALL("componentHandler";ek errors from components) // コンポーネン ::: - [`Last errors`](../commands/last-errors) コマンドは4D アプリケーション内で発生したエラーのカレントのスタックのコレクションを返します。 -- the [`Call chain`](../commands/call-chain) command that returns a collection of objects describing each step of the method call chain within the current process. +- [`Call chain`](../commands/call-chain) コマンドは、カレントプロセス内におけるメソッド呼び出しチェーンの各ステップを説明するオブジェクトのコレクションを返します。 #### 例題 @@ -229,7 +229,7 @@ End try - エラーがスローされなかった場合には、対応する `End try` キーワードの後へとコード実行が継続されます。 `Catch` と `End try` キーワード間のコードは実行されません。 - コードブロックの実行が *非遅延エラー* をスローした場合、実行フローは停止し、対応する `Catch` コードブロックを実行します。 -- コードブロックが *非遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 +- コードブロックが *遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 - 遅延エラーが `Try` ブロックから直接スローされた場合、実行フローは `Try` ブロックの終わりまで継続し、対応する `Catch` ブロックは実行しません。 :::note @@ -290,14 +290,14 @@ Function createInvoice($customer : cs.customerEntity; $items : Collection; $invo コード実行を妨げる例外は4D によって返されますが、その原因はOS、デバイス、4D カーネル、コード内の[`throw`](../commands/throw) など、様々な要因が考えられます。そのため、3つの要素によって定義されます: - **コンポーネント署名**。エラーの起きた場所を表します(署名の一覧については[`Last errors`](../commands/last-errors) を参照してください) -- **メッセージ**。エラーがなぜ起きたかを説明します。 +- **メッセージ**。エラーがなぜ起きたかを説明します - **コード**。コンポーネントによって返される任意の数値です。 エラーと特にその原因の完全な詳細を取得するには、[4D エラーダイアログボックス](../Debugging/basics.md) あるいは[`Last errors`](../commands/last-errors.md) コマンドを使用することができます。 ### エラーダイアログボックス -[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボランをクリックします: +[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボタンをクリックします: ![copy-button](../assets/en/Concepts/error.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/flow-control.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/flow-control.md index ad3bb638ee730b..b7eecdc650fcb9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/flow-control.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/flow-control.md @@ -7,7 +7,7 @@ title: 制御フロー - **シーケンシャル**: シーケンシャル構造は単純な線形構造です。シーケンスとは、4Dが最初から最後まで次々に実行する一連のステートメントです。オブジェクトメソッドで頻繁に使用される1行から成るルーチンはもっとも簡単なシーケンシャル構造の例です。例: `[People]lastName:=Uppercase([People]lastName)` - **分岐**: 分岐構造は、条件をテストし、その結果に基づいて異なる流れにメソッドを導きます。条件は true または false に評価されるブール式です。 [`If...Else...End if`](#ifelseend-if) 構文は分岐構造の一例で、処理フローを二つに分岐します。 [`Case of...Else...End case`](#case-ofelseend-case) 構文も分岐構造の一つで、処理フローをもっとたくさん分岐することができます。 -- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これに実現するために、4D は以下のループ構造を備えています: +- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これを実現するために、4D は以下のループ構造を備えています: - [`While...End while`](#whileend-while) - [`Repeat...Until`](#repeatuntil) @@ -16,7 +16,7 @@ title: 制御フロー ループを制御する方法には、条件が満たされるまでループする方法と、指定した回数だけループする方法の2通りがあります。各ループ構造はいずれの方法にも用いることができますが、`While` ループと `Repeat` ループは条件が満たされるまで繰り返す場合に、`For` ループは指定した回数だけループする場合の利用に適切です。 `For each...End for each` ループは両方を組み合わせることが可能で、オブジェクトやコレクション内でループするために設計されています。 -**注:** 4Dはプログラム構造 (If/While/For/Caes of/Repeat/For each) を512レベルまで入れ子で記述できます。 +**注:** 4Dはプログラム構造 (If/While/For/Case of/Repeat/For each) を512レベルまで入れ子で記述できます。 ## If...Else...End if @@ -268,7 +268,7 @@ vResult = 1の判定により他の条件を見る前に分岐するので、第 一般に、`While...End while` ループに入る手前で、ブール式で判定する値を初期化しておきます。値を初期化するとは適切な値に設定するということで、通常はブール式が true になるように設定してからループに入ります。 -ブール式は、ループ内の要素を使って設定されなければなりません。 そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 +ブール式は、ループ内の要素を使って設定されなければなりません。そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 ```4d NeverStop:=True @@ -309,7 +309,7 @@ Until(Boolean_Expression) #### 例題 -以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数　`OK` を初期化する `CONFIRM` コマンドはありません。 +以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数 `OK` を初期化する `CONFIRM` コマンドはありません。 ```4d Repeat @@ -375,7 +375,7 @@ End for End for ``` -4. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +4. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d FIRST RECORD([aTable]) @@ -424,7 +424,7 @@ End for End for ``` -8. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +8. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d LAST RECORD([aTable]) @@ -552,7 +552,7 @@ End for End for each ``` -`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の \*Expression \* を対象に反復処理をおこなうことができます: +`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の *Expression* を対象に反復処理をおこなうことができます: - コレクション: コレクションの各要素をループします - エンティティセレクション: 各エンティティをループします diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/identifiers.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/identifiers.md index 59353fc439a0af..8437bd7d41b2fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/identifiers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/identifiers.md @@ -75,7 +75,7 @@ Function getArea($width : Integer; $height : Integer)-> $area : Integer - 1文字目は、文字、数字、あるいはアンダースコア(_) でなければなりません。 - その後の文字には、文字・数字・アンダースコア(_)・スペースが使用できます。 - 予約語を使用しないでください。予約語にはコマンド名 (`Date`, `Time` 等)、キーワード (`If`, `For` 等)、そして定数 (`Euro`, `Black`, `Friday` 等) が含まれます。 -- 大文字・小文字は区別されます。 +- 大文字・小文字は区別されません。 例: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/interpreted.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/interpreted.md index 168d45256e64a6..36d3d5fe595e29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/interpreted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/interpreted.md @@ -27,7 +27,7 @@ title: インタープリターモードとコンパイル済みモード | 変数や配列のデータタイプは変更できません。 | 変数や配列のデータタイプは変更可能です (推奨されません) | | 1次元配列を2次元配列に、また2次元配列を1次元配列に変更することはできません。 | 可能です。 | | コンパイラーにより変数のタイプ定義はおこなわれますが、フォーム上の変数のようにデータタイプが明確でない場合は、宣言によって変数のデータタイプを指定するべきです。 | | -| `Undefined` 関数は、常に False を返します。 変数は常に定義されています。変数は常に定義されています。 | | +| `Undefined` 関数は、常に False を返します。変数は常に定義されています。 | | | メソッドの "プリエンプティブプロセスで実行可能" プロパティにチェックを入れていた場合、コードは他のスレッドアンセーフなコマンドやメソッドを呼び出してはいけません。 | プリエンプティブプロセスプロパティは無視されます。 | | 特定のループの場合、割り込みを可能にするには `IDLE` コマンドが必要です。 | いつでも割り込み可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/methods.md index 6fceb51a31e39a..6779385e1814af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/methods.md @@ -5,7 +5,7 @@ title: メソッド メソッドとは、1つ以上の動作を実行するコードのことです。メソッドは、1つ以上のステートメントで構成されます。 -ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する) することができます。 +ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する)することができます)。 メソッドは最大 2GBのテキストまたは、32000行まで記述できます。 @@ -17,14 +17,14 @@ title: メソッド | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **プロジェクトメソッド** | プロジェクトメソッド名が[呼び出された時](../Project/project-method-properties.md) に応じて | ◯ | 任意のアクションを実行するためのコードです。作成されたプロジェクトメソッドは、そのプロジェクトのランゲージの一部となります。 | | **オブジェクト (ウィジェット) メソッド** | メソッドが設定されたフォームオブジェクトに関連したイベント発生時に | × | フォームオブジェクト (ウィジェットとも呼びます) のプロパティです。 | -| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | +| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | | **トリガー** (別名 *テーブルメソッド*) | テーブルのレコード操作 (追加・削除・修正) の度に | × | テーブルのプロパティです。トリガーは、データベースのレコードに対して「不正な」操作がおこなわれることを防ぎます。 | | **データベースメソッド** | 作業セッションのイベント発生時に | ○ (既定) | 4D には 16のデータベースメソッドがあります。 | | **クラス** | クラスのオブジェクトがインスタンス化されたとき、あるいは他のメソッドや[データベースフィールド](../Develop/field-properties.md#class) 内においてオブジェクトインスタンス上でクラスの関数が実行されたときに自動的に呼び出されます。 | ◯(クラス関数) | オブジェクトのクラスの[constructor](./classes.md#class-constructor), [properties](./classes.md#property) と[関数](./classes.md#function) を宣言および設定するためには、**Class** が使用されます。[**クラス**](classes.md) および[**Function** クラス](../API/FunctionClass.md) 参照。 | ## ランゲージトークン -4Dランゲージでは、コード内で使用される全てのオブジェクト名(定数、コマンド、テーブル、フィールドそしてキーワード) 全てに対してユニークな トークナイゼーションシステムというものを持っています。これらの名前をトークナイズするということは、それらをコードエディターにタイプする際に内部で絶対参照 (数値) として保存され、実行時、あるいは表示時にコンテキストに応じてテキストとして復元されるということを意味します。これにより、コードは常に正しく解釈されるということが保証され、テーブルやフィールドの名前を変更した場合でも、4Dランゲージコマンドが異なるアプリケーションのバージョンに置いて改名された場合等でも正しく解釈されます。 +4Dランゲージでは、コード内で使用される全てのオブジェクト名(定数、コマンド、テーブル、フィールドそしてキーワード) 全てに対してユニークな トークナイゼーションシステムというものを持っています。これらの名前をトークナイズするということは、それらをコードエディターにタイプする際に内部で絶対参照 (数値) として保存され、実行時、あるいは表示時にコンテキストに応じてテキストとして復元されるということを意味します。これにより、コードは常に正しく解釈されるということが保証され、テーブルやフィールドの名前を変更した場合でも、4Dランゲージコマンドが異なるアプリケーションのバージョンにおいて改名された場合等でも正しく解釈されます。 **注意:** これは環境設定のメソッドページの["リージョンシステム設定を使用"オプション](../Preferences/methods.md#4dプログラミングランゲージ-リージョンシステム設定を使う) を有効化し、お使いの4D を異なる言語設定でデータベースを開いた際にも、コードの自動翻訳が正確であることを保証します。 @@ -48,7 +48,7 @@ title: メソッド ### トークンシンタックス -式の中でトークナイズ可能な名前付き要素に対して、4D はトークンを直接参照するための特別な信託巣を提供しています。要素名の後に型(コマンド、フィールド、など)を指定する特定の接頭辞を追加し、そのあとに参照を追加します。以下の表にこのトークンシンタックスについての詳細がまとめてあります: +式の中でトークナイズ可能な名前付き要素に対して、4D はトークンを直接参照するための特別なシンタックスを提供しています。要素名の後に型(コマンド、フィールド、など)を指定する特定の接頭辞を追加し、そのあとに参照を追加します。以下の表にこのトークンシンタックスについての詳細がまとめてあります: | 機能 | 使用例(標準のシンタックス) | 接尾辞 | 使用例(トークンシンタックス) | コメント | | -------- | ------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | @@ -58,7 +58,7 @@ title: メソッド | フィールド | [Employees]Name | :xx | [Employees:1]Name:2 | xx はフィールド番号です | | 4D プラグイン | PV PRINT(area) | :Pxx:yy | PV PRINT:P13000:229(area) | xx はプラグインIDで、yy はコマンドのインデックスです | -**注意:** 接頭辞には大文字(C, P)を使用しなければなりません。そうでない場合には正常に解釈されません。 +**注意:** 接尾辞には大文字 (C, P) を使用しなければなりません。そうでない場合には正常に解釈されません。 このシンタックスを使用することにより、フォーミュラの名前が変更された場合でも、データベースが異なる言語において実行された場合でも、フォーミュラが正しく解釈される事を保証します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/operators.md index 1baedda0c29499..aa24982323112d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: -- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 -- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#ternary-operator) (a ? b : c\\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2 + 3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#三項演算子) (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -24,7 +24,7 @@ title: 演算子 $myNumber:=3 // 3 を $myNumber 変数に代入 $myDate:=!2026/01/21! // 日付リテラルを代入 $myLength:=Length("Acme") // コマンドの結果(4) を $myLength に代入 -$col:=New collection //$col をからのコレクションで初期化 +$col:=New collection //$col を空のコレクションで初期化 $myObject:={ a:2 ; b:$col } // オブジェクト参照を $myObject に代入 $myObject.a:=3 // オブジェクトプロパティに値を代入 ``` @@ -97,7 +97,7 @@ $a+=2 // $a=3 - オブジェクトプロパティあるいはコレクション要素としてのピクチャー - 配列のインデックス変数 -"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()-+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 +"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()->+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 > [テキストの文字インデックス](dt_string.md#文字参照記号) および [BLOB のバイトインデックス](dt_blob.md#スカラーblob-のバイトへのアクセス) では、これらの演算子はサポートされません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/ordering.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/ordering.md index 85480bfae8c0c4..c2ef7b7780de6c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/ordering.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/ordering.md @@ -1,17 +1,17 @@ --- id: ordering -title: コレクションとオブジェクトの並び替え +title: コレクションとオブジェクトの並べ替え --- 一連のデータをソートするために、4D はデータの型に応じて定義された比較条件を適用することで、それぞれの値を他の値と比較します([並べ替えルール](#並べ替えルール) を参照してください)。このプロセスは全ての要素に渡って総合的な並べ替えを確立するためのソートアルゴリズムに依存しています。全てのデータが同じ [データ型](./data-types.md) に所属している場合、比較ルールは単純で正確に定義されています。 -しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は戦略的な並べ替えスキームを適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 +しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は階層化された並べ替え方式を適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 ## 並べ替え機能 4D ランゲージには、コレクション要素、オブジェクト属性をソートしたり、あるいは順序づけされた結果のためのソートを作成することに依存する複数の機構を提供します: -- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (明示的なキーと並べ替え指定を使用した複数条件並べ替え)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによる並べ替え)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な並べかリレーションによるインプレースなソート) +- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (キーと順序を明示的に指定する多条件ソート)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによるソート)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な順序関係によるインプレースなソート) - **エンティティセレクションの並べ替え用関数**: [`entitySelection.orderBy()`](../API/EntitySelectionClass.md#orderby)、コレクションと同じ並べ替えルールを適用します。 - **並べ替え付きのクエリ関数**: [`entitySelection.query()`](../API/EntitySelectionClass.md#query)、 [`dataClass.query()`](../API/DataClassClass.md#query) に対して `order by attributePath` キーワードを使用すると決定的な順序で結果を返します。 - **順序依存の統計関数**: [`collection.max()`](../API/CollectionClass.md#max)、 [`collection.min()`](../API/CollectionClass.md#min)、 [`entitySelection.max()`](../API/EntitySelectionClass.md#max)、 [`entitySelection.min()`](../API/EntitySelectionClass.md#min)、 これらは極値を識別するために順序関係に依存します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/parameters.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/parameters.md index f5a7b17e67088b..4fa0cc4a54af31 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/parameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/parameters.md @@ -19,7 +19,7 @@ ALERT("Hello") $area:=$o.getArea(50;100) ``` -また、プロジェクトメソッド `DO SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: +また、プロジェクトメソッド `DO_SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: ```4d DO_SOMETHING($WithThis;$AndThat;$ThisWay) @@ -35,7 +35,7 @@ EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/20!) // その際に引数として日付リテラル !05/05/20! を渡します ``` -メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* コードは以下のようになります: +メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* という変数に値を返します。コードは以下のようになります: ```4d MyLength:=Length("How did I get here?") @@ -226,7 +226,7 @@ Function returnHello Result:=MySum("000";1;2;200) // "203" ``` -0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: +0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: ```4d // foo メソッド @@ -480,16 +480,16 @@ ALERT([People]Name) ALERT($param) ``` -`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 +`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Name フィールドの値には影響しません。 もし `DO_SOMETHING` メソッド内でフィールドの値を変更したいのであれば、2通りのやり方があります: -1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。 この場合、以下のようにコードを書きます: +1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。この場合、以下のようにコードを書きます: ```4d // MY_METHOD メソッド DO_SOMETHING(->[People]Name) // [People]Name の値が "williams" だとします -ALERT([People]Last Name) +ALERT([People]Name) // DO_SOMETHING メソッド #DECLARE($param : Text) @@ -518,7 +518,7 @@ ALERT($param->) オブジェクトやコレクションのデータタイプは参照 (つまり、内部的な *ポインター*) を介した形でのみ扱われることに注意が必要です。 -したがって、`$param、$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 +したがって、`$param`、`$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 次の例では、`CreatePerson` メソッドはオブジェクトを作成したのち、それを引数として `ChangeAge` に渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/quick-tour.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/quick-tour.md index 1873d1227142a1..271130187a4c90 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/quick-tour.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/quick-tour.md @@ -31,7 +31,7 @@ $myHour:=?08:12:55? // 時間リテラルを代入します 代入演算 (:=) は必ず他の演算と区別しなければなりません。代入演算子は、被演算子を組み合わせて新しい一つのものにするのではなく、演算子の右側の式の値を左側の変数やフィールドにコピーします。 -**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 +**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 ## 変数 @@ -64,7 +64,7 @@ MyOtherDate:=Current date+30 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new") ``` -コレクションやオブジェクトにコマンドが属している場合、それらは名前付き関数であり、ドット記法を用いて使用します。例: +コレクションやオブジェクトにコマンドが属している場合、それらは関数と呼ばれ、ドット記法を用いて使用します。例: ```4d $c:=New collection(1;2;3;4;5) @@ -105,7 +105,7 @@ vRef:=Open document("PassFile";"TEXT";Read Mode) // ドキュメントを読み 4D が提供するたくさんのビルトインコマンドを使って、独自の **プロジェクトメソッド** を組み立てることができます。プロジェクトメソッドとはユーザー定義のメソッドで、コマンドや演算子などの要素から成り立ちます。プロジェクトメソッドは汎用性のあるメソッドですが、そうではない他の種類のメソッドも存在します: オブジェクトメソッド、フォームメソッド、テーブルメソッド (トリガー)、データベースメソッド。 -メソッドは、一つ以上のステートメントで構成されます。 ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 +メソッドは、一つ以上のステートメントで構成されます。ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 たとえば、次のステートメントは確認ダイアログボックスを表示します: @@ -144,7 +144,7 @@ $out:=Uppercase($in) データタイプのうち、文字タイプと数値タイプは、複数の類似するフィールドタイプに対応する点に注意してください。これらのフィールドにデータが格納されるとき、4D ランゲージはフィールドタイプに合致するデータタイプへとデータを自動的に変換します。反対に、たとえば整数フィールドのデータを呼び出すと、そのデータは自動的に数値タイプとして扱われます。つまり、4D ランゲージを使用する際に、類似するフィールドタイプを厳密に区別する必要はありません。 -しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。 しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 +しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 あるタイプとして格納したデータを、別のタイプとして使用する場合があります。 4D ランゲージには、データタイプを変換するためのコマンドが用意されています。たとえば、数値で始まり、"abc" 等の文字で終了する部品番号を作成する必要がある場合、以下のように記述することができます: @@ -258,7 +258,7 @@ This.name:="Square" 数値演算子は、使用可能な演算子のうちの 1種にすぎません。 4Dは、数値・テキスト・日付・ピクチャー等、異なるタイプのデータを扱うために、各データタイプで演算を実行するための演算子を備えています。 -対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。例えば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: +対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。たとえば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: | データタイプ | 演算 | 例題 | | ------ | --------------------------- | --------------------------------------------------------------------- | @@ -272,11 +272,11 @@ This.name:="Square" コマンド・演算子・変数・フィールド・オブジェクトプロパティ・コレクション要素等、複数のランゲージの要素を組み合わせて式は構成されます。式により、ステートメント (メソッドの 1文や 1行) を構成します。データが必要なとき、式が必要になります。 -式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります : +式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります。これには以下が含まれます: - フォーミュラエディター (フォーミュラによるクエリや並べ替えなど) - `EXECUTE FORMULA` コマンド -- フォームオブジェクトやウィジェットのデータソースとして +- プロパティリスト内で、フォームオブジェクトやウィジェットのデータソースとして - デバッガー内で式の値を確認することができます - クイックレポートエディターでカラムにフォーミュラを使用することができます @@ -284,30 +284,30 @@ This.name:="Square" 生成する値のタイプによって、式のタイプを定義することができます。式のタイプは複数あります。様々なタイプの式の例を以下に示します。 -| 式 | 型 | 説明 | -| ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | -| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | -| [People]Name + "様" | Text | 2つの文字列の結合です。 [People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | -| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | -| 4 | Number | これは数値定数 4です。 | -| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。 乗算演算子の (\*) を使用しています。数値の 8を返します。 | -| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | -| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | -| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | -| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | -| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | -| true | Boolean | このコマンドはブール値の true (真) を返します。 | -| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | -| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | -| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | -| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | -| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | -| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | -| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | -| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | -| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | -| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | +| 式 | 型 | 説明 | +| ------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | +| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | +| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | +| [People]Name + "様" | Text | 2つの文字列の結合です。[People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | +| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | +| 4 | Number | これは数値定数 4です。 | +| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。乗算演算子の (\*) を使用しています。数値の 8を返します。 | +| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | +| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | +| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | +| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | +| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | +| true | Boolean | このコマンドはブール値の true (真) を返します。 | +| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | +| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | +| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | +| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | +| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | +| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | +| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | +| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | +| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | +| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | ### 代入可能な式vs代入不可の式 {#assignable-vs-non-assignable-expressions} @@ -428,9 +428,10 @@ End for - 中カッコ `{ }` は、任意のパラメーターを示します。例えば、`.delete({ option : Integer })` は *option* 引数は関数を呼び出す際に省略可能であることを意味します。 - `any` キーワードは、あらゆる型(数値、テキスト、ブール、日付、時間、オブジェクト、コレクション、など) の値が可能な引数に対して使用されます。 -- これは *value* 引数は、テキスト型または実数型または日付型または時間型を受け付けるということを意味します。 +- パラメーターが複数の型を受け入れることができる場合、それらはカンマ区切りで列挙されます。例: `value : Text Real, Date, Time`。 + これは *value* が、テキスト型または実数型または日付型または時間型を受け付けるということを意味します。 - **可変長引数**: `...param : Type` という表記は、同じ型の引数を 0 から無制限に受け付けることを意味します。たとえば、`.concat( value : any { ;...valueN : any }) : Collection` という表記の場合、あらゆる型の引数を数に制限なく関数に渡すことができます。 -- **可変長のグループ引数**: `{; ...(param1 : Type ; param2 : Type)}` という表記は、グループの引数を1つから無制限に受け付けることを意味します。例えば、`COLLECTION TO ARRAY ( collection : Collection ; array : Array {; propertyName : Text}{; ...(array : Array ; propertyName : Text) })` という表記は、値またはテキスト型配列のペアを無制限にコマンドに渡すことができるということを意味します。 +- **可変長のグループ引数**: `{; ...(param1 : Type ; param2 : Type)}` という表記は、グループの引数を1つから無制限に受け付けることを意味します。たとえば、`COLLECTION TO ARRAY ( collection : Collection ; array : Array {; propertyName : Text}{; ...(array : Array ; propertyName : Text) })` という表記は、配列とテキストの組を無制限にコマンドに渡すことができるということを意味します。 ### 引数の型の説明 @@ -442,7 +443,7 @@ End for | any | サポートされるあらゆるデータ型を受け付ける引数 | JSON Stringify($value)
    $col.push(6;New object("firstname";"John")) | | 配列 | 同じ型の複数の値を格納する変数。 | ARRAY TEXT($arr;10) | | BLOB 配列 | BLOB 値を格納した配列。 | ARRAY BLOB($data;10) | -| BLOB | バイナリデータを保存するために使用される、バイナリーラージオブジェクト。 | BLOB TO DOCUMENT($blob;"file.bin") | +| BLOB | バイナリーデータを保存するために使用される、バイナリーラージオブジェクト。 | BLOB TO DOCUMENT($blob;"file.bin") | | Boolean | 論理値: True または False。 | If (OK=1) | | ブール配列 | ブール値を格納した配列。 | ARRAY BOOLEAN($flags;10) | | クラス名(例: 4D.File) | クラスインスタンスを作成または操作するために使用されるクラス型への参照。 | $file:=File("/RESOURCES/NovelCover1.jpg") | @@ -466,6 +467,6 @@ End for | テーブル | データベーステーブルへの参照。 | ALL RECORDS([Person]) | | Text | テキストデータを表現する一連の文字列。 | ALERT("Hello world") | | テキスト配列 | テキスト値を格納した配列。 | ARRAY TEXT($names;10) | -| Time | 時間、分、秒を表した時間値。 | 現在の時刻 | +| Time | 時間、分、秒を表した時間値。 | Current time | | 時間配列 | 時間値を格納した配列。 | ARRAY TIME($times;10) | | 変数 | 値を受け取り可能(代入可能)な、"任意"の型の書き込み可能な変数。 | SET PICTURE METADATA(vPicture;IPTC keywords;$arrTkeywords) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/shared.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/shared.md index c014e59e558b1f..a54bb6ee016a81 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/shared.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/shared.md @@ -82,7 +82,7 @@ End Use ### ストレージ -**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 +**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンプティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 `ストレージ` オブジェクトは標準の共有オブジェクトとは異なり、共有オブジェクト/コレクションがプロパティとして追加されたときでも共有グループを作成しないという点に注意してください。この例外的な振る舞いにより、**ストレージ** オブジェクトを使用するたびに、リンクされている共有オブジェクト/コレクションをすべてロックせずに済みます。 @@ -102,10 +102,10 @@ End Use 共有オブジェクトおよび共有コレクションは、プロセス間の (とくに \*[プリエンプティブプロセス](../Develop/preemptive.md)\*間の) 通信ができるように設計されています。これらはプロセスから他のプロセスへ、参照型の引数として渡すことができます。共有オブジェクトおよび共有コレクションを扱う際には、複数プロセスによる同時アクセスを避けるために、必ずそれらを `Use...End use` キーワードでくくる必要があります。 -- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のプすべてのロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 +- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のすべてのプロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 - *statement(s)* で実行されるステートメントは、Shared_object_or_Shared_collection のプロパティ/要素に対して、競合アクセスのリスクなしに変更も実行することができます。 - *Shared_object_or_Shared_collection* に他の共有オブジェクトあるいはコレクションがプロパティとして追加された場合、それらも同じ共有グループとして連結されます。 -- \*\*Use...End use \*\* 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 +- **Use...End use** 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 - **End use** は、*Shared_object_or_Shared_collection* プロパティおよび、同じグループのすべてのオブジェクトのロックを解除します。 - 4D コード内では、複数の **Use...End use** 構文を入れ子にすることができます。グループの場合、**Use** を使用するごとにグループのロックカウンターが 1 増加し、 **End use** ごとに 1 減少します。最後の **End use** によってロックカウンターが 0 になった場合にのみ、すべてのプロパティ/要素のロックが解除されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/variables.md index 017bca860210a3..b5c5643c78efdd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Concepts/variables.md @@ -59,23 +59,23 @@ var $myVar // バリアント型変数 サポートされている `varType` 値の一覧です: -| varType | 内容 | -| ---------------------------------------------- | -------------------------------- | -| `Text` | テキスト値 | -| `Date` | 日付値 | -| `Time` | 時間値 | -| `Boolean` | ブール値 | -| `Integer` | 倍長整数値 | -| `Real` | 実数値 | -| `Pointer` | ポインター値 | -| `Picture` | ピクチャー値 | -| `Blob` | スカラーBLOB値 | -| `Collection` | コレクション値 | -| `Variant` | バリアント値 | -| `Object` | デフォルトクラスのオブジェクト | -| `4D.` | 4Dクラス名のオブジェクト | -| `cs.` | ユーザークラス名のオブジェクト | -| `cs.`cs. | `` コンポーネントクラス名のオブジェクト | +| varType | 内容 | +| --------------------------- | -------------------------------- | +| `Text` | テキスト値 | +| `Date` | 日付値 | +| `Time` | 時間値 | +| `Boolean` | ブール値 | +| `Integer` | 倍長整数値 | +| `Real` | 実数値 | +| `Pointer` | ポインター値 | +| `Picture` | ピクチャー値 | +| `Blob` | スカラーBLOB値 | +| `Collection` | コレクション値 | +| `Variant` | バリアント値 | +| `Object` | デフォルトクラスのオブジェクト | +| `4D.` | 4Dクラス名のオブジェクト | +| `cs.` | ユーザークラス名のオブジェクト | +| `cs.` | `` コンポーネントクラス名のオブジェクト | :::note 互換性 @@ -184,7 +184,7 @@ MyNumber:=3 ## ローカル、プロセス、およびインタープロセス変数 -**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 +**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 ### ローカル変数 @@ -249,18 +249,18 @@ MyNumber:=3 システム変数は [4Dコマンド](../commands/command-index) によって使用されます。コマンドがシステム変数に影響を与えるかどうかを確認するには、コマンドの説明の "システム変数およびセット" の項目を参照ください。 -| システム変数名 | 型 | 説明 | -| ------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | -| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | -| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | -| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | -| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | -| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | -| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | -| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | +| システム変数名 | 型 | 説明 | +| ------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | +| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | +| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | +| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | +| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | +| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | +| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | +| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/building.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/building.md index 08259529bd014e..134d6ddad942d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/building.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/building.md @@ -674,7 +674,7 @@ userPrefs:=Get 4D folder(Active 4D Folder) #### データリンクモードの設定 -コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、 \*\*アプリケーション名 \*\* でリンクされます。 +コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、**アプリケーション名** でリンクされます。 異なるデータファイルを使用するために組み込みアプリを複製する場合には、この方法は適さないかもしれません。複製されたアプリは同じアプリケーションユーザー設定フォルダーを共有するため、同じデータファイルを使用することになります (最後に使用されたファイルが開かれるため、データファイル名を変更した場合でも結果は同じです)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/clientServer.md index c247114004304a..ffd5d4f327e2be 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/clientServer.md @@ -30,7 +30,7 @@ title: クライアント/サーバー管理 1. 次のいずれかの方法をおこないます: - Welcome ウィザードにて **4D Serverに接続** を選択します。 - - **ファイル** メニューより \*\*開く ＞ リモートプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **リモートプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 4D Server に接続するためのダイアログが表示されます。ダイアログには **最近使用**、**利用可**、および **カスタム** という、3つのタブがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/drag-and-drop.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/drag-and-drop.md index 301999fe23cbf6..25e56e6993e155 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/drag-and-drop.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/drag-and-drop.md @@ -5,7 +5,7 @@ title: ドラッグ&ドロップ ## 概要 -4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラック＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラック＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラック＆ドロップすることが出来ます。 +4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラッグ＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラッグ＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラッグ＆ドロップすることが出来ます。 またオブジェクトを4Dフォームと他のアプリケーション間でドラッグ＆ドロップできます。例えば PNGピクチャーを 4D のピクチャーフィールドにドラッグ＆ドロップできます。またワードプロセッサーアプリケーションでテキストを選択し、4D のテキスト変数やリストボックスなどにドロップできます。 @@ -42,7 +42,7 @@ title: ドラッグ&ドロップ :::note 注記 - デフォルトで、ピクチャーフィールドや変数の場合は、ピクチャーとその参照は両方ともドラッグされます。変数やフィールドの参照のみをドラッグしたい場合は、**Alt** ボタン(Windows) または **Option** ボタン(macOS) を押す必要があります。 -- 配列型リストボックスオブジェクトで“カスタム”のドラック可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 +- 配列型リストボックスオブジェクトで“カスタム”のドラッグ可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 - ドラッグとドロップの両方ができるオブジェクトは、開発者が禁止しない限り、自分自身にもドロップできます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/labels.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/labels.md index 83da396a907891..70073d18ad1a8d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/labels.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Desktop/labels.md @@ -55,7 +55,7 @@ title: ラベル ### ラベルプレビューエリア -このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ)) を指定できます)。 +このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ) で指定できます)。 - ラベルにはフィールドをドラッグすることができます。 - 一つ目のフィールドの上に他のフィールドをドロップする事で二つのフィールドを結合する事もできます。これらは自動的にスペースで区切られます。
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/onAfterEdit.md index 76ddea797f7bfe..ff8eaa6d2868fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/onAfterEdit.md @@ -62,11 +62,11 @@ title: On After Edit #### action = DragFillBlock -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | 自動入力のために使用されるレンジ | -| autoFillType | longint | 自動入力のために使用される値。
  • 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | -| fillDirection | longint | フィルの方向
  • フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | +| プロパティ | 型 | 説明 | +| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | 自動入力のために使用されるレンジ | +| autoFillType | longint | 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | +| fillDirection | longint | フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | #### action = formulaChanged diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/pictures.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/pictures.md index 0d21d56de45194..d7e13327bd0267 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/pictures.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/pictures.md @@ -57,10 +57,10 @@ title: ピクチャー 高解像度が自動的に優先されますが、スクリーンやピクチャーの dpi *(\*)*、およびピクチャー形式によって、動作に違いが生じることがあります: -| 演算 | 動作 | -| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
  • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
  • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    • | -| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | +| 演算 | 動作 | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    | +| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | *(\*) 通常は macOS = 72dpi, Windows = 96dpi* diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_Action.md index 6d9cbd7c33c021..e4a5e1851c7b3f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_Action.md @@ -5,7 +5,7 @@ title: 動作 ## メソッド -フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 +フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 メソッドが関連づけられているフォームに関わるイベントが発生した場合、4D は自動的にフォームメソッドを呼び出します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_FormProperties.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_FormProperties.md index 573e0869ca0eb3..df6571c758adc6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_FormProperties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormEditor/properties_FormProperties.md @@ -33,9 +33,9 @@ title: フォームプロパティ #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| --- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| css | string または collection | CSS file path(s) provided as:
  • a string (a file for both platforms)
  • a collection of strings (a list of files for both platform)
  • a collection of {"path":string;"media":"mac" | "windows"} objects
    • | +| 名称 | データタイプ | とりうる値 | +| --- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| css | string または collection | CSSファイルパス:
  • 文字列 (両方のプラットフォーム用に 1ファイル)
  • 文字列のコレクション (両プラットフォーム用のファイルのリスト)
  • {"path":string;"media":"mac" | "windows"} オブジェクトのコレクション
    • | --- diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/dropdownList_Overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/dropdownList_Overview.md index d2ce308c14c9e5..03c56440836808 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/dropdownList_Overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/dropdownList_Overview.md @@ -165,7 +165,7 @@ Form.myDrop.index //3 ## プロパティ一覧 -[Alpha Format](properties_Display.md#alpha-format) - [Bold](properties_Text.md#bold) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Data Type (expression type)](properties_DataSource.md#data-type-expression-type) - [Data Type (list)](properties_DataSource.md#data-type-list) - [Date Format](properties_Display.md#date-format) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Not rendered](properties_Display.md#not-rendered) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Standard action](properties_Action.md#standard-action) - [Save value](properties_Object.md#save-value) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [値を記憶](properties_Object.md#値を記憶) - [CSSクラス](properties_Object.md#cssクラス) - [データタイプ (セレクションおよびコレクションリストボックス列)](properties_DataSource.md#データタイプ-(リスト)) - [データタイプ](properties_DataSource.md#データタイプ-リスト) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [文字フォーマット](properties_Display.md#文字フォーマット) - [日付フォーマット](properties_Display.md#日付フォーマット) - [時間フォーマット](properties_Display.md#時間フォーマット) - [表示状態](properties_Display.md#表示状態) - [レンダリングしない](properties_Display.md#レンダリングしない) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [横揃え](properties_Text.md#横揃え) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox-object.md index 1203dc6f1f3213..77518af14c13a1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox-object.md @@ -27,7 +27,7 @@ LIST TO ARRAY("ListName";varCol) ## セレクションリストボックス -このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+“ ”[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 +このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+" "[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 それぞれの行はセレクションのレコードを基に評価されます。セレクションは **カレントセレクション** または **命名セレクション**です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox_overview.md index 32dd0774c33449..01f4e751dccf6f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/listbox_overview.md @@ -241,14 +241,14 @@ JSON フォームにおいて、リストボックスに次のハイライトセ 標準ソートのサポートは、リストボックスのタイプに依存します: -| リストボックスタイプ | 標準ソートのサポート | コメント | -| ------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | -| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | -| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。 この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照) | -| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | -| 命名セレクション | × | | -| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | +| リストボックスタイプ | 標準ソートのサポート | コメント | +| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | +| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | +| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    | +| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | +| 命名セレクション | × | | +| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | ### カスタムソート @@ -368,7 +368,7 @@ End if ### プレビューモード -プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。 とくに、表示されている以上の行を印刷することはできません。 +プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。とくに、表示されている以上の行を印刷することはできません。 ### 詳細モード diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Action.md index de6d70877b2e96..bfc0f24f59d090 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Action.md @@ -22,9 +22,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dragging | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dragging | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト @@ -54,9 +54,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dropping | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dropping | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Appearance.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Appearance.md index 515ad55da1c92f..6f8c7ddeb6968d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Appearance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Appearance.md @@ -31,9 +31,9 @@ Windows上では "推奨選択肢" の概念はサポートされていないた --- -## Display formula source as symbol +## フォーミュラのソースを記号として表示 -Displays source text of formulas as symbols when expressions are shown as references. +式が参照として表示される場合、フォーミュラのソーステキストを記号として表示します。 #### JSON 文法 @@ -155,7 +155,7 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show background and anchored elements +## 背景とアンカーされた要素を表示 ページの背景画像および背景色を表示/非表示にします。 @@ -175,9 +175,9 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show empty or unsupported images +## 空またはサポートされていない画像を表示 -Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). +読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示したり非表示にします。 #### JSON 文法 @@ -361,9 +361,9 @@ HTML WYSIWYG ビューを有効/無効にします。 このビューでは、 --- -## Show table borders +## 表組みの境界線を表示 -Displays internal and external table borders as dotted lines when these borders are partially or totally invisible. This facilitates page layout (more accessible, more visual resizing) and data entry (convenient in the case of merged cells, for example). +境界線が部分的または完全に非表示になっている場合には、表組の内部および外部の境界線を点線として表示します。これによりページレイアウト(よりアクセスしやすく、視覚的にリサイズしやすく)およびデータ入力(結合されたセルなどの場合に便利に)が容易になります。 ![](../assets/en/FormObjects/visible.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Object.md index 3369cec50c56b2..50fc0397990391 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Object.md @@ -139,9 +139,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | +| 名称 | データタイプ | とりうる値 | +| ---------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | ### 式 @@ -212,9 +212,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。 *配列/セレクションリストボックスのみ*: "integer", "object"
    • *配列/セレクションリストボックスのみ*: "integer", "object" | +| 名称 | データタイプ | とりうる値 | +| ------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。*配列/セレクションリストボックスのみ*: "integer", "object"
    • | #### 対象オブジェクト @@ -274,7 +274,7 @@ title: オブジェクト コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。 -コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、 [`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: +コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、[`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: - オブジェクトのコレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: `This.`。 - エンティティセレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: `This.`。 @@ -392,15 +392,15 @@ title: オブジェクト | 計算タイプ | Num | Text | Date | Time | Bool | Pict | フッター変数の型 | | ---------------------------------------- | --- | ---- | ---- | ---- | ---- | ---- | -------- | -| 最小 | X | X | X | X | X | | 列の型と同じ | -| 最大 | X | X | X | X | X | | 列の型と同じ | -| 合計 | X | | | X | X | | 列の型と同じ | -| カウント | X | X | X | X | X | X | Integer | -| 平均 | X | | | X | | | Real | -| 標準偏差(\*) | X | | | X | | | Real | -| 分散(\*) | X | | | X | | | Real | -| 平方和(\*) | X | | | X | | | Real | -| カスタム (JSON では "none") | X | X | X | X | X | X | 制限なし | +| 最小 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 最大 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 合計 | ○ | | | ○ | ○ | | 列の型と同じ | +| カウント | ○ | ○ | ○ | ○ | ○ | ○ | Integer | +| 平均 | ○ | | | ○ | | | Real | +| 標準偏差(\*) | ○ | | | ○ | | | Real | +| 分散(\*) | ○ | | | ○ | | | Real | +| 平方和(\*) | ○ | | | ○ | | | Real | +| カスタム (JSON では "none") | ○ | ○ | ○ | ○ | ○ | ○ | 制限なし | (\*) 配列型のリストボックスのみ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_RangeOfValues.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_RangeOfValues.md index 256743476e2ce4..0cfbfa209e4ae3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_RangeOfValues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_RangeOfValues.md @@ -17,22 +17,21 @@ title: 値の範囲 日付、時刻、シーケンス番号については、4D が提供する記号を使用することができます。日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: -| スタンプ | 意味 | -| ---- | ------- | -| #D | 本日の日付 | -| #H | 現在の時刻 | -| #N | シーケンス番号 | +| 記号 | 意味 | +| -- | ------- | +| #D | 本日の日付 | +| #H | 現在の時刻 | +| #N | シーケンス番号 | カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。詳細は [自動インクリメント](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.ja.html#976029) の段落を参照してください。 -> このプロパティと、リストボックス列に固定値を表示させるための -> "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 +> このプロパティと、リストボックス列に固定値を表示させるための "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | -| defaultValue | string | Any value and/or a stamp as a string: "#D", "#H", "#N", "42", "true"... | +| 名称 | データタイプ | とりうる値 | +| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------ | +| defaultValue | string | 任意の値や、特定の記号の文字列: "#D", "#H", "#N", "42", "true"... | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Text.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Text.md index e93a2ec956eae1..03e825d6f2d4d3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Text.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/properties_Text.md @@ -596,7 +596,7 @@ ST SET TEXT(txtVar;"This is a user link: ... ` - 取り消し線 `...` -*注意 : maOS では"取り消し線"がサポートされていません。指定しても表示されませんが、プログラムで管理することはできます。* +*注意 : macOS では"取り消し線"がサポートされていません。指定しても表示されませんが、プログラムで管理することはできます。* - フォントカラー: ` ... ` または `...` - 背景色: ` ... ` または `...` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/staticPicture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/staticPicture.md index b2c33d16e1918b..9de26e3aa09c5a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/staticPicture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/FormObjects/staticPicture.md @@ -9,7 +9,7 @@ title: スタティックピクチャー スタティックピクチャーはフォーム外に格納され、参照によって挿入されます。フォームエディターにおいては、コピーペーストやドラッグ ＆ ドロップ操作によってスタティックピクチャーオブジェクトが作成されます。 -> 複数ページあるフォームの 0ページにピクチャーを配置すると、そのピクチャーは自動ですべてのページに背景として表示されます。またピクチャーを継承フォームに置くこともでき、そのフォームを継承するすべてのフォームの背景とすることもできます。どちらの方法も、それぞれのページにピクチャーを配置するより、アプリケーションの動作が速くなります。またピクチャーを継承フォームに置くこともでき、そのフォームを継承するすべてのフォームの背景とすることもできます。どちらの方法も、それぞれのページにピクチャーを配置するより、アプリケーションの動作が速くなります。 +> 複数ページあるフォームの 0ページにピクチャーを配置すると、そのピクチャーは自動ですべてのページに背景として表示されます。またピクチャーを継承フォームに置くこともでき、そのフォームを継承するすべてのフォームの背景とすることもできます。どちらの方法も、それぞれのページにピクチャーを配置するより、アプリケーションの動作が速くなります。 ## 形式と保存場所 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/encrypt.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/encrypt.md index 4e35b338fa43cd..e013daddc5aa76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/encrypt.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/encrypt.md @@ -47,7 +47,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう 暗号化プロセスが正常に完了した場合、暗号化ページは 暗号化メンテナンスオペレーション ボタンを表示します。 -**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデーファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 +**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデータファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 ## 暗号化メンテナンスオペレーション @@ -86,7 +86,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ### パスフレーズを変更してデータを再暗号化する -この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスプレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 +この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスフレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 1. **パスフレーズを変更してデータを再暗号化する** をクリックします。 2. カレントのデータ暗号化キーを入力します。 @@ -110,7 +110,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ## 暗号化キーを保存する -4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。 なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 +4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 新しいパスフレーズが提供されるたびに暗号化キーを保存することができます: @@ -121,7 +121,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう :::caution -[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。 できない場合には、エラーが発生します。 +[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。できない場合には、エラーが発生します。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/overview.md index 000f1c827ccdce..bf793a36332bd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/MSC/overview.md @@ -14,7 +14,7 @@ MSCウィンドウを開く方法は幾つかあります。アクセスの方 メンテナンスモードでは、MSCウィンドウだけが表示されます (4Dアプリケーションはプロジェクトを開きません)。つまり、損傷が激しいため 4D が標準モードで開けないプロジェクトにもアクセスできるということです。さらに、特定の操作 (圧縮、修復など) はプロジェクトをメンテナンスモードで開くことを要求します ([アクセス権](#アクセス権) 参照)。 -次の 2つの場所から、MSC をメインテナンスモードで開くことができます: +次の 2つの場所から、MSC をメンテナンスモードで開くことができます: - **標準の開くダイアログボックス** 標準のプロジェクトを開くダイアログボックスには **開く** ボタンに関連付けられているメニューに **Maintenance & Security Center** オプションが含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Menus/sdi.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Menus/sdi.md index 587307a3951187..e91acd22715013 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Menus/sdi.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Menus/sdi.md @@ -17,7 +17,7 @@ SDIモードは以下の実行環境に限り利用可能です: - Windows - 組み込みの [スタンドアロン](../Desktop/building#スタンドアロンアプリケーションをビルド) または [クライアント](../Desktop/building#クライアントアプリケーションをビルド) 4Dアプリケーション -- **実行** メニューにて提供されている [\*\* アプリケーションをテスト\*\* 機能](bars.md#メニューバーのプレビュー) から利用可能です。 +- **実行** メニューにて提供されている [**アプリケーションをテスト** 機能](bars.md#メニューバーのプレビュー) から利用可能です。 ## SDIモードの有効化 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Notes/updates.md index 85900d17dfc769..d144beadda8735 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Notes/updates.md @@ -9,7 +9,7 @@ title: リリースノート #### ハイライト -- AI: macOS では、Apple Inteligence **Writing Tools** のおかげで、テキストを改善したり要約したりといったことができるようになりました。これは[4D Write Pro](../FormObjects/writeProArea_overview.md) および[入力](../FormObjects/input_overview.md) フォームオブジェクトにおいて、[プロパティ](../FormObjects/properties_Entry.md#writing-tools) および [標準アクション](../Desktop/standard-actions) として利用可能です。 +- AI: macOS では、Apple Intelligence **作文ツール** のおかげで、テキストを改善したり要約したりといったことができるようになりました。これは[4D Write Pro](../FormObjects/writeProArea_overview.md) および[入力](../FormObjects/input_overview.md) フォームオブジェクトにおいて、[プロパティ](../FormObjects/properties_Entry.md#writing-tools) および [標準アクション](../Desktop/standard-actions) として利用可能です。 - QUIC ネットワークレイヤーにおける、改善された[クライアント/サーバーの接続切断のサポート](../Desktop/clientServer.md#到達不能なピアの管理): 新しい [`QUIC session timeout`](../commands/set-database-parameter#quick-session-timeout-135) データベースパラメーター、新しい [`unreachableSince` session.info](../API/SessionClass.md#info) プロパティ。 - マルチレベルスタイルシートが、[4D Write Pro インターフェースでサポートされる](../WritePro/writeprointerface#multi-level-list-style-sheets) ようになり、これによりユーザーはツールバーとサイドバーから構造化されたマルチレベルリストを直接作成・管理できるようになりました。 - 新しい[`defer`](../commands/defer) コマンドが追加され、これによってメソッドまたは関数の終了時に必ず実行される同じコードを宣言することができるようになりました。また新しい[`Deferred formulas`](../commands/deferred-formulas) コマンドを使用することで、遅延されたフォーミュラの一覧を取得することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/dsMapping.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/dsMapping.md index 75e19a8fc8dc6e..6af90001d97296 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/dsMapping.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/dsMapping.md @@ -161,7 +161,7 @@ OB GET PROPERTY NAMES(ds.Employee;$prop) これに加えて、以下のリレーション属性もまた自動的に利用可能になります: -- Project データクラス内: "リレートエンティティ" 型の **theClient** 属性。各 Project (クライアント) に対して最大 1つの Companyが あります。 +- Project データクラス内: "リレートエンティティ" 型の **theClient** 属性。各 Project (クライアント) に対して最大 1つの Company があります。 - Company データクラス内: "リレートエンティティズ" 型の**companyProjects** 属性。各 Company に対して不定数の Project があります。 > データベースリレーションの手動あるいは自動プロパティは、ORDA においては何の効力も持ちません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/glossary.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/glossary.md index 5bd6df1059360b..d552d0e730e6fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/glossary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/glossary.md @@ -127,7 +127,7 @@ $myClass.query("name = smith") ## ミックスデータ型 -このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : +このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。これには以下が含まれます: - number - text @@ -211,9 +211,9 @@ ORDA オブジェクトとは関わりのないユーザークラス。 シャロウコピーは、要素の構造のみを複製し、同じ内部参照を保持します。シャロウコピーのあと、二つのコレクションに格納された個々の要素は同じものが共有されています。ディープコピー も合わせて参照してください。 -## スタンプ +## 記号 -"オプティミステック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 +"オプティミスティック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 ## ストレージ属性 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/privileges.md index 202ebf24877e1f..152a9ae07d86a3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/privileges.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ORDA/privileges.md @@ -58,7 +58,7 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ - エイリアス属性の元である属性に対するアクセス権をセッションが持っていない場合でも、[エイリアス属性](./ordaClasses.md#エイリアス属性-1) へのアクセス権があれば、これを読み取ることができます。 - 計算属性を構成する属性に対するアクセス権をセッションが持っていない場合でも、[計算属性](./ordaClasses.md#計算属性-1) へのアクセス権があれば、これを読み取ることができます。 -- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型）に適用されます。 +- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型) に適用されます。 - [`promote()`](../API/SessionClass.md#promote) および [`demote()`](../API/SessionClass.md#demote) 関数を使用することで、Web プロセスに対して動的に **promote** アクションを設定/削除することができます。 - デフォルト値: 現在の実装では、*Null* のみデフォルト値として利用可能です。 - REST の [強制ログインモード](../REST/authUsers.md#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/compiler.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/compiler.md index 23c3b7bb26768c..d410fa8ac62455 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/compiler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/compiler.md @@ -97,7 +97,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy #### エラーファイルを生成 -シンタックスチェック時にエラーファイルを生成するのに使用します ([エラーファイル](#エラーファイル) 参照)。エラーファイルは、プロジェクトの [Logs フォルダー](../Project/architecture.md#logs) 内に `ProjectName_error.xml` という名前で作成されます。 +シンタックスチェック時にエラーファイルを生成するのに使用します ([エラーファイル](#エラーファイル) 参照)。エラーファイルは、プロジェクトの [Logs フォルダー](../Project/architecture.md#logs) 内に `ProjectName_errors.xml` という名前で作成されます。 #### コンパイル対象CPU @@ -266,7 +266,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.xml` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/components.md index 6d7b48666aa28e..bf8cccb3b258d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/components.md @@ -22,7 +22,7 @@ title: 依存関係 - **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。[プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 - **コンパイル版コンポーネント**の場合: - - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー推奨されるアーキテクチャー) + - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー (推奨されるアーキテクチャー) - *Resources* などの他のフォルダーを格納している.4DZ ファイル。 :::note @@ -90,7 +90,7 @@ title: 依存関係 **優先度高** 1. [プロジェクトの **Components** フォルダー](architecture.md#components) に置かれているコンポーネント -2. dependencies.json\*\*ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 +2. **dependencies.json**ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 3. 内部のユーザー4Dコンポーネント (4D NetKit、4D SVG など) **優先度低** @@ -505,7 +505,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ [GitHub または GitLab 依存関係](#components-stored-on-git-hosting-platforms) を追加する場合: -1. パネルのフッターエリア内の\*\*[+]\*\* をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 +1. パネルのフッターエリア内の **[+]** をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 ![dependency-add-git](../assets/en/Project/dependency-add-git.png) @@ -584,7 +584,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ これに加えて、単一の依存関係あるいは全ての依存関係に対して、いつでも更新をチェックすることができます: -- 単一の依存関係に対して更新をチェクするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 +- 単一の依存関係に対して更新をチェックするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 ![check component](../assets/en/Project/check-component-one.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/search-replace.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/search-replace.md index 1728caa7b0f0b6..54687e450c1200 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/search-replace.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Project/search-replace.md @@ -5,14 +5,14 @@ title: 検索と置換 4D はデザイン環境の全ての要素に対して複数の検索と置換機能を提供しています。 -- 文字列またはオブジェクトのタイプ(変数、コメント、式、など)に対して検索を行うことができます。またカスタム条件("前方一致"、"含む"など)に基づいてプロジェクトの一部または全体に対して検索を行えます。文字列またはオブジェクトのタイプ(変数、コメント、式、など)に対して検索を行うことができます。またカスタム条件("前方一致"、"含む"など)に基づいてプロジェクトの一部または全体に対して検索を行えます。例えば、"MyVar" という文字列を格納している変数を、名前が"HR_" で始まるメソッド内2位おいてのみ検索する、といったことを行うことができます。 +- 文字列またはオブジェクトのタイプ(変数、コメント、式、など)に対して検索を行うことができます。またカスタム条件("前方一致"、"含む"など)に基づいてプロジェクトの一部または全体に対して検索を行えます。例えば、"MyVar" という文字列を格納している変数を、名前が"HR_" で始まるメソッド内2位おいてのみ検索する、といったことを行うことができます。 - 検索した結果は結果ウィンドウ内に表示表示され、ここからコンテンツの置換を行うことができます。この結果をテキストファイルとして書き出して、それをスプレッドシートなどに読み込ませることもできます。 - コード内で使用されていない変数やメソッドを検知し、それらを削除することでメモリを解放することもできます。 - 一回の操作で、デザイン環境内のプロジェクトメソッドや変数を名称変更することができます。 :::note -またエクスプローラーのメソッドページのコンテキストメニューには、プロジェクトのメソッド内を検索するための機能もあります: **呼び出し元を検索** ([メソッドエディター](../code-editor/write-class-method.md#search-callers) からも利用可能です) および **依存関係を検索** です。どちらの機能も、[結果ウィンドウ](#結果ウィンドウ) 内に見つかった項目を表示します。どちらの機能も、[結果ウィンドウ](#結果ウィンドウ) 内に見つかった項目を表示します。 +またエクスプローラーのメソッドページのコンテキストメニューには、プロジェクトのメソッド内を検索するための機能もあります: **呼び出し元を検索** ([メソッドエディター](../code-editor/write-class-method.md#search-callers) からも利用可能です) および **依存関係を検索** です。どちらの機能も、[結果ウィンドウ](#結果ウィンドウ) 内に見つかった項目を表示します。 ::: @@ -41,23 +41,21 @@ title: 検索と置換 "デザインモードを検索"ウィンドウ内で検索条件を指定します: 1. 4D ツールバー内の検索ボタン (![](../assets/en/Project/search-icon.png)) をクリックします。または - **編集** メニュー内から **デザインモードを検索...** コマンドを選択します。または **編集** メニュー内から **デザインモードを検索...** コマンドを選択します。 "デザインモードを検索" ウィンドウが表示されます: ![](../assets/en/Project/find-in-design.png) -メニューの選択に応じて、"デザインモードを検索"のエリアは動的に変化します。ウィンドウを展開することで、全てのオプションを表示することもできます: ウィンドウを展開することで、全てのオプションを表示することもできます: +メニューの選択に応じて、"デザインモードを検索"のエリアは動的に変化します。ウィンドウを展開することで、全てのオプションを表示することもできます: ![](../assets/en/Project/find-in-design-expanded.png) -2. 異なるメニューやダイアログボックスの入力エリアを使用して検索をビルドすることができ、また必要であれば検索したい文字列を入力します。これらの項目については、以下のセクションで説明されています。これらの項目については、以下のセクションで説明されています。 +2. 異なるメニューやダイアログボックスの入力エリアを使用して検索をビルドすることができ、また必要であれば検索したい文字列を入力します。これらの項目については、以下のセクションで説明されています。 3. [検索オプション](#検索オプション) を設定します(必要であれば)。 -4. **OK** をクリックするか、または**Enter** キーを押してください。 - **OK** をクリックするか、または**Enter** キーを押してください。検索が完了すると、 [結果ウィンドウ](#結果ウィンドウ) が表示され、そこに検索で見つかった要素が一覧表示されます。 +4. **OK** をクリックするか、または**Enter** キーを押してください。検索が完了すると、 [結果ウィンドウ](#結果ウィンドウ) が表示され、そこに検索で見つかった要素が一覧表示されます。 :::note @@ -65,14 +63,14 @@ title: 検索と置換 ::: -検索を一度実行したら、検索エリアに入力された値はメモリに保存されます。この値と、同じセッション中に入力された他の値は、コンボボックスから選択することができます。この値と、同じセッション中に入力された他の値は、コンボボックスから選択することができます。 +検索を一度実行したら、検索エリアに入力された値はメモリに保存されます。この値と、同じセッション中に入力された他の値は、コンボボックスから選択することができます。 ### 検索 -**検索**メニューを使用して検索したい要素のタイプを指定します。以下の選択肢から選択することが可能です: 以下の選択肢から選択することが可能です: +**検索**メニューを使用して検索したい要素のタイプを指定します。以下の選択肢から選択することが可能です: -- **テキスト**: この場合、4D はデザイン環境内においてその文字列を検索します。この検索はプレーンテキストモードで行われ、コンテキストは考慮されません。例えば、"ALERT("Error number:"+" or "button27" というテキストを検索したとします。このモードでは、ワイルドカード文字として "@" を使用することはできません。この場合は標準の文字として認識されるからです。この検索はプレーンテキストモードで行われ、コンテキストは考慮されません。例えば、"ALERT("Error number:"+" or "button27" というテキストを検索したとします。このモードでは、ワイルドカード文字として "@" を使用することはできません。この場合は標準の文字として認識されるからです。 -- **コメント**: この検索は基本的に前のものと同じですが、コード(// で始まる行)内の中身とエクスプローラーウィンドウ内のみを検索します。例えば、 "To be verified" という文字列を格納する任意のコメントを検索することができます。例えば、 "To be verified" という文字列を格納する任意のコメントを検索することができます。 +- **テキスト**: この場合、4D はデザイン環境内においてその文字列を検索します。この検索はプレーンテキストモードで行われ、コンテキストは考慮されません。例えば、"ALERT("Error number:"+" or "button27" というテキストを検索したとします。このモードでは、ワイルドカード文字として "@" を使用することはできません。この場合は標準の文字として認識されるからです。 +- **コメント**: この検索は基本的に前のものと同じですが、コード(// で始まる行)内の中身とエクスプローラーウィンドウ内のみを検索します。例えば、 "To be verified" という文字列を格納する任意のコメントを検索することができます。 :::note @@ -86,29 +84,29 @@ title: 検索と置換 - **ランゲージ要素**: 特定のランゲージ要素をその名前で検索するのに使用されます。 4D は以下のような要素を識別することができます: - **すべてのランゲージ要素**: 以下のリスト内の全ての要素。 - **プロジェクトメソッドまたはクラス**: プロジェクトメソッド名またはクラス名、例えば "M_Add" あるいは "EmployeeEntity" など。 - - **フォーム:** フォーム名。例 "Input"。このコマンドはプロジェクトフォームおよびテーブルフォームを検索します。このコマンドはプロジェクトフォームおよびテーブルフォームを検索します。 + - **フォーム:** フォーム名。例 "Input"。このコマンドはプロジェクトフォームおよびテーブルフォームを検索します。 - **フィールまたはテーブル**: テーブル名またはフィールド名。例 "Customers"。 - **変数**: 任意の変数名。例 "$myvar"。 **4D 定数**: 任意の定数。例 "Is Picture"。**引用符内の文字列**: リテラルなテキストのコンテンツ。例: コードエディター内、またはフォームエディターのテキストエリアに挿入された引用符内の任意の値。例えば、 "Martin" を検索すると、コード内に以下のような行があった場合には検索結果を返します: `ds.Customer.query("name = :1"; "Martin")` - **4D コマンド**: 任意の4D コマンド。例 "Alert"。 - **プラグインコマンド**: アプリケーションにインストールされたプラグインコマンド。 - - **プロパティ**: オブジェクトのプロパティ名(ORDA 属性名も含みます)。**プロパティ**: オブジェクトのプロパティ名(ORDA 属性名も含みます)。例えば "lastname" を検索した場合、"$o.lastname" および "ds.Employee.lastname" が返されます。 -- **あらゆるオブジェクト**: このオプションを使用するとデザイン環境内にあるあらゆる要素内を検索します。ここでは更新日フィルターしか使用できません。このオプションを使用することで、例えば "今日変更されたもの"というような検索を実行できます。ここでは更新日フィルターしか使用できません。このオプションを使用することで、例えば "今日変更されたもの"というような検索を実行できます。 + - **プロパティ**: オブジェクトのプロパティ名(ORDA 属性名も含みます)。例えば "lastname" を検索した場合、"$o.lastname" および "ds.Employee.lastname" が返されます。 +- **あらゆるオブジェクト**: このオプションを使用するとデザイン環境内にあるあらゆる要素内を検索します。ここでは更新日フィルターしか使用できません。このオプションを使用することで、例えば "今日変更されたもの"というような検索を実行できます。 ### 検索モード -検索モードメニュー(例えば"完全一致"や"名前"など)は入力された値をどのように検索するかを指定します。このメニューの中身は、 **タイプ** ドロップダウンリスト内で選択された要素のタイプに応じて変化します。このメニューの中身は、 **タイプ** ドロップダウンリスト内で選択された要素のタイプに応じて変化します。 +検索モードメニュー(例えば"完全一致"や"名前"など)は入力された値をどのように検索するかを指定します。このメニューの中身は、 **タイプ** ドロップダウンリスト内で選択された要素のタイプに応じて変化します。 - テキストまたはコメントの検索オプション: - - **含む**: 指定された文字列をデザイン環境内の全てのテキスト内を検索します。 "var" の検索結果としては、 "myvar"、 "variable1" あるいは "aVariable" などが含まれます。 "var" の検索結果としては、 "myvar"、 "variable1" あるいは "aVariable" などが含まれます。 + - **含む**: 指定された文字列をデザイン環境内の全てのテキスト内を検索します。 "var" の検索結果としては、 "myvar"、 "variable1" あるいは "aVariable" などが含まれます。 - **語全体を含む**: 文字列を完全な単語としてデザイン環境内の全てのテキスト内を検索します。 "var" を検索した場合には、それと完全に一致した場合のみが結果として返されます。この結果には "myvar" は含まれませんが、例えば "var:=10" や "ID+var" などは検索結果に含まれます。 何故なら `:` や `+` などの記号は単語の区切り文字だからです。 - - **前方一致 / 後方一致**: 文字列を単語の最初か最後に一致するか(テキスト検索)、あるいはコメント行の最初か最後に一致するか(コメント検索)を検索します。"後方一致" モードにおいては、 "var" を検索した場合 "myvar" が検索結果に含まれます。"後方一致" モードにおいては、 "var" を検索した場合 "myvar" が検索結果に含まれます。 + - **前方一致 / 後方一致**: 文字列を単語の最初か最後に一致するか(テキスト検索)、あるいはコメント行の最初か最後に一致するか(コメント検索)を検索します。"後方一致" モードにおいては、 "var" を検索した場合 "myvar" が検索結果に含まれます。 - ランゲージ要素に対しての検索オプション: メニューは標準のオプション(等しい、含む、前方一致、後方一致)を提供します。"等しい"検索オプションにおいては検索ワイルドカード (@) を使用できることに注意してください(指定されたタイプの全てのオブジェクトを返します)。 ### コンポーネント内を検索 -カレントのプロジェクトが [編集可能なコンポーネント](../Extensions/develop-components.md#editing-components) を参照している場合、コンポーネントの一つまたは全てを検索対象として含めることができます。 デフォルトでは、ホストに対してのみ検索が実行されます。 検索対象を変更するためには、**プロジェクト内** メニューを展開します: デフォルトでは、ホストに対してのみ検索が実行されます。検索対象を変更するためには、**プロジェクト内** メニューを展開します: +カレントのプロジェクトが [編集可能なコンポーネント](../Extensions/develop-components.md#editing-components) を参照している場合、コンポーネントの一つまたは全てを検索対象として含めることができます。デフォルトでは、ホストに対してのみ検索が実行されます。検索対象を変更するためには、**プロジェクト内** メニューを展開します: ![](../assets/en/Project/find-components.png) @@ -124,11 +122,11 @@ title: 検索と置換 ::: -**フォルダー** メニュー(以下参照) はプロジェクト選択した時に更新されます。どのフォルダーが利用できるかは選択された検索対象によって変わるからです。このメニューは "ホストプロジェクトとその全てのコンポーネント" オプションを選択している時には非表示になっています。このメニューは "ホストプロジェクトとその全てのコンポーネント" オプションを選択している時には非表示になっています。 +**フォルダー** メニュー(以下参照) はプロジェクト選択した時に更新されます。どのフォルダーが利用できるかは選択された検索対象によって変わるからです。このメニューは "ホストプロジェクトとその全てのコンポーネント" オプションを選択している時には非表示になっています。 ### Folder -**フォルダー** メニューは検索をプロジェクトの特定のフォルダーへと制限します。デフォルト("トップレベル"オプション)では、全てのフォルダー内で検索を実行します。デフォルト("トップレベル"オプション)では、全てのフォルダー内で検索を実行します。 +**フォルダー** メニューは検索をプロジェクトの特定のフォルダーへと制限します。デフォルト("トップレベル"オプション)では、全てのフォルダー内で検索を実行します。 :::note @@ -138,7 +136,7 @@ title: 検索と置換 ### 親オブジェクトの変更日 -このメニューは親の作成日/変更日に従って検索(例えば、文字列を含んでいるメソッドの検索など)を制限します。標準の日付条件(等しい、より以前、より以降、等しくない)に加えて、このメニューは標準の検索期間をより素早く指定するための複数のオプションを格納しています: 標準の日付条件(等しい、より以前、より以降、等しくない)に加えて、このメニューは標準の検索期間をより素早く指定するための複数のオプションを格納しています: +このメニューは親の作成日/変更日に従って検索(例えば、文字列を含んでいるメソッドの検索など)を制限します。標準の日付条件(等しい、より以前、より以降、等しくない)に加えて、このメニューは標準の検索期間をより素早く指定するための複数のオプションを格納しています: - **本日**: 現在の日付の真夜中(00:00 時)から始まる期間。 - **昨日以降**: 現在の日付と昨日の日付を含めた期間。 @@ -167,7 +165,7 @@ title: 検索と置換 ![](../assets/en/Project/result-window.png) -このウィンドウの行をダブルクリックすることでその要素を [メソッドエディター(コードエディター)](../code-editor/write-class-method.md) などのエディター内で閲覧することができます。複数の検索を実行した場合、それぞれの検索の結果ウィンドウが表示され、以前のウィンドウが開いたままで閉じられることはありません。複数の検索を実行した場合、それぞれの検索の結果ウィンドウが表示され、以前のウィンドウが開いたままで閉じられることはありません。 +このウィンドウの行をダブルクリックすることでその要素を [メソッドエディター(コードエディター)](../code-editor/write-class-method.md) などのエディター内で閲覧することができます。複数の検索を実行した場合、それぞれの検索の結果ウィンドウが表示され、以前のウィンドウが開いたままで閉じられることはありません。 一つ以上の結果が見つかった場合、リストには要素名のとなりに **個数** が表示されます。 @@ -185,12 +183,12 @@ title: 検索と置換 ![](../assets/en/Project/result-window-menu.png) -- **リストから削除**: 選択された要素を結果ウィンドウから削除します。具体的には、結果のリスト内に置換操作を行いたい要素だけを残すことや、アプリケーション間でドラッグ&ドロップを使用したい要素だけを残すことなどができます。具体的には、結果のリスト内に置換操作を行いたい要素だけを残すことや、アプリケーション間でドラッグ&ドロップを使用したい要素だけを残すことなどができます。 +- **リストから削除**: 選択された要素を結果ウィンドウから削除します。具体的には、結果のリスト内に置換操作を行いたい要素だけを残すことや、アプリケーション間でドラッグ&ドロップを使用したい要素だけを残すことなどができます。 - **選択された項目以外を全てリストから削除**: 選択された項目を除いて全てを結果ウィンドウをから消去します。 - [**内容を置換**](#replace-in-content): 選択された項目の文字列を置き換えます。 -- **選択 >**: 結果ウィンドウ内の全ての項目から、一つのタイプ(プロジェクトメソッド、オブジェクト名、など)だけを選択します。階層サブメニューには全ての項目を一度に選択する(すべて)か選択解除する(なし)かを実行するコマンドを提供しています。階層サブメニューには全ての項目を一度に選択する(すべて)か選択解除する(なし)かを実行するコマンドを提供しています。 +- **選択 >**: 結果ウィンドウ内の全ての項目から、一つのタイプ(プロジェクトメソッド、オブジェクト名、など)だけを選択します。階層サブメニューには全ての項目を一度に選択する(すべて)か選択解除する(なし)かを実行するコマンドを提供しています。 - **全てを折りたたむ/全てを展開する**: 結果の一覧内の全ての階層項目を展開するか折りたたみます。 -- **結果を書き出し**: 検索条件と結果ウィンドウに表示されている要素についての情報を書き出します。このテキストファイルは例えばExcel などのスプレッドシートに読み込ませることができます。各項目に対して、以下の情報がタブ区切りの値としてテキストファイル内に書き出されます: このテキストファイルは例えばExcel などのスプレッドシートに読み込ませることができます。各項目に対して、以下の情報がタブ区切りの値としてテキストファイル内に書き出されます: +- **結果を書き出し**: 検索条件と結果ウィンドウに表示されている要素についての情報を書き出します。このテキストファイルは例えばExcel などのスプレッドシートに読み込ませることができます。各項目に対して、以下の情報がタブ区切りの値としてテキストファイル内に書き出されます: - ホストプロジェクトまたはコンポーネント名 - タイプ (メソッド、クラス、フォームオブジェクト、トリガー、など) - パス @@ -200,7 +198,7 @@ title: 検索と置換 ## 内容を置換 {#replace-in-content} -内容を置換機能を使用すると、結果ウィンドウにリストされたオブジェクト内の文字列を他の文字列で置き換えることができます。これはウィンドウの [オプションメニュー](#オプションメニュー) 内にて利用可能です。これはウィンドウの [オプションメニュー](#オプションメニュー) 内にて利用可能です。 +内容を置換機能を使用すると、結果ウィンドウにリストされたオブジェクト内の文字列を他の文字列で置き換えることができます。これはウィンドウの [オプションメニュー](#オプションメニュー) 内にて利用可能です。 :::note @@ -214,13 +212,13 @@ title: 検索と置換 置換オペレーションは以下のルールに基づいて実行されます: -- 置換はリスト内にある全ての項目に対して実行され、選択されている要素だけに止まりません。置換はリスト内にある全ての項目に対して実行され、選択されている要素だけに止まりません。しかしながら、 [オプションメニュー](#オプションメニュー) またはコンテキストメニュー内の **リストから削除** あるいは **選択された項目以外を全てリストから削除** を使用してリストの内容を最初に絞り込みすることで、置換オペレーションの対象を狭めることができます。 +- 置換はリスト内にある全ての項目に対して実行され、選択されている要素だけに止まりません。しかしながら、 [オプションメニュー](#オプションメニュー) またはコンテキストメニュー内の **リストから削除** あるいは **選択された項目以外を全てリストから削除** を使用してリストの内容を最初に絞り込みすることで、置換オペレーションの対象を狭めることができます。 - 結果ウィンドウにコンポーネント内の要素が含まれていた場合、置換はコンポーネント内に対しても行われます。 - リストに表示されている発生箇所のみが置換され、かつ置換操作の前に、最初の検索条件に基づいて、最初の検索と置換操作の間にオブジェクトが変更されたケースを確認した後でのみ置換されます。 - 置換はコード、フォームオブジェクトのプロパティ、ヘルプメッセージの内容、入力フィルター、メニュー項目(項目のテキストとメソッド呼び出し)、選択リスト、コメント内で実行されます。 -- それぞれのオブジェクトが編集されると、4D は他のマシンあるいは他のウィンドウにおいてすでにロードされているかどうかをチェックします。コンフリクトがあった場合、オブジェクトがロックされていることを示す標準のダイアログボックスが表示されます。オブジェクトを閉じてから再試行するか、置換をキャンセルすることができます。置換操作はリスト内の他のオブジェクトに対して続行されます。コンフリクトがあった場合、オブジェクトがロックされていることを示す標準のダイアログボックスが表示されます。オブジェクトを閉じてから再試行するか、置換をキャンセルすることができます。置換操作はリスト内の他のオブジェクトに対して続行されます。 -- もし"内容を置換"操作の対象となっているメソッドまたはフォームが同じ4D アプリケーション内で現在編集中の場合、対象はその開かれているエディター内で直接編集されます(警告は表示されません)。この方法で編集されたフォームおよびメソッドは自動的には保存されません: 変更を保存するためには **保存** あるいは **すべてを保存** コマンドを明示的に使用する必要があります。この方法で編集されたフォームおよびメソッドは自動的には保存されません: 変更を保存するためには **保存** あるいは **すべてを保存** コマンドを明示的に使用する必要があります。 -- リストの項目に対して置換が行われたあとは、それらは斜字体で表示されます。ウィンドウの下部には行われた置換の回数がリアルタイムで表示されます。ウィンドウの下部には行われた置換の回数がリアルタイムで表示されます。 +- それぞれのオブジェクトが編集されると、4D は他のマシンあるいは他のウィンドウにおいてすでにロードされているかどうかをチェックします。コンフリクトがあった場合、オブジェクトがロックされていることを示す標準のダイアログボックスが表示されます。オブジェクトを閉じてから再試行するか、置換をキャンセルすることができます。置換操作はリスト内の他のオブジェクトに対して続行されます。 +- もし"内容を置換"操作の対象となっているメソッドまたはフォームが同じ4D アプリケーション内で現在編集中の場合、対象はその開かれているエディター内で直接編集されます(警告は表示されません)。この方法で編集されたフォームおよびメソッドは自動的には保存されません: 変更を保存するためには **保存** あるいは **すべてを保存** コマンドを明示的に使用する必要があります。 +- リストの項目に対して置換が行われたあとは、それらは斜字体で表示されます。ウィンドウの下部には行われた置換の回数がリアルタイムで表示されます。 - フォームオブジェクトを除き、見つかった要素自体の名前が **内容を置換** 機能で名称変更されることはありません。そのため、リスト内の特定の一部の項目が置換オペレーションの影響を受けないことが有り得ます。これは項目の名前のみが最初の検索条件に合致した場合などに起こり得ます。この場合、リスト内の項目が必ずしも全て斜字体で表示されるわけではなく、また最終的な置換カウントが最初の検索で見つかったオカレンス数より少なくなることも有り得ます。 ## プロジェクトメソッドと変数の名称変更 {#renaming-project-methods-and-variables} @@ -235,12 +233,12 @@ title: 検索と置換 ![](../assets/en/Project/rename-dial.png) -新しい名前は [命名規則](../Concepts/identifiers.md)に従っている必要があります。そうでない場合、ダイアログボックスを決定した際に警告が表示されます。例えば、メソッド名を "Alert" などのコマンド名に変更することはできません。例えば、メソッド名を "Alert" などのコマンド名に変更することはできません。 +新しい名前は [命名規則](../Concepts/identifiers.md)に従っている必要があります。そうでない場合、ダイアログボックスを決定した際に警告が表示されます。例えば、メソッド名を "Alert" などのコマンド名に変更することはできません。 名称変更しようとしているオブジェクトのタイプ(プロジェクトメソッドまたは変数)によっては、名称変更ダイアログボックスに追加のオプションが表示される場合があります: -- プロジェクトメソッド: **すべての参照箇所でメソッド名を変更** オプションを使用すると、それを参照しているプロジェクト内の全てのコードにおいてメソッド名を変更します。このオプションを選択解除することで、例えばエクスプローラー内においてのみメソッド名を変更することができます。このオプションを選択解除することで、例えばエクスプローラー内においてのみメソッド名を変更することができます。 -- プロセス変数: **すべての参照箇所で変数名を変更** オプションを使用すると、それを参照しているプロジェクト内のすべてのコードにおいて変数名を変更します。このオプションを選択解除することで、カレントのメソッドの内の変数のみが名称変更されます。このオプションを選択解除することで、カレントのメソッドの内の変数のみが名称変更されます。 +- プロジェクトメソッド: **すべての参照箇所でメソッド名を変更** オプションを使用すると、それを参照しているプロジェクト内の全てのコードにおいてメソッド名を変更します。このオプションを選択解除することで、例えばエクスプローラー内においてのみメソッド名を変更することができます。 +- プロセス変数: **すべての参照箇所で変数名を変更** オプションを使用すると、それを参照しているプロジェクト内のすべてのコードにおいて変数名を変更します。このオプションを選択解除することで、カレントのメソッドの内の変数のみが名称変更されます。 - ローカル変数: これに対しては追加のオプションはありません。変数はカレントのメソッドまたはクラスにおいてのみ名称変更されます。 ## 未使用の要素の検索 @@ -249,7 +247,7 @@ title: 検索と置換 ### 未使用のメソッドとグローバル変数を検索 -このコマンドは、宣言されているものの使用されていないプロジェクトメソッドと、"グローバル"変数(プロセス変数とインタープロセス変数) を探します。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。 +このコマンドは、宣言されているものの使用されていないプロジェクトメソッドと、"グローバル"変数(プロセス変数とインタープロセス変数) を探します。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。 プロジェクトメソッドは、以下のようの場合に未使用であると判断されます: @@ -264,18 +262,18 @@ title: 検索と置換 - 4D コード内でどこでも使用されていない - どのフォームオブジェクトでも使用されていない -ただしこの機能では特定の用法は検知できないことに注意してください。つまり、未使用と判断された要素が使用されていることが有り得るということです。これは以下のようなコードの場合に当てはまります: これは以下のようなコードの場合に当てはまります: +ただしこの機能では特定の用法は検知できないことに注意してください。つまり、未使用と判断された要素が使用されていることが有り得るということです。これは以下のようなコードの場合に当てはまります: ```4d var v : Text :="method" EXECUTE FORMULA("my"+v+String(42)) ``` -このコードはメソッド名をビルドします。このコードはメソッド名をビルドします。 *mymethod42* プロジェクトメソッドは実際には呼び出されていますが、ここでは未使用であると判断されてしまいます。そのため、未使用であると宣言された要素が実際に不要であるかどうかを、削除する前に確認することが望ましいといえます。そのため、未使用であると宣言された要素が実際に不要であるかどうかを、削除する前に確認することが望ましいといえます。 +このコードはメソッド名をビルドします。 *mymethod42* プロジェクトメソッドは実際には呼び出されていますが、ここでは未使用であると判断されてしまいます。そのため、未使用であると宣言された要素が実際に不要であるかどうかを、削除する前に確認することが望ましいといえます。 ### 未使用のローカル変数を検索 -このコマンドは宣言されているものの使用されていないローカル変数を探します。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。 +このコマンドは宣言されているものの使用されていないローカル変数を探します。検索結果は標準の [結果ウィンドウ](#結果ウィンドウ) に表示されます。 ローカル変数は、以下のような場合に未使用であると判断されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$entityset.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$entityset.md index 191d18512b9287..633d4704c073ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$entityset.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$entityset.md @@ -93,7 +93,7 @@ title: $entityset ## $entityset/$release -[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します). +[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します。 ### 説明 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$filter.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$filter.md index c9e152f4e7e709..d1faeac4f05451 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$filter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/$filter.md @@ -23,7 +23,7 @@ title: $filter **\{attribute\} {comparator} {value} {AND/OR/EXCEPT} \{attribute\} {comparator} {value}** -たとえば: `$filter="firstName=john AND salary>20000"` （`firstName` および `salary` は Employee データクラスの属性です)。 +たとえば: `$filter="firstName=john AND salary>20000"` (`firstName` および `salary` は Employee データクラスの属性です)。 ### paramsプロパティの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/ClassFunctions.md index 6a84eede161efe..657a3c0f726e83 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/ClassFunctions.md @@ -10,8 +10,7 @@ REST リクエストを使って、ORDA データモデルに定義されてい - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 -POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、 -よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 +POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 ## 関数の呼び出し diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/configuration.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/configuration.md index 5665216ee1b06e..0bba35e45972d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/configuration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/REST/configuration.md @@ -72,7 +72,7 @@ REST 経由でアクセス可能なデータストアオブジェクトを制限 2. フィールドの **RESTリソースとして公開** オプションの選択を解除します。
    ![alt-text](../assets/en/REST/field.png)
    - Repeat this for each field whose exposure needs to be modified. + 公開設定を変更する各フィールドに対して、この手順を繰り返します。 > あるフィールドが REST を通してアクセス可能であるためには、その親テーブルも公開されている必要があります。親テーブルが公開されていない場合、各フィールドの公開設定に関わらず、すべてのフィールドがアクセス不可になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ServerWindow/real-time-monitor.md index 85bd17028b0890..00f65b61dd81e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ServerWindow/real-time-monitor.md @@ -9,7 +9,7 @@ title: リアルタイムモニターページ > このページは、サーバーマシンの管理ウィンドウにありますが、リモートの 4Dマシンからも見られます。リモートマシンの場合は、サーバーマシン上で実行されている操作のデータを表示します。 -データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます。 +データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます)。 各行について、以下の情報が表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Tags/transformation-tags.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Tags/transformation-tags.md index dc98e8c94fccd7..dcd9855d063c4d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Tags/transformation-tags.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Tags/transformation-tags.md @@ -45,7 +45,7 @@ title: 変換タグ ### 再起的処理 -4Dタグは繰り返し解釈されます。 4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: +4Dタグは繰り返し解釈されます。4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: ```html @@ -61,7 +61,7 @@ title: 変換タグ ### "." を小数点として使用 -4D は常にピリオド文字 (.) `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 +4D は常にピリオド文字 (.) を小数点として使用して、 `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 ## 4DBASE @@ -631,7 +631,7 @@ return String(Current date) #### 代替シンタックス: `$4DTEXT(expression)` -タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: +タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: ```html

    へようこそ！

    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/classes.md index a8fa417ac13cf7..45c42624fbbc85 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/classes.md @@ -213,7 +213,7 @@ title: クラス **.borderHorizontal** : [cs.ViewPro.LineBorder](#lineborder) -`.borderBottom` プロパティは、 表の横の外枠線を定義します 。 +`.borderHorizontal` プロパティは、 表の横の外枠線を定義します 。 ### .borderVertical diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/commands/vp-set-allowed-methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/commands/vp-set-allowed-methods.md index b3f7839d769622..c4402d1853e2f4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/commands/vp-set-allowed-methods.md @@ -26,7 +26,7 @@ title: VP SET ALLOWED METHODS `VP SET ALLOWED METHODS` コマンドは、4D View Pro フォーミュラから呼び出し可能なプロジェクトメソッドを指定します。このコマンドは、呼び出し後のセッション中に初期化される 4D View Pro エリアすべてに対して適用されます。同じセッション中において異なる設定で初期化をするために、複数回呼び出すこともできます。 -セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照)。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 +セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照))。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 *methodObj* には、4D View Pro エリア内で定義したいファンクションの名前をプロパティとして格納しているオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/configuring.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/configuring.md index 06097e8c84dc57..2fd697a282b332 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/configuring.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/configuring.md @@ -141,7 +141,7 @@ title: 4D View Pro エリアの設定 | 0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 | | 。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 | | , | 数値内に千区切りのカンマを表示します。数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 | -| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | +| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( や _) のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | | @ | テキストのフォーマット文字。セル内のすべてのテキストにフォーマットを適用します。 | "\[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 | | \* | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0\*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、\*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 | | " " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 | @@ -165,17 +165,17 @@ VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_ 4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています: -| 定数 | 値 | 説明 | -| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | -| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | -| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | -| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。 アメリカ合衆国でのデフォルトパターン: "MMMM dd" | -| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。 アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | -| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm" | -| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | -| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | -| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。 アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | +| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | +| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | +| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" | +| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | +| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" | +| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | +| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | +| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | #### 例題 @@ -339,9 +339,9 @@ VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time"; | firstPageNumber | longint | 最初のページに印刷するページ番号。 デフォルト値 = 1 | | pageOrder | longint | ページの印刷順。とりうる値: `vk print page order auto` (デフォルト), `vk print page order down then over`, `vk print page order over then down`. | | pageRange | text | 印刷されるページの範囲 | -| qualityFactor | longint | 印刷の品質指定 (1 - 8)。印刷の品質指定 (1 - 8)。 高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    デフォルト値 = 2

    | -| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    デフォルト値 = true

    | -| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    デフォルト値 = 1

    | +| qualityFactor | longint | 印刷の品質指定 (1 - 8)。高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    | +| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    | +| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    | ### 用紙サイズ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/formulas.md index c116d1342e49e5..07d3871922968b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/formulas.md @@ -217,7 +217,7 @@ $o.DRIVERS_LICENCE.parameters.push(New object("name"; "ID"; "type"; Is longint)) サポートされている引数の型の詳細については、[VP SET CUSTOM FUNCTIONS](commands/vp-set-custom-functions) コマンドの説明を参照ください。 -引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、 それらの型は自動的に変換されます。 +引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、それらの型は自動的に変換されます。 日付およびオブジェクト引数は次のように扱われます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/getting-started.md index c8a25208010148..3af63f8bcebdd4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/ViewPro/getting-started.md @@ -8,7 +8,7 @@ title: はじめに ![](../assets/en/ViewPro/vpSpreadsheet.png) スプレッドシートとは、セルのグリッドを格納したアプリケーションのことで、これらのセルに情報を入力したり、計算を実行させたり、あるいはピクチャーを表示したりすることができます。 4D View Proは、4Dに統合された [SpreadJS スプレッドシートソリューション](https://developer.mescius.com/spreadjs) に基づいて動作します。
    -(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します） +(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します) :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/httpRequests.md index 85b2cec25b2465..e9df1e44ef2ee1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/httpRequests.md @@ -85,7 +85,7 @@ title: HTTPリクエストの処理 $BrowserIP 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 ### $ServerIP - サーバーIP アドレス @@ -99,8 +99,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ ## /4DACTION -\*\*/4DACTION/\*\**MethodName*
    -\*\*/4DACTION/\*\**MethodName/Param* +**/4DACTION/***MethodName*
    +**/4DACTION/***MethodName/Param* | 引数 | 型 | | 説明 | | ---------- | ---- | :-: | --------------------- | @@ -111,8 +111,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。メソッドはこの引数を受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 -- `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。属性がチェックされていない場合、Webリクエストは拒否されます。 +- `/4DACTION/MethodName/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -120,7 +120,7 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND TEXT` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インターフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 @@ -150,7 +150,7 @@ WEB SEND BLOB($BLOB;"image/png") ### 4DACTION を使用してフォームをポスト -4D Webサーバーでは、ポストされたフォームを使用することもできます。 これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 +4D Webサーバーでは、ポストされたフォームを使用することもできます。これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 フォームは 2つのメソッドを使用してサブミットできます (4D では両方のタイプを使用できます): diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/sessions.md index f45fb1de24ae42..994dc802e2efe1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/sessions.md @@ -3,7 +3,7 @@ id: sessions title: Webセッション --- -4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 +4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 Webセッションでは、以下のことが可能です: @@ -28,8 +28,7 @@ Webセッションでは、以下のことが可能です: Webセッションは次のものに使用されます: -- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する - [Web アプリケーション](gettingStarted.md) +- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する [Web アプリケーション](gettingStarted.md) - [リモートデータストア](../ORDA/remoteDatastores.md) や [Qodly ページ](https://developer.4d.com/qodly/) が使用する [REST API](../REST/authUsers.md) への呼び出し。 ## Webセッションの有効化 {#enabling-web-sessions} @@ -38,13 +37,13 @@ Webセッションは次のものに使用されます: - ストラクチャー設定の Web / オプション (I) ページの **スケーラブルセッション** を使用する (永続的な設定): ![alt-text](../assets/en/WebServer/settingsSession.png) -このオプションは、新規プロジェクトではデフォルトで選択されています。これは、 **セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 +このオプションは、新規プロジェクトではデフォルトで選択されています。これは、**セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 -- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します）。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 +- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します)。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 > メインの Webサーバーのセッションモードは、[`WEB SET OPTION`](../commands/web-set-option) コマンドを使って設定することもできます。 -いずれの場合も、設定はマシンに対しローカルなものです。 つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 +いずれの場合も、設定はマシンに対しローカルなものです。つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 > **互換性について**: 4D v18 R6 以前の 4Dバージョンで作成されたプロジェクトでは、**旧式セッション** オプションが使用できます (詳細については、[doc.4d.com](https://doc.4d.com) の Webサイトを参照ください)。 @@ -58,13 +57,13 @@ Webセッションは次のものに使用されます: ::: -1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID__AppName_" cookie の存在と値をチェックします。 +1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID_*AppName*" cookie の存在と値をチェックします。 2. cookie に値がある場合、4D は既存セッションの中からこのクッキーを作成したセッションを探し、見つかった場合には再利用します。 3. クライアントからのリクエストが、すでに開かれているセッションに対応していない場合: -- プライベートな "4DSID__AppName_" cookie を持つ新しいセッションが Webサーバー上に作成されます。 +- プライベートな "4DSID_*AppName*" cookie を持つ新しいセッションが Webサーバー上に作成されます。 - 新しいゲスト `Session` オブジェクトが作成され、このスケーラブルWebセッション専用に使用されます。 :::note @@ -488,7 +487,7 @@ Function validateEmail() : 4D.OutgoingMessage セッショントークンにはライフスパン(有効期限)があり、またセッション自身にもライフスパンがあります。セッショントークンのライフスパンは、[トークン作成時](../API/SessionClass.md#createotp) に設定することが可能です。デフォルトで、トークンのライフスパンは[`.idleTimeout`](../API/SessionClass.md#idletimeout) の値と同じ値となっています。 -セッショントークンのライフパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 +セッショントークンのライフスパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/templates.md index a330c809b15b83..1e9e4d1273f352 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/templates.md @@ -69,14 +69,14 @@ title: テンプレートページ 内部的には、パーサーは UTF-16 文字列で動作しますが、解析するデータは異なる方法でエンコードされている場合があります。タグにテキストが含まれている場合 (`4DHTML` など)、提供されている情報 (charset) や出所に応じて、4D は必要に応じてデータを変換します。以下に、HTMLページに含まれるタグを 4D が解析する場合と、おこなわれる変換を示します: -| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | -| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND TEXT` | X | - | 変換は不要です。 | -| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | +| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | +| ---------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND TEXT` | X | - | 変換は不要です。 | +| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | (\*) 4DHTML、4DTEXT、4DEVALタグにおいては、代替の $ベースシンタックスが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/webServerConfig.md index ead05535cfbb3c..1ecd21cb2aa8cb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WebServer/webServerConfig.md @@ -64,7 +64,7 @@ Webサーバー用の TLS証明書ファイルが置かれているフォルダ | ---------------- | -------------------------------------------------- | ---- | | webServer オブジェクト | [`cipherSuite`](API/WebServerClass.md#ciphersuite) | Text | -セキュアプロトコルに使用される暗号リストです。 Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 +セキュアプロトコルに使用される暗号リストです。Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 > 4D が使用するデフォルトの暗号リストは、`SET DATABASE PARAMETER` コマンドを使用してセッションごとに変更することができます。この場合、変更は 4Dアプリケーション全体に適用されます (Webサーバー・SQLサーバー・クライアント/サーバー接続、HTTPクライアント、セキュアプロトコルを使用するすべての 4Dコマンドを含む)。 @@ -161,7 +161,7 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" | `WEB SET OPTION` | `Web CORS enabled` | 0 (デフォルト値; 無効) または 1 (有効) | | 設定ダイアログボックス | [オプション (II) ページ / CORSを有効化](../settings/web.md#corsを有効化) | デフォルトではチェックなし | -4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 +4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。後述の CORSSettings 参照)。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 無効化されている場合 (デフォルト) には、CORS で送信されたサイト間リクエストはすべて無視されます。 @@ -255,7 +255,7 @@ HTTP接続を受け付ける IP (TCP) ポート番号。デフォルトで、4D デフォルトでない HTTPポート番号を使用して公開された Webアプリケーションに接続するには、Webブラウザーで入力するアドレスにポート番号を含めなければなりません。アドレスの後にコロンに続けてポート番号を指定します。たとえば、HTTPポート番号 8080を使用する場合、"123.4.567.89:8080" のように書きます。 -> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。 また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 +> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 0 を指定すると、4D はデフォルトの HTTPポート番号 80を使用します。 @@ -320,7 +320,7 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。デフォル - **TCPポートが使用済みでも警告は出ません**
    サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 -定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 +定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - **IPv4-マップされた IPv6アドレス**
    プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 @@ -456,9 +456,9 @@ Webサーバーの PFS利用可否状況 ([TLS](Admin/tls.md#perfect-forward-sec ## 一時的なコンテキストを再利用する (リモートモード) -| 設定できる場所 | 名称 | コメント | -| ----------- | --------------------------------------------------------------------------------------------------------------------- | ---- | -| 設定ダイアログボックス | [[オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | +| 設定できる場所 | 名称 | コメント | +| ----------- | ------------------------------------------------------------------------------------------ | ---- | +| 設定ダイアログボックス | [オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | > このオプションは、**セッションなし** オプションがチェックされている場合にのみ利用できます。 @@ -524,9 +524,9 @@ User-Agent: デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 -- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアパッケージを含むフォルダーです (4Dリモートモード)。 - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 -- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。置きます。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WritePro/managing-formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WritePro/managing-formulas.md index ce1649c081b77c..7cd11889334857 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WritePro/managing-formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/WritePro/managing-formulas.md @@ -6,7 +6,7 @@ slug: /WritePro/formulas ## 概要 -4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは4D コマンドなどの4D フォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 +4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは 4Dコマンドなどの 4Dフォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 4D Write Pro エリアへのフォーミュラの挿入には [**WP Insert formula**](commands/wp-insert-formula.md) コマンドを使用し、フォーミュラの読み出しには[**WP Get formulas**](commands-legacy/wp-get-formulas.md) コマンドを使用します。また、[**WP Get text**](commands-legacy/wp-get-text.md) コマンドを使用することでも返されます。 @@ -191,7 +191,7 @@ slug: /WritePro/formulas ### 参照を名前で表示 -フォーミュラには名前を割り当てることができ、これによって4D Write Proテンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 +フォーミュラには名前を割り当てることができ、これによって4D Write Pro テンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 例えば、以下のフォーミュラ参照はデフォルトではソーステキストとして表示されます: @@ -201,7 +201,7 @@ slug: /WritePro/formulas ![](../assets/en/WritePro/wp-formulas6.png) -フォーミュラに名前を割り当てるためには、 [WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: +フォーミュラに名前を割り当てるためには、[WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: ```4d // ドキュメント内に昨日の日付を挿入する diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/aikit/Classes/OpenAIChatAPI.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/aikit/Classes/OpenAIChatAPI.md index afb23bcb930605..5a30faa1791b01 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/aikit/Classes/OpenAIChatAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/aikit/Classes/OpenAIChatAPI.md @@ -22,7 +22,7 @@ title: OpenAIChatAPI | 引数 | 型 | 説明 | | -------------- | --------------------------------------- | ------------------------- | -| *systemPrompt* | Text | チャットを初期化するシステムプロント。 | +| *systemPrompt* | Text | チャットを初期化するシステムプロンプト。 | | 戻り値 | [OpenAIChatHelper](OpenAIChatHelper.md) | チャットのやり取りを管理するヘルパーインスタンス。 | #### 使用例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/code-editor/write-class-method.md index 25007e709f11ec..1153833edfbac3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/code-editor/write-class-method.md @@ -29,16 +29,16 @@ title: コードエディター | -------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **メソッド実行** | ![execute-method](../assets/en/code-editor/execute-method.png) | コードエディターウィンドウには、そのエディターで開かれているメソッドを実行するためのボタンがあります。このボタンに割り当てられているメニューを使用して、実行タイプを選択できます:
    • **新規プロセスで実行**: プロセスを作成し、そのプロセス内でメソッドを実行します。
    • **新規プロセスで実行＆デバッグ**: プロセスを作成し、デバッガーを開いてメソッドを表示します。
    • **アプリケーションプロセスで実行**: アプリケーションプロセス内でメソッドを実行します。
    • **アプリケーションプロセスで実行＆デバッグ**: アプリケーションプロセス内でデバッガーを開き、メソッドを表示します。
    メソッド実行についての詳細な情報については、[プロジェクトメソッド](../Project/project-method-properties.md) を参照してください。 | | **メソッド中を検索** | ![search-icon](../assets/en/code-editor/search.png) | [*検索* エリア](#検索と置換) を表示します。 | -| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についの詳細は、 [マクロ](#マクロ) を参照ください。 | +| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についての詳細は、[マクロ](#マクロ) を参照ください。 | | **すべて折りたたむ / すべて展開** | ![expand-collapse-button](../assets/en/code-editor/expand-collapse-all.png) | これらのボタンを使用してコードの制御フロー構造を折りたたんだり展開したりできます。 | -| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します(プロジェクトモードのみ)。 | +| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します (プロジェクトメソッドのみ)。 | | **最新のクリップボードの値** | ![last-clipboard-values-icon](../assets/en/code-editor/last-clipboard-values.png) | 直近でクリップボードに保存された値を表示します。 | -| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、 [これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | +| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、[これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | | **ナビゲーションドロップダウン** | ![code-navigation-icons](../assets/en/code-editor/tags.png) | 自動的にタグ付けされたコンテンツや手動で宣言されたマーカーを使用して、メソッドやクラス内を移動できます。後述参照。 | ### 編集エリア -このエリアを使用してコードを 入力/編集 します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 +このエリアを使用してコードを入力/編集します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 この編集エリアの表示はカスタマイズできます。カスタマイズした内容は、すべてのコードエディターに反映されます: @@ -74,10 +74,10 @@ title: コードエディター ![](../assets/en/code-editor/list-area.png) -- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示\非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 +- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示/非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 - すべてのウィンドウでリストを非表示にするには、次の方法があります: - - メソッド メニューの **表示** ＞ **リスト** オプションの選択を解除する + - **メソッド**メニューの **表示** ＞ **リスト** オプションの選択を解除する - **環境設定** の **メソッド** ページで **オプション** ＞ **リスト表示** の選択を解除する。**環境設定** ダイアログボックスでおこなった変更は、開かれているメソッドやクラス、関数を一度閉じて再度開いたときに反映されます。 #### リストのタイプ @@ -141,9 +141,9 @@ title: コードエディター - **行**: 行番号 - **階層**: 階層番号 (プログラム構造の階層レベル)。先頭のレベルは 0 です。この数値は、コード中でエラーが発生した際にインタープリターから提供されるのでデバッグ時に利用できます。 - **文字**: 行内の文字位置。 -- ![](../assets/en/code-editor/show-hide-list.png): Hide/display lists. +- ![](../assets/en/code-editor/show-hide-list.png): リストの表示/非表示。 -4Dコマンド、関数や変数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: +4Dコマンド、関数や引数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: ![](../assets/en/code-editor/status-bar-bold.png) ### ナビゲーションドロップダウン @@ -208,7 +208,7 @@ title: コードエディター メソッドやクラスのタグをアルファベット順に表示するには、次のいずれかを実行します: - ドロップダウンツールを **右クリックする** -- macOS では **option**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 +- macOS では **Cmd**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 > 関数内のタグは、親項目と一緒に移動します。 @@ -224,7 +224,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | **ショートカット** | **アクション** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| **選択およびナビゲージョン** | | +| **選択およびナビゲーション** | | | ダブルクリック | ランゲージ要素名を選択します。 | | [Alt]+ダブルクリック | スペースを含むランゲージ要素名 (定数、メソッドなど) を選択します。 | | [Shift]+[右矢印] | 選択範囲を作成し、一文字ずつ右に拡大します。 または、選択範囲を一文字ずつ左から縮小します。 | @@ -247,7 +247,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | [PgDn] | メソッドをページ単位で下にスクロールします (挿入カーソル位置は変更されません)。 | | [**イントロスペクション**](#定義を開く) | | | [Ctrl]+K または [Alt]+ダブルクリック | [**定義を開く**](#定義を開く) コマンドと同じ。 | -| トークン上で \[Ctrl\] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | +| トークン上で [Ctrl] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | | [**検索と置換**](#検索と置換) | | | [Ctrl]+F | 検索 | | [Ctrl]+G | 次を検索 | @@ -356,7 +356,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method > **環境設定** の **メソッド** ページで、**() と閉じる } ) ] " を自動で挿入** オプションをチェックしている場合、4D はひとつ以上の必須の引数を持つ4D コマンド、キーワード、プロジェクトメソッドの後ろに (提案、あるいは補完を受け入れたあとに) 自動的に **()** を追加します: > ![](../assets/en/code-editor/insert-and-closing-1.png) -> ![](../assets/en/code-editor/insert-and-closing-2.png) -例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: +自動補完機能は、コード構造 (例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: ![](../assets/en/code-editor/autocomplete-code-structures.png) 複数の候補がある場合、**Tab** キーを押すと 4D はそのポップアップリストを表示します: @@ -367,7 +367,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method デフォルトでは、値を選択したあとに区切り文字 `( ; : = < [ {` を入力すると、自動で値の候補も (区切り文字の前に) 挿入されます。 値のあとには区切り文字がつき、データの入力の準備ができた状態になります。 -![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** key --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) +![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** キー --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) > この区切り文字を使った候補の自動入力は、**環境設定** の **メソッド** ＞ **オプション** で無効にできます。 @@ -446,7 +446,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ### 置換 -*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ \*\* 置換...\*\* を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 +*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ **置換...** を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 *置換* エリアには、上の検索エリアの文字を置換する文字列を入力します。 @@ -524,11 +524,9 @@ Windows では、日本語や中国語を入力するために IME (Input Method - **4D コマンドドキュメンテーション**: 4D のコマンドや関数にマウスを重ねると、コマンドシンタックスと簡単な説明がヘルプTip に表示されます。 ![](../assets/en/code-editor/status-bar-description.png) - ![](../assets/en/code-editor/status-bar-description.png) - **変数型と詳細**: 変数にマウスを重ねると、その変数の型と (メソッド内で明示的に宣言されている場合)、付随したコメントが (あれば) ヘルプTip に表示されます。 ![](../assets/en/code-editor/variable-type.png) - ![](../assets/en/code-editor/variable-type.png) - **プロジェクトメソッドまたは関数**: プロジェクトメソッドまたはクラス関数にマウスを重ねると、以下の内容がヘルプTip に表示されます: @@ -550,7 +548,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ![](../assets/en/code-editor/comment-uncomment-1.png) --> ![](../assets/en/code-editor/comment-uncomment-2.png) -選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。 この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 +選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 > **コメント/アンコメント** コマンドは行全体に適用されます。行の一部のみをコメント化することはできません。 @@ -650,7 +648,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ::: -**定義を開く.....** コマンドの効果は、ターゲット要素によって異なります: +**定義を開く...** コマンドの効果は、ターゲット要素によって異なります: - プロジェクトメソッドの場合、コードエディターの新しいウィンドウ内にメソッドのコンテンツが表示されます。 - クラス名またはクラス関数の場合、コードエディター内にクラスが表示されます。 @@ -682,7 +680,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ## 名称変更 -グローバル名称変更機能は、**変数** と **プロジェクトメソッド** に対して使用でき、これによってプロジェクト全体において安全に名称を変更することができます。これをするためには、エディター内において変数またはプロジェクトメソッド名をハイライトし、コンテキストメニューの**メソッド** メニューから**名称変更...** を選択します。すると新しい名前を入力するためのダイアログボックスが表示されます。より詳細な情報については、[プロジェクトメソッドと変数の名称変更](../Project/search-replace.md#プロジェクトメソッドと変数の名称変更) の章を参照してください。 +グローバル名称変更機能は、**変数** と **プロジェクトメソッド** に対して使用でき、これによってプロジェクト全体において安全に名称を変更することができます。これをするためには、エディター内において変数またはプロジェクトメソッド名をハイライトし、**メソッド**メニューまたはコンテキストメニューから**名称変更...** を選択します。すると新しい名前を入力するためのダイアログボックスが表示されます。より詳細な情報については、[プロジェクトメソッドと変数の名称変更](../Project/search-replace.md#プロジェクトメソッドと変数の名称変更) の章を参照してください。 ## マクロ @@ -702,7 +700,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method - マシンのアクティブ4Dフォルダー。この場合、マクロはすべてのデータベースで共有されます。**注:** アクティブ4Dフォルダーの位置は OS により異なります。詳細については、*4Dランゲージリファレンス* マニュアルの [Get 4D folder](../commands/get-4d-folder) コマンドの説明を参照ください。 - データベースストラクチャーファイルと同階層。マクロは、このストラクチャーにのみ読み込まれます。 -- コンポーネントの場合: データベースの **Components** フォルダーと同階層。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 +- コンポーネントの場合: データベースの **Components** フォルダーの中。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 これら 3つの場所は同時に利用可能です。 各場所に "Macros v2" フォルダーをインストールできます。マクロは以下の順番でロードされます: 4Dフォルダー、ストラクチャーファイル、コンポーネント1 ... コンポーネントX。 @@ -834,7 +832,7 @@ XML仕様に準拠し、いくつかのタグは属性を含むことがあり マクロのサポートは 4Dのバージョンごとに変わることがあります。カスタマイズされたマクロを管理しつつ、異なるバージョンの互換性を保持するために、4Dは以前のバージョンのマクロを取り除くことはしません。最新機能を使用したい場合は、適切にバージョンを調整する必要があります。 -#### method の選択テキスト変数 +#### メソッドのテキスト選択変数 テキスト選択は、[GET MACRO PARAMETER](../commands/get-macro-parameter) および [SET MACRO PARAMETER](../commands/set-macro-parameter) コマンドを使用して管理することが推奨されています。これらのコマンドを使用すると、ホストプロジェクトとコンポーネント間でテキストを相互に交換することができ、マクロの管理専用のコンポーネントを作成することができます。マクロでこのモードを有効にするには、macro 要素内で version 属性に値 2 を指定しなければなりません。この場合、4D は旧式の _textSel, _textReplace 等の定義済み変数を管理しなくなり、[GET MACRO PARAMETER](../commands/get-macro-parameter) と [SET MACRO PARAMETER](../commands/set-macro-parameter) が使用されます。属性は以下のように定義します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/ai.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/ai.md index 87bef924be3328..67e8f3d64ebdf4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/ai.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/ai.md @@ -59,7 +59,7 @@ AI プロバイダーを追加するには: ### APIキー -(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報をが必要になる場合もあります。 +(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報が必要になる場合もあります。 ### 組織 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/interface.md index d6c4ba18023c01..0a03a6c9f7dd3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/settings/interface.md @@ -66,7 +66,7 @@ title: インターフェースページ ### Windows 上でFluent UI を使用 -このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトでWindows クラシクUI レンダリングテーマが使用されます。 +このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトで Windows クラシック UI レンダリングテーマが使用されます。 > このオプションはWindows でのみ使用され、macOS では何の効果もありません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CollectionClass.md index 0f0beb31d4fb8c..d45fdec7eabbfd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CollectionClass.md @@ -376,7 +376,7 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] #### 例題 1 -通常の (非共有の) コレクション *$lastnames \* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames\*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -398,7 +398,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と\*$sharedColl2\* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と *$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CryptoKeyClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CryptoKeyClass.md index d5859d3dc07c05..6b1f8c8b06437c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CryptoKeyClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/CryptoKeyClass.md @@ -187,7 +187,7 @@ ECDSA キーのみ: キーの楕円曲線 #### *実行結果* -`message` の復号に成功した場合には、success プロパティが `true` に設定された *status* オブジェクトを返します。 +*message* の復号に成功した場合には、`success` プロパティが `true` に設定された `status` オブジェクトを返します。 | プロパティ | 型 | 説明 | | ------- | ---------- | --------------------------------------------------------------- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md index e10458ee1adbee..82e969df01b16f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataClassClass.md @@ -3,7 +3,7 @@ id: DataClassClass title: DataClass --- -[データクラス](ORDA/dsMapping.md#データクラス) はデータベーステーブルへのオブジェクトインターフェースを提供します。 4Dアプリケーション内のデータクラスはすべて、`ds` [データストア](ORDA/dsMapping.md#データストア) のプロパティとして利用可能です。 +[データクラス](ORDA/dsMapping.md#データクラス) はデータベーステーブルへのオブジェクトインターフェースを提供します。 4Dアプリケーション内のデータクラスはすべて、`ds` [データストア](ORDA/dsMapping.md#データストア) のプロパティとして利用可能です。 ### 概要 @@ -51,24 +51,24 @@ title: DataClass 返される属性オブジェクトには以下のプロパティが格納されています: -| プロパティ | 型 | 説明 | -| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| autoFilled | Boolean | 属性値が 4D によって自動生成される場合に true です。このプロパティは次の 4Dフィールドプロパティに対応しています: 数値型フィールドの "自動インクリメント" および UUID (文字型)フィールドの "自動UUID"。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| exposed | Boolean | 属性が REST で公開されている場合に trueです | -| fieldNumber | integer | 属性の内部的な 4Dフィールド番号。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| fieldType | Integer | 属性の 4Dデータベースフィールドタイプ。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合は、対応する 4Dフィールドタイプ ([`Value type`](../commands/value-type) 参照)
  • `.kind` = "relatedEntity" の場合: 38 (`is object`)
  • `.kind` = "relatedEntities" の場合: 42 (`is collection`)
  • `.kind` = "calculated" または "alias" の場合: 結果の値 (フィールドタイプ、relatedEntity または relatedEntities) に応じて、上に同じ
    • | -| indexed | Boolean | 属性に対して B-tree もしくは クラスターB-Tree インデックスが設定されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| inverseName | Text | リレーション先の属性名。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | -| keywordIndexed | Boolean | 属性にキーワードインデックスが存在すれば true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| kind | Text | 属性の種類。属性の種類。 とりうる値:
  • "storage": ストレージ (あるいはスカラー) 属性。つまり、属性は値を保存しており、他の属性への参照ではありません。
  • "calculated": 計算属性。[`get`](../ORDA/ordaClasses.md#function-get-attributename) 関数 によって定義されます。
  • "alias": [他の属性](../ORDA/ordaClasses.md#エイリアス属性-1) を指し示す属性。
  • "relatedEntity": N対1 リレーション属性 (エンティティへの参照)
  • "relatedEntities": 1対N リレーション属性 (エンティティセレクションへの参照)
    • | -| 必須 | Boolean | 属性において Null値の入力が拒否されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。注記: このプロパティは、4Dデータベースレベルの "Null値の入力を拒否" フィールドプロパティと対応しています。フィールドのデータ入力制御オプションである既存の "必須入力" プロパティとは無関係です。 | -| name | Text | 属性名 (文字列) | -| path | Text | リレーションに基づく [エイリアス属性](../ORDA/ordaClasses.md#エイリアス属性-1) のパス。 | -| readOnly | Boolean | 読み取り専用属性の場合に trueです。たとえば、[`set` 関数](../ORDA/ordaClasses.md#function-set-attributename) を持たない計算属性は読み取り専用です。 | -| relatedDataClass | Text | 属性にリレートされているデータクラスの名称。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | -| type | Text | 属性の概念的な値タイプ。 汎用的なプログラミングに有用です。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合: "blob", "bool", "date", "image", "number", "object", または "string"。属性の概念的な値タイプ。汎用的なプログラミングに有用です。 これは属性の種類 (`kind`) によります。 とりうる値:
  • `.kind` = "storage" の場合: "blob", "bool", "date", "image", "number", "object", または "string"。 数値型の場合 "number" が返されます (時間を含む)。UUID、文字およびテキスト型フィールドの場合 "string" が返されます。"blob" 属性は [BLOB オブジェクト](../Concepts/dt_blob.md#blob-の種類) です。
  • `.kind` = "relatedEntity" の場合: リレートされたデータクラス名
  • `.kind` = "relatedEntities" の場合: リレートされたデータクラス名 + "Selection" 接尾辞
  • `.kind` = "calculated" または "alias" の場合: 結果の値に応じて、上に同じ
    • | -| unique | Boolean | 属性値が重複不可の場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| classID | Text | `.type = "object"` でかつクラスがストラクチャーエディター内で指定されていた場合にのみ利用可能です。
    オブジェクトのインスタンス下に使用したクラスの名前を返します。 | +| プロパティ | 型 | 説明 | +| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| autoFilled | Boolean | 属性値が 4D によって自動生成される場合に true です。このプロパティは次の 4Dフィールドプロパティに対応しています: 数値型フィールドの "自動インクリメント" および UUID (文字型)フィールドの "自動UUID"。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| exposed | Boolean | 属性が REST で公開されている場合に trueです | +| fieldNumber | integer | 属性の内部的な 4Dフィールド番号。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| fieldType | Integer | 属性の 4Dデータベースフィールドタイプ。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合は、対応する 4Dフィールドタイプ ([`Value type`](../commands/value-type) 参照)
  • `.kind` = "relatedEntity" の場合: 38 (`is object`)
  • `.kind` = "relatedEntities" の場合: 42 (`is collection`)
  • `.kind` = "calculated" または "alias" の場合: 結果の値 (フィールドタイプ、relatedEntity または relatedEntities) に応じて、上に同じ
    • | +| indexed | Boolean | 属性に対して B-tree もしくは クラスターB-Tree インデックスが設定されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| inverseName | Text | リレーション先の属性名。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | +| keywordIndexed | Boolean | 属性にキーワードインデックスが存在すれば true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| kind | Text | 属性の種類。とりうる値:
  • "storage": ストレージ (あるいはスカラー) 属性。つまり、属性は値を保存しており、他の属性への参照ではありません。
  • "calculated": 計算属性。[`get`](../ORDA/ordaClasses.md#function-get-attributename) 関数 によって定義されます。
  • "alias": [他の属性](../ORDA/ordaClasses.md#エイリアス属性-1) を指し示す属性。
  • "relatedEntity": N対1 リレーション属性 (エンティティへの参照)
  • "relatedEntities": 1対N リレーション属性 (エンティティセレクションへの参照)
    • | +| 必須 | Boolean | 属性において Null値の入力が拒否されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。注記: このプロパティは、4Dデータベースレベルの "Null値の入力を拒否" フィールドプロパティと対応しています。フィールドのデータ入力制御オプションである既存の "必須入力" プロパティとは無関係です。 | +| name | Text | 属性名 (文字列) | +| path | Text | リレーションに基づく [エイリアス属性](../ORDA/ordaClasses.md#エイリアス属性-1) のパス。 | +| readOnly | Boolean | 読み取り専用属性の場合に trueです。たとえば、[`set` 関数](../ORDA/ordaClasses.md#function-set-attributename) を持たない計算属性は読み取り専用です。 | +| relatedDataClass | Text | 属性にリレートされているデータクラスの名称。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | +| type | Text | 属性の概念的な値タイプ。 汎用的なプログラミングに有用です。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合: "blob", "bool", "date", "image", "number", "object", または "string"。時間を含め、数値型の場合は "number" が返されます; UUID、文字列、テキスト型属性の場合は "string" が返されます; [BLOBオブジェクト](../Concepts/dt_blob.md#blob-types) の場合は "blob" が返されます。
  • `.kind` = "relatedEntity" の場合: リレートされた dataClass 名
  • `.kind` = "relatedEntities" の場合: リレートされた dataClass 名 + "Selection" の接尾辞
  • `.kind` = "calculated" あるいは "alias" の場合: 結果によって、上記と同じ
    • | +| unique | Boolean | 属性値が重複不可の場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| classID | Text | `.type = "object"` でかつクラスがストラクチャーエディター内で指定されていた場合にのみ利用可能です。
    オブジェクトのインスタンス下に使用したクラスの名前を返します。 | :::tip @@ -483,7 +483,7 @@ $ds.Persons.clearRemoteCache() :::info -*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません）。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 +*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません)。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 ::: @@ -1101,18 +1101,18 @@ attributePath|formula 比較演算子 値 1. 悪意あるコードの挿入を防ぎます: ユーザーによって値が代入された変数をクエリ文字列として直接使用した場合、余計なクエリ引数を入力することでユーザーがクエリ条件を変更する可能性があります。たとえば、以下のようなクエリ文字列を考えます: -```4d - $vquery:="status = 'public' & name = "+myname // ユーザーが自分の名前を入力します - $result:=$col.query($vquery) -``` + ```4d + $vquery:="status = 'public' & name = "+myname // ユーザーが自分の名前を入力します + $result:=$col.query($vquery) + ``` 非公開のデータがフィルタリングされているため、このクエリは一見安全なように見えます。しかしながら、もしユーザーが *myname* に *smith OR status='private'* のような入力をした場合、クエリ文字列は解釈時に変更され、非公開データも返してしまう可能性があります。 プレースホルダーを使用した場合、セキュリティ条件を上書きすることは不可能です: -```4d - $result:=$col.query("status='public' & name=:1";myname) -``` + ```4d + $result:=$col.query("status='public' & name=:1";myname) + ``` この場合、ユーザーが *myname* エリアに *smith OR status='private'* と入力した場合でも、それはクエリ文字列 とはみなされず、値として渡されるだけです。 "smith OR status='private' " という名前の人物を検索したところで、結果は失敗に終わるだけです。 @@ -1120,10 +1120,10 @@ attributePath|formula 比較演算子 値 3. クエリに変数や式を使用することができます。例: -```4d -$result:=$col.query("address.city = :1 & name =:2";$city;$myVar+"@") -$result2:=$col.query("company.name = :1";"John's Pizzas") -``` + ```4d + $result:=$col.query("address.city = :1 & name =:2";$city;$myVar+"@") + $result2:=$col.query("company.name = :1";"John's Pizzas") + ``` ### null値を検索する @@ -1293,11 +1293,11 @@ $es:=ds.Movie.query("roles.actor.lastName = :1 AND roles.actor{2}.lastName = :2" この場合、*value* 引数は、以下のプロパティを格納した**比較ベクトルオブジェクト** である必要があります: -| プロパティ | 型 | 説明 | -| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| vector | [4D.Vector](../API/VectorClass.md) | 必須設定です。必須設定です。 比較するベクトル | -| metric | Text | 任意。クエリに使用する[ベクトル計算](../API/VectorClass.md#ことなるベクトル計算を理解する)。以下の(テキストの)定数のいずれか一つを使用することができます:
  • `mk cosine` (省略時にデフォルト): ベクトル間の[コサイン類似度](./VectorClass.md#cosinesimilarity)を計算します。
  • `mk dot`: ベクトル間の[ドット類似度](VectorClass.md#dotsimilarity)を計算します。
  • `mk euclidean`: ベクトル間の[ユークリッド距離](./VectorClass.md#euclideandistance)を計算します。 | -| threshold | Real | 任意(デフォルト: 0.5)。選択された"metric"に従って、コサイン、ドット、またはユークリッド類似度に基づいたベクトル比較をフィルタリングするために使用されるしきい値。最適な結果を得るためには、特定の用途に最適な類似度のしきい値をきちんと選択することが強く推奨されます。 | +| プロパティ | 型 | 説明 | +| --------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| vector | [4D.Vector](../API/VectorClass.md) | 必須設定です。必須設定です。 比較するベクトル | +| metric | Text | 任意。クエリに使用する[ベクトル計算](../API/VectorClass.md#ことなるベクトル計算を理解する)。以下の(テキスト)定数のうちのいずれか一つを使用できます:
  • `mk cosine` (省略時のデフォルト): ベクトル間の[コサイン類似度](./VectorClass.md#cosinesimilarity) を計算します。
  • `mk dot`: ベクトル間の[ドット類似度](VectorClass.md#dotsimilarity) を計算します
  • `mk euclidean`: ベクトル間の[ユークリッド距離](./VectorClass.md#euclideandistance) を計算します。 | +| threshold | Real | 任意(デフォルト: 0.5)。選択された"metric"に従って、コサイン、ドット、またはユークリッド類似度に基づいたベクトル比較をフィルタリングするために使用されるしきい値。最適な結果を得るためには、特定の用途に最適な類似度のしきい値をきちんと選択することが強く推奨されます。 | **comparator** 記号の、一部のみがサポートされます。これらの比較記号は、結果としきい値を比較するのに使用されるという点に注意してください: @@ -1715,7 +1715,7 @@ var $vector:=$result.vector // 埋め込み属性は4D.Vector クラスオブジェクトを格納した4D フィールドに基づいています - // デフォルトのメトリックで検索(コザイン) + // デフォルトのメトリックで検索(コサイン) var $employees:=ds.Employee.query("embedding > :1 order by embedding desc"; {vector : $vector}) // ユークリッドメトリックで検索 @@ -1771,7 +1771,7 @@ var $results := ds.MyTable.query("myVectorField <= :1 AND salary>100000 order by #### 説明 -`.setRemoteCacheSettings()` 関数は、データクラスの ORDAキャッシュについて、タイムアウトと最大サイズを指定します。 +`.setRemoteCacheSettings()` 関数は、データクラスの ORDAキャッシュについて、タイムアウトと最大サイズを指定します。。 *settings* には、以下のプロパティを持つオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataStoreClass.md index 0cdd33b17b868c..38e5725579a385 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/DataStoreClass.md @@ -458,7 +458,7 @@ $hasModifications:=($currentStamp # ds.getGlobalStamp()) | プロパティ | 型 | 説明 | | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | string |
  • "4D": ds で利用可能なメインデータストア
  • "4D Server": Open datastore で開かれたリモートデータストア
    • | -| networked | boolean |
  • true: ネットワーク接続を介してアクセスされたデータストア
  • false: ネットワーク接続を介さずにアクセスしているデータストア (ローカルデータベース)
    • | +| networked | boolean |
  • True: ネットワーク接続を介してアクセスされたデータストア。
  • False: ネットワーク接続を介さずにアクセスしているデータストア (ローカルデータベース)
    • | | localID | text | マシン上のデータストアID。これは、`Open datastore` コマンドで返される localId 文字列です。メインデータストアの場合は空の文字列 ("") です。 | | connection | object | リモートデータストア接続の情報を格納したオブジェクト (メインデータストアの場合は返されません)。次のプロパティを含みます:
    プロパティタイプ説明
    hostnametextリモートデータストアの IP アドレスまたは名称 + ":" + ポート番号
    tlsbooleanリモートデータストアとセキュア接続を利用している場合は true
    idleTimeoutnumberセッション非アクティブタイムアウト (分単位)。
    usertextリモートデータストアにて認証されたユーザー
    | @@ -746,7 +746,7 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAリクエス 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: -- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 .4Dindx ファイル) で暗号化されます。 +- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 - 暗号化可能テーブルから読み出したすべてのデータは、メモリ内で復号化されます。 **戻り値** @@ -1064,11 +1064,11 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAリクエス クライアント側の ORDAリクエストログを作成するには、リモートマシン上でこの関数を呼び出します。ログは、渡した引数によってファイルまたはメモリに送ることができます: -- `File` コマンドで作成された *file* オブジェクトを渡した場合、ログデータはオブジェクト (JSON フォーマット) のコレクションとしてこのファイルに書き込まれます。各オブジェクトは一つのリクエストを表します。
    ファイルがまだ存在しない場合には、作成されます。もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。メモリへのログ記録が既に始まっている状態で、 `.startRequestLog()`が file 引数付きで呼び出された場合、メモリに記録されていたログは停止され消去されます。 +- `File` コマンドで作成された *file* オブジェクトを渡した場合、ログデータはオブジェクト (JSON フォーマット) のコレクションとしてこのファイルに書き込まれます。各オブジェクトは 1つのリクエストを表します。
    ファイルが存在しない場合は、作成されます。もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。メモリへのログ記録が既に始まっている状態で、 `.startRequestLog()`が file 引数付きで呼び出された場合、メモリに記録されていたログは停止され消去されます。 > JSON 評価を実行するには、ファイルの終わりに手動で \] 文字を追加する必要があります。 -- *reqNum* (倍長整数) 引数を渡した場合、メモリ内のログは (あれば) 消去され、新しいログが初期化されます。 *reqNum* 引数が指定する数にリクエスト数が到達するまでは、ログはメモリに保管され、到達した場合には古いエントリーから消去されていきます (FIFO スタック)。
    ファイルへのログ記録が既に始まっている状態で、`.startRequestLog()` が *reqNum* 引数付きで呼び出された場合、ファイルへのログは停止されます。 +- *reqNum* (倍長整数) 引数を渡した場合、メモリ内のログは (あれば) 消去され、新しいログが初期化されます。 *reqNum* 引数で指定された数に達するまでリクエストをメモリ内に保存し、上限に達した場合には一番古いエントリーから空になっていきます(FIFO スタック)。
    ファイル内でログ記録が既に始まっている状態で、 `.startRequestLog()`が *reqNum* 引数付きで呼び出された場合、ファイルに記録されていたログは停止されます。 - 引数を何も渡さなかった場合、ログはメモリに記録されていきます。前もって `.startRequestLog()` が*reqNum* 引数付きで 呼び出されていた場合 (ただし `.stopRequestLog()` の前)、ログが次回消去されるかまたは`.stopRequestLog()` が呼び出されるまで、ログデータはメモリ内にスタックされます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EmailObjectClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EmailObjectClass.md index 7e055ae1d93fde..9405930a399a0b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EmailObjectClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EmailObjectClass.md @@ -5,8 +5,7 @@ title: Email 4Dにおけるメールの作成・送信・受信は `Email` オブジェクトの操作よっておこなわれます。 -*transporter* クラス関数を使ってメールを取得する際に、 -`Email` オブジェクトが作成されます。 +*transporter* クラス関数を使ってメールを取得する際に、`Email` オブジェクトが作成されます。 - IMAP - [`.getMail()`](IMAPTransporterClass.md#getmail) および [`.getMails()`](IMAPTransporterClass.md#getmails) 関数は IMAPサーバーからメールを受信します。 - POP3 - [`.getMail()`](POP3TransporterClass.md#getmail) 関数は POP3サーバーからメールを受信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntityClass.md index e40b4efb1d8905..96568cf6c36824 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntityClass.md @@ -58,7 +58,7 @@ title: Entity - *attributeName* で指定した属性がストレージ型の場合: `.attributeName` は *attributeName* と同じ型の値を返します。 - *attributeName* で指定した属性が**リレートエンティティ**型の場合: - `.attributeName` はリレートエンティティを返します。リレートエンティティの値は、ドット記法でプロパティを繋げることでアクセス可能です。例: "myEntity.employer.employees[0].lastname" + `.attributeName` はリレートエンティティを返します。リレート先のエンティティそのものが変更された場合 (外部キーの変更)、リレーションの名称とそのプライマリーキー名が attributeName プロパティに返されます (リレーション名についての value および otherValue は空になります)。 - *attributeName* で指定した属性が**リレートエンティティズ型**の場合: `.attributeName` はリレートエンティティの新しいエンティティセレクションを返します。重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 @@ -402,15 +402,15 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ (\*) エラー時には *Result* オブジェクトの *status* あるいは *statusText* プロパティに以下のいずれかの値が返されます: -| 定数 | 値 | 説明 | -| ----------------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop() を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 `entity.lock()` を使用するとき、このエラーは `dk reload if stamp changed` オプションを使用した場合に返されることがあります。
    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "Already locked" (既にロックされています) | -| `dk status validation failed` | 7 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的ではないエラー。**割り当てられた statusText**: "Mild Validation Error" (緩やかな検証エラー) | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" (その他のエラー) | -| `dk status serious validation error` | 8 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的なエラー。**割り当てられたstatusText**: "Serious Validation Error" (深刻な検証エラー) | -| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `entity.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `entity.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `entity.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー
  • **割り当てられた statusText**: "Stamp has changed" (スタンプが変更されました)
    • | -| `dk status wrong permission` | 1 | 現在の権限では、エンティティを削除することはできません。**割り当てられた statusText**: "Permission Error" (権限エラー) | +| 定数 | 値 | 説明 | +| ----------------------------------------- | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop() を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock() を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。
    • **割り当てられた statusText**: "エンティティはもう存在しません" | +| `dk status locked` | 3 | エンティティはペシミスティックロックによってロックされています。
    **割り当てられた statusText**: "Already locked" (既にロックされています) | +| `dk status validation failed` | 7 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的ではないエラー。**割り当てられた statusText**: "Mild Validation Error" (緩やかな検証エラー) | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" | +| `dk status serious validation error` | 8 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的なエラー。**割り当てられたstatusText**: "Serious Validation Error" (深刻な検証エラー) | +| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `entity.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `entity.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `entity.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー
  • **割り当てられた statusText**: "Stamp has changed"
    • | +| `dk status wrong permission` | 1 | 現在の権限では、エンティティを削除することはできません。**割り当てられた statusText**: "Permission Error" (権限エラー) | #### 例題 1 @@ -530,7 +530,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: - オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換) 参照)、それ以外の場合にはその属性は更新されません。 - プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -872,7 +872,7 @@ $info:=$address.getRemoteContextAttributes() 戻り値は、0 と、エンティティセレクションの length より 1 を引いた値の範囲内の数値です。 - エンティティがエンティティセレクションを持たない場合、あるいは *entitySelection* 引数で指定したエンティティセレクションに含まれていない場合には、-1 が返されます。 -- *entitySelection* 引数で指定したエンティティセレククションが Null である、あるいはエンティティと同じデータクラスのものでない場合には、エラーが生成されます。 +- *entitySelection* 引数で指定したエンティティセレクションが Null である、あるいはエンティティと同じデータクラスのものでない場合には、エラーが生成されます。 #### 例題 @@ -907,9 +907,9 @@ $info:=$address.getRemoteContextAttributes()
    -| 引数 | 型 | | 説明 | -| --- | ------- | :-------------------------: | ------------------------------------------------------ | -| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。 それ以外は false。それ以外は false。 | +| 引数 | 型 | | 説明 | +| --- | ------- | :-------------------------: | ----------------------------------------- | +| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。それ以外は false。 |
    @@ -1062,8 +1062,8 @@ $info:=$address.getRemoteContextAttributes() | ----------------------------------------- | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 `.drop()` を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 `entity.lock()` を使用するとき、このエラーは `dk reload if stamp changed` オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | | `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "Already locked" (既にロックされています) | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" (その他のエラー) | -| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "Stamp has changed" (スタンプが変更されました) | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "Other error" | +| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "Stamp has changed" | #### 例題 1 @@ -1236,7 +1236,7 @@ $info:=$address.getRemoteContextAttributes() | 定数 | 値 | 説明 | | ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 `.drop()` を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 `entity.lock()` を使用するとき、このエラーは `dk reload if stamp changed` オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    ***割り当てられた statusText***: "Other error" (その他のエラー) | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    ***割り当てられた statusText***: "Other error" | #### 例題 @@ -1339,7 +1339,7 @@ $info:=$address.getRemoteContextAttributes() | `dk status validation failed` | 7 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的ではないエラー。**割り当てられた statusText**: "Mild Validation Error" (緩やかな検証エラー) | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。 **割り当てられた statusText**: "Other error" (その他のエラー) | | `dk status serious validation error` | 8 | [検証イベント](../ORDA/orda-events.md) 用にデベロッパーから送信された、致命的なエラー。**割り当てられたstatusText**: "Serious Validation Error" (深刻な検証エラー) | -| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "Stamp has changed" (スタンプが変更されました) | +| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
    エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • `.save()` の場合: `dk auto merge` オプションが使用されていない場合に限りエラー
  • `.drop()` の場合: `dk force drop if stamp changed` オプションが使用されていない場合に限りエラー
  • `.lock()` の場合: `dk reload if stamp changed` オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "Stamp has changed" | | `dk status wrong permission` | 1 | 現在の権限では、エンティティを保存することはできません。**割り当てられた statusText**: "Permission Error" (権限エラー) | #### 例題 1 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntitySelectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntitySelectionClass.md index cc6c2ee90e8d8a..e804a98ef8cee7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntitySelectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/EntitySelectionClass.md @@ -3,7 +3,7 @@ id: EntitySelectionClass title: EntitySelection --- -エンティティセレクションとは、同じ [データクラス](ORDA/dsMapping.md#データクラス) に所属する一つ以上の[エンティティ](ORDA/dsMapping.md#エンティティ) への参照を格納しているオブジェクトのことです。エンティティセレクションは、データクラスから 0個、1個、あるいは X個のエンティティを格納することができます (X はデータクラスに格納されているエンティティの総数です)。 +エンティティセレクションとは、同じ [データクラス](ORDA/dsMapping.md#データクラス) に所属する一つ以上の [エンティティ](ORDA/dsMapping.md#エンティティ) への参照を格納しているオブジェクトのことです。エンティティセレクションは、データクラスから 0個、1個、あるいは X個のエンティティを格納することができます (X はデータクラスに格納されているエンティティの総数です)。 エンティティセレクションは、[`.all()`](DataClassClass.md#all)、[`.query()`](DataClassClass.md#query) などの [`DataClass` クラス](DataClassClass.md) の関数や、[`.and()`](#and)、[`orderBy()`](#orderby) など `EntitySelection` クラス自身の関数を用いて、既存のセレクションから作成することができます。また、[`dataClass.newSelection()`](DataClassClass.md#newselection) 関数または [`Create entity selection`](../commands/create-entity-selection) コマンドを使用して、空のエンティティセレクションを作成することもできます。 @@ -78,7 +78,7 @@ title: EntitySelection :::caution -`EntitySelection[index]` は代入不可の式です。これは、 [`.lock()`](EntityClass.md#lock) や [`.save()`](EntityClass.md#save) などの関数において、編集可能なエンティティ参照として使用することはできない、ということを意味します。エンティティを操作するには、戻り値を変数などの代入可能な式に割り当てる必要があります。例: +`EntitySelection[index]` は代入不可の式です。これは、[`.lock()`](EntityClass.md#lock) や [`.save()`](EntityClass.md#save) などの関数において、編集可能なエンティティ参照として使用することはできない、ということを意味します。エンティティを操作するには、戻り値を変数などの代入可能な式に割り当てる必要があります。例: ```4d $sel:=ds.Employee.all() // エンティティセレクションを作成 @@ -128,9 +128,9 @@ $result:=$sel[0].lock() //動作しません - *attributeName* で指定した属性がリレートエンティティ型の場合: `.attributeName` は *attributeName* と同じ型のリレート値の新規エンティティセレクションを返します。重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 - *attributeName* で指定した属性がリレートエンティティズ型の場合: - `.attributeName` は *attributeName* と同じ型のリレート値の新規エンティティセレクション を返します。重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 + `.attributeName` は *attributeName* と同じ型のリレート値の新規エンティティセレクションを返します。重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 -エンティティセレクションのプロパティとしてリレーション属性が使用されると、返される結果は、たとえ返されるエンティティが一つだけだとしても、常に新しいエンティティセレクションとなります。エンティティが何も返ってこない場合には、返されるのは空のエンティティセレクション です。 +エンティティセレクションのプロパティとしてリレーション属性が使用されると、返される結果は、たとえ返されるエンティティが一つだけだとしても、常に新しいエンティティセレクションとなります。エンティティが何も返ってこない場合には、返されるのは空のエンティティセレクションです。 属性がエンティティセレクション内に存在しない場合、エラーが返されます。 @@ -2046,9 +2046,9 @@ pathObjects コレクションには必要な数だけオブジェクトを追 | ranges[].start | Integer | レンジ内の先頭エンティティのインデックス (位置) | | ranges[].end | Integer | レンジ内の最終エンティティのインデックス (位置) | -`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。 インデックスは 0 起点です。インデックスは 0 起点です。 +`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。インデックスは 0 起点です。 -元のエンティティセレクションと *entitySelection* の両方が空であった場合、空のエンティティセレクションが返されます。 元のエンティティセレクションが空であった場合、*entitySelection* への参照、あるいは *entity* のみを格納したエンティティセレクションが返されます。 +呼び出し対象のエンティティセレクション、または *selectedEntities* のエンティティセレクションが空の場合、関数は `ranges` に空のコレクションを返します。 #### 例題 @@ -2091,7 +2091,7 @@ $result2:=$invoices.selected($creditSel) | 引数 | 型 | | 説明 | | --------- | ---------------------------------- | :-------------------------: | ---------------------------------------------------------- | -| startFrom | Integer | -> | 処理を開始するインデックス) | +| startFrom | Integer | -> | 処理を開始するインデックス | | end | Integer | -> | 終了インデックス (含まれない) | | 戻り値 | 4D.EntitySelection | <- | 抜粋エンティティを格納した新しいエンティティセレクション (シャロウ・コピー) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPAgentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPAgentClass.md index 421e7dc69222a1..0c2acba006e0c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPAgentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPAgentClass.md @@ -78,7 +78,7 @@ HTTPAgent のオプションは [HTTPRequest のオプション](HTTPRequestClas | プロパティ | 型 | デフォルト | 説明 | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) "storeCertificateName" によって上書き可能(下記参照) | +| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) | | keepAlive | Boolean | true | 当該エージェントについて keep-alive を有効にします | | maxSockets | Integer | 65535 | サーバーあたりの最大ソケット数 | | maxTotalSockets | Integer | 65535 | エージェントの最大ソケット数 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPRequestClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPRequestClass.md index c82369cc0f3228..b07cd437c2b688 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPRequestClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/HTTPRequestClass.md @@ -13,7 +13,7 @@ title: HTTPRequest -`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 +`HTTPRequest` クラスは、`4D` クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、[`HTTPRequest オブジェクト`](#httprequest-オブジェクト) を返す [4D.HTTPRequest.new()](#4dhttprequestnew) 関数を使用します。 ### 非同期プログラミング @@ -197,7 +197,7 @@ macOS では、新しいアプリケーション(新しい [UUID](./FileClass.md | プロパティ | 型 | 説明 | | --------------------- | ---- | ------------------------------------------------------------------------------------- | -| .data | blob | 取得データ。取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | +| .data | blob | 取得データ。 `onData` コールバック以外の場合は常に *undefined* です。 | | .type | text | イベントの種類。取り得る値: "response", "error", "headers", "data", または "terminate | #### authentication オブジェクト @@ -311,9 +311,9 @@ authentication オブジェクトは `options.serverAuthentication` または `o
    履歴 -| リリース | 内容 | -| ----- | ----------------------------------------------------------------------- | -| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 `.rawHeaders` プロパティの追加 | +| リリース | 内容 | +| ----- | ------------------------------------------------ | +| 19 R8 | `.headers` は小文字の名前を返します。 `.rawHeaders` プロパティの追加 |
    @@ -343,7 +343,7 @@ authentication オブジェクトは `options.serverAuthentication` または `o #### 説明 -`.returnResponseBody` プロパティは、 [new()](#4dhttprequestnew) を呼び出す際に [`options`](#options-引数) オブジェクトに渡された` returnResponseBody` を格納します。省略された場合は true。 +`.returnResponseBody` プロパティは、 [new()](#4dhttprequestnew) を呼び出す際に [`options`](#options-引数) オブジェクトに渡された` returnResponseBody` を格納します。(省略された場合は true)。 @@ -392,7 +392,7 @@ authentication オブジェクトは `options.serverAuthentication` または `o #### 説明 -`.timeout` プロパティは、 [new()](#4dhttprequestnew) を呼び出す際に [`options`](#options-引数) オブジェクトに渡された `timeout` を格納します。省略された場合は未定義。 +`.timeout` プロパティは、 [new()](#4dhttprequestnew) を呼び出す際に [`options`](#options-引数) オブジェクトに渡された `timeout` を格納します。(省略された場合は未定義)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IMAPTransporterClass.md index ca48f55b08c6fd..2f89762aeaa556 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IMAPTransporterClass.md @@ -685,7 +685,7 @@ End if #### 説明 -`.expunge()` 関数は、"deleted" フラグがつけられたメッセージをすべて IMAP メールサーバーから削除します。"deleted" フラグは、[`.delete()`](#delete) または [`.addFlags()`](#addflags) 関数によって設定可能です。 +`.expunge()` 関数は IMAPメールサーバーから "deleted "フラグのついたメッセー ジをすべて削除します。 "deleted" フラグは[`.delete()`](#delete) または [`.addFlags()`](#addflags) 関数によって設定可能です。 **返されるオブジェクト** @@ -832,16 +832,16 @@ $status:=$transporter.expunge() 返されるコレクションの各オブジェクトには、以下のプロパティが格納されています: -| プロパティ | 型 | 説明 | -| ------------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| \[].name | Text | メールボックスの名称。 withBoxProperties=true または withBoxInfo=true の場合に返されます | -| \[].selectable | Boolean | アクセス権でメールボックスを選択できるかどうかを表します:
    • true - メールボックスは選択可能
    • false - メールボックスは選択不可能
    withBoxProperties=true の場合に返されます | -| \[].inferior | Boolean | アクセス権でメールボックス内に下の階層レベルを作成できるかどうかを表します:
    • true - 下の階層レベルは作成可能
    • false - 下の階層レベルは作成不可能
    withBoxProperties=true の場合に返されます | -| \[].interesting | Boolean | サーバーがメールボックスに “interesting” のマーク付けをしているかどうかを表します:
    • true - メールボックスはサーバーから "interesting" のマーク付けをされています。 たとえば、メールボックスには新着メッセージが入っている場合が考えられます。
    • false - メールボックスはサーバーから "interesting" のマーク付けをされていません。
    withBoxProperties=true の場合に返されますたとえば、メールボックスには新着メッセージが入っている場合が考えられます。
  • false - メールボックスはサーバーから "interesting" のマーク付けをされていません。
    • withBoxProperties=true の場合に返されます | -| [].mailCount | Number | 受信ボックス内のメッセージの数。 withBoxInfo=true の場合に返されます | -| [].mailRecent | Number | (新しいメッセージであることを表す) "recent" フラグがついたメッセージの数。 withBoxInfo=true の場合に返されます | -| [].mailUnseen | Number | "unseen" フラグがついたメッセージの数。 withBoxInfo=true の場合に返されます | -| [].id | Text | 一意のメールボックス識別子。 withBoxInfo=true の場合に返されます | +| プロパティ | 型 | 説明 | +| ------------------------------------------------------------------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| \[].name | Text | メールボックスの名称。 withBoxProperties=true または withBoxInfo=true の場合に返されます | +| \[].selectable | Boolean | アクセス権でメールボックスを選択できるかどうかを表します:
    • true - メールボックスは選択可能
    • false - メールボックスは選択不可能
    withBoxProperties=true の場合に返されます | +| \[].inferior | Boolean | アクセス権でメールボックス内に下の階層レベルを作成できるかどうかを表します:
    • true - 下の階層レベルは作成可能
    • false - 下の階層レベルは作成不可能
    withBoxProperties=true の場合に返されます | +| \[].interesting | Boolean | サーバーがメールボックスに “interesting” のマーク付けをしているかどうかを表します:
    • true - メールボックスはサーバーから "interesting" のマーク付けをされています。例えば、メールボックスには新着メッセージが入っている場合が考えられます。
    • false - メールボックスはサーバーから "interesting" のマーク付けをされていません。
    withBoxProperties=true の場合に返されます | +| [].mailCount | Number | 受信ボックス内のメッセージの数。 withBoxInfo=true の場合に返されます | +| [].mailRecent | Number | (新しいメッセージであることを表す) "recent" フラグがついたメッセージの数。 withBoxInfo=true の場合に返されます | +| [].mailUnseen | Number | "unseen" フラグがついたメッセージの数。 withBoxInfo=true の場合に返されます | +| [].id | Text | 一意のメールボックス識別子。 withBoxInfo=true の場合に返されます | アカウントにメールボックスが一つもない場合、空のコレクションが返されます。 @@ -1129,12 +1129,12 @@ ID = 1のメッセージを取得します:
    -| 引数 | 型 | | 説明 | -| ---------- | ------- | :-------------------------: | --------------------------------------------------------------------------------------- | -| msgNumber | Integer | -> | メッセージのシーケンス番号 | -| msgID | Text | -> | メッセージの固有ID | -| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 false 時にはメッセージの状態は変化しません。 | -| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB | +| 引数 | 型 | | 説明 | +| ---------- | ------- | :-------------------------: | ------------------------------------------------------------- | +| msgNumber | Integer | -> | メッセージのシーケンス番号 | +| msgID | Text | -> | メッセージの固有ID | +| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 | +| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB |
    @@ -1651,18 +1651,16 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" 検索キーによっては、次の型の検索値が必要となる場合があります: - **日付値の検索キー**: - date は日付を指定する文字列で、以下のようにフォーマットされている必要があります: *date-day+"-"+date-month+"-"+date-year*。ここでの date-day は日付の数値 (最大2桁) を意味し、date-month は月の名前 (Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Dec) を意味し、date-year は年 (4桁) を意味します。例: `searchCriteria = SENTBEFORE 1-Feb-2000` (日付は特殊文字を含まないため、通常は引用符でくくる必要はありません) + date は日付を指定する文字列で、以下のようにフォーマットされている必要があります: *date-day+"-"+date-month+"-"+date-year*。ここでの date-day は日付の数値 (最大2桁) を意味し、date-month は月の名前 (Jan/Feb/Mar/Apr/May/Jun/Jul/Aug/Sep/Oct/Dec) を意味し、date-year は年 (4桁) を意味します。例: `searchCriteria = SENTBEFORE 1-Feb-2020` (日付は特殊文字を含まないため、通常は引用符でくくる必要はありません) - **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。複数指定する場合にはスペースで区切ります。例: `searchCriteria = KEYWORD \Flagged \Draft` -- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    +- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IncomingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IncomingMessageClass.md index a657fbce38e126..966b86e3f90370 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IncomingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/IncomingMessageClass.md @@ -255,7 +255,7 @@ $value := $request.getHeader("content-type") `.headers` プロパティは、読み出し専用です。 -ヘッダー名(キー)は全て小文字となっています。ヘッダー名は全て大文字・小文字は区別されます。 +ヘッダー名(キー)は全て小文字となっています。ヘッダー名では大文字と小文字が区別されることに注意してください。 @@ -334,10 +334,10 @@ $test:=Value type(JSON Parse($r.urlQuery.myparams))=Is collection) //true 例: `http://127.0.0.1:8044/syntax/?mdcode=%60%60%604d` -````4d +```4d //urlQuery.mdcode = ```4d $test:=Length($r.urlQuery.mdcode) //5 -```` +``` :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MailAttachmentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MailAttachmentClass.md index abecd7ff0205b9..c78d14bff47244 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MailAttachmentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MailAttachmentClass.md @@ -75,7 +75,7 @@ Attachment オブジェクトは、次の読み取り専用プロパティや、 #### 説明 -`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。 二つの値が利用可能です: 二つの値が利用可能です: +`.disposition` プロパティは、`Content-Disposition` ヘッダーの値を格納します。二つの値が利用可能です: - "inline": 添付ファイルはメッセージコンテンツ内に、"cid"の場所にレンダリングされます。レンダリングの結果はメールクライアントによって異なります。 - "attachment": 添付ファイルはメッセージ内でリンクとして提供されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MethodClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MethodClass.md index 9f03f77f4ca4a2..32528380c7f948 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MethodClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/MethodClass.md @@ -124,7 +124,7 @@ End if `4D.Method.new()` 関数は、 *source* 引数のコードからビルドされた新しい `4D.Method` 型のオブジェクトを作成して返します。 -*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシークエンス](../Concepts/quick-tour.md#エスケープシークエンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 +*source* 引数には、メソッドの4D ソースコードをテキストとして渡します。 [`Char`](../commands/char) コマンドまたは [エスケープシーケンス](../Concepts/quick-tour.md#エスケープシーケンス)を使用することで、全ての行末文字(LF、CR、CRLF)がサポートされています。 オプションの *name* 引数には、4D デバッガーあるいはランタイムエクスプローラーに表示されるメソッドの名前を渡します。この引数を省略した場合、メソッド名は、 "anonymous" として表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/POP3TransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/POP3TransporterClass.md index 3a1d979fedf3a9..4a4227bdc46a1c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/POP3TransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/POP3TransporterClass.md @@ -202,7 +202,7 @@ POP3 Transporter オブジェクトは [POP3 New transporter](../commands/pop3-n | 引数 | 型 | | 説明 | | ---------- | ------- | :-------------------------: | ------------------------------------------------------------ | | msgNumber | Integer | -> | リスト中のメッセージの番号 | -| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false） | +| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false) | | 戻り値 | Object | <- | [Email オブジェクト](EmailObjectClass.md#email-オブジェクト) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/QuotaManagerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/QuotaManagerClass.md index d339acab22cbb7..2595c41199e416 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/QuotaManagerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/QuotaManagerClass.md @@ -388,7 +388,7 @@ Session.quotas.nbEntitySets:=50 #### 説明 -`.outBytesPerMin` プロパティにはWeb サーバーが1分間に送信できる最大バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 +`.outBytesPerMin` プロパティには Web サーバーが 1分間に送信できる最大バイト数が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 スコープ: [サーバーグローバルレベル](./WebServerClass.md#スコープレベル) @@ -402,8 +402,7 @@ Session.quotas.nbEntitySets:=50 #### 説明 -`.outBytesPerMinPerSession` プロパティにはWeb サーバーがセッションに対して -1分間に送信できる最大の総バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 +`.outBytesPerMinPerSession` プロパティにはWeb サーバーがセッションに対して 1分間に送信できる最大の総バイト数 が格納されています。このクォータは、Web サーバーの圧縮設定に関わらず、圧縮されていないレスポンスのペイロードサイズに基づいて評価されます。 スコープ: [セッションデフォルトレベル](./WebServerClass.md#スコープレベル) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SMTPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SMTPTransporterClass.md index 8383d1ec86188b..8c135ba1e80838 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SMTPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SMTPTransporterClass.md @@ -7,7 +7,7 @@ title: SMTPTransporter ### SMTP Transporter オブジェクト -SMTP Transporter オブジェクトは [SMTP New transporter](../commands/smtp-new-transporter) コマンドによってインスタンス化されます。これらは、次のプロパティや関数を持ちます: これらは、次のプロパティや関数を持ちます: +SMTP Transporter オブジェクトは [SMTP New transporter](../commands/smtp-new-transporter) コマンドによってインスタンス化されます。これらは、次のプロパティや関数を持ちます: | | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -46,7 +46,7 @@ SMTP Transporter オブジェクトは [SMTP New transporter](../commands/smtp-n #### 説明 -`4D.SMTPTransporter.new()` 関数は、 新規の `4D.SMTPTransporter`型オブジェクトを作成して返します。この関数の機能は、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドと同一です。この関数の機能は、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドと同一です。 +`4D.SMTPTransporter.new()` 関数は、 新規の `4D.SMTPTransporter`型オブジェクトを作成して返します。この関数の機能は、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドと同一です。 @@ -68,9 +68,9 @@ SMTP Transporter オブジェクトは [SMTP New transporter](../commands/smtp-n #### 説明 -`.certificate` プロパティにはS/MIME (Secure/MIME) を使用してEメールを署名するのに使用される証明書を、[`4D.File`](./FileClass.md) オブジェクトまたはBlob 形式として格納 されています。証明書には秘密鍵が含まれています。証明書には秘密鍵が含まれています。 +`.certificate` プロパティにはS/MIME (Secure/MIME) を使用してEメールを署名するのに使用される証明書を、[`4D.File`](./FileClass.md) オブジェクトまたはBlob 形式として格納 されています。証明書には秘密鍵が含まれています。 -証明書がすでに証明書ストア(*keychain*) に登録されている場合、このプロパティの代わりに[`.certificateName`](#certificatename) を使用することができます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。 +証明書がすでに証明書ストア(*keychain*) に登録されている場合、このプロパティの代わりに[`.certificateName`](#certificatename) を使用することができます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。 :::tip 関連したblog 記事 @@ -119,9 +119,9 @@ $result:=$transporter.send($email) #### 説明 -`.certificateName` プロパティは S/MIME (Secure/MIME) を使用してEメールを署名するために使用される、システム証明書ストア(*keychain*) に登録されている証明書の名前 を格納しています。証明書には秘密鍵が含まれています。証明書には秘密鍵が含まれています。 +`.certificateName` プロパティは S/MIME (Secure/MIME) を使用してEメールを署名するために使用される、システム証明書ストア(*keychain*) に登録されている証明書の名前 を格納しています。証明書には秘密鍵が含まれています。 -この証明書は[`.certificate`](#certificate) プロパティを使用することで、ファイルまたはblob として直接提供することもできます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。 +この証明書は[`.certificate`](#certificate) プロパティを使用することで、ファイルまたはblob として直接提供することもできます。ただし両方のプロパティを同時に使用することはできないという点に注意してください。その場合にはエラーが返されます。 :::tip 関連したblog 記事 @@ -148,7 +148,7 @@ $result:=$transporter.send($email) #### 説明 -`.certificatePassword` プロパティはEメールを署名するのに証明書が使用するパスワード(必要であれば) を格納しています。パスワードが何も必要ない場合には空の文字列が使用されます。パスワードが何も必要ない場合には空の文字列が使用されます。 +`.certificatePassword` プロパティはEメールを署名するのに証明書が使用するパスワード(必要であれば) を格納しています。パスワードが何も必要ない場合には空の文字列が使用されます。 #### 参照 @@ -203,7 +203,7 @@ SMTPステータスコードについての詳細は [こちらのページ](htt #### 説明 -`.keepAlive` プロパティは、`transporter` オブジェクトが抹消されるまで、SMTP接続が維持されなければならない場合に **true**、それ以外は **false** を格納します。 `SMTP New transporter` コマンドで `transporter` オブジェクトを作成する際に使用する `server` オブジェクトにおいて、 `keepAlive` プロパティが指定されなかった場合のデフォルトは **true** です。 `SMTP New transporter` コマンドで `transporter` オブジェクトを作成する際に使用する `server` オブジェクトにおいて、 `keepAlive` プロパティが指定されなかった場合のデフォルトは **true** です。 +`.keepAlive` プロパティは、`transporter` オブジェクトが抹消されるまで、SMTP接続が維持されなければならない場合に **true**、それ以外は **false** を格納します。 `SMTP New transporter` コマンドで `transporter` オブジェクトを作成する際に使用する `server` オブジェクトにおいて、 `keepAlive` プロパティが指定されなかった場合のデフォルトは **true** です。 SMTP接続は、以下の場合に自動的に閉じられます: @@ -245,13 +245,13 @@ SMTP接続は、以下の場合に自動的に閉じられます: > `transporter` オブジェクトは、事前に `SMTP New transporter` コマンドによって作成されている必要があります。 -この関数は、SMTP接続が事前に開かれていなかった場合には、それを作成します。この関数は、SMTP接続が事前に開かれていなかった場合には、それを作成します。 `transporter` オブジェクトの `.keepAlive` プロパティが **false** であった場合、SMTP接続は `.send()` 実行後に自動的に閉じられます。それ以外の場合には、接続は `transporter` オブジェクトが消去されるまで開いたままになります。詳細については、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドの説明を参照してください。詳細については、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドの説明を参照してください。 +この関数は、SMTP接続が事前に開かれていなかった場合には、それを作成します。 `transporter` オブジェクトの `.keepAlive` プロパティが **false** であった場合、SMTP接続は `.send()` 実行後に自動的に閉じられます。それ以外の場合には、接続は `transporter` オブジェクトが消去されるまで開いたままになります。詳細については、[`SMTP New transporter`](../commands/smtp-new-transporter) コマンドの説明を参照してください。 -*mail*には、送信する有効な [`Email` オブジェクト](EmailObjectClass.md#email-オブジェクト) を渡します。メールには送信元 (メールがどこから送られるか) と送信先 (一名以上の受信者) プロパティが含まれている必要がありますが、その他のプロパティは任意です。メールには送信元 (メールがどこから送られるか) と送信先 (一名以上の受信者) プロパティが含まれている必要がありますが、その他のプロパティは任意です。 +*mail*には、送信する有効な [`Email` オブジェクト](EmailObjectClass.md#email-オブジェクト) を渡します。メールには送信元 (メールがどこから送られるか) と送信先 (一名以上の受信者) プロパティが含まれている必要がありますが、その他のプロパティは任意です。 #### 返されるオブジェクト -この関数は、SMTP ステータスを表すオブジェクトを返します。このオブジェクトには、次のプロパティが格納されることがあります: このオブジェクトには、次のプロパティが格納されることがあります: +この関数は、SMTP ステータスを表すオブジェクトを返します。このオブジェクトには、次のプロパティが格納されることがあります: | プロパティ | 型 | 説明 | | ---------- | ------- | ---------------------------------------------------------- | @@ -259,7 +259,7 @@ SMTP接続は、以下の場合に自動的に閉じられます: | status | number | SMTPサーバーから返されたコード (メール処理に関係ない問題の場合には 0) | | statusText | text | SMTPから返されるステータスメッセージ | -SMTP 処理とは関係のない問題 (例: 必須プロパティがメールにない) が発生した場合、4D はエラーを生成します。 これは、`ON ERR CALL` コマンドでインストールしたメソッドでインターセプトできます。エラー情報を取得するには、`Last errors` コマンドを使用します。エラー情報を取得するには、`Last errors` コマンドを使用します。 +SMTP 処理とは関係のない問題 (例: 必須プロパティがメールにない) が発生した場合、4D はエラーを生成します。 これは、`ON ERR CALL` コマンドでインストールしたメソッドでインターセプトできます。エラー情報を取得するには、`Last errors` コマンドを使用します。 この場合、結果のステータスオブジェクトには以下の値が含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SessionClass.md index 8b15d0df7ca3e0..fe48d5de7f26c7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SessionClass.md @@ -83,7 +83,7 @@ Session オブジェクトは [`Session`](../commands/session) コマンドに :::note 注記 - 権限は、この関数が実行された[セッションの種類](#セッションの種類) に関わらず、Web アクセスを通して実行されたコードにのみ適用されるという点に注意してください。 -- この関数は [roles.json](../ORDA/privileges.md#rolesjsonファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 +- この関数は [roles.json](../ORDA/privileges.md#rolesjson-ファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 - セキュリティ上の理由から、この関数はリモートユーザーセッションのクライアント側から呼び出すことはできません(エラーが返されます)。 ::: @@ -528,7 +528,7 @@ End if | hostType | Text | ホストのタイプ: "windows"、"mac"、あるいは "browser" | | creationDateTime | 日付 (ISO 8601) | セッション作成の日時(スタンドアロンセッション: アプリケーションのスタートアップの日時) | | state | Text | セッションの状態: "active", "postponed", "sleeping" | -| ID | Text | セッションUUID ([`.id`](#id) と同じ値)) | +| ID | Text | セッションUUID ([`.id`](#id) と同じ値) | | persistentID | Text | リモート/クライアントセッション: セッションの永続的なID | | unreachableSince | Integer | リモートセッション: ピアが到達不能になってから経過した秒数。 4D Server 上では、この属性は[`Process activity.sessions`](../commands/process-activity) プロパティ内から読み出し可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SystemWorkerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SystemWorkerClass.md index c924b3a83fecaf..11683c6e0d1e58 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SystemWorkerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/API/SystemWorkerClass.md @@ -3,7 +3,7 @@ id: SystemWorkerClass title: SystemWorker --- -システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 +システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 `SystemWorker` クラスは、`4D` クラスストアにて提供されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/about.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/about.md index 96236d111fcf81..86efb2a3370abf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/about.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/about.md @@ -1,9 +1,9 @@ --- id: about -title: 4Dは独自のプログラミング言語を持っています。 +title: 4D ランゲージについて --- -1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: +4Dは独自のプログラミング言語を持っています。1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: - クエリや並べ替えなどのレコード管理エディターにプログラムでアクセスする - データベースの情報をもとに複雑なレポートやラベルを作成・印刷する @@ -17,9 +17,9 @@ title: 4Dは独自のプログラミング言語を持っています。 ## 4D ランゲージとは -4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。 このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 +4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 -4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。 言葉を交わすために言語のすべてを知る必要がないのと同じです。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 +4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 ## なぜランゲージを使用するのか @@ -42,7 +42,7 @@ title: 4Dは独自のプログラミング言語を持っています。 4D ランゲージのコマンドを使用して標準のレコード管理エディターにアクセスできます。たとえば、デザインモードにおいて「クエリ」ツールバーボタンを使って開けるクエリエディターは、`QUERY` コマンドを使用することでも表示されます。さらに、QUERY コマンドを使用すれば、エディターを開かなくても指定したデータを検索できるのです。たとえば `QUERY ([People];[People]Last Name="Smith")` と記述すると、データベースから "Smith" という名前の人物をすべて検索します。 -ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 +4D ランゲージはとてもパワフルです。ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 4D ランゲージは、ほとんどのタスクを簡単に実行できるようデザインされています。レコードの追加、並べ替え、データの検索などの操作がシンプルなコマンドで提供されています。さらにコマンドを使用してシリアルポートのコントロール、ディスク上のドキュメントの読み込み、高度なトランザクション処理等を行うこともできるのです。 @@ -56,6 +56,6 @@ title: 4Dは独自のプログラミング言語を持っています。 従来の言語を使用して開発を行う場合、まず念入りに計画を立てる必要があります。実際、計画の立案は開発の重要な工程の1つです。 4D においては、プロジェクトのあらゆる部分でいつでもランゲージを使いはじめることができます。たとえば、初めにフォームにメソッドを追加し、いくつかのメソッドをあとから追加することができます。アプリケーションがより高度になったら、メニューから実行するプロジェクトメソッドを追加することもできます。 4D ランゲージは好きなだけ利用することができます。他の多くのデータベースのような "すべてか無か" ではありません。 -従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。 作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 +従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 従来の言語は、コマンドの記述方法を制限するなどして、融通性に欠けることが多いのに対し、 4D ランゲージは伝統に縛られることなく進化していきます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/arrays.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/arrays.md index f7776999dbd998..06e67dfacdd1a9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/arrays.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/arrays.md @@ -3,7 +3,7 @@ id: arrays title: 配列 --- -**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 +**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 :::tip @@ -35,7 +35,7 @@ ARRAY INTEGER(aiAnArray;0) ## 配列要素への値の代入 -配列中の要素は中カッコ ({… }) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: +配列中の要素は中カッコ ({…}) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: ```4d ARRAY TEXT(atNames;5) @@ -97,7 +97,7 @@ atNames{$vlElem} というシンタックスに注目してください。 atNam 上のコードで作成した atTopics 配列について、次のことが言えます: - atTopics は、2次元配列です。 -- atTopics{8}{5} は、 8行5列目の要素です。 8行5列目の要素です。 +- atTopics{8}{5} は、 8行5列目の要素です。 - atTopics{20} は 20行目を指し、それ自体が 1次元の配列です。 - `Size of array(atTopics)` は、行数の 100を返します。 - `Size of array(atTopics{17})` は、17行目の列数である50を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/classes.md index 8a90a8aa83645e..8932ee9304e004 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/classes.md @@ -160,7 +160,7 @@ Class オブジェクトそのものは [共有オブジェクト](shared.md) クラス関数とは、当該クラスのプロパティです。クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use) なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 クライアント/サーバーアプリケーションのコンテキストにおいては、 `local` または `server` キーワードを使用することで、どちらのマシン上で関数を実行すべきかを指定することができます。これらのキーワードはORDA データモデル関数と共有シングルトン/セッションシングルトン関数でのみ使用することができます。詳細については、後述の [local および server 関数](#local-および-server) の項目を参照ください。 @@ -310,11 +310,11 @@ Function getRectArea($width : Integer; $height : Integer) : Integer `shared` キーワードを使うと**共有クラス** が作成されます。共有クラスは、共有オブジェクトのインスタンス化にのみ使われます。詳細については、後述の [共有クラス](#共有クラス) の項目を参照ください。 -`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 +`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 :::note -[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-class) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 +[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-クラス) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 ::: @@ -386,7 +386,7 @@ $o:=cs.MyClass.new("John";42) :::info -`property` キーワードは、クラス関数内の `Function` および `Class constructor` ブロック外でのみ使用できます。 +`property` キーワードは、クラス関数において `Function` および `Class constructor` ブロック外でのみ使用できます。 ::: @@ -420,7 +420,7 @@ property fuzzy // バリアント :::note -宣言と同時に色かするプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: +宣言と同時に初期化するプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: ```4d // 共有クラス内 @@ -642,7 +642,7 @@ $val:=$o.f() //8 共有クラスは **共有関数** をサポートしています。共有関数は、[`Use...End use`](shared.md#useend-use) 構文なしで呼び出すことができます。 -クラスが共有クラスかどうかは、Classオブジェクトの .[`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 +クラスが共有クラスかどうかは、Classオブジェクトの [`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 :::info @@ -674,7 +674,7 @@ cs.Person.isShared // true 共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 -共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します 。例: +共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。例: ```4d //共有クラス Foo @@ -740,9 +740,9 @@ shared Function Bar($value : Integer) シングルトンを引数付きでインスタンス化する必要がある場合には、[`new()`](../API/ClassClass.md#new) 関数を呼び出すこともできます。この場合、アプリケーションの起動時に実行されるコードでシングルトンをインスタンス化することが推奨されます。 -クラスがシングルトンクラスかどうかは、Classオブジェクトの .[`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 +クラスがシングルトンクラスかどうかは、Classオブジェクトの [`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 -クラスがセッションシングルトンかどうかは、Classオブジェクトの .[`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 +クラスがセッションシングルトンかどうかは、Classオブジェクトの [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 ### 公開されたシングルトン関数 @@ -847,7 +847,7 @@ $myList := cs.ItemInventory.me.itemList ## `local` および `server` -[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) におていは、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 +[クライアント/サーバーアーキテクチャー](../Desktop/clientServer.md) においては、`local` および `server` キーワードを使用することで関数を実行する場所を指定することができます: クライアント側、またはサーバー側です。実行場所をコントロールすることは、パフォーマンス上の理由から、またビジネスロジック機能を実装する観点からも有用といえます。 シンタックスは次の通りです: @@ -929,7 +929,7 @@ End if ::: -`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) ストリーム可能でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 +`server` の関数の引数と戻り値は、[**ストリーム可能**](./dt_object.md#ストリーミングサポート) でなければなりません。例えば、[4D.Datastore](../API/DataStoreClass.md)、[File handle](../API/FileHandleClass.md)、あるいは [WebServer](../API/WebServerClass.md) などはストリーム不可能なクラスですが、 [4D.File](../API/FileClass.md) クラスはストリーム可能です。 この機能は、特に[リモートユーザーセッション](../Desktop/sessions.md#リモートユーザーセッション) のコンテキストにおいて有用で、これを使用することでビジネスロジックを[セッションシングルトン](../Concepts/classes.md#session-singleton) に実装することでセッションの全てのプロセス間でこれを共有することができ、結果として[`Session`](../commands/session) コマンドの機能を拡張することが可能になります。この場合、全てのセッション情報がサーバーに集められる様に、関連するビジネスロジックが**サーバー上で**実行されるようにしたい場合があるかもしれません。 @@ -944,7 +944,7 @@ End if - シングルトン *S1* はクライアント上でインスタンス化されます(名前は *s1* ) - *s1.function()* はクライアント上で実行されます。 -その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタン上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 +その時にサーバー上で *S1* のインスタンスが存在しない場合、*S1* はサーバー上でインスタンス化され(コンストラクターが実行されます)、*function()* 関数はサーバーインスタンス上で実行されます。結果として、それぞれ異なるプロパティ値をもつ、二つの *S1* のインスタンスが(クライアント側とサーバー側で)共存することが有り得ます。この場合、 *s1.property* は常にローカルにアクセス可能です。これはサーバーからはアクセスすることはできません。例えば、サーバー側のコードで直接ドット記法からアクセスするなどです(エラーが返されます)。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/components.md index 038574b53c76d9..5fc0c66422018e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/components.md @@ -3,7 +3,7 @@ id: components title: コンポーネント --- -4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 +4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルを表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 ## コンポーネントのインストール diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/data-types.md index 85cf87224117e2..6e460c6c1200fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/data-types.md @@ -7,25 +7,25 @@ title: データタイプの概要 この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: -| データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | -| ----------------------------------------------------- | -------------------------- | -------- | ------------------------ | ----------------------- | -| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | -| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | -| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | -| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | -| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | -| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | -| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | -| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | -| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | -| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | -| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | -| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | -| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | -| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | -| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | +| データタイプ | データベース (1) | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | +| ----------------------------------------------------- | ----------------------------- | -------- | ------------------------ | ----------------------- | +| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | +| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | +| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | +| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | +| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | +| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | +| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | +| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | +| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | +| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | +| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | +| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | +| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | +| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | +| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | (1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 @@ -38,7 +38,7 @@ title: データタイプの概要 以下のコマンドを使用することで、フィールドや変数の型を調べることができます: - フィールドやスカラー変数に対しては、[`Type`](../commands/type) コマンド -- 式対しては、[`Value type`](../commands/value-type) コマンド +- 式に対しては、[`Value type`](../commands/value-type) コマンド ## デフォルト値 @@ -63,7 +63,7 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的 な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_blob.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_blob.md index 9c3f9b36ab6164..f5c1e4961a9587 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_blob.md @@ -140,7 +140,7 @@ $type:= OB Instance of($myObject.blob; 4D.Blob) // true // 4D.Blob から スカラーBLOB への変換 $myBlob:= $myObject.blob -$type:= +$type:= Value type($myBlob) // Blob ``` > `4D.Blob` をスカラーBLOB に変換する際に、`4D.Blob` のサイズがスカラーBLOB の最大サイズを超える場合、結果のスカラーBLOB は空になります。たとえば、スカラーBLOB の最大サイズが 2GB の場合、2.5GB の `4D.Blob` をスカラーBLOB に変換すると、空の BLOB が得られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_boolean.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_boolean.md index a43fa87dd4188d..1db75d8479b445 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_boolean.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_boolean.md @@ -58,7 +58,7 @@ myBoolean:=(myButton=1) | false | true | true | | false | false | false | -**Tip:** 式1と式2の排他的結合子演算を実行する必要がある場合、次の評価式を使用します: +**Tip:** 式1と式2の排他的論理和を実行する必要がある場合、次の評価式を使用します: ```4d (Expr1|Expr2) & Not(Expr1 & Expr2) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_collection.md index 78edeeb2a3d3e3..81641dbb6f281d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_collection.md @@ -29,7 +29,7 @@ collectionRef[expression] $myVar:=myCol[0] ``` -コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます: +コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられます: ```4d var myCol : Collection @@ -105,14 +105,14 @@ $users:=[{name: "Alice"; \ 二種類のコレクションを作成することができます: -- [`New collection`](../../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared collection`](../../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 +- [`New collection`](../commands/new-collection) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared collection`](../commands/new-shared-collection) コマンドを使用して作成する共有コレクション。共有コレクションはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例' `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +コレクションと[オブジェクト](./dt_object.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へコレクションを代入する場合(例: `$myVar:=[1;2;3]`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のコレクションが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -233,7 +233,7 @@ var $c3:=$c1 // 同じインスタンスへの参照 :::note -Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md##blob-の自動変換) され、またその逆も然りです。 +Blob オブジェクト(4D.Blob) は、必要であれば[自動的にスカラーBlob へと変換](dt_blob.md#blob-の自動変換) され、またその逆も然りです。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_date.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_date.md index f2a035f22c1012..0ea510888eaa2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_date.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_date.md @@ -11,7 +11,7 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付リテラル -日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) 下記に、日付定数の例を示します: +日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) を使って記述します。下記に、日付定数の例を示します: ```4d !1976-01-01! @@ -30,23 +30,23 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付演算子 -| 演算 | シンタックス | 戻り値 | 式 | 値 | -| ----- | ------------------------------------- | ------- | --------------------------- | ------------ | -| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | -| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | -| 日付の減算 | Date – Number | Date | !2017-01-20! !2017-01-20! | !2017-01-11! | -| 等しい | Date = Date | Boolean | !2017-01-20! = !2017-01-01! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 異なる | Date # Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 大きい | Date > Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 小さい | Date < Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 以上 | Date >= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-01!>=!2017-01-20! | false | -| 以下 | Date <= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | +| 演算 | シンタックス | 戻り値 | 式 | 値 | +| ----- | ------------------------------------- | ------- | ----------------------------------------------------- | ------------ | +| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | +| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | +| 日付の減算 | Date – Number | Date | !2017-01-20! - 9 | !2017-01-11! | +| 等しい | Date = Date | Boolean | !2017-01-20! =!2017-01-20! | true | +| | | | !2017-01-20! = !2017-01-01! | false | +| 異なる | Date # Date | Boolean | !2017-01-20! # !2017-01-01! | true | +| | | | !2017-01-20! # !2017-01-20! | false | +| 大きい | Date > Date | Boolean | !2017-01-20! > !2017-01-01! | true | +| | | | !2017-01-20! > !2017-01-20! | false | +| 小さい | Date < Date | Boolean | !2017-01-20! < !2017-01-20! | true | +| | | | !2017-01-20! < !2017-01-20! | false | +| 以上 | Date >= Date | Boolean | !2017-01-20! >=!2017-01-01! | true | +| | | | !2017-01-01!>=!2017-01-20! | false | +| 以下 | Date <= Date | Boolean | !2017-01-20! <= !2017-01-20! | true | +| | | | !2017-01-20! <= !2017-01-01! | false | ## JavaScriptからの日付の変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_null_undefined.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_null_undefined.md index 00cb15c3e76501..cea54a9eeece33 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_null_undefined.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_null_undefined.md @@ -23,7 +23,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ フィールドは、未定義にはできません (フィールドの場合、`Undefined` コマンドは常に False を返します)。 -未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。 ただし以下の場合には生成されません: +未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。ただし以下の場合には生成されません: - 未定義の値を(配列を除く)変数に代入することは、変数に対して[`CLEAR VARIABLE`](../commands/clear-variable) を呼び出すのと同じ効果があります: @@ -41,7 +41,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ - ブール: False - 文字列: "" - 数値: 0 - - 日付: 日付: 日付: 日付: 日付: 日付: "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" + - 日付: !00-00-00! "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" - 時間: 0 (ミリ秒単位) - 未定義、Null: 変化なし @@ -51,7 +51,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ $o.a:=$o.b //$o.a=0 ``` -- 未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +- 未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 - 未定義の値を引数としてプロジェクトメソッドに渡した場合、宣言された引数の型に応じて、0 あるいは "" (空の文字列) へと自動変換されます。 @@ -97,7 +97,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ | | Null `#` Undefined | Boolean | a.nullProp `#` b.undefinedProp | false | | | Null `#` *scalar value* | Boolean | a.nullProp `#` 42 | true | -*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でもnull でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: +*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でも null でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: ```4d var $object : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_number.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_number.md index c5b5eb5fb1e708..d41770f6dc818a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_number.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_number.md @@ -71,7 +71,7 @@ title: Number (実数、整数) - 10 % 2は、0を返します。 10 は 2 で割り切れるからです。 - 10 % 3は、1を返します。 余りが 1 だからです。 -- 10.5 % 2は、0を返します。 余りが整数ではない (0.25) からです。 +- 10.5 % 2は、0を返します。 余りが整数ではない (0.5) からです。 :::warning @@ -85,7 +85,7 @@ title: Number (実数、整数) ### 実数の比較 -2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 +2つの実数が等しいかどうかを比較するために、4Dランゲージは実際には差の絶対値を *イプシロン値* と比較します。詳細に関しては[`SET REAL COMPARISON LEVEL`](../commands/set-real-comparison-level) コマンドを参照してください。 :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_object.md index 539c6959bafc90..10cfa0a615b6ff 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_object.md @@ -18,7 +18,7 @@ title: Object - ピクチャー(2) - collection -(1) [\*\* ストリーム不可能なオブジェクト\*\*](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 +(1) [**ストリーム不可能なオブジェクト**](#ストリーミングサポート) である [エンティティ](ORDA/dsMapping.md#エンティティ) や [エンティティセレクション](ORDA/dsMapping.md#エンティティセレクション) などの ORDAオブジェクト、[FileHandle](../API/FileHandleClass.md)、[Webサーバー](../API/WebServerClass.md)... は **オブジェクトフィールド** には保存できません。保存しようとするとエラーが返されます。しかし、メモリ内の **オブジェクト変数** に保存することは可能です。 (2) デバッガー内でテキストとして表示したり、JSON へと書き出されたりした場合、ピクチャー型のオブジェクトプロパティは "[object Picture]" と表されます。 @@ -53,7 +53,7 @@ title: Object ### `New object` コマンド -[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規コレクションを作成し、その参照を返します。 +[`New object`](../commands/new-object) コマンドは、空の、あるいは値の入った新規オブジェクトを作成し、その参照を返します。 例: @@ -110,12 +110,12 @@ $col:=$o.col[5] // 6 二種類のオブジェクトを作成することができます: -- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) コレクション。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有コレクション。共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 +- [`New object`](../commands/new-object) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) オブジェクト。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 +- [`New shared object`](../commands/new-shared-object) コマンドを使用して作成する共有オブジェクト。共有オブジェクトはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## 代入 -オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例' `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 +オブジェクトと[コレクション](./dt_collection.md) データ型は、スカラーデータ型(数値、日付、など)とは異なり、4D ランゲージ内においては**参照** (つまり内部的なポインター) を通して管理されます。結果として、変数へオブジェクトを代入する場合(例: `$myVar:={ a:2 }`)、代入されているのは値自身ではなく、**参照** が代入されています。そのため *$myVar* 変数にそのあと加えた変更は、元のオブジェクトが参照されている箇所全てにおいて反映されてしまうことになります。これは[ポインター](./dt_collection.md) と同じ原理に基づいていますが、*$myVar* 変数は逆参照する必要がないという点において異なります。 例: @@ -213,7 +213,7 @@ ASSERT($o1=$o2) // True ### Null 値 -オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。 例: +オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。例: ```4d myObject.address.zip:=Null @@ -224,7 +224,7 @@ ASSERT($o1=$o2) // True ### 未定義の値 -オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 詳細については [Null と 未定義](dt_null_undefined.md) を参照ください。 @@ -305,7 +305,7 @@ $doc:=Null // $docが占有するリソースを解放します しかしながら、オブジェクトのテキストストリーミングには、以下の様な制約があります: -- 循環参照(自分自身をプロパティとして格納してるオブジェクト)はサポートされおらず、エラーを返します +- 循環参照 (自分自身をプロパティとして格納してるオブジェクト) はサポートされておらず、エラーを返します - クラスのオブジェクトは文字列化した際にどのクラスであるかという情報は失われます - [Entity](../API/EntityClass.md) などのネイティブな4D クラスオブジェクトはJSON として表現はできず、"[object \]" と返されます。例: "[object Entity]" diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_picture.md index d401064c25c817..c4e4dfa184132b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_picture.md @@ -32,8 +32,8 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを | -------- | ------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 水平連結 | Pict1 + Pict2 | Picture | Pict1 の右側に Pict2 を追加します | | 垂直連結 | Pict1 / Pict2 | Picture | Pict1 の下側に Pict2 を追加します | -| 排他的論理和 | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | -| 包括的論理和 | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | +| 排他的重ね合わせ | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | +| 包括的重ね合わせ | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | | 水平移動 | Picture + Number | Picture | 指定ピクセル分、ピクチャーを横に移動します。 | | 垂直移動 | Picture / Number | Picture | 指定ピクセル分、ピクチャーを縦に移動します。 | | リサイズ | Picture \* Number | Picture | 割合によってピクチャーをサイズ変更します。 | @@ -70,7 +70,7 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを ![](../assets/en/Concepts/concatVer.en.png) ![](../assets/en/Concepts/concatVer2.en.png) -排他的論理和 +排他的重ね合わせ ```4d Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 @@ -78,7 +78,7 @@ Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 ![](../assets/en/Concepts/superimpoExc.fr.png) -包括的論理和 +包括的重ね合わせ ```4d Pict3:=Pict1|Pict2 // 同じサイズの二つのピクチャーを重ね合わせた上でそのマスクの結果を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_pointer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_pointer.md index 50ae7d97a89de3..8997c5db04196c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_pointer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_pointer.md @@ -3,7 +3,7 @@ id: pointer title: Pointer --- -ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、またはフィールドへの参照です。ポインタータイプのフィールドは、存在しません。 +ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、フィールド、またはオブジェクトへの参照です。ポインタータイプのフィールドは、存在しません。 ポインターは、(プログラミングにおける) データを参照するための高度な方法を提供します。 4D ランゲージ使用時にテーブル・フィールド・変数・配列等にアクセスするには、単純に名前を用います。ですが、名前を使用しないでデータを参照する、またはアクセスした方が便利な場合もあります。ポインターを使うとこれが実現できます。 @@ -47,7 +47,7 @@ $MyPointer-> 前述の式は、"Hello" という文字列を返します。ポインター記号 (->) をポインターの後につけると、参照先の値を取得することができます。これをデリファレンス (参照外し) と呼びます。 -ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、オリジナルの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: +ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、もとの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: ```4d ALERT($MyPointer->) @@ -59,7 +59,7 @@ $MyPointer を使用して $MyVar の値を変更することもできます。 $MyPointer->:="Goodbye" ``` -この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。 両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: +この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: ```4d ALERT($MyPointer->) @@ -154,7 +154,7 @@ $FieldPtr:=Field(1;2) OBJECT SET FONT($FieldPtr->;"Arial") ``` -### 変数へのポインター +### ローカル変数へのポインター プロセス変数またはローカル変数のポインターを使う場合、参照される変数はポインターが使用される時点ですでに定義されていなければなりません。ローカル変数は、それらを作成したメソッドの実行が終わると破棄され、プロセス変数もそれを作成したプロセスの終了時に削除される点に留意してください。存在しない変数をポインターで呼び出そうとすると、インタープリターモードでは (「変数が設定されていません」という内容の) シンタックスエラーが起きます。コンパイルモードでは、さらに重大なエラーが発生する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_string.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_string.md index 22aa6f7cc67387..3d357f5aba0a4a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_string.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_string.md @@ -10,7 +10,7 @@ title: String ## 文字列リテラル -文字列リテラル定数は、次のように二重引用符 ("...") 文字列定数の例を次に示します: +文字列リテラル定数は、次のように二重引用符 ("...") で囲んで表します。文字列定数の例を次に示します: ```4d "レコード追加" @@ -24,21 +24,21 @@ title: String 以下のエスケープシーケンスを文字列内で使用できます: -| エスケープシーケンス | 意味する文字 | -| ---------- | --------------------------- | -| \n | LF (行送り) | -| \t | HT (タブ) | -| \r | CR (改行) | -| \\\\ | | -| \\" | " (引用符) | +| エスケープシーケンス | 意味する文字 | +| --------------------------------------- | --------------------------- | +| \n | LF (行送り) | +| \t | HT (タブ) | +| \r | CR (改行) | +| \\\\|\ (バックスラッシュ) | | +| \\" | " (引用符) | -**注:** \ (バックスラッシュ) は Windows でパス名の区切り文字として使用されています。しかし “C:\MyDocuments\New” と入力した場合、4Dは二番目のバックスラッシュは "\N" (行送り) と解釈してしまい、“C:\\\MyDocuments\New”を表示します。 このようなケースでは開発者がバックスラッシュを2つ入力するようにしなければなりません。 +**注:** \ (バックスラッシュ) は Windows ではパス名の区切り文字としても使用されています。そのため、パス名において、4D のエスケープシーケンスで使用される文字の前にバックスラッシュを挿入したいときは、\\\ のようにバックスラッシュを 2つ入力しなければなりません (例: "\N" (行送り) と解釈されないよう、"C:\\\MyDocuments\\\New.txt" と表します)。 ### 行末の自動正規化 データベース内で管理されているテキストが複数のプラットフォームで正常に処理されるようにするため、4D は改行文字を自動的に正規化し、それらが単一の文字( `\r` 、キャリッジリターン)に収まる様にします。この正規化は、標準テキストまたはマルチスタイルテキストをホストするフォームオブジェクト(変数またはフィールド)レベルにおいて実行されます。ネイティブではない改行文字、あるいは複数の改行文字の混用(例えば `\r\n` など)は、単一の `\r` とみなされます。なお、XML 標準(マルチスタイルテキストフォーマット)に準拠するため、[スタイル付きテキストコマンド](../commands/theme/Styled_Text.md) は、オブジェクトに割り当てられていないテキスト変数の行末文字も正規化するという点に注意してください。 -この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが用意になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を公領する必要があります。 +この原則により、マルチプラットフォームのコンテキストにおいて[`HIGHLIGHT TEXT`](../commands/highlight-text) などのマルチスタイルテキスト系のコマンドを使用するのが容易になります。ただし、様々な異なるソースからのテキストを処理しようとする場合には、この原則を考慮する必要があります。 ## 文字列演算子 @@ -64,7 +64,7 @@ title: String ## 文字列比較の詳細 - 文字列は文字ごとに比較されます (後述の [キーワード](dt_string.md#キーワード) による検索の場合を除きます)。 -- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +- 文字列が比較されるとき文字の大小文字は無視されます。したがって、"a"="A"は `true` を返します。大文字と小文字を区別して比較するには、文字コードで比較してください。たとえば、次の式は `FALSE` です: ```4d Character code("A")=Character code("a") @@ -90,7 +90,7 @@ Character code("A")=Character code("a") "abcdefghij"="abc@" ``` -一方、どのような場合でも、ワイルドカードを 2つ連続して使用した文字列比較は常に FALSE を返します。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: +ただし、複数の文字を比較する目的のワイルドカード記号は、比較演算子の右側の式で使用しなければなりません。比較演算子の左側の式においては、"@" は単なる文字であると解釈されます。たとえば、次の式は `FALSE` です: ```4d "abc@"="abcdefghij" @@ -128,7 +128,7 @@ Character code("A")=Character code("a") 以下のようにすると、式は意図したように評価されます: ```4d -(Character code($vsValue[[Length($vsValue)]])=64) +(Character code($vsValue[[Length($vsValue)]])#64) ``` **注:** ストラクチャー設定のデータベースページには、文字列に @ 記号が含まれているとき、それをどう解釈するかを指定するオプションが提供されています。 @@ -184,7 +184,7 @@ End if ### 無効な文字列参照に関する注意 -文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。 +文字列参照記号を使用する際、配列に存在する要素を指定するのと同じ要領で、文字列内に存在する文字を指定しなければなりません。たとえば、文字列変数の20番目の文字を参照する場合、この変数は必ず、少なくとも20文字以上の長さがなくてはなりません。長さが足りない場合: - インタープリターモードでは構文エラーは発生しません。 - コンパイルモードで範囲チェックオプションを無効にしている場合には、メモリ領域を破壊するおそれがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_time.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_time.md index 0d04c4a95edf86..4b731c331977bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_time.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_time.md @@ -7,7 +7,7 @@ title: Time 時間は 24時間制です。 -時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す総秒数です。 +時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す深夜0時からの総秒数です。 **注:** *4Dランゲージリファレンス* マニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。 @@ -25,7 +25,7 @@ title: Time ?13:01:59? // 午後1時1分59秒 ``` -空の時間は、?00.00.00? のように指定します。 +空の時間は、?00:00:00? のように指定します。 **Tip:** コードエディターでは空の時間を入力するためのショートカットが提供されています。空の時間を入力するには、疑問符 (?) の入力後に Enterキーを押します。 @@ -34,26 +34,26 @@ title: Time | 演算 | シンタックス | 戻り値 | 式 | 値 | | --------------------------- | ------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | 加算 (足し算) | Time + Time | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? | -| 減算 (引き算) | Time – Time | Time | ?02:03:04? ?01:02:03? | ?01:01:01? | +| 減算 (引き算) | Time – Time | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? | | 加算 (足し算) | Time + Number | Number | ?02:03:04? + 65 | 7449 | -| 減算 (引き算) | Time – Number | Number | ?02:03:04? ?01:02:03? | 7319 | -| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? ?01:02:03? | 14768 | -| 除算 (割り算) | Time / Number | Number | ?02:03:04? ?01:02:03? | 3692 | -| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? ?02:03:04? | 3692 | +| 減算 (引き算) | Time – Number | Number | ?02:03:04? – 65 | 7319 | +| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? \* 2 | 14768 | +| 除算 (割り算) | Time / Number | Number | ?02:03:04? / 2 | 3692 | +| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? \ 2 | 3692 | | モジューロ | Time % Time | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? | | モジューロ | Time % Number | Number | ?02:03:04? % 2 | 0 | -| 等しい | Time = Time | Boolean | ?01:02:03? >=?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 異なる | Time # Time | Boolean | ?01:02:03? ?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 大きい | Time > Time | Boolean | ?01:02:03? > ?01:02:03? | true | +| 等しい | Time = Time | Boolean | ?01:02:03? = ?01:02:03? | true | +| | | | ?01:02:03? = ?01:02:04? | false | +| 異なる | Time # Time | Boolean | ?01:02:03? # ?01:02:04? | true | +| | | | ?01:02:03? # ?01:02:03? | false | +| 大きい | Time > Time | Boolean | ?01:02:04? > ?01:02:03? | true | | | | | ?01:02:03? > ?01:02:03? | false | | 小さい | Time < Time | Boolean | ?01:02:03? < ?01:02:04? | true | | | | | ?01:02:03? < ?01:02:03? | false | | 以上 | Time >= Time | Boolean | ?01:02:03? >=?01:02:03? | true | | | | | ?01:02:03? >=?01:02:04? | false | | 以下 | Time <= Time | Boolean | ?01:02:03? <=?01:02:03? | true | -| | | | ?01:02:03? <=?01:02:03? | false | +| | | | ?01:02:04? <=?01:02:03? | false | ### 例題 1 @@ -78,7 +78,7 @@ $vhSoon:=Time(Current time+3600) ### 例題 2 -モジューロ演算子を使用できます。 とくに24時間フォーマットを考慮した時間の追加に便利です: +モジューロ演算子を使用できます。とくに24時間フォーマットを考慮した時間の追加に便利です: ```4d $t1:=?23:00:00? // 23時です diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_variant.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_variant.md index d987830b9a641f..c2279417430f47 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_variant.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/dt_variant.md @@ -37,7 +37,7 @@ $vtype:=Type($variant) // 12 (Is variant) $vtypeVal:=Value type($variant) // 1 (Is real) ``` -変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。 ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: +変数が期待されるところであれば、どこでもバリアント型変数を使用することができます。ただし、変数の中身のデータ型は予期される型でなくてはなりません。また、バリアント型変数を使う場合、その時点で変数に格納されている値のみが実質的に使われます。例: ```4d C_VARIANT($v) @@ -48,7 +48,7 @@ $t:=Type($v) // 12 (Is variant) 代入元の変数はバリアント型ですが $t2:=Type($v2) // 2 (Is text) 代入先の変数はテキスト型です ``` -バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) この場合、引数の値の型の確認作業が必要になります: +バリアント型は、様々なタイプになりうる [メソッドの引数](parameters.md) ($0, $1,...) を宣言するのに使用できます。この場合、引数の値の型の確認作業が必要になります: ```4d #DECLARE ($param : Variant) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/error-handling.md index 7db089561d8327..4ac97bc4d102a5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/error-handling.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/error-handling.md @@ -23,9 +23,9 @@ title: エラー処理 ## 予測可能なエラーvs予測不可能なエラー {#predictable-vs-unpredictable-errors} -[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドを実装する) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 +[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドの実装) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 -もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、プロパティに値(例: `dk status serious error` - "その他のエラー")も返すことがあり得るという点に注意してください。 +もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors) のコレクションに含まれます。深刻なエラーは、`status` と `statusText` プロパティに値 (例: `dk status serious error` - "その他のエラー") を返すこともあり得るという点に注意してください。 ## エラー処理メソッドの実装 @@ -45,7 +45,7 @@ ON ERR CALL("IO_Errors";ek local) // ローカルなエラー処理メソッド ON ERR CALL("";ek local) // ローカルプロセスにおいてエラーの検知を中止します ``` -[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。 エラー処理メソッドを一時的に変更し、後で復元することができます: +[`Method called on error`](../commands/method-called-on-error) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。エラー処理メソッドを一時的に変更し、後で復元することができます: ```4d $methCurrent:=Method called on error(ek local) @@ -98,7 +98,7 @@ ON ERR CALL("componentHandler";ek errors from components) // コンポーネン ::: - [`Last errors`](../commands/last-errors) コマンドは4D アプリケーション内で発生したエラーのカレントのスタックのコレクションを返します。 -- the [`Call chain`](../commands/call-chain) command that returns a collection of objects describing each step of the method call chain within the current process. +- [`Call chain`](../commands/call-chain) コマンドは、カレントプロセス内におけるメソッド呼び出しチェーンの各ステップを説明するオブジェクトのコレクションを返します。 #### 例題 @@ -229,7 +229,7 @@ End try - エラーがスローされなかった場合には、対応する `End try` キーワードの後へとコード実行が継続されます。 `Catch` と `End try` キーワード間のコードは実行されません。 - コードブロックの実行が *非遅延エラー* をスローした場合、実行フローは停止し、対応する `Catch` コードブロックを実行します。 -- コードブロックが *非遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 +- コードブロックが *遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 - 遅延エラーが `Try` ブロックから直接スローされた場合、実行フローは `Try` ブロックの終わりまで継続し、対応する `Catch` ブロックは実行しません。 :::note @@ -290,14 +290,14 @@ Function createInvoice($customer : cs.customerEntity; $items : Collection; $invo コード実行を妨げる例外は4D によって返されますが、その原因はOS、デバイス、4D カーネル、コード内の[`throw`](../commands/throw) など、様々な要因が考えられます。そのため、3つの要素によって定義されます: - **コンポーネント署名**。エラーの起きた場所を表します(署名の一覧については[`Last errors`](../commands/last-errors) を参照してください) -- **メッセージ**。エラーがなぜ起きたかを説明します。 +- **メッセージ**。エラーがなぜ起きたかを説明します - **コード**。コンポーネントによって返される任意の数値です。 エラーと特にその原因の完全な詳細を取得するには、[4D エラーダイアログボックス](../Debugging/basics.md) あるいは[`Last errors`](../commands/last-errors.md) コマンドを使用することができます。 ### エラーダイアログボックス -[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボランをクリックします: +[4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**詳細** エリアを展開し、**保存...** あるいは **コピー** ボタンをクリックします: ![copy-button](../assets/en/Concepts/error.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/flow-control.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/flow-control.md index ad3bb638ee730b..b7eecdc650fcb9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/flow-control.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/flow-control.md @@ -7,7 +7,7 @@ title: 制御フロー - **シーケンシャル**: シーケンシャル構造は単純な線形構造です。シーケンスとは、4Dが最初から最後まで次々に実行する一連のステートメントです。オブジェクトメソッドで頻繁に使用される1行から成るルーチンはもっとも簡単なシーケンシャル構造の例です。例: `[People]lastName:=Uppercase([People]lastName)` - **分岐**: 分岐構造は、条件をテストし、その結果に基づいて異なる流れにメソッドを導きます。条件は true または false に評価されるブール式です。 [`If...Else...End if`](#ifelseend-if) 構文は分岐構造の一例で、処理フローを二つに分岐します。 [`Case of...Else...End case`](#case-ofelseend-case) 構文も分岐構造の一つで、処理フローをもっとたくさん分岐することができます。 -- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これに実現するために、4D は以下のループ構造を備えています: +- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これを実現するために、4D は以下のループ構造を備えています: - [`While...End while`](#whileend-while) - [`Repeat...Until`](#repeatuntil) @@ -16,7 +16,7 @@ title: 制御フロー ループを制御する方法には、条件が満たされるまでループする方法と、指定した回数だけループする方法の2通りがあります。各ループ構造はいずれの方法にも用いることができますが、`While` ループと `Repeat` ループは条件が満たされるまで繰り返す場合に、`For` ループは指定した回数だけループする場合の利用に適切です。 `For each...End for each` ループは両方を組み合わせることが可能で、オブジェクトやコレクション内でループするために設計されています。 -**注:** 4Dはプログラム構造 (If/While/For/Caes of/Repeat/For each) を512レベルまで入れ子で記述できます。 +**注:** 4Dはプログラム構造 (If/While/For/Case of/Repeat/For each) を512レベルまで入れ子で記述できます。 ## If...Else...End if @@ -268,7 +268,7 @@ vResult = 1の判定により他の条件を見る前に分岐するので、第 一般に、`While...End while` ループに入る手前で、ブール式で判定する値を初期化しておきます。値を初期化するとは適切な値に設定するということで、通常はブール式が true になるように設定してからループに入ります。 -ブール式は、ループ内の要素を使って設定されなければなりません。 そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 +ブール式は、ループ内の要素を使って設定されなければなりません。そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 ```4d NeverStop:=True @@ -309,7 +309,7 @@ Until(Boolean_Expression) #### 例題 -以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数　`OK` を初期化する `CONFIRM` コマンドはありません。 +以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数 `OK` を初期化する `CONFIRM` コマンドはありません。 ```4d Repeat @@ -375,7 +375,7 @@ End for End for ``` -4. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +4. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d FIRST RECORD([aTable]) @@ -424,7 +424,7 @@ End for End for ``` -8. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +8. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d LAST RECORD([aTable]) @@ -552,7 +552,7 @@ End for End for each ``` -`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の \*Expression \* を対象に反復処理をおこなうことができます: +`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の *Expression* を対象に反復処理をおこなうことができます: - コレクション: コレクションの各要素をループします - エンティティセレクション: 各エンティティをループします diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/identifiers.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/identifiers.md index 59353fc439a0af..8437bd7d41b2fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/identifiers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/identifiers.md @@ -75,7 +75,7 @@ Function getArea($width : Integer; $height : Integer)-> $area : Integer - 1文字目は、文字、数字、あるいはアンダースコア(_) でなければなりません。 - その後の文字には、文字・数字・アンダースコア(_)・スペースが使用できます。 - 予約語を使用しないでください。予約語にはコマンド名 (`Date`, `Time` 等)、キーワード (`If`, `For` 等)、そして定数 (`Euro`, `Black`, `Friday` 等) が含まれます。 -- 大文字・小文字は区別されます。 +- 大文字・小文字は区別されません。 例: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/interpreted.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/interpreted.md index 168d45256e64a6..36d3d5fe595e29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/interpreted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/interpreted.md @@ -27,7 +27,7 @@ title: インタープリターモードとコンパイル済みモード | 変数や配列のデータタイプは変更できません。 | 変数や配列のデータタイプは変更可能です (推奨されません) | | 1次元配列を2次元配列に、また2次元配列を1次元配列に変更することはできません。 | 可能です。 | | コンパイラーにより変数のタイプ定義はおこなわれますが、フォーム上の変数のようにデータタイプが明確でない場合は、宣言によって変数のデータタイプを指定するべきです。 | | -| `Undefined` 関数は、常に False を返します。 変数は常に定義されています。変数は常に定義されています。 | | +| `Undefined` 関数は、常に False を返します。変数は常に定義されています。 | | | メソッドの "プリエンプティブプロセスで実行可能" プロパティにチェックを入れていた場合、コードは他のスレッドアンセーフなコマンドやメソッドを呼び出してはいけません。 | プリエンプティブプロセスプロパティは無視されます。 | | 特定のループの場合、割り込みを可能にするには `IDLE` コマンドが必要です。 | いつでも割り込み可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/methods.md index 6fceb51a31e39a..6779385e1814af 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/methods.md @@ -5,7 +5,7 @@ title: メソッド メソッドとは、1つ以上の動作を実行するコードのことです。メソッドは、1つ以上のステートメントで構成されます。 -ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する) することができます。 +ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する)することができます)。 メソッドは最大 2GBのテキストまたは、32000行まで記述できます。 @@ -17,14 +17,14 @@ title: メソッド | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **プロジェクトメソッド** | プロジェクトメソッド名が[呼び出された時](../Project/project-method-properties.md) に応じて | ◯ | 任意のアクションを実行するためのコードです。作成されたプロジェクトメソッドは、そのプロジェクトのランゲージの一部となります。 | | **オブジェクト (ウィジェット) メソッド** | メソッドが設定されたフォームオブジェクトに関連したイベント発生時に | × | フォームオブジェクト (ウィジェットとも呼びます) のプロパティです。 | -| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | +| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | | **トリガー** (別名 *テーブルメソッド*) | テーブルのレコード操作 (追加・削除・修正) の度に | × | テーブルのプロパティです。トリガーは、データベースのレコードに対して「不正な」操作がおこなわれることを防ぎます。 | | **データベースメソッド** | 作業セッションのイベント発生時に | ○ (既定) | 4D には 16のデータベースメソッドがあります。 | | **クラス** | クラスのオブジェクトがインスタンス化されたとき、あるいは他のメソッドや[データベースフィールド](../Develop/field-properties.md#class) 内においてオブジェクトインスタンス上でクラスの関数が実行されたときに自動的に呼び出されます。 | ◯(クラス関数) | オブジェクトのクラスの[constructor](./classes.md#class-constructor), [properties](./classes.md#property) と[関数](./classes.md#function) を宣言および設定するためには、**Class** が使用されます。[**クラス**](classes.md) および[**Function** クラス](../API/FunctionClass.md) 参照。 | ## ランゲージトークン -4Dランゲージでは、コード内で使用される全てのオブジェクト名(定数、コマンド、テーブル、フィールドそしてキーワード) 全てに対してユニークな トークナイゼーションシステムというものを持っています。これらの名前をトークナイズするということは、それらをコードエディターにタイプする際に内部で絶対参照 (数値) として保存され、実行時、あるいは表示時にコンテキストに応じてテキストとして復元されるということを意味します。これにより、コードは常に正しく解釈されるということが保証され、テーブルやフィールドの名前を変更した場合でも、4Dランゲージコマンドが異なるアプリケーションのバージョンに置いて改名された場合等でも正しく解釈されます。 +4Dランゲージでは、コード内で使用される全てのオブジェクト名(定数、コマンド、テーブル、フィールドそしてキーワード) 全てに対してユニークな トークナイゼーションシステムというものを持っています。これらの名前をトークナイズするということは、それらをコードエディターにタイプする際に内部で絶対参照 (数値) として保存され、実行時、あるいは表示時にコンテキストに応じてテキストとして復元されるということを意味します。これにより、コードは常に正しく解釈されるということが保証され、テーブルやフィールドの名前を変更した場合でも、4Dランゲージコマンドが異なるアプリケーションのバージョンにおいて改名された場合等でも正しく解釈されます。 **注意:** これは環境設定のメソッドページの["リージョンシステム設定を使用"オプション](../Preferences/methods.md#4dプログラミングランゲージ-リージョンシステム設定を使う) を有効化し、お使いの4D を異なる言語設定でデータベースを開いた際にも、コードの自動翻訳が正確であることを保証します。 @@ -48,7 +48,7 @@ title: メソッド ### トークンシンタックス -式の中でトークナイズ可能な名前付き要素に対して、4D はトークンを直接参照するための特別な信託巣を提供しています。要素名の後に型(コマンド、フィールド、など)を指定する特定の接頭辞を追加し、そのあとに参照を追加します。以下の表にこのトークンシンタックスについての詳細がまとめてあります: +式の中でトークナイズ可能な名前付き要素に対して、4D はトークンを直接参照するための特別なシンタックスを提供しています。要素名の後に型(コマンド、フィールド、など)を指定する特定の接頭辞を追加し、そのあとに参照を追加します。以下の表にこのトークンシンタックスについての詳細がまとめてあります: | 機能 | 使用例(標準のシンタックス) | 接尾辞 | 使用例(トークンシンタックス) | コメント | | -------- | ------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | @@ -58,7 +58,7 @@ title: メソッド | フィールド | [Employees]Name | :xx | [Employees:1]Name:2 | xx はフィールド番号です | | 4D プラグイン | PV PRINT(area) | :Pxx:yy | PV PRINT:P13000:229(area) | xx はプラグインIDで、yy はコマンドのインデックスです | -**注意:** 接頭辞には大文字(C, P)を使用しなければなりません。そうでない場合には正常に解釈されません。 +**注意:** 接尾辞には大文字 (C, P) を使用しなければなりません。そうでない場合には正常に解釈されません。 このシンタックスを使用することにより、フォーミュラの名前が変更された場合でも、データベースが異なる言語において実行された場合でも、フォーミュラが正しく解釈される事を保証します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/operators.md index 1baedda0c29499..aa24982323112d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: -- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 -- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#ternary-operator) (a ? b : c\\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2 + 3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#三項演算子) (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -24,7 +24,7 @@ title: 演算子 $myNumber:=3 // 3 を $myNumber 変数に代入 $myDate:=!2026/01/21! // 日付リテラルを代入 $myLength:=Length("Acme") // コマンドの結果(4) を $myLength に代入 -$col:=New collection //$col をからのコレクションで初期化 +$col:=New collection //$col を空のコレクションで初期化 $myObject:={ a:2 ; b:$col } // オブジェクト参照を $myObject に代入 $myObject.a:=3 // オブジェクトプロパティに値を代入 ``` @@ -97,7 +97,7 @@ $a+=2 // $a=3 - オブジェクトプロパティあるいはコレクション要素としてのピクチャー - 配列のインデックス変数 -"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()-+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 +"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()->+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 > [テキストの文字インデックス](dt_string.md#文字参照記号) および [BLOB のバイトインデックス](dt_blob.md#スカラーblob-のバイトへのアクセス) では、これらの演算子はサポートされません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/ordering.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/ordering.md index 85480bfae8c0c4..c2ef7b7780de6c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/ordering.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/ordering.md @@ -1,17 +1,17 @@ --- id: ordering -title: コレクションとオブジェクトの並び替え +title: コレクションとオブジェクトの並べ替え --- 一連のデータをソートするために、4D はデータの型に応じて定義された比較条件を適用することで、それぞれの値を他の値と比較します([並べ替えルール](#並べ替えルール) を参照してください)。このプロセスは全ての要素に渡って総合的な並べ替えを確立するためのソートアルゴリズムに依存しています。全てのデータが同じ [データ型](./data-types.md) に所属している場合、比較ルールは単純で正確に定義されています。 -しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は戦略的な並べ替えスキームを適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 +しかしながら、[コレクション](./dt_collection.md) および [entity selections](../ORDA/dsMapping.md#エンティティセレクション) も含めた [オブジェクト](./dt_object.md) は異種の型の要素や属性を格納することが可能です: これにはスカラー型(テキスト、数値、ブール、日付、) あるいは複雑型(オブジェクト、Blob、コレクション) が含まれます。異なる種類の値を格納しているコレクションやオブジェクトの並べ替えをする場合、4D は階層化された並べ替え方式を適用します。まず最初に要素を型ごとに並べ替えし、その次に各型ごとの中で比較ルールを適用します。 ## 並べ替え機能 4D ランゲージには、コレクション要素、オブジェクト属性をソートしたり、あるいは順序づけされた結果のためのソートを作成することに依存する複数の機構を提供します: -- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (明示的なキーと並べ替え指定を使用した複数条件並べ替え)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによる並べ替え)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な並べかリレーションによるインプレースなソート) +- **コレクションの並べ替え用関数**: [`collection.multiSort()`](../API/CollectionClass.md#multisort) (キーと順序を明示的に指定する多条件ソート)、[`collection.orderBy()`](../API/CollectionClass.md#orderby) (各要素に対して式を評価することによるソート)、 [`collection.sort()`](../API/CollectionClass.md#sort) (自然な順序関係によるインプレースなソート) - **エンティティセレクションの並べ替え用関数**: [`entitySelection.orderBy()`](../API/EntitySelectionClass.md#orderby)、コレクションと同じ並べ替えルールを適用します。 - **並べ替え付きのクエリ関数**: [`entitySelection.query()`](../API/EntitySelectionClass.md#query)、 [`dataClass.query()`](../API/DataClassClass.md#query) に対して `order by attributePath` キーワードを使用すると決定的な順序で結果を返します。 - **順序依存の統計関数**: [`collection.max()`](../API/CollectionClass.md#max)、 [`collection.min()`](../API/CollectionClass.md#min)、 [`entitySelection.max()`](../API/EntitySelectionClass.md#max)、 [`entitySelection.min()`](../API/EntitySelectionClass.md#min)、 これらは極値を識別するために順序関係に依存します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/parameters.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/parameters.md index f5a7b17e67088b..4fa0cc4a54af31 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/parameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/parameters.md @@ -19,7 +19,7 @@ ALERT("Hello") $area:=$o.getArea(50;100) ``` -また、プロジェクトメソッド `DO SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: +また、プロジェクトメソッド `DO_SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: ```4d DO_SOMETHING($WithThis;$AndThat;$ThisWay) @@ -35,7 +35,7 @@ EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/20!) // その際に引数として日付リテラル !05/05/20! を渡します ``` -メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* コードは以下のようになります: +メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* という変数に値を返します。コードは以下のようになります: ```4d MyLength:=Length("How did I get here?") @@ -226,7 +226,7 @@ Function returnHello Result:=MySum("000";1;2;200) // "203" ``` -0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: +0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands/count-parameters) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: ```4d // foo メソッド @@ -480,16 +480,16 @@ ALERT([People]Name) ALERT($param) ``` -`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 +`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Name フィールドの値には影響しません。 もし `DO_SOMETHING` メソッド内でフィールドの値を変更したいのであれば、2通りのやり方があります: -1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。 この場合、以下のようにコードを書きます: +1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。この場合、以下のようにコードを書きます: ```4d // MY_METHOD メソッド DO_SOMETHING(->[People]Name) // [People]Name の値が "williams" だとします -ALERT([People]Last Name) +ALERT([People]Name) // DO_SOMETHING メソッド #DECLARE($param : Text) @@ -518,7 +518,7 @@ ALERT($param->) オブジェクトやコレクションのデータタイプは参照 (つまり、内部的な *ポインター*) を介した形でのみ扱われることに注意が必要です。 -したがって、`$param、$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 +したがって、`$param`、`$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 次の例では、`CreatePerson` メソッドはオブジェクトを作成したのち、それを引数として `ChangeAge` に渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/shared.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/shared.md index c014e59e558b1f..a54bb6ee016a81 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/shared.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/shared.md @@ -82,7 +82,7 @@ End Use ### ストレージ -**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 +**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands/storage) コマンドによって返されます。このオブジェクトは、他のプリエンプティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 `ストレージ` オブジェクトは標準の共有オブジェクトとは異なり、共有オブジェクト/コレクションがプロパティとして追加されたときでも共有グループを作成しないという点に注意してください。この例外的な振る舞いにより、**ストレージ** オブジェクトを使用するたびに、リンクされている共有オブジェクト/コレクションをすべてロックせずに済みます。 @@ -102,10 +102,10 @@ End Use 共有オブジェクトおよび共有コレクションは、プロセス間の (とくに \*[プリエンプティブプロセス](../Develop/preemptive.md)\*間の) 通信ができるように設計されています。これらはプロセスから他のプロセスへ、参照型の引数として渡すことができます。共有オブジェクトおよび共有コレクションを扱う際には、複数プロセスによる同時アクセスを避けるために、必ずそれらを `Use...End use` キーワードでくくる必要があります。 -- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のプすべてのロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 +- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のすべてのプロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 - *statement(s)* で実行されるステートメントは、Shared_object_or_Shared_collection のプロパティ/要素に対して、競合アクセスのリスクなしに変更も実行することができます。 - *Shared_object_or_Shared_collection* に他の共有オブジェクトあるいはコレクションがプロパティとして追加された場合、それらも同じ共有グループとして連結されます。 -- \*\*Use...End use \*\* 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 +- **Use...End use** 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 - **End use** は、*Shared_object_or_Shared_collection* プロパティおよび、同じグループのすべてのオブジェクトのロックを解除します。 - 4D コード内では、複数の **Use...End use** 構文を入れ子にすることができます。グループの場合、**Use** を使用するごとにグループのロックカウンターが 1 増加し、 **End use** ごとに 1 減少します。最後の **End use** によってロックカウンターが 0 になった場合にのみ、すべてのプロパティ/要素のロックが解除されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/variables.md index 017bca860210a3..b5c5643c78efdd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Concepts/variables.md @@ -59,23 +59,23 @@ var $myVar // バリアント型変数 サポートされている `varType` 値の一覧です: -| varType | 内容 | -| ---------------------------------------------- | -------------------------------- | -| `Text` | テキスト値 | -| `Date` | 日付値 | -| `Time` | 時間値 | -| `Boolean` | ブール値 | -| `Integer` | 倍長整数値 | -| `Real` | 実数値 | -| `Pointer` | ポインター値 | -| `Picture` | ピクチャー値 | -| `Blob` | スカラーBLOB値 | -| `Collection` | コレクション値 | -| `Variant` | バリアント値 | -| `Object` | デフォルトクラスのオブジェクト | -| `4D.` | 4Dクラス名のオブジェクト | -| `cs.` | ユーザークラス名のオブジェクト | -| `cs.`cs. | `` コンポーネントクラス名のオブジェクト | +| varType | 内容 | +| --------------------------- | -------------------------------- | +| `Text` | テキスト値 | +| `Date` | 日付値 | +| `Time` | 時間値 | +| `Boolean` | ブール値 | +| `Integer` | 倍長整数値 | +| `Real` | 実数値 | +| `Pointer` | ポインター値 | +| `Picture` | ピクチャー値 | +| `Blob` | スカラーBLOB値 | +| `Collection` | コレクション値 | +| `Variant` | バリアント値 | +| `Object` | デフォルトクラスのオブジェクト | +| `4D.` | 4Dクラス名のオブジェクト | +| `cs.` | ユーザークラス名のオブジェクト | +| `cs.` | `` コンポーネントクラス名のオブジェクト | :::note 互換性 @@ -184,7 +184,7 @@ MyNumber:=3 ## ローカル、プロセス、およびインタープロセス変数 -**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 +**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 ### ローカル変数 @@ -249,18 +249,18 @@ MyNumber:=3 システム変数は [4Dコマンド](../commands/command-index) によって使用されます。コマンドがシステム変数に影響を与えるかどうかを確認するには、コマンドの説明の "システム変数およびセット" の項目を参照ください。 -| システム変数名 | 型 | 説明 | -| ------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | -| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | -| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | -| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | -| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | -| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | -| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | -| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | -| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるエラー処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | +| システム変数名 | 型 | 説明 | +| ------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `OK` | Integer | 通常、コマンドがダイアログボックスを表示して、ユーザーが **OK** ボタンをクリックすると 1 に、**キャンセル** ボタンをクリックした場合は 0 に設定されます。一部のコマンドは、処理が成功すると `OK` システム変数の値を変更します。 | +| `Document` | Text | [Open document](../commands/open-document) や [SELECT LOG FILE](../commands/select-log-file) などのコマンドを使用して最後に開かれた、または作成されたファイルの「長い名前」(完全パス名)が格納されています。 | +| `FldDelimit`, `RecDelimit` | Integer | テキストを読み込んだり書き出したりする際に、フィールドの区切りとして (デフォルトは **タブ** (9))、あるいはレコードの区切り文字として (デフォルトは **キャリッジリターン** (13)) 使用する文字コードが格納されています。区切り文字を変更する場合は、システム変数の値を変更します。 | +| `Error`, `Error line` | Integer | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `Error method`, `Error formula` | Text | [`ON ERR CALL`](../commands/on-err-call) コマンドによって実装されるエラー処理メソッド内で使用されます。[メソッド内でのエラー処理](../Concepts/error-handling.md#メソッド内でのエラー処理)参照。 | +| `MouseDown` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。マウスボタンが押されたときに 1 が、それ以外の場合は 0 に設定されます。 | +| `MouseX`, `MouseY` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。
  • `MouseDown=1` イベントの時、`MouseX` と `MouseY` にはクリックされた場所の水平 / 垂直座標がそれぞれ代入されます。両方の値ともピクセル単位で表わされ、ウィンドウのローカルな座標システムを使用します。
  • ピクチャーフィールドや変数の場合は、[`On Clicked`](../Events/onClicked.md) や [`On Double Clicked`](../Events/onDoubleClicked.md)、および [`On Mouse Up`](../Events/onMouseUp.md) フォームイベント内で、クリックのローカル座標が `MouseX` と `MouseY` に返されます。また、[`On Mouse Enter`](../Events/onMouseEnter.md) および [`On Mouse Move`](../Events/onMouseMove.md) フォームイベントでもマウスカーソルのローカル座標が返されます。詳細については、[ピクチャー上のマウス座標](../FormEditor/pictures.md#ピクチャー上のマウス座標) を参照ください。
    • | +| `KeyCode` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。押されたキーの文字コードが代入されます。押されたキーがファンクションキーの場合、`KeyCode` には特殊コードがセットされます。 | +| `Modifiers` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。キーボードのモディファイアキーの値を格納します (Ctrl/Command、Alt/Option、Shift、Caps Lock)。 | +| `MouseProc` | Integer | [`ON EVENT CALL`](../commands/on-event-call) コマンドによって実装されるイベント処理メソッド内で使用されます。最後のイベントが発生したプロセス番号を格納します。 | :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/building.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/building.md index ce46baa310eb71..dccdfd953fa069 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/building.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/building.md @@ -674,7 +674,7 @@ userPrefs:=Get 4D folder(Active 4D Folder) #### データリンクモードの設定 -コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、 \*\*アプリケーション名 \*\* でリンクされます。 +コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、**アプリケーション名** でリンクされます。 異なるデータファイルを使用するために組み込みアプリを複製する場合には、この方法は適さないかもしれません。複製されたアプリは同じアプリケーションユーザー設定フォルダーを共有するため、同じデータファイルを使用することになります (最後に使用されたファイルが開かれるため、データファイル名を変更した場合でも結果は同じです)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/clientServer.md index fb0201dee4c660..66f85111cda68d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/clientServer.md @@ -30,7 +30,7 @@ title: クライアント/サーバー 1. 次のいずれかの方法をおこないます: - Welcome ウィザードにて **4D Serverに接続** を選択します。 - - **ファイル** メニューより \*\*開く ＞ リモートプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **リモートプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 4D Server に接続するためのダイアログが表示されます。ダイアログには **最近使用**、**利用可**、および **カスタム** という、3つのタブがあります。 @@ -216,7 +216,7 @@ title: クライアント/サーバー #### サーバー上で禁止されるコマンド -以下はサーバー上で実行されるストアドプロシージャー内で使用すべきでないコマンドのリストです。以下のコマンドの1つををストアドプロシージャー内で使用したら、4D Server 上で使ってはいけないというアラートが表示されます。エラーは#67 が返ります。[`ON ERR CALL`](../commands/on-err-call) コマンドでインストールされたメソッドを通し、受け取ることができます。 +以下はサーバー上で実行されるストアドプロシージャー内で使用すべきでないコマンドのリストです。以下のコマンドの1つをストアドプロシージャー内で使用したら、4D Server 上で使ってはいけないというアラートが表示されます。エラーは#67 が返ります。[`ON ERR CALL`](../commands/on-err-call) コマンドでインストールされたメソッドを通し、受け取ることができます。 [`ADD RECORD`](../commands/add-record) [`APPEND MENU ITEM`](../commands/append-menu-item) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/drag-and-drop.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/drag-and-drop.md index 301999fe23cbf6..25e56e6993e155 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/drag-and-drop.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/drag-and-drop.md @@ -5,7 +5,7 @@ title: ドラッグ&ドロップ ## 概要 -4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラック＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラック＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラック＆ドロップすることが出来ます。 +4Dにはフォームやアプリケーションのオブジェクト間で動作する組み込のドラッグ＆ドロップ機能があります。一つのオブジェクトを同一のウインドウ内、または別のウインドウにドラッグ＆ドロップすることが出来ます。言い換えれば、同一のプロセスまたは別のプロセスに対してドラッグ＆ドロップすることが出来ます。 またオブジェクトを4Dフォームと他のアプリケーション間でドラッグ＆ドロップできます。例えば PNGピクチャーを 4D のピクチャーフィールドにドラッグ＆ドロップできます。またワードプロセッサーアプリケーションでテキストを選択し、4D のテキスト変数やリストボックスなどにドロップできます。 @@ -42,7 +42,7 @@ title: ドラッグ&ドロップ :::note 注記 - デフォルトで、ピクチャーフィールドや変数の場合は、ピクチャーとその参照は両方ともドラッグされます。変数やフィールドの参照のみをドラッグしたい場合は、**Alt** ボタン(Windows) または **Option** ボタン(macOS) を押す必要があります。 -- 配列型リストボックスオブジェクトで“カスタム”のドラック可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 +- 配列型リストボックスオブジェクトで“カスタム”のドラッグ可プロパティと[“行の移動可”](../FormObjects/properties_Action.md#行の移動可) が同時に選択されている場合、行が移動された場合は“行の移動可”が優先されます。この場合ドラッグはできません。 - ドラッグとドロップの両方ができるオブジェクトは、開発者が禁止しない限り、自分自身にもドロップできます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/labels.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/labels.md index 83da396a907891..70073d18ad1a8d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/labels.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Desktop/labels.md @@ -55,7 +55,7 @@ title: ラベル ### ラベルプレビューエリア -このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ)) を指定できます)。 +このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ) で指定できます)。 - ラベルにはフィールドをドラッグすることができます。 - 一つ目のフィールドの上に他のフィールドをドロップする事で二つのフィールドを結合する事もできます。これらは自動的にスペースで区切られます。
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md index 03bddec21cce98..1defcb370930a6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/field-properties.md @@ -39,7 +39,7 @@ title: フィールド オブジェクト型フィールドのクラスとして`4D.Vector` を割り当てた場合、**ベクトルフィールド** を定義します。このようなフィールドは埋め込みを保存し、AI 機能を使用してデータをクエリすることに使用することができます。ベクトルに対してどのようにクエリを行うかについては[`4D.Vector` クラス](../API/VectorClass.md) のドキュメンテーションをご覧ください。 -また[**4D Embedding Studio** コンポーネント](corner.4d.com/component/4d-embedding-studio) を使用すると、4D.Vector フィールドを設定したり更新したりするに役立ちます。 +また[**4D Embedding Studio** コンポーネント](https://corner.4d.com/component/4d-embedding-studio) を使用すると、4D.Vector フィールドを設定したり更新したりするに役立ちます。 オブジェクト型フィールドに対して`4D.Vector` クラスを割り当てると、ストラクチャーエディター内において特定のアイコンがフィールドの型として表示されるようになります: ![](../assets/en/Develop/ai-icon.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-indexes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-indexes.md index bda4db52666dbb..51fb40856f799a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-indexes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-indexes.md @@ -82,7 +82,7 @@ QUERY([PICTURES];[PICTURES]Photos %"cats") - **ユークリッド**: このベクトルインデックスは [ユークリッド距離](../API/VectorClass.md#異なるベクトル計算を理解する) 計算に対して最適化されています。 - **自動**: 標準のオブジェクトインデックスタイプ([上記参照](#標準インデックス))。 Null ベクトルを管理したい場合にはこのインデックスタイプを選択できます。その場合、自動的に使用されます。 -You can select one or more index types for your vector fields, the appropriate index will be automatically used depending on the actual computation. For optimization reasons, it is recommended to only select necessary index types. +ベクトルフィールドに対しては一つまた複数のインデックスタイプを割り当てることができ、実際の計算に応じて適切なインデックスが自動的に使用されます。ただし最適化のため、必要なインデックスタイプのみを選択することが推奨されます。 :::tip 関連したblog 記事 @@ -90,84 +90,82 @@ You can select one or more index types for your vector fields, the appropriate i ::: -:::warning Limitation: Vector indexes and transactions +:::warning 制約: ベクトルインデックスとトランザクション -Vector indexes are not compatible with [transaction processing](../Develop/transactions). When vector-indexed records are inserted, updated, or deleted within a transaction, the corresponding index changes are not committed or rolled back with the transaction. As a result, the vector index may become inconsistent with the database state after a rollback, and search results may not reflect the persisted data. +ベクトルインデックスは[トランザクションの処理](../Develop/transactions) とは互換性がありません。トランザクション中にベクトルインデックスがつきレコードが追加、更新、削除された場合、対応するインデックスの変更はそのトランザクションとともにコミットまたはロールバックされることはありません。結果として、ベクトルインデックスはロールバック後にデータベースの状態と不整合になる可能性があり、検索結果には永続的なデータが反省されない可能性があります。 ::: -## Index List +## インデックスリスト -The ![](../assets/en/Develop/index-list.png) button of the toolbar in the Structure editor displays the Index List window. This window displays the list of all the indexes of the structure, regardless of their type: +ストラクチャーエディターのツールバーにある![](../assets/en/Develop/index-list.png) ボタンをクリックすると、インデックスリストウィンドウが表示されます。このウィンドウはタイプに関わらず、ストラクチャのすべてのインデックスを表示します: ![](../assets/en/Develop/index-window.png) -The Index List can be used to view the main properties of the indexes: +インデックスリストを使用して、インデックスの主なプロパティを確認することができます: -- **Type:** Index type. Each type of index (B-tree, Cluster B-tree, Keyword, Euclidean, Cosine, Dot) is depicted with a different icon. -- **Description:** Table and field(s) of index. For a composite index, this list contains all the fields of the index. -- **Name:** Index name. This property is used in particular by the language commands. You can change or add an index name by double-clicking in this column. +- **タイプ:** インデックスのタイプ。それぞれインデックスのタイプ(Bツリー、クラスターBツリー、キーワード、ユークリッド、コサイン、ドット) がそれぞれ異なるアイコンで表示されます。 +- **詳細:** インデックスのテーブルとフィールド。複合インデックスに対しては、リストにはインデックスに使用される全てのフィールドが含まれます。 +- **名前:** インデックスの名前。このプロパティは特にランゲージコマンドにおいて使用されます。この列をダブルクリックすることでインデックス名を変更または追加することができます。 -The **[+]** button displays the index property dialog box and allows you to edit the selected index or to add a new index when no index was selected. -The **[-]** button deletes the selected index (a confirmation dialog box appears). -This button can be used more particularly to delete composite indexes. +**[+]** ボタンをクリックすると、選択されたインデックスに対して編集するためのインデックスプロパティダイアログボックスを表示するか、インデックスが何も選択されていない場合には新しいインデックスを追加します。 +**[-]** ボタンは選択したインデックスを削除します(確認ダイアログが表示されます)。 +このボタンは特に複合インデックスを削除するために使用されます。 -Two additional commands are available in the menu associated with the tool button (enabled when an index is selected: +ツールボタンに割り当てられた2つのメニューを使用できます(インデックスが選択されている場合にのみ使用できます): -- **Edit:** Displays the properties of the selected index in the index property dialog box (see next paragraph). This command has the same effect as double-clicking on a row of the list (except for in the name area). -- **Rebuild:** Can be used to delete and rebuild the selected index. A confirmation dialog box appears when you select this command. +- **編集:** インデックスプロパティダイアログボックスに選択したインデックスのプロパティを表示します (次段落参照)。このダイアログはリスト中のインデックスをダブルクリックすることでも表示できます (名前エリアを除く)。 +- **再構築:** 選択したインデックスを再構築するために使用されます。このコマンドを選択すると、確認ダイアログボックスが表示されます。 -## Creating an index +## インデックスの作成 -To create a **standard index** directly: +**標準のインデックス** を直接作成する: -1. Select a field then choose a value from the "Index" menu of the **Inspector palette**. - **OR** - Right-click on the field then select a value from the **Index>** submenu of the context menu. +1. フィールドを選択し、**インスペクターパレット**の"インデックス"メニューから選択します。**または** + フィールドを右クリックし、コンテキストメニューの**インデックス>** サブメニューから選択します。 -To create a **composite index** or any other type of index using the index creation dialog box: +インデックス作成ダイアログボックスを使用して**複合インデックス** や他のタイプのインデックスを作成するためには: -1. Select several fields while holding down the **Shift** key (for adjacent selection) or **Ctrl** (Windows) or **Command** (macOS) button then right click on one of the fields and select **New Composite Index...** in the context menu. - **OR** - Select the **New Index...** in the context menu of the table or select **Index** in the add objects menu of the Structure editor tool bar. +1. **Shift** キー(連続した選択)、あるいは**Ctrl** (Windows) または **Command** (macOS) ボタンを押しながら複数のフィールドを選択し、うち一つのフィールドを右クリックしてコンテキストメニューから**新規複合インデックス...** を選択します。**または** + テーブルのコンテキストメニューから**新規インデックス...** を選択するか、ストラクチャーエディターツールバーのオブジェクト追加メニューを使用して、**インデックス** オプションを選択します。 -The index configuration dialog box then appears. +インデックス設定ダイアログが表示されます。 ![](../assets/en/Develop/index-add.png) -It contains the following elements: +このダイアログには以下の要素が含まれます: -- **Table:** List of all the database tables. Choose the table to which the index will belong from this menu. -- **Name:** Index name entry area. This name is used by the 4D language commands. -- **Type:** Selection menu for type of index to be created. If you keep the "Automatic" option, 4D will automatically choose the index type according to the contents of the field. -- **List of Fields:** This area is used to specify the field(s) associated with the index. It can contain a field by default depending on the current selection in the editor. +- **テーブル:** データベース中のすべてのテーブルのリスト。このメニューから、インデックスが属するテーブルを選択します。 +- **名称:** インデックス名の入力エリア。この名前は4D ランゲージコマンドによって使用されます。 +- **タイプ:** 作成するインデックスのタイプを選択するメニュー。"自動"を選択すると、フィールドの内容に基づき、4D が自動でインデックスタイプを決定します。 +- **フィールドリスト:** このエリアで、インデックスに割り当てるフィールドを指定します。ストラクチャーエディターでフィールドを選択していると、あらかじめそのフィールドがこのリストに設定されます。 -To add a field to the index, click on the **[+]** button. The list of fields of the selected table is displayed so that you can indicate the field to be added to the index. +インデックスにフィールドを追加するには **[+]** ボタンをクリックします。選択したテーブルのフィールドリストが表示され、インデックスに追加するフィールドを指定できます。 -- If you want to create a composite index, add each field to be included in the index successively. Once the list is completed, you can reorder the fields using the arrow buttons or using drag and drop. -- If you create a composite index based on primary key fields, make sure you put the fields in the same order in the primary key and in the index. +- 複合インデックスを作成するには、インデックスに含めるフィールドを複数選択します。フィールドリストが完成したら、矢印ボタンやドラッグ＆ドロップを使用してフィールドの並びを変更できます。 +- 主キーフィールドをもとに複合インデックスを作成する場合、フィールドの並び順が主キーとインデックスとで同じ順番になるようにしてください。 - If you have chosen the “Keyword Index” type, only Alpha or Text fields can be selected. Also in this case, you cannot include only one field in the index. -To delete a field from the index, select it in the list and click on the **[-]** button. +インデックスからフィールドを削除するには、リスト中でそれを選択し、 **[-]** ボタンをクリックします。 -Once the index has been configured, click on **OK** to generate the index. +インデックスの設定ができたら、**OK** ボタンをクリックするとインデックスが生成されます。 -## Deleting an index in the Structure editor +## ストラクチャーエディターでインデックスを削除する -You can delete indexes that are no longer useful at any time. This can be carried out directly in the Structure editor or using the [Index List](#index-list) window. +利用しなくなったインデックスはいつでも削除できます。削除はストラクチャーエディター上で直接、または[インデックスリスト](#インデックスリスト) ウィンドウ上で行うことができます。 -To delete a standard index in the Structure editor: +ストラクチャーエディター内で標準インデックスを削除するには: -1. Select the field associated with the index you want to delete, then choose the **None** or uncheck the **Keyword Index** option (for a keyword index) in the Index menu of the **Inspector palette** - **OR** - Right-click on the field associated with the index, then choose the **None** or uncheck the **Keywords** option from the **Index>** submenu of the context menu. +1. 削除するインデックスが割り当てられているフィールドを選択し、**インスペクターパレット** のインデックスメニューから**なし** を選択するか、**キーワードインデックス** オプションのチェックを外します(キーワードインデックスの場合)。 + **または** + 削除するインデックスが割り当てられているフィールド上で右クリックし、コンテキストメニューから**インデックス>** から**なし** を選択するか、**キーワード** オプションのチェックを外します。 -The deletion (and viewing) of a composite index can only be carried out from the List Index window, see above. +複合インデックスの削除(と表示)は、リストインデックスウィンドウを通してのみ実行可能です。詳細は上記を参照してください。 -## Reindexing a field +## インデックスの再構築 -You can reindex a field at any time; in other words, rebuild the index table(s) associated with it, in accordance with the data present. This can be useful in the case of application maintenance. +フィールドのインデックスをいつでも再構築できます。これは言い換えると、そのインデックスに対応するインデックステーブルを、現在のデータを使用して再構築することを意味します。これはアプリケーションメンテナンスの際に利用できます。 -Reindexing can be carried out using the **Rebuild** command in the [Index List](#index-list) window. +インデックスの再構築は[インデックスリスト](#インデックスリスト) ウィンドウの**再構築** コマンドを使用して行います。 -Note that modifying the [data language](../settings/database.md#text-comparison) or maintenance operations such as [compacting](../MSC/compact.md) will also cause the indexes to be rebuilt. +[データ言語](../settings/database.md#テキスト比較) の変更や、データの[圧縮](../MSC/compact.md) などのメンテナンス処理においても、インデックスの再構築が行われることに留意してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md index 57dae33dbf2d43..70735ccd1c37b4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Develop/structure-tables.md @@ -3,366 +3,362 @@ id: structure-tables title: テーブル --- -Tables are the foundation of every 4D database. Each table defines a collection of records that share the same set of fields and properties. In the Structure editor, tables are represented as graphic objects that you can create, rename, or delete, and whose attributes you can configure individually. +テーブルは全ての4D データベースの基盤です。それぞれのテーブルは、同じフィールドとプロパティの集合を共有するレコードの集合を定義します。ストラクチャーエディターでは、テーブルはグラフィカルなオブジェクトとして表示され、作成、名称変更、削除が可能で、またその属性を個別に設定することが可能です。 -Using the tools provided by 4D, you can: +4D が提供するツールを使用して、以下のようなことを行えます: -- Define tables and manage their primary keys and relations -- Set and edit table-level properties such as triggers, visibility, and replication -- Control naming rules and organize tables into folders for easier maintenance +- テーブルを定義し、その主キーやリレーションを管理する +- トリガ、表示状態、複製などのテーブルレベルのプロパティを設定し編集する +- 命名規則を管理しテーブルをフォルダに管理しメンテナンスを容易にする -## Creating a table +## テーブルの作成 -You can create a new table either directly in the Structure window, or via a dialog box. Direct creation is faster; but creation using the dialog box lets you specify certain parameters of the table and cancel the operation when necessary. You can also create tables using copy-paste. +直接ストラクチャウィンドウで、あるいはダイアログボックス経由で、テーブルを作成することができます。直接の作成は素早く行えますが、ダイアログボックスを 使用した作成ではテーブルの特定のパラメターを設定したり、必要であれば作成をキャンセルすることができます。またコピー/ペーストでテーブルを作成する こともできます。 -- To create a new table directly: +- 新規テーブルを直接作成するには: -1. Right-click an empty area of the Structure editor window, then choose **Add Table...** from the context menu. - **OR** - In the add objects menu of the [Structure editor toolbar](./structure-editor.md#toolbar), choose the Table option. +1. ストラクチャーエディターウィンドウの空のエリアで右クリックをし、コンテキストメニューから**テーブル追加...** を選択します。 + **または** + [ストラクチャーエディターツールバー](./structure-editor.md#ツールバー) のオブジェクト追加メニューから、テーブルを選択します。 -4D creates the table directly in the Structure editor. You can then change its name, add fields, etc. +4Dは直接ストラクチャーエディター内にテーブルを作成します。その後、名前を変更したりフィールドを追加したりできます。 :::note -If you want to put the table in a specific folder, you need to use the Home Page of the Explorer. +テーブルを特定のフォルダーに入れたい場合、エクスプローラーのホームページを使用します。 ::: -- To create a new table using the "New table" dialog box: +- “新規テーブル”ダイアログボックスを使用してテーブルを作成するには: -1. Choose **New > Table...** in the **File** menu (or in the **New** button of the 4D tool bar). - **OR** - On the Tables Page of the Explorer, click on the **\[+]** button. +1. **ファイル**メニューの **新規 > テーブル...** コマンドを選択します (または4Dツールバーの**新規**ボタンをクリックします)。 + **または** + エクスプローラーのテーブルページで、 **\[+]** ボタンをクリックします。 -The "New table" dialog box appears. 4D names the first table `Table_1` and then numbers them sequentially: +"新規テーブル"ダイアログボックスが表示されます。 4D は最初のテーブルに `Table_1` と名前をつけ、それ以降は順番に番号を振っていきます: ![](../assets/en/Develop/new-table.png) -2. (optional) Modify the [name of the table](../Concepts/identifiers.md#tables-and-fields) you want to create. -3. (optional) Specify the folder in which you want to place the new table. - By default, the table is placed at the highest level of the folder hierarchy ("Top Level"). Folders are handled in Home Page of the Explorer. -4. Click **OK** to validate. - 4D creates a new table image. It becomes the selected table image in the Structure editor window. +2. (任意) 作成する[テーブルの名称](../Concepts/identifiers.md#テーブルとフィールド) を変更します。 +3. (任意) 新しいテーブルを配置するフォルダーを選択します。 + デフォルトでテーブルはフォルダー階層のトップレベルに配置されます。フォルダーはエクスプローラーのホームページ内で管理されます。 +4. **OK** をクリックします。 + 4D は新しいテーブルイメージを作成します。それがストラクチャーエディターウィンドウ内で選択されます。 -- To create a new table by copy-paste: +- コピー/ペーストでテーブルを作成するには: -1. Select and copy the table(s) to be duplicated. -2. Paste the table(s) in the Structure editor window. +1. 複製するテーブルを選択し、コピーします。 +2. ストラクチャーウィンドウ内でテーブルを貼り付けします。 -The table is pasted with all its fields and properties. +テーブルはすべてのフィールドとプロパティとともにペーストされます。 -## Renaming a table +## テーブルの名称変更 -You can rename tables at any time. If you have used the old table name in a method, 4D automatically changes it to the new name provided the method is closed. If the method is open, you must make the changes yourself. Each table name must be unique in the database. +テーブルはいつでも名称変更できます。古いテーブル名がメソッド中で使用されていた場合、4D は自動でそれを新しい名称で置き換えます(メソッドがエディタで開かれていてはいけません)。メソッドが開かれている場合、手作業で変更を行う必要があります。データベース内でテーブル名はユ ニークでなければなりません。 -You can rename a table directly in the Structure editor, in the Explorer, or using the Inspector palette. +テーブル名の変更はストラクチャーエディター、エクスプローラー、またはインスペクターパレットを使用して直接行うことができます。 -To rename a table directly (Structure editor or Tables page of the Explorer), **click twice** on the table name (if the table is already selected, click once), so that it switches to editing mode: +(ストラクチャーエディターまたはエクスプローラーのテーブルページを使用して)テーブル名を直接変更するには、テーブル名を2回クリックし(テーブルが既に選択されている場合は1回クリック)、編集モードにスイッチします: ![](../assets/en/Develop/table-rename.png) -Enter the new name and click outside of the table. +新しい名称を入力し、テーブルの外側をクリックします。 -To rename a table using the Inspector palette of the Structure editor, double-click on the table name (or select **Table Properties...** in the context menu of the table) and enter the new name in the "Name" area. +ストラクチャーエディターのインスペクターパレットを使用して名称変更するには、テーブル名をダブルクリック(またはテーブルイメージ上で右クリックをし、コンテキストメニューから\*\*テーブルプロパティ...\*\*を選択)し、"名称"エリアに新しい名前を入力します。 ![](../assets/en/Develop/table-rename-2.png) -4D displays the name and properties of the selected table in the Inspector palette. This palette also indicates the table number. If the Inspector palette is already open but is displaying the properties of another table or another object, just select the desired table image and the palette will then display its properties. +4D はインスペクターパレット内に選択されたテーブルの名前とプロパティを表示します。このパレットにはテーブル番号も表示されます。インスペクターペレット が既に開かれていて、他のテーブルや他のオブジェクトのプロパティを表示している場合には、名称変更したいテーブルのテーブルイメージを選択すると、パ レットにそのテーブルのプロパティが表示されます。 -## Deleting a table +## テーブルの削除 -You can delete tables from your database. There are two ways of deleting tables in 4D: **permanent deletion** (the table and its data are actually removed from the database) and **non-permanent deletion** (the table is simply put into the Trash of the Explorer and may be recovered subsequently). +テーブルはデータベースから削除することができます。 4D では二つの方法でテーブルを削除できます: **恒久的削除** (テーブルおよびそのデータが実際にデータベースから取り除かれる削除) と**非恒久的削除** (テーブルが単にエクスプローラーのゴミ箱に置かれあとで元に戻すことができる削除) の二つです。 :::info -You can also remove tables using the [SQL engine of 4D](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.en.html). +テーブルの削除は[4D のSQL エンジン](https://doc.4d.com/4Dv21/4D/21/4D-SQL-Reference.100-7649299.ja.html) を使用して行うこともできます。 ::: -### Permanent deletion +### 恒久的削除 -To permanently delete one or more database tables in the Structure editor: +ストラクチャーエディターで一つまたは複数のテーブルを恒久的に削除するには: -Select the table(s) to be deleted then choose **Clear** from the **Edit** menu or choose **Delete** from the context menu of the table. +削除するテーブルを選択し、**編集**メニューから**クリア**を選択するか、テーブルのコンテキストメニューから**削除**を選択します。 -A warning dialog box will ask you to confirm the operation. When you click **OK**, 4D carries out the following operations: +警告ダイアログが表示され、処理を続行するか確認されます。 **OK** をクリックすると、4D は以下の処理を行います: -- The table is permanently deleted from the structure. All the data associated with the table are deleted permanently from the data file. -- Any trigger method associated with the table is deleted. -- The forms and lists associated with the table are transformed into project forms and are placed in the Trash of the Explorer. +- テーブルは恒久的にストラクチャーから削除されます。またデータファイルから、そのテーブル関連するデータが恒久的に削除されます。 +- テーブルのトリガーメソッドが削除されます。 +- テーブルに関連づけられていたテーブルフォームとリストフォームはプロジェクトフォームとなり、エクスプローラーのゴミ箱に移動されます。 -### Non-permanent deletion +### 非恒久的削除 -Non-permanent deletion of a table consists in putting it in the Trash of the project (which can be accessed via the Explorer), just like the file deletion mechanisms implemented by Windows and macOS. +テーブルの非恒久的削除は、プロジェクトのゴミ箱(エクスプローラーからアクセス可能)に、削除するテーブルを移動することで行われます。これはWindows やmacOS に実装されたファイル削除のメカニズムと同様のものです。 -The table then no longer appears in the 4D editors and its contents become inaccessible but it can still be recovered so long as the Trash is not emptied. +これを行うとテーブルは4Dのエディターに表示されず、その内容にアクセスすることもできなくなりますが、ゴミ箱を空にしない限り元に戻すことが可能です。 -To put one or more tables into the Trash from the Structure editor, choose the **Move to Trash** command from the context menu of the table or select the table(s) to be deleted then press the **Delete** or **Backspace** key. A confirmation dialog box appears. If you click **OK**, the table is put into the Trash. It can be recovered at any time from the Trash Page of the Explorer. +ストラクチャーエディターから一つまたは複数のテーブルをゴミ箱に移動するには、テーブルのコンテキストメニューから**ゴミ箱に移動**コマンドを選択するか、削除するテーブルを選択し、**Delete** または**Backspace** キーを押します。確認ダイアログが表示されます。 **OK** をクリックすると、テーブルはゴミ箱に移動されます。ゴミ箱を空にしない限りエクスプローラーのゴミ箱ページからいつでも元に戻すことができます。 -### Numbers of deleted tables +### 削除されたテーブルの番号 -When a table is deleted, the other tables of the database are not renumbered, so as to avoid endangering the stability of the database. It is therefore possible, for example, to have a database with three tables numbered 2, 4 and 5. +テーブルが削除されても、データベースの安定性を損ねることを避けるために、データベース中の他のテーブルの番号は変更されません。そのため例えば3 つのテーブルがあるデータベースにおいて、それらのテーブル番号が2, 4 および 5であるといったことが起こり得ます。 -Note that the numbers of permanently deleted tables are reused when new tables are created subsequently. +恒久的に削除されたテーブルのテーブル番号は、新しくテーブルが作成されるときに再利用される点に留意してください。 -## Table properties +## テーブルプロパティ -You can set several properties for tables using the **Inspector palette** or, for certain properties, using the context menu for the tables. +**インスペクターパレット**を使用してテーブルのプロパティを設定できます。また特定のプロパティについてはテーブルのコンテキストメニューからも設定できます。 ### Triggers -A [trigger](./triggers) is a method that runs automatically when certain events related to the table occur. Trigger events can be set in the **Inspector palette** or using the context menu associated with the table (right-click on the title area of the table). Check each event for which you want to [activate the trigger](./triggers#activating-and-creating-a-trigger). +[trigger](./triggers) はテーブルに関連する特定のイベントが発生した際に自動で実行されるメソッドです。トリガーイベントは**インスペクターパレット** またはテーブルに割り当てられたコンテキストメニューを使用(テーブルのタイトルエリアを右クリック)して設定できます。[有効にしたいトリガー](./triggers#トリガーのアクティブ化と作成) のイベントにチェックします。 -You can access the trigger of a table directly from the Structure editor by clicking on the **Edit...** button in the Inspector palette or by selecting **Edit Method...** in the context submenu. You can also create and display triggers with the **Methods Page** of the Explorer. +テーブルのトリガーには、ストラクチャーエディターのテーブルインスペクターパレットで**編集...**ボタンをクリックするか、テーブルのコンテキストメニューから**メソッド編集...**サブメニューを選択します。エクスプローラーの**メソッドページ**を使用してトリガーを作成および表示ができます。 -The [information bar](./structure-editor.md#information-bar) of the **Structure editor** indicates the triggers that are activated for each table. +**ストラクチャーエディター**の[情報バー](./structure-editor.md#情報バー) には有効にされているトリガーがテーブルごとに表示されます。 ### 属性 -You can set different attributes to configure the appearance and general behavior of each table. +アピアランスや一般的な振る舞いを指定するために、テーブルごとに異なる属性を設定できます。 #### 非表示 -This option lets you make a table invisible in the Application mode and for plug-ins. You can activate this option for utility tables or tables that are not being used temporarily. +このオプションを使用して、アプリケーションモードおよびプラグインからテーブルを見えなくできます。このオプションはユーティリティテーブルや、一時的に使用しないテーブルに対して使用できます。 -Making a table invisible allows you to limit the operations that a user can perform on a table by making the table and its fields invisible in all editors and some dialog boxes that appear in the Application environment. It can also not be used by plug-ins. +テーブルを非表示にすることで、アプリケーションモードのすべてのエディター上やいくつかのダイアログボックスでそのテーブルとフィールドが非表示になり、ユーザーがテーブルに対して行うことのできる処理を制限できます。またプラグインから使用することもできなくなります。 -The editors and dialog boxes concerned in the Application environment include the following: +アプリケーションモードにおいて関連するエディターやダイアログボックスは以下の通りです: -- All query editors -- Order by editor -- [Label editor](../Desktop/labels.md) -- Quick report editor -- Exporting and importing data dialog boxes -- Formula editor +- すべてのクエリーエディター +- 並び替えエディター +- [ラベルエディター](../Desktop/labels.md) +- クイックレポートエディター +- データの読み込みと書き出しダイアログボックス +- フォーミュラエディター -In each of these editors, the user is unable to see or choose the table or any of its fields. For instance, the user cannot include any fields from an invisible table in a report or label. +これらのエディターそれぞれで、ユーザーはテーブルやそのフィールドを見たり選択したりすることはできません。例えばレポートやラベルに非表示テーブルのフィールドを含めることはできません。 :::note 注記 -- When using these editors, users have the option of saving their specifications (e.g., the query or sort they created) to disk files. In this case, any specified tables or fields that are subsequently made invisible may still be used in the operation. -- Users can type the names of invisible tables and fields in the dialog box. -- It is also possible to set this attribute for each field individually. +- これらのエディターを使用する際、ユーザーは設定をディスクファイルに保存することができます (例えば作成したクエリや並び替え設定)。その設定ファイルが使用される場合、設定が作成された後に非表示にされたテーブルやフィールドは、あとの操作でも使用することが可能です。 +- ユーザーはフォーミュラエディターダイアログボックスに非表示テーブルやフィールド名をタイプ入力することが可能です。 +- またこの属性をそれぞれのフィールドに対して個別に設定することも可能です。 ::: -Invisible tables and fields are displayed in *italics* in the Structure editor window. +非表示テーブルとフィールドはストラクチャーエディターウィンドウ内で*イタリック* で表示されます。 -#### Color of the table image +#### テーブルイメージのカラー -A color can be attributed to each table. Using colors helps to organize the structure of a large database. For example, you could use one color for all tables that relate to customers and another for tables that relate to inventory. +テーブルイメージごとにカラーを割り当てることができます。カラーを使用すると、大きなデータベースストラクチャーでグループを視認しやすくできます。例えば顧客や顧客にリレートするすべてのテーブルに同じカラーを設定し、在庫や在庫にリレートするすべてのテーブルに別のカラーを割り当てることができます。 :::note -It is also possible to attribute a color to each field individually as well as to each relation. +個々のフィールドやリレーションにカラーを割り当てることもできます。 ::: -To set the color of one or more tables, make your selection and then choose the color using: +テーブルにカラーを設定するには、テーブルを選択し、以下の方法でカラーを選択します: -- The **Color** button of the Structure editor toolbar -- The **Color** command in the context menu of the tables -- The **Color** option in the **Inspector palette** +- ストラクチャーエディターツールバーの**カラー**ボタン +- テーブルのコンテキストメニューの**カラー**コマンド +- **インスペクターパレット**の**カラー**オプション -The **Automatic** option can be used to apply the standard original color to the table. +**自動**オプションを使用すると、テーブルのデフォルトカラーが使用されます。 -#### Expose as REST resource +#### REST リソースとして公開 -This option controls whether the [table is exposed to REST requests](../REST/configuration.md#exposing-tables). +このオプションは、[テーブルがREST リクエストに対して公開されるかどうか](../REST/configuration.md#テーブルの公開) を管理します。 :::note 注記 -- You can also set this option at the level of each field of the table. -- This option is used in the context of [ORDA remote datastore features](../ORDA/remoteDatastores.md). +- このオプションは、テーブルのフィールドレベルで個別に設定することもできます。 +- このオプションは [ORDA のリモートデータストア機能](../ORDA/remoteDatastores.md)のコンテキストにおいて使用されます。 ::: -#### Records definitively deleted +#### レコードを完全に削除 -This option lets you optimize the deletion of a selection of records made using the [`DELETE SELECTION`](../commands/delete-selection) command. +このオプションを使用すると、[`DELETE SELECTION`](../commands/delete-selection) コマンドを使用して選択したレコードを削除する際の動作を最適化できます。 -When 4D deletes a selection, the record markers are also deleted. A record marker is a header attached to the record that contains information relating to this record. Deleting both markers and records is slower than deleting only records. In certain cases, it may be desirable to not automatically delete the record markers. +4Dはレコードのセレクションを削除する際、レコードマーカーも削除します。レコードマーカーはそのレコードに関連する情報を含む、レコードに添付されたヘッダーです。マーカーとレコード両方を削除するのは、レコードだけを削除するよりも時間がかかります。特定の場合においては、レコードマーカーを自動では削除しないほうに設定した方がよいこともあります。 -To accelerate the deletion of a large selection made using the [`DELETE SELECTION`](../commands/delete-selection) command, deselect the **Records definitively deleted** option. Record markers will then not be deleted. This option cannot be set by programming. +[`DELETE SELECTION`](../commands/delete-selection) を使用して実行される大量のセレクションの削除を加速するために、**レコードを完全に削除** オプションの選択を解除できます。そうするとレコードマーカーは削除されなくなります。このオプションをプログラムで設定することはできません。 -#### Enable replication +#### 複製を有効にする :::info 非推奨 -Replication and synchronize mechanisms using SQL are deprecated as of 4D 20 R3. They are still supported but it is now recommended to use the [ORDA-based Global Stamp feature](../ORDA/global-stamp.md), providing a flexible and robust solution to implement replication and synchronization in 4D. +SQL を使用した複製と同期の機構は4D 20 R3 以降は非推奨となっています。これらはまだサポートされていますが、現在は[ORDA ベースのグローバルスタンプ機能](../ORDA/global-stamp.md) を使用することが推奨されます。この機能は4D 内において複製と同期を実装するための柔軟で堅牢なソリューションを提供します。 ::: -#### Include in Log File +#### ログファイルに含める -By default, this option is checked for all new tables created and for all tables in converted databases. Check this option in order for operations performed on the table’s data to be included in the [database log file](../Backup/log.md) (when it is generated). +このオプションは、作成された全ての新しいテーブルと変換されたデータベースにおいては、デフォルトでチェックがされています。テーブルのデータに対して行われたオペレーションを、全て[データベースのログファイル](../Backup/log.md)(作成時)に含めたい場合にはこのオプションにチェックを入れて下さい。 -This option must generally be checked for most tables. However, for optimization purposes, you can uncheck it, for example for temporary tables or tables used for importing data. +このオプションは一般的に、ほとんどのテーブルにおいてチェックされるべきものです。しかしながら、最適化の観点から、例えばデータをインポートするために一時的に使用するテーブルなどではチェックを外すこともできます。 -It is important to note that this option only indicates that the table’s data must be journaled if the database uses a log file; it does not enable the journaling procedure itself at the database level. +このオプションは、データベースがログファイルを使用する場合には、そのテーブルのデータがログに記録されなければならないという指示にすぎず、データベースレベルでのデータログ処理そのものを有効化するスイッチではないということに留意して下さい。 :::note 注記 -- This option is grayed out when the table does not have a primary key. -- 4D displays a warning icon to the right of the **Include in Log File** option when the required conditions are not met. As long as this icon is shown, journaling is not yet enabled. +- このオプションはテーブルがプライマリーキーを持っていない場合にはグレーになって選択することができません。 +- 必要要件を満たしていない場合は、**ログファイルに含める** のオプションの横に警告アイコンが表示されます。このアイコンが表示されている限り、データログは有効化されていません。 ::: -#### Encryptable +#### 暗号化可能 -This option controls whether the data stored in the table must be encrypted on disk when [data file encryption is enabled](../MSC/encrypt.md). +このオプションは、[データファイル暗号化が有効化された](../MSC/encrypt.md) 際に、テーブルに保存されたデータがディスク上で暗号化されるべきかどうかを管理します。 -Since encrypting/decrypting can be time consuming, selecting the tables to encrypt allows you to optimize the performance of encrypted databases. For example, you could set only the tables that contain personal data as **Encryptable**. +暗号化 / 復号化は時間がかかることがあるため、暗号化するテーブルを選択することで暗号化されたデータベースの操作を最適化することができます。例えば、個人データを格納しているデータのみを**暗号化可能**に設定する、とすることが可能です。 -Note that this option flags table(s); it does not perform any encryption or decryption operation. To actually encrypt or decrypt selected table(s) in the data file, you must use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command. +このオプションはテーブルにフラグを立てるだけであり、実際の暗号化/復号化操作を実行するわけではないことに注意してください。実際にデータファイル内で選択されたテーブルを暗号化あるいは復号化するためには、[MSC](../MSC/encrypt.md) あるいは[`Encrypt data file`](../commands/encrypt-data-file) コマンドを使用しなければなりません。 :::warning -- When you modify the value of this option for a table in an already encrypted database, you must also use the [MSC](../MSC/encrypt.md) or call the [`Encrypt data file`](../commands/encrypt-data-file) command to preserve data consistency. Otherwise, you will not be allowed to save data in the modified table (errors will be returned by 4D when trying to save records). -- Encryption of data stored outside of the data file is not managed by this option. +- 既に暗号化されているデータベース内でこのオプションの値を変更した場合、データの一貫性を保つために必ず[MSC](../MSC/encrypt.md) か[`Encrypt data file`](../commands/encrypt-data-file) コマンドを使用しなければなりません。使用しない場合、編集したテーブル内にデータを保存することができません(レコードを保存しようとした場合、4D はエラーを返します)。 +- データファイルの外部に保存されているデータの暗号化は、このオプションによる管理できません。 ::: ### コメント -The **Comments** area of the **Inspector palette** lets you store additional information about the table. These comments are available for all the developers. Note that each field and each relation has its own comments area. +**インスペクターパレット**の**コメント**エリアにはテーブルに関する追加の情報を格納できます。このコメントはすべての開発者が利用できます。各フィールドおよびリレーションごとにコメントエリアがあります。 ### SQL -- The "Schemas" menu lists all the SQL schemas specified in the database. You can use this menu to set the schema to which the table will belong (it is also possible to modify this property via SQL commands). Every database has at least one schema, named **DEFAULT_SCHEMA**. By default, all the tables belong to this schema. For more information about SQL schemas, refer to the [**Schemas** section](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.en.html#148386) in the *4D SQL Reference guide*. -- The information area indicates whether the name of the table respects the rules regarding SQL nomenclature (for example, unlike 4D, SQL does not allow a field name to contain spaces). +- “スキーマ”メニューにはデータベースに定義されたすべてのSQL スキーマが一覧されます。このメニューを使用して、テーブルが属するスキーマを指定できます (このプロパティはSQL コマンドを使用して変更することもできます)。すべてのデータベースには最低1つの、**DEFAULT_SCHEMA** という名前のスキーマがあります。デフォルトですべてのテーブルはこのスキーマに属します。 SQL スキーマに関する詳細は*4D SQL リファレンス* の[**スキーマ** の章](https://doc.4d.com/4Dv21/4D/21/4D-SQL-engine-implementation.300-7649386.ja.html#148386) を参照してください。 +- 情報エリアは、テーブル名がSQL の命名規則に沿っているかどうかを表示します (例えば4D と異なり、SQL ではフィールド名にスペースを含めることはできません)。 -### Primary keys +### プライマリーキー(主キー) -A primary key designates the field(s) used for uniquely identifying the records in a table. Setting a primary key is necessary for the [journaling features](../Backup/log.md). +プライマリーキー(主キー)は、テーブル内のレコードを個別に識別するために使用されるフィールドを指定します。[データログ機能](../Backup/log.md) を使用するためにはプライマリーキーを設定しなければなりません。 -You create, edit and/or remove primary keys directly using the context menu of the Structure editor or the [Primary key manager](#primary-key-manager). +ストラクチャーエディターのコンテキストメニューまたは[プライマリーキーマネージャー](#プライマリーキー-主キー-マネージャー) を使用して、直接プライマリーキーを作成/編集/削除することができます。 -> **Note:** Primary keys can also be set using the SQL language by means of the **PRIMARY KEY** clause followed by the list of columns. +> **注:** プライマリーキーは、SQL ランゲージにて**PRIMARY KEY** 節のあとカラムのリストを記述することでも作成することができます。 -#### Rules for using primary key fields +#### プライマリーキーフィールドの使用ルール -Primary key fields should be handled with care to ensure data integrity at all times. In particular, a primary key field must respect the following rules: +プライマリーキーフィールドは、データの整合性を保証するために常に細心の注意で管理すべきものです。具体的には、プライマリーキーフィールドは以下のルールを遵守する必要があります: -- it must not be empty, -- it must be unique, -- once created, it should (in principle) never be modified, especially if: - - [Global stamp features](../ORDA/global-stamp.md) are enabled, - - [REST (or similar) feature](../REST/gettingStarted.md) is enabled, - - the database is periodically synchronized (backup or logical mirror using the [log file](../Backup/log.md)). +- 空であってはいけません。 +- 固有(重複不可)でなければなりません。 +- 一度作成されたら、原則として変更してはなりません。以下のような場合には絶対変更してなりません: + - [グローバルスタンプ機能](../ORDA/global-stamp.md) が有効化されている + - [REST (あるいはそれに似た)機能](../REST/gettingStarted.md) が有効化されている + - データベースが([ログファイル](../Backup/log.md) を使用したバックアップあるいは論理ミラーを使用して)定期的に同期されている。 -Modifying primary key field value is highly discouraged, even if 4D allows it for specific use cases. -If you absolutely need to modify a primary key value (e.g. you used a social security number field as primary key and incorrect values have been entered), it is preferable to disable (remove) the current primary key and to add a new field used as primary key with automatic assignment. +プライマリーキーフィールドを変更することは、たとえ4D が特殊な場合に対して許可しているとしても、変更しないことが強く推奨されます。 +どうしてもプライマリーキーフィールドを変更しなくてはいけない場合(例：マイナンバーをプライマリーキーとして指定してしまい、誤った番号を入力してしまった、等)でも、変更する代わりにカレントのプライマリーキーを無効化(削除)して自動割り当てをつけた新しいフィールドを追加してプライマリーキーフィールドとして使用する方が望ましいです。 -Primary key fields can be long integer type or UUID format (alpha type). In most cases, we recommend the UUID format with the Auto UUID option enabled. Even though the long integer type takes up less disk space, UUIDs have many advantages, for example, facilitating the merge of independent databases, data import/export, implementation of elaborate mirror/replication strategies or synchronization with external systems. +プライマリーキーフィールドは、倍長整数型がUUIDフォーマット(文字型)が選べます。多くの場合、自動UUIDオプションを有効化したUUIDフォーマットの方が推奨されます。倍長整数型の方が使用するディスク容量が小さいのですが、UUID には他の多くの利点があります。例えば、独立したデータベースの統合が容易であったり、データの読み込み/書き出し、精巧なミラー/複製戦略の実装、あるいは外部システムとの同期、などにおいて有利です。 -#### Setting primary keys +#### プライマリーキーの設定 -To create a primary key from the Structure editor: +ストラクチャーエディターからプライマリーキーを作成するためには、以下の手順に従って下さい: -1. Select the field(s) that make up the table’s primary key. -2. Right-click and choose **Create primary key** in the context menu (this command is only displayed for fields whose type is eligible for primary keys). +1. テーブルのプライマリーキーを構成するフィールド(複数も可)を選択します。 +2. 右クリックでコンテキストメニューを表示し、**主キーを作成**を選択します(このコマンドは主キーとして使用可能な型のフィールドに対してのみ表示されます)。 -You cannot have more than one primary key for each table. If a primary key is already specified, a warning dialog box appears indicating that the existing primary key will first be disabled. +一つのテーブルにつき二つ以上のプライマリーキーを作成することはできません。プライマリーキーが既にテーブルにおいて指定されている場合、既存のプライマリーキーは無効化されるという旨の警告ダイアログボックスが表示されます。 -The primary key is created immediately. Fields included in the primary key are *underlined* in the editor and their SQL description displays the **PRIMARY KEY** keyword. +プライマリーキーは直ちに作成されます。プライマリーキーに含まれるフィールドはエディター上では下線が引かれ、インスペクターのSQL の詳細には**PRIMARY KEY** のキーワードが入ります。 -When you create a primary key in a table that already contains records (using an existing field or adding a new one), 4D checks the conformity of all the values present or automatically performs updating operations: +既にレコードが存在するテーブルに主キーを作成した場合(既存フィールドを使用、あるいは新規に追加した場合)、4D は存在している全ての値の適合性をチェックするか、あるいは自動的にアップデート操作を実行します: -- The field(s) belonging to the primary key cannot contain any duplicated values. If any duplicated values for the key exist in the table records, a warning dialog box appears to indicate that it is not possible to create the key because of this. -- If the duplicated values are blank or null values (case of an added key field), you can check the corresponding automatic generation option (for Alpha fields in or for Longint fields). - In this case, 4D examines all the records of the table and automatically assigns a calculated value to each primary key. Note that this process is sequential and may require a significant amount of time if there are a sizable number of records. +- 主キーに属しているフィールド内では重複している値を持つ事はできません。テーブルのレコード内に重複している値が存在していた場合、この値の為に主キーを作成する事ができない旨を示す警告ダイアログボックスが表示されます。 +- 重複した値が空の値、またはヌル値(追加されたフィールド)だった場合、それに対応する自動生成オプションをチェックする事ができます(文字フィールドでの自動UUID、または倍長整数フィールドでの自動インクリメント)。 + この場合、4D はテーブルの全てのレコードを検査し計算された値をそれぞれの主キーに自動的に割り当てます。ただし処理はシーケンシャルであり、レコードの数が大量であった場合、この処理に長い時間を要することがあるという点に注意して下さい。 -> **Note:** The column(s) belonging to the primary key do not accept NULL values. +> **注:** プライマリーキーに所属するカラムは、ヌル値を受け付けません。 -#### Removing primary keys +#### プライマリーキーの削除 -To remove a primary key from a table: +テーブルからプライマリーキーを削除するためには、以下の手順に従って下さい: -1. Right-click on the table containing the primary key and choose **Remove primary key** in the context menu: +1. プライマリーキーを含むテーブルを右クリックしてコンテキストメニューを表示し、**主キーを削除**を選択します。確認ダイアログが表示されます。プライマリーキーを削除するためには**OK**をクリックします。 -[picture here] +#### デフォルトのプライマリーキーフィールド -A confirmation dialog box appears. Click **OK** to remove the primary key. +新規に作成されるテーブルには全てデフォルトでプライマリーキーが含まれています。このフィールドは、デフォルトで名前が **"ID"** の倍長整数型のフィールドであり、特に以下の属性を持ちます: -#### Default primary key field +- 重複不可 +- ヌル値の入力を拒否 +- 自動インクリメント +- 自動インデックス -Every new table created in the database contains a primary key by default. This field, named **"ID"** by default, is of the Longint type, and has, in particular, the following attributes: - -- Unique, -- Reject NULL value input, -- Autoincrement, -- Automatic index. - -You can use this field as is, or change its name and/or its properties if you want (for example, you may want to use an UUID field). You can also delete it if you want to use another field (or fields) as primary key(s). However, it is strongly recommended to keep at least one primary key in each 4D table. +このフィールドはそのまま使用することもできますし、必要に応じて名前やプロパティを変更する事もできます (例えば UUID フィールドを使用する等)。また、他のフィールドをプライマリーキーとして使用する場合はプライマリーキーを削除することはできます。ただし、全ての 4D テーブルに最低一つずつプライマリーキーを用意しておくことが強く推奨されます。 :::note -In the [Structure page of the Preferences](../Preferences/structure.md), you can modify the name and type of the primary keys that are created by default. +[環境設定のストラクチャーページ](../Preferences/structure.md) にて、プライマリーキーのデフォルトの名前と型を変更することができます。 ::: :::info -Default primary keys are not added to tables that are created using the SQL **CREATE TABLE** command, or tables that are imported into the database. +デフォルトのプライマリーキーは、SQL **CREATE TABLE** コマンドを使用して作成されたテーブルやデータベースにインポートされたテーブルには追加されません。 ::: ## プライマリーキー(主キー)マネージャー -The **Primary key manager** is an assistant intended to facilitate the resolution of errors related to the presence of tables without primary keys, particularly in the context of a journaled database: +**プライマリーキー管理** (プライマリーキーマネージャー)というアシスタントウィンドウは、特にログを使用しているデータベースにおいて、プライマリーキーがないテーブルに起因するエラーの解消を手助けするためのものです: ![](../assets/en/Develop/pk-manager.png) -You can use this assistant to: +このアシスタントには以下の様な機能があります: -- diagnose the compatibility of each database table with the 4D journaling mechanism, -- propose a correction for each table found that is not compatible, more particularly by creating a primary key. +- データベースのそれぞれのテーブルと 4D のデータログのメカニズムとの競合性を検証します。 +- データログのメカニズム合致しないテーブルに対してそれぞれに解決方法を提示します。具体的にはプライマリーキーの作成です。 -### Accessing assistant +### アシスタントを表示 -There are two ways to display the **Primary key manager** window: +**プライマリーキー管理** ウィンドウを表示する方法は二通りあります: -- From the **Primary key error window**: click on the **Run assistant** button to display the assistant window. +- **プライマリーキーエラーウィンドウ** から表示: **アシスタントを起動**ボタンをクリックしてアシスタントウィンドウを表示します。 -**Note:** The Primary key manager is displayed in Design mode. If the database starts in Application mode, the assistant does not appear right away and you will need to switch to Design mode. +**注:** プライマリーキー管理はデザインモードで表示されます。データベースがアプリケーションモードで開かれた場合はアシスタントは直ちには表示されず、デザインモードへと切り替える必要があります。 -- From the **Structure editor**: click on the button in the [toolbar](./structure-editor.md#toolbar) of this window to display the assistant. +- **ストラクチャーエディター**から: ウィンドウの[ツールバー](./structure-editor.md#ツールバー) 内の新しいボタン をクリックするとアシスタントを表示できます。 -### Using the assistant +### アシスタントの使用 -The **Primary key manager** window displays a line for every table in the database: +**プライマリーキー管理**ウィンドウではデータベース内の全てのテーブルに関しての情報が行となって表示されます: ![](../assets/en/Develop/pk-1.png) -The assistant does not take tables placed in the Trash into account. +アシスタントはごみ箱に入っているテーブルは検知しません。 -The icon at the head of each line indicates whether the table requires the attention of the user: +それぞれの行の先頭にあるアイコンはテーブルの状態をユーザーに知らせます: -| アイコン | ステータス | 説明 | -| -------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ![](../assets/en/Develop/pk-icon1.png) | OK | A valid primary key is set for the table. | -| ![](../assets/en/Develop/pk-icon2.png) | No primary key, eligible field(s) | The table does not have a primary key but contains at least one field that could become the primary key. | -| ![](../assets/en/Develop/pk-icon3.png) | No primary key, no eligible fields | The table does not have a primary key and does not have any fields that could become one (you will have to create a primary key field). | -| ![](../assets/en/Develop/pk-icon4.png) | 警告 | The table does not have a primary key but it is not journaled ("Include in Log File" option disabled for the table). It is possible to hide tables that have this status by unchecking the option to display warnings. | +| アイコン | ステータス | 説明 | +| -------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| ![](../assets/en/Develop/pk-icon1.png) | OK | テーブルには有効なプライマリーキーがあります。 | +| ![](../assets/en/Develop/pk-icon2.png) | プライマリーキーなし、使用可能なフィールド有り | テーブルにはプライマリーキーがないものの、プライマリーキーとして使用できるフィールドが少なくとも一つは含まれています。 | +| ![](../assets/en/Develop/pk-icon3.png) | プライマリーキーも使用可能なフィールドもなし | テーブルにはプライマリーキーも、プライマリーキーとして使用できるフィールドもありません(プライマリーキーフィールドを作成する必要があります)。 | +| ![](../assets/en/Develop/pk-icon4.png) | 警告 | テーブルにはプライマリーキーがありませんが、データのログを取りません("ログファイルに含める"のオプションのチェックが外されています)。この状態のテーブルは、警告アイコンをクリックすることによって非表示にできます。 | -For each journaled table that does not have a primary key, the assistant displays a menu to set the action to be performed. You can choose from the following options: +データログを残すテーブルでプライマリーキーがないものに関して、アシスタントはそれぞれに実行すべきアクションを表示します。以下の選択肢から選ぶことができます: -- **Ignore:** does not modify the table. The errors are not corrected and the status of the table is not changed. Use this option if you wish to intervene later, or if you want to create the primary key outside of the assistant. This option is necessary in particular when you want to create a primary key based on several fields in the table. +- **無視:** テーブルに何も変更を加えません。エラーは修正されず、テーブルの状態は変更されません。後でエラーを修正したい場合、またはアシスタントを使用せずにエラーを修正したい場合などにはこのオプションを選択して下さい。このオプションは特に、複数のテーブルをもとにプライマリーキーを作成したい場合に必要です。 -- **Use existing field** (only shown for tables with at least one field eligible to be a primary key): designates one of the table fields as the primary key. When you choose this option, the assistant suggests the most appropriate field by default. If you want to use another field or if the assistant fails to identify a particularly suitable field (the assistant displays *Select a field*), click on the second menu in the row to display the list of eligible fields. +- **既存のフィールドを使用**(プライマリーキーとして使用可能なフィールドが少なくとも一つはあるテーブルにおいてのみ表示): テーブルのフィールドのどれかをプライマリーキーとして指定します。このオプションを選択すると、アシスタントはデフォルトでプライマリーキーとして最適なフィールドを選択して提示します。他のフィールドを使用したい場合、またはアシスタントが適切なフィールドを識別するのに失敗した場合(この場合アシスタントは *選択可能なフィールド* を表示します) などは、行の中の二つ目のメニューをクリックして選択可能なフィールドのリストを表示して下さい。 -- **Create a new field:** creates a new primary key field in the table. This field will have the same characteristics as the one [added by default when a new table is created](#default-primary-key-field). By default, the assistant proposes to create a field of the Longint type, named “ID”. You can modify the name and type of default primary key fields in the [Preferences](../Preferences/structure.md#primary-key). You can also change the name and/or type of the field directly in the Primary key manager window. +- **新規フィールドを作成:** テーブル内に新しいプライマリーキーを作成します。このフィールドは[新規テーブルが作成されたときのもの](#デフォルトのプライマリーキーフィールド) と同じ属性を持ちます。デフォルトでは、アシスタントは "ID" という名前の倍長整数型のフィールドが提示されます。このデフォルトのプライマリーキーの名前と型は[環境設定](../Preferences/structure.md#プライマリーキー)から変更することができます。プライマリーキー管理ウィンドウ内で直接テーブルの名前/型を変更することもできます。 -- **Do not log this table:** unchecks the [**Include in Log File**](#include-in-log-file) option for the table. You can choose this option in the case of temporary tables. After you validate this dialog box, a “Warning” status is assigned to the table. +- **このテーブルはログに含めない:** このテーブルに関しては[**ログファイルに含める**](#ログファイルに含める) のチェックを外します。一時的なテーブルなどの場合にこのオプションを選択することができます。ダイアログボックスを確定させると、"警告"の状態がテーブルへと適用されできます。 -Once you have made your settings, click on **Apply...** to apply the changes to the database or **Close** to close the dialog box without modifying the database. When you click on **Apply...**, a confirmation dialog box appears listing the operations to be performed; you can either confirm or cancel the operation. +設定が完了したら**適用...** をクリックして変更をデータベースに適用するか、データベースを変更せずに閉じる場合には**閉じる**をクリックして下さい。**適用...** をクリックすると、実行されるオペレーションの一覧がダイアログボックスに表示され、適用かキャンセルがクリックできます。 -If you have designated existing fields as primary keys, 4D checks each table to make sure that its existing data respects the rules concerning uniqueness and null values for this type of field. If, for example, a field contains duplicate values or null values, an error is generated. You will need to find and remove these anomalies before you can enable journaling for the data. +既存のフィールドをプライマリーキーとして使用した場合、4D はそれぞれのテーブルに関して、既存のデータがそのフィールドの型の固有性やヌル値の設定とあてはまるかどうかを検証します。もし、例えばフィールドが複製値やヌル値を含んでいた場合、エラーが生成されます。データログを有効にするためにはこれらのエラーを探して削除する必要があります。 :::note -In order to facilitate the correction of errors related to primary keys, the primary key values are displayed in the [**Activity analysis** page of the Maintenance and Security Center](../MSC/analysis.md). +プライマリーキーに関するエラーの修正を容易にするために、プライマリーキーの値は[MSCの **アクティビティ解析ページ**](../MSC/analysis.md) の中に表示されています。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Events/onAfterEdit.md index 76ddea797f7bfe..ff8eaa6d2868fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Events/onAfterEdit.md @@ -62,11 +62,11 @@ title: On After Edit #### action = DragFillBlock -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | 自動入力のために使用されるレンジ | -| autoFillType | longint | 自動入力のために使用される値。
  • 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | -| fillDirection | longint | フィルの方向
  • フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | +| プロパティ | 型 | 説明 | +| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | 自動入力のために使用されるレンジ | +| autoFillType | longint | 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | +| fillDirection | longint | フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | #### action = formulaChanged diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Extensions/develop-components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Extensions/develop-components.md index d5c863650c2e1e..66e74263c2b580 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Extensions/develop-components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Extensions/develop-components.md @@ -17,7 +17,7 @@ title: コンポーネントの開発 :::note -他の別のマトリックスプロジェクトを開くことなく、[ホストプロジェクトから直接コンポーネントを作成](#コンポーネントの作成) することができます。 +他の別のマトリクスプロジェクトを開くことなく、[ホストプロジェクトから直接コンポーネントを作成](#コンポーネントの作成) することができます。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/pictures.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/pictures.md index 0d21d56de45194..d7e13327bd0267 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/pictures.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/pictures.md @@ -57,10 +57,10 @@ title: ピクチャー 高解像度が自動的に優先されますが、スクリーンやピクチャーの dpi *(\*)*、およびピクチャー形式によって、動作に違いが生じることがあります: -| 演算 | 動作 | -| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
  • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
  • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    • | -| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | +| 演算 | 動作 | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    | +| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | *(\*) 通常は macOS = 72dpi, Windows = 96dpi* diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_Action.md index 6d9cbd7c33c021..e4a5e1851c7b3f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_Action.md @@ -5,7 +5,7 @@ title: 動作 ## メソッド -フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 +フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 メソッドが関連づけられているフォームに関わるイベントが発生した場合、4D は自動的にフォームメソッドを呼び出します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_FormProperties.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_FormProperties.md index 573e0869ca0eb3..df6571c758adc6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_FormProperties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormEditor/properties_FormProperties.md @@ -33,9 +33,9 @@ title: フォームプロパティ #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| --- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| css | string または collection | CSS file path(s) provided as:
  • a string (a file for both platforms)
  • a collection of strings (a list of files for both platform)
  • a collection of {"path":string;"media":"mac" | "windows"} objects
    • | +| 名称 | データタイプ | とりうる値 | +| --- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| css | string または collection | CSSファイルパス:
  • 文字列 (両方のプラットフォーム用に 1ファイル)
  • 文字列のコレクション (両プラットフォーム用のファイルのリスト)
  • {"path":string;"media":"mac" | "windows"} オブジェクトのコレクション
    • | --- diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/dropdownList_Overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/dropdownList_Overview.md index d2ce308c14c9e5..03c56440836808 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/dropdownList_Overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/dropdownList_Overview.md @@ -165,7 +165,7 @@ Form.myDrop.index //3 ## プロパティ一覧 -[Alpha Format](properties_Display.md#alpha-format) - [Bold](properties_Text.md#bold) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Data Type (expression type)](properties_DataSource.md#data-type-expression-type) - [Data Type (list)](properties_DataSource.md#data-type-list) - [Date Format](properties_Display.md#date-format) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Not rendered](properties_Display.md#not-rendered) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Standard action](properties_Action.md#standard-action) - [Save value](properties_Object.md#save-value) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [値を記憶](properties_Object.md#値を記憶) - [CSSクラス](properties_Object.md#cssクラス) - [データタイプ (セレクションおよびコレクションリストボックス列)](properties_DataSource.md#データタイプ-(リスト)) - [データタイプ](properties_DataSource.md#データタイプ-リスト) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [文字フォーマット](properties_Display.md#文字フォーマット) - [日付フォーマット](properties_Display.md#日付フォーマット) - [時間フォーマット](properties_Display.md#時間フォーマット) - [表示状態](properties_Display.md#表示状態) - [レンダリングしない](properties_Display.md#レンダリングしない) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [横揃え](properties_Text.md#横揃え) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox-object.md index 1203dc6f1f3213..77518af14c13a1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox-object.md @@ -27,7 +27,7 @@ LIST TO ARRAY("ListName";varCol) ## セレクションリストボックス -このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+“ ”[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 +このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+" "[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) や [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) コマンドを使用して、カラムをプログラムで変更することもできます。 それぞれの行はセレクションのレコードを基に評価されます。セレクションは **カレントセレクション** または **命名セレクション**です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox_overview.md index b5221f8ba1c50b..b1895b698f6a10 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/listbox_overview.md @@ -241,14 +241,14 @@ JSON フォームにおいて、リストボックスに次のハイライトセ 標準ソートのサポートは、リストボックスのタイプに依存します: -| リストボックスタイプ | 標準ソートのサポート | コメント | -| ------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | -| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | -| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。 この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照) | -| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | -| 命名セレクション | × | | -| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | +| リストボックスタイプ | 標準ソートのサポート | コメント | +| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | +| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | +| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    | +| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | +| 命名セレクション | × | | +| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | ### カスタムソート @@ -368,7 +368,7 @@ End if ### プレビューモード -プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。 とくに、表示されている以上の行を印刷することはできません。 +プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。とくに、表示されている以上の行を印刷することはできません。 ### 詳細モード diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Action.md index de6d70877b2e96..bfc0f24f59d090 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Action.md @@ -22,9 +22,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dragging | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dragging | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト @@ -54,9 +54,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dropping | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dropping | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md index 2757b8f0762a52..867942a71d02b2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Appearance.md @@ -31,9 +31,9 @@ Windows上では "推奨選択肢" の概念はサポートされていないた --- -## Display formula source as symbol +## フォーミュラのソースを記号として表示 -Displays source text of formulas as symbols when expressions are shown as references. +式が参照として表示される場合、フォーミュラのソーステキストを記号として表示します。 #### JSON 文法 @@ -155,7 +155,7 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show background and anchored elements +## 背景とアンカーされた要素を表示 ページの背景画像および背景色を表示/非表示にします。 @@ -175,9 +175,9 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show empty or unsupported images +## 空またはサポートされていない画像を表示 -Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). +読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示したり非表示にします。 #### JSON 文法 @@ -361,9 +361,9 @@ HTML WYSIWYG ビューを有効/無効にします。 このビューでは、 --- -## Show table borders +## 表組みの境界線を表示 -Displays internal and external table borders as dotted lines when these borders are partially or totally invisible. This facilitates page layout (more accessible, more visual resizing) and data entry (convenient in the case of merged cells, for example). +境界線が部分的または完全に非表示になっている場合には、表組の内部および外部の境界線を点線として表示します。これによりページレイアウト(よりアクセスしやすく、視覚的にリサイズしやすく)およびデータ入力(結合されたセルなどの場合に便利に)が容易になります。 ![](../assets/en/FormObjects/visible.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md index 3369cec50c56b2..50fc0397990391 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_Object.md @@ -139,9 +139,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | +| 名称 | データタイプ | とりうる値 | +| ---------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | ### 式 @@ -212,9 +212,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。 *配列/セレクションリストボックスのみ*: "integer", "object"
    • *配列/セレクションリストボックスのみ*: "integer", "object" | +| 名称 | データタイプ | とりうる値 | +| ------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。*配列/セレクションリストボックスのみ*: "integer", "object"
    • | #### 対象オブジェクト @@ -274,7 +274,7 @@ title: オブジェクト コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。 -コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、 [`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: +コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、[`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: - オブジェクトのコレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: `This.`。 - エンティティセレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: `This.`。 @@ -392,15 +392,15 @@ title: オブジェクト | 計算タイプ | Num | Text | Date | Time | Bool | Pict | フッター変数の型 | | ---------------------------------------- | --- | ---- | ---- | ---- | ---- | ---- | -------- | -| 最小 | X | X | X | X | X | | 列の型と同じ | -| 最大 | X | X | X | X | X | | 列の型と同じ | -| 合計 | X | | | X | X | | 列の型と同じ | -| カウント | X | X | X | X | X | X | Integer | -| 平均 | X | | | X | | | Real | -| 標準偏差(\*) | X | | | X | | | Real | -| 分散(\*) | X | | | X | | | Real | -| 平方和(\*) | X | | | X | | | Real | -| カスタム (JSON では "none") | X | X | X | X | X | X | 制限なし | +| 最小 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 最大 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 合計 | ○ | | | ○ | ○ | | 列の型と同じ | +| カウント | ○ | ○ | ○ | ○ | ○ | ○ | Integer | +| 平均 | ○ | | | ○ | | | Real | +| 標準偏差(\*) | ○ | | | ○ | | | Real | +| 分散(\*) | ○ | | | ○ | | | Real | +| 平方和(\*) | ○ | | | ○ | | | Real | +| カスタム (JSON では "none") | ○ | ○ | ○ | ○ | ○ | ○ | 制限なし | (\*) 配列型のリストボックスのみ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_RangeOfValues.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_RangeOfValues.md index c598240b01fbb0..f34fb508c50ab2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_RangeOfValues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/FormObjects/properties_RangeOfValues.md @@ -17,22 +17,21 @@ title: 値の範囲 日付、時刻、シーケンス番号については、4D が提供する記号を使用することができます。日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: -| スタンプ | 意味 | -| ---- | ------- | -| #D | 本日の日付 | -| #H | 現在の時刻 | -| #N | シーケンス番号 | +| 記号 | 意味 | +| -- | ------- | +| #D | 本日の日付 | +| #H | 現在の時刻 | +| #N | シーケンス番号 | -カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。 For more information, refer to the [Autoincrement](../Develop/structure-fields#autoincrement) paragraph. +カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。詳細については [自動インクリメント](../Develop/structure-fields#自動インクリメント) を参照ください。 -> このプロパティと、リストボックス列に固定値を表示させるための -> "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 +> このプロパティと、リストボックス列に固定値を表示させるための "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | -| defaultValue | string | Any value and/or a stamp as a string: "#D", "#H", "#N", "42", "true"... | +| 名称 | データタイプ | とりうる値 | +| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------ | +| defaultValue | string | 任意の値や、特定の記号の文字列: "#D", "#H", "#N", "42", "true"... | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/GettingStarted/creating.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/GettingStarted/creating.md index 6efe720ddc5eae..cb674d031cf94b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/GettingStarted/creating.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/GettingStarted/creating.md @@ -11,12 +11,12 @@ title: プロジェクトの作成・開始 1. 4D または 4D Server を起動します。 2. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*新規 > プロジェクト...\*\*を選択します: ![](../assets/en/getStart/projectCreate-1.png) - - (4D のみ) **新規** ツールバーボタンより \*\*プロジェクト...\*\*を選択します:

    ![](../assets/en/getStart/projectCreate-2.png)
    標準の **保存** ダイアログが表示され、4D プロジェクトの名前と保存場所を指定します。 + - **ファイル** メニューより **新規** > **プロジェクト...** を選択します: ![](../assets/en/getStart/projectCreate-1.png) + - (4D のみ) **新規** ツールバーボタンより **プロジェクト...** を選択します:

    ![](../assets/en/getStart/projectCreate-2.png)
    標準の **保存** ダイアログが表示され、4Dプロジェクトの名前と保存場所を指定します。 :::note -**データベース...** および **ストラクチャー定義を使用したデータベス...** の項目は、環境設定において[**バイナリー形式のデータベース作成を有効化する** オプション](../Preferences/general.md#バイナリー形式のデータベース作成を有効化する) をチェックしている場合にのみ利用可能です。 +**データベース...** および **ストラクチャー定義を使用したデータベース...** の項目は、環境設定において[**バイナリー形式のデータベース作成を有効化する** オプション](../Preferences/general.md#バイナリー形式のデータベース作成を有効化する) をチェックしている場合にのみ利用可能です。 ::: @@ -37,7 +37,7 @@ OS によって許可されている名称であれば使用可能です。し 1. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*開く ＞ ローカルプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **ローカルプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 - Welcome ウィザードにて **ローカルアプリケーションプロジェクトを開く** を選択します。 標準のファイルを開くためのダイアログが表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/encrypt.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/encrypt.md index 4e35b338fa43cd..e013daddc5aa76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/encrypt.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/encrypt.md @@ -47,7 +47,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう 暗号化プロセスが正常に完了した場合、暗号化ページは 暗号化メンテナンスオペレーション ボタンを表示します。 -**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデーファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 +**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデータファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 ## 暗号化メンテナンスオペレーション @@ -86,7 +86,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ### パスフレーズを変更してデータを再暗号化する -この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスプレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 +この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスフレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 1. **パスフレーズを変更してデータを再暗号化する** をクリックします。 2. カレントのデータ暗号化キーを入力します。 @@ -110,7 +110,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ## 暗号化キーを保存する -4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。 なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 +4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 新しいパスフレーズが提供されるたびに暗号化キーを保存することができます: @@ -121,7 +121,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう :::caution -[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。 できない場合には、エラーが発生します。 +[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。できない場合には、エラーが発生します。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/overview.md index 000f1c827ccdce..bf793a36332bd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/MSC/overview.md @@ -14,7 +14,7 @@ MSCウィンドウを開く方法は幾つかあります。アクセスの方 メンテナンスモードでは、MSCウィンドウだけが表示されます (4Dアプリケーションはプロジェクトを開きません)。つまり、損傷が激しいため 4D が標準モードで開けないプロジェクトにもアクセスできるということです。さらに、特定の操作 (圧縮、修復など) はプロジェクトをメンテナンスモードで開くことを要求します ([アクセス権](#アクセス権) 参照)。 -次の 2つの場所から、MSC をメインテナンスモードで開くことができます: +次の 2つの場所から、MSC をメンテナンスモードで開くことができます: - **標準の開くダイアログボックス** 標準のプロジェクトを開くダイアログボックスには **開く** ボタンに関連付けられているメニューに **Maintenance & Security Center** オプションが含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Menus/sdi.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Menus/sdi.md index 587307a3951187..e91acd22715013 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Menus/sdi.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Menus/sdi.md @@ -17,7 +17,7 @@ SDIモードは以下の実行環境に限り利用可能です: - Windows - 組み込みの [スタンドアロン](../Desktop/building#スタンドアロンアプリケーションをビルド) または [クライアント](../Desktop/building#クライアントアプリケーションをビルド) 4Dアプリケーション -- **実行** メニューにて提供されている [\*\* アプリケーションをテスト\*\* 機能](bars.md#メニューバーのプレビュー) から利用可能です。 +- **実行** メニューにて提供されている [**アプリケーションをテスト** 機能](bars.md#メニューバーのプレビュー) から利用可能です。 ## SDIモードの有効化 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/glossary.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/glossary.md index 5bd6df1059360b..d552d0e730e6fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/glossary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/glossary.md @@ -127,7 +127,7 @@ $myClass.query("name = smith") ## ミックスデータ型 -このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : +このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。これには以下が含まれます: - number - text @@ -211,9 +211,9 @@ ORDA オブジェクトとは関わりのないユーザークラス。 シャロウコピーは、要素の構造のみを複製し、同じ内部参照を保持します。シャロウコピーのあと、二つのコレクションに格納された個々の要素は同じものが共有されています。ディープコピー も合わせて参照してください。 -## スタンプ +## 記号 -"オプティミステック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 +"オプティミスティック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 ## ストレージ属性 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/privileges.md index 202ebf24877e1f..152a9ae07d86a3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/privileges.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ORDA/privileges.md @@ -58,7 +58,7 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ - エイリアス属性の元である属性に対するアクセス権をセッションが持っていない場合でも、[エイリアス属性](./ordaClasses.md#エイリアス属性-1) へのアクセス権があれば、これを読み取ることができます。 - 計算属性を構成する属性に対するアクセス権をセッションが持っていない場合でも、[計算属性](./ordaClasses.md#計算属性-1) へのアクセス権があれば、これを読み取ることができます。 -- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型）に適用されます。 +- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型) に適用されます。 - [`promote()`](../API/SessionClass.md#promote) および [`demote()`](../API/SessionClass.md#demote) 関数を使用することで、Web プロセスに対して動的に **promote** アクションを設定/削除することができます。 - デフォルト値: 現在の実装では、*Null* のみデフォルト値として利用可能です。 - REST の [強制ログインモード](../REST/authUsers.md#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/compiler.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/compiler.md index 1877e9dc0b78e9..5e247b7dd47f13 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/compiler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/compiler.md @@ -67,7 +67,7 @@ title: コンパイル ::: -コンパイル中のコンポーネントの一覧がコンパイラウィンドウ内に表示されます。コンポーネント内でエラーが検知された場合、そのコンパイルは停止されますがその他のコンポーネントに対しての処理は継続されます。 +コンパイル中のコンポーネントの一覧がコンパイラーウィンドウ内に表示されます。コンポーネント内でエラーが検知された場合、そのコンパイルは停止されますがその他のコンポーネントに対しての処理は継続されます。 - コンポーネントに少なくとも一つのエラーがある場合には**太字**で表示され、エラーリストを展開して表示することができます。 - コンポーネントに少なくとも一つの警告がある場合には、警告のリストを展開して表示することができます。 @@ -78,7 +78,7 @@ title: コンパイル ホストプロジェクトからのコンパイルの対象になり得るためには、コンポーネントは以下の要件に合致している必要があります: - コンポーネントは[プロジェクトアーキテクチャー](../Project/architecture.md) を使用している -- コンポーネントの[インタープリタコード](../Concepts/interpreted.md) が利用可能であり、コンポーネントが[コンパイルモードで実行中](#run-compiled) ではない +- コンポーネントの[インタープリターコード](../Concepts/interpreted.md) が利用可能であり、コンポーネントが[コンパイルモードで実行中](#run-compiled) ではない - コンポーネントが[直接型指定](#直接型指定の有効化) 宣言を使用している。 :::note @@ -326,7 +326,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.xml` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/components.md index 0702fcad827c72..2e5cce67053f90 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Project/components.md @@ -22,7 +22,7 @@ title: 依存関係 - **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。[プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 - **コンパイル版コンポーネント**の場合: - - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー推奨されるアーキテクチャー) + - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー (推奨されるアーキテクチャー) - *Resources* などの他のフォルダーを格納している.4DZ ファイル。 :::note @@ -90,7 +90,7 @@ title: 依存関係 **優先度高** 1. [プロジェクトの **Components** フォルダー](architecture.md#components) に置かれているコンポーネント -2. dependencies.json\*\*ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 +2. **dependencies.json**ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 3. 内部のユーザー4Dコンポーネント (4D NetKit、4D SVG など) **優先度低** @@ -505,7 +505,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ [GitHub または GitLab 依存関係](#components-stored-on-git-hosting-platforms) を追加する場合: -1. パネルのフッターエリア内の\*\*[+]\*\* をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 +1. パネルのフッターエリア内の **[+]** をクリックし、追加したいプラットフォームに対応したタブを次から選択します: **GitHub** または **GitLab**。 ![dependency-add-git](../assets/en/Project/dependency-add-git.png) @@ -614,7 +614,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ これに加えて、単一の依存関係あるいは全ての依存関係に対して、いつでも更新をチェックすることができます: -- 単一の依存関係に対して更新をチェクするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 +- 単一の依存関係に対して更新をチェックするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 ![check component](../assets/en/Project/check-component-one.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$entityset.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$entityset.md index 191d18512b9287..633d4704c073ec 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$entityset.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$entityset.md @@ -93,7 +93,7 @@ title: $entityset ## $entityset/$release -[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します). +[4D Server のキャッシュ](./$info.md) から、一つ以上の既存のエンティティセットを削除します。 ### 説明 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$filter.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$filter.md index c9e152f4e7e709..d1faeac4f05451 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$filter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/$filter.md @@ -23,7 +23,7 @@ title: $filter **\{attribute\} {comparator} {value} {AND/OR/EXCEPT} \{attribute\} {comparator} {value}** -たとえば: `$filter="firstName=john AND salary>20000"` （`firstName` および `salary` は Employee データクラスの属性です)。 +たとえば: `$filter="firstName=john AND salary>20000"` (`firstName` および `salary` は Employee データクラスの属性です)。 ### paramsプロパティの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/ClassFunctions.md index 6a84eede161efe..657a3c0f726e83 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/ClassFunctions.md @@ -10,8 +10,7 @@ REST リクエストを使って、ORDA データモデルに定義されてい - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 -POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、 -よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 +POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 ## 関数の呼び出し diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/configuration.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/configuration.md index 5665216ee1b06e..0bba35e45972d1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/configuration.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/REST/configuration.md @@ -72,7 +72,7 @@ REST 経由でアクセス可能なデータストアオブジェクトを制限 2. フィールドの **RESTリソースとして公開** オプションの選択を解除します。
    ![alt-text](../assets/en/REST/field.png)
    - Repeat this for each field whose exposure needs to be modified. + 公開設定を変更する各フィールドに対して、この手順を繰り返します。 > あるフィールドが REST を通してアクセス可能であるためには、その親テーブルも公開されている必要があります。親テーブルが公開されていない場合、各フィールドの公開設定に関わらず、すべてのフィールドがアクセス不可になります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ServerWindow/real-time-monitor.md index 85bd17028b0890..00f65b61dd81e9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ServerWindow/real-time-monitor.md @@ -9,7 +9,7 @@ title: リアルタイムモニターページ > このページは、サーバーマシンの管理ウィンドウにありますが、リモートの 4Dマシンからも見られます。リモートマシンの場合は、サーバーマシン上で実行されている操作のデータを表示します。 -データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます。 +データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます)。 各行について、以下の情報が表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Tags/transformation-tags.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Tags/transformation-tags.md index dc98e8c94fccd7..dcd9855d063c4d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Tags/transformation-tags.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/Tags/transformation-tags.md @@ -45,7 +45,7 @@ title: 変換タグ ### 再起的処理 -4Dタグは繰り返し解釈されます。 4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: +4Dタグは繰り返し解釈されます。4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: ```html @@ -61,7 +61,7 @@ title: 変換タグ ### "." を小数点として使用 -4D は常にピリオド文字 (.) `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 +4D は常にピリオド文字 (.) を小数点として使用して、 `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 ## 4DBASE @@ -631,7 +631,7 @@ return String(Current date) #### 代替シンタックス: `$4DTEXT(expression)` -タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: +タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: ```html

    へようこそ！

    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/classes.md index a8fa417ac13cf7..45c42624fbbc85 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/classes.md @@ -213,7 +213,7 @@ title: クラス **.borderHorizontal** : [cs.ViewPro.LineBorder](#lineborder) -`.borderBottom` プロパティは、 表の横の外枠線を定義します 。 +`.borderHorizontal` プロパティは、 表の横の外枠線を定義します 。 ### .borderVertical diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-copy-to-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-copy-to-object.md index 8373879821bfe1..4321e884cfd3de 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-copy-to-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-copy-to-object.md @@ -36,10 +36,10 @@ title: VP Copy to object 任意の *options* 引数として、以下のプロパティを渡すことができます。 -| プロパティ | 型 | 説明 | -| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| copy | Boolean | コマンド実行後もコピーされた値、書式、数式が保持するには *true* (デフォルト)。削除するには *false*。 | -| copyOptions | Integer | コピーまたは移動する内容を指定します。とりうる値:

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

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

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

    | [ワークブックオプション](vp-set-workbook-options.md) で定義されている貼り付けオプションが考慮されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-export-to-blob.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-export-to-blob.md index 9ce0558e2439ab..9e422fd3f62e78 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-export-to-blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-export-to-blob.md @@ -21,7 +21,7 @@ title: VP EXPORT TO BLOB ## 説明 -`VP EXPORT TO BLOB` コマンドは、*vpAreaName* で指定した 4D View Pro エリアの 4D View Pro ドキュメントを、*paramObj* で指定したとおりに 4D.Blob に書き出します。 エクスポートされた Blob は、コールバックを通して利用可能です。 4D View Pro エリアを Blob でエクスポートおよびインポートすることは高速で、メモリ効率に優れています。 +`VP EXPORT TO BLOB` コマンドは、*vpAreaName* で指定した 4D View Pro エリアの 4D View Pro ドキュメントを、*paramObj* で指定したとおりに 4D.Blob に書き出します。エクスポートされた Blob は、コールバックを通して利用可能です。 4D View Pro エリアを Blob でエクスポートおよびインポートすることは高速で、メモリ効率に優れています。 *paramObj* には、複数のプロパティを渡せます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-find.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-find.md index 703b52a5cc3de1..419c18e2d87f97 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-find.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-find.md @@ -32,14 +32,14 @@ title: VP Find 任意の *searchCondition* 引数を渡すことで、検索がどのように実行されるかを指定することができます。以下のプロパティがサポートされています: -| プロパティ | 型 | 説明 | -| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| afterColumn | Integer | 検索を開始するカラムの直前のカラムの番号。 *rangeObj* 引数が統合されたレンジの場合、渡されるカラムの番号は最初のレンジのものでなければなりません。デフォルト値: -1 (*rangeObj* の最初) | -| afterRow | Integer | 検索を開始する行の直前の行番号。 *rangeObj* 引数が統合されたレンジの場合、渡される行番号は最初のレンジのものでなければなりません。デフォルト値: -1 (*rangeObj* の最初) | -| all | Boolean |
  • true - *rangeObj* 内で *searchValue* の値に合致するセルはすべて返されます。
  • false - (デフォルト値) *rangeObj* 内で *searchValue* の値に合致する最初のセルのみが返されます。
    • | -| flags | Integer |
    `vk find flag exact match`セルの中身全体が検索値と完全に一致する必要があります
    `vk find flag ignore case`文字の大小は区別されません。例: "a" と "A" は同じとみなされます。
    `vk find flag none`検索フラグは指定されていません (デフォルト)。
    `vk find flag use wild cards`検索文字列においてワイルドカード文字 (\*,?) を使用できます。ワイルドカードは、すべての文字列の比較に使用することができ、ワイルドカードによって置き換わる文字の数は指定されません:
  • \* は 0 から複数文字に使用可能です (例: "bl*" を検索した場合、"bl"、"black"、"blob" などが合致します)。
  • ? は単一文字に使用可能です (例: "h?t" を検索した場合、"hot"、"hit" などが合致します)。
    • フラグは組み合わせることができます。例: $search.flags:=vk find flag use wild cards+vk find flag ignore case | -| order | Integer |
    `vk find order by columns`検索がカラムごとに実行されます。カラムの各行が検索されたあとに次のカラムへと移動します。
    `vk find order by rows`検索が行ごとに実行されます。行の各カラムが検索されたあとに次の行へと移動します (デフォルト)。
    | -| target | Integer |
    `vk find target formula`セルフォーミュラ内で検索がおこなわれます。
    `vk find target tag`セルタグ内で検索がおこなわれます。
    `vk find target text`セルテキスト内で検索がおこなわれます (デフォルト)。

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

    | +| プロパティ | 型 | 説明 | +| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| afterColumn | Integer | 検索を開始するカラムの直前のカラムの番号。 *rangeObj* 引数が統合されたレンジの場合、渡されるカラムの番号は最初のレンジのものでなければなりません。デフォルト値: -1 (*rangeObj* の最初) | +| afterRow | Integer | 検索を開始する行の直前の行番号。 *rangeObj* 引数が統合されたレンジの場合、渡される行番号は最初のレンジのものでなければなりません。デフォルト値: -1 (*rangeObj* の最初) | +| all | Boolean |
  • true - *rangeObj* 内で *searchValue* の値に合致するセルはすべて返されます。
  • false - (デフォルト値) *rangeObj* 内で *searchValue* の値に合致する最初のセルのみが返されます。
    • | +| flags | Integer |
    `vk find flag exact match`セルの中身全体が検索値と完全に一致する必要があります
    `vk find flag ignore case`文字の大小は区別されません。例: "a" と "A" は同じとみなされます。
    `vk find flag none`検索フラグは指定されていません(デフォルト)
    `vk find flag use wild cards`検索文字列においてワイルドカード文字(\*,?)を使用を使用できます。ワイルドカードは、すべての文字列の比較に使用することができ、ワイルドカードによって置き換わる文字の数は指定されません:
  • \* は 0 から複数文字に使用可能です (例: "bl*" を検索した場合、"bl"、"black"、"blob" などが合致します)。
  • ? は単一文字に使用可能です (例: "h?t" を検索した場合、"hot"、"hit" などが合致します)。
    • フラグは組み合わせることができます。例: $search.flags:=vk find flag use wild cards+vk find flag ignore case | +| order | Integer |
    `vk find order by columns`検索がカラムごとに実行されます。カラムの各行が検索されたあとに次のカラムへと移動します。
    `vk find order by rows`検索は行ごとに実行されます。行の各カラムが検索されたあとに次の行へと移動します (デフォルト)。
    | +| target | Integer |
    `vk find target formula`セルフォーミュラ内で検索がおこなわれます。
    `vk find target tag`セルタグ内で検索がおこなわれます。
    `vk find target text`セルテキスト内で検索がおこなわれます (デフォルト)。

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

    | 任意の *replaceValue* 引数として、*rangeObj* 内で見つかった *searchValue* の値のテキストを置換するテキストを渡すことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-get-print-info.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-get-print-info.md index 1ebbd5342a3026..bd331afbd67715 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-get-print-info.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-get-print-info.md @@ -24,7 +24,7 @@ title: VP Get print info `VP Get print info` コマンドは、*vpAreaName* 引数で指定したエリアの印刷属性を格納したオブジェクトを返します。 -*vpAreaName* には、4D View Pro エリアの名前を渡します。 存在しない名前を渡した場合、エラーが返されます。存在しない名前を渡した場合、エラーが返されます。存在しない名前を渡した場合、エラーが返されます。 +*vpAreaName* には、4D View Pro エリアの名前を渡します。存在しない名前を渡した場合、エラーが返されます。 任意の *sheet* 引数として、シートのインデックス (0 起点) を渡すことで、印刷属性を取得するスプレッドシートを指定することができます。省略された場合、または `vk current sheet` を渡した場合、カレントスプレッドシートが使用されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-set-allowed-methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-set-allowed-methods.md index b3f7839d769622..c4402d1853e2f4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/commands/vp-set-allowed-methods.md @@ -26,7 +26,7 @@ title: VP SET ALLOWED METHODS `VP SET ALLOWED METHODS` コマンドは、4D View Pro フォーミュラから呼び出し可能なプロジェクトメソッドを指定します。このコマンドは、呼び出し後のセッション中に初期化される 4D View Pro エリアすべてに対して適用されます。同じセッション中において異なる設定で初期化をするために、複数回呼び出すこともできます。 -セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照)。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 +セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照))。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 *methodObj* には、4D View Pro エリア内で定義したいファンクションの名前をプロパティとして格納しているオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/configuring.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/configuring.md index 06097e8c84dc57..2fd697a282b332 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/configuring.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/configuring.md @@ -141,7 +141,7 @@ title: 4D View Pro エリアの設定 | 0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 | | 。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 | | , | 数値内に千区切りのカンマを表示します。数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 | -| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | +| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( や _) のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | | @ | テキストのフォーマット文字。セル内のすべてのテキストにフォーマットを適用します。 | "\[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 | | \* | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0\*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、\*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 | | " " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 | @@ -165,17 +165,17 @@ VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_ 4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています: -| 定数 | 値 | 説明 | -| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | -| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | -| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | -| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。 アメリカ合衆国でのデフォルトパターン: "MMMM dd" | -| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。 アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | -| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm" | -| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | -| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | -| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。 アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | +| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | +| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | +| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" | +| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | +| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" | +| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | +| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | +| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | #### 例題 @@ -339,9 +339,9 @@ VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time"; | firstPageNumber | longint | 最初のページに印刷するページ番号。 デフォルト値 = 1 | | pageOrder | longint | ページの印刷順。とりうる値: `vk print page order auto` (デフォルト), `vk print page order down then over`, `vk print page order over then down`. | | pageRange | text | 印刷されるページの範囲 | -| qualityFactor | longint | 印刷の品質指定 (1 - 8)。印刷の品質指定 (1 - 8)。 高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    デフォルト値 = 2

    | -| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    デフォルト値 = true

    | -| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    デフォルト値 = 1

    | +| qualityFactor | longint | 印刷の品質指定 (1 - 8)。高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    | +| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    | +| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    | ### 用紙サイズ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/formulas.md index c116d1342e49e5..07d3871922968b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/formulas.md @@ -217,7 +217,7 @@ $o.DRIVERS_LICENCE.parameters.push(New object("name"; "ID"; "type"; Is longint)) サポートされている引数の型の詳細については、[VP SET CUSTOM FUNCTIONS](commands/vp-set-custom-functions) コマンドの説明を参照ください。 -引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、 それらの型は自動的に変換されます。 +引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、それらの型は自動的に変換されます。 日付およびオブジェクト引数は次のように扱われます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/getting-started.md index c8a25208010148..3af63f8bcebdd4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/ViewPro/getting-started.md @@ -8,7 +8,7 @@ title: はじめに ![](../assets/en/ViewPro/vpSpreadsheet.png) スプレッドシートとは、セルのグリッドを格納したアプリケーションのことで、これらのセルに情報を入力したり、計算を実行させたり、あるいはピクチャーを表示したりすることができます。 4D View Proは、4Dに統合された [SpreadJS スプレッドシートソリューション](https://developer.mescius.com/spreadjs) に基づいて動作します。
    -(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します） +(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します) :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/authentication.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/authentication.md index d6d10cc16b7cac..c96f14eac97f63 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/authentication.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/authentication.md @@ -150,7 +150,7 @@ BASICモードと同様に、ユーザーは接続時に自分の名前とパス `$IPClient` 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 #### $IPServer - サーバーIP アドレス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/httpRequests.md index 85b2cec25b2465..e9df1e44ef2ee1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/httpRequests.md @@ -85,7 +85,7 @@ title: HTTPリクエストの処理 $BrowserIP 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 ### $ServerIP - サーバーIP アドレス @@ -99,8 +99,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ ## /4DACTION -\*\*/4DACTION/\*\**MethodName*
    -\*\*/4DACTION/\*\**MethodName/Param* +**/4DACTION/***MethodName*
    +**/4DACTION/***MethodName/Param* | 引数 | 型 | | 説明 | | ---------- | ---- | :-: | --------------------- | @@ -111,8 +111,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。メソッドはこの引数を受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 -- `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。属性がチェックされていない場合、Webリクエストは拒否されます。 +- `/4DACTION/MethodName/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -120,7 +120,7 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND TEXT` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インターフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 @@ -150,7 +150,7 @@ WEB SEND BLOB($BLOB;"image/png") ### 4DACTION を使用してフォームをポスト -4D Webサーバーでは、ポストされたフォームを使用することもできます。 これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 +4D Webサーバーでは、ポストされたフォームを使用することもできます。これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 フォームは 2つのメソッドを使用してサブミットできます (4D では両方のタイプを使用できます): diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/sessions.md index f45fb1de24ae42..994dc802e2efe1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/sessions.md @@ -3,7 +3,7 @@ id: sessions title: Webセッション --- -4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 +4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 Webセッションでは、以下のことが可能です: @@ -28,8 +28,7 @@ Webセッションでは、以下のことが可能です: Webセッションは次のものに使用されます: -- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する - [Web アプリケーション](gettingStarted.md) +- HTTP リクエスト([SOAP Web サービス](../commands/theme/Web_Services_Server) および [/4DACTION](../WebServer/httpRequests.md#4daction) リクエストを含む)を送信する [Web アプリケーション](gettingStarted.md) - [リモートデータストア](../ORDA/remoteDatastores.md) や [Qodly ページ](https://developer.4d.com/qodly/) が使用する [REST API](../REST/authUsers.md) への呼び出し。 ## Webセッションの有効化 {#enabling-web-sessions} @@ -38,13 +37,13 @@ Webセッションは次のものに使用されます: - ストラクチャー設定の Web / オプション (I) ページの **スケーラブルセッション** を使用する (永続的な設定): ![alt-text](../assets/en/WebServer/settingsSession.png) -このオプションは、新規プロジェクトではデフォルトで選択されています。これは、 **セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 +このオプションは、新規プロジェクトではデフォルトで選択されています。これは、**セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 -- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します）。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 +- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します)。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 > メインの Webサーバーのセッションモードは、[`WEB SET OPTION`](../commands/web-set-option) コマンドを使って設定することもできます。 -いずれの場合も、設定はマシンに対しローカルなものです。 つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 +いずれの場合も、設定はマシンに対しローカルなものです。つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 > **互換性について**: 4D v18 R6 以前の 4Dバージョンで作成されたプロジェクトでは、**旧式セッション** オプションが使用できます (詳細については、[doc.4d.com](https://doc.4d.com) の Webサイトを参照ください)。 @@ -58,13 +57,13 @@ Webセッションは次のものに使用されます: ::: -1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID__AppName_" cookie の存在と値をチェックします。 +1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID_*AppName*" cookie の存在と値をチェックします。 2. cookie に値がある場合、4D は既存セッションの中からこのクッキーを作成したセッションを探し、見つかった場合には再利用します。 3. クライアントからのリクエストが、すでに開かれているセッションに対応していない場合: -- プライベートな "4DSID__AppName_" cookie を持つ新しいセッションが Webサーバー上に作成されます。 +- プライベートな "4DSID_*AppName*" cookie を持つ新しいセッションが Webサーバー上に作成されます。 - 新しいゲスト `Session` オブジェクトが作成され、このスケーラブルWebセッション専用に使用されます。 :::note @@ -488,7 +487,7 @@ Function validateEmail() : 4D.OutgoingMessage セッショントークンにはライフスパン(有効期限)があり、またセッション自身にもライフスパンがあります。セッショントークンのライフスパンは、[トークン作成時](../API/SessionClass.md#createotp) に設定することが可能です。デフォルトで、トークンのライフスパンは[`.idleTimeout`](../API/SessionClass.md#idletimeout) の値と同じ値となっています。 -セッショントークンのライフパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 +セッショントークンのライフスパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/templates.md index a330c809b15b83..1e9e4d1273f352 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/templates.md @@ -69,14 +69,14 @@ title: テンプレートページ 内部的には、パーサーは UTF-16 文字列で動作しますが、解析するデータは異なる方法でエンコードされている場合があります。タグにテキストが含まれている場合 (`4DHTML` など)、提供されている情報 (charset) や出所に応じて、4D は必要に応じてデータを変換します。以下に、HTMLページに含まれるタグを 4D が解析する場合と、おこなわれる変換を示します: -| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | -| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND TEXT` | X | - | 変換は不要です。 | -| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | +| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | +| ---------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND TEXT` | X | - | 変換は不要です。 | +| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | (\*) 4DHTML、4DTEXT、4DEVALタグにおいては、代替の $ベースシンタックスが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/webServerConfig.md index ead05535cfbb3c..1ecd21cb2aa8cb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WebServer/webServerConfig.md @@ -64,7 +64,7 @@ Webサーバー用の TLS証明書ファイルが置かれているフォルダ | ---------------- | -------------------------------------------------- | ---- | | webServer オブジェクト | [`cipherSuite`](API/WebServerClass.md#ciphersuite) | Text | -セキュアプロトコルに使用される暗号リストです。 Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 +セキュアプロトコルに使用される暗号リストです。Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 > 4D が使用するデフォルトの暗号リストは、`SET DATABASE PARAMETER` コマンドを使用してセッションごとに変更することができます。この場合、変更は 4Dアプリケーション全体に適用されます (Webサーバー・SQLサーバー・クライアント/サーバー接続、HTTPクライアント、セキュアプロトコルを使用するすべての 4Dコマンドを含む)。 @@ -161,7 +161,7 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" | `WEB SET OPTION` | `Web CORS enabled` | 0 (デフォルト値; 無効) または 1 (有効) | | 設定ダイアログボックス | [オプション (II) ページ / CORSを有効化](../settings/web.md#corsを有効化) | デフォルトではチェックなし | -4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 +4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。後述の CORSSettings 参照)。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 無効化されている場合 (デフォルト) には、CORS で送信されたサイト間リクエストはすべて無視されます。 @@ -255,7 +255,7 @@ HTTP接続を受け付ける IP (TCP) ポート番号。デフォルトで、4D デフォルトでない HTTPポート番号を使用して公開された Webアプリケーションに接続するには、Webブラウザーで入力するアドレスにポート番号を含めなければなりません。アドレスの後にコロンに続けてポート番号を指定します。たとえば、HTTPポート番号 8080を使用する場合、"123.4.567.89:8080" のように書きます。 -> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。 また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 +> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 0 を指定すると、4D はデフォルトの HTTPポート番号 80を使用します。 @@ -320,7 +320,7 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。デフォル - **TCPポートが使用済みでも警告は出ません**
    サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 -定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 +定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - **IPv4-マップされた IPv6アドレス**
    プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 @@ -456,9 +456,9 @@ Webサーバーの PFS利用可否状況 ([TLS](Admin/tls.md#perfect-forward-sec ## 一時的なコンテキストを再利用する (リモートモード) -| 設定できる場所 | 名称 | コメント | -| ----------- | --------------------------------------------------------------------------------------------------------------------- | ---- | -| 設定ダイアログボックス | [[オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | +| 設定できる場所 | 名称 | コメント | +| ----------- | ------------------------------------------------------------------------------------------ | ---- | +| 設定ダイアログボックス | [オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | > このオプションは、**セッションなし** オプションがチェックされている場合にのみ利用できます。 @@ -524,9 +524,9 @@ User-Agent: デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 -- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアパッケージを含むフォルダーです (4Dリモートモード)。 - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 -- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。置きます。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WritePro/managing-formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WritePro/managing-formulas.md index ce1649c081b77c..7cd11889334857 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WritePro/managing-formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/WritePro/managing-formulas.md @@ -6,7 +6,7 @@ slug: /WritePro/formulas ## 概要 -4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは4D コマンドなどの4D フォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 +4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは 4Dコマンドなどの 4Dフォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 4D Write Pro エリアへのフォーミュラの挿入には [**WP Insert formula**](commands/wp-insert-formula.md) コマンドを使用し、フォーミュラの読み出しには[**WP Get formulas**](commands-legacy/wp-get-formulas.md) コマンドを使用します。また、[**WP Get text**](commands-legacy/wp-get-text.md) コマンドを使用することでも返されます。 @@ -191,7 +191,7 @@ slug: /WritePro/formulas ### 参照を名前で表示 -フォーミュラには名前を割り当てることができ、これによって4D Write Proテンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 +フォーミュラには名前を割り当てることができ、これによって4D Write Pro テンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 例えば、以下のフォーミュラ参照はデフォルトではソーステキストとして表示されます: @@ -201,7 +201,7 @@ slug: /WritePro/formulas ![](../assets/en/WritePro/wp-formulas6.png) -フォーミュラに名前を割り当てるためには、 [WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: +フォーミュラに名前を割り当てるためには、[WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: ```4d // ドキュメント内に昨日の日付を挿入する diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/aikit/Classes/OpenAIChatAPI.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/aikit/Classes/OpenAIChatAPI.md index afb23bcb930605..5a30faa1791b01 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/aikit/Classes/OpenAIChatAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/aikit/Classes/OpenAIChatAPI.md @@ -22,7 +22,7 @@ title: OpenAIChatAPI | 引数 | 型 | 説明 | | -------------- | --------------------------------------- | ------------------------- | -| *systemPrompt* | Text | チャットを初期化するシステムプロント。 | +| *systemPrompt* | Text | チャットを初期化するシステムプロンプト。 | | 戻り値 | [OpenAIChatHelper](OpenAIChatHelper.md) | チャットのやり取りを管理するヘルパーインスタンス。 | #### 使用例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/code-editor/write-class-method.md index f31ca379c64241..66e28fa115df7d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/code-editor/write-class-method.md @@ -29,16 +29,16 @@ title: コードエディター | -------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **メソッド実行** | ![execute-method](../assets/en/code-editor/execute-method.png) | コードエディターウィンドウには、そのエディターで開かれているメソッドを実行するためのボタンがあります。このボタンに割り当てられているメニューを使用して、実行タイプを選択できます:
    • **新規プロセスで実行**: プロセスを作成し、そのプロセス内でメソッドを実行します。
    • **新規プロセスで実行＆デバッグ**: プロセスを作成し、デバッガーを開いてメソッドを表示します。
    • **アプリケーションプロセスで実行**: アプリケーションプロセス内でメソッドを実行します。
    • **アプリケーションプロセスで実行＆デバッグ**: アプリケーションプロセス内でデバッガーを開き、メソッドを表示します。
    メソッド実行についての詳細な情報については、[プロジェクトメソッド](../Project/project-method-properties.md) を参照してください。 | | **メソッド中を検索** | ![search-icon](../assets/en/code-editor/search.png) | [*検索* エリア](#検索と置換) を表示します。 | -| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についの詳細は、 [マクロ](#マクロ) を参照ください。 | +| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についての詳細は、[マクロ](#マクロ) を参照ください。 | | **すべて折りたたむ / すべて展開** | ![expand-collapse-button](../assets/en/code-editor/expand-collapse-all.png) | これらのボタンを使用してコードの制御フロー構造を折りたたんだり展開したりできます。 | -| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します(プロジェクトモードのみ)。 | +| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します (プロジェクトメソッドのみ)。 | | **最新のクリップボードの値** | ![last-clipboard-values-icon](../assets/en/code-editor/last-clipboard-values.png) | 直近でクリップボードに保存された値を表示します。 | -| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、 [これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | +| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、[これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | | **ナビゲーションドロップダウン** | ![code-navigation-icons](../assets/en/code-editor/tags.png) | 自動的にタグ付けされたコンテンツや手動で宣言されたマーカーを使用して、メソッドやクラス内を移動できます。後述参照。 | ### 編集エリア -このエリアを使用してコードを 入力/編集 します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 +このエリアを使用してコードを入力/編集します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 この編集エリアの表示はカスタマイズできます。カスタマイズした内容は、すべてのコードエディターに反映されます: @@ -74,10 +74,10 @@ title: コードエディター ![](../assets/en/code-editor/list-area.png) -- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示\非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 +- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示/非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 - すべてのウィンドウでリストを非表示にするには、次の方法があります: - - メソッド メニューの **表示** ＞ **リスト** オプションの選択を解除する + - **メソッド**メニューの **表示** ＞ **リスト** オプションの選択を解除する - **環境設定** の **メソッド** ページで **オプション** ＞ **リスト表示** の選択を解除する。**環境設定** ダイアログボックスでおこなった変更は、開かれているメソッドやクラス、関数を一度閉じて再度開いたときに反映されます。 #### リストのタイプ @@ -141,9 +141,9 @@ title: コードエディター - **行**: 行番号 - **階層**: 階層番号 (プログラム構造の階層レベル)。先頭のレベルは 0 です。この数値は、コード中でエラーが発生した際にインタープリターから提供されるのでデバッグ時に利用できます。 - **文字**: 行内の文字位置。 -- ![](../assets/en/code-editor/show-hide-list.png): Hide/display lists. +- ![](../assets/en/code-editor/show-hide-list.png): リストの表示/非表示。 -4Dコマンド、関数や変数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: +4Dコマンド、関数や引数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: ![](../assets/en/code-editor/status-bar-bold.png) ### ナビゲーションドロップダウン @@ -208,7 +208,7 @@ title: コードエディター メソッドやクラスのタグをアルファベット順に表示するには、次のいずれかを実行します: - ドロップダウンツールを **右クリックする** -- macOS では **option**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 +- macOS では **Cmd**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 > 関数内のタグは、親項目と一緒に移動します。 @@ -224,7 +224,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | **ショートカット** | **アクション** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| **選択およびナビゲージョン** | | +| **選択およびナビゲーション** | | | ダブルクリック | ランゲージ要素名を選択します。 | | トリプルクリック | コードを一行選択 | | [Shift]+[右矢印] | 選択範囲を作成し、一文字ずつ右に拡大します。 または、選択範囲を一文字ずつ左から縮小します。 | @@ -247,7 +247,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | [PgDn] | メソッドをページ単位で下にスクロールします (挿入カーソル位置は変更されません)。 | | [**イントロスペクション**](#定義を開く) | | | [Ctrl]+K または [Alt]+ダブルクリック | [**定義を開く**](#定義を開く) コマンドと同じ。 | -| トークン上で \[Ctrl\] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | +| トークン上で [Ctrl] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | | [**検索と置換**](#検索と置換) | | | [Ctrl]+F | 検索 | | [Ctrl]+G | 次を検索 | @@ -356,7 +356,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method > **環境設定** の **メソッド** ページで、**() と閉じる } ) ] " を自動で挿入** オプションをチェックしている場合、4D はひとつ以上の必須の引数を持つ4D コマンド、キーワード、プロジェクトメソッドの後ろに (提案、あるいは補完を受け入れたあとに) 自動的に **()** を追加します: > ![](../assets/en/code-editor/insert-and-closing-1.png) -> ![](../assets/en/code-editor/insert-and-closing-2.png) -例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: +自動補完機能は、コード構造 (例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: ![](../assets/en/code-editor/autocomplete-code-structures.png) 複数の候補がある場合、**Tab** キーを押すと 4D はそのポップアップリストを表示します: @@ -367,7 +367,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method デフォルトでは、値を選択したあとに区切り文字 `( ; : = < [ {` を入力すると、自動で値の候補も (区切り文字の前に) 挿入されます。 値のあとには区切り文字がつき、データの入力の準備ができた状態になります。 -![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** key --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) +![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** キー --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) > この区切り文字を使った候補の自動入力は、**環境設定** の **メソッド** ＞ **オプション** で無効にできます。 @@ -446,7 +446,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ### 置換 -*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ \*\* 置換...\*\* を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 +*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ **置換...** を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 *置換* エリアには、上の検索エリアの文字を置換する文字列を入力します。 @@ -524,11 +524,9 @@ Windows では、日本語や中国語を入力するために IME (Input Method - **4D コマンドドキュメンテーション**: 4D のコマンドや関数にマウスを重ねると、コマンドシンタックスと簡単な説明がヘルプTip に表示されます。 ![](../assets/en/code-editor/status-bar-description.png) - ![](../assets/en/code-editor/status-bar-description.png) - **変数型と詳細**: 変数にマウスを重ねると、その変数の型と (メソッド内で明示的に宣言されている場合)、付随したコメントが (あれば) ヘルプTip に表示されます。 ![](../assets/en/code-editor/variable-type.png) - ![](../assets/en/code-editor/variable-type.png) - **プロジェクトメソッドまたは関数**: プロジェクトメソッドまたはクラス関数にマウスを重ねると、以下の内容がヘルプTip に表示されます: @@ -550,7 +548,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ![](../assets/en/code-editor/comment-uncomment-1.png) --> ![](../assets/en/code-editor/comment-uncomment-2.png) -選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。 この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 +選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 > **コメント/アンコメント** コマンドは行全体に適用されます。行の一部のみをコメント化することはできません。 @@ -650,7 +648,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ::: -**定義を開く.....** コマンドの効果は、ターゲット要素によって異なります: +**定義を開く...** コマンドの効果は、ターゲット要素によって異なります: - プロジェクトメソッドの場合、コードエディターの新しいウィンドウ内にメソッドのコンテンツが表示されます。 - クラス名またはクラス関数の場合、コードエディター内にクラスが表示されます。 @@ -682,7 +680,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ## 名称変更 -グローバル名称変更機能は、**変数** と **プロジェクトメソッド** に対して使用でき、これによってプロジェクト全体において安全に名称を変更することができます。これをするためには、エディター内において変数またはプロジェクトメソッド名をハイライトし、コンテキストメニューの**メソッド** メニューから**名称変更...** を選択します。すると新しい名前を入力するためのダイアログボックスが表示されます。より詳細な情報については、[プロジェクトメソッドと変数の名称変更](../Project/search-replace.md#プロジェクトメソッドと変数の名称変更) の章を参照してください。 +グローバル名称変更機能は、**変数** と **プロジェクトメソッド** に対して使用でき、これによってプロジェクト全体において安全に名称を変更することができます。これをするためには、エディター内において変数またはプロジェクトメソッド名をハイライトし、**メソッド**メニューまたはコンテキストメニューから**名称変更...** を選択します。すると新しい名前を入力するためのダイアログボックスが表示されます。より詳細な情報については、[プロジェクトメソッドと変数の名称変更](../Project/search-replace.md#プロジェクトメソッドと変数の名称変更) の章を参照してください。 ## マクロ @@ -702,7 +700,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method - マシンのアクティブ4Dフォルダー。この場合、マクロはすべてのデータベースで共有されます。**注:** アクティブ4Dフォルダーの位置は OS により異なります。詳細については、*4Dランゲージリファレンス* マニュアルの [Get 4D folder](../commands/get-4d-folder) コマンドの説明を参照ください。 - データベースストラクチャーファイルと同階層。マクロは、このストラクチャーにのみ読み込まれます。 -- コンポーネントの場合: データベースの **Components** フォルダーと同階層。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 +- コンポーネントの場合: データベースの **Components** フォルダーの中。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 これら 3つの場所は同時に利用可能です。 各場所に "Macros v2" フォルダーをインストールできます。マクロは以下の順番でロードされます: 4Dフォルダー、ストラクチャーファイル、コンポーネント1 ... コンポーネントX。 @@ -834,7 +832,7 @@ XML仕様に準拠し、いくつかのタグは属性を含むことがあり マクロのサポートは 4Dのバージョンごとに変わることがあります。カスタマイズされたマクロを管理しつつ、異なるバージョンの互換性を保持するために、4Dは以前のバージョンのマクロを取り除くことはしません。最新機能を使用したい場合は、適切にバージョンを調整する必要があります。 -#### method の選択テキスト変数 +#### メソッドのテキスト選択変数 テキスト選択は、[GET MACRO PARAMETER](../commands/get-macro-parameter) および [SET MACRO PARAMETER](../commands/set-macro-parameter) コマンドを使用して管理することが推奨されています。これらのコマンドを使用すると、ホストプロジェクトとコンポーネント間でテキストを相互に交換することができ、マクロの管理専用のコンポーネントを作成することができます。マクロでこのモードを有効にするには、macro 要素内で version 属性に値 2 を指定しなければなりません。この場合、4D は旧式の _textSel, _textReplace 等の定義済み変数を管理しなくなり、[GET MACRO PARAMETER](../commands/get-macro-parameter) と [SET MACRO PARAMETER](../commands/set-macro-parameter) が使用されます。属性は以下のように定義します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/menus.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/menus.md index a4b9a959a1fbeb..86ed0b00037cd2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/menus.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/menus.md @@ -67,7 +67,7 @@ macOS では**終了**コマンドは**4D Server** メニュー (アプリケー :::note -macos では、**環境設定... \*\* コマンドは**4D Server\*\* メニュー (アプリケーションメニュー) 内にあります。 +macos では、**環境設定...** コマンドは **4D Server** メニュー (アプリケーションメニュー) 内にあります。 ::: @@ -137,4 +137,4 @@ macos では、**環境設定... \*\* コマンドは**4D Server\*\* メニュ ### 4D Serverについて... -このコマンドは\*\*4D Server について... \*\* ウィンドウを表示します。 +このコマンドは **4D Server について...** ウィンドウを表示します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/service.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/service.md index 05d3608f3cf2e5..c4b416a832cfba 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/service.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/server/service.md @@ -5,7 +5,7 @@ title: サービスとして登録 Windowsにおいて、4D Server をサービスとして起動することができます。 -サービスとして登録された4D Server アプリケーションはマシンの開始時に自動で、ユーザセッションが開かれる前に、カレントのプロジェクトを使用して起動されます。またユーザがセッションを終了したときも、データベースは閉じられません。 +サービスとして登録された 4D Server アプリケーションはマシンの開始時に自動で、ユーザーセッションが開かれる前に、カレントのプロジェクトを使用して起動されます。またユーザがセッションを終了したときも、データベースは閉じられません。 この動作により、マシンの再起動が必要になるような出来事の場合でも、4D Server が実行されるようにすることができます。またメンテナンスをリモートで行うことができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/ai.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/ai.md index 87bef924be3328..67e8f3d64ebdf4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/ai.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/ai.md @@ -59,7 +59,7 @@ AI プロバイダーを追加するには: ### APIキー -(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報をが必要になる場合もあります。 +(オプション) プロバイダーのAPI キー。 API キーを生成するための手順については、そのAI プロバイダーの公式ドキュメンテーションを参照して下さい。一部のAI プロバイダーでは追加の特定の資格情報が必要になる場合もあります。 ### 組織 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/interface.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/interface.md index d6c4ba18023c01..0a03a6c9f7dd3c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/interface.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R5/settings/interface.md @@ -66,7 +66,7 @@ title: インターフェースページ ### Windows 上でFluent UI を使用 -このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトでWindows クラシクUI レンダリングテーマが使用されます。 +このオプションがチェックされている場合、4D は[利用可能な状態](../FormEditor/forms.md#要件) のであれば、Windows 上の全てのフォームに対しては [Fluent UI レンダリングテーマ](../FormEditor/forms.md#fluent-ui-レンダリング) を自動的に使用します。これがチェックされていない場合、デフォルトで Windows クラシック UI レンダリングテーマが使用されます。 > このオプションはWindows でのみ使用され、macOS では何の効果もありません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md index 22a55563cb8bad..1afe8174d26372 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/CollectionClass.md @@ -370,7 +370,7 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] #### 例題 1 -通常の (非共有の) コレクション *$lastnames \* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames\*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames* を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -392,7 +392,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と\*$sharedColl2\* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と *$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md index bf40d2728766f8..0ee8a1bbf20c8c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataClassClass.md @@ -482,7 +482,7 @@ $ds.Persons.clearRemoteCache() :::info -*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません）。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 +*settings* パラメーター**なし**で `.get()` 関数を呼び出すと、属性値のリクエストが直接サーバーに送信されます ([ORDAキャッシュ](../ORDA/client-server-optimization.md#ordaキャッシュ) は使用されません)。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataStoreClass.md index 83adcc79c6e389..98d03fc1073bb1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/DataStoreClass.md @@ -746,7 +746,7 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAリクエス 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: -- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 .4Dindx ファイル) で暗号化されます。 +- 暗号化可能テーブルに対するデータ編集はすべて、ディスク上 (.4DD、.journal、 .4Dindx ファイル) で暗号化されます。 - 暗号化可能テーブルから読み出したすべてのデータは、メモリ内で復号化されます。 **戻り値** diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EmailObjectClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EmailObjectClass.md index a10525c644c13a..8648fe7f05a684 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EmailObjectClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EmailObjectClass.md @@ -5,8 +5,7 @@ title: Email 4Dにおけるメールの作成・送信・受信は `Email` オブジェクトの操作よっておこなわれます。 -*transporter* クラス関数を使ってメールを取得する際に、 -`Email` オブジェクトが作成されます。 +*transporter* クラス関数を使ってメールを取得する際に、`Email` オブジェクトが作成されます。 - IMAP - [`.getMail()`](IMAPTransporterClass.md#getmail) および [`.getMails()`](IMAPTransporterClass.md#getmails) 関数は IMAPサーバーからメールを受信します。 - POP3 - [`.getMail()`](POP3TransporterClass.md#getmail) 関数は POP3サーバーからメールを受信します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md index c017b8ae6dafee..96568cf6c36824 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntityClass.md @@ -530,7 +530,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: - オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +- データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換) 参照)、それ以外の場合にはその属性は更新されません。 - プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -907,9 +907,9 @@ $info:=$address.getRemoteContextAttributes()
    -| 引数 | 型 | | 説明 | -| --- | ------- | :-------------------------: | ------------------------------------------------------ | -| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。 それ以外は false。それ以外は false。 | +| 引数 | 型 | | 説明 | +| --- | ------- | :-------------------------: | ----------------------------------------- | +| 戻り値 | Boolean | <- | エンティティが作成されたばかりで未保存の場合は true。それ以外は false。 |
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntitySelectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntitySelectionClass.md index eafadf392594e1..aa32dc4371360b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntitySelectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/EntitySelectionClass.md @@ -2044,9 +2044,9 @@ pathObjects コレクションには必要な数だけオブジェクトを追 | ranges[].start | Integer | レンジ内の先頭エンティティのインデックス (位置) | | ranges[].end | Integer | レンジ内の最終エンティティのインデックス (位置) | -`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。 インデックスは 0 起点です。インデックスは 0 起点です。 +`ranges` プロパティに 1件のエンティティしか含まれない場合、`start` = `end` です。インデックスは 0 起点です。 -元のエンティティセレクションと *entitySelection* の両方が空であった場合、空のエンティティセレクションが返されます。 元のエンティティセレクションが空であった場合、*entitySelection* への参照、あるいは *entity* のみを格納したエンティティセレクションが返されます。 +呼び出し対象のエンティティセレクション、または *selectedEntities* のエンティティセレクションが空の場合、関数は `ranges` に空のコレクションを返します。 #### 例題 @@ -2089,7 +2089,7 @@ $result2:=$invoices.selected($creditSel) | 引数 | 型 | | 説明 | | --------- | ---------------------------------- | :-------------------------: | ---------------------------------------------------------- | -| startFrom | Integer | -> | 処理を開始するインデックス) | +| startFrom | Integer | -> | 処理を開始するインデックス | | end | Integer | -> | 終了インデックス (含まれない) | | 戻り値 | 4D.EntitySelection | <- | 抜粋エンティティを格納した新しいエンティティセレクション (シャロウ・コピー) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/HTTPAgentClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/HTTPAgentClass.md index 2b8598823fb623..aec41c1d1bca7a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/HTTPAgentClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/HTTPAgentClass.md @@ -77,7 +77,7 @@ HTTPAgent のオプションは [HTTPRequest のオプション](HTTPRequestClas | プロパティ | 型 | デフォルト | 説明 | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) "storeCertificateName" によって上書き可能(下記参照) | +| certificatesFolder | Folder | undefined (デフォルト値は [HTTPRequest.new()](HTTPRequestClass.md#options-引数) 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照) | | keepAlive | Boolean | true | 当該エージェントについて keep-alive を有効にします | | maxSockets | Integer | 65535 | サーバーあたりの最大ソケット数 | | maxTotalSockets | Integer | 65535 | エージェントの最大ソケット数 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IMAPTransporterClass.md index cf72f48a0ae03e..5c171ea2a1f831 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IMAPTransporterClass.md @@ -1124,12 +1124,12 @@ ID = 1のメッセージを取得します:
    -| 引数 | 型 | | 説明 | -| ---------- | ------- | :-------------------------: | --------------------------------------------------------------------------------------- | -| msgNumber | Integer | -> | メッセージのシーケンス番号 | -| msgID | Text | -> | メッセージの固有ID | -| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 false 時にはメッセージの状態は変化しません。 | -| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB | +| 引数 | 型 | | 説明 | +| ---------- | ------- | :-------------------------: | ------------------------------------------------------------- | +| msgNumber | Integer | -> | メッセージのシーケンス番号 | +| msgID | Text | -> | メッセージの固有ID | +| updateSeen | Boolean | -> | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 | +| 戻り値 | BLOB | <- | メールサーバーから返された MIME文字列の BLOB |
    @@ -1637,13 +1637,11 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" - **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +- **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` - **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。複数指定する場合にはスペースで区切ります。例: `searchCriteria = KEYWORD \Flagged \Draft` -- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    +- **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IncomingMessageClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IncomingMessageClass.md index 0111d76918e337..9357afc0c05d32 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IncomingMessageClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/IncomingMessageClass.md @@ -255,7 +255,7 @@ $value := $request.getHeader("content-type") `.headers` プロパティは、読み出し専用です。 -ヘッダー名(キー)は全て小文字となっています。ヘッダー名は全て大文字・小文字は区別されます。 +ヘッダー名(キー)は全て小文字となっています。ヘッダー名では大文字と小文字が区別されることに注意してください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/POP3TransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/POP3TransporterClass.md index 55db52dfb2c937..0941c2bfaf04ca 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/POP3TransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/POP3TransporterClass.md @@ -202,7 +202,7 @@ POP3 Transporter オブジェクトは [POP3 New transporter](../commands/pop3-n | 引数 | 型 | | 説明 | | ---------- | ------- | :-------------------------: | ------------------------------------------------------------ | | msgNumber | Integer | -> | リスト中のメッセージの番号 | -| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false） | +| headerOnly | Boolean | -> | メールヘッダーのみをダウンロードする場合は true (デフォルトは false) | | 戻り値 | Object | <- | [Email オブジェクト](EmailObjectClass.md#email-オブジェクト) | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SessionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SessionClass.md index 0f5621d26f0cdc..1bad22c397a105 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SessionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SessionClass.md @@ -81,7 +81,7 @@ Session オブジェクトは [`Session`](../commands/session.md) コマンド :::note -この関数は [roles.json](../ORDA/privileges.md#rolesjsonファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 +この関数は [roles.json](../ORDA/privileges.md#rolesjson-ファイル) ファイルで追加されたものであれ [`promote()`](#promote) 関数で追加されたものであれ、Web プロセスから**昇格された権限** を削除しません。 ::: @@ -525,7 +525,7 @@ End if | hostType | Text | ホストタイプ: "windows" または "mac" | | creationDateTime | 日付 (ISO 8601) | セッション作成の日付と時間。セッション作成の日付と時間。 スタンドアロンセッションの場合: アプリケーション起動の日付と時間 | | state | Text | セッションの状態: "active", "postponed", "sleeping" | -| ID | Text | セッションUUID ([`.id`](#id) と同じ値)) | +| ID | Text | セッションUUID ([`.id`](#id) と同じ値) | | persistentID | Text | リモートセッション: セッションの永続的な ID | :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SystemWorkerClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SystemWorkerClass.md index 0d111b4f2945eb..abfbaedcbf3bb2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SystemWorkerClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/API/SystemWorkerClass.md @@ -3,7 +3,7 @@ id: SystemWorkerClass title: SystemWorker --- -システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 +システムワーカーを使うことで、4Dコードは同じマシン上で任意の外部プロセス (シェルコマンド、PHPなど ) を呼び出すことができます。システムワーカーは非同期で呼び出されます。コールバックを使用することで、4D は双方向の通信を可能にします。 `SystemWorker` クラスは、`4D` クラスストアにて提供されています。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/about.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/about.md index 96236d111fcf81..86efb2a3370abf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/about.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/about.md @@ -1,9 +1,9 @@ --- id: about -title: 4Dは独自のプログラミング言語を持っています。 +title: 4D ランゲージについて --- -1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: +4Dは独自のプログラミング言語を持っています。1300を超えるこのビルトインの言語により、4Dは Web、モバイル、およびデスクトップアプリケーションを作成する、パワフルな開発ツールとなっています。単純な計算から複雑なカスタムインターフェースの作成まで、4D 言語は様々なタスクに使用することができます。たとえば、以下のようなことが可能です: - クエリや並べ替えなどのレコード管理エディターにプログラムでアクセスする - データベースの情報をもとに複雑なレポートやラベルを作成・印刷する @@ -17,9 +17,9 @@ title: 4Dは独自のプログラミング言語を持っています。 ## 4D ランゲージとは -4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。 このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 +4D ランゲージは、私たちが日ごろ話している言語とさして変わりありません。アイデアの表現や、伝達、指示をおこなうためのコミュニケーションの一形態です。話し言葉と同様に、4D は独自の語彙・文法・構文を持っています。このランゲージを使用して、アプリケーションやデータをどのように扱うのかを 4D に伝えます。 -4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。 言葉を交わすために言語のすべてを知る必要がないのと同じです。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 +4D を効果的に使用する目的では、ランゲージのすべてを知っている必要はありません。言葉を交わすために言語のすべてを知る必要がないのと同じです。実際、少ない語彙でも雄弁に語ることはできるものです。 4D ランゲージも、創造性を発揮するのに必要となるのはほんの一部で、残りは必要に応じて覚えればよいのです。 ## なぜランゲージを使用するのか @@ -42,7 +42,7 @@ title: 4Dは独自のプログラミング言語を持っています。 4D ランゲージのコマンドを使用して標準のレコード管理エディターにアクセスできます。たとえば、デザインモードにおいて「クエリ」ツールバーボタンを使って開けるクエリエディターは、`QUERY` コマンドを使用することでも表示されます。さらに、QUERY コマンドを使用すれば、エディターを開かなくても指定したデータを検索できるのです。たとえば `QUERY ([People];[People]Last Name="Smith")` と記述すると、データベースから "Smith" という名前の人物をすべて検索します。 -ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 +4D ランゲージはとてもパワフルです。ひとつのコマンドが、従来のプログラム言語で書かれた数百行あるいは数千行にも及ぶコードに相当することもしばしばです。このパワーを持ちながら、コマンドにはシンプルな英語の名称がつけられています。たとえば、クエリをおこなうには `QUERY` コマンドを、レコードを追加するには `ADD RECORD` コマンドを使用します。 4D ランゲージは、ほとんどのタスクを簡単に実行できるようデザインされています。レコードの追加、並べ替え、データの検索などの操作がシンプルなコマンドで提供されています。さらにコマンドを使用してシリアルポートのコントロール、ディスク上のドキュメントの読み込み、高度なトランザクション処理等を行うこともできるのです。 @@ -56,6 +56,6 @@ title: 4Dは独自のプログラミング言語を持っています。 従来の言語を使用して開発を行う場合、まず念入りに計画を立てる必要があります。実際、計画の立案は開発の重要な工程の1つです。 4D においては、プロジェクトのあらゆる部分でいつでもランゲージを使いはじめることができます。たとえば、初めにフォームにメソッドを追加し、いくつかのメソッドをあとから追加することができます。アプリケーションがより高度になったら、メニューから実行するプロジェクトメソッドを追加することもできます。 4D ランゲージは好きなだけ利用することができます。他の多くのデータベースのような "すべてか無か" ではありません。 -従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。 作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 +従来の言語では、インターフェースオブジェクトをあらかじめ正式な記述法で宣言・定義しなければなりません。しかし、4D ではボタンなどのオブジェクトを作成し、そのまま使用することができます。作成したオブジェクトは自動的に 4D によって管理されます。たとえば、ボタンを使用するためには、ボタンをフォーム上に作成して名前を指定します。ユーザーがボタンをクリックした時点で、ランゲージが自動的にメソッドに通知します。 従来の言語は、コマンドの記述方法を制限するなどして、融通性に欠けることが多いのに対し、 4D ランゲージは伝統に縛られることなく進化していきます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/arrays.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/arrays.md index f7776999dbd998..06e67dfacdd1a9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/arrays.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/arrays.md @@ -3,7 +3,7 @@ id: arrays title: 配列 --- -**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 +**配列** とは、同じタイプの **変数** を番号付きで並べたものです。各変数は、配列の **要素** といいます。配列のサイズとは、配列が持つ要素の数を指します。配列は作成時にサイズが与えられ、要素の追加・挿入・削除によって、または作成時に使用したコマンドの再使用によって、何度でもサイズを変更することができます。配列要素には、1 から N の番号が付けられます (N は配列のサイズ)。配列は必ず、特別な [要素ゼロ](#配列の要素ゼロ) を持ちます。配列は 4D の変数です。他の変数と同様、配列にもスコープがあり、4D ランゲージの規則に従いますが、他と異なるところがいくつかあります。 :::tip @@ -35,7 +35,7 @@ ARRAY INTEGER(aiAnArray;0) ## 配列要素への値の代入 -配列中の要素は中カッコ ({… }) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: +配列中の要素は中カッコ ({…}) を使用して参照します。中カッコの中には数字を入れて特定の要素を指定します。この数字を要素番号といいます。次のコードは、5つの名前を atNames という配列に入れ、それらを警告ウィンドウに表示します: ```4d ARRAY TEXT(atNames;5) @@ -97,7 +97,7 @@ atNames{$vlElem} というシンタックスに注目してください。 atNam 上のコードで作成した atTopics 配列について、次のことが言えます: - atTopics は、2次元配列です。 -- atTopics{8}{5} は、 8行5列目の要素です。 8行5列目の要素です。 +- atTopics{8}{5} は、 8行5列目の要素です。 - atTopics{20} は 20行目を指し、それ自体が 1次元の配列です。 - `Size of array(atTopics)` は、行数の 100を返します。 - `Size of array(atTopics{17})` は、17行目の列数である50を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/classes.md index 63fc31a7573f14..4295a48f3cca16 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/classes.md @@ -209,7 +209,7 @@ Class オブジェクトそのものは [共有オブジェクト](shared.md) クラス関数とは、当該クラスのプロパティです。クラス関数は [`4D.Function`](API/FunctionClass.md) クラスのオブジェクトです。クラス定義ファイルでは、`Function` キーワードに続けて関数名を指定して宣言をおこないます。 -[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use) なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 +[共有クラス](#共有クラス) 内で関数が宣言されている場合は、`shared` キーワードを使用することによって、[`Use...End use` 構文](shared.md#useend-use)なしで関数を呼び出せるようにできます。詳細については、後述の [共有関数](#共有関数) の項目を参照ください。 関数名は [プロパティ名の命名規則](Concepts/identifiers.md#オブジェクトプロパティ) に準拠している必要があります。 @@ -357,11 +357,11 @@ Function getRectArea($width : Integer; $height : Integer) : Integer `shared` キーワードを使うと**共有クラス** が作成されます。共有クラスは、共有オブジェクトのインスタンス化にのみ使われます。詳細については、後述の [共有クラス](#共有クラス) の項目を参照ください。 -`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 +`singleton` キーワードを使うと **シングルトン** が作成されます。シングルトンクラスは、クラスインスタンスを一つに限定する場合に使われます。 `session singleton` キーワードを使うと、セッションごとに 1つのインスタンスを作成します。詳細については、後述の [シングルトンクラス](#シングルトンクラス) の項目を参照ください。 :::note -[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-class) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 +[ORDA エンティティクラス](../ORDA/ordaClasses.md#entity-クラス) も`Class constructor` 機能の恩恵を受けることができます。実装は通常のクラスと同様ですが、[一部に違いがあります](../ORDA/ordaClasses.md#class-constructor-1)。 ::: @@ -433,7 +433,7 @@ $o:=cs.MyClass.new("John";42) :::info -`property` キーワードは、クラス関数内の `Function` および `Class constructor` ブロック外でのみ使用できます。 +`property` キーワードは、クラス関数において `Function` および `Class constructor` ブロック外でのみ使用できます。 ::: @@ -467,7 +467,7 @@ property fuzzy // バリアント :::note -宣言と同時に色かするプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: +宣言と同時に初期化するプロパティが [共有クラス](#共有クラス) のオブジェクトまたはコレクションである場合、その値は自動的に共有された値に変換されます: ```4d // 共有クラス内 @@ -691,7 +691,7 @@ $val:=$o.f() //8 共有クラスは **共有関数** をサポートしています。共有関数は、[`Use...End use`](shared.md#useend-use) 構文なしで呼び出すことができます。 -クラスが共有クラスかどうかは、Classオブジェクトの .[`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 +クラスが共有クラスかどうかは、Classオブジェクトの [`.isShared`](../API/ClassClass.md#isshared)プロパティで確認できます。 :::info @@ -723,7 +723,7 @@ cs.Person.isShared // true 共有クラス内で定義された関数が、そのクラスのオブジェクトを変更する場合には、共有オブジェクトへのアクセスを保護するために、[`Use...End use`](shared.md#useend-use) 構文を呼び出す必要があります。しかし、**shared** として関数を定義することで、実行時には内部的な `Use...End use` を自動でトリガーするようにし、コードを簡略化することができます。 -共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します 。例: +共有クラス内で共有関数を作成するには、[Function](#function) キーワードの前に `shared` キーワードを追加します。例: ```4d //共有クラス Foo @@ -789,9 +789,9 @@ shared Function Bar($value : Integer) シングルトンを引数付きでインスタンス化する必要がある場合には、[`new()`](../API/ClassClass.md#new) 関数を呼び出すこともできます。この場合、アプリケーションの起動時に実行されるコードでシングルトンをインスタンス化することが推奨されます。 -クラスがシングルトンクラスかどうかは、Classオブジェクトの .[`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 +クラスがシングルトンクラスかどうかは、Classオブジェクトの [`.isSingleton`](../API/ClassClass.md#issingleton)プロパティで確認できます。 -クラスがセッションシングルトンかどうかは、Classオブジェクトの .[`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 +クラスがセッションシングルトンかどうかは、Classオブジェクトの [`.isSessionSingleton`](../API/ClassClass.md#issessionsingleton) プロパティで確認できます。 ### 公開されたシングルトン関数 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/components.md index f4423e826ad8fd..984f35f5d6a476 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/components.md @@ -3,7 +3,7 @@ id: components title: コンポーネント --- -4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルの表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 +4D のコンポーネントとは、プロジェクトにインストール可能な、1つ以上の機能を持つ 4Dコードやフォームの一式です。たとえば、[4D SVG コンポーネント](https://github.com/4d/4D-SVG) は、SVGファイルを表示するための高度なコマンドと統合されたレンダリングエンジンを追加します。 ## コンポーネントのインストール diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/data-types.md index 2c6f00ff72328c..0fe8a9c96815d6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/data-types.md @@ -7,25 +7,25 @@ title: データタイプの概要 この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: -| データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | -| ----------------------------------------------------- | -------------------------- | -------- | ------------------------ | ----------------------- | -| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | -| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | -| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | -| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | -| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | -| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | -| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | -| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | -| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | -| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | -| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | -| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | -| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | -| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | -| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | -| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | +| データタイプ | データベース (1) | ランゲージ | [`var` 宣言](variables.md) | [`ARRAY` 宣言](arrays.md) | +| ----------------------------------------------------- | ----------------------------- | -------- | ------------------------ | ----------------------- | +| [文字列](dt_string.md) | ◯ | テキストに変換 | - | - | +| [テキスト](Concepts/dt_string.md) | ◯ | ◯ | `Text` | `ARRAY TEXT` | +| [日付](Concepts/dt_date.md) | ◯ | ◯ | `Date` | `ARRAY DATE` | +| [時間](Concepts/dt_time.md) | ◯ | ◯ | `Time` | `ARRAY TIME` | +| [ブール](Concepts/dt_boolean.md) | ◯ | ◯ | `Boolean` | `ARRAY BOOLEAN` | +| [整数](Concepts/dt_number.md) | ◯ | 倍長整数 に変換 | `Integer` | `ARRAY INTEGER` | +| [倍長整数](Concepts/dt_number.md) | ◯ | ◯ | `Integer` | `ARRAY LONGINT` | +| [64ビット整数](Concepts/dt_number.md) | ◯ (SQL) | 実数に変換 | - | - | +| [実数](Concepts/dt_number.md) | ◯ | ◯ | `Real` | `ARRAY REAL` | +| [未定義](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [Null](Concepts/dt_null_undefined.md) | - | ◯ | - | - | +| [ポインター](Concepts/dt_pointer.md) | - | ◯ | `Pointer` | `ARRAY POINTER` | +| [ピクチャー](Concepts/dt_picture.md) | ◯ | ◯ | `Picture` | `ARRAY PICTURE` | +| [BLOB](Concepts/dt_blob.md) | ◯ | ◯ | `Blob`, `4D.Blob` | `ARRAY BLOB` | +| [オブジェクト](Concepts/dt_object.md) | ◯(3) | ◯ | `Object` | `ARRAY OBJECT` | +| [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | | +| [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | | (1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 @@ -63,7 +63,7 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的 な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_blob.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_blob.md index acbe6f6eec4336..da5b00ac1fc46c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_blob.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_blob.md @@ -141,7 +141,7 @@ $type:= OB Instance of($myObject.blob; 4D.Blob) // true // 4D.Blob から スカラーBLOB への変換 $myBlob:= $myObject.blob -$type:= +$type:= Value type($myBlob) // Blob ``` > `4D.Blob` をスカラーBLOB に変換する際に、`4D.Blob` のサイズがスカラーBLOB の最大サイズを超える場合、結果のスカラーBLOB は空になります。たとえば、スカラーBLOB の最大サイズが 2GB の場合、2.5GB の `4D.Blob` をスカラーBLOB に変換すると、空の BLOB が得られます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_boolean.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_boolean.md index a43fa87dd4188d..1db75d8479b445 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_boolean.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_boolean.md @@ -58,7 +58,7 @@ myBoolean:=(myButton=1) | false | true | true | | false | false | false | -**Tip:** 式1と式2の排他的結合子演算を実行する必要がある場合、次の評価式を使用します: +**Tip:** 式1と式2の排他的論理和を実行する必要がある場合、次の評価式を使用します: ```4d (Expr1|Expr2) & Not(Expr1 & Expr2) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_collection.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_collection.md index 89938d0c524d97..b4b1f92ce9be1f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_collection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_collection.md @@ -29,7 +29,7 @@ collectionRef[expression] $myVar:=myCol[0] ``` -コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられらます: +コレクションの最後の要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、途中のすべての値には null 値が割り当てられます: ```4d var myCol : Collection @@ -106,7 +106,7 @@ $users:=[{name: "Alice"; \ 二種類のコレクションを作成することができます: - [`New collection`](../commands/new-collection.md) コマンド、またはコレクションリテラルのシンタックス `[]` を使用して作成する通常 (非共有) コレクション。 通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。通常のコレクションは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 -- [`New shared collection`](../commands/new-shared-collection.md) コマンドを使用して作成する共有コレクション。 共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。 共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 +- [`New shared collection`](../commands/new-shared-collection.md) コマンドを使用して作成する共有コレクション。 共有コレクションはプロセス間 (プリエンティブ・スレッド含む) で共有可能なコレクションです。 共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。共有コレクションはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なコレクションです。共有コレクションへのアクセスは [`Use...End use`](Concepts/shared.md#useend-use) 構造によって管理されています。 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_date.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_date.md index d80c718c064c1e..eea6e1458527b4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_date.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_date.md @@ -11,7 +11,7 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付リテラル -日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) 下記に、日付定数の例を示します: +日付リテラル定数は、エクスクラメーションマークで囲んで表します (! ... !)。日付は ISOフォーマット (!YYYY-MM-DD!) を使って記述します。下記に、日付定数の例を示します: ```4d !1976-01-01! @@ -30,23 +30,23 @@ C_DATE によって宣言された日付は 32767年までの範囲に対応し ## 日付演算子 -| 演算 | シンタックス | 戻り値 | 式 | 値 | -| ----- | ------------------------------------- | ------- | --------------------------- | ------------ | -| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | -| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | -| 日付の減算 | Date – Number | Date | !2017-01-20! !2017-01-20! | !2017-01-11! | -| 等しい | Date = Date | Boolean | !2017-01-20! = !2017-01-01! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 異なる | Date # Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 大きい | Date > Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 小さい | Date < Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | -| 以上 | Date >= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-01!>=!2017-01-20! | false | -| 以下 | Date <= Date | Boolean | !2017-01-20! !2017-01-20! | true | -| | | | !2017-01-20! !2017-01-20! | false | +| 演算 | シンタックス | 戻り値 | 式 | 値 | +| ----- | ------------------------------------- | ------- | ----------------------------------------------------- | ------------ | +| 日付の差 | Date – Date | Number | !2017-01-20! - !2017-01-01! | 19 | +| 日付の加算 | Date + Number | Date | !2017-01-20! + 9 | !2017-01-29! | +| 日付の減算 | Date – Number | Date | !2017-01-20! - 9 | !2017-01-11! | +| 等しい | Date = Date | Boolean | !2017-01-20! =!2017-01-20! | true | +| | | | !2017-01-20! = !2017-01-01! | false | +| 異なる | Date # Date | Boolean | !2017-01-20! # !2017-01-01! | true | +| | | | !2017-01-20! # !2017-01-20! | false | +| 大きい | Date > Date | Boolean | !2017-01-20! > !2017-01-01! | true | +| | | | !2017-01-20! > !2017-01-20! | false | +| 小さい | Date < Date | Boolean | !2017-01-20! < !2017-01-20! | true | +| | | | !2017-01-20! < !2017-01-20! | false | +| 以上 | Date >= Date | Boolean | !2017-01-20! >=!2017-01-01! | true | +| | | | !2017-01-01!>=!2017-01-20! | false | +| 以下 | Date <= Date | Boolean | !2017-01-20! <= !2017-01-20! | true | +| | | | !2017-01-20! <= !2017-01-01! | false | ## JavaScriptからの日付の変換 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_null_undefined.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_null_undefined.md index f81b5c6dad1615..bf1d975f584644 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_null_undefined.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_null_undefined.md @@ -23,7 +23,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ フィールドは、未定義にはできません (フィールドの場合、`Undefined` コマンドは常に False を返します)。 -未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。 ただし以下の場合には生成されません: +未定義の式を読み込んだ、または割り当てようとしたときに 4D は通常、エラーを生成します。ただし以下の場合には生成されません: - 未定義の値を(配列を除く)変数に代入することは、変数に対して[`CLEAR VARIABLE`](../commands-legacy/clear-variable.md) を呼び出すのと同じ効果があります: @@ -41,7 +41,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ - ブール: False - 文字列: "" - 数値: 0 - - 日付: 日付: 日付: 日付: 日付: 日付: "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" + - 日付: !00-00-00! "オブジェクトでは ISO日付フォーマットの代わりに日付型を使用する" 設定が有効化されている場合は !00-00-00!、それ以外の場合には "" - 時間: 0 (ミリ秒単位) - 未定義、Null: 変化なし @@ -51,7 +51,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ $o.a:=$o.b //$o.a=0 ``` -- 未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +- 未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 - 未定義の値を引数としてプロジェクトメソッドに渡した場合、宣言された引数の型に応じて、0 あるいは "" (空の文字列) へと自動変換されます。 @@ -97,7 +97,7 @@ Null は **null** の値のみをとることのできる特殊なデータタ | | Null `#` Undefined | Boolean | a.nullProp `#` b.undefinedProp | false | | | Null `#` *scalar value* | Boolean | a.nullProp `#` 42 | true | -*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でもnull でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: +*スカラー値* は、文字列、日付、時間、ブール、数値、BLOB のいずれかの型の値です。スカラー値が宣言されている場合、その [デフォルト値](data-types.md#デフォルト値) は未定義でも null でもありません。それ以外のデータ型 (ポインター、ピクチャー、オブジェクト、コレクション) の場合、デフォルト値は未定義または null となります。例: ```4d var $object : Object diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_number.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_number.md index 51db42b15d21cb..e01b7ab811cc1f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_number.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_number.md @@ -71,7 +71,7 @@ title: Number (実数、整数) - 10 % 2は、0を返します。 10 は 2 で割り切れるからです。 - 10 % 3は、1を返します。 余りが 1 だからです。 -- 10.5 % 2は、0を返します。 余りが整数ではない (0.25) からです。 +- 10.5 % 2は、0を返します。 余りが整数ではない (0.5) からです。 :::warning diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_object.md index 33a6f0328b9475..12b3cd12d3e12a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_object.md @@ -112,7 +112,7 @@ $col:=$o.col[5] // 6 - [`New object`](../commands-legacy/new-object.md) コマンド、またはオブジェクトリテラルのシンタックス (`{}`) を使用して作成する通常 (非共有) コレクション。 通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。通常のオブジェクトは特別なアクセスコントロールをせずに編集可能ですが、プロセス間で共有することはできません。 - [`New shared object`](../commands-legacy/new-shared-object.md) コマンドを使用して作成する共有コレクション。 共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。 共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。 - 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。共有オブジェクトはプロセス間 (プリエンティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 + 詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。共有オブジェクトはプロセス間 (プリエンプティブ・スレッド含む) で共有可能なオブジェクトです。共有オブジェクトへのアクセスは `Use...End use` 構造によって管理されています。詳細な情報については、[共有オブジェクトと共有コレクション](shared.md) を参照ください。 ## プロパティ{#properties} @@ -184,7 +184,7 @@ $col:=$o.col[5] // 6 ### Null 値 -オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。 例: +オブジェクトを使用するにあたって、**null** 値は **Null** コマンドを通してサポートされています。このコマンドを使用すると、null 値をオブジェクトプロパティに割り当てたり、それらと比較したりすることができます。例: ```4d myObject.address.zip:=Null @@ -195,7 +195,7 @@ $col:=$o.col[5] // 6 ### 未定義の値 -オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。 +オブジェクトプロパティを評価した結果、未定義の値が生成されることがあります。未定義の値を既存のオブジェクトプロパティに代入した場合、その値は初期化、あるいは消去されます。未定義の値を存在しないオブジェクトのプロパティへと代入した場合は、何も起こりません。 詳細については [Null と 未定義](dt_null_undefined.md) を参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_picture.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_picture.md index 2185156e160dc5..1caf177f118a27 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_picture.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_picture.md @@ -33,8 +33,8 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを | -------- | ------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 水平連結 | Pict1 + Pict2 | Picture | Pict1 の右側に Pict2 を追加します | | 垂直連結 | Pict1 / Pict2 | Picture | Pict1 の下側に Pict2 を追加します | -| 排他的論理和 | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | -| 包括的論理和 | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | +| 排他的重ね合わせ | Pict1 & Pict2 | Picture | Pict1 の前面に Pict2 を重ねます (Pict2 が前面) `COMBINE PICTURES(pict3;pict1;Superimposition;pict2)` と同じ結果になります。 | +| 包括的重ね合わせ | Pict1 | Pict2 | Picture | Pict1 と Pict2 を重ね、そのマスクした結果を返します (両ピクチャーとも同じサイズである必要があります) `$equal:=Equal pictures(Pict1;Pict2;Pict3)` と同じ結果になります。 | | 水平移動 | Picture + Number | Picture | 指定ピクセル分、ピクチャーを横に移動します。 | | 垂直移動 | Picture / Number | Picture | 指定ピクセル分、ピクチャーを縦に移動します。 | | リサイズ | Picture \* Number | Picture | 割合によってピクチャーをサイズ変更します。 | @@ -71,7 +71,7 @@ WIC および ImageIO はピクチャー内のメタデータの書き込みを ![](../assets/en/Concepts/concatVer.en.png) ![](../assets/en/Concepts/concatVer2.en.png) -排他的論理和 +排他的重ね合わせ ```4d Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 @@ -79,7 +79,7 @@ Pict3:=Pict1 & Pict2 // Pict1 の上に Pict2 を重ねます。 ![](../assets/en/Concepts/superimpoExc.fr.png) -包括的論理和 +包括的重ね合わせ ```4d Pict3:=Pict1|Pict2 // 同じサイズの二つのピクチャーを重ね合わせた上でそのマスクの結果を返します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_pointer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_pointer.md index 50ae7d97a89de3..8997c5db04196c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_pointer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_pointer.md @@ -3,7 +3,7 @@ id: pointer title: Pointer --- -ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、またはフィールドへの参照です。ポインタータイプのフィールドは、存在しません。 +ポインターの変数や式は、別の変数 (配列、配列要素を含む) 、テーブル、フィールド、またはオブジェクトへの参照です。ポインタータイプのフィールドは、存在しません。 ポインターは、(プログラミングにおける) データを参照するための高度な方法を提供します。 4D ランゲージ使用時にテーブル・フィールド・変数・配列等にアクセスするには、単純に名前を用います。ですが、名前を使用しないでデータを参照する、またはアクセスした方が便利な場合もあります。ポインターを使うとこれが実現できます。 @@ -47,7 +47,7 @@ $MyPointer-> 前述の式は、"Hello" という文字列を返します。ポインター記号 (->) をポインターの後につけると、参照先の値を取得することができます。これをデリファレンス (参照外し) と呼びます。 -ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、オリジナルの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: +ポインター記号 (->) を後につけたポインターは、その参照先を直接使うのと同義であることを理解することが重要です。つまり、もとの変数 $MyVar を使用することと、$MyPointer-> を使用することは、まったく同じ意味になります。たとえば、以下のステートメントはアラートボックスに文字列 "Hello" を表示します: ```4d ALERT($MyPointer->) @@ -59,7 +59,7 @@ $MyPointer を使用して $MyVar の値を変更することもできます。 $MyPointer->:="Goodbye" ``` -この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。 両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: +この2つの $MyPointer-> を使用した例のとおり、$MyVar を使用するのとまったく同じ動作が実行されます。以下の2つのステートメントも、同一の動作を実行します。両方とも、変数 $MyVar の現在の値をアラートボックスに表示します: ```4d ALERT($MyPointer->) @@ -154,7 +154,7 @@ $FieldPtr:=Field(1;2) OBJECT SET FONT($FieldPtr->;"Arial") ``` -### 変数へのポインター +### ローカル変数へのポインター プロセス変数またはローカル変数のポインターを使う場合、参照される変数はポインターが使用される時点ですでに定義されていなければなりません。ローカル変数は、それらを作成したメソッドの実行が終わると破棄され、プロセス変数もそれを作成したプロセスの終了時に削除される点に留意してください。存在しない変数をポインターで呼び出そうとすると、インタープリターモードでは (「変数が設定されていません」という内容の) シンタックスエラーが起きます。コンパイルモードでは、さらに重大なエラーが発生する可能性があります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_time.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_time.md index 0d04c4a95edf86..4b731c331977bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_time.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/dt_time.md @@ -7,7 +7,7 @@ title: Time 時間は 24時間制です。 -時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す総秒数です。 +時間の値は数値として扱うことができます。時間から返される数値は、その時間が表す深夜0時からの総秒数です。 **注:** *4Dランゲージリファレンス* マニュアルでは、コマンド説明における時間引数は特に明記されていない限り、「時間」と表記されています。 @@ -25,7 +25,7 @@ title: Time ?13:01:59? // 午後1時1分59秒 ``` -空の時間は、?00.00.00? のように指定します。 +空の時間は、?00:00:00? のように指定します。 **Tip:** コードエディターでは空の時間を入力するためのショートカットが提供されています。空の時間を入力するには、疑問符 (?) の入力後に Enterキーを押します。 @@ -34,26 +34,26 @@ title: Time | 演算 | シンタックス | 戻り値 | 式 | 値 | | --------------------------- | ------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | 加算 (足し算) | Time + Time | Time | ?02:03:04? + ?01:02:03? | ?03:05:07? | -| 減算 (引き算) | Time – Time | Time | ?02:03:04? ?01:02:03? | ?01:01:01? | +| 減算 (引き算) | Time – Time | Time | ?02:03:04? – ?01:02:03? | ?01:01:01? | | 加算 (足し算) | Time + Number | Number | ?02:03:04? + 65 | 7449 | -| 減算 (引き算) | Time – Number | Number | ?02:03:04? ?01:02:03? | 7319 | -| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? ?01:02:03? | 14768 | -| 除算 (割り算) | Time / Number | Number | ?02:03:04? ?01:02:03? | 3692 | -| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? ?02:03:04? | 3692 | +| 減算 (引き算) | Time – Number | Number | ?02:03:04? – 65 | 7319 | +| 乗算 (かけ算) | Time \* Number | Number | ?02:03:04? \* 2 | 14768 | +| 除算 (割り算) | Time / Number | Number | ?02:03:04? / 2 | 3692 | +| 倍長整数を返す除算 | Time \ Number | Number | ?02:03:04? \ 2 | 3692 | | モジューロ | Time % Time | Time | ?20:10:00? % ?04:20:00? | ?02:50:00? | | モジューロ | Time % Number | Number | ?02:03:04? % 2 | 0 | -| 等しい | Time = Time | Boolean | ?01:02:03? >=?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 異なる | Time # Time | Boolean | ?01:02:03? ?01:02:03? | true | -| | | | ?01:02:03? ?01:02:03? | false | -| 大きい | Time > Time | Boolean | ?01:02:03? > ?01:02:03? | true | +| 等しい | Time = Time | Boolean | ?01:02:03? = ?01:02:03? | true | +| | | | ?01:02:03? = ?01:02:04? | false | +| 異なる | Time # Time | Boolean | ?01:02:03? # ?01:02:04? | true | +| | | | ?01:02:03? # ?01:02:03? | false | +| 大きい | Time > Time | Boolean | ?01:02:04? > ?01:02:03? | true | | | | | ?01:02:03? > ?01:02:03? | false | | 小さい | Time < Time | Boolean | ?01:02:03? < ?01:02:04? | true | | | | | ?01:02:03? < ?01:02:03? | false | | 以上 | Time >= Time | Boolean | ?01:02:03? >=?01:02:03? | true | | | | | ?01:02:03? >=?01:02:04? | false | | 以下 | Time <= Time | Boolean | ?01:02:03? <=?01:02:03? | true | -| | | | ?01:02:03? <=?01:02:03? | false | +| | | | ?01:02:04? <=?01:02:03? | false | ### 例題 1 @@ -78,7 +78,7 @@ $vhSoon:=Time(Current time+3600) ### 例題 2 -モジューロ演算子を使用できます。 とくに24時間フォーマットを考慮した時間の追加に便利です: +モジューロ演算子を使用できます。とくに24時間フォーマットを考慮した時間の追加に便利です: ```4d $t1:=?23:00:00? // 23時です diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/error-handling.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/error-handling.md index c4b97ba0f35580..0765fa807d03f3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/error-handling.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/error-handling.md @@ -23,9 +23,9 @@ title: エラー処理 ## 予測可能なエラーvs予測不可能なエラー {#predictable-vs-unpredictable-errors} -[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドを実装する) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors.md) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 +[`entity.save()`](../API/EntityClass.md#save) や [`transporter.send()`](../API/SMTPTransporterClass.md#send) などの多くの4D クラス関数は、*status* 情報を格納しているオブジェクトを返します。このオブジェクトには、プログラムの実行を停止する必要のないエラー(無効なパスワード、ロックされたエンティティ)など、ランタイムコンテキストにおける**予測可能な**エラーを保存するのに使用されます。このカテゴリーのエラーは、**サイレントエラー**とも呼ばれ、通常のコードで管理することができます。 [`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは[エラー処理メソッド](#エラー処理メソッドの実装) などのエラー処理コンテキストにおいてこのようなエラーが発生した場合、これらは実行を中断することはせず、エラー処理(例: [`Try/Catch`](#trycatchend-try) の`Catch` 部分)をトリガーすることはありません。これらは[`Last errors`](../commands/last-errors.md) のコレクションには含まれません。エラーは返されるオブジェクトの`status` および `statusText` プロパティ内にのみ返されます。これはビジネスロジックに応じて処理することが可能です。 -もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors.md) のコレクションに含まれます。深刻なエラーは、プロパティに値(例: `dk status serious error` - "その他のエラー")も返すことがあり得るという点に注意してください。 +もう一つのエラーのカテゴリーは**予測不可能な**エラーと呼ばれ、別名**深刻なエラー**とも呼ばれます。これにはディスク書き込みエラー、ネットワーク失敗、あるいはそれ以外の予期せぬ中断が含まれます。これらのカテゴリーのエラーは[*コード*、*メッセージ*および*署名*](#エラーコード)によって定義される例外を生成します。これらは実行を中断し、[`Try`](#tryexpression)、[`Try/Catch`](#trycatchend-try) あるいは [エラー処理メソッド](#エラー処理メソッドの実装) 機能のエラー処理をトリガーします。これらは[`Last errors`](../commands/last-errors.md) のコレクションに含まれます。深刻なエラーは、`status` と `statusText` プロパティに値 (例: `dk status serious error` - "その他のエラー") を返すこともあり得るという点に注意してください。 ## エラー処理メソッドの実装 @@ -45,7 +45,7 @@ ON ERR CALL("IO_Errors";ek local) // ローカルなエラー処理メソッド ON ERR CALL("";ek local) // ローカルプロセスにおいてエラーの検知を中止します ``` -[`Method called on error`](../commands-legacy/method-called-on-error.md) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。 エラー処理メソッドを一時的に変更し、後で復元することができます: +[`Method called on error`](../commands-legacy/method-called-on-error.md) コマンドを使用すると、カレントプロセスにおいて`ON ERR CALL` で実装されたメソッドの名前を知ることができます。このコマンドは汎用的なコードでとくに有用です。エラー処理メソッドを一時的に変更し、後で復元することができます: ```4d $methCurrent:=Method called on error(ek local) @@ -98,7 +98,7 @@ ON ERR CALL("componentHandler";ek errors from components) // コンポーネン ::: - [`Last errors`](../commands/last-errors.md) コマンドは、4Dアプリケーションで発生したカレントエラースタックに関する情報をコレクションとして返します。 -- the [`Call chain`](../commands/call-chain) command that returns a collection of objects describing each step of the method call chain within the current process. +- [`Call chain`](../commands/call-chain) コマンドは、カレントプロセス内におけるメソッド呼び出しチェーンの各ステップを説明するオブジェクトのコレクションを返します。 #### 例題 @@ -229,7 +229,7 @@ End try - エラーがスローされなかった場合には、対応する `End try` キーワードの後へとコード実行が継続されます。 `Catch` と `End try` キーワード間のコードは実行されません。 - コードブロックの実行が *非遅延エラー* をスローした場合、実行フローは停止し、対応する `Catch` コードブロックを実行します。 -- コードブロックが *非遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 +- コードブロックが *遅延エラー* をスローするメソッドを呼び出した場合、実行フローは対応する `Catch` コードブロックへと直接ジャンプします。 - 遅延エラーが `Try` ブロックから直接スローされた場合、実行フローは `Try` ブロックの終わりまで継続し、対応する `Catch` ブロックは実行しません。 :::note @@ -290,7 +290,7 @@ Function createInvoice($customer : cs.customerEntity; $items : Collection; $invo コード実行を妨げる例外は4D によって返されますが、その原因はOS、デバイス、4D カーネル、コード内の[`throw`](../commands-legacy/throw.md) など、様々な要因が考えられます。 そのため、3つの要素によって定義されます: そのため、3つの要素によって定義されます: - **コンポーネント署名**。エラーの起きた場所を表します(署名の一覧については[`Last errors`](../commands/last-errors.md) を参照してください) -- **メッセージ**。エラーがなぜ起きたかを説明します。 +- **メッセージ**。エラーがなぜ起きたかを説明します - **コード**。コンポーネントによって返される任意の数値です。 [4D エラーダイアログボックス](../Debugging/basics.md) はユーザーに対してコードとメッセージを表示します。**コピー** ボタンをクリックすることで、エラーに関連した詳細な情報がペーストボードに保存されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/flow-control.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/flow-control.md index 85377c302cc435..fa5ca65f8a6aff 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/flow-control.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/flow-control.md @@ -7,7 +7,7 @@ title: 制御フロー - **シーケンシャル**: シーケンシャル構造は単純な線形構造です。シーケンスとは、4Dが最初から最後まで次々に実行する一連のステートメントです。オブジェクトメソッドで頻繁に使用される1行から成るルーチンはもっとも簡単なシーケンシャル構造の例です。例: `[People]lastName:=Uppercase([People]lastName)` - **分岐**: 分岐構造は、条件をテストし、その結果に基づいて異なる流れにメソッドを導きます。条件は true または false に評価されるブール式です。 [`If...Else...End if`](#ifelseend-if) 構文は分岐構造の一例で、処理フローを二つに分岐します。 [`Case of...Else...End case`](#case-ofelseend-case) 構文も分岐構造の一つで、処理フローをもっとたくさん分岐することができます。 -- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これに実現するために、4D は以下のループ構造を備えています: +- **ループ**: メソッドの作成にあたって、何度も同じ処理を繰り返すことがあります。これを実現するために、4D は以下のループ構造を備えています: - [`While...End while`](#whileend-while) - [`Repeat...Until`](#repeatuntil) @@ -16,7 +16,7 @@ title: 制御フロー ループを制御する方法には、条件が満たされるまでループする方法と、指定した回数だけループする方法の2通りがあります。各ループ構造はいずれの方法にも用いることができますが、`While` ループと `Repeat` ループは条件が満たされるまで繰り返す場合に、`For` ループは指定した回数だけループする場合の利用に適切です。 `For each...End for each` ループは両方を組み合わせることが可能で、オブジェクトやコレクション内でループするために設計されています。 -**注:** 4Dはプログラム構造 (If/While/For/Caes of/Repeat/For each) を512レベルまで入れ子で記述できます。 +**注:** 4Dはプログラム構造 (If/While/For/Case of/Repeat/For each) を512レベルまで入れ子で記述できます。 ## If...Else...End if @@ -268,7 +268,7 @@ vResult = 1の判定により他の条件を見る前に分岐するので、第 一般に、`While...End while` ループに入る手前で、ブール式で判定する値を初期化しておきます。値を初期化するとは適切な値に設定するということで、通常はブール式が true になるように設定してからループに入ります。 -ブール式は、ループ内の要素を使って設定されなければなりません。 そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 +ブール式は、ループ内の要素を使って設定されなければなりません。そうでなければ、ループは永久に続くでしょう。以下の例では、*NeverStop* がいつも true であるので、ループは永久に続きます。 ```4d NeverStop:=True @@ -309,7 +309,7 @@ Until(Boolean_Expression) #### 例題 -以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数　`OK` を初期化する `CONFIRM` コマンドはありません。 +以下の例を、`While...End while` ループの例と比較してください。ブール式を、初期化しておく必要がない点に注目してください。システム変数 `OK` を初期化する `CONFIRM` コマンドはありません。 ```4d Repeat @@ -375,7 +375,7 @@ End for End for ``` -4. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +4. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d FIRST RECORD([aTable]) @@ -424,7 +424,7 @@ End for End for ``` -8. 以下の例は、テーブル [aTable] のカレントセクションの各レコードについて処理をおこないます: +8. 以下の例は、テーブル [aTable] のカレントセレクションの各レコードについて処理をおこないます: ```4d LAST RECORD([aTable]) @@ -552,7 +552,7 @@ End for End for each ``` -`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の \*Expression \* を対象に反復処理をおこなうことができます: +`For each...End for each` 構造は、*Expression* に含まれるすべての*Current_item* に対して処理を繰り返します。 *Current_item* の型は *Expression* の型に依存します。 `For each...End for each` ループは3種類の *Expression* を対象に反復処理をおこなうことができます: - コレクション: コレクションの各要素をループします - エンティティセレクション: 各エンティティをループします diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/identifiers.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/identifiers.md index 59353fc439a0af..8437bd7d41b2fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/identifiers.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/identifiers.md @@ -75,7 +75,7 @@ Function getArea($width : Integer; $height : Integer)-> $area : Integer - 1文字目は、文字、数字、あるいはアンダースコア(_) でなければなりません。 - その後の文字には、文字・数字・アンダースコア(_)・スペースが使用できます。 - 予約語を使用しないでください。予約語にはコマンド名 (`Date`, `Time` 等)、キーワード (`If`, `For` 等)、そして定数 (`Euro`, `Black`, `Friday` 等) が含まれます。 -- 大文字・小文字は区別されます。 +- 大文字・小文字は区別されません。 例: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/interpreted.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/interpreted.md index 168d45256e64a6..36d3d5fe595e29 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/interpreted.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/interpreted.md @@ -27,7 +27,7 @@ title: インタープリターモードとコンパイル済みモード | 変数や配列のデータタイプは変更できません。 | 変数や配列のデータタイプは変更可能です (推奨されません) | | 1次元配列を2次元配列に、また2次元配列を1次元配列に変更することはできません。 | 可能です。 | | コンパイラーにより変数のタイプ定義はおこなわれますが、フォーム上の変数のようにデータタイプが明確でない場合は、宣言によって変数のデータタイプを指定するべきです。 | | -| `Undefined` 関数は、常に False を返します。 変数は常に定義されています。変数は常に定義されています。 | | +| `Undefined` 関数は、常に False を返します。変数は常に定義されています。 | | | メソッドの "プリエンプティブプロセスで実行可能" プロパティにチェックを入れていた場合、コードは他のスレッドアンセーフなコマンドやメソッドを呼び出してはいけません。 | プリエンプティブプロセスプロパティは無視されます。 | | 特定のループの場合、割り込みを可能にするには `IDLE` コマンドが必要です。 | いつでも割り込み可能です。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/methods.md index 045a45f64a7dcf..644384983b1402 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/methods.md @@ -5,7 +5,7 @@ title: メソッド メソッドとは、1つ以上の動作を実行するコードのことです。メソッドは、1つ以上のステートメントで構成されます。 -ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する) することができます。 +ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。ステートメントとは通常、メソッドの 1行のことを指します (必要に応じて [`\` 文字を使って行を分割](quick-tour.md#行を分割する)することができます)。 メソッドは最大 2GBのテキストまたは、32000行まで記述できます。 @@ -17,7 +17,7 @@ title: メソッド | ------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **プロジェクトメソッド** | 呼び出しに応じて ([プロジェクトメソッドの呼び出し](#calling-project-methods) 参照) | ◯ | 任意のアクションを実行するためのコードです。作成されたプロジェクトメソッドは、そのプロジェクトのランゲージの一部となります。 | | **オブジェクト (ウィジェット) メソッド** | メソッドが設定されたフォームオブジェクトに関連したイベント発生時に | × | フォームオブジェクト (ウィジェットとも呼びます) のプロパティです。 | -| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | +| **フォームメソッド** | メソッドが設定されたフォームに関連したイベント発生時に | × | フォームのプロパティです。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。 | | **トリガー** (別名 *テーブルメソッド*) | テーブルのレコード操作 (追加・削除・修正) の度に | × | テーブルのプロパティです。トリガーは、データベースのレコードに対して「不正な」操作がおこなわれることを防ぎます。 | | **データベースメソッド** | 作業セッションのイベント発生時に | ○ (既定) | 4D には 16のデータベースメソッドがあります。 | | **クラス** | [**クラス関数**](classes.md#function) は、オブジェクトインスタンスのコンテキストにおいて呼び出されます。 | ◯ | クラス関数にはビルトインのものと (*例:* `collection.orderBy()` や `entity.save()`)、開発者によって作成されるものがあります。 [**クラス**](classes.md) 参照。[**クラス**](classes.md) 参照。 | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/operators.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/operators.md index 4c93b98ad66543..3bd1c2e539f560 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/operators.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/operators.md @@ -11,8 +11,8 @@ title: 演算子 4Dランゲージでは、**二項演算子** および **三項演算子** をサポートしています: -- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2＋3`)。 -- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#ternary-operator) (a ? b : c\\`). +- 二項演算子とは、2つの対象に対して演算をおこない、その 2つの対象の間に表示されます (例: `2 + 3`)。 +- 三項演算子は 3つの対象に対して演算をおこないます。 C と同様、4D の三項演算子は 1つしかありません: [三項条件演算子](#三項演算子) (a ? b : c\`). 演算子が影響を与える対象はオペランド (被演算子) と呼ばれます。 `1 + 2` という式では、+ 記号は二項演算子であり、その 2つのオペランドは値 1 と 2 です。 @@ -95,7 +95,7 @@ $a+=2 // $a=3 - オブジェクトプロパティあるいはコレクション要素としてのピクチャー - 配列のインデックス変数 -"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()-+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 +"代入先 複合代入演算子 値" と "代入先 := 代入先 演算子 値" は、厳密には等価ではありません。なぜなら、前者の場合、代入先 (変数・フィールド・オブジェクトプロパティ・コレクション要素) は一度しか評価されないからです。たとえば、`getPointer()->+=1` のような式では、`getPointer` メソッドは一度だけ呼び出されます。 > [テキストの文字インデックス](dt_string.md#文字参照記号) および [BLOB のバイトインデックス](dt_blob.md#スカラーblob-のバイトへのアクセス) では、これらの演算子はサポートされません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/parameters.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/parameters.md index e5719e2dc505c9..ef3234cec95252 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/parameters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/parameters.md @@ -19,7 +19,7 @@ ALERT("Hello") $area:=$o.getArea(50;100) ``` -また、プロジェクトメソッド `DO SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: +また、プロジェクトメソッド `DO_SOMETHING` が3つの引数を受け取る場合、このメソッドを呼び出すには以下のように書きます: ```4d DO_SOMETHING($WithThis;$AndThat;$ThisWay) @@ -35,7 +35,7 @@ EXECUTE METHOD IN SUBFORM("Cal2";"SetCalendarDate";*;!05/05/20!) // その際に引数として日付リテラル !05/05/20! を渡します ``` -メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* コードは以下のようになります: +メソッドやクラス関数からデータを **返す** こともできます。以下は、文字列のデータ長を返すビルトインの `Length` コマンドを用いたステートメントです。このステートメントでは、`Length` 関数が *MyLength* という変数に値を返します。コードは以下のようになります: ```4d MyLength:=Length("How did I get here?") @@ -232,7 +232,7 @@ Function returnHello Result:=MySum("000";1;2;200) // "203" ``` -0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands-legacy/count-parameters.md) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: +0、1、またはそれ以上のパラメーターを宣言してある場合でも、任意の数の引数を渡すことができます。呼び出されたコード内では、`${N}` シンタックスを使って引数を利用でき、可変長引数の型はデフォルトで [バリアント](dt_variant.md) です ([可変長引数の記法](#可変長引数の宣言) を使ってこれらを宣言できます)。 [`Count parameters`](../commands-legacy/count-parameters.md) コマンドを使用して、パラメーターが存在することをあらかじめ確認しておく必要があります。例: ```4d // foo メソッド @@ -492,16 +492,16 @@ ALERT([People]Name) ALERT($param) ``` -`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Last Name フィールドの値には影響しません。 +`DO_SOMETHING` メソッドによって表示されたアラートボックスでは "WILLIAMS" と表示され、`MY_METHOD` メソッドによって表示されるアラートボックスでは "williams" と表示されます。 `DO_SOMETHING` メソッドは $param の値をローカルな範囲で変更しましたが、これは `MY_METHOD` メソッドがサブルーチンに渡す引数として指定した [People]Name フィールドの値には影響しません。 もし `DO_SOMETHING` メソッド内でフィールドの値を変更したいのであれば、2通りのやり方があります: -1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。 この場合、以下のようにコードを書きます: +1. サブルーチンに渡す式としてフィールドではなく、フィールドへのポインターを指定することができます。この場合、以下のようにコードを書きます: ```4d // MY_METHOD メソッド DO_SOMETHING(->[People]Name) // [People]Name の値が "williams" だとします -ALERT([People]Last Name) +ALERT([People]Name) // DO_SOMETHING メソッド #DECLARE($param : Text) @@ -530,7 +530,7 @@ ALERT($param->) オブジェクトやコレクションのデータタイプは参照 (つまり、内部的な *ポインター*) を介した形でのみ扱われることに注意が必要です。 -したがって、`$param、$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 +したがって、`$param`、`$return...` には *値* ではなく *参照* が格納されます。 `$param、$return...` の値をサブルーチン内で変更した場合、その変更は元となるオブジェクトやコレクションが使用されているところへと伝播します。これは [ポインター](dt_pointer.md#メソッドの引数としてのポインター) に対する原理と同じものですが、`$param、$return...` の使用にあたって参照を外す必要はありません。 次の例では、`CreatePerson` メソッドはオブジェクトを作成したのち、それを引数として `ChangeAge` に渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/quick-tour.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/quick-tour.md index b751b548d6e9b6..97bd1a0627d4ee 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/quick-tour.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/quick-tour.md @@ -31,7 +31,7 @@ $myHour:=?08:12:55? // 時間リテラルを代入します 代入演算 (:=) は必ず他の演算と区別しなければなりません。代入演算子は、被演算子を組み合わせて新しい一つのものにするのではなく、演算子の右側の式の値を左側の変数やフィールドにコピーします。 -**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 +**重要:** 代入演算子 (:=) と比較演算子 (=) とを混同しないように注意してください。 (=) とは異なる代入演算子が採用されたのは意図的なことで、他のプログラミング言語で (==) や (===) の使用によって度々起こる間違いを避けるためです。このような間違いはコンパイラーにとっても発見しにくく、時間を消耗するトラブルシューティングのもとです。 ## 変数 @@ -64,7 +64,7 @@ MyOtherDate:=Current date+30 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new") ``` -コレクションやオブジェクトにコマンドが属している場合、それらは名前付き関数であり、ドット記法を用いて使用します。例: +コレクションやオブジェクトにコマンドが属している場合、それらは関数と呼ばれ、ドット記法を用いて使用します。例: ```4d $c:=New collection(1;2;3;4;5) @@ -105,7 +105,7 @@ vRef:=Open document("PassFile";"TEXT";Read Mode) // ドキュメントを読み 4D が提供するたくさんのビルトインコマンドを使って、独自の **プロジェクトメソッド** を組み立てることができます。プロジェクトメソッドとはユーザー定義のメソッドで、コマンドや演算子などの要素から成り立ちます。プロジェクトメソッドは汎用性のあるメソッドですが、そうではない他の種類のメソッドも存在します: オブジェクトメソッド、フォームメソッド、テーブルメソッド (トリガー)、データベースメソッド。 -メソッドは、一つ以上のステートメントで構成されます。 ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 +メソッドは、一つ以上のステートメントで構成されます。ステートメントとは、メソッドの1行のことで1つの命令を実行します。ステートメントは 1つの命令を実行し、単純な場合もあれば複雑な場合もあります。 たとえば、次のステートメントは確認ダイアログボックスを表示します: @@ -144,7 +144,7 @@ $out:=Uppercase($in) データタイプのうち、文字タイプと数値タイプは、複数の類似するフィールドタイプに対応する点に注意してください。これらのフィールドにデータが格納されるとき、4D ランゲージはフィールドタイプに合致するデータタイプへとデータを自動的に変換します。反対に、たとえば整数フィールドのデータを呼び出すと、そのデータは自動的に数値タイプとして扱われます。つまり、4D ランゲージを使用する際に、類似するフィールドタイプを厳密に区別する必要はありません。 -しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。 しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 +しかし、プログラミングにおいて異なるデータタイプを混同しないようにすることは重要です。 "ABC" を日付フィールドに格納しても意味がないように、日付型の変数に "ABC" を格納することも意味がありません。 4D は、コードに書かれたことをできるだけ有効にしようとします。たとえば、日付に数値を加算した場合は、日付に日数を加算したいものと認識します。しかし、日付に文字列を加算した場合には、4D はその操作が意味を持たないことを警告します。 あるタイプとして格納したデータを、別のタイプとして使用する場合があります。 4D ランゲージには、データタイプを変換するためのコマンドが用意されています。たとえば、数値で始まり、"abc" 等の文字で終了する部品番号を作成する必要がある場合、以下のように記述することができます: @@ -258,7 +258,7 @@ This.name:="Square" 数値演算子は、使用可能な演算子のうちの 1種にすぎません。 4Dは、数値・テキスト・日付・ピクチャー等、異なるタイプのデータを扱うために、各データタイプで演算を実行するための演算子を備えています。 -対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。例えば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: +対象のデータタイプによって、同じ記号が異なる処理に使用される場合があります。たとえば、データタイプによってプラス記号 (+) は下記のように異なる演算を実行します: | データタイプ | 演算 | 例題 | | ------ | --------------------------- | --------------------------------------------------------------------- | @@ -272,11 +272,11 @@ This.name:="Square" コマンド・演算子・変数・フィールド・オブジェクトプロパティ・コレクション要素等、複数のランゲージの要素を組み合わせて式は構成されます。式により、ステートメント (メソッドの 1文や 1行) を構成します。データが必要なとき、式が必要になります。 -式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります : +式が単独で使われることはほとんどありませんが、単独で使用できる場合がいくつかあります。これには以下が含まれます: - フォーミュラエディター (フォーミュラによるクエリや並べ替えなど) - `EXECUTE FORMULA` コマンド -- フォームオブジェクトやウィジェットのデータソースとして +- プロパティリスト内で、フォームオブジェクトやウィジェットのデータソースとして - デバッガー内で式の値を確認することができます - クイックレポートエディターでカラムにフォーミュラを使用することができます @@ -284,30 +284,30 @@ This.name:="Square" 生成する値のタイプによって、式のタイプを定義することができます。式のタイプは複数あります。様々なタイプの式の例を以下に示します。 -| 式 | 型 | 説明 | -| ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | -| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | -| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | -| [People]Name + "様" | Text | 2つの文字列の結合です。 [People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | -| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | -| 4 | Number | これは数値定数 4です。 | -| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。 乗算演算子の (\*) を使用しています。数値の 8を返します。 | -| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | -| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | -| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | -| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | -| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | -| true | Boolean | このコマンドはブール値の true (真) を返します。 | -| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | -| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | -| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | -| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | -| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | -| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | -| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | -| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | -| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | -| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | +| 式 | 型 | 説明 | +| ------------------------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | +| "こんにちは" | Text | これは文字列定数 "こんにちは" です。 文字列定数であることを表すために二重引用符が必要です。 | +| "みなさん" + "こんにちは" | Text | 2つの文字列 "みなさん" と "こんにちは" が + 演算子により結合され、"みなさんこんにちは" を返します。 | +| [People]Name + "様" | Text | 2つの文字列の結合です。[People]Name フィールドと文字列 "様" が結合されます。フィールドの値が "小林" の場合、"小林様" を返します。 | +| Uppercase ("smith") | Text | この式は `Uppercase` コマンドを使用して、文字列 "smith" を英大文字に変換します。そして "SMITH" を返します。 | +| 4 | Number | これは数値定数 4です。 | +| 4 \* 2 | Number | 2つの数値、4 と 2 の乗算です。乗算演算子の (\*) を使用しています。数値の 8を返します。 | +| myButton | Number | これはボタンに紐づけられた変数です。ボタンの現在の値を返します: クリックされた場合に 1、それ以外は 0 を返します。 | +| !06/12/24! または !2006/12/24! | Date | この式は日付定数で 2006年12月24日を表します。 | +| Current date + 30 | Date | これは日付式です。`Current date` コマンドを使用して今日の日付を取得し、今日の日付に30日を足した、新しい日付を返します。 | +| ?8:05:30? | Time | これは時間定数で、8時5分30秒を表します。 | +| ?2:03:04? + ?1:02:03? | Time | 2つの時間の足し算をおこない、3時5分7秒を返します。 | +| true | Boolean | このコマンドはブール値の true (真) を返します。 | +| 10 # 20 | Boolean | これは 2つの数値の論理比較です。#記号は、"等しくない" を表します。 10と20は "等しくない" ため、この式は true (真) を返します。 | +| "ABC" = "XYZ" | Boolean | これは文字列の論理比較です。文字列は等しくないため、式は FALSE (偽) を返します。 | +| My Picture + 50 | Picture | この式は My Picture 変数に入っているピクチャーを右に 50ピクセル移動したピクチャーを返します。 | +| ->[People]Name | Pointer | この式は [People]Name フィールドへのポインターを返します。 | +| Table (1) | Pointer | このコマンドは一番目に定義されたテーブルへのポインターを返します。 | +| JSON Parse (MyString) | Object | このコマンドは MyString が適切なフォーマットであれば、オブジェクトとして返します。 | +| JSON Parse (MyJSONArray) | Collection | このコマンドは MyJSONArray が適切なフォーマットであれば、コレクションとして返します。 | +| Form.pageNumber | オブジェクトプロパティ | オブジェクトプロパティは式として、サポートされているいずれのタイプでもありえます。 | +| Col[5] | コレクション要素 | コレクション要素は式として、サポートされているいずれのタイプでもありえます。 | +| $entitySel[0] | Entity | ORDA のエンティティセレクションの要素である、エンティティを返します。これは **代入不可の式** です。 | ### 代入可能な式vs代入不可の式 {#assignable-vs-non-assignable-expressions} diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/shared.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/shared.md index 300d6b51bb2a20..82e1943eb8fc3e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/shared.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/shared.md @@ -82,7 +82,7 @@ End Use ### ストレージ -**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands-legacy/storage.md) コマンドによって返されます。このオブジェクトは、他のプリエンティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 +**ストレージ** は固有の共有オブジェクトで、各アプリケーションおよびマシン上で利用可能です。この共有オブジェクトは[`Storage`](../commands-legacy/storage.md) コマンドによって返されます。このオブジェクトは、他のプリエンプティブあるいは標準プロセスからでも利用出来るように、セッション中に定義されたすべての共有オブジェクト/コレクションを参照するためのものです。 `ストレージ` オブジェクトは標準の共有オブジェクトとは異なり、共有オブジェクト/コレクションがプロパティとして追加されたときでも共有グループを作成しないという点に注意してください。この例外的な振る舞いにより、**ストレージ** オブジェクトを使用するたびに、リンクされている共有オブジェクト/コレクションをすべてロックせずに済みます。 @@ -102,10 +102,10 @@ End Use 共有オブジェクトおよび共有コレクションは、プロセス間の (とくに \*[プリエンプティブプロセス](../Develop/preemptive.md)\*間の) 通信ができるように設計されています。これらはプロセスから他のプロセスへ、参照型の引数として渡すことができます。共有オブジェクトおよび共有コレクションを扱う際には、複数プロセスによる同時アクセスを避けるために、必ずそれらを `Use...End use` キーワードでくくる必要があります。 -- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のプすべてのロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 +- **Use** の実行が成功すると、対応する `End use` が実行されるまで、*Shared_object_or_Shared_collection* のすべてのプロパティ/要素は他のあらゆるプロセスに対し書き込みアクセスがロックされます。 - *statement(s)* で実行されるステートメントは、Shared_object_or_Shared_collection のプロパティ/要素に対して、競合アクセスのリスクなしに変更も実行することができます。 - *Shared_object_or_Shared_collection* に他の共有オブジェクトあるいはコレクションがプロパティとして追加された場合、それらも同じ共有グループとして連結されます。 -- \*\*Use...End use \*\* 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 +- **Use...End use** 内ステートメントの実行中に、他のプロセスが *Shared_object_or_Shared_collection* のプロパティやリンクされたプロパティにアクセスしようとした場合、そのアクセスは自動的に保留され、実行中の処理が終了するまで待機します。 - **End use** は、*Shared_object_or_Shared_collection* プロパティおよび、同じグループのすべてのオブジェクトのロックを解除します。 - 4D コード内では、複数の **Use...End use** 構文を入れ子にすることができます。グループの場合、**Use** を使用するごとにグループのロックカウンターが 1 増加し、 **End use** ごとに 1 減少します。最後の **End use** によってロックカウンターが 0 になった場合にのみ、すべてのプロパティ/要素のロックが解除されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/variables.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/variables.md index 7058692c4fe739..dc82d0a34dc018 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/variables.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Concepts/variables.md @@ -59,23 +59,23 @@ var $myVar // バリアント型変数 サポートされている `varType` 値の一覧です: -| varType | 内容 | -| ---------------------------------------------- | -------------------------------- | -| `Text` | テキスト値 | -| `Date` | 日付値 | -| `Time` | 時間値 | -| `Boolean` | ブール値 | -| `Integer` | 倍長整数値 | -| `Real` | 実数値 | -| `Pointer` | ポインター値 | -| `Picture` | ピクチャー値 | -| `Blob` | スカラーBLOB値 | -| `Collection` | コレクション値 | -| `Variant` | バリアント値 | -| `Object` | デフォルトクラスのオブジェクト | -| `4D.` | 4Dクラス名のオブジェクト | -| `cs.` | ユーザークラス名のオブジェクト | -| `cs.`cs. | `` コンポーネントクラス名のオブジェクト | +| varType | 内容 | +| --------------------------- | -------------------------------- | +| `Text` | テキスト値 | +| `Date` | 日付値 | +| `Time` | 時間値 | +| `Boolean` | ブール値 | +| `Integer` | 倍長整数値 | +| `Real` | 実数値 | +| `Pointer` | ポインター値 | +| `Picture` | ピクチャー値 | +| `Blob` | スカラーBLOB値 | +| `Collection` | コレクション値 | +| `Variant` | バリアント値 | +| `Object` | デフォルトクラスのオブジェクト | +| `4D.` | 4Dクラス名のオブジェクト | +| `cs.` | ユーザークラス名のオブジェクト | +| `cs.` | `` コンポーネントクラス名のオブジェクト | :::note 互換性 @@ -184,7 +184,7 @@ MyNumber:=3 ## ローカル、プロセス、およびインタープロセス変数 -**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 +**ローカル**、**プロセス**、および **インタープロセス** という、3種類の変数を作成することができます。これらの変数の違いは使用できるスコープにあります。また、それらを使用することのできるオブジェクトも異なります。 ### ローカル変数 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/building.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/building.md index 1f096650587aeb..4c7e7f54627fde 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/building.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/building.md @@ -677,7 +677,7 @@ userPrefs:=Get 4D folder(Active 4D Folder) #### データリンクモードの設定 -コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、 \*\*アプリケーション名 \*\* でリンクされます。 +コンパイルされたアプリケーションでは、4D は最後に使用されたデータファイルを自動的に使用します。デフォルトでは、データファイルのパスはアプリケーションのユーザー設定フォルダー内に保存され、**アプリケーション名** でリンクされます。 異なるデータファイルを使用するために組み込みアプリを複製する場合には、この方法は適さないかもしれません。複製されたアプリは同じアプリケーションユーザー設定フォルダーを共有するため、同じデータファイルを使用することになります (最後に使用されたファイルが開かれるため、データファイル名を変更した場合でも結果は同じです)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md index 1beaa114580a41..1985ecebb59526 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/clientServer.md @@ -30,7 +30,7 @@ title: クライアント/サーバー管理 1. 次のいずれかの方法をおこないます: - Welcome ウィザードにて **4D Serverに接続** を選択します。 - - **ファイル** メニューより \*\*開く ＞ リモートプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **リモートプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 4D Server に接続するためのダイアログが表示されます。ダイアログには **最近使用**、**利用可**、および **カスタム** という、3つのタブがあります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/labels.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/labels.md index ce58c8ea1f22ed..4c5a8115de97f9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/labels.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Desktop/labels.md @@ -55,7 +55,7 @@ title: ラベル ### ラベルプレビューエリア -このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ)) を指定できます)。 +このエリアを使用して、ラベルに表示させるすべてのオブジェクトの配置を調整し、ラベルを設計します。白い長方形は一つのラベルを表します(ラベルの大きさは [レイアウトページ](#レイアウトページ) で指定できます)。 - ラベルにはフィールドをドラッグすることができます。 - 一つ目のフィールドの上に他のフィールドをドロップする事で二つのフィールドを結合する事もできます。これらは自動的にスペースで区切られます。
    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md index 5c96a6ee73ac73..cf7fab4c699f99 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/onAfterEdit.md @@ -62,11 +62,11 @@ title: On After Edit #### action = DragFillBlock -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| fillRange | object | 自動入力のために使用されるレンジ | -| autoFillType | longint | 自動入力のために使用される値。
  • 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | -| fillDirection | longint | フィルの方向
  • フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | +| プロパティ | 型 | 説明 | +| ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| fillRange | object | 自動入力のために使用されるレンジ | +| autoFillType | longint | 自動入力のために使用される値。
  • 0: 全データ (値、書式、フォーミュラ) がセルに入力された
  • 1: 自動シーケンシャルデータがセルに入力された
  • 2: 書式のみがセルに入力された
  • 3: 値のみがセルに入力され、書式は入力されていない
  • 4: セルから値が除去された
  • 5: セルは自動的に入力された
    • | +| fillDirection | longint | フィルの方向
  • 0: 左側のセルがフィルされた
  • 1: 右側のセルがフィルされた
  • 2: 上側のセルがフィルされた
  • 3: 下側のセルがフィルされた
    • | #### action = formulaChanged diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/pictures.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/pictures.md index 445e6be9790ef0..585cea2ef076f0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/pictures.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/pictures.md @@ -57,10 +57,10 @@ title: ピクチャー 高解像度が自動的に優先されますが、スクリーンやピクチャーの dpi *(\*)*、およびピクチャー形式によって、動作に違いが生じることがあります: -| 演算 | 動作 | -| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
  • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
  • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    • | -| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | +| 演算 | 動作 | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ドロップ、ペースト | もしピクチャーの解像度が:
    • **72dpi または 96dpi** - ピクチャーは [中央合わせ](FormObjects/properties_Picture.md#中央合わせ-トランケート-中央合わせしない) 表示され、ピクチャーを表示しているオブジェクトは同じピクセル数です。
    • **その他の dpi** - 画像は"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされ、ピクチャーを格納しているオブジェクトは(ピクチャーのピクセル数 \* スクリーンdpi) / (ピクチャーの dpi) と同じになります。
    • **dpi なし** - ピクチャーは"[スケーリング](FormObjects/properties_Picture.md#スケーリング)" フォーマットされます。
    | +| [自動サイズ](https://doc.4d.com/4Dv20/4D/20.2/Setting-object-display-properties.300-6750143.ja.html#148057) (フォームエディターのコンテキストメニュー) | ピクチャーの表示が:
    • **[スケーリング]](FormObjects/properties_Picture.md#スケーリング)** - ピクチャーを表示しているオブジェクトのピクセル数は (ピクチャーのピクセル数 / ピクチャーの dpi) \* (スクリーンの dpi) にリサイズされます。
    • **スケーリング以外** - ピクチャーを表示しているオブジェクトは、ピクチャーと同じピクセル数です。
    | *(\*) 通常は macOS = 72dpi, Windows = 96dpi* diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_Action.md index 6d9cbd7c33c021..e4a5e1851c7b3f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_Action.md @@ -5,7 +5,7 @@ title: 動作 ## メソッド -フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。 ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 +フォームに関連づけられたメソッドへの参照。フォームメソッドを使用してデータとオブジェクトを管理することができます。ただし、これら目的には、オブジェクトメソッドを使用する方が通常は簡単であり、より効果的です。詳細は[メソッド](../Concepts/methods.md) を参照してください。 メソッドが関連づけられているフォームに関わるイベントが発生した場合、4D は自動的にフォームメソッドを呼び出します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_FormProperties.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_FormProperties.md index a95d4b342b8fc4..71e727016b622a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_FormProperties.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormEditor/properties_FormProperties.md @@ -33,9 +33,9 @@ title: フォームプロパティ #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| --- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| css | string または collection | CSS file path(s) provided as:
  • a string (a file for both platforms)
  • a collection of strings (a list of files for both platform)
  • a collection of {"path":string;"media":"mac" | "windows"} objects
    • | +| 名称 | データタイプ | とりうる値 | +| --- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| css | string または collection | CSSファイルパス:
  • 文字列 (両方のプラットフォーム用に 1ファイル)
  • 文字列のコレクション (両プラットフォーム用のファイルのリスト)
  • {"path":string;"media":"mac" | "windows"} オブジェクトのコレクション
    • | --- diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/dropdownList_Overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/dropdownList_Overview.md index f443ae046667a1..703e4d684c6425 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/dropdownList_Overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/dropdownList_Overview.md @@ -165,7 +165,7 @@ Form.myDrop.index //3 ## プロパティ一覧 -[Alpha Format](properties_Display.md#alpha-format) - [Bold](properties_Text.md#bold) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Data Type (expression type)](properties_DataSource.md#data-type-expression-type) - [Data Type (list)](properties_DataSource.md#data-type-list) - [Date Format](properties_Display.md#date-format) - [Expression Type](properties_Object.md#expression-type) - [Focusable](properties_Entry.md#focusable) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Help Tip](properties_Help.md#help-tip) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Not rendered](properties_Display.md#not-rendered) - [Object Name](properties_Object.md#object-name) - [Right](properties_CoordinatesAndSizing.md#right) - [Standard action](properties_Action.md#standard-action) - [Save value](properties_Object.md#save-value) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) +[タイプ](properties_Object.md#タイプ) - [オブジェクト名](properties_Object.md#オブジェクト名) - [変数あるいは式](properties_Object.md#変数あるいは式) - [式の型](properties_Object.md#式の型式タイプ) - [値を記憶](properties_Object.md#値を記憶) - [CSSクラス](properties_Object.md#cssクラス) - [データタイプ (セレクションおよびコレクションリストボックス列)](properties_DataSource.md#データタイプ-(リスト)) - [データタイプ](properties_DataSource.md#データタイプ-リスト) - [左](properties_CoordinatesAndSizing.md#左) - [上](properties_CoordinatesAndSizing.md#上) - [右](properties_CoordinatesAndSizing.md#右) - [下](properties_CoordinatesAndSizing.md#下) - [幅](properties_CoordinatesAndSizing.md#幅) - [高さ](properties_CoordinatesAndSizing.md#高さ) - [横方向サイズ変更](properties_ResizingOptions.md#横方向サイズ変更) - [縦方向サイズ変更](properties_ResizingOptions.md#縦方向サイズ変更) - [選択リスト](properties_DataSource.md#選択リスト) - [フォーカス可](properties_Entry.md#フォーカス可) - [文字フォーマット](properties_Display.md#文字フォーマット) - [日付フォーマット](properties_Display.md#日付フォーマット) - [時間フォーマット](properties_Display.md#時間フォーマット) - [表示状態](properties_Display.md#表示状態) - [レンダリングしない](properties_Display.md#レンダリングしない) - [フォント](properties_Text.md#フォント) - [フォントサイズ](properties_Text.md#フォントサイズ) - [太字](properties_Text.md#太字) - [イタリック](properties_Text.md#イタリック) - [下線](properties_Text.md#下線) - [フォントカラー](properties_Text.md#フォントカラー) - [横揃え](properties_Text.md#横揃え) - [ヘルプTips](properties_Help.md#ヘルプtips) - [標準アクション](properties_Action.md#標準アクション) ## サポートされるイベント diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox-object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox-object.md index 422609816f2ae3..9f3182d9f956d3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox-object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox-object.md @@ -28,7 +28,7 @@ LIST TO ARRAY("ListName";varCol) ## セレクションリストボックス -このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+“ ”[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands-legacy/listbox-set-column-formula.md) や [`LISTBOX INSERT COLUMN FORMULA`](../commands-legacy/listbox-insert-column-formula.md) コマンドを使用して、カラムをプログラムで変更することもできます。 +このタイプのリストボックスでは、列ごとにフィールド (例: `[Employees]LastName`) や式を割り当てます。式は 1つ以上のフィールド (たとえば `[Employees]FirstName+" "[Employees]LastName`) または単にフォーミュラ (たとえば `String(Milliseconds)`) を使用できます。式にはプロジェクトメソッド、変数、あるいは配列項目も指定できます。また[`LISTBOX SET COLUMN FORMULA`](../commands-legacy/listbox-set-column-formula.md) や [`LISTBOX INSERT COLUMN FORMULA`](../commands-legacy/listbox-insert-column-formula.md) コマンドを使用して、カラムをプログラムで変更することもできます。 それぞれの行はセレクションのレコードを基に評価されます。セレクションは **カレントセレクション** または **命名セレクション**です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox_overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox_overview.md index 6261dabd1dc36c..05eef4d40508b6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox_overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/listbox_overview.md @@ -241,14 +241,14 @@ JSON フォームにおいて、リストボックスに次のハイライトセ 標準ソートのサポートは、リストボックスのタイプに依存します: -| リストボックスタイプ | 標準ソートのサポート | コメント | -| ------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | -| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | -| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。 この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照) | -| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | -| 命名セレクション | × | | -| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | +| リストボックスタイプ | 標準ソートのサポート | コメント | +| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Object の Collection | ◯ |
    • "This.a" や "This.a.b" 列はソート可能です。
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    | +| スカラー値のコレクション | × | [`orderBy()`](../API/CollectionClass.md#orderby) 関数を使ったカスタムソートを使用します。 | +| エンティティセレクション | ◯ |
    • [リストボックス列の式プロパティ](properties_Object.md#変数あるいは式) は [代入可能な式](../Concepts/quick-tour.md#代入可-vs-代入不可の式) でなくてはなりません。
    • サポートされる: オブジェクト属性プロパティに対するソート (例: "data" がオブジェクト属性であるときに"This.data.city")
    • サポートされる: リレートされた属性に対するソート(例: "This.company.name")
    • サポートされない: リレートされた属性を経由したオブジェクト属性に対するソート(例: "This.company.data.city")。この場合には、[`orderByFormula()`](../API/EntitySelectionClass.md#orderbyformula) 関数を使ったカスタムソートを使用します (後述の例題参照)
    | +| カレントセレクション | ◯ | 単純な式のみソート可能です (例: `[Table_1]Field_2`) | +| 命名セレクション | × | | +| 配列 | ◯ | ピクチャー配列やポインター配列と紐づけられた列はソートできません | ### カスタムソート @@ -368,7 +368,7 @@ End if ### プレビューモード -プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。 とくに、表示されている以上の行を印刷することはできません。 +プレビューモードでのリストボックスの印刷は、標準の印刷コマンドや **印刷** メニューを使用して、リストボックスを含むフォームをそのまま出力します。リストボックスはフォーム上に表示されている通りに印刷されます。このモードでは、オブジェクトの印刷を細かく制御することはできません。とくに、表示されている以上の行を印刷することはできません。 ### 詳細モード diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Action.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Action.md index b16cd1ee4ff962..35623913ef897e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Action.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Action.md @@ -22,9 +22,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dragging | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dragging | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト @@ -54,9 +54,9 @@ title: 動作 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dropping | text | "none" (default), "custom" (excluding plug-in area), "automatic" (excluding button and list box) | +| 名称 | データタイプ | とりうる値 | +| -------- | ------ | --------------------------------------------------------------------------------------------------------------- | +| dropping | text | "なし" (デフォルト)、"カスタム" (プラグインエリアを除く)、"自動"(ボタンとリストボックスを除く) | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Appearance.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Appearance.md index f54c7ef9b36f4f..cae4137892890b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Appearance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Appearance.md @@ -31,9 +31,9 @@ Windows上では "推奨選択肢" の概念はサポートされていないた --- -## Display formula source as symbol +## フォーミュラのソースを記号として表示 -Displays source text of formulas as symbols when expressions are shown as references. +式が参照として表示される場合、フォーミュラのソーステキストを記号として表示します。 #### JSON 文法 @@ -149,7 +149,7 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show background and anchored elements +## 背景とアンカーされた要素を表示 ページの背景画像および背景色を表示/非表示にします。 @@ -169,9 +169,9 @@ Displays source text of formulas as symbols when expressions are shown as refere --- -## Show empty or unsupported images +## 空またはサポートされていない画像を表示 -Displays/hides a black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). +読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示したり非表示にします。 #### JSON 文法 @@ -355,9 +355,9 @@ HTML WYSIWYG ビューを有効/無効にします。 このビューでは、 --- -## Show table borders +## 表組みの境界線を表示 -Displays internal and external table borders as dotted lines when these borders are partially or totally invisible. This facilitates page layout (more accessible, more visual resizing) and data entry (convenient in the case of merged cells, for example). +境界線が部分的または完全に非表示になっている場合には、表組の内部および外部の境界線を点線として表示します。これによりページレイアウト(よりアクセスしやすく、視覚的にリサイズしやすく)およびデータ入力(結合されたセルなどの場合に便利に)が容易になります。 ![](../assets/en/FormObjects/visible.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Object.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Object.md index 03d9e66617ac2a..2aaa6cc07a4ba8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Object.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_Object.md @@ -139,9 +139,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | +| 名称 | データタイプ | とりうる値 | +| ---------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSource | string、または string のコレクション |
  • 4D変数、フィールド名、あるいは任意の式
  • [ダイナミック変数](#ダイナミック変数) の場合は、空の文字列。
  • [階層リストボックス](listbox_overview.md#階層リストボックス) 列の場合に、文字列 (配列名) のコレクション
    • | ### 式 @@ -212,9 +212,9 @@ title: オブジェクト #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。 *配列/セレクションリストボックスのみ*: "integer", "object"
    • *配列/セレクションリストボックスのみ*: "integer", "object" | +| 名称 | データタイプ | とりうる値 | +| ------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| dataSourceTypeHint | string |
  • **標準のオブジェクト**: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined"
  • **リストボックス列:** "boolean", "number", "picture", "text", date", "time"。*配列/セレクションリストボックスのみ*: "integer", "object"
    • | #### 対象オブジェクト @@ -274,7 +274,7 @@ title: オブジェクト コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。 -コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、 [`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: +コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、[`This`](../Concepts/classes.md#this) キーワードを通してオブジェクトとして利用可能です: - オブジェクトのコレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: `This.`。 - エンティティセレクションを使用した場合、データソース式内で **This** コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: `This.`。 @@ -392,15 +392,15 @@ title: オブジェクト | 計算タイプ | Num | Text | Date | Time | Bool | Pict | フッター変数の型 | | ---------------------------------------- | --- | ---- | ---- | ---- | ---- | ---- | -------- | -| 最小 | X | X | X | X | X | | 列の型と同じ | -| 最大 | X | X | X | X | X | | 列の型と同じ | -| 合計 | X | | | X | X | | 列の型と同じ | -| カウント | X | X | X | X | X | X | Integer | -| 平均 | X | | | X | | | Real | -| 標準偏差(\*) | X | | | X | | | Real | -| 分散(\*) | X | | | X | | | Real | -| 平方和(\*) | X | | | X | | | Real | -| カスタム (JSON では "none") | X | X | X | X | X | X | 制限なし | +| 最小 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 最大 | ○ | ○ | ○ | ○ | ○ | | 列の型と同じ | +| 合計 | ○ | | | ○ | ○ | | 列の型と同じ | +| カウント | ○ | ○ | ○ | ○ | ○ | ○ | Integer | +| 平均 | ○ | | | ○ | | | Real | +| 標準偏差(\*) | ○ | | | ○ | | | Real | +| 分散(\*) | ○ | | | ○ | | | Real | +| 平方和(\*) | ○ | | | ○ | | | Real | +| カスタム (JSON では "none") | ○ | ○ | ○ | ○ | ○ | ○ | 制限なし | (\*) 配列型のリストボックスのみ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_RangeOfValues.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_RangeOfValues.md index b0d587e898babe..aa841a709729a7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_RangeOfValues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/FormObjects/properties_RangeOfValues.md @@ -17,22 +17,21 @@ title: 値の範囲 日付、時刻、シーケンス番号については、4D が提供する記号を使用することができます。日付と時刻はシステムから取得されます。シーケンス番号は 4D が自動で生成します。自動で使用できるデフォルト値の記号は以下の通りです: -| スタンプ | 意味 | -| ---- | ------- | -| #D | 本日の日付 | -| #H | 現在の時刻 | -| #N | シーケンス番号 | +| 記号 | 意味 | +| -- | ------- | +| #D | 本日の日付 | +| #H | 現在の時刻 | +| #N | シーケンス番号 | カレントデータファイルの特定のテーブルにおいて、レコード毎のユニーク番号を生成するためにシーケンス番号を使用することができます。シーケンス番号は倍長整数型で新規レコード毎に生成されます。番号は 1 から始まり、1ずつ増加します。シーケンス番号が割り当てられたレコードがテーブルから削除されても、その番号は再利用されません。シーケンス番号は各テーブルが保有する内部カウンターが管理します。詳細は [自動インクリメント](https://doc.4d.com/4Dv20/4D/20.2/Field-properties.300-6750280.ja.html#976029) の段落を参照してください。 -> このプロパティと、リストボックス列に固定値を表示させるための -> "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 +> このプロパティと、リストボックス列に固定値を表示させるための "[デフォルト値](properties_DataSource.md#デフォルト値)" を混同しないようにしてください。 #### JSON 文法 -| 名称 | データタイプ | とりうる値 | -| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- | -| defaultValue | string | Any value and/or a stamp as a string: "#D", "#H", "#N", "42", "true"... | +| 名称 | データタイプ | とりうる値 | +| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------ | +| defaultValue | string | 任意の値や、特定の記号の文字列: "#D", "#H", "#N", "42", "true"... | #### 対象オブジェクト diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/GettingStarted/creating.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/GettingStarted/creating.md index f895654cc5cec7..682ae0c5951802 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/GettingStarted/creating.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/GettingStarted/creating.md @@ -12,7 +12,7 @@ title: プロジェクトの作成・開始 1. 4D または 4D Server を起動します。 2. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*新規 > プロジェクト...\*\*を選択します: ![](../assets/en/getStart/projectCreate-1.png) + - **ファイル** メニューより **新規** > **プロジェクト...** を選択します: ![](../assets/en/getStart/projectCreate-1.png) - (4D のみ) **新規** ツールバーボタンより \*\*プロジェクト...\*\*を選択します:

    ![](../assets/en/getStart/projectCreate-2.png)

    標準の **保存** ダイアログが表示され、4D プロジェクトの名前と保存場所を指定します。 3. プロジェクトフォルダー名を入力したら、**保存**をクリックします。この名称はつぎの場所に使用されます: @@ -32,7 +32,7 @@ OS によって許可されている名称であれば使用可能です。し 1. 次のいずれかの方法をおこないます: - - **ファイル** メニューより \*\*開く ＞ ローカルプロジェクト...\*\*を選択するか、**開く** ツールバーボタンより同様に選択します。 + - **ファイル** メニューより **開く** ＞ **ローカルプロジェクト...** を選択するか、**開く** ツールバーボタンより同様に選択します。 - Welcome ウィザードにて **ローカルアプリケーションプロジェクトを開く** を選択します。 標準のファイルを開くためのダイアログが表示されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/encrypt.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/encrypt.md index 4e35b338fa43cd..e013daddc5aa76 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/encrypt.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/encrypt.md @@ -47,7 +47,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう 暗号化プロセスが正常に完了した場合、暗号化ページは 暗号化メンテナンスオペレーション ボタンを表示します。 -**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデーファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 +**警告**: 暗号化操作の最中、4D は新しい、空のデータファイルを作成したうえで、元のデータファイルからデータを注入します。"暗号化可能" テーブルに属しているレコードは暗号化後にコピーされ、他のレコードは単にコピーされるだけです (圧縮オペレーションも実行されます)。操作が正常に完了した場合、もとのデータファイルは "Replaced Files (Encrypting)" フォルダーへ移動されます。暗号化されたデータファイルを配布する場合、暗号化されていないデータファイルをアプリケーションフォルダーからすべて移動/削除しておくようにしてください。 ## 暗号化メンテナンスオペレーション @@ -86,7 +86,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ### パスフレーズを変更してデータを再暗号化する -この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスプレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 +この操作は、カレントの暗号化データキーを変更したい場合に有用です。たとえば、セキュリティ上のルール (3ヶ月ごとにパスフレーズを変更する必要があるなど) を遵守するために変更をおこないたいケースが考えられます。 1. **パスフレーズを変更してデータを再暗号化する** をクリックします。 2. カレントのデータ暗号化キーを入力します。 @@ -110,7 +110,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう ## 暗号化キーを保存する -4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。 なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 +4D ではデータ暗号化キーを専用ファイルに保存しておくことができます。ファイル名には、`.4DKeyChain` の拡張子が必要です (例: "myKeys.4DKeyChain")。このファイルを USBキーなどの外部デバイスに保存しておくと、暗号化されたアプリケーションを使うのが簡単になります。なぜならユーザーは暗号化されたデータにアクセスするには、アプリケーションを開く前にデバイスを接続してキーを提供すればよいからです。 新しいパスフレーズが提供されるたびに暗号化キーを保存することができます: @@ -121,7 +121,7 @@ MSC でデータファイルを初めて暗号化する場合、以下のよう :::caution -[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。 できない場合には、エラーが発生します。 +[自動復元とログの統合](../Backup/settings.md#自動復元とログの統合) 機能を使用する場合、デバイスの一番上の階層にデータ暗号化キーファイルを保存することが必須となります。復元処理がトリガーされるとき、4D は暗号化キーファイルにアクセスできなくてはなりません。できない場合には、エラーが発生します。 ::: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/overview.md index 000f1c827ccdce..bf793a36332bd9 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/MSC/overview.md @@ -14,7 +14,7 @@ MSCウィンドウを開く方法は幾つかあります。アクセスの方 メンテナンスモードでは、MSCウィンドウだけが表示されます (4Dアプリケーションはプロジェクトを開きません)。つまり、損傷が激しいため 4D が標準モードで開けないプロジェクトにもアクセスできるということです。さらに、特定の操作 (圧縮、修復など) はプロジェクトをメンテナンスモードで開くことを要求します ([アクセス権](#アクセス権) 参照)。 -次の 2つの場所から、MSC をメインテナンスモードで開くことができます: +次の 2つの場所から、MSC をメンテナンスモードで開くことができます: - **標準の開くダイアログボックス** 標準のプロジェクトを開くダイアログボックスには **開く** ボタンに関連付けられているメニューに **Maintenance & Security Center** オプションが含まれます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Menus/sdi.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Menus/sdi.md index 2fcb1c75cd2189..df7d10d5226eff 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Menus/sdi.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Menus/sdi.md @@ -17,7 +17,7 @@ SDIモードは以下の実行環境に限り利用可能です: - Windows - 組み込みの [スタンドアロン](../Desktop/building#スタンドアロンアプリケーションをビルド) または [クライアント](../Desktop/building#クライアントアプリケーションをビルド) 4Dアプリケーション -- **実行** メニューにて提供されている [\*\* アプリケーションをテスト\*\* 機能](bars.md#メニューバーのプレビュー) から利用可能です。 +- **実行** メニューにて提供されている [**アプリケーションをテスト** 機能](bars.md#メニューバーのプレビュー) から利用可能です。 ## SDIモードの有効化 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/glossary.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/glossary.md index 5bd6df1059360b..d552d0e730e6fe 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/glossary.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/glossary.md @@ -127,7 +127,7 @@ $myClass.query("name = smith") ## ミックスデータ型 -このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。 : +このドキュメントでは、データクラス属性に保存可能な値の様々な型を指定するために、"ミックス" データ型が使用されます。これには以下が含まれます: - number - text @@ -211,9 +211,9 @@ ORDA オブジェクトとは関わりのないユーザークラス。 シャロウコピーは、要素の構造のみを複製し、同じ内部参照を保持します。シャロウコピーのあと、二つのコレクションに格納された個々の要素は同じものが共有されています。ディープコピー も合わせて参照してください。 -## スタンプ +## 記号 -"オプティミステック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 +"オプティミスティック" ロックテクノロジーにおいて使用されるものです。すべてのエンティティにはスタンプと呼ばれる内部カウンターがあり、エンティティが保存されるたびにインクリメントされていきます。エンティティ内のスタンプとディスク上に保存されているエンティティのスタンプを自動的に比較することで、4D は同じエンティティへの書き込みの衝突を防いでいます。 ## ストレージ属性 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/privileges.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/privileges.md index 202ebf24877e1f..152a9ae07d86a3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/privileges.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ORDA/privileges.md @@ -58,7 +58,7 @@ Webユーザーまたは RESTユーザーがログインすると、そのセッ - エイリアス属性の元である属性に対するアクセス権をセッションが持っていない場合でも、[エイリアス属性](./ordaClasses.md#エイリアス属性-1) へのアクセス権があれば、これを読み取ることができます。 - 計算属性を構成する属性に対するアクセス権をセッションが持っていない場合でも、[計算属性](./ordaClasses.md#計算属性-1) へのアクセス権があれば、これを読み取ることができます。 -- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型）に適用されます。 +- シングルトンクラス (`singleton` 型) には許諾アクションを割り当てることができます。その場合、そのシングルトンクラスの公開関数すべて、および、シングルトン関数 (`singletonMethod` 型) に適用されます。 - [`promote()`](../API/SessionClass.md#promote) および [`demote()`](../API/SessionClass.md#demote) 関数を使用することで、Web プロセスに対して動的に **promote** アクションを設定/削除することができます。 - デフォルト値: 現在の実装では、*Null* のみデフォルト値として利用可能です。 - REST の [強制ログインモード](../REST/authUsers.md#強制ログインモード) では、[`authentify()`関数](../REST/authUsers.md#function-authentify) は、権限の設定に関係なく常にゲストユーザーによって実行可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/compiler.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/compiler.md index dde6c6c656d77a..d410fa8ac62455 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/compiler.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/compiler.md @@ -266,7 +266,7 @@ Symbolファイルを生成するのに使用します ([Symbolファイル](#sy ### エラーファイル -コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.txt` という名前で作成されます。 +コンパイラー設定の [**エラーファイルを生成**](#エラーファイルを生成) オプションを使用して、コンパイル時にエラーファイルを生成するかどうかを選択することができます。エラーファイルは、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs)内に `ProjectName_errors.xml` という名前で作成されます。 [コンパイラーウインドウ](#コンパイラーウインドウ) からエラーに直接アクセスすることができますが、マシンからマシンへ送信できるエラーファイルがあると便利な場合があります。エラーファイルは、その内容を自動的に解析しやすいように XMLフォーマットで生成されます。これを利用して、エラー表示用に独自のインターフェースを作成することもできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md index b500a5f5f05769..300f89c73468c6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Project/components.md @@ -24,7 +24,7 @@ title: 依存関係 - **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。[プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 - **コンパイル版コンポーネント**の場合: - - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー推奨されるアーキテクチャー) + - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー (推奨されるアーキテクチャー) - *Resources* などの他のフォルダーを格納している.4DZ ファイル。 :::note @@ -90,7 +90,7 @@ title: 依存関係 **優先度高** 1. [プロジェクトの **Components** フォルダー](architecture.md#components) に置かれているコンポーネント -2. dependencies.json\*\*ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 +2. **dependencies.json**ファイルで宣言されたコンポーネント (ローカル環境を構成するために **environment4d.json** で指定されたパスは **dependencies.json** のパスをオーバーライドします)。 3. 内部のユーザー4Dコンポーネント (4D NetKit、4D SVG など) **優先度低** @@ -539,7 +539,7 @@ GitHub 依存関係は[**dependencies.json**](#dependenciesjson) ファイル内 これに加えて、単一の依存関係あるいは全ての依存関係に対して、いつでも更新をチェックすることができます: -- 単一の依存関係に対して更新をチェクするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 +- 単一の依存関係に対して更新をチェックするためには、依存関係を右クリックしてコンテキストメニューから**更新をチェックする** を選択します。 ![check component](../assets/en/Project/check-component-one.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$filter.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$filter.md index 5ad6a598e88e3e..26bd093843b317 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$filter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$filter.md @@ -23,7 +23,7 @@ title: $filter **\{attribute\} {comparator} {value} {AND/OR/EXCEPT} \{attribute\} {comparator} {value}** -たとえば: `$filter="firstName=john AND salary>20000"` （`firstName` および `salary` は Employee データクラスの属性です)。 +たとえば: `$filter="firstName=john AND salary>20000"` (`firstName` および `salary` は Employee データクラスの属性です)。 ### paramsプロパティの使用 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md index 131a9086ea1cff..9f5adb232e2309 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/$method.md @@ -21,7 +21,7 @@ title: $method ### 説明 -`$method=delete` を使ってエンティティ、またはエンティティセレクションを削除します。たとえば、[`$filter`]($filter.md) を使って定義したエンティティセレクションや、[`\{dataClass\}(\{key\})`](dataClassD.md#dataclasskey) (*例*: /Employee(22)) のように直接特定したエンティティが対象です。 +`$method=delete` を使ってエンティティ、またはエンティティセレクションを削除します。たとえば、[`$filter`]($filter.md) を使って定義したエンティティセレクションや、[`\{dataClass\}(\{key\})`](dataClass.md#dataclasskey) (*例*: /Employee(22)) のように直接特定したエンティティが対象です。 [`$entityset/\{entitySetID\}`]($entityset.md#entitysetentitysetid) のようにエンティティセットを呼び出して、そこに含まれるエンティティを削除することもできます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md index 6a84eede161efe..657a3c0f726e83 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/REST/ClassFunctions.md @@ -10,8 +10,7 @@ REST リクエストを使って、ORDA データモデルに定義されてい - **POST リクエスト** を使用する。この場合、データ引数はリクエストの本文内で渡します。 - **GET リクエスト** を使用する。この場合、引数はURL 内に直接渡します。 -POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、 -よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 +POST リクエストは、リンクをクリックするだけのようなシンプルなアクションでセンシティブなコードを実行するのを避けられるため、より優れたセキュリティレベルを提供します。一方で、GET リクエストは、URL をブラウザーに入れるだけで関数を呼び出すことができるため、よりユーザーエクスペリエンスに沿っていると言えます(注意: 開発者は、このような機能でセンシティブなアクションが実行されないようにしなければなりません)。 ## 関数の呼び出し diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/maintenance.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/maintenance.md index 05f7ae4dfb761a..583a8a5c7754a4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/maintenance.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/maintenance.md @@ -13,25 +13,25 @@ title: メンテナンスページ ### レコードとインデックスを検査 -このボタンを使用して、サーバーを止めることなく検査処理を直接起動できます。検証の間、サーバーの動作が遅くなるかもしれないことに留意してください。検証の間、サーバーの動作が遅くなるかもしれないことに留意してください。 +このボタンを使用して、サーバーを止めることなく検査処理を直接起動できます。検証の間、サーバーの動作が遅くなるかもしれないことに留意してください。 データベースのすべてのレコードとすべてのインデックスが検証されます。検査対象を絞り込んだり、追加のオプションを指定したい場合は、[Maintenance ＆ Security Center](MSC/overview.md) (MSC) を使用します。 -検査後、サーバー上の [maintenance Logs](../Project/architecture.md#logs) フォルダーに、XML形式でレポートファイルが作成されます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。 +検査後、サーバー上の [maintenance Logs](../Project/architecture.md#logs) フォルダーに、XML形式でレポートファイルが作成されます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。 ### データ圧縮 -このボタンを使用して、データ圧縮処理を直接起動できます。このボタンを使用して、データ圧縮処理を直接起動できます。この処理をおこなうにはサーバーを停止させる必要があります。 ボタンをクリックすると、4D Server の終了ダイアログが表示され、終了方法を選択することができます: +このボタンを使用して、データ圧縮処理を直接起動できます。この処理をおこなうにはサーバーを停止させる必要があります。 ボタンをクリックすると、4D Server の終了ダイアログが表示され、終了方法を選択することができます: ![](../assets/en/Admin/server-shut.png) -アプリケーションが実際に停止された後、4D Server はデータベースのデータに対する標準の圧縮処理をおこないます。追加のオプションを指定したい場合は、[Maintenance ＆ Security Center](MSC/overview.md) (MSC) を使用します。追加のオプションを指定したい場合は、[Maintenance ＆ Security Center](MSC/overview.md) (MSC) を使用します。 +アプリケーションが実際に停止された後、4D Server はデータベースのデータに対する標準の圧縮処理をおこないます。追加のオプションを指定したい場合は、[Maintenance ＆ Security Center](MSC/overview.md) (MSC) を使用します。 圧縮が終了すると、4D Server は自動でデータベースを再開します。その後、4Dユーザーの再接続が可能になります。 > 圧縮リクエストがリモートの 4Dマシンからなされた場合、このマシンは 4D Server により自動で再接続されます。 -検査後、サーバー上の [maintenance Logs](../Project/architecture.md#logs) フォルダーに、XML形式でレポートファイルが作成されます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。 +検査後、サーバー上の [maintenance Logs](../Project/architecture.md#logs) フォルダーに、XML形式でレポートファイルが作成されます。**レポートを表示** (クライアントマシンから処理が実行された場合は **レポートをダウンロード**) ボタンをクリックすると、ブラウザーにレポートを表示できます。 ## 動作時間 @@ -45,14 +45,14 @@ title: メンテナンスページ ## 前回のバックアップ -このエリアには、データベースの [前回のバックアップ](MSC/backup.md) の日付・時刻と、予定された次のバックアップがあれば、それに関する情報が表示されます。自動バックアップは、ストラクチャー設定の **スケジューラー** ページで設定します自動バックアップは、ストラクチャー設定の **スケジューラー** ページで設定します +このエリアには、データベースの [前回のバックアップ](MSC/backup.md) の日付・時刻と、予定された次のバックアップがあれば、それに関する情報が表示されます。自動バックアップは、ストラクチャー設定の **スケジューラー** ページで設定します - **前回のバックアップ**: 前回のバックアップ日時。 - **次回のバックアップ**: 予定された次のバックアップ日時。 -- **必要なスペース**: バックアップに必要な計算された空き容量。バックアップファイルの実際のサイズは (圧縮などの)設定や、データファイルの変化により変わります。バックアップファイルの実際のサイズは (圧縮などの)設定や、データファイルの変化により変わります。 +- **必要なスペース**: バックアップに必要な計算された空き容量。バックアップファイルの実際のサイズは (圧縮などの)設定や、データファイルの変化により変わります。 - **空きスペース**: バックアップボリュームの空き容量。 -**バックアップ開始** ボタンを使用して、現在のバックアップパラメーター ( バックアップするファイル、アーカイブの場所、オプションなど) を使用したバックアップを即座に開始できます。**環境設定...** ボタンをクリックして、これらのパラメーターを確認できます。**バックアップ開始** ボタンを使用して、現在のバックアップパラメーター ( バックアップするファイル、アーカイブの場所、オプションなど) を使用したバックアップを即座に開始できます。**環境設定...** ボタンをクリックして、これらのパラメーターを確認できます。サーバー上でのバックアップがおこなわれる間、クライアントマシンはブロックされ (ただし接続解除はされません)、新規のクライアント接続はできなくなります。 +**バックアップ開始** ボタンを使用して、現在のバックアップパラメーター ( バックアップするファイル、アーカイブの場所、オプションなど) を使用したバックアップを即座に開始できます。**環境設定...** ボタンをクリックして、これらのパラメーターを確認できます。サーバー上でのバックアップがおこなわれる間、クライアントマシンはブロックされ (ただし接続解除はされません)、新規のクライアント接続はできなくなります。 ## リクエストとデバッグログ @@ -62,11 +62,11 @@ title: メンテナンスページ ### リクエストとデバッグのログを開始/停止 -**リクエストとデバッグのログを開始** ボタンでログファイルが開始されます。これによりパフォーマンスが著しく低下する場合があるため、これはアプリケーションの開発フェーズでのみ使用します。これによりパフォーマンスが著しく低下する場合があるため、これはアプリケーションの開発フェーズでのみ使用します。 +**リクエストとデバッグのログを開始** ボタンでログファイルが開始されます。これによりパフォーマンスが著しく低下する場合があるため、これはアプリケーションの開発フェーズでのみ使用します。 > このボタンは、サーバー上で実行されているオペレーションしか記録しません。 -ログが有効になると、ボタンのタイトルが **リクエストとデバッグのログを停止** に変わり、いつでもリクエストの記録を停止できます。停止後にログを再開すると、以前のファイルは消去されることに留意してください。停止後にログを再開すると、以前のファイルは消去されることに留意してください。 +ログが有効になると、ボタンのタイトルが **リクエストとデバッグのログを停止** に変わり、いつでもリクエストの記録を停止できます。停止後にログを再開すると、以前のファイルは消去されることに留意してください。 ### レポートを表示 @@ -74,11 +74,11 @@ title: メンテナンスページ ### ログ設定ファイルを読み込む -このボタンを押すと、特殊な [ログ設定ファイル](Debugging/debugLogFiles.md#ログ設定ファイルを使用する) (`.json` ファイル) をサーバーに読み込むことができます。この特殊ファイルは、特定のケースを監視・調査するために 4Dテクニカルサービスが提供することがあります。この特殊ファイルは、特定のケースを監視・調査するために 4Dテクニカルサービスが提供することがあります。 +このボタンを押すと、特殊な [ログ設定ファイル](Debugging/debugLogFiles.md#ログ設定ファイルを使用する) (`.json` ファイル) をサーバーに読み込むことができます。この特殊ファイルは、特定のケースを監視・調査するために 4Dテクニカルサービスが提供することがあります。 ### ログを停止する -このボタンを押すと、サーバーで開始されたログを記録する処理がすべて中断されます。この機能は、サーバーの処理を一時的に軽くするのに便利です。この機能は、サーバーの処理を一時的に軽くするのに便利です。 +このボタンを押すと、サーバーで開始されたログを記録する処理がすべて中断されます。この機能は、サーバーの処理を一時的に軽くするのに便利です。 ログが停止されると、ボタンのタイトルが **ログを再開する** に変わり、これを押すことでログの記録を再開することができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/real-time-monitor.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/real-time-monitor.md index daf211e73794e0..e41feba0a9520c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/real-time-monitor.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ServerWindow/real-time-monitor.md @@ -9,7 +9,7 @@ title: リアルタイムモニターページ > このページは、サーバーマシンの管理ウィンドウにありますが、リモートの 4Dマシンからも見られます。リモートマシンの場合は、サーバーマシン上で実行されている操作のデータを表示します。 -データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます。 +データに対して実行されている長い処理は、それぞれに行が割り当てられます。操作が完了すると、この行は消えます (**オペレーションを最低5秒間表示する** オプションをチェックすることで、短いオペレーションでも 5秒間表示したままにできます)。 各行について、以下の情報が表示されます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md index 0bd79023ce9164..7043a9003c53d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Tags/transformation-tags.md @@ -45,7 +45,7 @@ title: 変換タグ ### 再起的処理 -4Dタグは繰り返し解釈されます。 4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: +4Dタグは繰り返し解釈されます。4D は常に変換の結果を解釈しようとし、新しい変換が起きた際にはそれに伴う新しい解釈が実行され、取得結果の変換が必要がなくなるまで繰り返されます。たとえば、以下のようなステートメントがあった場合: ```html @@ -61,7 +61,7 @@ title: 変換タグ ### "." を小数点として使用 -4D は常にピリオド文字 (.) `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 +4D は常にピリオド文字 (.) を小数点として使用して、 `4DTEXT`、`4DHTML`、および `4DEVAL` の 4Dタグで数値表現を評価します。リージョン設定は無視されます。この機能により、4Dの言語設定とバージョンが異なっていてもメンテナンスが容易となり互換性が保たれます。 ## 4DBASE @@ -634,7 +634,7 @@ No name has been found. #### 代替シンタックス: `$4DTEXT(expression)` -タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: +タグ `` を使用して 4D変数や値を返す式への参照を挿入できます。たとえば、(HTMLページ内にて) 以下のように記述すると: ```html

    へようこそ！

    diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/classes.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/classes.md index a8fa417ac13cf7..45c42624fbbc85 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/classes.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/classes.md @@ -213,7 +213,7 @@ title: クラス **.borderHorizontal** : [cs.ViewPro.LineBorder](#lineborder) -`.borderBottom` プロパティは、 表の横の外枠線を定義します 。 +`.borderHorizontal` プロパティは、 表の横の外枠線を定義します 。 ### .borderVertical diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-allowed-methods.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-allowed-methods.md index b3f7839d769622..c4402d1853e2f4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/commands/vp-set-allowed-methods.md @@ -26,7 +26,7 @@ title: VP SET ALLOWED METHODS `VP SET ALLOWED METHODS` コマンドは、4D View Pro フォーミュラから呼び出し可能なプロジェクトメソッドを指定します。このコマンドは、呼び出し後のセッション中に初期化される 4D View Pro エリアすべてに対して適用されます。同じセッション中において異なる設定で初期化をするために、複数回呼び出すこともできます。 -セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照)。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 +セキュリティ上の理由により、 `VP SET ALLOWED METHODS` コマンドを実行していない場合のデフォルトでは、4D View Pro エリアにおいてはメソッドの呼び出しは許可されません (ただし、4D の汎用的な `SET ALLOWED METHODS` コマンドが呼び出されていた場合を除きます (前述の互換性に関する注記参照))。許可されていないのメソッドをフォーミュラ内で使用した場合には、4D View Pro エリアに #NAME? エラーが表示されます。 *methodObj* には、4D View Pro エリア内で定義したいファンクションの名前をプロパティとして格納しているオブジェクトを渡します: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md index 780674543ebafb..0a45a85f46666e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/configuring.md @@ -141,7 +141,7 @@ title: 4D View Pro エリアの設定 | 0 | ゼロを表示する桁のプレースホルダー | #.00 は 1.1 を 1.10 と表示します。 | | 。 | 小数点を表示します | 0.00 は 1999 を 1999.00 と表示します。 | | , | 数値内に千区切りのカンマを表示します。数値記号 "#" あるいはゼロに挟まれたカンマがフォーマットに含まれる場合、3桁ごとにカンマで区切られます。桁のプレースホルダーの後にくるカンマは、数値を 1000 で割ります。 | #,0 は 12200000 を 12,200,000 と表示します。 | -| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | +| \_ | アンダーバーに続く文字の幅をスキップします。 | \_( や _) のようにカッコなどと組み合わせることで、左や右にスペースを追加します。 | | @ | テキストのフォーマット文字。セル内のすべてのテキストにフォーマットを適用します。 | "\[Red]@" はテキスト値に対して赤のフォントカラーを適用します。 | | \* | 列幅いっぱいまで、後に続く文字を繰り返します。 | 0\*- は、数値の後にセルの幅いっぱいまでダッシュを繰り返します。対して、\*0 をフォーマットの前につけると、先頭に 0 が複数表示されます。 | | " " | 引用符にはさまれたテキストを、解釈せずにそのまま表示します。 | "8%" は 8% と表示されます。 | @@ -165,17 +165,17 @@ VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_ 4D View Pro では IS0 8601 の日付と時間パターンを示す以下の定数を提供しています: -| 定数 | 値 | 説明 | -| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | -| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。 アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | -| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | -| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。 アメリカ合衆国でのデフォルトパターン: "MMMM dd" | -| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。 アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | -| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。 アメリカ合衆国でのデフォルトパターン: "HH:mm" | -| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | -| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。 アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | -| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。 アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `vk pattern full date time` | "*fullDateTimePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付と時間。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy HH:mm:ss" | +| `vk pattern long date` | "*longDatePattern*" | カレント言語設定における ISO 8601 フォーマットの完全な日付。アメリカ合衆国でのデフォルトパターン: "dddd, dd MMMM yyyy" | +| `vk pattern long time` | "*longTimePattern*" | カレント言語設定における ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm:ss" | +| `vk pattern month day` | "*monthDayPattern*" | カレント言語設定における ISO 8601 フォーマットの月日の日付。アメリカ合衆国でのデフォルトパターン: "MMMM dd" | +| `vk pattern short date` | "*shortDatePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの日付。アメリカ合衆国でのデフォルトパターン: "MM/dd/yyyy" | +| `vk pattern short time` | "*shortTimePattern*" | カレント言語設定における省略形の ISO 8601 フォーマットの時間。アメリカ合衆国でのデフォルトパターン: "HH:mm" | +| `vk pattern sortable date time` | "*sortableDateTimePattern*" | カレント言語設定における、並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss" | +| `vk pattern universal sortable date time` | "*universalSortableDateTimePattern*" | カレント言語設定における、UTCを使用した並べ替え可能な ISO 8601 フォーマットの日付と時間。アメリカ合衆国でのデフォルトパターン: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'" | +| `vk pattern year month` | "*yearMonthPattern*" | カレント言語設定における ISO 8601 フォーマットの年月。アメリカ合衆国でのデフォルトパターン: "yyyy MMMM" | #### 例題 @@ -339,9 +339,9 @@ VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time"; | firstPageNumber | longint | 最初のページに印刷するページ番号。 デフォルト値 = 1 | | pageOrder | longint | ページの印刷順。とりうる値: `vk print page order auto` (デフォルト), `vk print page order down then over`, `vk print page order over then down`. | | pageRange | text | 印刷されるページの範囲 | -| qualityFactor | longint | 印刷の品質指定 (1 - 8)。印刷の品質指定 (1 - 8)。 高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    デフォルト値 = 2

    | -| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    デフォルト値 = true

    | -| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    デフォルト値 = 1

    | +| qualityFactor | longint | 印刷の品質指定 (1 - 8)。高ければ印刷の質は高くなりますが、印刷のパフォーマンスに影響する可能性があります。

    デフォルト値 = 2

    | +| useMax | boolean | データのあるカラムと行のみが印刷されます。

    デフォルト値 = true

    | +| zoomFactor | real | 印刷ページの拡大/縮小率。

    デフォルト値 = 1

    | ### 用紙サイズ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/formulas.md index cbc2c8054e141f..f8165236c176bf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/formulas.md @@ -217,7 +217,7 @@ $o.DRIVERS_LICENCE.parameters.push(New object("name"; "ID"; "type"; Is longint)) サポートされている引数の型の詳細については、[VP SET CUSTOM FUNCTIONS](commands/vp-set-custom-functions) コマンドの説明を参照ください。 -引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、 それらの型は自動的に変換されます。 +引数を宣言していない場合には、メソッドに値を順番に渡すことができ ($1、$2... に受け取られます)、それらの型は自動的に変換されます。 日付およびオブジェクト引数は次のように扱われます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/getting-started.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/getting-started.md index a69e4f2d3d80b8..294b078eb8028b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/getting-started.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/ViewPro/getting-started.md @@ -8,7 +8,7 @@ title: はじめに ![](../assets/en/ViewPro/vpSpreadsheet.png) スプレッドシートとは、セルのグリッドを格納したアプリケーションのことで、これらのセルに情報を入力したり、計算を実行させたり、あるいはピクチャーを表示したりすることができます。 4D View Proは、4Dに統合された [SpreadJS スプレッドシートソリューション](https://developer.mescius.com/spreadjs) に基づいて動作します。
    -(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します） +(4D View Pro のツールバー等のインターフェースは SpreadJS 提供のものです。インターフェース上で "テーブル" という用語が使用されますが、4D でテーブルといえばデータベーステーブルを指すため、当マニュアルではこれを便宜上 "表組み" あるいは "表" と呼んで区別します) :::note diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/authentication.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/authentication.md index 369bb51bfb17b0..890f58a3e71c75 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/authentication.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/authentication.md @@ -150,7 +150,7 @@ BASICモードと同様に、ユーザーは接続時に自分の名前とパス `$IPClient` 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 #### $IPServer - サーバーIP アドレス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/httpRequests.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/httpRequests.md index 183d69cb36480c..ad1040ed3e324f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/httpRequests.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/httpRequests.md @@ -85,7 +85,7 @@ title: HTTPリクエストの処理 $BrowserIP 引数はブラウザーマシンの IPアドレスを受け取ります。この情報を使用して、イントラネットアクセスとインターネットアクセスを区別できます。 -> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。 たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 +> 4D は IPv4 アドレスを、96-bit の接頭辞付きのハイブリッド型 IPv6/IPv4 フォーマットで返します。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4 アドレスを意味します。詳細については、[IPv6 のサポートについて](webServerConfig.md#IPv6-のサポートについて) の章を参照ください。 ### $ServerIP - サーバーIP アドレス @@ -99,8 +99,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ ## /4DACTION -\*\*/4DACTION/\*\**MethodName*
    -\*\*/4DACTION/\*\**MethodName/Param* +**/4DACTION/***MethodName*
    +**/4DACTION/***MethodName/Param* | 引数 | 型 | | 説明 | | ---------- | ---- | :-: | --------------------- | @@ -111,8 +111,8 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ この URL を使用して、任意の *Param* テキスト引数とともに *MethodName* に指定した 4Dプロジェクトメソッドを呼び出すことができます。メソッドはこの引数を受け取ります。 -- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされていない場合、Webリクエストは拒否されます。 -- `/4DACTION/MyMethod/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 +- 4Dプロジェクトメソッドは、[Webリクエスト用に許可](allowProject.md)されていなければなりません。メソッドのプロパティで "公開オプション: 4DタグとURL(4DACTION...)" 属性がチェックされている必要があります。属性がチェックされていない場合、Webリクエストは拒否されます。 +- `/4DACTION/MethodName/Param` リクエストを受け取ると、4D は `On Web Authentication` データベースメソッド (あれば) を呼び出します。 `4DACTION/` は、スタティックな Webページの URL に割り当てることもできます: @@ -120,7 +120,7 @@ $user と $password 引数は、ブラウザーが表示する標準の認証ダ Do Something ``` -`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND BLOB` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 +`MyMethod` プロジェクトメソッドは通常レスポンスを返すべきです (`WEB SEND FILE` や `WEB SEND TEXT` で HTMLページを送信するなど)。ブラウザーをブロックしないように、処理は可能な限り短時間でおこなわれるようにします。 > `4DACTION/` から呼び出されるメソッドは、インターフェース要素 (`DIALOG`, `ALERT` など) を呼び出してはいけません。 @@ -150,7 +150,7 @@ WEB SEND BLOB($BLOB;"image/png") ### 4DACTION を使用してフォームをポスト -4D Webサーバーでは、ポストされたフォームを使用することもできます。 これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 +4D Webサーバーでは、ポストされたフォームを使用することもできます。これはスタティックなページから Webサーバーにデータを送信し、すべての値を簡単に取得するというものです。 POSTタイプを使用し、フォームのアクションは /4DACTION/MethodName で始まっていなければなりません。 フォームは 2つのメソッドを使用してサブミットできます (4D では両方のタイプを使用できます): diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md index bbae7000e6a429..b5c2e6b958b277 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/sessions.md @@ -3,7 +3,7 @@ id: sessions title: Webセッション --- -4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 +4D Webサーバーは、**Webセッション** を管理するビルトインの機能を提供します。 Webセッションを作成・維持することで、Webアプリケーション上のユーザーエクスペリエンスを管理・向上することができます。 Webセッションが有効化されていると、Webクライアントはリクエスト間で同じコンテキスト (セレクションや変数の値) を再利用できます。 Webセッションでは、以下のことが可能です: @@ -32,13 +32,13 @@ Webセッションは次のものに使用されます: - ストラクチャー設定の Web / オプション (I) ページの **スケーラブルセッション** を使用する (永続的な設定): ![alt-text](../assets/en/WebServer/settingsSession.png) -このオプションは、新規プロジェクトではデフォルトで選択されています。これは、 **セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 +このオプションは、新規プロジェクトではデフォルトで選択されています。これは、**セッションなし** オプションを選択して無効にすることもできます。この場合、Webセッション機能は無効になります (`Session` オブジェクトは使用できません)。 -- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します）。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 +- Webサーバーオブジェクトの [`.scalableSession`](API/WebServerClass.md#scalablesession) プロパティを使用する ([`.start()`](API/WebServerClass.md#start) 関数に *settings* 引数として渡します)。この場合、ストラクチャー設定ダイアログボックスで定義されたオプションよりも、Webサーバーオブジェクトの設定が優先されます (ディスクには保存されません)。 > メインの Webサーバーのセッションモードは、[`WEB SET OPTION`](../commands-legacy/web-set-option.md) コマンドを使って設定することもできます。 -いずれの場合も、設定はマシンに対しローカルなものです。 つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 +いずれの場合も、設定はマシンに対しローカルなものです。つまり、4D Server の Webサーバーと、リモートの 4Dマシンの Webサーバーで異なる設定が可能です。 > **互換性について**: 4D v18 R6 以前の 4Dバージョンで作成されたプロジェクトでは、**旧式セッション** オプションが使用できます (詳細については、[doc.4d.com](https://doc.4d.com) の Webサイトを参照ください)。 @@ -52,13 +52,13 @@ Webセッションは次のものに使用されます: ::: -1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID__AppName_" cookie の存在と値をチェックします。 +1. Webサーバーは、各Webクライアントリクエストにおいて、プライベートな "4DSID_*AppName*" cookie の存在と値をチェックします。 2. cookie に値がある場合、4D は既存セッションの中からこのクッキーを作成したセッションを探し、見つかった場合には再利用します。 3. クライアントからのリクエストが、すでに開かれているセッションに対応していない場合: -- プライベートな "4DSID__AppName_" cookie を持つ新しいセッションが Webサーバー上に作成されます。 +- プライベートな "4DSID_*AppName*" cookie を持つ新しいセッションが Webサーバー上に作成されます。 - 新しいゲスト `Session` オブジェクトが作成され、このスケーラブルWebセッション専用に使用されます。 :::note @@ -476,6 +476,6 @@ Function validateEmail() : 4D.OutgoingMessage セッショントークンにはライフスパン(有効期限)があり、またセッション自身にもライフスパンがあります。セッショントークンのライフスパンは、[トークン作成時](../API/SessionClass.md#createotp) に設定することが可能です。デフォルトで、トークンのライフスパンは[`.idleTimeout`](../API/SessionClass.md#idletimeout) の値と同じ値となっています。 -セッショントークンのライフパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 +セッショントークンのライフスパンと、セッションのライフスパンの両方がどちらも失効していない場合に限り、トークンを使用してセッションを復元することができます。それ以外の場合(セッショントークンが失効している、またはセッション自身が失効している)には、セッショントークンをもったWeb リクエストが受信されたときにゲストセッションが作成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/templates.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/templates.md index a330c809b15b83..1e9e4d1273f352 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/templates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/templates.md @@ -69,14 +69,14 @@ title: テンプレートページ 内部的には、パーサーは UTF-16 文字列で動作しますが、解析するデータは異なる方法でエンコードされている場合があります。タグにテキストが含まれている場合 (`4DHTML` など)、提供されている情報 (charset) や出所に応じて、4D は必要に応じてデータを変換します。以下に、HTMLページに含まれるタグを 4D が解析する場合と、おこなわれる変換を示します: -| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | -| --------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `WEB SEND TEXT` | X | - | 変換は不要です。 | -| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | -| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | +| 動作 / コマンド | 送信ページの解析 | $シンタックスのサポート(\*) | タグ解析に使用される文字セット | +| ---------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| URL で呼び出されたページ | ○、ただし拡張子が ".htm" または ".html" のページを除く | ○、ただし拡張子が ".htm" または ".html" のページを除く | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND FILE` | X | - | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `WEB SEND TEXT` | X | - | 変換は不要です。 | +| `WEB SEND BLOB` | ○ (BLOBが "text/html" 型の場合) | - | レスポンスの "Content-Type" ヘッダーに指定された文字セットを使います。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `` タグによる挿入 | X | X | ページの "Content-Type" ヘッダーのパラメーターに渡された文字セットに従います。それが無い場合は、META-HTTP EQUIVタグを探します。それも無ければ、HTTPサーバーのデフォルト文字セットを使用します。 | +| `PROCESS 4D TAGS` | X | X | テキストデータは変換しません。 BLOBデータは、互換性のために Mac-Roman 文字セットから自動変換されます。 | (\*) 4DHTML、4DTEXT、4DEVALタグにおいては、代替の $ベースシンタックスが利用可能です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md index ead05535cfbb3c..1ecd21cb2aa8cb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WebServer/webServerConfig.md @@ -64,7 +64,7 @@ Webサーバー用の TLS証明書ファイルが置かれているフォルダ | ---------------- | -------------------------------------------------- | ---- | | webServer オブジェクト | [`cipherSuite`](API/WebServerClass.md#ciphersuite) | Text | -セキュアプロトコルに使用される暗号リストです。 Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 +セキュアプロトコルに使用される暗号リストです。Webサーバーが実装する暗号アルゴリズムの優先順位を設定します。コロン区切りの文字列として設定できます (例: "ECDHE-RSA-AES128-...")。詳細は Open SSL サイトの [ciphers ページ](https://www.openssl.org/docs/manmaster/man1/ciphers.html) を参照ください。 > 4D が使用するデフォルトの暗号リストは、`SET DATABASE PARAMETER` コマンドを使用してセッションごとに変更することができます。この場合、変更は 4Dアプリケーション全体に適用されます (Webサーバー・SQLサーバー・クライアント/サーバー接続、HTTPクライアント、セキュアプロトコルを使用するすべての 4Dコマンドを含む)。 @@ -161,7 +161,7 @@ Webサーバーの初回起動時には、4D はデフォルトで "index.html" | `WEB SET OPTION` | `Web CORS enabled` | 0 (デフォルト値; 無効) または 1 (有効) | | 設定ダイアログボックス | [オプション (II) ページ / CORSを有効化](../settings/web.md#corsを有効化) | デフォルトではチェックなし | -4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 +4D Webサーバーは、クロスオリジンリソースシェアリング (CORS) を実装しており、これによって別ドメインにて提供されている特定の Webページが、REST などを使用した XHRコールを介してカレントWebアプリケーションのリソースにアクセスできるようにすることが可能です。セキュリティ上の理由により、"ドメイン間" のリクエストはブラウザーレベルでデフォルトで禁止されています。有効化されている場合、ドメイン外 Webページからの XHRコール (RESTリクエストなど) をアプリケーションにおいて許可することができます (CORSドメインリストに許可されたアドレスのリストを定義する必要があります。後述の CORSSettings 参照)。有効時に、許可されていないドメインやメソッドがサイト間リクエストを送信した場合、"403 - forbidden" エラーレスポンスによって拒否されます。 無効化されている場合 (デフォルト) には、CORS で送信されたサイト間リクエストはすべて無視されます。 @@ -255,7 +255,7 @@ HTTP接続を受け付ける IP (TCP) ポート番号。デフォルトで、4D デフォルトでない HTTPポート番号を使用して公開された Webアプリケーションに接続するには、Webブラウザーで入力するアドレスにポート番号を含めなければなりません。アドレスの後にコロンに続けてポート番号を指定します。たとえば、HTTPポート番号 8080を使用する場合、"123.4.567.89:8080" のように書きます。 -> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。 また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 +> **警告**: デフォルトの TCPポート番号 (標準モードで 80、HTTPSモードで 443) 以外を指定する場合、同時に使用する他のサービスのデフォルトポート番号を使わないよう注意が必要です。たとえば、Webサーバーマシンで FTPプロトコルを使用する計画である場合、このプロトコルのデフォルトである TCPポート 20 と 21 を使用してはいけません。 256 より下のポート番号は、well-known サービスに予約されています。また、256 から 1024 は UNIXプラットフォーム由来のサービスに予約されています。セキュリティのため、これらの数値よりも上、たとえば 2000台や 3000台などを指定します。 0 を指定すると、4D はデフォルトの HTTPポート番号 80を使用します。 @@ -320,7 +320,7 @@ TLS を介した HTTPS接続を受け付ける IPポート番号。デフォル - **TCPポートが使用済みでも警告は出ません**
    サーバーが応答する IPアドレスが "任意" に設定されていた場合、TCPポートが他のアプリケーションで使用されていても、それはサーバー起動時に指摘されません。 IPv6 アドレスのポートが空いているため、この場合 4D Server はどのようなエラーも検知しません。しかしながら、マシンの IPv4アドレスを使用、またはローカルアドレス 127.0.0.1 を使用してアクセスすることは不可能です。 -定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。 他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 +定義されたポートで 4D Server が反応していないようであれば、サーバーマシンで [::1] のアドレスを試してみてください (IPv6 における 127.0.0.1 と同義です。他のポート番号をテストするには [:portNum] を追加してください)。 4D が応答するようであれば、IPv4 のポートを他のアプリケーションが使用している可能性が高いです。 - **IPv4-マップされた IPv6アドレス**
    プロセスを標準化するために、4D では IPv4アドレスの標準ハイブリッド表示を IPv6 で提供しています。これらのアドレスは IPv6フォーマットにおいて 96ビットの接頭辞付きで書かれ、その後に IPv4ドット区切り表記で書かれた 32ビットが続きます。たとえば、::ffff:192.168.2.34 は、192.168.2.34 という IPv4アドレスを表します。 @@ -456,9 +456,9 @@ Webサーバーの PFS利用可否状況 ([TLS](Admin/tls.md#perfect-forward-sec ## 一時的なコンテキストを再利用する (リモートモード) -| 設定できる場所 | 名称 | コメント | -| ----------- | --------------------------------------------------------------------------------------------------------------------- | ---- | -| 設定ダイアログボックス | [[オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | +| 設定できる場所 | 名称 | コメント | +| ----------- | ------------------------------------------------------------------------------------------ | ---- | +| 設定ダイアログボックス | [オプション (I) ページ / 一時的なコンテキストを再利用する](../settings/web.md#一時的なコンテキストを再利用する) | | > このオプションは、**セッションなし** オプションがチェックされている場合にのみ利用できます。 @@ -524,9 +524,9 @@ User-Agent: デフォルトHTMLルートフォルダーを変更するには、パスを "デフォルトHTMLルート" に入力します。 -- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアーパッケージを含むフォルダーです (4Dリモートモード)。 +- このとき、相対パスの起点は [Projectフォルダー](Project/architecture.md#project-folder) (4Dローカルおよび 4D Server) 、または、4Dアプリケーションやソフトウェアパッケージを含むフォルダーです (4Dリモートモード)。 - パスは POSIX シンタックスで表します (フォルダーはスラッシュ ("/") で区切ります)。 -- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。置きます。 +- フォルダー階層で 1つ上にあがるには、フォルダー名の前にピリオドを2つ “..” 置きます。 - パスはスラッシュ (“/”) で始まってはいけません (HTMLルートフォルダーを Projectフォルダーや 4Dリモートフォルダーにしながら、それより上階層へのアクセスを禁止したい場合には、"/" を入力します)。 たとえば、HTMLルートフォルダーを "MyWebApp" フォルダーの “Web” サブフォルダーにしたい場合、"MyWebApp/Web" と入力します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md index e4fe3536b468ec..893e001b94bea6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/WritePro/managing-formulas.md @@ -6,7 +6,7 @@ slug: /WritePro/formulas ## 概要 -4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは4D コマンドなどの4D フォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 +4D Write Pro ドキュメントには、変数、フィールド、式、プロジェクトメソッドあるいは 4Dコマンドなどの 4Dフォーミュラへの参照を含めることができます。ページ番号などの特定の情報もフォーミュラを通して参照することができます(以下参照)。 4D Write Pro エリアへのフォーミュラの挿入には [**WP Insert formula**](commands/wp-insert-formula.md) コマンドを使用し、フォーミュラの読み出しには[**WP Get formulas**](commands-legacy/wp-get-formulas.md) コマンドを使用します。また、[**WP Get text**](commands-legacy/wp-get-text.md) コマンドを使用することでも返されます。 @@ -207,7 +207,7 @@ slug: /WritePro/formulas ### 参照を名前で表示 -フォーミュラには名前を割り当てることができ、これによって4D Write Proテンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 +フォーミュラには名前を割り当てることができ、これによって4D Write Pro テンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。 例えば、以下のフォーミュラ参照はデフォルトではソーステキストとして表示されます: @@ -217,7 +217,7 @@ slug: /WritePro/formulas ![](../assets/en/WritePro/wp-formulas6.png) -フォーミュラに名前を割り当てるためには、 [WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: +フォーミュラに名前を割り当てるためには、[WP Insert formula](commands/wp-insert-formula.md) コマンドにオブジェクト型の引数を渡す必要があります。例: ```4d // ドキュメント内に昨日の日付を挿入する diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md index afb23bcb930605..5a30faa1791b01 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/aikit/Classes/OpenAIChatAPI.md @@ -22,7 +22,7 @@ title: OpenAIChatAPI | 引数 | 型 | 説明 | | -------------- | --------------------------------------- | ------------------------- | -| *systemPrompt* | Text | チャットを初期化するシステムプロント。 | +| *systemPrompt* | Text | チャットを初期化するシステムプロンプト。 | | 戻り値 | [OpenAIChatHelper](OpenAIChatHelper.md) | チャットのやり取りを管理するヘルパーインスタンス。 | #### 使用例 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/code-editor/write-class-method.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/code-editor/write-class-method.md index d056144e12f264..c13887b9b2ac0f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/code-editor/write-class-method.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/code-editor/write-class-method.md @@ -29,16 +29,16 @@ title: コードエディター | -------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **メソッド実行** | ![execute-method](../assets/en/code-editor/execute-method.png) | コードエディターウィンドウには、そのエディターで開かれているメソッドを実行するためのボタンがあります。このボタンに割り当てられているメニューを使用して、実行タイプを選択できます:
    • **新規プロセスで実行**: プロセスを作成し、そのプロセス内でメソッドを実行します。
    • **新規プロセスで実行＆デバッグ**: プロセスを作成し、デバッガーを開いてメソッドを表示します。
    • **アプリケーションプロセスで実行**: アプリケーションプロセス内でメソッドを実行します。
    • **アプリケーションプロセスで実行＆デバッグ**: アプリケーションプロセス内でデバッガーを開き、メソッドを表示します。
    メソッド実行に関するより詳細な情報については、[プロジェクトメソッドの呼び出し](../Concepts/methods.md#プロジェクトメソッドの呼び出し)を参照して下さい。 | | **メソッド中を検索** | ![search-icon](../assets/en/code-editor/search.png) | [*検索* エリア](#検索と置換) を表示します。 | -| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についの詳細は、 [マクロ](#マクロ) を参照ください。 | +| **マクロ** | ![macros-button](../assets/en/code-editor/macros.png) | 選択対象にマクロを挿入します。ドロップダウンの矢印をクリックすると、利用可能なマクロがすべて表示されます。マクロの作成とインスタンス化についての詳細は、[マクロ](#マクロ) を参照ください。 | | **すべて折りたたむ / すべて展開** | ![expand-collapse-button](../assets/en/code-editor/expand-collapse-all.png) | これらのボタンを使用してコードの制御フロー構造を折りたたんだり展開したりできます。 | -| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します(プロジェクトモードのみ)。 | +| **メソッド情報** | ![method-information-icon](../assets/en/code-editor/method-information.png) | [メソッドプロパティ](../Project/project-method-properties.md) ダイアログボックスを表示します (プロジェクトメソッドのみ)。 | | **最新のクリップボードの値** | ![last-clipboard-values-icon](../assets/en/code-editor/last-clipboard-values.png) | 直近でクリップボードに保存された値を表示します。 | -| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、 [これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | +| **クリップボード** | ![clipboard icons](../assets/en/code-editor/clipboards.png) | コードエディターで利用可能な 9つのクリップボードです。クリップボードのアイコンをクリックするか、あるいはキーボードショートカットによって、[これらのクリップボードを利用](#クリップボード) できます。[環境設定オプション](Preferences/methods.md#options-1) を使用するとそれらを非表示にすることができます。 | | **ナビゲーションドロップダウン** | ![code-navigation-icons](../assets/en/code-editor/tags.png) | 自動的にタグ付けされたコンテンツや手動で宣言されたマーカーを使用して、メソッドやクラス内を移動できます。後述参照。 | ### 編集エリア -このエリアを使用してコードを 入力/編集 します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 +このエリアを使用してコードを入力/編集します。エディターは、コードテキストのインデントを自動で設定し、異なるシンタックス要素ごとに色を付けて、コード構造を明確に表示します。 この編集エリアの表示はカスタマイズできます。カスタマイズした内容は、すべてのコードエディターに反映されます: @@ -74,10 +74,10 @@ title: コードエディター ![](../assets/en/code-editor/list-area.png) -- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示\非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 +- リストを追加/削除するには、リストのタイトルエリアをクリックし、一番下の対応するメニューを選択します。**このリストを取り除く** コマンドは、リストが残り1つのときは無効になります。すべてのリストを非表示にするには、ウィンドウ右下の **リストを表示/非表示** ボタンをクリックするか、**環境設定** でデフォルトで非表示にする必要があります。 - すべてのウィンドウでリストを非表示にするには、次の方法があります: - - メソッド メニューの **表示** ＞ **リスト** オプションの選択を解除する + - **メソッド**メニューの **表示** ＞ **リスト** オプションの選択を解除する - **環境設定** の **メソッド** ページで **オプション** ＞ **リスト表示** の選択を解除する。**環境設定** ダイアログボックスでおこなった変更は、開かれているメソッドやクラス、関数を一度閉じて再度開いたときに反映されます。 #### リストのタイプ @@ -141,9 +141,9 @@ title: コードエディター - **行**: 行番号 - **階層**: 階層番号 (プログラム構造の階層レベル)。先頭のレベルは 0 です。この数値は、コード中でエラーが発生した際にインタープリターから提供されるのでデバッグ時に利用できます。 - **文字**: 行内の文字位置。 -- ![](../assets/en/code-editor/show-hide-list.png): Hide/display lists. +- ![](../assets/en/code-editor/show-hide-list.png): リストの表示/非表示。 -4Dコマンド、関数や変数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: +4Dコマンド、関数や引数にカーソルを置くと、ステータスバーにコマンドのシンタックスが表示されます。引数を入力したり選択したりすると、そのエリアには現在の引数が **太字** で表示されます: ![](../assets/en/code-editor/status-bar-bold.png) ### ナビゲーションドロップダウン @@ -208,7 +208,7 @@ title: コードエディター メソッドやクラスのタグをアルファベット順に表示するには、次のいずれかを実行します: - ドロップダウンツールを **右クリックする** -- macOS では **option**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 +- macOS では **Cmd**、Windows では **Alt** を押しながら、ドロップダウンツールをクリックします。 > 関数内のタグは、親項目と一緒に移動します。 @@ -224,7 +224,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | **ショートカット** | **アクション** | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -| **選択およびナビゲージョン** | | +| **選択およびナビゲーション** | | | ダブルクリック | ランゲージ要素名を選択します。 | | [Alt]+ダブルクリック | スペースを含むランゲージ要素名 (定数、メソッドなど) を選択します。 | | [Shift]+[右矢印] | 選択範囲を作成し、一文字ずつ右に拡大します。 または、選択範囲を一文字ずつ左から縮小します。 | @@ -247,7 +247,7 @@ macOSでは **Ctrl** の代わりに **Command** を使用してください。 | [PgDn] | メソッドをページ単位で下にスクロールします (挿入カーソル位置は変更されません)。 | | [**イントロスペクション**](#定義を開く) | | | [Ctrl]+K または [Alt]+ダブルクリック | [**定義を開く**](#定義を開く) コマンドと同じ。 | -| トークン上で \[Ctrl\] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | +| トークン上で [Ctrl] (Windows) または [Alt] を押しながらマウスオーバー | トークン (認識されたランゲージ要素) に下線を引きます。下線が引かれたトークンをクリック = [**定義を開く**](#定義を開く) コマンドと同じ。 | | [**検索と置換**](#検索と置換) | | | [Ctrl]+F | 検索 | | [Ctrl]+G | 次を検索 | @@ -356,7 +356,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method > **環境設定** の **メソッド** ページで、**() と閉じる } ) ] " を自動で挿入** オプションをチェックしている場合、4D はひとつ以上の必須の引数を持つ4D コマンド、キーワード、プロジェクトメソッドの後ろに (提案、あるいは補完を受け入れたあとに) 自動的に **()** を追加します: > ![](../assets/en/code-editor/insert-and-closing-1.png) -> ![](../assets/en/code-editor/insert-and-closing-2.png) -例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: +自動補完機能は、コード構造 (例: If..End if, For each...End for each) などにも使用できます: 構造の最初の部分を入力し始めると、コードエディターは自動的に終わりの部分を提示します: ![](../assets/en/code-editor/autocomplete-code-structures.png) 複数の候補がある場合、**Tab** キーを押すと 4D はそのポップアップリストを表示します: @@ -367,7 +367,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method デフォルトでは、値を選択したあとに区切り文字 `( ; : = < [ {` を入力すると、自動で値の候補も (区切り文字の前に) 挿入されます。 値のあとには区切り文字がつき、データの入力の準備ができた状態になります。 -![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** key --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) +![](../assets/en/code-editor/autocomplete-delimiter.png) + **(** キー --> ![](../assets/en/code-editor/autocomplete-delimiter-2.png) > この区切り文字を使った候補の自動入力は、**環境設定** の **メソッド** ＞ **オプション** で無効にできます。 @@ -446,7 +446,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ### 置換 -*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ \*\* 置換...\*\* を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 +*検索* エリアの左にある **v** トグルボタンをクリックすると、*置換* エリアの表示/非表示を切り替えることができます。**編集** メニューで **検索** ＞ **置換...** を選択するか、**Ctrl+Alt+F** (Windows) / **Cmd+Alt+F** (macOS) のショートカットも使用できます。 *置換* エリアには、上の検索エリアの文字を置換する文字列を入力します。 @@ -524,11 +524,9 @@ Windows では、日本語や中国語を入力するために IME (Input Method - **4D コマンドドキュメンテーション**: 4D のコマンドや関数にマウスを重ねると、コマンドシンタックスと簡単な説明がヘルプTip に表示されます。 ![](../assets/en/code-editor/status-bar-description.png) - ![](../assets/en/code-editor/status-bar-description.png) - **変数型と詳細**: 変数にマウスを重ねると、その変数の型と (メソッド内で明示的に宣言されている場合)、付随したコメントが (あれば) ヘルプTip に表示されます。 ![](../assets/en/code-editor/variable-type.png) - ![](../assets/en/code-editor/variable-type.png) - **プロジェクトメソッドまたは関数**: プロジェクトメソッドまたはクラス関数にマウスを重ねると、以下の内容がヘルプTip に表示されます: @@ -550,7 +548,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ![](../assets/en/code-editor/comment-uncomment-1.png) --> ![](../assets/en/code-editor/comment-uncomment-2.png) -選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。 この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 +選択行がアクティブなコードの場合、**コメント** コマンドが適用されます。選択行にアクティブコードとコメントの両方が含まれる場合、すべての行に "//" が追加されます。この動作により、複数回コマンドを適用しても、その後のアンコメント時に初期のコメントが維持されます。選択行がすべてコメントのみの場合、**アンコメント** コマンドが適用されます。 > **コメント/アンコメント** コマンドは行全体に適用されます。行の一部のみをコメント化することはできません。 @@ -650,7 +648,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method ::: -**定義を開く.....** コマンドの効果は、ターゲット要素によって異なります: +**定義を開く...** コマンドの効果は、ターゲット要素によって異なります: - プロジェクトメソッドの場合、コードエディターの新しいウィンドウ内にメソッドのコンテンツが表示されます。 - クラス名またはクラス関数の場合、コードエディター内にクラスが表示されます。 @@ -698,7 +696,7 @@ Windows では、日本語や中国語を入力するために IME (Input Method - マシンのアクティブ4Dフォルダー。この場合、マクロはすべてのデータベースで共有されます。**注:** アクティブ4Dフォルダーの位置は OS により異なります。詳細については、*4Dランゲージリファレンス* マニュアルの [Get 4D folder](../commands-legacy/get-4d-folder.md) コマンドの説明を参照ください。 - データベースストラクチャーファイルと同階層。マクロは、このストラクチャーにのみ読み込まれます。 -- コンポーネントの場合: データベースの **Components** フォルダーと同階層。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 +- コンポーネントの場合: データベースの **Components** フォルダーの中。この場合マクロは、コンポーネントがインストールされている場合のみ利用できます。 これら 3つの場所は同時に利用可能です。 各場所に "Macros v2" フォルダーをインストールできます。マクロは以下の順番でロードされます: 4Dフォルダー、ストラクチャーファイル、コンポーネント1 ... コンポーネントX。 @@ -830,7 +828,7 @@ XML仕様に準拠し、いくつかのタグは属性を含むことがあり マクロのサポートは 4Dのバージョンごとに変わることがあります。カスタマイズされたマクロを管理しつつ、異なるバージョンの互換性を保持するために、4Dは以前のバージョンのマクロを取り除くことはしません。最新機能を使用したい場合は、適切にバージョンを調整する必要があります。 -#### method の選択テキスト変数 +#### メソッドのテキスト選択変数 テキスト選択は、[GET MACRO PARAMETER](../commands-legacy/get-macro-parameter.md) および [SET MACRO PARAMETER](../commands-legacy/set-macro-parameter.md) コマンドを使用して管理することが推奨されています。これらのコマンドを使用すると、ホストプロジェクトとコンポーネント間でテキストを相互に交換することができ、マクロの管理専用のコンポーネントを作成することができます。マクロでこのモードを有効にするには、macro 要素内で version 属性に値 2 を指定しなければなりません。この場合、4D は旧式の _textSel, _textReplace 等の定義済み変数を管理しなくなり、[GET MACRO PARAMETER](../commands-legacy/get-macro-parameter.md) と [SET MACRO PARAMETER](../commands-legacy/set-macro-parameter.md) が使用されます。属性は以下のように定義します: