Microsoft Project Server 数据库信息

本文档提供 Microsoft Project Server 数据库中数据存储方式的信息，包括如何访问那些关系最密切的数据。本文档也提供了 Microsoft SQL Server 脚本示例，以供访问该数据时使用。可以运行这些脚本示例并用于 Microsoft Data Engine (MSDE) 或 Microsoft SQL Server 数据库，如果要经常运行这些脚本，则可将其作为存储过程的一部分使用。可以方便地修改或扩展这些脚本以获取与您的单位关系更为密切的信息。

注释   脚本 WEBTBLS.sql、VIEWTBLS.sql 和 CUBETBLS.sql 可创建本文档中描述的数据库表。可在 Microsoft Project Server CD-ROM 中的 \SUPPORT\DATABASE 文件夹中找到这些脚本。

Microsoft Project Server 进行了扩展并包括以下整体性能的提高：

• 安全性表
• 专用视图表
• 支持创建“工作分配”多维数据集和“资源”多维数据集
• 支持企业功能

Microsoft Project Server 数据库中已添加了下列表：

以下部分详细讲述了 Microsoft Project Server 所支持的数据库以及如何使用数据库中的数据。

Microsoft Project Server 支持下列数据库：

• Microsoft SQL Server 2000
• Microsoft Data Engine 2000 或更新版本

Microsoft Project Server 在数据库上执行几种类型的操作，每种操作都需要 Microsoft SQL Server 2000 中的 DATA READER 或 DATA WRITER 权限。若要将新项目保存到空数据库中，或者要有选择地将数据导出到数据库中，用户还必须拥有 CREATE TABLE 权限。除了有效的登录标识号之外，SQL Server 用户还必须拥有访问项目数据库的权限。个别用户通过 Microsoft Project Web Access 访问数据，因此他不需要直接访问 Microsoft Project Server 的权限。

在 Microsoft Project Server 数据库表中设置触发器可能导致数据损坏或返回意外的结果。请注意以下重要内容：

• INSERT 或 UPDATE 触发器所启动的任何过程均不会改变 @@identity 属性。
• INSERT 或 UPDATE 触发器所触发的程序不应执行在表中插入“标识”列的“插入”操作，否则该程序将生成由 Microsoft SQL Server 2000 创建的“标识”值。

Microsoft Project Server 支持集成数据库。对于 Microsoft Project Standard 用户，该数据库用于存储通过 Microsoft Project Web Access 添加或查看的数据。对于 Microsoft Project Professional 用户，该数据库用于存储 Microsoft Project 和 Microsoft Project Web Access 数据。

在以下示例中，Microsoft Project 支持使用数据源名称 (DSN) 连接到服务器：

• Microsoft Project Standard 需要使用 DSN 连接到服务器。
• 在脱机模式下，Microsoft Project Professional 需要使用 DSN 连接到服务器。
• 在联机模式下，Microsoft Project Professional 不能使用 DSN 连接到服务器。

用户确定运行 Microsoft Project Server 的服务器时，与该服务器的连接信息自动传送到 Microsoft Project。若要将 Microsoft Project 连接到使用 DNS 的服务器，请执行下列操作之一：

若使用 Microsoft Project Standard：

若在脱机模式下使用 Microsoft Project Professional：

注释   如果多名用户需要访问同一数据库中的项目，并非所有更改数据的用户需要使用相同的 DSN 连接到该数据库。Microsoft Project 将 DSN 和项目名称（或连接字符串）组合保存为标识符以使用下列格式定位项目：<DSN>\项目名称。

Microsoft Project 中的 DSN 限制：

• 无法为以下项目链接使用 DSN：如资源库、共享文件、外部相关性（跨项目链接）或插入的项目。
• 如果多名用户修改数据库，他们将无法通过在“另存为”对话框的“保存类型”列表中选择 .mpd 或 .mdb 文件类型来保存文件。
• Microsoft Project 记录登录密码和其他连接信息。在单台计算机上，多名用户无法使用同一用户标识号分别或同时登录数据库。创建连接后，即使在登录时输入不同的登录名和/或密码也将再次使用该连接。若要使用不同的用户标识号登录，必须关闭使用该 DNS 打开的所有项目。如果同时存在其他连接，必须为所有的用户标识号创建其他的备用 DNS。
• 决不可使用 DNS 打开企业全局模板。这可导致与数据库的冲突，并可导致数据放置位置的紊乱。

