Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-1) was last changed on 28-Aug-2023 11:25 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 added 191 lines
%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
NOTA la versione precedente è la LOBASE_340\\
La documentazione del membro LOBASE_340 NON è aggiornata.\\
\\
!! Logica per la ricerca delle icone\\
La directory che contiene le icone di Loocup risiede sul filesystem e si chiama LOOCUP_ICO.\\
Con l'installazione di Loocup questa cartella viene creata all'interno della cartella di installazione di Loocup.\\
\\
Quando viene chiesta l'icona di un oggetto Loocup utilizza il seguente meccanismo per reperire la posizone della cartella LOOCUP_ICO:\\
1) se nel setup è definito l'elemento Path con attributo uguale a ICO (XPATH=Setup/Program/BAS/Paths/Path[@Cod='ICO']) viene utilizzato l'attributo Value.\\
2) Se nel path indicato dall'attributo Value non c'è la cartella LOOCUP_ICO, viene ricercata nella cartella che contiene la cartella di installazione di loocup, la cartella LOOCUP_ICO/AMBIENTE.\\
3) Se non esiste la cartella al punto 2, si passa alla cartella di default.\\
\\
Una volta identificata la posizone della cartella LOOCUP_ICO, come per la ricerca delle immagini, viene fatta una ricerca per risalita di tipo/parametro/codice all'interno della cartella LOOCUP_ICO, in modo da individuare il file fisico che contiene l'icona da usare.\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_099.png' caption='cartella delle icone nel file system' width='100%' style='max-width: 100%;'}]\\
\\
* Looc.up è installato nella directory LOOCUP, nell'esempio specifico C:/PROGRAMMI/LOOCUP.\\
* La directory di installazione LOOCUP contiene la directory LOOCUP_ICO che contiene le icone di default. Questa directory viene creata durante l'installazione iniziale di Loocup.\\
\\
\\
!! Forzatura Path di Icone da Sme.Up\\
E' possibile forzare la directory base delle icone di LoocUp attraverso gli script di configurazione di Loocup (file SCP_SET).\\
La dichiarazione della variabile ICO, mediante il tag C.PAT, attributo Value consente di forzare la cartella delle icone.\\
Qui di seguito vediamo il frammento di script:\\
C.SEZ Cod="Path"\\
C.PAT Cod="ICO" Txt="Icone" Type="TREE" Value="PERCORSO_IMG"\\
Il percorso può essere relativo o assoluto. Nel primo caso va concepito a partire dalla directory di installazione di LoocUp.\\
\\
!! Caratteri non consentiti nei path\\
Qualora gli identificativi dell'oggetto di cui si sta ricercando l'icona contengano caratteri non consentiti in un percorso di file system, tali caratteri andranno sostituiti con il carattere meno (-). Quindi l'icona dell'oggetto di tipo ** sarà contenuto nella cartella --. Gli oggetti di tipo OJ-*USRPRF avranno le loro icone nella cartella -USRPRF contenuta nella cartella OJ.\\
\\
\\
!! Casi particolari\\
Se viene ricercata l'icona dell'oggetto TA, *CNTT; XX, ci si riconduce alla ricerca dell'icona dell'oggetto (XX; ; )\\
Se viene ricercata l'icona dell'oggetto (OG, OG, XX) o dell'oggetto (OG, ; XX) ci si riconduce alla ricerca dell'icona dell'oggetto (XX; ; )\\
Se viene ricercata l'icona dell'oggetto (OG, XX, YY) ci si riconduce alla ricerca dell'icona dell'oggetto (XX, YY, )\\
\\
\\
!! Meccanismo di ricerca delle icone\\
Ogni oggetto, comando e azione può avere icone specifiche o generiche definite da tipo/parametro/codice di appartenenza.\\
Se l'icona dell'oggetto (tipo/parametro/codice) così definita non è presente sul filesystem interviene la logica di risalita, che permette la ricerca di icone più generiche come l'icona dell'istanza (tipo/parametro) o l'icona ancora più generica della classe (tipo).\\
Si andrà quindi a ricercare l'icona rispettando il seguente ordine:\\
* LOOCUP_ICO/tipo/parametro/codice.PNG/GIF ( icona specifica)\\
* LOOCUP_ICO/tipo/parametro/default.PNG/GIF (icona generica)\\
* LOOCUP_ICO/tipo/codice.PNG/GIF (icona specifica)\\
* LOOCUP_ICO/tipo/default.PNG/GIF (icona generica)\\
* LOOCUP_ICO/default.PNG/GIF (icona generica)\\
\\
__NOTA 1__ : Il modulo grafico (SMETRAY) non visualizza l'icona di default generica. Il modulo base (LOOCUO.JAR) la utilizza. Questa è però costituita da un'immagine di 16x16 trasparente. E' stata operata questa scelta per uniformità grafica e per evitare interventi sul codice.\\
\\
__NOTA 2__: al codice viene trimmato, pertanto, eventuali spazi a sinistra vengono eliminati.\\
\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_098.png' caption='visualizzazione icona CN;; CN;CLI; e CN;CLI;001 nel filesystem e nella scheda' width='100%' style='max-width: 100%;'}]\\
Nell'esempio in figura possiamo notare dove sono posizionate le icone nel filesystem (in alto) e la loro visualizzazione nel componente albero della scheda (in basso). In particolare notiamo l'icona specifica assegnata all'oggetto CN;CLI;001 (recuperata dal filesystem nel percorso LOOCUP_ICO\CN\CLI\001.gif, vedi etichetta (1) ) e l'icona generica dell'oggetto CN;CLI;005 (non trovata nel filesystem l'icona specifica nel percorso LOOCUP_ICO\CN\CLI\005.gif viene recuperata l'icona generica nel percorso LOOCUP_ICO\CN\CLI\default.gif, vedi etichetta (2) ).\\
\\
!! Schemi di ricerca delle icone\\
Di seguito vediamo gli schemi per identificare l'icona di un oggetto\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_120.png' caption='Identificazione cartella Icone' width='100%' style='max-width: 100%;'}]\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_121.png' caption='Ricerca icona, casi particolari - OG;OG;XX - OG;;XX - OG;XX;YYY - TA;*CNTT;XX' width='100%' style='max-width: 100%;'}]\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_121.png' caption='Ricerca icona di oggetto generico' width='100%' style='max-width: 100%;'}]\\
%%quote
Nei casi particolari delle icone di programma (come per esempio l'icona di Microsoft Word, Microsoft Office ...) l'icona viene richiesta direttamente al sistema operativo e non è quindi inclusa in nessun percorso di Loocup.
/%
----
\\
\\
!! Tipi di icone -- TODO Validare\\
Le icone in Loocup possono rappresentare:\\
* oggetti\\
* funzioni (verbo/azione)\\
* comandi\\
\\
Le icone-oggetto sono catalogate nelle diverse classi note di Smeup (AR per gli articoli, CN per i contatti ...).\\
Le icone-funzione sono icone che rappresentano azioni generiche, che non sono associate ad un oggetto specifico. Ad esempio l'azione "taglia", l'azione "copia" generica.\\
Le icone-comando sono icone che rappresentano comandi, ovvero azioni riferite ad un oggetto specifico. Ad esempio l'icona "copia testo" dovrà essere diversa dall'icona "copia cliente" poichè è differente l'oggetto a cui è riferita l'azione, e differente quindi il comando. Queste icone sono catalogate con tipo __J1__ e parametro __KEY__.\\
\\
\\
!! Le icone nei componenti\\
In alcuni componenti di Loocup è possibile visualizzare icone specifiche e generiche dell'oggetto come descritto. Inoltre, in alternativa, su alcuni componenti è anche possibile visualizzare delle icone differenti da quelle standard, semplicemente definendo nell'attributo __i="..."__ del nodo dell'xml a cui appartiene l'oggetto, l'azione o il comando un percorso specifico dal quale attingere l'icona.\\
\\
! I bottoni\\
Nel componente bottone è possibile visualizzare icone oggetto in vari modi.\\
L'icona può dipendere esclusivamente dall'oggetto a cui fa riferimento il bottone: in questo caso l'xml del componente bottone vengono assegnati gli attributi tipo, parametro e codice dai quali è possibile risalire all'icona visualizzata.\\
...\\
<Oggetto Nome="Bottone" Tipo="CN" Parametro="CLI" Codice="" Testo="Bottone" />\\
...\\
\\
In alternativa è possibile assegnare altre icone al componente assegnando all'attributo i='...' valori differenti. Le icone possono essere:\\
* icone dirette (es. : con i="M1")\\
* riferite ad oggetti (es. : con i="CN;CLI;001")\\
* specificando il pathfile (es. : con Tipo="J1" Parametro="PATHFILE" e i="[*ICON_PATH]\Verde.gif")\\
\\
...\\
<Oggetto Tipo="" Parametro="" Codice="" Testo="" i="M1" />\\
...\\
<Oggetto Tipo="" Parametro="" Codice="" Testo="" i="CN;CLI;001" />\\
...\\
<Oggetto Tipo="J1" Parametro="PATHFILE" Codice="" Testo="" i="[*ICON_PATH]\Verde.gif" />\\
...\\
\\
! L'albero\\
Nel componente albero è possibile visualizzare icone generiche, icone oggetto o icone specifiche valorizzando nel setup l'attributo __icone='...'__ con i seguenti valori:\\
* __icone="no"__ per visualizzare le icone generiche dei nodi (la cartella per i nodi con figli, il punto per i nodi foglia senza figli)\\
* __icone="yes"__ per visualizzare le icone oggetto che dipendono dal tipo, parametro e codice del nodo\\
* __icone="specific"__ per visualizzare solo le icone specificate nell'attributo __i='...'__ (vedi di seguito)\\
\\
Nell'xml del componente albero vengono assegnati gli attributi tipo, parametro e codice dai quali è possibile risalire all'icona visualizzata.\\
<Oggetto>\\
...\\
<Oggetto Tipo="CN" Parametro="CLI" Codice="001" Testo="Cliente" />\\
...\\
</Oggetto>\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_096.png' caption='esempio icone oggetto nell'albero' width='100%' style='max-width: 100%;'}]\\
In alternativa è possibile assegnare altre icone al componente assegnando all'attributo i='...' valori differenti. Le icone possono essere:\\
* icone dirette (es. : con i="M1")\\
* riferite ad oggetti (es. : con i="CN;CLI;001")\\
* specificando il pathfile (es. : con Tipo="J1" Parametro="PATHFILE" e i="[*ICON_PATH]\Verde.gif")\\
\\
<Oggetto>\\
...\\
<Oggetto Tipo="" Parametro="" Codice="" Testo="Cliente" i="M1" />\\
<Oggetto Tipo="" Parametro="" Codice="" Testo="Cliente" i="CN;CLI;001" />\\
<Oggetto Tipo="J1" Parametro="PATHFILE" Codice="" Testo="Cliente" i="[*ICON_PATH]\Verde.gif" />\\
...\\
</Oggetto>\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_097.png' caption='esempio icone specifiche nell'albero' width='100%' style='max-width: 100%;'}]\\
! La matrice\\
Nel componente matrice è possibile visualizzare icone oggetto sull'intestazione o nella cella con i seguenti valori:\\
* __iconeTesta="no"__ per non visualizzare le icone oggetto nell'intestazione\\
* __iconeTesta="yes"__ per visualizzare le icone oggetto nell'intestazione\\
* __icone="no"__ per non visualizzare le icone oggetto nella cella\\
* __icone="yes"__ per visualizzare le icone oggetto nella cella\\
\\
Per visualizzare un'__icona sull'intestazione__ della matrice è sufficiente assegnare all'attributo oggetto (ogg) della colonna l'oggetto a cui è riferita la colonna. Ad esempio per visualizzare nell'intestazione della colonna l'icona con tipo="CN" e parametro="CLI" è sufficiente scrivere nell'xml Ogg="CNCLI", come segue:\\
<Griglia>\\
...\\
<Colonna Cod="ID colonna" Txt="Descrizione colonna" Tip="" Lun="3" IO="O" Ogg="CNCLI" />\\
...\\
</Griglia>\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_100.png' caption='esempio matrice con colonna oggettizzata' width='100%' style='max-width: 100%;'}]\\
Per visualizzare un'__icona nella cella__ della matrice è sufficiente assegnare all'attributo oggetto (ogg) della colonna il codice della colonna che specifica l'icona tra parentesi quadre ed eventualmente il tipo e/o parametro comuni a tutte le celle della colonna.\\
Ad esempio per visualizzare nelle celle della seconda colonna le icone ;; CN;; CN;CLI; AR;; e AR;ART; è sufficiente scrivere nell'xml Ogg="[ID1]", e nelle celle della colonna con codice ID1 specificare gli oggetti per ogni singola riga come segue:\\
<Griglia>\\
<Colonna Cod="ID1" Txt="colonna1" Tip="" Lun="3" IO="O" Ogg="" />\\
<Colonna Cod="ID2" Txt="colonna2" Tip="" Lun="15" IO="O" Ogg="[ID1]" />\\
</Griglia>\\
<Righe>\\
...\\
<Riga Fld="|00001"/>\\
<Riga Fld="CN|00001"/>\\
<Riga Fld="CNCLI|00001"/>\\
<Riga Fld="AR|00001"/>\\
<Riga Fld="ARART|00001"/>\\
...\\
</Righe>\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_101.png' caption='esempio matrice con cella oggettizzata e tipo colonna eterogeneo' width='100%' style='max-width: 100%;'}]\\
Nel caso in cui le celle della colonna siano di uno stesso tipo, ad esempio CN;; CN;CLI; e CN;COL; , è sufficiente scrivere nell'xml Ogg="CN[ID1]", e nelle celle della colonna con codice ID1 specificare i parametri di ogni singola riga come segue:\\
<Griglia>\\
<Colonna Cod="ID1" Txt="colonna1" Tip="" Lun="3" IO="O" Ogg="" />\\
<Colonna Cod="ID2" Txt="colonna2" Tip="" Lun="15" IO="O" Ogg="CN[ID1]" />\\
</Griglia>\\
<Righe>\\
...\\
<Riga Fld="|00001"/>\\
<Riga Fld="CLI|00001"/>\\
<Riga Fld="COL|00001"/>\\
...\\
</Righe>\\
\\
[{Image src='immagini/MBDOC-LOBASE_07/LOBASE_102.png' caption='esempio matrice con cella oggettizzata e tipo colonna omogeneo' width='100%' style='max-width: 100%;'}]\\
!! Le icone dei componenti Java\\
I componenti Java, utilizzano delle icone che sono incluse nel file Loocup.jar.\\
La modifica delle icone è possibile solamente passando attraverso l'IDE Eclipse.\\
\\
! Classificazione delle icone\\
I componenti java, utilizzano due tipi di icone: quelle per i pulsanti/toolbar e quelle di altro tipo.\\
\\
Passiamo ad analizzare componente per componente le icone utilizzate\\
\\
This page has only one version
«