Design Object Access Commands

4D v20.1

4D permite o acesso por programação ao conteúdo dos métodos de suas aplicações. Esse source toolkit facilita a integração de seus aplicativos para as ferramentas do código de controle, em especial gestão de aplicações de versões (VCS). Ele também permite que você implante sistemas de documentação de código avançado, compilar um personalizado navegador ou organizar backups agendados do código sob a forma de arquivos no disco.

Os princípios seguintes aplicam:

Cada método e formulário de uma aplicação 4D têm sua própria direção em forma de endereço de acesso. Por exemplo, o método trigger da tabela 1 é acessível na direção "[trigger]/table_1". Cada endereço de acesso de objeto é único em uma aplicação.
Nota: para garantir a unicidade dos endereços de acesso, 4D não permite criar objetos com o mesmo nome nas diferentes páginas formulário. Em bases de dados convertidas de versões anteriores a 4D v13, o CSM detecta os nomes duplicados.

Pode acessar aos objetos da aplicação 4D utilizando os comandos de este tema, por exemplo METHOD GET NAMES ou METHOD GET PATHS.
A maioria dos comandos neste tema funcionam em modo interpretado e em modo compilado. No entanto, os comandos que modificam as propriedades ou acessam ao conteúdo executado dos métodos só podem ser utilizados em modo interpretado (ver a tabela abaixo).

Você pode usar todos os comandos deste tema com 4D em modo local ou remoto. No entanto, lembre-se que não pode usar certos comandos em modo compilado: seu objetivo é criar ferramentas personalizadas de ajuda ao desenvolvimento. Você não deve usá-los para modificar dinamicamente o funcionamento de uma base em execução. Por exemplo, não pode usar METHOD SET ATTRIBUTE para alterar um atributo do método baseado no estado do usuário atual.

Quando um comando deste tema é executado desde um componente, é acessado por padrão aos objetos do componente. Neste caso, para acessar aos objetos de base locais, passe * como o último parâmetro. Observe que neste contexto, esta sintaxe só é possível para os comandos que modificam objetos (tais como METHOD SET ATTRIBUTE), já que os componentes sempre são executados no modo somente leitura.

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

Criação de vias de acesso

Por padrão, nenhum arquivo é criado no disco por 4D. No entanto, os caminhos de acesso gerados para os objetos são compatíveis com a gestão de arquivos do sistema operativo, como podem ser utilizadas diretamente para gerar arquivos em disco através de seus próprios métodos de importação/exportação.

Mais especificamente, os caracteres proibidos tais como ":" estão codificados nos nomes dos métodos. Os arquivos gerados podem ser integrados automaticamente a um sistema de controle de versões.
Estes são os caracteres codificados:

Caractere	Codificação
"	%22
*	%2A
/	%2F
:	%3A
<	%3C
>	%3E
?	%3F
\|	%7C
\	%5C
%	%25

Exemplos:
Form?1 é codificado Form%3F1
Button/1 é codificado Button%2F1

Uso em modo compilado

Por razões relacionadas com o mesmo princípio de processos de compilação, somente certos comandos deste tema são utilizados em modo compilado. A seguinte tabela indica a disponibilidade dos comandos em modo compilado:

Comando	Pode ser utilizado em modo compilado
Current method path	Sim
FORM EDIT	Não (*)
FORM GET NAMES	Sim
METHOD Get attribute	Sim
METHOD GET ATTRIBUTES	Sim
METHOD GET CODE	Não (*)
METHOD GET COMMENTS	Sim
METHOD GET FOLDERS	Sim
METHOD GET MODIFICATION DATE	Sim
METHOD GET NAMES	Sim
METHOD Get path	Sim
METHOD GET PATHS	Sim
METHOD GET PATHS FORM	Sim
METHOD OPEN PATH	Não (*)
METHOD RESOLVE PATH	Sim
METHOD SET ACCESS MODE	Sim
FORM GET NAMES	Sim
METHOD Get attribute	Sim
METHOD GET ATTRIBUTES	Sim
METHOD GET CODE	Não (*)
METHOD GET COMMENTS	Sim
METHOD GET FOLDERS	Sim
METHOD GET MODIFICATION DATE	Sim
METHOD GET NAMES	Sim
METHOD Get path	Sim
METHOD GET PATHS	Sim
METHOD GET PATHS FORM	Sim
METHOD OPEN PATH	Não (*)
METHOD RESOLVE PATH	Sim
METHOD SET ACCESS MODE	Sim
METHOD SET ATTRIBUTE	Não (*)
METHOD SET ATTRIBUTES	Não (*)
METHOD SET CODE	Não (*)
METHOD SET COMMENTS	Não (*)

(*) O erro -9762 "The command cannot be executed in a compiled database." é gerado quando o comando se executa em modo compilado.