此脚本组返回有关 Microsoft Project Server 数据库表中所存储信息的一般统计数据。

以下脚本提取当前存储在 Microsoft Project Server 数据库中的所有项目、每个项目的项目经理的姓名和每个项目的工作分配总数量的列表。

select
   PROJ_NAME as Project,
   RES_NAME as Project_Manager,
   (select count(*) from MSP_WEB_ASSIGNMENTS a 
      where  a.WPROJ_ID = p.WPROJ_ID) as Assignments
from
   MSP_WEB_PROJECTS p,
   MSP_WEB_RESOURCES r
where
      p.WRES_ID = r.WRES_ID
and   p.WPROJ_ID <> 1 
order by
   PROJ_NAME,
   RES_NAME

以下脚本提取当前在 Microsoft Project Server 数据库中存储了工作分配的所有资源、每个资源所分配的项目名称和每个项目的工作分配总数量的列表。

select
   RES_NAME as Resource,
   PROJ_NAME as Project,
   count(*) as Assignments
from
   MSP_WEB_PROJECTS p,
   MSP_WEB_ASSIGNMENTS a,
   MSP_WEB_RESOURCES r
where
      r.WRES_ID = a.WRES_ID
and   a.WPROJ_ID = p.WPROJ_ID
and   p.WPROJ_ID <> 1
group by
   PROJ_NAME,
   RES_NAME

以下脚本提取当前在 Microsoft Project Server 数据库中存储了未删除 Microsoft Project Server 消息的所有资源、与消息关联的项目名称和每个项目的未删除消息总数量的列表。

select
   r.RES_NAME as Receiver,
   PROJ_NAME as Project,
   count(*) as Undeleted_Messages
from
   MSP_WEB_PROJECTS p,
   MSP_WEB_MESSAGES m,
   MSP_WEB_RESOURCES r
where
      r.WRES_ID = m.WRES_ID_RECEIVER
and   m.WPROJ_ID = p.WPROJ_ID
and   p.WPROJ_ID <> 1
group by
   RES_NAME,
   PROJ_NAME

以下脚本提取当前存储在 Microsoft Project Server 数据库中的已被请求的所有状态报告、请求报告的项目经理姓名和被请求进行报告的资源名称的列表。

select
   WREPORT_NAME as Report,
   m.RES_NAME as Project_Manager,
   r.RES_NAME as Resource
from
   MSP_WEB_STATUS_REPORTS p,
   MSP_WEB_STATUS_REQUESTS q,
   MSP_WEB_RESOURCES m,
   MSP_WEB_RESOURCES r
where
   p.WRES_ID_MGR = m.WRES_ID
and   p.WSR_ID = q.WSR_ID
and   q.WRES_ID_RECEIVER = r.WRES_ID

以下脚本提取在 @cur_date（当前日期）变量之前的所有状态报告及其最新答复的列表。并且，所列出的状态报告必须在 @start_date 和 @end_date 变量间有一个周期性的开始日期。

--declare the variables
declare @start_date as datetime
declare @end_date as datetime
declare @cur_date as datetime
--set the variable values
set @start_date = '2001-09-09'
set @end_date = '2001-10-10'
set @cur_date = '2001-09-09'
--select the fields
select
   s.WREPORT_NAME as 'Status Report',
   max(r1.WSUBMIT_DATE) as 'Last Response'
from
   MSP_WEB_STATUS_REPORTS s,
   MSP_WEB_STATUS_RESPONSES r1,
   MSP_WEB_STATUS_FREQUENCIES f
where
      s.WSR_ID = f.WSR_ID
and   s.WSR_ID = r1.WSR_ID
and   f.WREPORT_START_DATE between @start_date and @end_date
and   not exists (select r2.WSR_ID 
      from MSP_WEB_STATUS_RESPONSES r2 
         where r2.WSUBMIT_DATE > @cur_date 
            and s.WSR_ID = r2.WSR_ID)
