liujj-xujj

资本的力量很强大,但是没有了国家和民族,你再有钱也就是买办。
  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

MSF 过程指南自定义指南[中文译]

Posted on 2006-09-07 11:45  liujj-xujj  阅读(4437)  评论(3编辑  收藏  举报
 

MSF过程指南自定义指南

 英文原版请在这下载:/Files/liujj-xujj/Guide.rar


目录

MSF过程指南自定义指南    1

目录   2

介绍MSF Process Guidance MSF过程指南)   4

自定义过程指南工作流   4

配置过程指南所需的工具   4

Microsoft InfoPath 5

XMLXSL编辑器   5

MSFWinBuild工具   5

编辑相对运行模式   5

简介Microsoft InfoPath 格式的过程指南文件模版   6

公共节   7

创建新工作流   8

设定工作流控制者   8

添加入口和退出条件到工作流   9

添加参考到工作产品   10

查看工作流的变更   10

创建新的活动   11

添加活动的步骤   11

添加活动到工作流   12

为活动建立RACI信息   12

为活动添加入口和退出条件   13

查看活动的修改   14

编写工作项文件   14

工作项字段   14

工作项状态   15

工作项转换   15

链接工作项到活动和工作流中   16

查看工作项的变更   16

创建新规则   17

查看规则的变更   17

交叉引用   18

下一步   18

又见   18

案例和实践   19

编写概述页文档   19

ProcessGuidance.xml中编辑概述页   21

XSL文件中编辑概述页   21

编制如何内容和过程   21

编制过程指南报告文档   23

数据序列   23

添加运行正常的和运行不正常的报表的示例   23

编制视图文档   24

交叉引用视图   25

删除内容项   25

创建HTML内容页   26

 


 

介绍MSF Process Guidance MSF过程指南)

微软解决方案框架(MSF)过程指南是一个特殊的软件开发过程,由一系列的描述规则、工作项、工作产品、活动内容以及报告等内容的文档组成。过程指南是对过程模版的补充。例如:如果在过程模版中创建了一个新的工组项,过程指南里就必须有此工作项的相应文档来描述此工作项怎样关联规则和活动内容。过程指南将解答团队成员有关此过程的疑问,以及他们在团队项目中必须如何工作。

 

Microsoft® Visual Studio 2005® Team System授权了两个过程模版:MSF for Agile Software Development MSF for CMMI® Process Improvement。每个过程模版都可被软件项目开发配置和使用。本文将介绍如何在这些过程中配置过程指南。

 

自定义过程指南工作流

进行更改过程指南内容的过程大致如下。每一个步骤详细的过程将在本文中展开描述。

There is a general set of activities to perform to update process guidance content. Details on each of these activities are explained in this guide.

1.      修改过程指南的原始XML文件集

然后确定你的修改并通过编辑原始XML文件集来配置过程指南。

2.      IE里验证修改

当你在修改的时候,你可以通过IE浏览改后的文件,确定是否修改正确。

3.      生成HTML页面

通过使用MSFWinBuildTool预先把所有XML的原始内容解释到HTML文件中。这些HTML将以静态内容和字段的方式被更快的运行。

4.      更新清单

如果你在配置过程中创建或删除了文件,就要在wsstask.xml文件中更新清单,以确保在新的团队项目创建的时候,正确的过程指南文件被安装。注意:MSFWinBuild工具将会把由MSFWinBuild工具创建的HTML文件的列表自动更新到wsstasks.xml文件中。

 

配置过程指南所需的工具

MSF过程指南里包含了XMLXSLHTML文件。你将必须用到以下几个工具才能配置过程指南的文件。

·         Microsoft Office InfoPath 2003 with SP1

·         An XML or XSL editor

·         The MSFWinBuild tool

 

Microsoft InfoPath

MSF过程指南的原始内容保存在Wss\Process Guidance\Source\XML\目录下。已经编辑好的Microsoft InfoPath模版文件(template2.xsn)也保存在这个目录下。

 

你可以使用XML编辑器来直接编辑这个Microsoft InfoPath模版文件,但是你必须对XML过程框架基本定义非常了解。使用Microsoft InfoPath和模版使得编辑XML的可读性更高。Microsoft InfoPath可在Microsoft Office 2003中找到。你必须安装Microsoft Office Service Pack 1更新Microsoft InfoPath。此服务包可以从微软Office网站上获得。

 

XMLXSL编辑器

过程指南里的XSL文件包含了你可以配置的内容。

例如,Wss\Process Guidance\Source\XSLs\Principles.xsl文件包含了显示在Principles页上的内容。你需要一个XMLXSL编辑器来编辑这些文件。你可以使用Visual Studio 作为XML编辑器。

 

MSFWinBuild工具

XML文件里包含了过程指南里的原始内容。当进入编辑状态时,过程指南的内部结构代码使用一系列的查询将XML文件构架解释为HTML文件显示在浏览器中。当过程指南内容增多时,查询XML的速度就会降低。

 

MSFWinBuild工具把XML原始内容中所有的视图都解释成了一系列的HTML文件。这些HTML都已经被预先解释了。所以它们比查询XML源更快的调用和显示。可以到MSF敏捷开发软件架构工作平台上下载这个工具。位置在:http://lab.msdn.microsoft.com/teamsystem/workshop/msfagile/default.aspx.

 

编辑相对运行模式

浏览器调用MSF过程指南,是通过对一系列JavaScripXSL文件的内部代码来解释运行。其中包含两个内部代码集,这是他们之间最重要的区别。

 

