Edit

Interfaz de línea de comando

Puede utilizar el terminal macOS o la consola Windows para manejar sus aplicaciones 4D (4D y 4D Server) utilizando líneas de comando. Más concretamente, esta funcionalidad le permite:

• lanzar una base de datos de forma remota, lo que puede ser especialmente útil para administrar los servidores web.
• ejecutar pruebas automáticas para sus aplicaciones.

Información básica

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

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

En macOS, se pueden pasar los argumentos directamente yendo a la carpeta donde se encuentra la aplicación dentro del paquete (Contents/MacOS), lo que permite direccionar el flujo stderr. Por ejemplo, si el paquete 4D se encuentra en la carpeta MyFolder, 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 siempre que no necesite acceder al flujo stderr.

Lanzar una aplicación 4D

A continuación se describen las líneas de comando y los argumentos soportados para lanzar aplicaciones 4D.

Sintaxis:

<applicationPath> [--version] [--help] [--project] [<projectPath | packagePath | 4dlinkPath> [--data <dataPath>]] 
[--opening-mode interpreted | compiled] [--create-data] [--user-param <user string>] [--headless] [--dataless]
[--webadmin-settings-file] [--webadmin-access-key] [--webadmin-auto-start] [--webadmin-store-settings]

Argumento	Valor	Descripción
applicationPath	Ruta de acceso a 4D, 4D Server o de la aplicación fusionada	Lance la aplicación. Es 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 la caja de diálogo "seleccionar la base de datos".
--version		Muestra la versión de la aplicación y sale
--help		Muestra el mensaje de ayuda y salir. Argumentos alternativos: -?, -h
--project	projectPath | packagePath | 4dlinkPath	Archivo de proyecto a abrir con el archivo de datos actual. No aparece ninguna caja de diálogo.
--data	dataPath	Archivo de datos a abrir con el archivo de proyecto designado. Si no se especifica, 4D utiliza el último archivo de datos abierto.
--opening-mode	interpreted | compiled	Base de datos de peticiones a abrir en modo interpretado o compilado. No se lanza 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 ninguna caja de diálogo. 4D utiliza el nombre del archivo pasado en el argumento "--data" si lo hay (genera un error si ya existe un archivo con el mismo nombre).
--user-param	Cadena usuario personalizada	Una cadena que estará disponible en la aplicación 4D a través del comando Get database parameter (la cadena no debe comenzar por un caracter "-", que está reservado).
--headless		Lanza 4D, 4D Server o la aplicación fusionada sin interfaz (modo headless). En este modo: El modo Diseño no está disponible, la base de datos se inicia en modo Aplicación No se muestra ninguna barra de herramientas, barra de menús, ventana MDI o pantalla de inicio No aparece ningún icono en el dock o en la barra de tareas La base de datos abierta no está registrada en el menú "Bases de datos recientes" El registro de diagnóstico se lanza automáticamente ( ver SET DATABASE PARAMETER, selector 79) Cada llamada a una caja de diálogo es interceptada y se da 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 registro de diagnóstico. Para las necesidades de mantenimiento, puede enviar cualquier texto a los flujos de salida estándar utilizando la función LOG EVENT. Tenga en cuenta que las aplicaciones 4D sin interfaz sólo pueden cerrarse mediante una llamada a QUIT 4D o utilizando el administrador de tareas del sistema operativo.
--dataless		Lanza 4D, 4D Server o la aplicación fusionada en modo sin datos. El modo sin datos es útil cuando 4D ejecuta tareas sin necesidad de datos (compilación de proyectos, por ejemplo). En este modo: No se abre ningún archivo que contenga datos, incluso si se especifica en la línea de comandos o en el archivo .4DLink, o cuando se utilizan los comandos CREATE DATA FILE y OPEN DATA FILE. Los comandos que manipulan datos generarán un error. Por ejemplo, CREATE RECORD lanza "no hay tabla a la que aplicar el comando". Nota: Si se pasa en la línea de comandos, el modo sin datos se aplica a todas las bases de datos abiertas en 4D, mientras no se cierre la aplicación. Si se pasa utilizando el archivo .4DLink, el modo sin datos sólo se aplica a la base de datos especificada en el archivo .4DLink. Para más información sobre los archivos .4DLink, ver Atajos para abrir proyectos.
--webadmin-settings-file	Ruta del archivo	Ruta del archivo WebAdmin .4DSettings personalizado para el servidor web WebAdmin
--webadmin-access-key	Cadena	Llave de acceso al servidor web WebAdmin
--webadmin-auto-start	Booleano	Estado del inicio automático del servidor web WebAdmin
--webadmin-store-settings		Almacena la llave de acceso y los parámetros de inicio automático en el archivo de parámetros actual (es decir, el archivo WebAdmin.4DSettings por defecto o un archivo personalizado designado por el parámetro --webadmin-settings-path). Utilice el argumento --webadmin-store-settings para guardar estos parámetros si es necesario

(*) Algunos diálogos se muestran antes de que se abra la base de datos, 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 este caso, se lanza un mensaje de error tanto en el flujo stderr como en el registro de eventos sistema, y luego la aplicación se cierra.

Ejemplos

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

La carpeta actual del usuario se alcanza utilizando el comando "~ " en macOS y el comando "%HOMEPATH%" en Windows.

Lance la aplicación:

• macOS:

open ~/Desktop/4D.app

• Windows:

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

Lanzar la aplicación con un archivo paquete en macOS:

yarn open ~/Desktop/4D.app --args ~/Documents/myDB.4dbase

Lanzar la aplicación con un archivo proyecto:

• macOS:

yarn 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
or:
%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 MyDatabase.4DLink

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

• Windows:

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

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

Lanzar la aplicación en modo compilado y crear 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 pasar una cadena como parámetro 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