group by 
   s.WREPORT_NAME

注释   若要使用当前日期，可使用 getdate() 函数代替 cur_date 变量。

以下脚本提取当前存储在 Microsoft Project Server 数据库中的所有项目、每个工作分配的名称和所分配的工作组成员的列表。结果中不包括非工作分配时间。

select
   PROJ_NAME as Project,
   TASK_NAME as Task_Name,   
   RES_NAME as Team_Member
from
   MSP_WEB_PROJECTS p,
   MSP_WEB_RESOURCES r,
   MSP_WEB_ASSIGNMENTS a
where
      a.WRES_ID = r.WRES_ID
and   a.WPROJ_ID = p.WPROJ_ID
and   a.WNWRK_ID is NULL
order by
   PROJ_NAME,
   TASK_NAME

以下脚本在指定日期范围内为特定工作组成员提取时间分段数据的分组、总成型列表。工时类型（排定的、实际的或加班的）也指定为变量。总成型数据先按项目名分组，再按任务名分组，最后按日期分组并给出每种分组级别的总成型工时总和。工时值按小时显示。

declare @res_name as nvarchar(510)
declare @begin_date as datetime
declare @end_date as datetime
declare @work_type as int
-- set these variables
select @res_name = 'Team Member'
select @begin_date = '2001-09-09'
select @end_date = '2001-12-09'
select @work_type = 0 -- 0=scheduled, 1=actual, 2=overtime
-- end user variables
-- function variables
declare @assn_id as int
declare @td_start as datetime
declare @total_days as int
declare @td_value as decimal(25,6)
declare @td_cur_date as datetime
declare @p_name as nvarchar(510)
declare @t_name as nvarchar(510)
-- end function variables
-- create temporary table
create table #tp_data ( td_date datetime, td_hours decimal(25,9), 
   task_name nvarchar(510), proj_name nvarchar(510) )
-- create cursor for data collection
declare td cursor for
select
   a.WASSN_ID, 
   WWORK_START,
   datediff(day, WWORK_START, WWORK_FINISH)+1,
   WWORK_VALUE
from
   MSP_WEB_WORK w,
   MSP_WEB_RESOURCES r,
   MSP_WEB_ASSIGNMENTS a
where
      a.WRES_ID = r.WRES_ID
and   a.WASSN_ID = w.WASSN_ID
and   r.RES_NAME = @res_name
and   w.WWORK_TYPE = @work_type
and   (@begin_date <= WWORK_FINISH or @end_date >= WWORK_START)
order by
   WWORK_START
-- loop through cursor to explode timephased data
open td
fetch next from td into @assn_id, @td_start, @total_days, @td_value
while @@fetch_status <> -1
begin
   select @td_cur_date = @td_start
   while @total_days > 0
   begin
      -- get the task name
      select @t_name = 
         ( select TASK_NAME
         from MSP_WEB_ASSIGNMENTS
         where WASSN_ID = @assn_id )
      -- get the project name
      select @p_name = 
         ( select PROJ_NAME
         from MSP_WEB_PROJECTS p, MSP_WEB_ASSIGNMENTS a
         where a.WASSN_ID = @assn_id and a.WPROJ_ID = p.WPROJ_ID )
      -- insert the data row into the temp table
      insert #tp_data values ( @td_cur_date, @td_value, 
         @t_name, @p_name )
      select @td_cur_date = DATEADD(d, 1, @td_cur_date)
      select @total_days = @total_days - 1
   end
   -- get next row from cursor
   fetch next from td into @assn_id, @td_start, @total_days, @td_value
end
close td
deallocate td
-- display data from temporary table with grouping and rollup
select 
   proj_name as Project,
   task_name as Task,
   td_date as 'Date',
   SUM(td_hours/60000) as 'Total_Work'
from    
   #tp_data
group by proj_name, task_name, td_date with rollup
-- clean up that temporary table
drop table #tp_data

以下脚本在指定日期范围内为特定项目名提取时间分段数据的分组、总成型列表。工时类型（排定的、实际的或加班的）也指定为变量。总成型数据先按工作组成员姓名分组，再按任务名分组，最后按日期分组并给出每种分组级别的总成型工时总和。工时值按小时显示。