Wss\Process Guidance\Source文件夹中,内部结构代码被设计成在编辑模式中进行控制操作。在进入编辑模式的时候,内部结构代码通过一系列的查询来架构ProcessGuidance.xml文件,将其解释为HTML显示在浏览器中。

 

Wss\Process Guidance\Supporting Files文件夹,内部结构代码被设计成在运行模式进行操作控制。当在运行模式的时候,内部结构代码显示预先解释过的内容(由于预先解释过,所以显示的更快)。

 

当编辑原始XML文件的时候,你必须在Wss\Process Guidance\Source\XML目录中进行设计。所有的过程指南文件都在这个原始目录中。你必须打开Wss\Process Guidance\Source\ProcessGuidance.htm file文件检查你的修改。

 

当你完成了你的修改后,你必须运行MSFWinBuild工具创建所有的预编辑的HTML文件到Wss\Process Guidance\Supporting Files目录中。你还可以打开Wss\Process Guidance\ProcessGuidance.htm文件来检查最后的内容。当创建一个团队项目的时候,Wss\Process Guidance\Supporting Files文件夹下的所有的文件和文件夹都会被拷贝到团队门户中。

 

简介Microsoft InfoPath 格式的过程指南文件模版

通过使用Microsoft InfoPathMicrosoft InfoPath模版来更改过程指南XML源文件是一个很简便的方式。当你用Microsoft InfoPath打开一个过程指南XML文件时,界面如下:

 

 

1InfoPath中的MSF敏捷软件开发

 

在窗体的上部的每个按钮都代表一个视图。这些查询页将整个过程指南的内容按照特殊的部分分类组织,使我们更容易设置。第一个视图(如图1所示)是一个内容视图。这个内容查询页代表的是一个内容项列表。一个内容项代表的是一个要解释的HTML

 

在每个视图中,都会显示一个列表项。在列表的下面是一个编辑窗体,你可以通过这个窗体编辑你在列表中选的任何一项。一旦选择了其中一项,其内容将显示在列表下方的窗体中。然后你可以在这个窗体里对其内容进行修改。

 

以下是几个有用的视图

    Content View(内容视图) - 此视图使用很频繁,用来显示内容项。每一个内容项反映的是一个由工作流或活动页解释成的HTML页。内容项的内容,例如:规则、工作流、工作产品、报告、活动、查询、怎样选项、怎样产品化、工作项等。

 

    点菜单 此视图很少使用,显示菜单的图片和依赖的XSL转换信息文件。

 

    术语 此视图显示术语的分类和定义。

 

    帮助地图 此视图是使用说明,正在使用,显示过程指南的帮助标题地图。

 

    图像 此视图显示的是图像和其文件位置的映射。图像文件硬性规定一定要保存在Process Guidance\Supporting Files\images folder目录下。

 

    索引 此视图显示参考对照。不常使用。

 

    菜单 此视图显示各个菜单的菜单项具体描述信息。我们将在此文档中介绍内容视图、术语视图、图像视图。

 

公共节

当我们使用内容项工作的时候。必须注意有一些公共节,它们涉及到很多的内容类型。在每个工作流和活动中都必须完整填写以下的节的内容。

 

Part

Part节是描述关于工作流或活动的细节信息的集合。在工作流中,Part节引用一个已经存在的活动并且将从工作流页链接到此活动页。在活动中,Part节描述的是在活动中执行的一个具体步骤。

 

RACI

RACI节(依赖、解释、合作、通知)标识了一个规则的名字和其包含的工作流或活动。通常只有依赖和参考规则被解释。可能会有多个参考规则,但是一个好的准则就是一个依赖规则。这个规则就被认为是这个工作流或规则的控制者。

 

Criteria(条件)节

条件节标识必须达到的条件。分为入口条件和退出条件。条件确定了一个工作流或活动什么时候开始,什么时候完成。

 

Cross Reference(交叉引用)节

cross reference section(交叉引用节)描述的是内联或外联的链接。内联链接指的是文件内部的具体的内容项,如:工作流、活动项、规则以及工作产品这些内容项。外联链接指的是链接到文件外的其它的URL

 

创建新工作流

一个工作流是由一系列互相关联的活动集合组成的,这些工作项通常是由一个特殊的规则联系起来。例如,重现Bug、定位Bug产生原因、写代码修复Bug、预览修复后的代码,这些都是由修改代码的活动联系起来的。在MSF敏捷软件开发中,这个工作流叫做“修复Bug”,它获取这些活动并且通过开发者规则来联合这些活动。你可以创建其它的工作流来定义你的软件开发过程中的特殊细节。

 

创建一个新工作流的步骤

To create a new workstream

1.      使用Microsoft InfoPath 打开 ProcessGuidance.xml 文件。此文件路径为 Wss\Process Guidance\Source\XML 目录下。

2.      打开 Insert 菜单,选择 SectionContentItem 在内容项列表的底端将显示新产生的项。

3.      在新项窗口,设定 Content Type 值为 Workstream

4.      Content Name中输入一个序列名,以标识本工作流。这个名字必须是一个能贯穿所有内容项的序列以确保连接不同工作项之间能正确工作。

5.      Content Description中,输入对工作流的描述信息。

6.      保存你的修改。

 

设定工作流控制者

创建完工作流后,你必须标识哪个规则是这个工作流的控制者。通过RACI节来设定这个信息。在MSF敏捷软件开发中,只解释依赖和参考规则。可以有多条参可规则,但是一个好的准则是只有一个依赖规则。

 

添加一条RACI规则到工作流

1.        Microsoft InfoPath中选择一个工作流希望处理的RACI信息。

