Specifica dei controlli dei form elemento di lavoro

È possibile utilizzare le informazioni fornite in questo argomento come un riferimento rapido per l'elemento Control e per gli elementi figlio e gli attributi di tale elemento. Per ogni campo o controllo del form che si desidera visualizzare su un form elemento di lavoro, è necessario aggiungere un elemento Control. È possibile personalizzare un form elemento di lavoro per visualizzare informazioni che consentono al team di utilizzare correttamente il form. È inoltre possibile aggiungere i controlli e i campi elemento di lavoro che consentono di immettere e visualizzare i dati di cui si desidera tenere traccia. L'elemento Control fornisce nove valori per l'attributo Type che possono essere utilizzati per aggiungere campi o per visualizzare testo normale, collegamenti ipertestuali o campi. È inoltre possibile definire controlli speciali per aggiungere collegamenti e allegati, visualizzare contenuto basato su Web o creare un controllo personalizzato e aggiungerlo al form elemento di lavoro.

In questo argomento

• Aggiunta di campi elemento di lavoro a un form elemento di lavoro

• Aggiunta di controlli speciali a un form elemento di lavoro

• Aggiunta di controlli personalizzati a un form elemento di lavoro

Aggiunta di campi elemento di lavoro a un form elemento di lavoro

Quando si personalizza il form elemento di lavoro, si aggiunge in genere un sottoinsieme dei campi elemento di lavoro definito per il tipo di elemento di lavoro che si desidera visualizzare sul form. Le definizioni dei campi controllano molti aspetti relativi ai dati che vengono visualizzati e ai dati che possono essere inseriti nel form. Per ulteriori informazioni, vedere Definizione dei campi elemento di lavoro.

A ogni campo elemento di lavoro è associato un tipo di dati. È possibile utilizzare le informazioni riportate nella tabella seguente per determinare il tipo di campo supportato dall'attributo Type dell'elemento Control. L'attributo Label consente di specificare il testo da visualizzare accanto al controllo. L'attributo LabelPosition correlato consente di specificare la posizione dell'etichetta rispetto al controllo. Per ulteriori informazioni, vedere Controllo della visualizzazione dei campi elemento di lavoro.

Nota

Non è possibile modificare i valori dei campi di sistema, che vengono aggiornati automaticamente. Ad esempio, i campi Data creazione e Creato Da vengono definiti quando un elemento di lavoro viene salvato la prima volta. È possibile tuttavia utilizzare questi campi nei criteri di ricerca. Per una descrizione di ciascun campo di sistema, vedere Utilizzo dei campi di sistema e dei campi definiti tramite i modelli di processo MSF.

Tipo di campo	Attributo Type dell'elemento Control	Utilizzo
DateTime	FieldControl DateTimeControl	Utilizzare FieldControl per fornire un campo di testo per l'input o la visualizzazione di un campo per il tipo di dati DateTime. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> Utilizzare DateTimeControl per consentire la selezione di una data del calendario per un campo, come illustrato nella figura seguente. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	Utilizzare FieldControl per fornire un campo di testo per l'input o la visualizzazione di campi Double. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
Cronologia	WorkItemLogControl	Utilizzare WorkItemLogControl per fornire un campo di controllo per i campi Cronologia che tengono traccia dei thread di discussione e di altre informazioni cronologiche, come illustrato nella figura seguente. È possibile utilizzare questo controllo solo per supportare la visualizzazione del campo della cronologia di un elemento di lavoro, ovvero il campo elemento di lavoro System.History. Tramite questo controllo è possibile espandere e comprimere i dettagli relativi alle revisioni cronologiche apportate a un elemento di lavoro. È inoltre possibile formattare il testo che si aggiunge al campo della cronologia. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	Utilizzare HTMLControl per fornire un campo di controllo che consente ai campi HTML di acquisire il formato rich text, come illustrato nella figura seguente. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	Utilizzare FieldControl per fornire un campo di controllo per un campo Integer. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Utilizzare FieldControl per fornire un campo di controllo per un campo di testo normale come, ad esempio, una casella di testo contenente descrizioni che potrebbero superare i 255 caratteri. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	Utilizzare FieldControl per fornire un campo di controllo per un campo String. I campi String sono limitati a 255 caratteri. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	Utilizzare WorkItemClassificationControl per fornire un campo di controllo per un campo TreePath. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Attributi di campo facoltativi dell'elemento Control per tutti i tipi di controllo

È possibile specificare gli attributi facoltativi riportati di seguito solo per i tipi di controllo elencati:

