AdminSettings Method

Description

The PDS returns a list of administrative settings from Microsoft Office Project Server 2003.

Syntax

<Request>
   <AdminSettings>
      <Release></Release>
   </AdminSettings>
</Request>

Parameters

Release

Optional. The default value is 0, which means Microsoft Project 2002 (Project version 10). The only other valid value of Release is 1, which means Project 2003 (version 11).

Return Value

If successful, the PDS returns a successful HRESULT and STATUS, as well as the values for the administrative settings for AllowLocalBaseCalendars, DisplayMasterProjects, and EnforceCurrency.

If Release is set to 1, the PDS also returns ProtectActuals, ProjectBaseline, BuildTeamOnNewProject, and RBS.

RBS contains the current user's resource breakdown structure unique ID. The RBS value is -1 if the current user does not have a RBS UID.

If Release is 1 and the currently logged-on user has been denied any custom permissions, then the PDS returns DisabledItems and its children. The ItemType and ItemID are the values of WSEC_ITEM_TYPE and WSEC_ITEM_ID from the database table MSP_WEB_SECURITY_USERDEFINED.

<Reply>
   <HRESULT></HRESULT>
   <STATUS></STATUS>
   <UserName></UserName>
   <AdminSettings>
      <AllowLocalBaseCalendars></AllowLocalBaseCalendars>
      <DisplayMasterProjects></DisplayMasterProjects>
      <EnforceCurrency></EnforceCurrency>
      <ProtectActuals></ProtectActuals>      <ProtectBaseline></ProtectBaseline>      <BuildTeamOnNewProject></BuildTeamOnNewProject>      <RBS></RBS>      <DisabledItems>         <Item>            <ItemType></ItemType>            <ItemID></ItemID>         </Item>         . . . Additional Items . . .      </DisabledItems>
   </AdminSettings>
</Reply>

Remarks

Request and reply elements that are new or changed since Microsoft Project 2002 are shown in bold.