Configure or redirect process guidance

Your team can use process guidance to capture how they coordinate work on a team project, how to use work item types (WITs), and how to work with reports throughout the project life cycle. The generic guidance is hosted on MSDN for the Scrum, Agile, and CMMI process template artifacts. You can customize your own process guidance and redirect the F1 help links from select artifacts to point to your custom guidance.

If your team project was created using the Basic configuration or is hosted on Visual Studio Online, neither your project portal nor process guidance is enabled. This means that the links that redirect F1 help within a work item form aren’t available.

To configure a project portal, go here. If you want to configure process guidance, choose from one of the following options based on your deployment configuration and team requirements:

  1. From Visual Studio or Team Explorer, connect to your team project.

  2. Open Portal Settings.

    Open Portal Settings page from Team Explorer
  3. Choose the Process Guidance tab. When the Enable the link to process guidance check box is not selected, process guidance is not enabled.

    Process guidance not enabled

    When process guidance is not enabled, F1 help links within work item forms will not open help content.

Choose this option when you aren’t using SharePoint Products or when your team project is hosted on Visual Studio Online.

  1. If you aren’t a member of the Team Project Administrators group, get added now.

  2. Open Portal Settings and choose the Process Guidance tab.

  3. Enable the link to process guidance and then enter the URL for the website you’ve prepared for your team project portal.

    Specify Web site for process guidance
  4. To redirect F1 help links to point to content on your website, upload and then modify the support files.

Some process guidance links will work only if process guidance has been enabled for your team project.

  1. If you aren’t a member of the Team Project Administrators group, get added now.

  2. Open Portal Settings and choose the Process Guidance tab.

  3. Enable the link to process guidance and then configure the URL.

  4. Enter the URL for the SharePoint document library that contains the process guidance support files or content.

    Specify URL to SharePoint document library

  1. To obtain the process guidance support files for your team project, download them using the Process Template Manager. See Download the latest version of the process templates.

  2. Upload the contents of the Windows SharePoint Services/Process Guidance folder to the SharePoint document library that you have configured for process guidance.

    Depending on your process template, upload the following files into the indicated folders.

    Folder

    Scrum

    Agile

    CMMI

    Process Guidance

    ProcessGuidance.html

    ProcessGuidance.html

    ProcessGuidance.html

    Process Guidance/Supporting Files

    Bug.htm

    CodeReviewRequest.htm

    CodeReviewResponse.htm

    Feature.htm

    FeedbackRequest.htm

    FeedbackResponse.htm

    Impediment.htm

    Impediment.htm

    ProductBacklogItem.htm

    SharedSteps.htm

    Task.htm

    TestCase.htm

    AboutWorkItems.htm

    Bug.htm

    CodeReviewRequest.htm

    CodeReviewResponse.htm

    Feature.htm

    FeedbackRequest.htm

    FeedbackResponse.htm

    Issue.htm

    SharedSteps.htm

    Task.htm

    TestCase.htm

    UserStory.htm

    AboutWorkItems.htm

    Bug.htm

    ChangeRequest

    CodeReviewRequest.htm

    CodeReviewResponse.htm

    Feature.htm

    FeedbackRequest.htm

    FeedbackResponse.htm

    Issue.htm

    Requirement.htm

    Review.htm

    Risk.htm

    SharedSteps.htm

    Task.htm

    TestCase.htm

You can redirect users to customized content by modifying the redirect links contained within the process guidance support and report files.

The Open process guidance for work item process guidance icon is designed to look for an .aspx, .htm, or .html file. These files can either contain the content or provide a URL that redirects to it.

These files must be uploaded to a folder labeled Supporting Files, within the SharePoint document library configured for process guidance for the team project.

Upload .aspx content pages

  • For each work item type for which you want to provide process guidance, upload the .aspx content page that you named to match the work item type to your process guidance website.

    You must name the .aspx file to match the WORKITEMTYPE value in the type definition. For example, if the process guidance content is about the bug type of work item, which has <WORKITEMTYPE name="Bug"> within its type definition, name the file Bug.aspx.

Modify a process guidance support file

  1. In the Process Guidance folder and its subfolder Supporting Files, open each .htm file that you downloaded in step 1 of Upload process guidance support files.

  2. In each file, locate the meta statement that specifies the URL. For example:

    <meta http-equiv="Refresh" content="0;URL=http://go.microsoft.com/fwlink/?LinkId=190653" />
    
  3. Replace the value specified for the URL with the URL of the customized guidance stored on your configured process guidance website. For example:

    <meta http-equiv="Refresh" content="0;URL=http://YourPortal/Process Guidance/scrum/html/Bug.html" />
    
  4. Save and close each file.

  5. Upload each file to your process guidance website.

    These files must be stored in the appropriate folder as indicated in step 2 of Upload process guidance support files, above.

Modify a process guidance link within a report

  1. From Visual Studio, choose Team, Show Report Site.

  2. Open the folder that contains the report that you want to modify.

  3. Open the short-cut menu for the report and choose Download.

  4. Open the file in Visual Studio or a text editor.

  5. Locate the Hyperlink statement within the report.

  6. Replace the URL in that statement with the URL of the file that contains your customized content.

  7. Save and close the file.

  8. Return to the Report Manager folder of the report, and choose Upload File.

A: For work items: From Team Explorer, press F1 or choose the Open process guidance for work item process guidance icon from an open work item.

The Open process guidance for work item process guidance icon appears only on the work item forms opened from Team Explorer and only when your team project has process guidance enabled and configured.

When you choose the Open process guidance for work item process guidance icon that appears in the work item forms in Team Explorer, a web browser opens and the page that’s defined in the process guidance support file for the corresponding work item type is displayed. If you have not configured your team project with a project portal, or you haven’t uploaded the process guidance support files to the project portal, then this link will be inactive.

For reports: From an open report in Report Manager, choose the How to Use this Report link at the bottom of a report.

Depending on your settings, a web browser page opens to the MSDN content or your customized process guidance opens.

A: Yes. To specify text or a hyperlink within a work item form, see LabelText and Text XML Elements Reference.

To embed a webpage or html content within a work item form, see WebpageControlOptions XML Elements Reference.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft