CustomFields.UpdateCustomFields(CustomFieldDataSet, Boolean, Boolean) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates, modifies, or deletes enterprise custom fields.
public:
void UpdateCustomFields(WebSvcCustomFields::CustomFieldDataSet ^ cfds, bool validateOnly, bool autoCheckIn);[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/office/project/server/webservices/CustomFields/UpdateCustomFields", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/office/project/server/webservices/CustomFields/", ResponseNamespace="http://schemas.microsoft.com/office/project/server/webservices/CustomFields/", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
public void UpdateCustomFields(WebSvcCustomFields.CustomFieldDataSet cfds, bool validateOnly, bool autoCheckIn);member this.UpdateCustomFields : WebSvcCustomFields.CustomFieldDataSet * bool * bool -> unitPublic Sub UpdateCustomFields (cfds As CustomFieldDataSet, validateOnly As Boolean, autoCheckIn As Boolean)Parameters
- cfds
- CustomFieldDataSet
CustomFieldDataSet contains the updated custom field definitions.
- validateOnly
- Boolean
If true, validate only the CustomFieldDataSet.
- autoCheckIn
- Boolean
If true, check in the custom fields after they are updated.
- Attributes
Remarks
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: 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.
Tip: 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
| 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.