METHOD Get path
METHOD Get path ( tipoMetodo {; aTabela}{; nomObjeto{; nomObjetoForm}}{; *} ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tipoMetodo | Inteiro longo | 🡒 | Seletor de tipo objeto |
| aTabela | Tabela | 🡒 | Referência de tabela |
| nomObjeto | Texto | 🡒 | Nome de formulário ou método base |
| nomObjetoForm | Texto | 🡘 | Nome do objeto de formulário |
| * | Operador | 🡒 | Se passado = o comando se aplica à base local quando se executa desde um componente (parâmetro ignorado fora deste contexto) |
| Resultado | Texto | 🡐 | Rota de acesso completa do objeto |
Descrição
O comando METHOD Get path devolve a rota de acesso interna completa de um método.
Passe em tipoMetodo, o tipo de método cuja rota quer obter. Pode utilizar as seguintes constantes, do tema Design Object Access:
| Constante | Tipo | Valor | Comentário |
|---|---|---|---|
| Path database method | Inteiro longo | 2 | Rota de métodos de banco de dados especificados. Lista desses métodos: [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 |
| Path project form | Inteiro longo | 4 | Rota dos métodos formulário projeto e de todos seus métodos objeto. Exemplos: [projectForm]/myForm/{formMethod} [projectForm]/myForm/button1 [projectForm]/myForm/mylist [projectForm]/myForm/button1 |
| Path project method | Inteiro longo | 1 | Nome do método. Exemplo: MeuMétodoProjeto |
| Path table form | Inteiro longo | 16 | Rota dos métodos formulário tabela e de todos seus métodos objeto. Exemplos: [tableForm]/table_1/Form1/{formMethod} [tableForm]/table_1/Form1/button1 [tableForm]/table_1/Form1/mylist [tableForm]/table_2/Form1/mylist |
| Path trigger | Inteiro longo | 8 | Rota dos triggers da base. Exemplos: [trigger]/tabela_1 [trigger]/tabela_2 |
Passe os valores nos parâmetros aTabela, nomObjeto e nomObjetoForm em função do tipo de objeto o qual quer obter a rota de acesso do método:
| Tipo de objeto | aTabela | nomObjeto | nomObjetoForm |
|---|---|---|---|
| Rota Formulário projeto | X | X (opcional) | |
| Rota Formulário tabela | X | X | X (opcional) |
| Rota Método base | X | ||
| Rota Método projeto | X | ||
| Rota Trigger | X |
Nota: O comando não checa se o objeto design alvo realmente existe no banco de dados (exceto se um nome de método de database inválido for passado, em cujo caso um erro é gerado)
Se o comando for executado desde um componente, retorna como padrão as rotas dos métodos de componente. Se passar o parâmetro *, o array contém as rotas dos métodos da database host..
Exemplo
//Recuperar a rota de acesso do método base "On Startup":
$path:=METHOD Get path(Path database method;"onStartup")
//Recuperar a rota de acesso do trigger da tabela [Empregados]:
$path:=METHOD Get path(Path trigger;[Empregados])
//Recuperar a rota de acesso do método do objeto "OK" do formulário "input" da tabela [Empregados]:
$path:=METHOD Get path(Path table form;[Empregados];"input";"OK")