Interfaz de línea de comando

4D v20 R7

Puede utilizar la Terminal de macOS o la consola de Windows para manejar sus aplicaciones 4D (4D y 4D Server) por líneas de comando. Esta funcionalidad le permite:

lanzar una base de datos remotamente, lo cual puede ser particularmente útil para los administradores de servidores web.
ejecutar pruebas automáticas para sus aplicaciones.

Información básica

Puede ejecutar las líneas de comando para aplicaciones 4D utilizando el Terminal macOS o la consola Windows.

Bajo macOS, debe utilizar el comando open.
Bajo Windows, puede pasar los argumentos directamente.

Nota: bajo macOS, puede pasar directamente los argumentos accediendo a la carpeta donde se encuentra la aplicación en el interior del paquete (ruta Contents/MacOS), la cual permite direccionar el flujo stderr. Por ejemplo, si el paquete 4D se encuentra en la carpeta MiCarpeta, debe escribir la línea de comandos de la siguiente manera: /MyFolder/4D.app/Contents/MacOS/4D &. Sin embargo, le recomendamos que utilice el comando open, cuando no necesite acceder al flujo stderr.

Lanzar una aplicación 4D

Esta es una descripción de las líneas de comandos y de sus argumentos los cuales son soportados para lanzar aplicaciones 4D:

Sintaxis

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

Argumento	Valor	Descripción
applicationPath	Ruta de la aplicación 4D, 4D Server o combinada	Inicia la aplicación. Idéntico a hacer doble clic en la aplicación 4D. Cuando se llama sin argumento de archivo de estructura, la aplicación se ejecuta y aparece el cuadro de diálogo 'seleccionar base de datos'.
--project	projectPath \| packagePath \| 4dlinkPath	Archivo de proyecto para abrir con el archivo de datos actual. No aparece el cuadro de diálogo.
--data	rutaDatos	Archivo de datos para abrir con el archivo de proyecto designado. Si no se especifica, 4D utiliza el último archivo de datos abierto.
--opening-mode	interpreted \| compiled	Solicita que la base de datos se abra en modo interpretado o compilado. No se produce ningún error si el modo solicitado no está disponible.
--create-data		Crea automáticamente un nuevo archivo de datos si no se encuentra un archivo de datos válido. No aparece el cuadro de diálogo. 4D utiliza el nombre de archivo pasado en el argumento "--data" si lo hay (genera un error si ya existe un archivo con el mismo nombre).
--user-param	Cadena de usuario personalizada	Una cadena que estará disponible dentro de la aplicación 4D a través del comando Get database parameter (la cadena no debe comenzar por el caracter "-", el cual está reservado).
--headless		Inicia 4D, 4D Server o la aplicación fusionadaen modo sin interfaz (headless mode). En este modo: El modo Diseño no está disponible, la base inicia en modo Aplicación No se muestra la barra de herramientas, la barra de menús, la ventana MDI o la pantalla de bienvenida No se muestra ningún icono en el dock o en la barra de tareas La base abierta no se registra en el menú "Bases de datos recientes El historial de diagnóstico se inicia automáticamente (ver SET DATABASE PARAMETER, selector 79) Toda llamada a una caja de diálogo es interceptada y se ofrece una respuesta automática (por ejemplo, OK para el comando ALERT, Abort para un diálogo de error...). Todos los comandos interceptados (*) se registran en el historial de diagnóstico Para las necesidades de mantenimiento, puede enviar cualquier texto a las secuencias de salida estándar utilizando el comando LOG EVENT. Tenga en cuenta que las aplicaciones 4D solo pueden cerrarse mediante una llamada a QUIT 4D o mediante el administrador de tareas del sistema operativo.
-version		Muestra la versión de la aplicación y sale
--help		Muestra la ayuda y sale. Argumentos alternativos: -?, -h

(*) Algunos diálogos se muestran antes de abrir la base, por lo que es imposible escribir en el archivo de registro de diagnóstico (alerta de licencia, diálogo de conversión, selección de base de datos, selección de archivo de datos). En tal caso, se emite un mensaje de error tanto en el flujo stderr como en el registro de eventos del sistema, y luego se cierra la aplicación.

Ejemplos

Estos ejemplos asumen que su aplicación 4D está almacenada en el escritorio y que la base de datos que se abrirá se encuentra en la carpeta "Documentos".

Nota: la carpeta actual del usuario se accede utilizando el comando "~" en macOS y el comando "%HOMEPATH%" en Windows.

Lanzar aplicación
macOS:
open ~/Desktop/4D.app

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

Lanzar aplicación con un archivo paquete en macOS:
open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase

Lanzar la aplicación con un archivo proyecto
macOS:
open ~/Desktop/4D.app --args ~/Documents/myProj/Project/myProj.4DProject

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

Lanzar la aplicación con un archivo proyecto y un archivo de datos
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 o: %HOMEPATH%\Desktop\4D\4D.exe /project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject /data %HOMEPATH%\Documents\data\myData.4DD

Lanzar la aplicación con un archivo .4DLink
macOS:
open ~/Desktop/4D.app ~/Desktop/MyDatabase.4DLink

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

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

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

Lanzar la aplicación en modo compilado y cree un archivo de datos si no está disponible
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
Lanzar la aplicación con un archivo proyecto y un archivo de datos y pase una cadena como un parámetro de usuario
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"

Lanzar la aplicación sin interfaz (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 también

Headless 4D applications (blog post)