Appunti sulla libreria UtenzeV2 di JSup (Bozza)

[JSup Application properties|Proprietà dell'applicazione] definibili:

  • UtenzeV2.itemFirstAddress: usato da utNumeroUtenza( TagRef statusWord ) per stabilire il nr. di utenza in base all'indirizzo.
  • UtenzeV2.itemNameLeadings: elenco separato da virgole che elenca i prefissi dei tag relativi alle utenze che vanno tolti per identificare il nome dell'utenza in base al nome del tag.
  • UtenzeV2.itemNameTrailings: elenco separato da virgole che elenca i suffissi dei tag relativi alle utenze che vanno tolti per identificare il nome dell'utenza in base al nome del tag.
  • UtenzeV2.desiredManAnaSteps: numero di incrementi desiderati tra il minimo e il massimo valore di una variabile quando si utilizza uno spinner per stabilire il passo dell'incremento, default 30. Può essere sovrascritto per un tag particolare dalla proprietà ana.step.
  • UtenzeV2.spaceBetweenLettersAndNumber: se true viene aggiunto uno spazio, nel nome delle utenze (itemNameFixes()), per separare le lettere e i numeri.
  • UtenzeV2.prodotto.alpha: specifica la percentuale di opacità del prodotto nei sili.


Proprietà dei tag relativi alle utenze (definiti solitamente nelle [JSup Tag classes|tag class]):

  • item: item dell'utenza, se non può essere ricavata dal nome del tag.
  • itemType: nome del tipo di utenza; per esempio: valvola, motore, termoresistenza, ecc.
  • automan.secGroup: specifica il gruppo di sicurezza ulteriore che cui l'utente deve appartenere per il comando manuale (forzatura) dell'utenza (oltre a quello predefinito).
  • securityGroup: usato utSecurityGroup() per specificare il gruppo di sicurezza associato ad un tag, se non specificato viene ricercata la medesima proprietà nel gruppo allarmi associato al tag.
  • autoMan-type: id numerico del tipo di utenza (da documentare)
  • autoMan-off: descrizione dello stato off corrispondente al valore 1 della word di stato; per esempio: Spento, Chiusa, Fermo
  • autoMan-on: descrizione dello stato on corrispondente al valore 2 della word di stato; per esempio: In marcia, Aperta, Attivo
  • autoMan-ind: descrizione dello stato on indietro corrispondente al valore 3 della word di stato; per esempio: Marcia indietro, //
  • genre: valori "male/female" per specificare il genere del tipo di utenza per dialoghi e messaggi vari.
  • autoMan-disabled: se impostato a 1 viene disabilitato il controllo manuale (o forzatura) dell'utenza.

Per le valvole a tre vie:

  • direzione.off: descrizione della direzione della valvola quando non è comandata; per esempio: dritta, verso raffreddamento, ricircolo.
  • direzione.on: descrizione della direzione della valvola quando è comandata; per esempio: deviata, verso riscaldamento, dosaggio.
  • valvolaBistabile: se 1 indica che si tratta di una valvola bistabile, in questo caso viene interpretato anche il bit di comando_ind del tag, per specificare il comando indietro.


Segnali digitali:

  • description: descrizione generica per tooltip
  • offTooltip: descrizione per tooltip specifica quando il segnale è off
  • onTooltip: descrizione per tooltip specifica quando il segnale è on


Tag analogici:

  • description: descrizione per tooltip
  • typeOfMeasure: tipo di misura; per esempio: temperatura, pressione, ecc.
  • output.format: formato numero da usare per visualizzare la misura (per specificare quante cifre decimali); per esempio: #,##0.0
  • where: descrizione della collocazione della misura per tooltip bargraph.
  • prodotto.colore: usabile per specificare il colore del prodotto nell'animazione di un silo.
  • ana.0: indica il valore da considerare come, ad esempio, silo vuoto al posto del valore minimo del tag o 0.
  • ana.100: indica il valore da considerare come, ad esempio, silo pieno al posto del valore massimo del tag o 100.
  • ana.step: indica il passo per l'incremento/decremento dal valore del tag mediante uno spinner, se non specificato viene calcolato tra ana.0 e ana.100 in base alla proprietà dell'applicazione UtenzeV2.desiredManAnaSteps.