2.        如果一条信息都不存在就创建一个RACI节。你可以通过点击 Insert item 链接到Part节的末尾来创建一个RACI

3.        设定RACIType内容为 ResponsibleAccountableConsulted,或 Informed这取决于工作流里的规则的关系。如果这个工作流是控制者,那么类型必须被设定为 Responsible

4.        Role Name中,输入在规则内容项里,Conten Name中显示的规则的名字,。

5.        保存你的修改。

 

添加入口和退出条件到工作流

虽然入口条件是一个可选节,但是它对于工作流的制定很有好处。在工作流将要开始的时候,经常要先确定一个或一组事件。有一种事件的类型是时间。以时间为基准的事件会被放到When节。依靠是另外一种事件类型。这些事件确定了需要先完成哪些事情才能开始指定的工作流。

 

添加入口条件到工作流

 

1.      Microsoft InfoPath 中选择需要加入入口条件的工作流,并且定位到 Entry Criteria 节。

2.      When 节,输入以时间为基准的事件的描述信息,这些事件确定了什么时候开始工作流。

3.      Dependency Name 字段,输入工作流开始工作需要依靠的项的名字。

4.      Dependency Description 字段,输入依赖的描述信息,例如在工作流开始前指定的工作项需要处于什么状态。
注意:如果你需要多个依赖,在Dependency节上鼠标右键,选择 Insert DependencyItem below

5.      如果不存在所需的条件类型,就创建一个条件类型。你可以通过点击Insert Item链接到对照类型节的末尾,创建一个新的条件类型节。

6.      设定 Criteria Type 字段为 Entry

7.      Criteria Name 字段,输入工作流开始前必须达到的条件的名字。

8.      Criteria Description,输入有关这个条件的详细描述信息。
注意:如果你必须创建多个入口条件,在条件类型节鼠标右键,然后选择 Insert CriteriaItem Below

9.      保存你的修改。

 

添加退出条件到工作流

To add exit criteria to a workstream

1.      Microsoft InfoPath 中选择需要加入退出条件的工作流。

2.      如果没有退出条件类型,就创建一个。你可以通过鼠标点击 Insert Item链接到对照类型节的末尾来创建一个条件类型节。

3.      设定Criteria Type 字段为 Exit

4.      Criteria Name字段,输入在工作流结束前必须进行的条件的名字。

5.      Criteria Description字段,输入有关这个条件的详细信息。
注意:如果你需要创建多个退出条件,在在条件类型节鼠标右键,然后选择 Insert CriteriaItem Below

6.      保存你的修改。

 

添加参考到工作产品

你可以创建对照参考到工作产品中来标识工作产品与工作流之间的联系。对照参考定义了一个工作产品列表,当我们用含特殊规则的HTML页查看的时候,它就会显示出来。你也必须为新的活动创建活动产品的对照参考。

 

1.      Microsoft InfoPath中选择需要工作产品对照参考的工作流。

2.      在新的CrossType字段,设定CrossType(参照类型)字段为所需的工作产品类型。以下列表标识的是不同的工作产品的类型。每个类型决定了当内容被显示时显示的图标。
Microsoft Excel - WorkProduct-Excel

Microsoft Word - WorkProduct-Word
Microsoft Project - WorkProduct-Project
Microsoft PowerPoint - WorkProduct-PPT
Microsoft Visual Studio Team System - WorkProduct-VS

3.      Cross Name字段。输入工作产品的名字,一定要和工作产品内容项中的ContentName字段的内容一致。

4.      保存你的修改。
注意:你可以使用同样的步骤实现从活动来参照工作产品。

 

查看工作流的变更

当你变更了工作流,你将希望在HTML页上浏览一下这些更改以确保显示的正确。你必须确保在Microsoft InfoPath中没有打开任何过程指南内容中的XML原始文件。每一个活动都有一个与之联系的HTML页,这个HTML页可通过Index标签页进行访问。

 

查看你的工作流的改变

To view your changes to a workstream

1.      关闭Microsoft InfoPath

2.      IE 里打开 Wss\Process Guidance\Source\ProcessGuidance.htm 文件。

3.      点击 Index 标签页。

4.      在左边的菜单中,点击 Workstream标签页。

5.      在工作流列表中,点击你希望查看的工作流。

6.      你可以在工作流页中看到本工作流的描述、入口条件、活动、退出条件。

 

创建新的活动

活动是为达到某个目标或完成某型工作而执行的步骤的集合。例如,为Bug编写修复代码这个活动包括三个步骤:重写代码、写新的代码、在已经存在的代码文件中写代码。你可以为你的软件开发过程创建新的活动,来定义特殊的细节。

 

创建新的活动

To create a new activity

1.      Microsoft InfoPath打开Wss\Process Guidance\Source\XML目录下的ProcessGuidance.xml文件。

2.      Insert 菜单上选择 SectionContentItem。一个新项就显示在内容项列表的末尾。

3.      在内容项窗体,设定ContentType字段为 Activity

4.      ContentName字段,输入唯一的名字标识这个活动。这个名字必须在所有内容项中是唯一的,以确保在不同的内容项之间的工作正确链接。

5.      ContentDescription字段,输入描述信息。

6.      保存你的修改。

 

添加活动的步骤

活动的步骤为活动按照怎样的规则执行提供了详细的指南。每个步骤都必须是可描述的,具有可行性的,相互截然不同的。每个步骤都必须明确指出如何输入到活动中,如何转化到活动结束的输出中。

 

向活动中添加一个步骤

To add a step to an activity

