CustomFields.ReadCustomFields Method

Gets enterprise custom field definitions.

Namespace:  [CustomFields Web service]
Service reference: http://ServerName:32843/[Project Service Application GUID]/PSI/CustomFields.svc
Web service reference: http://ServerName/ProjectServerName/_vti_bin/PSI/CustomFields.asmx?wsdl

[SoapDocumentMethodAttribute("http://schemas.microsoft.com/office/project/server/webservices/CustomFields/ReadCustomFields", RequestNamespace = "http://schemas.microsoft.com/office/project/server/webservices/CustomFields/", 
	ResponseNamespace = "http://schemas.microsoft.com/office/project/server/webservices/CustomFields/", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public CustomFieldDataSet ReadCustomFields(
	string xmlFilter,
	bool autoCheckOut
)

Parameters

xmlFilter
Type: System.String
Limits the amount of data returned.
autoCheckOut
Type: System.Boolean
If true, check out the custom fields for modification.

Return Value

Type: [CustomFields Web service].CustomFieldDataSet
The CustomFieldDataSet contains information specified by the xmlFilter parameter.

The primary DataTable in the CustomFieldDataSet is the CustomFieldsDataTable. There are no secondary datatables. The xmlFilter parameter works with the Criteria operators to filter rows in the CustomFieldsDataTable. You can use the Fields.Add method to filter columns in the primary CustomFieldsDataTable.

NoteNote

For Project Server 2010, the returned CustomFieldDataSet can include the Relative Importance custom field and the Project Impact custom fields. Project Web App does not show these custom fields in the Enterprise Custom Fields and Lookup Tables page, because they are built-in for portfolio analyses and cannot be modified or deleted.

TipTip

The ReadCustomFields method ignores the locale setting of the computer running Project Server. The ReadCustomFields2 method returns locale-dependent values for formulas that calculate custom fields and graphical indicators.

For a code example that uses the ReadCustomFields2 method, see ReadCustomFields2. For more information, see How to: Use a Filter Parameter with PSI Methods

Project Server Permissions

Permission

Description

LogOnToProjectServerFromProjectProfessional

Allows a user to connect to the Project Server database from Project Professional. Global permission.

ManageEnterpriseCustomFields

Allows a user to modify the definitions of enterprise custom fields and lookup table values. Global permission.

ManageUsersAndGroups

Allows a user to manage Project Server users and groups. Global permission.

NewProject

Allows a user to create a project. Global permission.

ViewResourceCenter

Allows a user to view resource allocation data. Global permission.

Community Additions

ADD
Show:
© 2014 Microsoft