Visualizza wikitesto di Esempio di personalizzazione dell'anagrafica clienti e fornitori

{{Livello2}} 
SIGLA<sup>®</sup> consente di operare l’aggiunta di campi di input su alcune delle finestre di dialogo gestite. I campi di input aggiuntivi possono essere ''normali'' (la  gestione della  memorizzazione e del recupero dal database sono in questo caso interamente demandate a funzioni personalizzate) o ''automatici''.

I campi automatici consentono di operare delle aggiunte di informazione che vengono automaticamente memorizzate e recuperate nelle tabelle del database. 

L’operazione avviene definendo in un file ASCII, il cui nome varia in funzione della finestra che si desidera personalizzare, un insieme di  istruzioni in grado di descrivere i campi da aggiungere.

{{Dettagli|Personalizzazione_delle_finestre|Personalizzazione delle finestre}}
<br>
Supponendo, ad esempio, di voler aggiungere tre campi ''automatici'' (una data, un numero e un testo) all'[[Anagrafica_clienti_e_fornitori|anagrafica dei clienti e fornitori]], è necessario generare con un comune editor, come il ''Blocco note'', il file '''ASCII CLIFOR.USR''' definito come segue:
{{#modcontinuo:
; definizione della label del Folder Aggiuntivo
LNote
; definizione di un riquadro nel Folder Aggiuntivo
A02025009
; definizione delle didascalie
T0303Data
T0305Importo
T0307Descrizione
; definizione dei campi d’immissione
DD08020031USR0001
DN13220051USR0002
DT20020071USR0004    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|3||}}
Il file '''CLIFOR.USR''' deve essere posizionato nella cartella di installazione di SIGLA<sup>®</sup>.
{{vedi nota|Dp-accept|I nomi dei campi '''devono''' lunghi 11 caratteri, quindi nel file devono essere scritti con spazi bianchi di riempimento a destra fino al raggiungimento di tale lunghezza.}}
<br>
La struttura della tabella ''CLIFOR'' nel [http://en.wikipedia.org/wiki/Database database] dei dati aziendali deve essere ovviamente modificata con l'aggiunta dei tre campi
* {{Fixed|USRDATA char(8)}}
* {{Fixed|USRIMPORTO numeric}}
* {{Fixed|USRDESCR char(20)}} 

Questa operazione può essere effettuata attraverso gli appositi strumenti di amministrazione messi a disposizione dai vari [http://en.wikipedia.org/wiki/Database database] manager e, per la fase di creazione delle tabelle attraverso il programma di [[Archivi_di_base#Men.C3.B9_Applicazione|Configurazione]] implementando la funzione [[SIGLAPPCreateDitta]].

La figura '''1''' mostra come si presenta usualmente la finestra di dialogo senza alcuna personalizzazione.<br>
[[Image:Dp-anaclifor1.png|thumb|center|775x503px|Figura '''1''': Anagrafica cliente/fornitore/prospect]]
La figura '''2''' invece mostra l'aspetto della stessa finestra con la personalizzazione.<br> 
[[Image:Dp-panaclifor1.jpg|thumb|center|787x503px|Figura '''2''': Pagina ''Note'' nell'anagrafica cliente/fornitore/prospect]]

All'interno dell'anagrafica è stata aggiunta una nuova pagina denominata ''Note'', nella quale sono contenuti i dati aggiuntivi richiesti (data, importo e descrizione).

I nuovi campi inseriti sono abilitati all'input da parte dall’utente e, in quanto campi ''automatici'', la gestione memorizzazione delle informazioni è gestita da SIGLA<sup>®</sup>.<br>
In fase di salvataggio di un record le informazioni inserite nei campi a video sono memorizzate nei campi aggiuntivi precedentemente inseriti nella tabella ''CLIFOR''.<br>
In fase di consultazione di un record esistente le informazioni mostrate a video sono automaticamente reperite da tali campi.

Fino a questo punto tutte le operazioni di personalizzazione sono state completate senza la scrittura di codice, le successive fasi invece fasi prevedono la scrittura di codice per l'utilizzo della libreria [[Libreria_SIGPPDLL|SIGPPDLL]]/[[Libreria_SPPFrame|SPPFrame]].

Supponendo di voler aggiungere un controllo sul campo '''Data''' in modo da verificarne la validità, si deve intervenire implementando la funzione [[SIGLAPPSaveObject]], come mostrato nel seguito (nell'esempio si prevede di eseguire il controllo attraverso una specifica funzione realizzata in una [http://it.wikipedia.org/wiki/Dynamic-link_library DLL] aggiuntiva chiamata '''custom.dll''', caricata nella [[SIGLAPPStart|SIGLAPPStart]], inizializzata nella [[SIGLAPPInit|SIGLAPPInit]] e rilasciata nella [[SIGLAPPStop|SIGLAPPStop]]).
{{#modcontinuo:
BOOL DLLCALL SIGLAPPSaveObject(DPObject *theObject,int theActionID)
{
  DPUsrFld *param;
  char buffer[128];

  if(theActionID==-1000)
  {
    param=(DPUsrFld *) theObject;

    // controlla il nome della finestra
    if(strcmp(param->videoname,”CLIFOR”)==0)
    {
      switch(param->actualfld)
      {
        // controlla il campo 0 (data)
        case 0:
          // torna FALSE se la data non è valida
          {
            int ret;
            int (FAR PASCAL *ValidateDate) (LPSTR xdate);
            FARPROC pp;

            if(customdll>HINSTANCE_ERROR)
            {
              pp=GetProcAddress(customdll,"VALIDATEDATE");
              if(pp!=NULL)
              {
                // il controllo di validità della data viene eseguito
                // da una funzione della libreria custom.dll
                strcpy(buffer,param->usrfld[0]);
                ValidateDate=(void (FAR PASCAL *)()) pp;
                ret=(*ValidateDate)(buffer);

                if(ret==0) {
                  // la data è valida e viene copiata in usrfld[0] in
                  // modo da essere aggiornata a video
                  strcpy(param->usrfld[0],buffer);
                  return(TRUE);
                }
                else return(FALSE);
              }
            }
          }
       }
    }
    return TRUE;
}
|1||}}
<br>
{{vedi nota|Dp-edit|Le chiamate con {{Fixed|actionid}} -1000 possono essere attivate anche per [[Libreria_SPPFrame|SPPFrame]] ed intercettate nella funzione {{Fixed|SPPFrameIntSaveObject}} della libreria [[Libreria_SPPFrOld|SPPFrOld]]. Per l'attivazione è necessario implementare l'{{Fixed|actionid}} -999 nella funzione [[SPPFrameIntSaveObject|SPPFrameIntSaveObject]] in maniera che il valore di ritorno della funzione sia {{Fixed|False}}. 
Se non si implementa l'{{Fixed|actionid}} -999 per la [[SPPFrameIntSaveObject|SPPFrameIntSaveObject]] o se il ritorno è {{Fixed|True}} le successive uscite -1000 continueranno ad essere indirizzate alla SIGPPDLL.DLL.}}
<br>
Le informazioni personalizzate aggiunte alla finestra di dialogo dell'[[Anagrafica_clienti_e_fornitori|anagrafica dei clienti e fornitori]] possono essere utilizzate anche in altre parti della procedura come, ad esempio, la stampa di una bolla.

Configurando il '''CAMPO PERSONALIZZATO SU CLIFOR''' durante la fase di impostazione del fincato del documento per le [[Configuratore_moduli_di_stampa#Costruzione_di_un_fincato_di_stampa_testo|stampe testo]], oppure accedendo alla pagina ''Controllo'' e selezionando l'opzione '''CLIFOR''' per le stampe grafiche (vedi figure '''3''' e '''4''' sotto) è possibile esporre in stampa anche queste informazioni aggiunte alla tabella ''CLIFOR''.
<br>
[[Image:Dp-panaclifor2.png|thumb|center|786x503px|Figura '''3''': Campo personalizzato su CLIFOR - stampa testo]]<br>
[[Image:Dp-panaclifor3.jpg|thumb|center|859x351px|Figura '''4''': Disegno stampa grafica]]<br>

== Bibliografia ==
*[http://en.wikipedia.org/wiki/Database Database] 
*[http://it.wikipedia.org/wiki/Dynamic-link_library DLL]

== Voci correlate ==
[[Anagrafica_clienti_e_fornitori|anagrafica dei clienti e fornitori]]<br>
[[Come_si_personalizza_SIGLA|Come si personalizza SIGLA]]<br>
[[Archivi_di_base#Men.C3.B9_Applicazione|Configurazione]]<br> 
[[Libreria_SIGPPDLL|La libreria SIGPPDLL]]<br>
[[Libreria_SPPFrame|La libreria SPPFrame]]<br>
[[Personalizzazione_delle_finestre|Personalizzazione delle finestre]]<br>
[[SIGLAPPCreateDitta]]
[[Configuratore_moduli_di_stampa#Costruzione_di_un_fincato_di_stampa_testo|Stampe testo]]

{{Portale|Come personalizzare SIGLA}}

[[Categoria:Personalizzazioni]]
[[Categoria:Libreria SIGPPDLL]]
[[Categoria:Libreria SPPFrame]]
[[Categoria:Configurazione]]
[[Categoria:Gestione documenti]]
{{Pubblicazione|PUBBLICARE}}