“跟踪配置文件设计器”示例

Download sample

工作流跟踪配置文件设计器是一种工具，可支持使用工作流设计器图面依据工作流定义创建跟踪配置文件。 此示例应用程序假设您熟悉跟踪配置文件和服务。 有关更多信息，请参见本主题末尾的参考。

生成示例

1. 通过单击本主题中的**“下载示例”**来下载该示例。

   这会将示例项目提取到本地硬盘。

2. 单击**“开始”，依次指向“程序”和“Microsoft Windows SDK”，然后单击“CMD 外壳”[CMD Shell]**。

3. 转到示例的源目录。

4. 在命令提示符处键入 MSBUILD <解决方案文件名>。

运行示例

• 在 SDK 命令提示窗口中，运行 TrackingProfileDesigner\bin\debug 文件夹（对于该示例的 VB 版本为 TrackingProfileDesigner\bin 文件夹）中的 .exe 文件，该文件夹位于该示例的主文件夹下。

创建跟踪配置文件

按照以下过程添加和配置活动跟踪点以及打开跟踪配置文件。

创建活动跟踪点

1. 在**“File”（文件）菜单中，单击“Open”（打开），然后单击“Workflow From File”（文件中的工作流）**。

2. 定位到包含要使用的工作流的程序集，然后单击**“Open”（打开）**返回到工作流跟踪配置文件设计器主屏幕。

3. 在设计器图面上，单击一个活动将其选中。

   这将在工具栏上启用**“Track”（跟踪）**按钮。

4. 单击**“Track”（跟踪）**以跟踪选定的活动。

配置活动跟踪点

1. 单击**“Events”（事件）**以选择想要跟踪选定跟踪点的活动状态事件。

   可以通过单击**“Select All”（全选）或“Select None”（全部不选）**来选择所有事件或不选择任何事件。

2. 单击**“Annotate”（批注）以打开“Annotation”（批注）**工具条。

3. 在文本框中，输入字符串来描述活动跟踪点。

4. 单击**“Extract Data”（提取数据），然后在列表中选择“Properties”（属性）**以选取将为此活动跟踪的元素。

5. 选择**“Match Derived Types”（匹配派生类型）**，指示此跟踪点将匹配选定的活动类型和所有派生类型。

6. 还可以添加条件来筛选所发出跟踪点的集合。

添加跟踪条件

1. 在选定活动跟踪点上单击**“Conditions”（条件），并选择“Add new condition”（添加新条件）**。

2. 在**“Conditions”（条件）**工具条中，选择将出现在条件左边的成员，例如，Name。

3. 单击**“==”**按钮在相等和不相等 (!=) 之间切换。

4. 输入将出现在条件右边的字符串值，例如，codeActivity1。

5. 单击**“Save”（保存）**添加已完成的条件。

打开跟踪配置文件

1. 在**“File”（文件）菜单中，单击“Open”（打开），然后单击“Profile From File”（文件中的配置文件）**。

2. 选择要使用的跟踪配置文件，然后单击**“Open”（打开）**。

提示

必须加载工作流，然后才能打开跟踪配置文件。 此外，只有用此工具生成的配置文件才能保证可正确加载。

保存跟踪配置文件

1. 在**“File”（文件）菜单上，单击“Save”（保存），然后单击“Profile as File”（将配置文件另存为文件）**。

2. 使用 .xml 扩展名输入路径和文件名。

3. 单击**“Save”（保存）**以保存跟踪配置文件。

使用 SQL 跟踪数据库

如果设置了 SQL 跟踪数据库，您还可以将配置文件保存到数据库。 如果尚未创建跟踪数据库，请参阅“简单的跟踪”示例中的数据库设置说明。

将应用程序与 SQL 跟踪数据库结合使用

1. 将包含有效 ConnectionString 的应用程序的 .config 文件更新到配置文件数据库。

   默认配置文件看起来如下所示：

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
       <appSettings>
           <add key="ConnectionString" value="Persist Security Info=False;Integrated Security=SSPI;database=TrackingStore;server=localhost"/>
       </appSettings>
   </configuration>
   

2. 在**“File”（文件）菜单上，单击“Save”（保存），然后单击“Profile to SQL Tracking Database”（将配置文件保存到 SQL 跟踪数据库）**，以便将当前配置文件保存到跟踪数据库。

   如果数据库中的版本比当前配置文件新，则在保存配置文件之前会出现一个对话框并请求更新的版本。

3. 在**“File”（文件）菜单上，单击“Open”（打开），然后单击“From SQL Tracking Database”（从 SQL 跟踪数据库中）**，以便从跟踪数据库中加载配置文件。

   将出现一个对话框，并允许您选择工作流类型和配置文件版本。 如果工作流程序集不在与设计器相同的路径中，则会出现另一个对话框，并请求所需程序集的位置。

备注

• 由于此应用程序是一个示例，因此其用途可能会有某些限制。

• 只有由配置文件设计器创建的跟踪配置文件才能保证可正确加载。 这是因为设计器将创建单一活动跟踪位置，并假设该位置对于特定跟踪点将存在。

• 将按工作流类型保存跟踪配置文件。 若要将配置文件保存为默认跟踪配置文件，您可以调用存储过程 UpdateDefaultTrackingProfile。

• 只会为最外面的复合活动显示批注。

• 无法通过设计器添加 UserTrackPoints。

请参见

其他资源

Creating and Using Tracking Profiles
Windows Workflow Tracking Services
Creating Custom Tracking Services
“文件跟踪服务和查询”示例
Task 4 : Using the Windows Workflow Tracking Service
应用程序示例

版权所有 (C) 2007 Microsoft Corporation。保留所有权利。