1.      Microsoft InfoPath 中选择你需要添加步骤的活动。

2.      如果没有Part节就创建一个。你可以通过点击InsertItem链接到EntryCritera节的下面来创建一个Part节。

3.      设置PartType字段为Step

4.      PartName字段,输入步骤的名字,这个名字将在随后的活动执行中被使用。

5.      Sequence字段,输入一个序列号保证每个步骤按照正确的顺序被执行。例如,如果某个步骤应该被第一个执行,这个序列必须被设为1

6.      如果这个步骤必须执行,就选择 IsRequired字段。否则就清除IsRequired字段。

7.      PartDescription字段,输入步骤的描述信息。
注意:如果你需要创建多个Part描述信息,在PartDescription节鼠标右键,然后再选择InsertPartBlow

8.      保存你的修改。

 

添加活动到工作流

当你创建了一个新的活动,它需要和一个或多个工作流有联系,工作流是活动的容器。允许任何人查看一个工作流中有哪些活动在执行。使用以下过程将一个新的活动关联到一个已经存在的工作流中。

 

添加活动到工作流

To add an activity to a workstream

1.      Microsoft InfoPath中选择希望包含你的活动的工作流。

2.      如果没有Part节,就创建一个。你可以通过点击InsertItem链接到EntryCriteria节的末尾来创建一个Part节。

3.      设定PartType字段为Step

4.      PartName字段,输入活动的名字,一定要和活动内容项中的ContentName字段中显示的名字一样

5.      Sequence字段,输入一个序号,保证活动按照相应的顺序来执行。例如,某个活动第一个被执行,它的序号必须被设为1

6.      如果这个步骤必须执行,就选择 IsRequired字段。否则就清除IsRequired字段。

7.      PartDescription字段,输入步骤的描述信息。
注意:如果你需要创建多个Part描述信息,在PartDescription节鼠标右键,然后再选择InsertPartBlow

8.      保存你的修改。

 

为活动建立RACI信息

创建完活动后,你需要标识在活动中使用了哪些规则,以及他们如何使用的。这些信息是用RACI节建立的。在MSF敏捷软件开发中,只有依赖和参考规则会被解释。虽然允许存在多个参考规则,但是一个好的准则是只有一个依赖规则。

 

添加一个RACI规则到活动中

To add a RACI role to an activity

1.      Microsoft InfoPath中选择需要RACI信息的活动。

2.      如果没有RACI节,就创建一个。可以通过点击InsertItem链接到最后的Part节的末尾来创建一个RACI节。

3.      RACIType字段为Responsible, Accountable, Consulted, Informed ,这取决于活动里的规则的关系。

4.      RoleName字段中,输入规则的名字,要保证和规则内容项中的ContentName字段显示的内容一样。

5.      保存你的变更。

 

为活动添加入口和退出条件

虽然入口条件是一个可选节,但是发现通常可以很好的定义活动。在活动启动之前通常需要完成一个或一组事件。有一种事件类型是时间。以时间为基础的事件要放到When节中。依赖是另一个类型的事件。这些事件确定了必须完成哪些时间才能开始活动。

 

添加入口条件到活动中

To add entry criteria to an activity

1.      Microsoft InfoPath中选择需要入口条件的活动。定位到Entry Criteria节。

2.      When字段,输入描述以时间为基础的事件,这个事件决定了活动什么时候开始。

3.      Dependeccy Name字段,输入这个项的名字,活动依赖它才能开始。

4.      Dependency Description 字段,输入依赖的描述信息,例如在活动开始前这个项必须处于什么状态。
注意:如果你必须要多个依赖,在Dependency节鼠标右键,点击InsertDependencyItemBelow

5.      如果没有CriteriaType节,就创建一个。可以通过点击InsertItem链接到最后的CrossType节来创建一个CriteriaType节。

6.      CriteriaType字段为Entry

7.      CriteriaName字段,输入活动开始前必须执行的条件的名字。

8.      CriteriaDescription中输入有关条件的更多的描述信息。
注意:如果你需要创建多个入口条件,右键点击CriteriaType节并且点击InsertCriteriaItemBelow

9.      保存你的变更。

 

添加退出条件到活动中

To add exit criteria to an activity

1.      Microsoft InfoPath 中选择需要退出条件的活动。

2.      如果不存在CriteriaType节,就创建一个。你可以通过点击InsertItem链接到最后的CrossType节的末尾来创建一个条件。

3.      设定CriteriaType字段为Exit

4.      CriteriaName字段,输入在活动结束前必须完成的条件的名字。

5.      CriteriaDescription字段,输入有关这个条件的详细信息。
注意:如果你需要创建多个退出条件,右键点击CriteriaType节,然后点击InserCriteriaItemBelow

6.      保存你的变更

 

查看活动的修改

当你修改了一个活动后,你会希望重新浏览一遍HTML页面的改变情况,以确保它们的显示正确。你必须确保没有过程指南相关的XML原始文件被Microsoft InfoPath打开。每一个活动都有一个与之联系的HTML页,这个HTML页可通过Index标签页中的工作流进行访问。

 

查看你对活动进行的修改

To view your changes to an activity

1.      关闭Microsoft InfoPath

2.      IE中打开Wss\Process Guidance\Source\ProcessGuidance.htm文件。

3.      点击Index标签。

4.      在左边的菜单点击Workstreams标签。

5.      在工作流列表,点击链接到指定活动的工作流。

6.      在工作流页面,点击指定的活动。

7.      你可以看到活动页上列出的活动的描述、入口条件、步骤、退出条件。

 

编写工作项文件

