Caisis Input Controls&action it

From CaisisWiki

(Difference between revisions)
Jump to: navigation, search
(Introduzione)
 
(6 intermediate revisions not shown)
Line 1: Line 1:
-
(traduzione italiana in corso)
+
Traduzione a cura di Andrea Fraietta
 +
 
===Introduzione===
===Introduzione===
Line 6: Line 7:
I controlli di input di Caisis forniscono proprietà addizionali per facilitare la loro associazione con i [[Business Objects]]. Proprietà quali Table e Field facilitano l'associazione del valori dei controlli ai rispettivi nomi di campi e tabelle associati del database.
I controlli di input di Caisis forniscono proprietà addizionali per facilitare la loro associazione con i [[Business Objects]]. Proprietà quali Table e Field facilitano l'associazione del valori dei controlli ai rispettivi nomi di campi e tabelle associati del database.
-
===Interfaces===
+
===Interfacce===
----
----
====ICaisisInputControl====
====ICaisisInputControl====
-
The interface ICaisisInputControl provides commonly used UI elements into helpful properties as well as providing support to handle matching controls to associated [Business Object] Fields.
+
L'interfaccia denominata ICaisisInputControl fornisce gli elementi più comuni attraverso proprietà e fornisce supporto per trattare l'associazione con i campi dei [Business Object] correlati.
-
'''Controls Implementing ICaisisInputControl'''  
+
'''Controlli implementati da ICaisisInputControl'''  
*CaisisTextBox
*CaisisTextBox
*CaisisTextArea
*CaisisTextArea
Line 25: Line 26:
====ICaisisLookupControl====
====ICaisisLookupControl====
-
The ICaisisLookupControl provide easy access to bind controls to LookupCodes, as defined by the Administrator. There are also additional properties used to generate dynamic lookup codes based on user selected values.
+
L'interfaccia denominata ICaisisLookupControl fornisce un accesso facilitato per legare i controlli ai LookupCodes, come definito dall'amministratore. Esistono anche proprietà addizionali utilizzate per creare codici di lookup dinamici basati su valori scelti dall'utente.
 +
 
'''Controls Implementing ICaisisLookupControl'''
'''Controls Implementing ICaisisLookupControl'''
*CaisisSelect
*CaisisSelect
*CaisisComboBox
*CaisisComboBox
-
 
+
=== Proprietà di base ===
-
=== Base Properties ===
+
----
----
-
By default, all controls that implement the ICaisisInputControl interface, have these properties exposed to be set and retrieved by user code. These properties provide easy access to many of the control's UI elements, as well as database related properties such as Table and Field, which allow for syncing with [[Business Objects]].
+
Per default, tutti i controlli implementati dall'interfaccia ICaisisInputControl, hanno tutte le proprietà esposte in modo da essere settate e trovate per codice utente. Queste proprietà forniscono un accesso facilitato a molti controlli dell'interfaccia utente, assieme a proprietà di database quali Table e Field, che consentono il collegamento con i [[Business Objects]].
====Table (string) ====
====Table (string) ====
-
The name of the Database Table corresponding to a control.
+
Il nome della tabella di database corrispondente al controllo.
====Field (string) ====
====Field (string) ====
-
The name of the Database Table's field corresponding to a control
+
Il nome del campo della tabella del database corrispondente al controllo.
====Value (string) ====
====Value (string) ====
-
This is the corresponding "text" value of a derived control.  
+
Questo è il corrispondente valore di "text" di un controllo derivato.  
-
So, for TextBox the Value field refers to the TextBox's value, for TexArea's value, DropDownList, SelectedValue.
+
Quindi, per TextBox il campo Value si riferisce al valore del TextBox, della TexArea, del DropDownList, del SelectedValue.
====Visible (boolean)====
====Visible (boolean)====
-
The name of the Database Table corresponding to a control.
+
Il nome della tabella di database corrispondente al controllo.
====FieldLabel (string)====
====FieldLabel (string)====
-
The name to display next to the control.
+
Il nome da visualizzare dopo il controllo.
====Required (boolean)====
====Required (boolean)====
-
Shows if this field is required on data entry forms.
+
Indica se questo campo è obbligatorio nei moduli di data entry.
====ShowHelpBubble (boolean)====
====ShowHelpBubble (boolean)====
-
True or False value indicating wheather to show a help description for a control.
+
Valore True o False che indica se visualizzare un help per il controllo.
====HelpDescription (string)====
====HelpDescription (string)====
-
The help description displayed for a control.
+
Descrizione di help visualizzata per il controllo.
====ShowLabel (boolean)====
====ShowLabel (boolean)====
-
True or False indicating weather to show a control.
+
Valore True o False che indica se visualizzare il controllo.
====Enabled (boolean)====
====Enabled (boolean)====
-
True or False indicating weather to is enabled for editing/modifying.
+
Valore True o False che indica se abilitare la modifica del controllo.
====CssClass (string)====
====CssClass (string)====
-
The CSS class name to apply to the control.
+
Nome della classse del CSS (foglio di stile) da applicare al controllo.
-
 
