Interface da linha de comando

4D v20.2

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.

Lançar uma aplicação 4D

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

Sintaxe

<applicationPath> [--project] [<projectPath | packagePath | 4dlinkPath> [--data <dataPath>]] [--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>] [--headless] [--version] [--help]

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.
--project	projectPath \| packagePath \| 4dlinkPath	Arquivo de projeto para abrir o arquivo de dados atual. Nenhuma caixa de diálogo aparece.
--data	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.
--opening-mode	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).
--user-param	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.
--version		Exibe a versão da aplicação e sai
--help		Exibe a ajuda e sai. Argumentos alternativos: -?, -h

(*) 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 um arquivo pacote em macOS:
open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase

Lançar aplicação com um arquivo projeto
macOS:
open ~/Desktop/4D.app --args ~/Documents/myProj/Project/myProj.4DProject

Windows:
%HOMEPATH%\Desktop\4D\4D.exe %HOMEPATH%\Documents\myProj\Project\myProj.4DProject

Lançar aplicação com um arquivo projeto e um arquivo dados
macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD or: %HOMEPATH%\Desktop\4D\4D.exe /project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject /data %HOMEPATH%\Documents\data\myData.4DD

Lançar aplicação com um arquivo .4DLink
macOS:
open ~/Desktop/4D.app ~/Desktop/MyDatabase.4DLink

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

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

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

Lançar aplicação em modo compilado e criar um arquivo de dados se não disponível
macOS:
open ~/Desktop/4D.app ~/Documents/myBase.4dbase --args --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 projeto e um arquivo de dados e passar uma string como parâmetro de usuário
macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --user-param "Hello world"

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --user-param "Hello world"

Lançar aplicação sem interface (modo headless)
macOS:
open ~/Desktop/4D.app --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --headless

open ~/Desktop/MyBuiltRemoteApp −−headless

Windows:
%HOMEPATH%\Desktop\4D\4D.exe --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject --data %HOMEPATH%\Documents\data\myData.4DD --headless %HOMEPATH%\Desktop\4D\MyBuiltRemoteApp.exe --headless

Ver também

Headless 4D applications (blog post)