Comandos del tema Acceso objetos diseño

4D v20.6

4D permite acceder por programación al contenido de los métodos de sus aplicaciones. Este source toolkit facilita la integración de sus aplicaciones a las herramientas de control de código, en particular las aplicaciones de gestión de versiones (VCS). También le permite implementar sistemas avanzados de documentación del código, construir un explorador personalizado u organizar copias de seguridad programadas del código en forma de archivos de disco.

Los principios siguientes aplican:

Cada método y formulario de una aplicación 4D tiene su propia dirección en forma de ruta de acceso. Por ejemplo, el método trigger de la tabla 1 es accesible en la dirección "[trigger]/table_1". Cada ruta de acceso de objeto es única en una aplicación.
Nota: para garantizar la unicidad de las rutas de acceso, 4D no permite crear objetos con el mismo nombre en páginas formularios diferentes. En bases de datos convertidas de versiones anteriores a 4D v13, el CSM detecta los nombres duplicados.

Puede acceder a los objetos de la aplicación 4D utilizando los comandos de este tema, por ejemplo METHOD GET NAMES o METHOD GET PATHS.
La mayoría de los comandos en este tema funcionan en modo interpretado y en modo compilado. Sin embargo, los comandos que modifican las propiedades o acceden al contenido ejecutable de los métodos sólo pueden utilizarse en modo interpretado (ver la tabla abajo).

Puede utilizar todos los comandos de este tema con 4D en modo local o remoto. Sin embargo, recuerde que no puede utilizar ciertos comandos en modo compilado: su propósito es crear herramientas personalizadas de ayuda de desarrollo. No debe utilizarlos para modificar dinámicamente el funcionamiento de una base en ejecución. Por ejemplo, no puede utilizar METHOD SET ATTRIBUTE para cambiar un atributo de método en función del estado del usuario actual.

Cuando un comando de este tema se ejecuta desde un componente, accede por defecto a los objetos del componente. En este caso, para acceder a los objetos de la base local, pase * como último parámetro. Note que en este contexto, esta sintaxis sólo es posible para los comandos que modifican objetos (tales como METHOD SET ATTRIBUTE), ya que los componentes siempre se ejecutan en modo sólo lectura.

Path syntax

Here is the syntax of paths to different methods and forms in the 4D application:

Path	Description
class	Path of class definition. Example: [class]/MyClass
class function	Path of class function. Example: [class]/MyClass/myFunction
database method	Path of database methods specified. List of these methods: [databaseMethod]/onStartup [databaseMethod]/onExit [databaseMethod]/onDrop [databaseMethod]/onBackupStartup [databaseMethod]/onBackupShutdown [databaseMethod]/onWebConnection [databaseMethod]/onWebAuthentication [databaseMethod]/onWebSessionSuspend [databaseMethod]/onServerStartup [databaseMethod]/onServerShutdown [databaseMethod]/onServerOpenConnection [databaseMethod]/onServerCloseConnection [databaseMethod]/onSystemEvent [databaseMethod]/onSqlAuthentication [databaseMethod]/onHostDatabaseEvent [databaseMethod]/onRESTAuthentication [databaseMethod]/onMobileAppAuthentication [databaseMethod]/onMobileAppAction
project form	Path of project form methods and all their object methods. Examples: [projectForm]/myForm/{formMethod} [projectForm]/myForm/button1 [projectForm]/myForm/my list [projectForm]/myForm/button1
project method	Name of method. Example: MyProjectMethod
table form	Path of table form methods and all their object methods. Examples: [tableForm]/table_1/Form1/{formMethod} [tableForm]/table_1/Form1/button1 [tableForm]/table_1/Form1/my list [tableForm]/table_2/Form1/my list
trigger	Path of database triggers. Examples: [trigger]/table_1 [trigger]/table_2

Creación de rutas de acceso

Por defecto, ningún archivo es creado en el disco por 4D. Sin embargo, las rutas de acceso generadas para los objetos son compatibles con la gestión de archivos del sistema operativo, ya que pueden ser utilizadas directamente para generar archivos en disco vía sus propios métodos de importación/exportación.

Más específicamente, los caracteres prohibidos tales como ":" están codificados en los nombres de los métodos. Los archivos generados se pueden integrar automáticamente a un sistema de control de versiones.
Estos son los caracteres codificados:

Carácter	Codificación
"	%22
*	%2A
/	%2F
:	%3A
<	%3C
>	%3E
?	%3F
\|	%7C
\	%5C
%	%25

Ejemplos:
Form?1 es codificado Form%3F1
Button/1 es codificado Button%2F1

Uso en modo compilado

Por razones relacionadas con el mismo principio de procesos de compilación, sólo ciertos comandos de este tema son utilizables en modo compilado. La siguiente tabla indica la disponibilidad de los comandos en modo compilado:

Comando	Puede utilizarse en modo compilado
Current method path	Sí
FORM EDIT	No (*)
FORM GET NAMES	Sí
METHOD Get attribute	Sí
METHOD GET ATTRIBUTES	Sí
METHOD GET CODE	No (*)
METHOD GET COMMENTS	Sí
METHOD GET FOLDERS	Sí
METHOD GET MODIFICATION DATE	Sí
METHOD GET NAMES	Sí
METHOD Get path	Sí
METHOD GET PATHS	Sí
METHOD GET PATHS FORM	Sí
METHOD OPEN PATH	No (*)
METHOD RESOLVE PATH	Sí
METHOD SET ACCESS MODE	Sí
METHOD SET ATTRIBUTE	No (*)
METHOD SET ATTRIBUTES	No (*)
METHOD SET CODE	No (*)
METHOD SET COMMENTS	No (*)

(*) El error -9762 "The command cannot be executed in a compiled database." se genera cuando el comando se ejecuta en modo compilado.