WitCustomControls Wiki & Documentation Rss Feed

Updated Wiki: Multivalue control

hayderc — Mon, 20 Apr 2009 19:23:58 GMT

MultiValue Control

A ComboBox Control to accept and show multiple values for a field by showing a list of checkboxes.

Installation
In order to use this control, at two files must be present in the deployment folder:

MultiValueControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: <ApplicationData>\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

Schema
Fields associated with multivalue control should have list of suggested values and each value enclosed in square brackets. For example:

<FIELD name="Triage" refname="Microsoft.VSTS.Common.Triage" type="String" reportable="dimension">
<HELPTEXT>Status of triaging the bug</HELPTEXT>
<SUGGESTEDVALUES expanditems="false">
<LISTITEM value="[Approved]" />
<LISTITEM value="[Investigate]" />
<LISTITEM value="[Rejected]" />
<LISTITEM value="[Submit]" />
</SUGGESTEDVALUES>
</FIELD>

Then use MultiValueControl as controltype for that field in Form section, for example:

<Control Type="MultiValueControl" FieldName="Microsoft.VSTS.Common.Triage" Label="Triag&e:" LabelPosition="Left" />

Quering
For quering work item based on MultiValueControl field, the control value is treated as a string. To search for items that has a specific list item selected in the MultiValueContorl use the contains operator and don't forget the square bracket when you enter the value. If you are searching for a specific list item selected and only that item is selected use the = operator. If sreaching for item that has more than one list item selected use multipe 'contains' clauses for that field.

New Comment on "Multivalue control"

Jethro — Thu, 02 Apr 2009 07:05:01 GMT

hi, how can i change the "System.AssignedTo" to multi-value , I want only users who are contributors or project administrator of the project will be listed.

New Comment on "Multivalue control"

jonlu — Fri, 16 Jan 2009 15:27:43 GMT

Hi! I tried the control and it works nicely but of course it doesn't work on the web client. Have you got any plans to implement web funcitonality or do you know of a version that works on the web client? Thanks! Jon

UPDATED WIKI: Screenshot controls

MOlausson — Tue, 23 Oct 2007 21:42:08 GMT

The Capture control can be added to any work item tracking type definition. Typically you would provide a label and then the Capture button, similar to the following image:

And here’s a cool feature – if the clipboard doesn’t contain an image then the Capture button is disabled. It will become enable as soon as the user presses “print screen” or “alt-gr print-screen”.

When the button is pressed a “Save As Attachment” dialog is shown. The dialog lets the user enter the attachment name and comment as usual. Pressing OK will create a new attachment to the work item.

It is also possible to click on the preview image to bring up a larger window with the screen shot:

To make the capture control even more useful, I’ve also implemented an alternative “File Attachment” control. This control works just like the standard control but also provides the Capture feature.

Schema
To use the control first create a work item type that contains the image. In essence the only thing that needs to be done is to include a new control in the <FORM> section in the work item XML. The following examples shows the syntax for the ScreenShot control and the FileAttachment control respectively:

<Control Type="ScreenshotControl" Label="Screenshot:" LabelPosition="Left" />

<Tab Label="File Attachments">
<Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

After that the control and its associated .wicc files need to be deployed locally on each machine using the control (and no, the TFS web client will currently not handle custom controls). Team Explorer searches for custom controls in folder “Microsoft\Team Foundation\Work Item Tracking\Custom Controls” under Environment.SpecialFolder.CommonApplicationData folder first, then under Environment.SpecialFolder.LocalApplicationData.

So, that was it. Hopefully these little controls will fill part of the gap when it comes to handling screenshots in TFS work items.

Installation
In order to use this control, at two files must be present in the deployment folder:

AttachmentsControl.wicc
ScreenshotControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

UPDATED WIKI: Screenshot controls

MOlausson — Tue, 09 Oct 2007 15:12:02 GMT

UPDATED WIKI: Multivalue control

hayderc — Tue, 25 Sep 2007 19:20:38 GMT

MultiValue Control

A ComboBox Control to accept and show multiple values for a field by showing a list of checkboxes.

Installation
In order to use this control, at two files must be present in the deployment folder:

MultiValueControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: <ApplicationData>\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

Schema
Fields associated with multivalue control should have list of suggested values and each value enclosed in square brackets. For example:

<FIELD name="Triage" refname="Microsoft.VSTS.Common.Triage" type="String" reportable="dimension">
<HELPTEXT>Status of triaging the bug</HELPTEXT>
<SUGGESTEDVALUES expanditems="false">
<LISTITEM value="[Approved]" />
<LISTITEM value="[Investigate]" />
<LISTITEM value="[Rejected]" />
<LISTITEM value="[Submit]" />
</SUGGESTEDVALUES>
</FIELD>

Then use MultiValueControl as controltype for that field in Form section, for example:

<Control Type="MultiValueControl" FieldName="Microsoft.VSTS.Common.Triage" Label="Triag&e:" LabelPosition="Left" />

Quering
For quering for work item based on MultiValueControl filed, the control value is treated as a string. To search for items that has a specific list item selected in the MultiValueContorl use the contains operator and dont forget the square bracket when you enter the value. If you are searcher for a specific list item selected and only that list item is selecte use the = operator. If sreaching for item that has more than one list item selected use multipe 'contains' clauses for the same field.

UPDATED WIKI: Multivalue control

hayderc — Sun, 23 Sep 2007 05:13:31 GMT

MultiValue Control

A ComboBox Control to accept and show multiple values for a field by showing a list of checkboxes.

Installation
In order to use this control, at two files must be present in the deployment folder:

MultiValueControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: <ApplicationData>\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

Schema
Fields associated with multivalue control should have list of suggested values and each value enclosed in square brackets. For example:

<FIELD name="Triage" refname="Microsoft.VSTS.Common.Triage" type="String" reportable="dimension">
<HELPTEXT>Status of triaging the bug</HELPTEXT>
<SUGGESTEDVALUES expanditems="false">
<LISTITEM value="[Approved]" />
<LISTITEM value="[Investigate]" />
<LISTITEM value="[Rejected]" />
<LISTITEM value="[Submit]" />
</SUGGESTEDVALUES>
</FIELD>

Then use MultiValueControl as controltype for that field in Form section, for example:

<Control Type="MultiValueControl" FieldName="Microsoft.VSTS.Common.Triage" Label="Triag&e:" LabelPosition="Left" />

Quering
For quering for work item based on MultiValueControl filed, the control value is treated as a string. To search for items that has a specific list item selected in the MultiValueContorl use the contains operator and dont forget the square bracket when you enter the value. If you are searcher for a specific list item selected and only that list item is selecte use the = operator. If sreaching for item that has more than one list item selected use multipe 'contains' clauses for the same field.

UPDATED WIKI: Multivalue control

hayderc — Sun, 23 Sep 2007 04:56:31 GMT

!MultiValue Control

A ComboBox Control to accept and show multiple values for a field by showing a list of checkboxes.

Installation
In order to use this control, at two files must be present in the deployment folder:

MultiValueControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: <ApplicationData>\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

Schema
Fields associated with multivalue control should have list of suggested values and each value enclosed in square brackets. For example:

<FIELD name="Triage" refname="Microsoft.VSTS.Common.Triage" type="String" reportable="dimension">
<HELPTEXT>Status of triaging the bug</HELPTEXT>
<SUGGESTEDVALUES expanditems="false">
<LISTITEM value="Approved" />
<LISTITEM value="Investigate" />
<LISTITEM value="Rejected" />
<LISTITEM value="Submit" />
</SUGGESTEDVALUES>
</FIELD>

Then use MultiValueControl as controltype for that field in Form section, for example:

<Control Type="MultiValueControl" FieldName="Microsoft.VSTS.Common.Triage" Label="Triag&e:" LabelPosition="Left" />

Quering
For searching, MultiValueComboBox value is treated as a string. To search for items that has a specific list item selected in the combo box use the contains operator and dont forget the square bracket when you enter the value. Here are few query example

{"
-To sreach for item with Approved checked in Triage field use this clause:
AndOr Field Operator Value
And Triage Contains Approved

-To sreach for item with ONLY Approved is checked in Triage field use this clause:
AndOr Field Operator Value
And Triage = Approved

-To sreach for item with Approved and Investigae are checked in Triage field use these clauses:
AndOr Field Operator Value
And Triage Contains Approved
And Triage Contains Investigate

-To sreach for item with ONLY Approved and Investigae are checked in Triage field use this clause:
AndOr Field Operator Value
And Triage = Approved;Investigate"}

UPDATED WIKI: Home

hayderc — Sun, 23 Sep 2007 04:47:30 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Custom controls is a feature in TFS SP1 using which customer developed controls can be hosted in work item form. Those controls can implement various business logics or add additional functionality to work with the workitemform. Here is the info on how to build custom controls: http://blogs.msdn.com/narend/archive/2006/10/02/How-to-use-Custom-Controls-in-Work-Item-Form.aspx

Our blogs:

Naren Datha: http://blogs.msdn.com/narend
Mathias Olausson: http://olausson.net/blog

Why this project?

There are many functionalities that customers want to have in a work item form, and most can be build with using this feature and sometimes by supplementing with an addin. If you think a generic control can be built to address needs out there, you can help build it or suggest that idea for someone else to build it here.

Implemented Controls

The following controls are implemented in the current release:

Screenshot controls: A control where users can paste screenshots & images.
Web browser control: A control to host a web page and pass field values to that webpage.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes.

Other custom control ideas:

Below are some ideas to start with and many of these come from customers in Work Item Tracking msdn forum . Please use the user forum to share your comments or ideas on what controls might help you. More details on these here .

Difficulty Level: Easy

Checkbox control: Basic checkbox control to view and edit Boolean field values
Formattor control: A control to that formats dates and floting point field values to given format for display

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Button control: Similar to web site control above, but will call a web service and pass work item data.

Difficulty Level: Hard

UPDATED WIKI: Home

MOlausson — Mon, 13 Aug 2007 21:50:58 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

Implemented Controls

The following controls are implemented in the current release:

Screenshot controls: A control where users can paste screenshots & images.
Web browser control: A control to host a web page and pass field values to that webpage.

Other custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values
Formattor control: A control to that formats dates and floting point field values to given format for display

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

UPDATED WIKI: Screenshot controls

MOlausson — Mon, 13 Aug 2007 21:41:27 GMT

UPDATED WIKI: Home

MOlausson — Mon, 13 Aug 2007 21:34:05 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

Implemented Controls

The following controls are implemented in the current release:

Screenshot controls: A control where users can paste screenshots & images.
Web browser control: A control to host a web page and pass field values to that webpage.

Other custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values
Formattor control: A control to that formats dates and floting point field values to given format for display

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

UPDATED WIKI: Screenshot controls

MOlausson — Mon, 13 Aug 2007 21:31:44 GMT

The Capture control can be added to any work item tracking type definition. Typically you would provide a label and then the Capture button, similar to the following image:

And here’s a cool feature – if the clipboard doesn’t contain an image then the Capture button is disabled. It will become enable as soon as the user presses “print screen” or “alt-gr print-screen”.

When the button is pressed a “Save As Attachment” dialog is shown. The dialog lets the user enter the attachment name and comment as usual. Pressing OK will create a new attachment to the work item.

It is also possible to click on the preview image to bring up a larger window with the screen shot:

To make the capture control even more useful, I’ve also implemented an alternative “File Attachment” control. This control works just like the standard control but also provides the Capture feature.

To use the control first create a work item type that contains the image. In essence the only thing that needs to be done is to include a new control in the <FORM> section in the work item XML. The following examples shows the syntax for the ScreenShot control and the FileAttachment control respectively:

<Control Type="ScreenshotControl" Label="Screenshot:" LabelPosition="Left" />

<Tab Label="File Attachments">
<Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

After that the control and its associated .wicc files need to be deployed locally on each machine using the control (and no, the TFS web client will currently not handle custom controls). Team Explorer searches for custom controls in folder “Microsoft\Team Foundation\Work Item Tracking\Custom Controls” under Environment.SpecialFolder.CommonApplicationData folder first, then under Environment.SpecialFolder.LocalApplicationData.

So, that was it. Hopefully these little controls will fill part of the gap when it comes to handling screenshots in TFS work items.

UPDATED WIKI: Screenshot controls

MOlausson — Mon, 13 Aug 2007 21:30:44 GMT

The Capture control can be added to any work item tracking type definition. Typically you would provide a label and then the Capture button, similar to the following image:

And here’s a cool feature – if the clipboard doesn’t contain an image then the Capture button is disabled. It will become enable as soon as the user presses “print screen” or “alt-gr print-screen”.

When the button is pressed a “Save As Attachment” dialog is shown. The dialog lets the user enter the attachment name and comment as usual. Pressing OK will create a new attachment to the work item.

It is also possible to click on the preview image to bring up a larger window with the screen shot:

To make the capture control even more useful, I’ve also implemented an alternative “File Attachment” control. This control works just like the standard control but also provides the Capture feature.

To use the control first create a work item type that contains the image. In essence the only thing that needs to be done is to include a new control in the <FORM> section in the work item XML. The following examples shows the syntax for the ScreenShot control and the FileAttachment control respectively:

<Control Type="ScreenshotControl" Label="Screenshot:" LabelPosition="Left" />

<Tab Label="File Attachments">
<Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

After that the control and its associated .wicc files need to be deployed locally on each machine using the control (and no, the TFS web client will currently not handle custom controls). Team Explorer searches for custom controls in folder “Microsoft\Team Foundation\Work Item Tracking\Custom Controls” under Environment.SpecialFolder.CommonApplicationData folder first, then under Environment.SpecialFolder.LocalApplicationData.

So, that was it. Hopefully these little controls will fill part of the gap when it comes to handling screenshots in TFS work items.

UPDATED WIKI: Screenshot controls

MOlausson — Mon, 13 Aug 2007 21:27:03 GMT

The Capture control can be added to any work item tracking type definition. Typically you would provide a label and then the Capture button, similar to the following image:

And here’s a cool feature – if the clipboard doesn’t contain an image then the Capture button is disabled. It will become enable as soon as the user presses “print screen” or “alt-gr print-screen”.

When the button is pressed a “Save As Attachment” dialog is shown. The dialog lets the user enter the attachment name and comment as usual. Pressing OK will create a new attachment to the work item.

It is also possible to click on the preview image to bring up a larger window with the screen shot:

To make the capture control even more useful, I’ve also implemented an alternative “File Attachment” control. This control works just like the standard control but also provides the Capture feature.

To use the control first create a work item type that contains the image. In essence the only thing that needs to be done is to include a new control in the <FORM> section in the work item XML. The following examples shows the syntax for the ScreenShot control and the FileAttachment control respectively:

<Control Type="ScreenshotControl" Label="Screenshot:" LabelPosition="Left" />

<Tab Label="File Attachments">
<Control Type="AttachmentsControl" LabelPosition="Top" />
</Tab>

After that the control and its associated .wicc files need to be deployed locally on each machine using the control (and no, the TFS web client will currently not handle custom controls). Team Explorer searches for custom controls in folder “Microsoft\Team Foundation\Work Item Tracking\Custom Controls” under Environment.SpecialFolder.CommonApplicationData folder first, then under Environment.SpecialFolder.LocalApplicationData.

So, that was it. Hopefully these little controls will fill part of the gap when it comes to handling screenshots in TFS work items.

UPDATED WIKI: Web browser control

MOlausson — Mon, 13 Aug 2007 21:24:21 GMT

This control presents a simple web browser control inside the TFS client form. The control is configurable via XML attributes to display any webpage, and can pass in fields to be used as parameters in the URL.

Installation
In order to use this control, at two files must be present in the deployment folder:

WebBrowserControl.wicc
CodePlex.WitCustomControls.dll

The deployment folder is located at the following location under a default client install: C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls.

Schema
Below is an example of the "Control" entry which should be added to your work item schema to include this control on your form:

<Tab Label="Connect">
<Control Type="WebBrowserControl" URL="http://some.page?param0={0}&param1={1}" Params="fieldreferencename,fieldreferencename" Dock="Fill"/>
</Tab>

Where the URL attribute is a formatted string containing parameter placeholders if needed. The Params attribute is optional, and if omitted, the URL will be used verbatim. If the Params attribute is present, the control will try to look up the values of those fields in the current work item and place the value in the relative positions of the marked parameters in the URL.

UPDATED WIKI: Home

MOlausson — Mon, 13 Aug 2007 21:19:59 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

There are many functionalities that customers want with work item form, and most can be build with using this feature and sometimes by supplementing with an addin. It makes me feel hard each time when I say “not in v1” in forums for customers’ needs. Now you can do something more than asking product team to build it! If you think a generic control can be built to address needs out there, you can help built it or suggest that idea for someone else to build it here.

Implemented Controls

The following controls are implemented in the current release:

Screenshot controls: A control where users can paste screenshots & images.
Web browser control: A control to host a web page and pass field values to that webpage.

Other custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values
Formattor control: A control to that formats dates and floting point field values to given format for display

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

UPDATED WIKI: Home

naren — Sat, 03 Feb 2007 02:08:56 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

Custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values
Formattor control: A control to that formats dates and floting point field values to given format for display

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Web site control: A control to host a web page and pass field values to that webpage.
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

Screenshot capture control: A control where users could paste screenshots & images. Images can be pasted in present html control, but they are not persisted. This could fill that gap.

NOTE: I am leaving on paternity leave + vacation soon, so I can check the posts only during mid January. There may not be any activity on this until then because I do not have a replacement moderator yet. You are welcome to discuss ideas in user forum till then. I hope to initially provide a framework, base control to implement custom controls, setup package and a sample control (most likely website control mentioned above).

UPDATED WIKI: Home

naren — Thu, 16 Nov 2006 18:18:08 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

Custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Web site control: A control to host a web page and pass field values to that webpage.
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

Screenshot capture control: A control where users could paste screenshots & images. Images can be pasted in present html control, but they are not persisted. This could fill that gap.

UPDATED WIKI: Home

naren — Thu, 16 Nov 2006 01:22:41 GMT

Welcome to TFS Work Item Tracking Custom Controls home page!

Why this project?

Custom control ideas:

Checkbox control: Basic checkbox control to view and edit Boolean field values

Difficulty Level: Medium

Math expression control: Control to evaluate an expression based on value of other fields and display result. Example: Show effective priority which is function of Priority & Severity.
Color control: Will show values in different forecolor and backcolors based on expression evaluation as in above control. Example usage is to highlight a value in red on highly important item or customer
Web site control: A control to host a web page and pass field values to that webpage.
Button control: Similar to web site control above, but will call a web service and pass work item data.
Multivalue control: A control to accept and show multiple values for a field by showing a list of checkboxes

Difficulty Level: Hard

Custom Rules control: A control or an addin which will evaluate additional xml defined rules that WIT rules mechanism does not cover and that does not require user deployment. For example, enforcing non-root AreaPath for new workitems. See here for more info.