{"id":7313,"date":"2006-09-29T19:32:00","date_gmt":"2006-09-29T19:32:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2006\/09\/29\/custom-controls-in-work-item-types\/"},"modified":"2019-02-14T17:52:31","modified_gmt":"2019-02-15T01:52:31","slug":"custom-controls-in-work-item-types","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/custom-controls-in-work-item-types\/","title":{"rendered":"Custom Controls in Work Item Types"},"content":{"rendered":"

Work Item Tracking Custom Controls<\/p>\n

<\/font><\/font><\/p>\n

Note: This is draft documentation for the Team Foundation Server SP1 Beta. The contents of this article should not be considered as final.  All feedback is welcome.<\/p>\n

<\/font><\/font><\/p>\n

Introduction<\/p>\n

<\/font><\/font><\/h2>\n

The Work Item Tracking Custom Controls mechanism provides a standard way to enhance T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem<\/font><\/u><\/span>s to include enhanced user-interface capabilities, extended event-based rules, and workflow capabilities. These custom controls can be bound to T:Microsoft.TeamFoundation.WorkItemTracking.Client.Field<\/font><\/u><\/span>s within T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem<\/font><\/u><\/span>s. These custom controls enable users to view and edit data.<\/p>\n

<\/font><\/font><\/p>\n

Purpose of the Work Item Tracking Custom Controls<\/p>\n

<\/font><\/font><\/h2>\n

The Work Item Tracking Custom Controls are intended to enable the following capabilities:<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Allow the use of new or existing Windows Form controls. This includes ActiveX controls wrapped as a Windows Form control.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Place controls on a T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem<\/font><\/u><\/span> Form using design layout constraints.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Allow a Control to be read and to write to a T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem<\/font><\/u><\/span> or T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItem<\/font><\/u><\/span> T:Microsoft.TeamFoundation.WorkItemTracking.Client.Field<\/font><\/u><\/span>.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Allow a Control to read and write from external data sources.<\/p>\n

<\/font><\/font><\/p>\n

Restrictions of the Work Item Tracking Custom Controls<\/p>\n

<\/font><\/font><\/h2>\n

There are some restrictions for custom controls.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Multiple value fields are not directly supported. The use of a single field value as a holder of multiple values makes querying very difficult to do reliably.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Attachments do not have an update capability. The use of Custom Controls cannot overcome this limitation.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>The existing controls are not public and therefore cannot be extended.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>The binaries for each custom control must be installed on the client computer. There is no requirement for Admin rights to install custom control binaries.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>There is no provisioning system for custom control binaries in Visual Studio. Visual Studio<\/font><\/font> <\/span><\/span>assumes the binaries are already installed on the client computer.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Custom controls that are missing or are not configured correctly must not cause the client to crash. They must also provide enough information to troubleshoot the problem.<\/p>\n

<\/font><\/font><\/p>\n

Custom Control Implementations<\/p>\n

<\/span><\/font><\/font><\/h2>\n

Custom Controls have the following rules:<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>They must derive from the T:System.Windows.Forms.Control<\/font><\/u><\/span> class<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>They must have a no-argument constructor<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>They must implement the T:Microsoft.TeamFoundation.WorkItemTracking.Controls.IWorkItemControl<\/font><\/u><\/span> interface<\/p>\n

<\/font><\/font><\/p>\n

As an option, they can implement the following interfaces:<\/p>\n

<\/font><\/font><\/p>\n

T:Microsoft.TeamFoundation.WorkItemTracking.Controls.IWorkItemClipboard<\/span><\/p>\n

<\/font><\/u><\/font><\/font><\/p>\n

T:Microsoft.TeamFoundation.WorkItemTracking.Controls.IWorkItemUserAction<\/span><\/p>\n

<\/font><\/u><\/font><\/font><\/p>\n

T:Microsoft.TeamFoundation.WorkItemTracking.Controls.IWorkItemToolTip<\/span><\/p>\n

<\/font><\/font><\/font><\/u><\/p>\n

See description\/comment a Work Item Type definition<\/p>\n

<\/font><\/font><\/h2>\n

In the Work Item Type definition Layout, each Control element has a Type attribute. The schema previously identified the following valid control types:   <\/span><\/p>\n

<\/font><\/font><\/p>\n

<xs:restriction base=”xs:string”><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”FieldControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”DateTimeControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”HtmlFieldControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”LinksControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”AttachmentsControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”WorkItemClassificationControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><xs:enumeration value=”WorkItemLogControl” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

<\/xs:restriction><\/p>\n

<\/font><\/font><\/font><\/p>\n

This has been replaced with:<\/p>\n

<\/font><\/font><\/p>\n

<xs:restriction base=”xs:string”><\/p>\n

<\/font><\/font><\/font><\/p>\n

    <\/span><\/xs:restriction><\/p>\n

<\/font><\/font><\/font><\/p>\n

This allows any name to be used. The built-in Types are still permitted. However, the use of a Type that does not match a built-in Type will infer the use of a Custom Control. This reference must not be to a specific DLL or Control. The reference is used as a name to look up an assembly manifest file on the client. For more information on assembly manifests see the topic, Assembly Manifests, on MSDN (<\/font>http:\/\/go.microsoft.com\/fwlink\/?LinkId=74355<\/font><\/a>).<\/p>\n

<\/font><\/font><\/p>\n

Example<\/p>\n

<\/font><\/font><\/font><\/h3>\n

<Control Type=”WorkItemIdReference” FieldName=”MyFields.DuplicateId”  <\/span>Label=”&amp;Duplicate Id:” LabelPosition=”Left” \/><\/p>\n

<\/font><\/font><\/font><\/p>\n

Work Item Custom Control (.wicc) Files<\/p>\n

<\/font><\/font><\/h2>\n

Use the value for the Control Type to identify the Work Item Custom Control (WICC) manifest file. The WICC file uses a naming convention of <Control Type>.wicc. It is located on the client computer in the following search path:<\/p>\n

<\/font><\/font><\/p>\n

<\/a><\/p>\n

 <\/font><\/p>\n<\/p>\n\n\n\n\n\n
\n

Term<\/p>\n

<\/font><\/font><\/b><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/p>\n

\n

Definition<\/p>\n

<\/font><\/font><\/b><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/tr>\n

\n

Environment.SpecialFolder.LocalApplicationData<\/p>\n

<\/font><\/font><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/p>\n

\n

User-specific Path<\/p>\n

<\/font><\/font><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/tr>\n

\n

Environment.SpecialFolder.CommonApplicationData folder<\/p>\n

<\/font><\/font><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/p>\n

\n

All Users<\/p>\n

<\/font><\/font><\/span><\/p>\n<\/td>\n

<\/font><\/span><\/tr>\n<\/tbody>\n<\/table>\n

<\/p>\n

 <\/font><\/p>\n

<\/span><\/p>\n

<\/span><\/p>\n

This manifest contains the following information:<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Assembly <\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>FullClassName<\/p>\n

<\/font><\/font><\/p>\n

Here is an example:<\/p>\n

<\/font><\/font><\/p>\n

<?xml version=”1.0″?><\/p>\n

<\/font><\/font><\/font><\/p>\n

<CustomControl xmlns:xsi=”http:\/\/www.w3.org\/2001\/XMLSchema-instance” xmlns:xsd=”http:\/\/www.w3.org\/2001\/XMLSchema”><\/p>\n

<\/font><\/font><\/font><\/p>\n

  <\/span><Assembly>WitCustomControlSample.dll<\/Assembly><\/p>\n

<\/font><\/font><\/font><\/p>\n

  <\/span><FullClassName>WitCustomControlSample.WorkItemIdReference<\/FullClassName><\/p>\n

<\/font><\/font><\/font><\/p>\n

<\/CustomControl><\/p>\n

<\/font><\/font><\/font><\/p>\n

Use the Assembly element to locate and load the assembly. This value can be either the relative path of the location of the assembly file or the absolute path of the location of the assembly file.<\/p>\n

<\/font><\/font><\/p>\n

Additional Notes<\/p>\n

<\/font><\/font><\/h2>\n

·<\/font>         <\/span><\/span><\/span>If you cannot find the control, or if some other error occurs, you will see a red, read-only error message. This message is substituted for the control itself.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Custom validation rules cannot be enforced in other client environments, such as <\/font>Microsoft Excel <\/font><\/em><\/span><\/span>and <\/font>Microsoft Project<\/font><\/em><\/span><\/span>. Use these rules carefully.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>Validation rules cause the existing controls to change color when they are invalid. The colors are not customizable. Therefore, new controls should use standard colors to remain consistent.<\/p>\n

<\/font><\/font><\/p>\n

·<\/font>         <\/span><\/span><\/span>The Work Item Object Model is updated on every change to a control. Custom control implementations must set the dirty flag correctly in the Object Model so that changes in the custom control will be saved.<\/p>\n

<\/font><\/font><\/p>\n

See Also<\/font><\/font><\/h2>\n<\/h2>\n","protected":false},"excerpt":{"rendered":"

Work Item Tracking Custom Controls Note: This is draft documentation for the Team Foundation Server SP1 Beta. The contents of this article should not be considered as final.  All feedback is welcome. Introduction The Work Item Tracking Custom Controls mechanism provides a standard way to enhance T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItems to include enhanced user-interface capabilities, extended event-based rules, […]<\/p>\n","protected":false},"author":125,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-7313","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops"],"acf":[],"blog_post_summary":"

Work Item Tracking Custom Controls Note: This is draft documentation for the Team Foundation Server SP1 Beta. The contents of this article should not be considered as final.  All feedback is welcome. Introduction The Work Item Tracking Custom Controls mechanism provides a standard way to enhance T:Microsoft.TeamFoundation.WorkItemTracking.Client.WorkItems to include enhanced user-interface capabilities, extended event-based rules, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/7313","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/125"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=7313"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/7313\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=7313"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=7313"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=7313"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}