Attribute	Descrizione
Field	Specifica il controllo associato al campo dell'elemento di lavoro.
Label	Specifica il testo visibile sul form che identifica il controllo. Specificare una stringa composta da un massimo di 80 caratteri. Nota È possibile associare un collegamento ipertestuale all'etichetta di un campo aggiunto al form elemento di lavoro tramite FieldControl.Questo controllo è utile per fornire un collegamento alle informazioni relative al modo in cui viene utilizzato il campo.Per ulteriori informazioni, vedere Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro.
LabelPosition	Specifica la posizione dell'etichetta rispetto ai dati del controllo. Specificare una stringa contenente uno dei valori seguenti: Top, Bottom, Left e Right.
Dock	Specifica l'allineamento dell'etichetta al lato specificato del contenitore o estende il campo per riempire il contenitore. Specificare una stringa contenente uno dei valori seguenti: Fill, Top, Bottom, Left e Right.
Padding	Specifica la quantità di spazio in pixel intorno al bordo interno del controllo. Vengono forniti quattro valori corrispondenti ai margini superiore, inferiore, sinistro e destro. ad esempio 2,0,2,0.
Margin	Specifica la quantità di spazio in pixel intorno al bordo esterno del controllo. Vengono forniti quattro valori corrispondenti ai margini superiore, inferiore, sinistro e destro. ad esempio 2,0,2,0.
ReadOnly	Specifica se il campo è di sola lettura. Specificare True o False.
MinimumSize	Specifica la dimensione minima in pixel che il controllo deve occupare nel form. Vengono specificati due valori corrispondenti alla larghezza e all'altezza. ad esempio 100,100.
Name	Identifica un controllo in modo univoco. L'attributo Name è necessario se più di un controllo del form viene associato allo stesso campo elemento di lavoro. Nota Utilizzare l'attributo Name per visualizzare lo stesso campo in più aree del form.Specificare un valore univoco per l'attributo Name per entrambe le voci del controllo in modo che il sistema identifichi ogni controllo in modo univoco.È utile visualizzare lo stesso controllo in diverse posizioni in base al contesto delle schede.

Attributi di campo facoltativi dell'elemento Control per tipi di controllo specifici

È possibile specificare gli attributi facoltativi riportati di seguito solo per i tipi di controllo elencati:

Attribute	Tipi di controllo	Descrizione
NumberFormat	FieldControl	Specifica i caratteri che è possibile immettere nel controllo del campo. Sono validi i seguenti valori: WholeNumbers, SignedWholeNumbers, DecimalNumbers e SignedDecimalNumbers.
MaxLength	FieldControl	Specifica la lunghezza massima dei caratteri consentiti in un controllo del campo.
Format	DateTimeControl	Specifica il formato per il campo data e ora corrispondente a uno dei valori dell'enumerazione DateTimePickerFormat. Sono validi i seguenti valori: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Specifica il formato personalizzato utilizzato per il campo data e ora corrispondente alla sintassi definita per la proprietà DateTimePicker.CustomFormat.

Aggiunta di controlli speciali a un form elemento di lavoro

Nella tabella riportata di seguito vengono descritti gli attributi Type dell'elemento Control che consentono di gestire allegati di file, creare collegamenti, visualizzare contenuto Web e visualizzare altri dati non associati a un campo elemento di lavoro.

Attributo Type dell'elemento Control	Utilizzo
AttachmentsControl	Consente di allegare file a un form elemento di lavoro. Questo controllo è contenuto generalmente in un gruppo di schede separato, come illustrato nella figura seguente. AttachmentsControl Per ulteriori informazioni, vedere Aggiunta del controllo allegati.
LabelControl	Utilizzare per visualizzare testo normale o testo con collegamento ipertestuale non associato a un campo, come illustrato nella figura seguente. Utilizzare gli elementi figlio e contenitore, LabelText e Link, per specificare il testo, il collegamento ipertestuale e la posizione di un campo o di un'etichetta il cui testo è associato in parte a un collegamento ipertestuale. Per ulteriori informazioni, vedere Fornitura di Testo della guida, Linee guida per il processo, contenuto Web e collegamenti a pagine Web in un form elemento di lavoro, Riferimento agli elementi XML LabelText e Text e Riferimento agli elementi XML Link e Param.
LinksControl	Consente di creare e gestire collegamenti tra elementi di lavoro. Questo controllo è contenuto generalmente in un gruppo di schede separato, come illustrato nella figura seguente. Utilizzare LinksControlOptions per definire i filtri dei collegamenti e il layout dei campi colonna utilizzati per visualizzare l'elenco di collegamenti. Per ulteriori informazioni, vedere Definizione dei controlli dei collegamenti per limitare le relazioni di collegamento e Elementi LinksControlOptions.
WebpageControl	Consente di visualizzare contenuto Web in un form elemento di lavoro. Questo controllo è in genere contenuto in un gruppo di schede separato. Utilizzare gli elementi figlio WebpageControlOptions e Link per specificare i controlli richiesti per caricare la destinazione della pagina Web nel form elemento di lavoro. Per ulteriori informazioni, vedere Aggiunta di contenuto Web a un form elemento di lavoro, Riferimento agli elementi XML WebpageControlOptions e Riferimento agli elementi XML Link e Param.

Aggiunta di controlli personalizzati a un form elemento di lavoro

Oltre ai controlli incorporati, è possibile aggiungere un controllo personalizzato a un form elemento di lavoro.

È possibile ad esempio aggiungere un controllo personalizzato per acquisire una schermata degli Appunti. Oppure è possibile fornire un controllo per acquisire più valori aggiungendo una casella di controllo per i valori presenti in un elenco o in un menu.

Per implementare un controllo personalizzato, è necessario specificare il nome del controllo per l'attributo Type. Per ulteriori informazioni, visitare il sito Web Microsoft Controlli personalizzati per tenere traccia degli elementi di lavoro (la pagina potrebbe essere in inglese).

Vedere anche

Attività

Aggiungere e personalizzare un tipo di elemento di lavoro

Modifica del layout del form elemento di lavoro

Modifica dell'etichetta di un campo

Aggiunta di contenuto Web a un form elemento di lavoro

Riferimenti

Riferimento all'elemento XML Control

Concetti

Progettazione e personalizzazione di un form elemento di lavoro

Cronologia delle modifiche

Data	Cronologia	Motivo
Giugno 2010	Aggiunte illustrazioni e spostate alcune sezioni nei nuovi argomenti.	Miglioramento delle informazioni.