一个工作项就是一个工作的纪录,包含了特殊的如:bug工作项纪录与发现、分析、修复bug有关的工作。你可以创建一个附加的工作项来定义你的软件开发过程中的特别的细节。

 

编写新工作项文档

1.      使用Microsoft InfoPath打开ProcessGuidance.xml文件。原始XML文件在Wss\Process Guidance\Source\XML目录中

2.      Insert菜单,选择SectionContentItem。新的内容项显示在内容项列表的底端。

3.      在内容项窗体中,设Content Type字段为WorkItem

4.      Content Name字段输入一个唯一的工作项名字。例如:bug,或issue。这个名字必须是在整个内容项中是唯一的,以确保不同内容项之间的链接正确。

5.      Content Description字段,输入这个工作项的描述信息。

6.      保存你的修改。

 

工作项字段

工作项字段是由过程模版中的工作项XML部分定义的。你可以在以下步骤中在过程指南中的每一个字段进行描述。

 

编写工作项字段

1.      Microsoft InfoPath中选择工作项。

2.      在选好的工作项中,定位到Part节,此节位于Entry Criteria登录节的下面。

3.      如果Part节不存在,就通过点击Insert Item链接来创建一个。

4.      设定Part Type 字段为 Field

5.      Part Name 字段,输入工作项字段的名字。这个名字必须和团队成员在工作项窗口看到的字段标签一致。

6.      Sequence Number 字段,输入一个数值。这个数值决定了这个工作项字段在过程向导内容列表中的顺序。

7.      如果工作项字段必须包含数据,就选择 Is Required 字段,否则就清除 Is Required 字段。

8.      Part Description 字段,输入描述信息。

9.      在你的工作项类型中为每一个字段重复9-14步骤的操作。

10. 保存此窗体,退出 InfoPath

 

工作项状态

工作项状态也是由过程模版中的工作项XML部分定义的。你可以在以下步骤中在过程指南中的每一个字段进行描述。

 

编写工作项状态

To document states for a work item

1.      Microsoft InfoPath 中选择工作项。

2.      在被选好的工作项上,定位到 StatesTransitions,和Reasons 节。

3.      如果State节不存在,就点击 Insert Item链接来创建一个。

4.      State Name 字段,输入状态的名字,例如 Active Resolved。这个名字必须和团队成员在工作项窗口的状态字段看到的内容一致。

5.      Sequence Number 字段,输入数值。这个数值决定了在过程指南内容中所列状态的顺序。通常,都会争取将工作流中的状态列表的顺序设为一致。

6.      在你的工作项类型中为每一个状态重复5-7步的操作。

7.      保存本窗口并关闭InfoPath

 

工作项转换

工作项转换也是由过程模版中的工作项XML部分定义的。转换描述的是工作项的工作流信息。通过描述每个转换发生的原因来编写工作流文档。

 

编写工作项转换

To document transitions for a work item

1.      Microsoft InfoPath 中选择工作项。

2.      在被选好的工作项上,定位到 StatesTransitions,和Reasons 节。

3.      找到你想加入转换的那个State节上。

4.      设定 Transition Type Reason

5.      State Name 字段,输入状态的名字,例如 Active Resolved。这个名字必须和团队成员在工作项窗口的状态字段看到的内容一致。

6.      Sequence Number 字段,输入数值。这个数值决定了在过程指南内容中所列状态的顺序。通常,都会争取将工作流中的状态列表的顺序设为一致。

7.      在你的工作项类型中为每一个状态重复5-7步的操作。

8.      保存本窗口并关闭InfoPath

 

链接工作项到活动和工作流中

当团队成员查看工作项页时,会显示与这个工作项有关的活动和工作流的附加链接信息。这些链接命名为活动和工作流。点击链接,就会显示与这个工作项有关的活动或工作流的图形化视图。按照下面的步骤将新的工作项链接到活动和工作流。

 

链接一个工作流到活动和工作流

To link a work item to an activity and workstream

1.      Microsoft InfoPath 中选择链接到工作项的活动。

2.      如果没有CrossType节就创建一个。可以通过点击InsertItem链接到认证节的末尾,来创建一个CrossType节。

3.      CrossType字段为WorkItem

4.      CrossName字段,输入工作项的名字,确保它和工作项的内容项的ContentName字段的内容一致。

5.      Cross Description 字段,输入执行此活动时,此工作项所处的状态的名字。输入的状态名要确保和在工作项的内容项的ContentName字段的内容一致。
注意:当活动链接到一个工作项的时候,活动所属的工作流将自动链接到此工作项。

 

查看工作项的变更

当你变更了工作项,你将希望在HTML页上浏览一下这些更改以确保显示的正确。你必须确保在Microsoft InfoPath中没有打开任何过程指南内容中的XML原始文件。每一个工作项都有一个与之联系的HTML页,这个HTML页可通过WorkItems标签页进行访问。

 

查看你的工作项的变更

To view your changes to a work item

1.      关闭Microsoft InfoPath

2.      IE中打开Wss\Process Guidance\Source\ProcessGuidance.htm文件。

3.      点击WorkItem标签页。

4.      在左边菜单,点击你希望查看的工作项。

5.      在工作项页,点击你希望看到的工作项的部分。(概述、状态、转换、字段、活动、或工作流)

 

创建新规则

规则是软件开发项目中执行一系列特殊活动的保障。项目成员采用一个或多个规则。你可以在你的软件开发过程中定义特殊的细节来创建其它的规则。

 

创建新规则

To create a new role

6.      Microsoft InfoPath 打开Wss\Process Guidance\Source\XML 目录下的 ProcessGuidance.xml文件。

