Specificare i controlli dei form elemento di lavoro

Questo argomento fornisce un riferimento rapido all'elemento Control, agli elementi figlio e agli attributi. 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 usare 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 usati 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.

Aggiungere i campi dell'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 altre informazioni, vedere Modificare o aggiungere un campo per supportare query, report e flusso di lavoro.

A ogni campo elemento di lavoro è associato un tipo di dati. È possibile usare 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 altre informazioni, vedere Controllare la 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 usare questi campi nei criteri di ricerca.Per una descrizione di ogni campo di sistema, vedere Riferimenti ai campi elemento di lavoro per Visual Studio ALM.

Tipo di campo	Attributo Type dell'elemento Control	Utilizzo
DateTime	FieldControl DateTimeControl	Usare 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" /> Usare 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	Usare 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" />
History	WorkItemLogControl	Usare 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 usare 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	Usare 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	Usare FieldControl per fornire un campo di controllo per un campo Integer. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Usare 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	Usare 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	Usare 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 di controllo per tutti i tipi di controllo

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

Attributo	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 usato il campo.Per altre informazioni, vedere Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su 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 Usare 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 di controllo per tipi di controllo specifici

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

Attributo	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 usato per il campo data e ora corrispondente alla sintassi definita per la proprietà DateTimePicker.CustomFormat.

Aggiungere controlli speciali

Nella tabella riportata di seguito vengono descritti gli attributi Control dell'elemento Type 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. Controllo allegati Per altre informazioni, vedere Aggiungere il controllo allegati.
LabelControl	Usare per visualizzare testo normale o testo con collegamento ipertestuale non associato a un campo, come illustrato nella figura seguente. Usare 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 altre informazioni, vedere Fornire testo della Guida, collegamenti ipertestuali o contenuto Web su 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. Usare LinksControlOptions per definire i filtri dei collegamenti e il layout dei campi colonna usati per visualizzare l'elenco di collegamenti. Per altre informazioni, vedere Definire i controlli dei collegamenti per limitare le relazioni di collegamento e Elementi LinksControlOptions.
StoryboardsControl	Consente di aprire Storyboard di PowerPoint da un elemento di lavoro e di collegare i file Storyboard salvati in una condivisione di rete. Questo controllo è contenuto generalmente in un gruppo di schede separato, come illustrato nella figura seguente. Per aggiungere StoryboardsControl alla sezione FORM, aggiungere il seguente frammento di codice: <Tab Label="Storyboards">    <Control Name="StoryboardsControl" Type="LinksControl">       <LinksControlOptions>          <WorkItemLinkFilters FilterType="excludeAll" />          <ExternalLinkFilters FilterType="include">             <Filter LinkType="Storyboard" />          </ExternalLinkFilters>          <LinkColumns>             <LinkColumn RefName="System.Title" />             <LinkColumn LinkAttribute="System.Links.Comment" />          </LinkColumns>       </LinksControlOptions>    </Control> </Tab>
WebpageControl	Consente di visualizzare contenuto Web in un form elemento di lavoro. Questo controllo è in genere contenuto in un gruppo di schede separato. Usare gli elementi figlio WebpageControlOptions e Link per specificare i controlli richiesti per caricare la destinazione della pagina Web nel form elemento di lavoro. Per altre informazioni, vedere Modificare una definizione WIT per aggiungere contenuto Web a un form elemento di lavoro, Riferimento agli elementi XML WebpageControlOptions ed Riferimento agli elementi XML Link e Param.

Aggiungere controlli personalizzati

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.

Vedere anche

Attività

Modificare il layout del form elemento di lavoro

Modificare una definizione WIT per aggiungere contenuto Web a un form elemento di lavoro

Riferimenti

Riferimento all'elemento XML Control