declare @proj_name as nvarchar(510)
declare @begin_date as datetime
declare @end_date as datetime
declare @work_type as int
-- set these variables
select @proj_name = 'Microsoft Project'
select @begin_date = '2001-09-09'
select @end_date = '2001-12-09'
select @work_type = 0 -- 0=scheduled, 1=actual, 2=overtime
-- end user variables
-- function variables
declare @assn_id as int
declare @td_start as datetime
declare @total_days as int
declare @td_value as decimal(25,6)
declare @td_cur_date as datetime
declare @tm_name as nvarchar(510)
declare @t_name as nvarchar(510)
-- end function variables
-- create temporary table
create table #tp_data ( td_date datetime, td_hours decimal(25,9), 
   task_name nvarchar(510), team_member nvarchar(510) )
-- create cursor for data collection
declare td cursor for
select
   a.WASSN_ID, 
   WWORK_START,
   datediff(day, WWORK_START, WWORK_FINISH)+1,
   WWORK_VALUE
from
   MSP_WEB_WORK w,
   MSP_WEB_RESOURCES r,
   MSP_WEB_ASSIGNMENTS a,
   MSP_WEB_PROJECTS p
where
      a.WPROJ_ID = p.WPROJ_ID
and   a.WASSN_ID = w.WASSN_ID
and   p.PROJ_NAME = @proj_name
and   w.WWORK_TYPE = @work_type
and   (@begin_date <= WWORK_FINISH or @end_date >= WWORK_START)
order by
   WWORK_START
-- loop through cursor to explode timephased data
open td
fetch next from td into @assn_id, @td_start, @total_days, @td_value
while @@fetch_status <> -1
begin
   select @td_cur_date = @td_start
   while @total_days > 0
   begin
      -- get the task name
      select @t_name = 
         ( select TASK_NAME
         from MSP_WEB_ASSIGNMENTS
         where WASSN_ID = @assn_id )
      -- get the team member name
      select @tm_name = 
         ( select RES_NAME 
         from MSP_WEB_RESOURCES r, MSP_WEB_ASSIGNMENTS a
         where a.WASSN_ID = @assn_id and a.WRES_ID = r.WRES_ID )
      -- insert the data row into the temp table
      insert #tp_data values ( @td_cur_date, @td_value, 
         @t_name, @tm_name )
      select @td_cur_date = DATEADD(d, 1, @td_cur_date)
      select @total_days = @total_days - 1
   end
   -- get next row from cursor
   fetch next from td into @assn_id, @td_start, @total_days, @td_value
end
close td
deallocate td
-- display data from temporary table with grouping and rollup
select 
   team_member as Team_Member,
   task_name as Task,
   td_date as 'Date',
   SUM(td_hours/60000) as 'Total_Work'
from    
   #tp_data
group by team_member, task_name, td_date with rollup
-- clean up that temporary table
drop table #tp_data

以下脚本在指定日期范围内为特定工作组成员提取所有工作分配和相关、关联的工作分配数据的列表。结果脚本将包括摘要工作分配，可以通过在此脚本的子句中添加 MSP_WEB_ASSIGNMENTS.TASK_IS_SUMMARY = 0 来除去摘要工作分配。

declare @res_name as nvarchar(510)
declare @begin_date as datetime
declare @end_date as datetime
 -- set these variables
select @res_name = 'Team Member'
select @begin_date = '2001-09-09'
select @end_date = '2001-10-10'
 -- end variables
select    WASSN_ID as Assignment_ID,
      TASK_IS_SUMMARY as Summary,
   TASK_NAME as Task_Name,
       ASSN_START_DATE as Start,
      ASSN_FINISH_DATE as Finish,
       WASSN_COMMENTS as Comments,
      WASSN_PCT_COMP as Percent_Complete,
       ASSN_WORK/60000 as Assigned_Work,
      ASSN_REM_WORK/60000 as Remaining_Work,
       PROJ_NAME as Project
from    MSP_WEB_ASSIGNMENTS a, 
      MSP_WEB_PROJECTS p
