Invocazione da linea di comando =============================== Konga può essere invocato da interfaccia a linea di comando; in questo caso si ha la possibilità di specificare una serie di opzioni di avvio altrimenti non accessibili. .. note:: **Utenti Windows:** per lanciare Konga da prompt dei comandi è necessario aver installato il componente ``Supporto da prompt dei comandi`` durante l'installazione del programma. Questo componente installa il comando ``KONGA.COM`` (o ``KONGACLIENT.COM``) e aggiorna anche la variabile d'ambiente ``PATH`` in modo da rendere possibile l'esecuzione di questo comando da qualsiasi directory. .. note:: **Utenti Mac OS X:** per lanciare Konga da terminale è necessario installare il relativo supporto. La prima volta che si avvia Konga, viene richiesto se si vuole installare il supporto all'esecuzione da terminale; questo non verrà più richiesto agli avvii successivi, ma sarà sempre possibile installare il supporto dalle preferenze del programma, alla voce *Avanzate*. Per installare il supporto è necessario possedere i privilegi di amministratore della macchina e verrà installato il comando ``easybyte-konga`` (o ``easybyte-konga-client``) accessibile da qualsiasi directory. .. note:: **Utenti Linux:** il supporto all'esecuzione di Konga da terminale è installato automaticamente; è disponibile il comando ``easybyte-konga`` (o ``easybyte-konga-client``) accessibile da qualsiasi directory. .. program:: easybyte-konga Uso:: easybyte-konga [-v] [-l ] [-p ] [--lang it|en|nl] [--no-windows] [--no-default] [--reset-prefs] [--no-prefs] [-c] [--cli-connect HOST[:[PORT][:TENANT_KEY]]] [-e COMMAND] [--script FILE] [--script-step FILE] [--always-connect] [--loglevel DEBUG|INFO|WARNING|ERROR|CRITICAL] [--client] [FILE] ``FILE`` permette di specificare un file da aprire all'avvio di Konga, e può essere un database (estensione ``.edb``), un backup (estensione ``.ebk``) oppure un layout di stampa (estensione ``.plx``). Nel caso di database o backup, se il file non è già nella posizione corretta assunta dal programma (percorso dei database o dei backup impostati dalle preferenze del server), Konga chiederà conferma all'utente se si desidera copiare il file e in caso affermativo provvederà automaticamente a copiare lo stesso nella posizione predefinita prima dell'apertura. Argomenti opzionali: .. option:: -h, --help Show this help message and exit. .. option:: -v, --version Mostra la versione del programma ed esci. .. option:: -l , --login Imposta il nome utente per l'autenticazione automatica. .. option:: -p , --password Imposta la password per l'autenticazione automatica. .. option:: --lang it|en|nl Imposta la lingua corrente. .. option:: --no-windows Avvia il programma senza ripristinare le finestre salvate nella precedente sessione di lavoro. .. option:: --no-default Avvia il programma senza aprire il database predefinito, se impostato. .. option:: --reset-prefs Azzera e reimposta tutte le preferenze del programma ai valori predefiniti. .. option:: --no-prefs Avvia il programma con le preferenze predefinite, ma non sovrascrive le preferenze precedenti. .. option:: -c, --cli Avvia il programma in modalità console da linea di comando. .. option:: --cli-connect HOST[:[PORT][:TENANT_KEY]] Come --cli, ma connette al server specificato all'avvio. .. option:: -e COMMAND, --execute COMMAND Esegui uno o più comandi console specificati ed esci. .. option:: --script FILE Esegui tutti i comandi console nel file di script specificato ed esci; se file è il carattere '-', legge lo script da standard input. .. option:: --script-step FILE Esegui tutti i comandi console nel file di script specificato ed esci, chiedendo conferma di esecuzione per ogni riga; se file è il carattere '-', legge lo script da standard input. .. option:: --always-connect Connetti sempre a database anche se la versione del client è diversa da quella del server. .. option:: --loglevel DEBUG|INFO|WARNING|ERROR|CRITICAL Imposta il livello di log (predefinito: debug). .. option:: --client Disabilita il server integrato, emulando a tutti gli effetti un konga client. .. _script: Script di Konga =============== E' possibile salvare una serie di :ref:`comandi console `, uno per linea, in un semplice file di testo e salvare questo file come uno *script di Konga*. Lanciando Konga da linea di comando passando il percorso del file come parametro dell'opzione ``--script``, il programma non verrà avviato in modalità grafica, ma eseguirà ogni comando console contenuto nel file, alla fine del quale Konga sarà terminato. Da notare che le linee vuote o che iniziano con il carattere ``#`` (interpretate come commenti) non verranno eseguite. .. hint:: **(Solo utenti Mac OS X e Linux)** Se la prima linea del file è:: #!/usr/bin/easybyte-konga --script ed il file è reso eseguibile, sarà possibile lanciarlo direttamente da terminale. All'interno degli script si possono accedere le variabili d'ambiente del terminale tramite la forma ``$``. Esempi ------ * Come ottenere i codici delle aliquote IVA del database SQLite il cui nome è contenuto nella variabile d'ambiente ``MYKONGADB``:: #!/usr/bin/easybyte-konga --script .connect 127.0.0.1 .open_database $MYKONGADB SELECT Codice FROM EB_AliquoteIVA * Come eseguire un backup ed una importazione:: #!/usr/bin/easybyte-konga --script .connect 127.0.0.1 .backup_database $MYKONGADB "Backup di sicurezza" .open_database $MYKONGADB .import -i data.json -f json * Come eseguire una esportazione mirata:: #!/usr/bin/easybyte-konga --script .connect 127.0.0.1 .open_database $MYKONGADB .export -o data.json -t EB_DocumentiFiscali -w "DataDocumento > '2015-01-01'" -f json