4D v14.3

Design Object Access Commands

Página Inicial

 
4D v14.3
Design Object Access Commands

Design Object Access Commands  


 

 

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.

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:

ComandoPode ser utilizado em modo compilado
Current method pathSim
FORM GET NAMESSim
METHOD SET ATTRIBUTENão (*)
METHOD SET CODENão (*)
METHOD SET COMMENTSNão (*)
METHOD SET ACCESS MODESim
METHOD Get attributeSim
METHOD Get pathSim
METHOD GET PATHSSim
METHOD GET PATHS FORMSim
METHOD GET CODENão (*)
METHOD GET COMMENTSSim
METHOD GET MODIFICATION DATESim
METHOD GET FOLDERSSim
METHOD GET NAMESSim
METHOD OPEN PATHNão (*)
METHOD RESOLVE PATHSim

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

Por defeito, 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.

Más 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:

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

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

 
PROPRIEDADES 

Produto: 4D
Tema: Accesso aos Objetos de Design

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)