+
-
===Extended Properties===
+
===Proprietà estese===
----
----
-
The following properties are exposed by controls implementing the ICaisisLookupControl interface. This provides easy access to binding to [[Lookup Codes]] as well, as offering dynamic cascading values through related controls.
+
Le seguenti proprietà sono esposte dai controlli implementati nell'interfaccia ICaisisLookupControl. Ciò fornisce un accesso facilitato al collegamento con i [[Lookup Codes]] ed ai relativi valori collegati attraverso i relativi controlli.
====LookupCode (string)====
====LookupCode (string)====
-
A code used to retrieve results from the database.
+
Il codice utilizzato per cercare i risultati dal database.
====LookupDistinct (string)====
====LookupDistinct (string)====
-
Controls filtering of lookup values.
+
Controlli che filtrano i valori di lookup.
====CascadeValuesBasedOn (string)====
====CascadeValuesBasedOn (string)====
-
(Advanced) When combined with the CascadeFormatString, lookup codes for a control are generated on the fly (client-side through javascript,CaisisComboBox), or via AutoPostBack events (via server,CaisisSelect). This property takes a list of comma-seperated list of related Fields. When lookup codes are needed (during a combo box click event), then values are extracted from these related fields and used to build a dynamic lookup code that is retrieved from the server.
+
(Avanzato) Combinato con il CascadeFormatString, i lookup codes per un controllo sono generati al volo (client-side tramite javascript,CaisisComboBox), o tramite eventi AutoPostBack (via server,CaisisSelect). Questa proprietà prende una lista di campi separati da virgola. Solo quando i codici di lookup sono richiesti (all'evento click su un combo box), i valori vengono estratti dai campi correlati del database per costruire dinamicamente i codici di lookup richiesti al server.
====CascadeFormatString (string)====
====CascadeFormatString (string)====
-
(Advanced) Specifies the format of the dynamic lookup codes, based on values of the related control (CascadeValuesBasedOn). Format is similar to C# String.Format method where string "my first value: {0} and second value: {1}" will have {0} and {1} replaced with an array of values, based on an index 0-n. In this case, the array of values are determined by the controls referenced(by Field names) in CascadeValuesBasedOn. In addition to using indexes of related control, you may also use the n. prefix to extract a number from the control's value. Below is an example of how this property is combined with the CascadeValuesBasedOn.
+
(Avanzato) Specifica il formato dei codici di lookup dinamici, basato sui valori del controllo associato (CascadeValuesBasedOn). Il formato è simile a quello della C# String. Metodo del formato dove la stringa "mio primo valore: {0} e secondo valore: {1}" vedranno {0} e {1} sostituiti con un array di valori, basato su un indice 0-n. In questo caso, l'array di valori è determinato dai controlli referenziati(per nome di Field) nel CascadeValuesBasedOn. Oltre ad utilizzare gli indici dei relativi controlli, è anche possibile usare il prefisso n. per estrarre un numero di valori di controllo. Di seguito un esempio su come questa proprietà interagisce con il CascadeValuesBasedOn.
-
'''Example:'''  
+
'''Esempio:'''  
-
We have the field ClinStageT represented by the CaisisComboBox control.  
+
Supponiamo di avere il campo ClinStageT rappresentato dal controllo CaisisComboBox.  
-
On this same form there are two CaisisSelect(DropDownList) represented with Field ClinStageDisease and ClinStageSystem.
+
Nello stesso form ci sono anche due CaisisSelect(DropDownList) per rappresentare i Field ClinStageDisease e ClinStageSystem.
-
We now set the related properties.
+
Impostiamo ora le seguenti proprietà:
*CascadeValuesBasedOn="ClinStageDisease,ClientStageSystem"
*CascadeValuesBasedOn="ClinStageDisease,ClientStageSystem"
*CascadeFormatString="StageClin_{0}_{n.1}_T"
*CascadeFormatString="StageClin_{0}_{n.1}_T"
-
When we change the values of ClinStageDisease or ClinStageSystem, the lookup code which the ClinStageT ComboBox generates is based on the two observed values. So if we select Prostate for the ClinStageDisease, and select UICC_02 for ClinStageSystem, we will generate a lookupcode "StageClin_Prostate_02_T", since the "Value" of ClinStageDisease is "Prostate" and the "Value" of ClinStageSystem is "UICC_02". We only extract the number for the ClinStageSystem "Value", as our format string said to parse out a number, "{n.1}" from the value at index 1.
+
Quando cambiamo i valori di ClinStageDisease o di ClinStageSystem, i codici di lookup che il ComboBox ClinStageT genera sono basati su sue valori osservati. Così se selezioniamo Prostate per il ClinStageDisease, e scegliamo UICC_02 per ClinStageSystem, andremo a generare un codice di lookup "StageClin_Prostate_02_T", in quanto il "Value" di ClinStageDisease è "Prostate" e il "Value" di ClinStageSystem è "UICC_02". Estraiamo solo il numero di valori di ClinStageSystem, in quanto il nostro formato di stringa è impostato per un parse di un numero, "{n.1}" dal valore dell'indice 1.
-
NOTES: If the control using these properties is a CaisiSelect, everytime an observed control changes values, it will cause a post back to the server, causing syncing issues with retaining values. The CaisisComboBoxes however do not post back, as values are generated via javascript and are retrieved using Client CallBacks, there is no need to worry about retaining values. If unsure, CaisisComboBoxes always provide the best method to handle dynamic lookup codes. The controls being observed (CascadeValuesBasedOn) can still be any type of control, even a CaisisSelect.
+
NOTE: Se il controllo che utilizza queste proprietà e una CaisiSelect, ogni cambiamento di valore osservato, darà luogo ad una interrogazione al server, fornendo i relativi risultati di ritorno. Tuttavia i CaisisComboBoxes non rieseguono l'interrogazione, in quanto i valori sono generati via javascript e sono acquisiti tramite CallBacks lato client, per cui non c'è da preoccuparsi circa il ritorno dei valori. Se non siete sicuri, i CaisisComboBoxes forniscono sempre il metodo migliore per trattare i codici di lookup dinamici. I controlli che vengono osservati (CascadeValuesBasedOn) possono essere qualsiasi tipo di controllo, anch e un CaisisSelect.

Current revision as of 09:17, 15 September 2008

Traduzione a cura di Andrea Fraietta


Contents

Introduzione

In questa sezione vengono descritti i controlli di input di Caisis che costituiscono i controlli base dell'interfaccia utente all'applicazione, che si appoggiano ai controlli standard previsti da .NET controls, quali TextBoxes, TextAreas, CheckBoxes, RadioButton, DropDownList, etc... Questi controlli forniscono proprietà utili applicabili ai vari elementi dell'interfaccia (calendari, tastierini numerici, icone, descrizioni...) con poca attività di programmazione.

I controlli di input di Caisis forniscono proprietà addizionali per facilitare la loro associazione con i Business Objects. Proprietà quali Table e Field facilitano l'associazione del valori dei controlli ai rispettivi nomi di campi e tabelle associati del database.

Interfacce


ICaisisInputControl

L'interfaccia denominata ICaisisInputControl fornisce gli elementi più comuni attraverso proprietà e fornisce supporto per trattare l'associazione con i campi dei [Business Object] correlati. Controlli implementati da ICaisisInputControl

  • CaisisTextBox
  • CaisisTextArea
  • CaisisSelect
  • CaisisHidden
  • CaisisCheckBox
  • CaisisComboBox
  • CaisisRadioButton
  • CaisisRadioButtonList
  • CaisisExtendedCheckBoxList
  • CaisisExtendedRadioButtonList

ICaisisLookupControl

L'interfaccia denominata ICaisisLookupControl fornisce un accesso facilitato per legare i controlli ai LookupCodes, come definito dall'amministratore. Esistono anche proprietà addizionali utilizzate per creare codici di lookup dinamici basati su valori scelti dall'utente.

Controls Implementing ICaisisLookupControl

  • CaisisSelect
  • CaisisComboBox

Proprietà di base


Per default, tutti i controlli implementati dall'interfaccia ICaisisInputControl, hanno tutte le proprietà esposte in modo da essere settate e trovate per codice utente. Queste proprietà forniscono un accesso facilitato a molti controlli dell'interfaccia utente, assieme a proprietà di database quali Table e Field, che consentono il collegamento con i Business Objects.

Table (string)

Il nome della tabella di database corrispondente al controllo.

Field (string)

Il nome del campo della tabella del database corrispondente al controllo.

Value (string)

Questo è il corrispondente valore di "text" di un controllo derivato. Quindi, per TextBox il campo Value si riferisce al valore del TextBox, della TexArea, del DropDownList, del SelectedValue.

Visible (boolean)

Il nome della tabella di database corrispondente al controllo.

FieldLabel (string)

Il nome da visualizzare dopo il controllo.

Required (boolean)

Indica se questo campo è obbligatorio nei moduli di data entry.

ShowHelpBubble (boolean)

Valore True o False che indica se visualizzare un help per il controllo.

HelpDescription (string)

Descrizione di help visualizzata per il controllo.

ShowLabel (boolean)

Valore True o False che indica se visualizzare il controllo.

Enabled (boolean)

Valore True o False che indica se abilitare la modifica del controllo.

CssClass (string)

Nome della classse del CSS (foglio di stile) da applicare al controllo.

Proprietà estese


Le seguenti proprietà sono esposte dai controlli implementati nell'interfaccia ICaisisLookupControl. Ciò fornisce un accesso facilitato al collegamento con i Lookup Codes ed ai relativi valori collegati attraverso i relativi controlli.

LookupCode (string)

Il codice utilizzato per cercare i risultati dal database.

LookupDistinct (string)

Controlli che filtrano i valori di lookup.

CascadeValuesBasedOn (string)

(Avanzato) Combinato con il CascadeFormatString, i lookup codes per un controllo sono generati al volo (client-side tramite javascript,CaisisComboBox), o tramite eventi AutoPostBack (via server,CaisisSelect). Questa proprietà prende una lista di campi separati da virgola. Solo quando i codici di lookup sono richiesti (all'evento click su un combo box), i valori vengono estratti dai campi correlati del database per costruire dinamicamente i codici di lookup richiesti al server.

CascadeFormatString (string)

(Avanzato) Specifica il formato dei codici di lookup dinamici, basato sui valori del controllo associato (CascadeValuesBasedOn). Il formato è simile a quello della C# String. Metodo del formato dove la stringa "mio primo valore: {0} e secondo valore: {1}" vedranno {0} e {1} sostituiti con un array di valori, basato su un indice 0-n. In questo caso, l'array di valori è determinato dai controlli referenziati(per nome di Field) nel CascadeValuesBasedOn. Oltre ad utilizzare gli indici dei relativi controlli, è anche possibile usare il prefisso n. per estrarre un numero di valori di controllo. Di seguito un esempio su come questa proprietà interagisce con il CascadeValuesBasedOn.

Esempio:

Supponiamo di avere il campo ClinStageT rappresentato dal controllo CaisisComboBox.

Nello stesso form ci sono anche due CaisisSelect(DropDownList) per rappresentare i Field ClinStageDisease e ClinStageSystem.

Impostiamo ora le seguenti proprietà:

  • CascadeValuesBasedOn="ClinStageDisease,ClientStageSystem"
  • CascadeFormatString="StageClin_{0}_{n.1}_T"

Quando cambiamo i valori di ClinStageDisease o di ClinStageSystem, i codici di lookup che il ComboBox ClinStageT genera sono basati su sue valori osservati. Così se selezioniamo Prostate per il ClinStageDisease, e scegliamo UICC_02 per ClinStageSystem, andremo a generare un codice di lookup "StageClin_Prostate_02_T", in quanto il "Value" di ClinStageDisease è "Prostate" e il "Value" di ClinStageSystem è "UICC_02". Estraiamo solo il numero di valori di ClinStageSystem, in quanto il nostro formato di stringa è impostato per un parse di un numero, "{n.1}" dal valore dell'indice 1.

NOTE: Se il controllo che utilizza queste proprietà e una CaisiSelect, ogni cambiamento di valore osservato, darà luogo ad una interrogazione al server, fornendo i relativi risultati di ritorno. Tuttavia i CaisisComboBoxes non rieseguono l'interrogazione, in quanto i valori sono generati via javascript e sono acquisiti tramite CallBacks lato client, per cui non c'è da preoccuparsi circa il ritorno dei valori. Se non siete sicuri, i CaisisComboBoxes forniscono sempre il metodo migliore per trattare i codici di lookup dinamici. I controlli che vengono osservati (CascadeValuesBasedOn) possono essere qualsiasi tipo di controllo, anch e un CaisisSelect.

Personal tools