7.      Insert菜单,选择SectionContentItem。新内容项显示在内容项列表的底端。

8.      在内容项窗体中,设定ContentType字段为Role

9.      ContentName字段,输入唯一的规则名。如开发者、测试者。这个名字必须在整个内容项中是唯一的。确保内容项之间的链接工作正确。

10. ContentDescription字段,输入对这个规则的详细描述。

11. 保存你的更改。

你创建完规则后,需要回顾一下在已经存在的工作流和活动中的RACI信息,看看是否新的规则关联到它们。

 

查看规则的变更

当你修改了一个规则后,你会希望重新浏览一遍HTML页面的改变情况,以确保它们的显示正确。你必须确保没有过程指南相关的XML原始文件被Microsoft InfoPath打开。每一个规则都有一个与之联系的HTML页,这个HTML页可通过Roles标签页进行访问。

 

查看新规则

To view the new role

1.      关闭Microsoft InfoPath

2.      IE中打开Wss\Process Guidance\Source\ProcessGuidance.htm文件

3.      点击Roles标签页,在AboutRoles页,你可以在列表中看到新的规则。

4.      点击新的规则,你可以看到你输入的有关此规则的描述信息。

 

交叉引用

交叉引用向允许你将外部链接当成内部内容使用提供支持。本节分三个步骤来讨论交叉引用:下一步、又见、案例和实践。在团队成员查看过程指南页的时候,每一节都会显示在左手列中。

 

创建一个交叉引用

To create a cross reference

1.      Microsoft InfoPath 打开Wss\Process Guidance\Source\XML 目录下的 ProcessGuidance.xml文件。

2.      选择需要next step的内容项。

3.      如果没有Cross Type节,就通过点击Insert链接创建一个。

 

1.      Use Microsoft InfoPath to open the ProcessGuidance.xml file. The source XML files are located in the Wss\Process Guidance\Source\XML folder.

2.      Select the content item requiring a next step.

3.      If a Cross Type section does not already exist, create one by clicking the Insert item link.

下一步

下一步是正确完成工作流或活动之后建议运行的。下一步链接到其它的工作流或活动。

创建一个新的下一步引用

To create a next step reference

1.      在新的CrossType节,设定CrossType字段为NextStep

2.      CrossName字段,输入活动或工作流的名字。确保和内容项中的ContentName字段显示的内容一致。

3.      保存你的变更。

 

又见

又见引用是在局域网网和互联网上链接到Web的内容。使用又见引用链接Web内容来描述具体的内容项。也将帮助团队成员尝试理解此内容项。

 

创建一个又见引用

To create a see also reference

1.      CrossType节,设定CrossType字段为SeeAlso

2.      CrossName字段,输入链接Web内容的描述信息。

3.      CrossLink字段,输入定位Web内容的URL

4.      保存你的变更。

 

案例和实践

案例和实践是描述你的内容项的指南。使用这些参考将帮助团队成员准确的找到连接工作流、活动、规则的指南。

 

创建一个案例和实践引用

To create a patterns & practice reference

1.      CrossType节,设CrossType字段为PatternPractices

2.      CrossName字段,输入描述案例和实践的名字。

3.      CrossLink字段,输入链接到案例或实践内容的URL

4.      保存你的变更。

 

编写概述页文档

 

MSF过程指南包含了多个概述页。通过点击概述标签页显示这些概述页,例如概念页、管理页。也可以通过别的标签页显示。例如,点击Roles标签页显示AboutRoles概述页。

 

这些页的内容都可以修改。但是除非修改框架,否则不能添加页或删除已经存在的页。修改框架不在本主题内讨论。

 

多数的概述页都有对应的XSL文件,在某些情况下,XSL是用于解释页的控制器。如果你要修改页,就必须修改XSL文件,而不是原始XML文件。

 

所有的MSF过程指南的概述页如下表所列。还列出了每个页对应的XSL文件,以及这些页的内容来源的位置。如果内容来源是XSL文件,你必须编辑XSL文件才能修改页的内容。

 

 

名字

Name

描述

Description

XSL文件

XSL File

内容来源

Content Source

概念

Concepts

The overview page for MSF.

Concepts.xsl

Concepts.xsl

周期和迭代

Cycles and Iterations

The overview page explaining how cycles and iterations work in MSF.

Iterations.xsl

Iterations.xsl

监管

Governance

The overview page explaining how team projects are governed in MSF.

Governance.xsl

ProcessGuidance.xml

原则

Principles

The overview page explaining the principles of MSF.

Principles.xsl

ProcessGuidance.xml

团队模型

Team Model

The overview page explaining roles and their responsibilities to the team.

Teammodel.xsl

Teammodel.xsl

创新

Mindsets

The overview page explaining the mindset of the team.

Mindsets.xsl

ProcessGuidance.xml

关于规则

About Roles

规则标签页的关于页

The About page for the Roles tab.

Aboutroles.xsl

ProcessGuidance.xml

关于周期

About Cycles

在视图标签页下的周期的关于页

The About page for cycles on the View tab.

NA

ProcessGuidance.xml

关于服务质量

About Qualities of Service

在视图标签页下的服务质量的关于页

The About page for qualities of service on the View tab.

NA

ProcessGuidance.xml

关于专业领域

About Disciplines

The About page for disciplines on the View tab.

NA

ProcessGuidance.xml

关于跟踪

About Tracks

The About page for tracks on the View tab.

NA

ProcessGuidance.xml

关于视图

About Views

The About page for the Views tab.

