Interface da linha de comando

4D v18

Pode utilizar o Terminal de Mac OS X ou a consola de Windows para manipular suas aplicações 4D (4D e 4D Server) por linhas de comando. Mais especificamente, esta funcionalidade lhe permite:

abrir um banco de dados remotamente, o que pode ser particularmente útil para os administradores de servidores web
rodar testes automáticos para suas aplicações

Informação básica

Pode executar as linhas de comando relativas as aplicações 4D utilizando o Terminal Mac OS ou a consola de Windows.

Em macOS, deve utilizar o comando open.
Em Windows, pode passar os argumentos diretamente.

Nota: Em macOS, pode passar diretamente os argumentos acessando a pasta onde se encontra a aplicação no interior do pacote (rota Contents/MacOS) que permite direcionar o stream stderr. Por exemplo, se o pacote 4D se encontra na pasta MinhaPasta, deve escrever a linha de comandos da seguinte maneira: /MyFolder/4D.app/Contents/MacOS/4D &. No entanto, lhe recomendamos que utilize o comando open sempre que não precise acessar o stream stderr.

Comandos e argumentos

Esta é uma descrição de linhas de comandos e de seus argumentos que são suportados pelas aplicações 4D:

Sintaxe

<applicationPath> [--structure] [<structurePath | packagePath | 4dlinkPath> [--data <dataPath>]] [--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>][--headless]

Argumento	Valor	Descrição
applicationPath	Rota da aplicação 4D ou servidor 4D	Lança a aplicação. Mesma coisa que um duplo clique na aplicação 4D. Quando chamada sem argumento de arquivo de estrutura, a aplicação é executada e a caixa de diálogo de banco de dados selecionado aparece.
--estrutura	structurePath \| packagePath \| 4dlinkPath	Arquivo de estrutura para abrir com o arquivo atual de dados. A caixa de diálogo não aparece.
--dados	dataPath	Arquivos de dados para abrir com o arquivo de estrutura designado. Se não for especificado, 4D usa o último arquivo de dados aberto.
--modo de abertura	interpreted \| compilado	Pede que o banco de dados abra em modo interpretado ou compilado. Nenhum erro é mostrado se o modo pedido não estiver disponível.
--create-data		Cria automaticamente um novo arquivo de dados se nenhum arquivo válido de dados não for encontrado. Nenhuma caixa de diálogo vai aparecer. 4D usa o nome de arquivo passado no argumento "--data" se houver (gera um erro se um arquivo com o mesmo nome já existir).
--parâmetro de usuário	String de usuário personalizado	Qualquer string que estiver disponível dentro da aplicação 4D através do comando Get database parameter (a string não deve começar pelo caractere "-", que está reservado).
--headless		Inicia 4D, 4D Server ou a aplicação fusionada em modo sem interface ( modo headless). Neste modo: O modo Design não está disponível, o banco de dados se inicia em modo Aplicação Não se mostra a barra de ferramentas, a barra de menus, a janela MDI ou a tela de boas vindas Não se mostra nenhum ícone no dock ou na barra de tarefas O banco de ados aberto não se registra no menu "Bancos de dados recentes O histórico de diagnóstico se inicia automaticamente (ver SET DATABASE PARAMETER, selector 79) Toda chamada a uma caixa de diálogo é interceptada e se oferece uma resposta automática (por exemplo, OK para o comando ALERT, Abort para um diálogo de erro...). Todos os comandos interceptados (*) são registrados no histórico de diagnóstico Para as necessidades de manutenção, pode enviar qualquer texto às sequências de saida padrão utilizando o comando LOG EVENT. Lembre que as aplicações 4D só podem ser fechadas mediante uma chamada a QUIT 4D ou mediante o administrador de tarefas do sistema operativo.

(*) Alguns diálogos são exibidos antes do banco de dados ser aberto, fazendo impossível que se escreva no arquivo de histórico de Diagnóstico (alerta de licença, diálogo de conversão, seleção de banco de dados, seleção arquivos de dados). Em tais casos, uma mensagem de erro é lançada no stream stderr e no histórico de eventos do sistema, e a aplicação fecha.

Exemplos

Estes exemplos assumem que sua aplicação 4D está armazenada no desktop e que o banco de dados a ser aberto é encontrado na pasta "Documents".

Nota: A pasta atual do usuário é alcançada usando o comando "~ " em macOS e o comando "%HOMEPATH%" em Windows.
Lançar aplicação
macOS:
open ~/Desktop/4D.app

Windows:
%HOMEPATH%\Desktop\4D\4D.exe
Lançar aplicação com o arquivo de estrutura
macOS:
open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase

Windows:
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myDB.4dbase\myDB.4db
Lançar aplicação com o arquivo de estrutura e um arquivo de dados
macOS:
open ~/Desktop/4D.app --structure ~/Documents/myBase.4dbase --data ~/Documents/data/myData.4DD

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --structure %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --data %HOMEPATH%\Documents\data\myData.4DD or: %HOMEPATH%\Desktop\4D\4D.exe /structure %HOMEPATH%\Documents\myBase.4dbase\myDB.4db /data %HOMEPATH%\Documents\data\myData.4DD
Lançar a aplicação com um arquivo .4DLink
    macOS:

open ~/Desktop/4D.app MyDatabase.4DLink


open "~/Desktop/4D Server.app" MyDatabase.4DLink

    Windows:

%HOMEPATH%\Desktop\4D.exe MyDatabase.4DLink


"%HOMEPATH%\Desktop\4D Server.exe" MyDatabase.4DLink
Lançar aplicação em modo compilado e criar um arquivo de dados se não estiver disponível
macOS:
open ~/Desktop/4D.app ~/Documents/myBase.4dbase --opening-mode compiled --create-data true

Windows:
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --opening-mode compiled --create-data true

Lançar aplicação com um arquivo de estrutura e um arquivo de dados e passar uma string como um parâmetro de usuário
macOS:
open ~/Desktop/4D.app --structure ~/Documents/myBase.4dbase --data ~/Documents/data/myData.4DD --user-param "Hello world"

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --structure %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --data %HOMEPATH%\Documents\data\myData.4DD --user-param "Hello world"
Lançar a aplicação sem interface (modo headless)
macOS:
open ~/Desktop/4D.app --structure ~/Documents/myBase.4dbase --data ~/Documents/data/myData.4DD --headless

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --structure %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --data %HOMEPATH%\Documents\data\myData.4DD --headless

Ver também

Headless 4D applications (blog post)