where    a.WRES_ID = (Select WRES_ID from MSP_WEB_RESOURCES 
         Where RES_NAME = @res_name)
and    a.WPROJ_ID = p.WPROJ_ID
and    ASSN_START_DATE Between @begin_date And @end_date

以下脚本提取自某一特定日期起过期的所有工作分配的列表。用来确定过期工作分配的日期是一个变量，所以可以插入任何日期。变量 @days_late 确定工作分配过期的程度；例如，可以更改脚本，使之仅报告那些过期五天或十天的工作分配。当在工作分配的完成日期后出现剩余工时或 @check_date 时，可以认为工作分配已过期。

declare @check_date as datetime
declare @days_late as int
 -- set these variables
select @check_date = GETDATE()
select @days_late = 0
 -- end variables
select
   PROJ_NAME as Project,
   TASK_NAME as Task,
   RES_NAME as Resource,
   ASSN_WORK/60000 as Work_Assigned,
   (ASSN_WORK/60000 - ASSN_REM_WORK/60000) as Work_Complete,
   ASSN_REM_WORK/60000 as Work_Remaining,
   ASSN_FINISH_DATE as Scheduled_Finish
from
   MSP_WEB_PROJECTS p, 
   MSP_WEB_ASSIGNMENTS a,
   MSP_WEB_RESOURCES r
where
      a.ASSN_REM_WORK > 0
and   DATEDIFF(day, a.ASSN_FINISH_DATE, @check_date) > @days_late
and   a.WPROJ_ID = p.WPROJ_ID
and   a.WRES_ID = r.WRES_ID

以下脚本提取已经从一名用户委托给另一名用户的所有工作分配的列表，包括任务名、委托人、受托人和项目经理。该脚本列出批准的或尚未批准的所有委托，并且可以方便地扩展该脚本，使之仅列出批准的委托或等待批准的委托。

select
   TASK_NAME as Task_Name,
   r1.RES_NAME as Delegator,
   r2.RES_NAME as Delegatee,
   r3.RES_NAME as Project_Manager
from
   MSP_WEB_ASSIGNMENTS a,
   MSP_WEB_RESOURCES r1,
   MSP_WEB_RESOURCES r2,
   MSP_WEB_RESOURCES r3,
   MSP_WEB_DELEGATION_ASSIGNMENTS da,
   MSP_WEB_DELEGATIONS d,
   MSP_WEB_PROJECTS p
where
   a.WASSN_ID = da.WASSN_ID
and   da.WDELEG_ID = d.WDELEG_ID
and   d.WRES_ID_DELEGATOR = r1.WRES_ID
and   d.WRES_ID_DELEGATEE = r2.WRES_ID
and   a.WPROJ_ID = p.WPROJ_ID
and   p.WRES_ID = r3.WRES_ID

以下规则应用于表名称：

• 表名称全部大写。
• 所有表名称前加 MSP_WEB_ 前缀以表示它们是 Microsoft Project Server 表，“工作分配”多维数据集和“资源”多维数据集 (MSP_CUBE_n) 或 Microsoft Project Web Access 视图 (MSP_VIEW_n) 中所使用的表除外。
• 用下划线分隔各个单词。

下面的表定义描述了将一个完整项目保存到数据库中时创建的数据库结构。包含每个表主键的域在左边的列中标有 PK。

以下规则应用于列名称：

• 列名称全部大写。
• 单词通常用下划线分隔。
• 列名称通常使用所在表的唯一标识符作为前缀。

若具有在以下表中未列出的表，则可能由于下列情况之一：

• 表中的列不具有统一的命名规则。
• 该表为视图表 (MSP_VIEW_n)。
• 该表为“工作分配”多维数据集表或“资源”多维数据集表 (MSP_CUBE_n)。

为了保持列名称的单词组件短小一致，在命名列时使用了下列缩写：

Microsoft Project Server 数据库结构中使用了以下域类型。下面的表给出了所有的域类型：

在 Microsoft Project Server 需要保存时间值而不是日期值的时候，时间值将作为日期保存。当您从数据库中读取此项目时，将忽略这些域中的日期组件。

在 Microsoft Project 中可使用以下标记符号：