Aboutviews.xsl

ProcessGuidance.xml

关于工作项

About Work Items

The About page for the Work Items tab.

Aboutworkitems.xsl

ProcessGuidance.xml

 

 

ProcessGuidance.xml中编辑概述页

如果你想编辑的概述页的原始内容在ProcessGuidance.xml文件中,你可以使用Microsoft InfoPath进行修改。概述页的Content Type设为 Overview。用ContentName字段标识此页。如,关于专业领域页在ProcessGuidance.xml文件中命名为关于专业领域。

 

XSL文件中编辑概述页

如果你要编辑的概述页的原始内容位于XSL文件中,你必须在编辑器中打开这个XSL文件(如Nodpad或微软FrontPage)来对此文件进行修改。XSL文件位于过程指南的原始文件的XSK目录下。

 

编制如何内容和过程

在工具中,内容项如何解释某些活动一步步执行的。如,活动可以要求商业分析建立一个方案列表。然而这个商业分析可能不知道如何建立这样的列表。如何内容项将在Excle中提供创建步骤的列表。通常,如何工作项通过工具映射活动。你可以配置过程指南来包含其它的,可以是任何你和你的团队用到的特别的工具或活动的,如何内容项。

 

如何内容项由一个或多个如何如何过程组成。过程提供了实际执行的步骤。例如如何创建任务的内容项,包含了两个过程:一个是在Excle中创建任务,另一个是在Project中创建任务。

 

创建一个完整的如何内容项,你需要进行以下三步:

1.        创建如何工作项。

2.        创建如何过程内容项。

3.        将如何过程内容项挂到如何如何内容项内。

 

创建如何内容项

1.        Microsoft InfoPathWss\Process Guidance\Source\XML目录下打开ProcessGuidance.xml文件。

2.        InsertItem菜单,选择Section,然后再选择ContentItem。新的内容显示在内容项列表的底端。

3.        在内容项窗口,设ContentType字段为HowTo

4.        ContentName内容项,输入唯一的名字以标识将执行的内容项是什么。通常,如何内容项是标题格式,“如何<行为>。”这个名字必须在整个内容项中是唯一的,以确保工作项之间的连接能正常的工作。

5.        ContentDescription字段,输入描述信息。

6.        保存你的变更

 

创建如何过程

1.        Microsoft InfoPathWss\Process Guidance\Source\XML目录下打开ProcessGuidance.xml文件。

2.        InsertItem菜单,选择Section,然后再选择ContentItem

3.        新的内容显示在内容项列表的底端。

4.        在内容项窗口,设ContentType字段为HowToProcedure

5.        ContentName内容项,输入唯一的名字以标识将执行的过程是什么。通常,如何过程是标题格式,“如何<执行行为>。”这个名字必须在整个内容项中是唯一的,以确保工作项之间的连接能正常的工作。

6.        ContentDescription字段,输入描述信息。

7.        下一步你必须添加过程的步骤编号,每一步都是由Part节描述的。

 

添加如何过程的步骤

1.        如果没有Part节就创建一个。你可以通过点击InsertItem连接到EntryCritera节来创建一个Part节。

2.        PartType字段为Step

3.        Sequence字段,输入一个序列号以确保步骤是按照指定的顺序进行的。如,某个步骤必须第一个执行,那它的值必须是1

4.        如果这个步骤必须被执行,就选择IsRequired字段。否则就清楚IsRequred字段。

5.        PartDescription字段,输入步骤的描述信息。每个步都必须干净、简明以及解释为简单的行为。

6.        以同样的方式将过程中的步骤一一创建。

最后你必须将过程关联到如何内容项中。

 

关联过程到如何内容项

1.        ProcessGuidance.xml文件中,选择需要关联如何过程的如何内容项。

2.        如果没有Part节就创建一个。你可以通过点击InsertItem连接到EntryCritera节来创建一个Part节。

3.        PartType字段为Step

4.        PartName字段,输入如何过程的名字,这个名字要和显示在如何过程项的ContentName字段的内容一致。

5.        Sequence字段,输入一个序列号以确保步骤是按照指定的顺序进行的。如,某个步骤必须第一个执行,那它的值必须是1

6.        如果这个步骤必须被执行,就选择IsRequired字段。否则就清楚IsRequred字段。

7.        保存你的变更

 

编制过程指南报告文档

当团队项目在不断进展的时候,报表聚合了各种信息指标。这些信息将帮助项目经理和领导监控团队项目是否正常运行并做出决定。如果你想创建或修改报表,你需要在过程指南里提供相应的文档,帮助团队成员理解这个报表的目的,以及如何解读这个报表。

 

编制新报表文档

1.        Microsoft InfoPathWss\Process Guidance\Source\XML目录下打开ProcessGuidance.xml文件。

2.        InsertItem菜单,选择Section,然后再选择ContentItem。新的内容显示在内容项列表的底端。

3.        在内容项窗口,设ContentType字段为Report

4.        ContentName内容项,输入唯一的报表名字。这个名字必须在整个内容项中是唯一的,以确保工作项之间的连接能正常的工作。

5.        ContentDescription字段,输入描述信息。

6.        保存你的变更。

 

数据序列

数据序列是报表的主要部分,它标志了一些独特的计量方式,例如区域图的顶端,一条线,一个圆。你可以为每个数据串进行详细的描述,以帮助读者正确的理解报表。

 

添加数据序列

1.        ProcessGuidance.xml文件中,选择需要加数据序列的报表。

2.        如果没有Part节就创建一个。你可以通过点击InsertItem连接到EntryCritera节来创建一个Part节。

