Saltar al contenido principal
Versión: Siguiente

Interfaz de línea de comando

Puede utilizar el Terminal de macOS o la consola de Windows para manejar sus aplicaciones 4D (4D, 4D Server, aplicación fusionada y tool4d) 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, recomendamos que utilice el comando open siempre que no necesite acceder al stream 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]  
[--utility] [--skip-onstartup] [--startup-method <methodName string>]
ArgumentoValorDescripción
applicationPathRuta de 4D, 4D Server, aplicación fusionada o tool4dLanza la aplicación.
Si no es sin interfaz: idéntico a hacer doble clic en la aplicación; cuando se llama sin argumento de archivo de estructura, la aplicación se ejecuta y aparece la caja de diálogo "seleccionar base de datos".
--versionMuestra la versión de la aplicación y sale
--helpMuestra el mensaje de ayuda y sale. Argumentos alternativos: -?, -h
--projectprojectPath | packagePath | 4dlinkPathArchivo de proyecto a abrir con el archivo de datos actual. No aparece ninguna caja de diálogo.
--datadataPathArchivo de datos a abrir con el archivo de proyecto designado. Si no se especifica, se utiliza el último archivo de datos abierto.
--opening-modeinterpreted | compiledBase 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-dataCrea 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-paramCadena usuario personalizadaUna cadena que estará disponible en la aplicación a través del comando Get database parameter (la cadena no debe comenzar por un carácter "-", que está reservado).
--headlessLanza 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 la barra de herramientas, la barra de menú, la ventana MDI ni la pantalla de presentación
  • No se muestra ningún icono en el dock o la barra de tareas
  • La base de datos abierta no se registra en el menú "Bases de datos recientes"
  • Se inicia automáticamente el registro de diagnóstico (ver SET DATABASE PARAMETER, selector 79)
  • Se intercepta cada llamada a una caja de diálogo y se suministra 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 los flujos de salida estándar utilizando el comando 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.
    --datalessLanza 4D, 4D Server, la aplicación fusionada o tool4d 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, aunque se especifique en la línea de comandos o en el archivo .4DLink, o cuando se utilicen los comandos CREATE DATA FILE y OPEN DATA FILE.
  • Los comandos que manipulen datos generarán un error. Por ejemplo, CREATE RECORD muestra el mensaje “no hay tabla a la cual aplicar el comando”.

    • Nota:
  • si se pasa en la línea de comandos, el modo dataless se aplica a todas las bases de datos abiertas en 4D, siempre y cuando la aplicación no se cierre.
  • Si se pasa utilizando el archivo .4DLink, el modo dataless solo 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-fileRuta del archivoRuta del archivo .4DSettings personalizado para el servidor web WebAdmin. No disponible con tool4d.
    --webadmin-access-keyTextLlave de acceso para el servidor web WebAdmin. No disponible con tool4d.
    --webadmin-auto-startBooleanEstado del lanzamiento automático del servidor web WebAdmin. No disponible con tool4d.
    --webadmin-store-settingsAlmacena la llave de acceso y los parámetros de inicio automático en el archivo de parámetros actualmente utilizado (es decir, el archivo WebAdmin.4DSettings por defecto o un archivo personalizado designado con el parámetro --webadmin-settings-path). Utilice el argumento --webadmin-store-settings para guardar esta configuración si es necesario. No disponible con tool4d.
    --utilitySólo disponible con 4D Server. Sólo disponible con 4D Server.
    --skip-onstartupLanza el proyecto sin ejecutar ningún método "automático", incluyendo los métodos base On Startup y On Exit
    --startup-methodNombre del método proyecto (cadena)Método de proyecto a ejecutar inmediatamente después del método base On Startup (si no se omite con --skip-onstartup).

    (*) Algunos diálogos se muestran antes de abrir 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 bases de datos, selección de archivos 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​

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

    Lance una aplicación 4D almacenada en el escritorio:

    • macOS:
    open ~/Desktop/4D.app
              open "~/Desktop/4D Server.app"
    • Windows:
    %HOMEPATH%\Desktop\4D\4D.exe
              %HOMEPATH%\Desktop\"4D Server.exe"

    Abra un paquete en macOS:

    --args ~/Documents/myDB.4dbase

    Abra un archivo de proyecto:

    • macOS:
    --args ~/Documents/myProj/Project/myProj.4DProject
    • Windows:
    %HOMEPATH%\Documents\myProj\Project\myProj.4DProject

    Abra un archivo de proyecto y un archivo de datos:

    • macOS:
    --args --project ~/Documents/myProj/Project/myProj.4DProject
              --data ~/Documents/data/myData.4DD
    • Windows:
    --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject
              --data %HOMEPATH%\Documents\data\myData.4DD
              o:
              /project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject /data
              %HOMEPATH%\Documents\data\myData.4DD

    Abra un archivo .4DLink:

    • macOS:
    ~/Desktop/MyDatabase.4DLink
    • Windows:
    %HOMEPATH%\Desktop\MyDatabase.4DLink

    Lance la aplicación en modo compilado y cree un archivo de datos si no está disponible:

    • macOS:
    ~/Documents/myBase.4dbase --args --opening-mode compiled
              --create-data true
    • Windows:
    %HOMEPATH%\Documents\myBase.4dbase\myDB.4db --opening-mode
              compiled --create-data true

    Lance la aplicación con un archivo proyecto y un archivo de datos y pase una cadena como parámetro de usuario:

    • macOS:
    --args --project ~/Documents/myProj/Project/myProj.4DProject
              --data ~/Documents/data/myData.4DD --user-param "Hello world"
    • Windows:
    --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject
              --data %HOMEPATH%\Documents\data\myData.4DD --user-param "Hello world"

    Apertura sin interfaz (modo headless):

    • macOS:
    --args --project ~/Documents/myProj/Project/myProj.4DProject --data ~/Documents/data/myData.4DD --headless
    • Windows:
    --project %HOMEPATH%\Documents\myProj\Project\myProj.4DProject
              --data %HOMEPATH%\Documents\data\myData.4DD --headless

    tool4d​

    tool4d es una aplicación gratuita, ligera y autónoma que le permite abrir un proyecto 4D en modo sin interfaz y ejecutar código 4D utilizando la lìnea de comando (CLI).

    tool4d está disponible en Windows y macOS y siempre está asociado a una versión 4D (misma versión y número de compilación). Sólo está disponible en inglés.

    tool4d es una herramienta perfecta si desea:

    • implementar una cadena CI/CD para su aplicación 4D,
    • utilizar un ejecutable 4D ligero para ejecutar scripts 4D, por ejemplo para ejecutar pruebas unitarias automáticas.

    Uso de tool4d​

    Puedes obtener tool4d de la Página de descarga de productos.

    Se utiliza tool4d ejecutando una línea de comandos con un proyecto 4D estándar. Puede utilizar todos los argumentos descritos en la tabla anterior, excepto --webadmin ya que este componente está desactivado en tool4d. Con tool4d, se lanza la siguiente secuencia específica:

    1. La herramienta 4D ejecuta el método base On Startup (y todos los métodos "automáticos" como el método usuario), excepto si se pasa el argumento --skip-onstartup.
    2. tool4d ejecuta el método designado por el argumento --startup-method, si existe.
    3. tool4d ejecuta el método base On Exit, excepto si se pasa el argumento --skip-onstartup.
    4. tool4d cierra.

    En Windows, tool4d es una aplicación de consola, de modo que el stream stdout se muestra en el terminal (cmd, powershell...).

    Notas
    • tool4d siempre se ejecuta sin interfaz (la opción de línea de comandos headless es inútil).
    • El comando Application type devuelve el valor 6 ("tool4d") cuando se llama desde la aplicación tool4d.
    • el archivo de registro de diagnóstico tiene el prefijo "4DDiagnosticLogTool".

    Funcionalidades 4D desactivadas​

    Tenga en cuenta que tool4d se ejecuta automáticamente en modo sin interfaz (ver --headless en esta tabla), y no da acceso al IDE 4D ni a ninguno de sus servidores. En concreto, se desactivan las siguientes funcionalidades:

    • servidor de aplicaciones, servidor web, servidor SQL,
    • programador de copias de seguridad,
    • ODBC y SQL pass-through,
    • todos los componentes como 4D View Pro, 4D SVG, 4D NetKit...,
    • corrector ortográfico hunspell,
    • corrector ortográfico japonés (librería mecab),
    • WebAdmin
    • CEF,
    • PHP,
    • depurador remoto (depurador local, el comando TRACE y los puntos de interrupción se ignoran en las aplicaciones sin interfaz).

    4D Server en modo utilitario​

    Puede lanzar una instancia 4D Server en modo utilitario (sin interfaz) utilizando la opción CLI --utility. En este caso, se activa el siguiente flujo de trabajo:

    1. 4D Server ejecuta el método base On Startup (y todos los métodos "automáticos" como el método usuario), excepto si se pasa el parámetro --skip-onstartup.
    2. 4D Server ejecuta el método designado por el --startup-method, si existe.
    3. El servidor 4D ejecuta el método base On Exit, excepto si se pasa el parámetro --skip-onstartup.
    4. 4D Server se cierra.
    info

    A diferencia de tool4d, 4D Server en modo utilitario tiene todas sus funcionalidades activadas. Sin embargo, el servidor de aplicaciones y el resto de servidores no se inician.

    Ver también

    Ver esta publicación de blog para ejemplos de cómo utilizar tool4d y 4D Server en modo utilitario.