CustomFields.UpdateCustomFields Method

Creates, modifies, or deletes enterprise custom fields.

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/UpdateCustomFields", 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 void UpdateCustomFields(
	CustomFieldDataSet cfds,
	bool validateOnly,
	bool autoCheckIn
)

Parameters

cfds
Type: [CustomFields Web service].CustomFieldDataSet
CustomFieldDataSet contains the updated custom field definitions.
validateOnly
Type: System.Boolean
If true, validate only the CustomFieldDataSet.
autoCheckIn
Type: System.Boolean
If true, check in the custom fields after they are updated.

UpdateCustomFields creates custom fields if the CustomFieldDataSet includes new custom fields, modifies existing custom fields, and deletes custom fields that are not in the CustomFieldDataSet.

Caution noteCaution

The UpdateCustomFields method and the UpdateCustomFields2 method, as well as Project Web App, all allow you to create an enterprise project custom field of type Flag, and set the custom field to be workflow controlled. However, Project Server workflows cannot control Flag custom fields. You should not set project custom fields of type Flag for workflow control.

TipTip

The UpdateCustomFields method ignores the locale setting of the computer running Project Server. The UpdateCustomFields2(CustomFieldDataSet, Boolean, Boolean) method can use locale-dependent values for formulas that calculate custom fields and graphical indicators.

Project Server Permissions

Permission

Description

ManageEnterpriseCustomFields

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

If the user did not check out the custom fields, UpdateCustomFields also requires administrative permissions to force check in.

Community Additions

ADD
Show:
© 2014 Microsoft