3.        在内容项窗口,设ContentType字段为DataSeries

4.        ContentName内容项,输入数据序列的名字。通常这个名字和报告标题发名字是一样的。

5.        PartDescription为描述数据序列信息。包含如何解释数据的细节。

6.        保存你的修改。

 

添加运行正常的和运行不正常的报表的示例

你可以用包含正常运行和不正常运行的图形的报表来帮助读者理解如何解释报表中的数据。正常运行的图形示例显示目前看起来哪些很好的报表,并且解释这些数据怎样说明项目的正常情况。一个或多个不正常运行报表示例用不同方式显示项目中哪些数据说明了一个或多个问题。每一个图形都包含了一段内容解释为什么这个图片是正常运行的报表或不正常。

 

添加运行正常和运行不正常的报表的示例

1.        首先,从报表中获取图片。你可以用真实的数据得出的真实报表或有意的数据得出的希望获得的报表来做这件事。另外一个方法是。这个图片必须保存为gifjpg格式的文件。

2.        ProcessGuidance.xml文件中,通过点击窗体顶端的Image按钮定位到图像列表。

3.        Insert菜单,选择Section,然后选择ImageMenu

4.        新图像菜单显示在图像列表的底端。

5.        在新图像残端窗口,设MenuName字段为唯一的名字以标识此图像。例如,“unhealthyproductivity”这个名字标识一个不正常运行的生产力报表的示例图片。我们认为将名字全都小写可以使我们在后面的工作中更容易理解其含义。

6.        设定MenuImage字段为图片的目录和文件名。所有MSF的图片都存在一个目录下。例如,如果unhealthyproductivity.gifimage目录下,你就设MenuImage字段为“images/unhealthyproductivity.gif”。

7.        MenuDescription字段,输入描述信息。

8.        保存你的修改。

 

下一步你必须使你的图片和报表之间有联系。如果图片没有与报表建立联系,将无法显示图片。

 

建立正常运行或不正常运行的图像与报表之间的联系

1.        ProcessGuidance.xml中选择需要与图片建立联系的报表。

2.        如果没有Part节就创建一个。你可以通过点击InsertItem连接到接近内容项末端的Entry Criteria节来创建一个Part节。

3.        PartTypeImageMenuReference

4.        如果这个示例是一个正常运行的示例,设PartNameReportImageMenuHealthy。如果是一个不正常运行的示例,设PartNameReportImageMenuUnhealthy。这些值是区分大小写的。必须输入正确,否则图像将不会显示。

5.        PartDescription字段为图像的名字,确保你输入的和MenuName字段的一致。

6.        保存你的修改。

 

编制视图文档

视图为项目成员提供了对活动进行不同方式的分类的途径。以下有四种分类视图:专业领域、服务质量、周期、跟踪。

 

专业领域

本视图组将叙述专业领域的活动组织在一起。例如,点击项目管理者的专业领域的视图,你可以看到所有的在过程指南中与项目管理有关的工作流和活动。

服务质量

本视图描述的是按照不同的要求使用不同方式的服务质量。例如,点击服务质量安全性视图,你可以看到所有与服务质量的安全性有关的所有工作流和活动。

周期

本视图描述的是执行活动的频率。例如,点击每日生成周期视图,你可以看到与每日生成周期有关的所有工作流和活动。

跟踪

此视图描述的是对通向监管检查点的活动进行分组。例如点击计划跟踪,你可以看到与执行计划有关的所有工作流和活动。

 

你可以通过以下过程修改视图和添加新的视图。

添加新视图

1.        Microsoft InfoPathWss\Process Guidance\Source\XML目录下打开ProcessGuidance.xml文件。

2.        Insert菜单,选择Section,然后选择ContentItem

3.        新内容项显示在内容项列表的底端。

4.        在内容项窗体,设定ContentType字段为你创建的视图的类型(专业领域、服务质量、周期、跟踪)。

5.        ContentName字段,输入唯一描述你加的视图的类型。这个名字必须在所有内容项中是唯一的,以确保内容项之间的链接工作正常。

6.        保存你的修改。

 

交叉引用视图

下一步,你将通过你创建的视图来交叉引用活动,使你能在被选的视图上看到活动之间的关系。

引用一个视图

1.        ProcessGuidance.xml文件中,选择需要交叉引用到视图中的活动。

2.        如果没有CrossType节就创建一个。你可以通过点击InsertItem连接到接近内容项末端的Verification Type节来创建一个CrossType节。

3.        设定CrossType为你希望交叉引用的视图的类型。有四种可能的值:专业领域、服务质量、周期、跟踪。

4.        CrossName为你创建的视图的名字,你必须输入和视图中的ContentName字段显示一致的名字,否则活动将不会在视图的交叉引用映射中显示。

5.        保存你的修改。

删除内容项

你可以通过选择任何内容项,然后选择EditCut来删除它们。有可能其它内容项原先已经链接到被删除的内容项。例如,如果你删除了一个活动,你必须在所有引用了此活动的工作流中删除此活动所关联的那部分节。否则这些工作流依旧会将此活动列出,但不会链接它。

 

创建HTML内容页

当你修改完过程指南的内容,你必须重新构建HTML页以保证这些内容可以提交给团队成员。MSF创建工具就是为此目的使用的。工具读取源文件并且构建所有所需的HTML文件。MSFWinBuild工具可以从MSF 敏捷软件开发工作平台上下载,路径为http://lab.msdn.microsoft.com/teamsystem/workshop/msfagile/default.aspx.

本文使用的MSFBuild就包含此工具。