{"id":22812,"date":"2022-12-15T17:00:39","date_gmt":"2022-12-15T16:00:39","guid":{"rendered":"http:\/\/help.qualiware.it\/qw-help\/?p=22812"},"modified":"2026-04-09T23:28:29","modified_gmt":"2026-04-09T21:28:29","slug":"fd-form","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/fd-form\/","title":{"rendered":"OGGETTO FORM"},"content":{"rendered":"<h4 align=\"left\"><a name=\"progettazione_form_proprieta\"><\/a>Descrizione<\/h4>\n<div class=\"msgBody\">\n<p>Il Form \u00e8 un oggetto che contiene altri oggetti.<\/p>\n<\/div>\n<div class=\"msgBody\">\n<h4 align=\"left\"><a name=\"progettazione_form_proprieta\"><\/a>Propriet\u00e0 Specifiche<\/h4>\n<p>Oltre alle <a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-proprieta-comuni\/\">propriet\u00e0 comuni<\/a> sono disponibili le seguenti propriet\u00e0:<\/p>\n<ul>\n<li><b><span style=\"color: #993300;\">AdattaAlloSpazio:<br \/>\n<\/span><\/b>Se impostata a <em>True<\/em>, consente di adattare la dimensione del form allo spazio a disposizione nel browser anzich\u00e8 mantenere la dimensione impostata nel designer e ingrandire il form stesso il pi\u00f9 possibile effettuando uno zoom. Questa propriet\u00e0 va utilizzata in combinazione con la propriet\u00e0 <span style=\"color: #993300;\"><strong>Anchor<\/strong> <\/span>disponibile su alcuni controlli.<\/li>\n<li><b><span style=\"color: #993300;\">Commenti:<br \/>\n<\/span><\/b>visibile solo in fase di progettazione<em>,&nbsp;<\/em>consente l&#8217;inserimento di informazioni quali la descrizione del form stesso e la storia delle modifiche effettuate.<\/li>\n<li><b><span style=\"color: #993300;\">Lingua:<br \/>\n<\/span><\/b>lingua nella quale viene progettato il form. E&#8217; possibile scegliere fra le seguenti lingue:<\/p>\n<ul>\n<li>it: italiano<\/li>\n<li>en: inglese<\/li>\n<li>fr: francese<\/li>\n<li>es: spagnolo<\/li>\n<li>de: tedesco<\/li>\n<li>ro: rumeno<\/li>\n<li>pt: portoghese<\/li>\n<li>bg: bulgaro<\/li>\n<li>el: greco<\/li>\n<li>zh: cinese semplificato<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p style=\"padding-left: 40px;\">Modificando la lingua, viene effettuata una traduzione automatica nella nuova lingua scelta nel caso non si ancora presente alcuna traduzione.<\/p>\n<ul>\n<li><b><span style=\"color: #993300;\">TraduzioneStringhe:<br \/>\n<\/span><\/b>Tabella di traduzione di tutte le stringhe presenti negli oggetti dei form. Consente anche di definire ulteriori stringhe da utilizzare con i metodi&nbsp; <strong>TranslateString <\/strong>e<strong> GetString<\/strong>. Queste stringhe dovranno avere un nome arbitrario nella propriet\u00e0 <strong>NomeOggetto<\/strong>, mentre la propriet\u00e0 <strong>NomePropriet\u00e0<\/strong> pu\u00f2 essere lasciata vuota. Queste stringhe aggiuntive possono anche essere relative ai nomi dei campi presenti nelle query che alimentano eventuali oggetti VistaDati, che vengono tradotti automaticamente.NOTA: in questa tabella possono essere definite le traduzioni delle intestazioni delle liste di scelta specificate nelle propriet\u00e0 QueryLista. Per ogni intestazione, pu\u00f2 essere riportata la versione italiana e quella nelle altre lingue, e il sistema effettuer\u00e0 la traduzione in automatico.<\/li>\n<\/ul>\n<\/div>\n<h4 align=\"left\"><a name=\"eventi_form\"><\/a>Eventi specifici del form<\/h4>\n<p align=\"left\">&nbsp;I principali eventi sul form sono:<\/p>\n<ul>\n<li><span style=\"color: #800000;\"><b>CambiaForm<\/b><\/span>: evento attivato al cambiamento del valore di un qualsiasi campo del form. Pu\u00f2 essere utilizzato ad esempio per<br \/>\n&#8211; modificare i valori di uno o pi\u00f9 campi in base al valore inserito in uno o pi\u00f9 campi<br \/>\n&#8211; fornire all&#8217;utente messaggi di avviso in base al valore inserito in uno o pi\u00f9 campi.<\/li>\n<li><span style=\"color: #800000;\"><b>Caricamento<\/b>:<\/span> evento attivato al caricamento di un form (sia esso esistente o nuovo). Pu\u00f2 essere utilizzato ad esempio per assegnare valori a campi che non corrispondono a campi del database ma sono la combinazione di uno o pi\u00f9 di essi (campi calcolati).<\/li>\n<li><span style=\"color: #800000;\"><b>Render<\/b>:<\/span> evento attivato alla prima visualizzazione del form e in tutti i successivi postback. Pu\u00f2 essere utilizzato ad esempio per riassegnare propriet\u00e0 degli oggetti ad ogni aggiornamento del form.<\/li>\n<li><span style=\"color: #800000;\"><b>RenderClient<\/b>:<\/span> evento lato client attivato alla prima visualizzazione del form e in tutti i successivi postback. Deve essere scritto in linguaggio Javascript e pu\u00f2 essere utilizzato, ad esempio, per effettuare aggiornamenti che richiedono l&#8217;uso di codice Javascript.<\/li>\n<li><span style=\"color: #800000;\"><b>Salva<\/b>:<\/span> evento attivato al salvataggio del form. Pu\u00f2 essere utilizzato per validare i dati: \u00e8 possibile infatti inibire il salvataggio nel caso i dati inseriti non rispettino regole specifiche che possono essere inserite nel codice di gestione dell&#8217;evento, il quale dovr\u00e0 ritornare il valore <em>false<\/em> nel caso il salvataggio debba essere inibito. Nei <a href=\"https:\/\/help.qualiware.it\/qw-help\/form_autonomi\/\">form autonomi<\/a> pu\u00f2 essere utilizzato per salvare i dati sul database.<br \/>\n<strong>NOTE<br \/>\n<\/strong>1) al momento della creazione di un documento, all&#8217;interno di una categoria di tipo file, l&#8217;evento di salvataggio del form si attiva solamente dopo che l&#8217;utente ha scelto il file da allegare.<br \/>\n2) In un <a href=\"https:\/\/help.qualiware.it\/qw-help\/form_autonomi\/\">form autonomo<\/a>, l&#8217;evento viene eseguito dopo che i valori degli oggetti sono stati salvati sulla tabella principale nei campi ad essi collegati. Pertanto, eventuali variazioni dei valori degli oggetti stessi effettuate in questo evento non si riflettono automaticamente sulla tabella principale, a meno che l&#8217;utente non effettui un ulteriore salvataggio.<\/li>\n<\/ul>\n<p>Per maggiori informazioni sugli eventi leggi <a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-eventi\/\">qui<\/a>.<\/p>\n<h4 align=\"left\"><a name=\"progettazione_form_proprieta\"><\/a>Propriet\u00e0 utilizzabili da codice<\/h4>\n<div class=\"msgBody\">\n<ul>\n<li><span style=\"color: #993300;\"><strong>GlobalVars(&lt;variable name&gt;)<\/strong><\/span>: consente di assegnare o recuperare il valore di una variabile globale del form, il cui nome \u00e8 contenuto nel parametro &lt;variable name&gt;. I nomi delle variabili sono case insensitive. \u00c8 utilizzabile solo per i form desktop.<br \/>\nEsempio:<\/p>\n<pre>form.GlobalVars(\"CONTATORE\")=0\r\nform.GlobalVars(\"CONTATORE\")=form.GlobalVars(\"CONTATORE\")+1<\/pre>\n<\/li>\n<\/ul>\n<\/div>\n<h4 align=\"left\"><a name=\"eventi_form\"><\/a>Metodi utilizzabili da codice lato Server (VB.NET\/C#)<\/h4>\n<ul>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>Alert(&lt;message&gt;,&lt;optional caption&gt;)<\/strong><\/span><\/span>: consente di visualizzare una finestra popup che visualizza la stringa passata come primo parametro e, solo per la versione desktop, ha opzionalmente come titolo la stringa passata come secondo parametro;<\/li>\n<li><span style=\"color: #993300;\"><strong>ChooseOption(&lt;postback procedure&gt;,&lt;options array&gt;)<\/strong><span style=\"color: #000000;\">: visualizza una richiesta popup che consente all&#8217;utente di scegliere fra una serie di opzioni specificate nel parametro &lt;options array&gt;. &nbsp;In caso di pressione del pulsante di conferma, viene richiamato l&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt;. All&#8217;interno del codice dell&#8217;evento \u00e8 utilizzabile&nbsp;il parametro&nbsp;<strong>Parameter1<\/strong>&nbsp;al quale viene passato l&#8217;indice dell&#8217;opzione scelta.<br \/>\n<\/span><\/span>Esempio di utilizzo:<\/p>\n<pre>form.ChooseOption(form.findcontrol(\"RitornoSceltaOpzioni\"),new dbarray(\"Opzione1\",\"Opzione2\",\"Opzione3\"))<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><strong>ChooseRecords(&lt;postback procedure&gt;,&lt;table&gt;,&lt;title&gt;,&lt;multiple&gt;,&lt;columns format&gt;)<\/strong><span style=\"color: #000000;\">: visualizza una richiesta popup che consente all&#8217;utente di scegliere uno o pi\u00f9 records da una lista. Nel&nbsp;parametro &lt;table&gt; deve essere passato&nbsp;l&#8217;oggetto QWTable contente i records da mostrare. Il parametro &lt;title&gt; (opzionale) contiene il titolo della finestra popup, mentre il parametro &lt;multiple&gt; assegnato a <em>true <\/em>consente la selezione di pi\u00f9 di un record (opzionale, default <em>false<\/em>).<br \/>\nAttraverso il parametro opzionale &lt;columns format&gt; \u00e8 possibile specificare il layout delle colonne da visualizzare, attraverso un array di elementi array con con i seguenti elementi: &lt;nome campo&gt;,&lt;larghezza in pixel&gt;,&lt;intestazione colonna,&lt;formato numerico&gt;. Quest&#8217;ultimo parametro \u00e8 opzionale ed \u00e8 del tipo &#8220;999,999.99&#8221;.<br \/>\n<\/span><\/span><span style=\"color: #993300;\"><span style=\"color: #000000;\">Alla conferma della scelta,&nbsp;viene richiamato l&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt;. All&#8217;interno del codice dell&#8217;evento \u00e8 utilizzabile&nbsp;il parametro&nbsp;<strong>Parameter1<\/strong>&nbsp;al quale viene passato un array contenente i records selezionati, a loro volta costituiti da array contenenti i valori dei campi.<br \/>\n<\/span><\/span><span style=\"color: #000000;\">Esempio di utilizzo:<\/span><br \/>\n<span style=\"color: #000000;\"><em>Attivazione della lista<\/em><\/span><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"visualbasic\">Dim errorMsg As String \r\nDim personale As QWTable \r\npersonale = OpenTable(form, \"SELECT CODICE,NOME FROM PERSON\", Nothing, True, False, errorMsg)\r\n\r\nIf String.IsNullOrEmpty(errorMsg) Then \r\n    form.ChooseRecords(form.findcontrol(\"RitornoChooseRecords\"), personale, \"Scegliere una persona\", False, new DBArray(new DBArray(\"CODICE\",40,\"Codice\"),new DBArray(\"NOME\",200,\"Nome\"))) \r\nElse\r\n    form.Alert(\"Errore: \" &amp; errorMsg) \r\nEnd if\r\n\r\n' Non chiudere la tabella!<\/pre>\n<p><em>Esame dei risultati nell&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;oggetto <strong>RitornoChooseRecords<\/strong><\/em><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">' crea un elenco testuale dei records (codice e nome delle persone)\r\n\r\nDim rows As DBArray = Parameter1\r\nDim columns As DBarray\r\nDim stampa As String = \"\"\r\n\r\nFor i As Integer = 1 To rows.Size\r\n    columns = rows(i)\r\n    stampa = columns(1) &amp; \" \" &amp; columns(2) &amp; \"&lt;br&gt;\"\r\nNext<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>Close()<\/strong><\/span><\/span>: chiude il form senza salvare i dati.<\/li>\n<li><span style=\"color: #993300;\"><strong>Confirm(&lt;postback procedure&gt;,&lt;message&gt;,&lt;title&gt;,&lt;oklabel&gt;,&lt;cancellabel&gt;)<\/strong><span style=\"color: #000000;\">: visualizza una richiesta popup di conferma all&#8217;utente. Il parametro &lt;message&gt; rappresenta il messaggio da visualizzare, &lt;title&gt; (opzionale) il titolo del popup, &lt;oklabel&gt; (opzionale) l&#8217;etichetta del pulsante di conferma, &lt;cancellabel&gt; (opzionale) l&#8217;etichetta del pulsante di rifiuto. In caso di pressione del pulsante di conferma, viene richiamato l&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt;.<br \/>\n<\/span><\/span><span style=\"color: #993300;\"><span style=\"color: #000000;\">Su piattaforma mobile i parametri &lt;title&gt;, &lt;oklabel&gt; e &lt;cancellabel&gt; non sono presenti.<br \/>\n<\/span><\/span>Esempio di utilizzo:<\/p>\n<pre>form.Confirm(form.findcontrol(\"RitornoConferma\"),\"Confermi l'esecuzione della procedura?\",\"Confermare\",\"S\u00ec\",\"No\")<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>ExecuteQuery()<\/strong><\/span><\/span>: valido solo per i form relativi a query SQL. Riesegue la query principale.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>FileDownload(&lt;path&gt;,&lt;name&gt;)<\/strong><\/span><\/span>:&nbsp;esegue il download del file il cui percorso \u00e8 specificato nel parametro &lt;path&gt;. Opzionalmente, \u00e8 possibile specificare nel parametro &lt;name&gt; il nome che dovr\u00e0 avere il file scaricato.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>FilePreview(&lt;path&gt;,&lt;name&gt;)**<\/strong><\/span><\/span>:&nbsp;visualizza l&#8217;anteprima del file il cui percorso \u00e8 specificato nel parametro &lt;path&gt;. Opzionalmente, \u00e8 possibile specificare nel parametro &lt;name&gt; il nome che dovr\u00e0 essere visualizzato nel titolo della pagina di anteprima.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>GetAssigned(&lt;object&gt;)<\/strong><\/span><\/span>: restituisce <em>true<\/em> se l&#8217;oggetto del form passato come parametro ammette solo valori scelti da una lista, ed il valore contenuto al momento risulta scelto dalla lista, <em>false<\/em> altrimenti.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>GetCurrentGPSCoordinates(&lt;postback procedure&gt;)<\/strong><\/span><\/span>: legge la posizione GPS del dispositivo e richiama <span style=\"color: #993300;\"><span style=\"color: #000000;\"><strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt; assegnando a Parameter1 la latitudine e a Parameter2 la longitudine<\/span><\/span><\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>GetDataBase()<\/strong><\/span><\/span>: restituisce l&#8217;oggetto DataBase<\/li>\n<li><strong><span style=\"color: #993300;\">GetDocumentPath()<\/span><\/strong>: restituisce il percorso del documento collegato al form<\/li>\n<li><strong><span style=\"color: #993300;\">GetCategoryID()<\/span><\/strong>: restituisce il codice della categoria documentale<\/li>\n<li><strong><span style=\"color: #993300;\">GetIdDoc()<\/span><\/strong>: restituisce l&#8217;ID del documento (vale sempre &#8220;DW&#8221;)<\/li>\n<li><strong><span style=\"color: #993300;\">GetCodDoc()<\/span><\/strong>: restituisce il codice univoco del documento<\/li>\n<li><span style=\"color: #993300;\"><strong>GetUserCode()<\/strong><\/span>: restituisce il codice dell&#8217;utente nell&#8217;anagrafica<\/li>\n<li><span style=\"color: #993300;\"><strong>GetUserMail()<\/strong><\/span>: restituisce l&#8217;e-mail dell&#8217;utente<\/li>\n<li><span style=\"color: #993300;\"><strong>GetUserName()<\/strong><\/span>: restituisce il nome dell&#8217;utente<\/li>\n<li><span style=\"color: #993300;\"><strong>GetSession()<\/strong><\/span>: restituisce l&#8217;oggetto sessione<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>IsNew()<\/strong><\/span><\/span>: restituisce <em>true<\/em> se \u00e8 in corso la creazione di un nuovo documento\/modulo, <em>false<\/em> se sono caricati i dati di un documento\/modulo gi\u00e0 precedentemente salvato<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>IsPublished()<\/strong><\/span><\/span>: restituisce <em>true<\/em> se il documento\/modulo \u00e8 pubblicato, <em>false<\/em> altrimenti<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>Notification(&lt;message&gt;,&lt;type (optional)&gt;,&lt;auto close (optional)&gt;,&lt;auto close delay msec (optional)&gt;)<\/strong><\/span><\/span>: mostra una notifica all&#8217;utente in basso a destra, visualizzando il testo contenuto nel parametro &lt;message&gt;. Il parametro opzionale &lt;type&gt; consente di definire il tipo di notifica in termini di colore e icona. I possibili valori sono quelli mostrati dalla figura seguente, che illustra anche l&#8217;aspetto.<br \/>\n<a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/Pasted-16.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-27821\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/Pasted-16.png\" alt=\"\" width=\"150\" height=\"290\"><\/a><br \/>\nOpzionalmente, \u00e8 possibile definire la chiusura automatica della notifica dopo un determinato periodo di tempo, assegnando il parametro opzionale &lt;auto close&gt; a <em>true<\/em> e il parametro &lt;auto close delay&gt; al tempo, in millisecondi, trascorso il quale si desidera che la notifica venga chiusa automaticamente.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>ClearNotifications()<\/strong><\/span><\/span>: cancella tutte le notifiche presenti sulla pagina.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>PhoneCall(&lt;number&gt;)<\/strong><\/span><\/span>: consente di effettuare una chiamata telefonica al numero specificato nel parametro &lt;number&gt;. Su piattaforma desktop \u00e8 necessario installare l&#8217;app &#8220;Il mio telefono&#8221; disponibile con Windows 10 versione 20H2 (ottobre 2020).<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>RefreshList(&lt;object&gt;)<\/strong><\/span><\/span>: consente di aggiornare le tendine degli oggetti &#8220;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-casella-a-discesa\/\">Casella a discesa<\/a>&#8221; per i quali nella query specificata nella propriet\u00e0 <strong>QueryLista<\/strong> \u00e8 presente un riferimento all&#8217;oggetto passato nel parametro &lt;object&gt;.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>RefreshLinkdoc()<\/strong><\/span><\/span>: forza l&#8217;aggiornamento del riquadro dei documenti collegati, rileggendo i dati dal database;<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>Save()<\/strong><\/span><\/span>: salva i dati (equivale alla pressione del tasto &#8220;Salva&#8221; o &#8220;Conferma&#8221;).<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetAssigned(&lt;object&gt;,&lt;bool&gt;)<\/strong><\/span><\/span>: consente di marcare l&#8217;oggetto passato nel primo parametro come assegnato se nel secondo parametro viene passato il valore <em>true<\/em>.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetDocumentToLoad(&lt;path&gt;)<\/strong><\/span><\/span>: valido solo per form legati a categorie di tipo &#8220;file&#8221;, permette di definire il file da caricare quando il documento \u00e8 nuovo (form.isNew=true). Non ha effetto se il documento non \u00e8 nuovo.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetEnabled(&lt;object&gt;,&lt;bool&gt;)<\/strong><\/span><\/span>: abilita o disabilita&nbsp;l&#8217;oggetto passato nel primo parametro, in base al valore del secondo parametro. Se&nbsp;<em>true<\/em>&nbsp;abilita, se&nbsp;<em>false<\/em>&nbsp;disabilita.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetFocus(&lt;object&gt;)<\/strong><\/span><\/span>: rende l&#8217;oggetto &lt;object&gt; quello attivo per l&#8217;input<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetNumber()<\/strong><\/span><\/span>: assegna il campo &#8220;numero&#8221; come progressivo in base al campo &#8220;tipo&#8221;<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>SetVisible(&lt;object&gt;,&lt;bool&gt;)<\/strong><\/span><\/span>: visualizza o nasconde l&#8217;oggetto passato nel primo parametro, in base al valore del secondo parametro. Se&nbsp;<em>true<\/em> visualizza, se&nbsp;<em>false<\/em> nasconde.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>ShowOnlyForm()<\/strong><\/span><\/span>: Mostra all&#8217;utente solo il form, sopprimendo i campi relativi al numero e al titolo del documento, e la griglia dei risultati nel caso delle query.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>HideLinkDoc()<\/strong><\/span><\/span>: Nasconde il riquadro dei documenti collegati.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>MinimizeToolbar()<\/strong><\/span><\/span>: Lascia solo la prima linguetta della toolbar.<\/li>\n<li><span style=\"color: #993300;\"><strong>TranslateString(&lt;string&gt;)<\/strong><\/span>: Traduce una stringa nella lingua corrente. La stringa pu\u00f2 essere in una qualsiasi delle lingue supportate, e viene tradotta nella lingua correntemente impostata nell&#8217;interfaccia di QualiWare. La traduzione avviene utilizzando la tabella impostata nella propriet\u00e0 <strong>TraduzioneStringhe<\/strong>.<\/li>\n<li>Esempio di utilizzo:\n<pre>form.alert(form.TranslateString(\"Operazione completata\"))\r\n<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>GetString(&lt;name&gt;,&lt;default (optional)&gt;,&lt;parameter1 (optional)&gt;,&lt;parameter2 (optional)&gt;,<\/strong><\/span><\/span><\/span> <strong style=\"color: #993300;\">&lt;parameter3 (optional)&gt;<\/strong>, <span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>&lt;parameter4 (optional)&gt;)<\/strong><\/span><\/span>: Restituisce la stringa definita nella propriet\u00e0 <strong>TraduzioneStringhe <\/strong>e avente il nome &lt;name&gt;, nella lingua corrente. E&#8217; possibile specificare un default, nel caso la traduzione non sia stata trovata, nel parametro &lt;default&gt;. Nelle stringhe \u00e8 inoltre possibile definire delle sostituzioni con i valori dei parametri opzionali, inserendo i placeholder &#8220;%1&#8221;, &#8220;%2&#8221;, &#8220;%3&#8221;, &#8220;%4&#8221;.<br \/>\nEsempio di utilizzo:<\/p>\n<pre>form.alert(form.GetString(\"lbl001\",\"Operazione completata\"))<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>UpdateContainer(&lt;object&gt;)<\/strong><\/span><\/span>: consente di aggiornare il contenuto di un <a href=\"https:\/\/help.qualiware.it\/qw-help\/fd-contenitore\/\">oggetto contenitore<\/a> che ha la propriet\u00e0 <strong>ContenitoreAggiornamento<\/strong> a <em>true<\/em>. Pu\u00f2 essere richiamato da oggetti che si trovano in altri contenitori che hanno la propriet\u00e0 a <em>true<\/em>, oppure dagli eventi degli oggetti <a href=\"https:\/\/help.qualiware.it\/qw-help\/oggetto-gantt\/\">Gantt<\/a>, <a href=\"https:\/\/help.qualiware.it\/qw-help\/oggetto-calendario\/\">Calendario<\/a> e <a href=\"https:\/\/help.qualiware.it\/qw-help\/oggetto-kanban\/\">Kanban<\/a>. Se il parametro &lt;object&gt; \u00e8 lasciato a Nothing, verr\u00e0 aggiornato l&#8217;intero form. Questo pu\u00f2 essere utile per aggiornare anche il titolo da un evento che \u00e8 attivato da un oggetto all&#8217;interno di un contenitore con la propriet\u00e0&nbsp;<strong>ContenitoreAggiornamento<\/strong> a <em>true.<\/em><\/li>\n<li><span style=\"color: #993300;\"><strong>UploadFile(&lt;postback procedure&gt;,&lt;allowed extensions&gt;,&lt;multiple&gt;)**<\/strong><span style=\"color: #000000;\">: visualizza una maschera per il caricamento di un file sul server. Alla pressione del tasto di conferma viene richiamato l&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt;. Nel parametro opzionale &lt;allowed extensions&gt; \u00e8 possibile specificare le estensioni di file consentite, separate da &#8220;,&#8221; (es.: &#8220;.jpg,.png&#8221;). Il parametro opzionale &lt;multiple&gt; pu\u00f2 essere posto a <em>false&nbsp;<\/em>nel caso si voglia consentire il caricamento di un solo file.<br \/>\nAll&#8217;interno del codice dell&#8217;evento sono utilizzabili il parametro <strong>Parameter1<\/strong>&nbsp;cui viene passato&nbsp;il percorso fisico del file caricato sul server, e il&nbsp;parametro <strong>Parameter2<\/strong> cui viene passato il nome originale del file caricato dall&#8217;utente. Nel caso di caricamento di pi\u00f9 file \u00e8 possibile utilizzare l&#8217;oggetto DBArray restituito nel parametro <strong>ParameterAll<\/strong> per recuperare tutti i percorsi, che vengono assegnati agli indici dispari, e i nomi, che vengono assegnati agli indici pari successivi (es. nell&#8217;elemento ParameterAll(1) \u00e8 contenuto il percorso del file e nell&#8217;elemento ParameterAll(2) il relativo nome, ecc.).<br \/>\n<\/span><\/span>Esempio di utilizzo:<\/p>\n<pre>form.UploadFile(form.findcontrol(\"RitornoUpload\"),\".jpg,.png\")<\/pre>\n<\/li>\n<\/ul>\n<p>Solo Form Desktop :<\/p>\n<ul>\n<li><strong><span style=\"color: #993300;\">AcquireBarcode<\/span>&nbsp;(<span style=\"color: #993300;\">&lt;postback procedure&gt;,<\/span><span style=\"color: #993300;\">&nbsp;&lt;title&gt;)<\/span><\/strong>: consente di acquisire un codice a barre dalla fotocamera. Il codice a barre letto verr\u00e0 restituito come parametro1 alla procedura collegata all&#8217;oggetto indicato nel parametro &lt;postback procedure&gt;.<br \/>\nNel parametro &lt;title&gt; pu\u00f2 essere opzionalmente specificato il titolo da visualizzare nella finestra di acquisizione del codice a barre.<br \/>\nEsempio di utilizzo (da inserire nel codice dell&#8217;evento Click di un pulsante):<\/p>\n<pre>form.AcquireBarcode(form.findcontrol(\"ReadBarcode\"),\"Leggere il codice a barre\")<\/pre>\n<\/li>\n<li><strong><span style=\"color: #993300;\">AcquirePicture<\/span>&nbsp;(<span style=\"color: #993300;\">&lt;postback procedure&gt;,<\/span><span style=\"color: #993300;\"> &lt;format&gt;, &lt;quality&gt;, &lt;title&gt;)<\/span><\/strong>: consente di scattare una foto dalla fotocamera. L&#8217;immagine verr\u00e0 salvata su file il cui percorso verr\u00e0 restituito nella variabile Parameter1 alla procedura collegata all&#8217;oggetto indicato nel parametro &lt;postback procedure&gt;.<br \/>\nNel parametro &lt;format&gt; pu\u00f2 essere opzionalmente specificato il formato del file, che pu\u00f2 essere &#8220;JPG&#8221; o &#8220;PNG&#8221;. Di default \u00e8 &#8220;PNG&#8221;.<br \/>\nNel parametro &lt;quality&gt; pu\u00f2 essere opzionalmente specificata la qualit\u00e0 dell&#8217;immagine, che va da 0 a 100 ed \u00e8 applicabile solo se il formato \u00e8 &#8220;JPG&#8221;. Il valore di default \u00e8 95.<br \/>\nNel parametro &lt;title&gt; pu\u00f2 essere opzionalmente specificato il titolo da visualizzare nella finestra di acquisizione dell&#8217;immagine.<br \/>\nEsempio di utilizzo (da inserire nel codice dell&#8217;evento Click di un pulsante):<\/p>\n<pre>form.AcquirePicture(form.findcontrol(\"ReadPicture\"),\"JPG\",90,\"Scattare una foto\")<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><strong>AcquireSignature(&lt;postback procedure&gt;,&lt;title&gt;,&lt;width&gt;,&lt;height&gt;)<\/strong><\/span>: consente di acquisire una firma scritta a mano visualizzando l&#8217;apposita maschera. La firma acquisita verr\u00e0 salvata su file in formato png il cui percorso verr\u00e0 restituito come parametro1 alla procedura collegata all&#8217;oggetto indicato nel parametro &lt;postback procedure&gt;. Nel parametro &lt;title&gt; \u00e8 possibile specificare un titolo per la finestra di richiesta di firma, mentre nei parametri &lt;width&gt; e &lt;height&gt; ne pu\u00f2 essere specificata rispettivamente la larghezza e l&#8217;altezza in pixel. E&#8217; possibile scaricare un esempio di categoria documentale con la gestione della firma da&nbsp;<a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma\/\">qui<\/a>.<\/li>\n<li><span style=\"color: #993300;\"><strong>AcquireSignatureWACOM(&lt;filename&gt;)<\/strong><\/span>: consente di acquisire tramite i Cloud Components una firma scritta a mano su dispositivo WACOM STU-430 o STU-530. La firma acquisita verr\u00e0 salvata sul server in un file in formato png il cui percorso verr\u00e0 restituito nel parametro &lt;filename&gt;. Viene anche restituito un file con lo stesso nome ma estensione JSON contenente i dettagli della firma, in termini di coordinate e pressione della penna. Da notare che l&#8217;operazione \u00e8 asincrona, e quindi il form dovr\u00e0 prevedere un polling per verificare quando il file sar\u00e0 stato generato. E&#8217; possibile scaricare un esempio di categoria documentale con la gestione della firma da <a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma-da-dispositivo-wacom\/\">qui<\/a>.<\/li>\n<li><span style=\"color: #993300;\"><strong>AcquireDigitalSignature(&lt;filename&gt;,&lt;signPDF&gt;,&lt;signedFilename&gt;,&lt;IdDoc&gt;,&lt;CodDoc&gt;)<\/strong><\/span>: consente di firmare digitalmente il file il cui percorso \u00e8 specificato nel parametro &lt;filename&gt;. Se il formato del file \u00e8 PDF, con il flag &lt;signPDF&gt; \u00e8 possibile specificare se firmare direttamente il PDF o generare un file P7M. Il file risultante verr\u00e0 memorizzato nel percorso specificato nel parametro &lt;signedFilename&gt;, che, se lasciato a nothing, viene assegnato dal metodo. Nel caso si desideri collegare il file firmato ad un documento, \u00e8 possibile specificarne il codice nei parametri &lt;IdDoc&gt; e &lt;CodDoc&gt;. E&#8217; possibile scaricare un esempio di categoria documentale con la gestione della firma digitale qualificata da <a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma-digitale-qualificata\/\">qui<\/a>.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"> <strong>AcquireDigitalSignatureNamirial(<\/strong><\/span><\/span><span style=\"color: #993300;\"><strong>&lt;postback procedure&gt;<\/strong><\/span> <span style=\"color: #993300;\"><strong>,&lt;filename&gt;,&lt;P7MEnvelope&gt;)<\/strong><\/span>: consente di firmare digitalmente, con la f<a href=\"https:\/\/help.qualiware.it\/qw-help\/firma-digitale-qualificata-remota-con-namirial\/\" target=\"_blank\" rel=\"noopener\">irma remota Namirial<\/a>, il file il cui percorso \u00e8 specificato nel parametro &lt;filename&gt;. Al termine del processo di firma, viene eseguito l&#8217;EventoEsegui dell&#8217;oggetto specificato nel parametro &lt;postback procedure&gt;, nel cui parametro Parameter1 \u00e8 contenuto il percorso del file firmato. Se &lt;P7MEnvelope&gt; \u00e8 true, il file viene sempre firmato con la busta P7M (firma CADES). Se \u00e8 false, nel caso in cui il file sia un PDF viene usata la firma PADES, se \u00e8 un XML viene usata la firma XADES. In tutti gli altri casi, viene sempre usata la firma CADES.<\/li>\n<li><span style=\"color: #993300;\"><strong>ChooseOptionMultiple(&lt;postback procedure&gt;,&lt;options array&gt;,&lt;atleastone&gt;)<\/strong><span style=\"color: #000000;\">: visualizza una richiesta popup che consente all&#8217;utente di scegliere fra una o pi\u00f9 fra le opzioni specificate nel parametro &lt;options array&gt;.&nbsp; Se il parametro &lt;alteastone&gt; \u00e8 passato a &#8220;true&#8221;, l&#8217;utente deve scegliere almeno una opzione. In caso di pressione del pulsante di conferma, viene richiamato l&#8217;evento <strong>EventoEsegui<\/strong> dell&#8217;<a href=\"http:\/\/help.qualiware.it\/qw-help\/fd-procedura\/\">oggetto Procedura<\/a> specificato nel parametro &lt;postback procedure&gt;. All&#8217;interno del codice dell&#8217;evento \u00e8 utilizzabile&nbsp;il parametro&nbsp;<strong>Parameter1<\/strong> al quale viene passata una stringa contenente gli indici delle opzioni scelte separate da &#8220;,&#8221;. Tale stringa pu\u00f2 essere trasformata in un DBArray usando la funzione <a href=\"https:\/\/help.qualiware.it\/qw-help\/primitive-di-sistema\/\">String2Array<\/a>.<br \/>\n<\/span><\/span>Esempio di utilizzo:<\/p>\n<pre>form.ChooseOptionMultiple(form.findcontrol(\"RitornoSceltaOpzioni\"),new dbarray(\"Opzione1\",\"Opzione2\",\"Opzione3\"),true)<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>OpenInIFrame(&lt;client&gt;,&lt;URL&gt;)<\/strong><\/span><\/span>: consente l&#8217;apertura della &lt;URL&gt; specificata all&#8217;interno di un IFRAME creato nell&#8217;oggetto client specificato nel primo parametro.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>OpenChatInIFrame(&lt;client&gt;,&lt;IDDoc&gt;,&lt;CodDoc&gt;,&lt;recipients&gt;)<\/strong><\/span><\/span>: consente l&#8217;apertura della chat relativa al documento identificato dai parametri &lt;IDDoc&gt; e &lt;CodDoc&gt; all&#8217;interno di un IFRAME creato nell&#8217;oggetto client specificato nel primo parametro. Il parametro &lt;recipients&gt; di tipo DBArray contiene i codici dei possibili destinatari.<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>OpenLinkDocInIFrame(&lt;client&gt;,&lt;IDDoc&gt;,&lt;CodDoc&gt;,&lt;optional readOnly&gt;,&lt;optional refresh&gt;)<\/strong><\/span><\/span>: consente l&#8217;apertura dei documenti collegati relativi al documento identificato dai parametri &lt;IDDoc&gt; e &lt;CodDoc&gt; all&#8217;interno di un IFRAME creato nell&#8217;oggetto client specificato nel primo parametro. Il parametro opzionale &lt;readOnly&gt;, se assegnato a <em>true<\/em>, consente di inibire la modifica ai documenti collegati, mentre il parametro &lt;refresh&gt;, se assegnato a <em>true<\/em>, consente di aggiornare i collegamenti virtuali.E&#8217; possibile scaricare un esempio di utilizzo dei metodi Open*InIFrame a <a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/TEST-OPENINIFRAME.zip\">qui<\/a>.<\/li>\n<\/ul>\n<p>Solo Form Designer Mobile:<\/p>\n<ul>\n<li><span style=\"color: #993300;\"><strong>AcquirePicture<\/strong><\/span>&nbsp;(<span style=\"color: #993300;\"><strong>&lt;postback button&gt;, &lt;type&gt;,&lt;file name&gt;<\/strong><\/span>): consente di scattare una foto dalla fotocamera o acquisirla dalla&nbsp;galleria. L&#8217;immagine verr\u00e0 inserita nei documenti collegati con il nome specificato.<br \/>\nNel primo parametro pu\u00f2 essere passato un &#8220;oggetto Button&#8221;, il cui ClickEvent sar\u00e0 invocato al momento la conferma della foto. Potrebbe anche essere lasciata a nothing&nbsp;se non \u00e8 richiesto postback. Nel secondo parametro deve essere specificato il tipo di immagine:<br \/>\n1 = bassa risoluzione<br \/>\n2 = media risoluzione<br \/>\n3 = alta risoluzione<br \/>\n4 = altissima&nbsp;risoluzione<br \/>\n5 = Acquisisci&nbsp;dalla galleria<br \/>\nNel terzo parametro pu\u00f2 essere opzionalmente specificato il nome da assegnare al file, che verr\u00e0 mostrato nella finestra dei documento collegati. Pu\u00f2 essere lasciato a nothing o stringa vuota. Esempio di utilizzo (da inserire nel &#8220;Codice EventoClick&#8221; di un tasto):<\/p>\n<pre>form.AcquirePicture(form.findcontrol(\"POSTBACK\"),1,\"picture\")<\/pre>\n<p><span style=\"color: #ff0000;\">N.B. questa versione \u00e8 utilizzabile solo sui form collegati a categorie documentali<\/span><\/li>\n<li><span style=\"color: #993300;\"><strong>AcquirePicture<\/strong><\/span>&nbsp;(<span style=\"color: #993300;\"><strong>&lt;postback procedure&gt;,<\/strong><\/span><span style=\"color: #993300;\"><strong>&nbsp;&lt;type&gt;<\/strong><\/span>): consente di scattare una foto dalla fotocamera o acquisirla dalla&nbsp;galleria. L&#8217;immagine&nbsp;verr\u00e0 salvata su file il cui percorso verr\u00e0 restituito come parametro1 alla procedura collegata all&#8217;oggetto indicato nel parametro &lt;postback procedure&gt;.<br \/>\nNel parametro &lt;type&gt; deve essere specificato il tipo di immagine:<br \/>\n1 = bassa risoluzione<br \/>\n2 = media risoluzione<br \/>\n3 = alta risoluzione<br \/>\n4 = altissima&nbsp;risoluzione<br \/>\n5 = Acquisisci&nbsp;dalla galleriaUn esempio di applicazione di questo metodo \u00e8 disponibile <a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma-o-di-unimmagine-su-piattaforma-mobile\/\">qui<\/a>.<\/li>\n<li><span style=\"color: #993300;\"><strong>AcquireSignature(&lt;postback button&gt;,&lt;default name&gt;)<\/strong><\/span>: consente di acquisire una firma scritta a mano visualizzando l&#8217;apposita maschera. La firma acquisita verr\u00e0 inserita nei documenti collegati come immagine in formato Jpeg. Entrambi i parametri possono essere lasciati a&nbsp;nothing. Nel primo parametro pu\u00f2 essere passato un oggetto di tipo Pulsante, il cui evento Click verr\u00e0 richiamato al momento della conferma della firma. Nel secondo parametro pu\u00f2 essere passato il nome dell&#8217;utente che apporr\u00e0 la firma.<br \/>\nEsempio di utilizzo (da inserire nel codice dell&#8217;evento Click di un pulsante):<\/p>\n<pre>form.AcquireSignature(form.findcontrol(\"POSTBACK\"),\"Pier Alberto Guidotti\")<\/pre>\n<p><span style=\"color: #ff0000;\">N.B. questa versione \u00e8 utilizzabile solo sui form collegati a categorie documentali<\/span><\/li>\n<li><span style=\"color: #993300;\"><strong>AcquireSignature(&lt;postback procedure&gt;,&lt;default name&gt;)<\/strong><\/span>: consente di acquisire una firma scritta a mano visualizzando l&#8217;apposita maschera. La firma acquisita verr\u00e0 salvata su file in formato png il cui percorso verr\u00e0 restituito come parametro1 alla procedura collegata all&#8217;oggetto indicato nel parametro &lt;postback procedure&gt;. Nel parametro &lt;default name&gt; \u00e8 possibile specificare il nome di default della persona che effettuer\u00e0 la firma. E&#8217; possibile scaricare un esempio di categoria documentale con la gestione della firma su dispositivo mobile da&nbsp;<a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma\/\">qui<\/a>. Un esempio di form \u00e8 inoltre disponibile&nbsp;<a href=\"http:\/\/help.qualiware.it\/qw-help\/esempio-di-form-per-lacquisizione-di-una-firma-o-di-unimmagine-su-piattaforma-mobile\/\">qui<\/a>.<\/li>\n<li><span style=\"color: #993300;\"><strong>AddStyle(&lt;stylename&gt;,&lt;styledefinition&gt;)<\/strong><\/span>: consente di aggiungere uno stile CSS che potr\u00e0 essere assegnato agli oggetti. Di seguito un esempio di utilizzo:\n<pre>form.AddStyle(\".Critical\",\"background-color:red !important\")<\/pre>\n<\/li>\n<\/ul>\n<h4 align=\"left\"><a name=\"eventi_form\"><\/a>Metodi utilizzabili da codice lato Client (Javascript)<\/h4>\n<ul>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.alert(&lt;text&gt;,&lt;title&gt;)<\/strong><\/span>: consente di visualizzare una finestra popup che mostra il testo e il titolo passati come parametro<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.confirm(&lt;text&gt;, &lt;title&gt;, &lt;okLabel&gt;, &lt;okCallBack&gt;, &lt;cancelLabel&gt;, &lt;cancelCallBack&gt;)<\/strong><span style=\"color: #000000;\">: visualizza una richiesta popup di conferma all&#8217;utente. Il parametro &lt;text&gt; rappresenta il messaggio da visualizzare, &lt;title&gt; il titolo del popup, &lt;okLabel&gt; l&#8217;etichetta del pulsante di conferma, &lt;cancelLabel&gt; l&#8217;etichetta del pulsante di rifiuto. In caso di pressione del pulsante di conferma, viene eseguita la funzione specificata nel parametro &lt;okCallBack&gt;, mentre in caso di pressione del tasto di annullamento viene eseguita la funzione specificata nel parametro &lt;cancelCallBack&gt;, che \u00e8 opzionale.<br \/>\n<\/span><\/span>Esempio di utilizzo di &#8220;alert&#8221; e &#8220;confirm&#8221;:<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"js\">$.QualiWare.confirm(\"Confermi?\",\"Confermare\",\"Confermo\",function() {\r\n\t$.QualiWare.alert(\"Confermato\",\"Attenzione\")\r\n},\r\n\"Non confermo\")\r\n<\/pre>\n<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.executeQuery(&lt;sql&gt;, &lt;callback&gt;)<\/strong><span style=\"color: #000000;\">: esegue in modo asincrono la query contenuta nel parametro &lt;sql&gt; e, ad esecuzione completata, richiama la funzione contenuta nel parametro &lt;callback&gt; restituendo nel parametro &lt;data&gt; l&#8217;array dei record ritornati e nel parametro &lt;error&gt; l&#8217;eventuale messaggio d&#8217;errore.<br \/>\nEsempio:<br \/>\n<\/span><\/span><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"js\">$.QualiWare.executeQuery('Select * from ENTI',\r\n\t\t\t\tfunction(data,error) {\r\n\t\t\t\t\tif (error) \r\n\t\t\t\t\t    $.QualiWare.alert(error,\"Errore\")\r\n\t\t\t\t\telse\r\n\t\t\t\t\t    $('#&lt;oggetto&gt;').setValue(data[0][\"CODICE\"])\r\n\t\t\t\t}\r\n)<\/pre>\n<p>NOTA: la query deve essere preventivamente abilitata nell&#8217;EventoCarica del form utilizzando il metodo <strong>AllowClientQuery<\/strong> dell&#8217;oggetto <strong>QWSession<\/strong>. Dal momento che la query stessa pu\u00f2 essere modificata dinamicamente nell&#8217;evento Javascript, ad esempio aggiungendo i filtri nella clausola WHERE, non \u00e8 necessario specificarla completamente nel parametro &lt;query&gt; del metodo, ma \u00e8 sufficiente inserire la parte costante, ad esempio la parte SELECT.<br \/>\nEsempio:<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"visualbasic\">form.GetSession().AllowClientQuery(\"Select RAGSOC from CLIFOR\")<\/pre>\n<p>&nbsp;<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.getUserCode()<\/strong><\/span>: restituisce le iniziali dell&#8217;utente<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.getUserName()<\/strong><\/span>: restituisce il nome dell&#8217;utente<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.setFocus<\/strong><\/span><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>(&lt;object&gt;)<\/strong><\/span><\/span>: rende l&#8217;oggetto &lt;object&gt; quello attivo per l&#8217;input<\/li>\n<li><span style=\"color: #993300;\"><span style=\"color: #993300;\"><strong>$.QualiWare.Notification(&lt;message&gt;,&lt;type (optional)&gt;,&lt;auto close (optional)&gt;,&lt;auto close delay msec (optional)&gt;)<\/strong><\/span><\/span>: mostra una notifica all&#8217;utente in basso a destra, visualizzando il testo contenuto nel parametro &lt;message&gt;. Il parametro opzionale &lt;type&gt; consente di definire il tipo di notifica in termini di colore e icona. I possibili valori sono quelli mostrati dalla figura seguente, che illustra anche l&#8217;aspetto.<br \/>\n<a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/Pasted-16.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-27821\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/Pasted-16.png\" alt=\"\" width=\"150\" height=\"290\"><\/a><br \/>\nOpzionalmente, \u00e8 possibile definire la chiusura automatica della notifica dopo un determinato periodo di tempo, assegnando il parametro opzionale &lt;auto close&gt; a <em>true<\/em> e il parametro &lt;auto close delay&gt; al tempo, in millisecondi, trascorso il quale si desidera che la notifica venga chiusa automaticamente.<\/li>\n<li><span style=\"color: #993300;\"><strong>$.QualiWare.ClearNotifications()<\/strong><\/span>: cancella tutte le notifiche presenti sulla pagina.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Descrizione Il Form \u00e8 un oggetto che contiene altri oggetti. Propriet\u00e0 Specifiche Oltre alle propriet\u00e0 comuni sono disponibili le seguenti propriet\u00e0: AdattaAlloSpazio: Se impostata a True, consente di adattare la dimensione del form allo spazio a disposizione nel browser anzich\u00e8 mantenere la dimensione impostata nel designer e ingrandire il form stesso il pi\u00f9 possibile effettuando&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[6],"tags":[],"acf":[],"_links":{"self":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/22812"}],"collection":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/comments?post=22812"}],"version-history":[{"count":31,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/22812\/revisions"}],"predecessor-version":[{"id":38446,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/22812\/revisions\/38446"}],"wp:attachment":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/media?parent=22812"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/categories?post=22812"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/tags?post=22812"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}