.. _console: Comandi console =============== La console di amministrazione di Konga accetta sia query SQL che una serie di comandi specifici; tutti i comandi sono nella forma ``.``, altrimenti la riga inserita è interpretata come una query SQL. Se il primo carattere è ``!``, il resto della riga viene sempre interpretato come una query SQL, ma nativa per il driver del database attualmente connesso. Di seguito sono riportate le istruzioni di utilizzo di tutti i comandi disponibili. Ogni comando supporta anche l'opzione ``-h``, qui omessa, che stampa sulla console l'aiuto in linea del comando stesso. .. _cmd_activate: .. program:: activate .activate ^^^^^^^^^ Attiva il server. Uso:: .activate .. option:: serial Seriale abbinato al contratto. .. option:: name Nome del licenziatario. .. option:: key Chiave di attivazione. .. _cmd_add_job: .. program:: add_job .add_job ^^^^^^^^ Aggiunge una nuova attività pianifica sul server. Uso:: .add_job [--driver ] [--database ] [--tenant ] [-p ] optimize|backup|index .. option:: optimize|backup|index Tipo di attività da pianificare. .. option:: when Stringa di specifica della periodicità (stile `cron `_). .. option:: --driver Nome del driver a cui applicare questa attività (* = tutti). .. option:: --database Nome del database a cui applicare questa attività (* = tutti). .. option:: --tenant Chiave del tenant per cui applicare questa attività (* = tutti). .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_add_tenant: .. program:: add_tenant .add_tenant ^^^^^^^^^^^ Aggiunge un nuovo tenant sul server. Uso:: .add_tenant [--databases [DRIVER:DATABASE ...]] [-p ] .. option:: name Nome del tenant. .. option:: max_clients Numero massimo di postazioni disponibili per questo tenant. .. option:: --databases [DRIVER:DATABASE ...] Database configurati per il tenant, nella forma driver:nome. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_archive_accounting_year: .. program:: archive_accounting_year .archive_accounting_year ^^^^^^^^^^^^^^^^^^^^^^^^ Archivia un esercizio del database corrente su un altro database di tipo archivio storico. Uso:: .archive_accounting_year [-d ] [--create] [--desc ] [-b] [--position computer|cloud|both] [--optimize] [-p ] .. option:: company_code Codice dell'azienda. .. option:: accounting_year_code Codice dell'esercizio da archiviare. .. option:: archive_name Nome dell'archivio storico. .. option:: -d , --driver Driver del database. .. option:: --create Crea un nuovo archivio storico. .. option:: --desc Imposta la descrizione dell'archivio storico durante la creazione. .. option:: -b, --backup Esegue un backup del database prima di archiviare l'esercizio. .. option:: --position computer|cloud|both Posizione in cui salvare il backup. .. option:: --optimize Ottimizza il database originale al termine dell'archiviazione. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_backup_database: .. program:: backup_database .backup_database ^^^^^^^^^^^^^^^^ Esegui il backup di un database. Uso:: .backup_database [-d ] [-p ] [-o] [--position computer|cloud|both] [--store-index] .. option:: name Nome del database. .. option:: backup_name Nome del backup. .. option:: -d , --driver Driver del database. .. option:: -p , --password Password del server per autorizzare l'operazione. .. option:: -o, --overwrite Sovrascrivi il backup se già esiste. .. option:: --position computer|cloud|both Posizione in cui salvare il backup. .. option:: --store-index Includi l'indice di ricerca del database nel backup. .. _cmd_begin: .. program:: begin .begin ^^^^^^ Inizia una nuova transazione. Uso:: .begin [--no-index] Argomenti opzionali: .. option:: --no-index Sospendi l'indicizzazione del database durante la transazione. .. _cmd_binary_data_stats: .. program:: binary_data_stats .binary_data_stats ^^^^^^^^^^^^^^^^^^ Ottiene statistiche sui dati binari del database corrente. Uso:: .binary_data_stats .. _cmd_calc: .. program:: calc .calc ^^^^^ Calcola il risultato di una espressione matematica. Uso:: .calc ... .. option:: expr Espressione da calcolare. .. _cmd_clone_database: .. program:: clone_database .clone_database ^^^^^^^^^^^^^^^ Duplica un database. Uso:: .clone_database [-d ] [--new-driver ] [-p ] [] .. option:: name Nome del database. .. option:: new_name Nome del nuovo database. .. option:: -d , --driver Driver del database. .. option:: --new-driver Driver del nuovo database. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_close_database: .. program:: close_database .close_database ^^^^^^^^^^^^^^^ Chiude il database corrente. Uso:: .close_database .. _cmd_cloud_info: .. program:: cloud_info .cloud_info ^^^^^^^^^^^ Riporta informazioni sullo stato del supporto cloud. Uso:: .cloud_info .. _cmd_commit: .. program:: commit .commit ^^^^^^^ Termina la transazione corrente salvando le modifiche. Uso:: .commit [--index] Argomenti opzionali: .. option:: --index Riprendi l'indicizzazione del database se precedentemente sospesa. .. _cmd_config: .. program:: config .config ^^^^^^^ Ottiene o imposta i settaggi del server. Uso:: .config [-p ] list|get|set|help [] [] .. option:: list|get|set|help Azione da eseguire. .. option:: key Chiave da ottenere o impostare. .. option:: value Valore da impostare. .. option:: -p , --password Password del server per autorizzare l'operazione. L'azione ``list`` mostra tutte le chiavi dei settaggi disponibili con il relativo valore corrente. Ogni chiave può avere delle restrizioni sul valore che può assumere; l'azione ``help`` mostra su console un aiuto in linea sulla configurazione della chiave desiderata. .. _cmd_connect: .. program:: connect .connect ^^^^^^^^ Connette ad un nuovo server. Uso:: .connect [-p ] [--timeout ] [--tenant-key ] .. option:: host Indirizzo o nome del server a cui collegarsi. .. option:: -p , --port Porta del server a cui collegarsi. .. option:: --timeout Tempo di attesa per effettuare la connessione. .. option:: --tenant-key Chiave di accesso al server in modalità multi-tenant. Se la porta è omessa, ``.connect`` proverà nell'ordine le porte ``51965`` (porta standard di Konga), ``51966`` (porta standard di Konga Server), ``51986`` e ``52006``. .. _cmd_create_database: .. program:: create_database .create_database ^^^^^^^^^^^^^^^^ Crea un nuovo database. Uso:: .create_database [-d ] [--description ] [-p ] .. option:: name Nome del database. .. option:: -d , --driver Driver del database. .. option:: --description Testo di descrizione del database. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_decrypt_backup: .. program:: decrypt_backup .decrypt_backup ^^^^^^^^^^^^^^^ Decifra un backup. Uso:: .decrypt_backup [-p ] [--position computer|cloud] .. option:: name Nome del backup. .. option:: -p , --password Password del server per autorizzare l'operazione. .. option:: --position computer|cloud Posizione in cui si trova il backup. .. _cmd_del_binary: .. program:: del_binary .del_binary ^^^^^^^^^^^ Elimina una immagine/documento allegato ad un record del database. Uso:: .del_binary [-f ] [-c ] doc|image|web|thumb .. option:: doc|image|web|thumb Tipo di binario da cancellare. .. option:: resource Nome risorsa nella forma :. .. option:: -f , --filename Nome del file per identificare il documento da cancellare. .. option:: -c , --company-code Codice dell'azienda proprietaria della risorsa. .. _cmd_delete_backup: .. program:: delete_backup .delete_backup ^^^^^^^^^^^^^^ Cancella un backup di database. Uso:: .delete_backup [-p ] [--position computer|cloud] .. option:: backup_name Nome del backup. .. option:: -p , --password Password del server per autorizzare l'operazione. .. option:: --position computer|cloud Posizione in cui si trova il backup. .. _cmd_delete_database: .. program:: delete_database .delete_database ^^^^^^^^^^^^^^^^ Cancella un database. Uso:: .delete_database [-d ] [--cloud-data ignore|preserve|delete] [-p ] .. option:: name Nome del database. .. option:: -d , --driver Driver del database. .. option:: --cloud-data ignore|preserve|delete Comportamento sulla cancellazione dei dati binari nel cloud. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_delete_job: .. program:: delete_job .delete_job ^^^^^^^^^^^ Cancella un'attività pianificata sul server. Uso:: .delete_job [-p ] .. option:: id Id dell'attività pianificata. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_delete_tenant: .. program:: delete_tenant .delete_tenant ^^^^^^^^^^^^^^ Cancella un tenant dal server. Uso:: .delete_tenant [-p ] .. option:: key Chiave di accesso del tenant. .. option:: -p , --password Password del server per autorizzare l'operazione. .. _cmd_disconnect: .. program:: disconnect .disconnect ^^^^^^^^^^^ Disconnette dal server corrente. Uso:: .disconnect .. _cmd_echo: .. program:: echo .echo ^^^^^ Stampa un messaggio sulla console. Uso:: .echo ... .. option:: message Messaggio da stampare. Questo comando può essere utile all'interno degli :ref:`script di Konga