Database.com Metadata API Developer's Guide - Salesforce.com

CRUD-Based CallsupdateMetadata()updateMetadata()Updates one or more metadata components in your organization synchronously.SyntaxSaveResult[] = metadataConnection.updateMetadata(Metadata[] metadata);UsageUse the updateMetadata() call to update one or more metadata components in your organization. This call executessynchronously, meaning the call returns only when the operation completes.You can use this call to update any of the objects that extend Metadata. For more details, see Metadata Components andTypes.VersionAvailable in API version 30.0 and later.PermissionsYour client application must be logged in with the “Modify All Data” permission.Required FieldsYou must supply values for all the required fields in the component.Valid Field ValuesYou must supply values that are valid for the field’s data type, such as integers for integer fields (not alphabetic characters). Inyour client application, follow the data formatting rules specified for your programming language and development tool (yourdevelopment tool handles the appropriate mapping of data types in SOAP messages).String ValuesWhen storing values in string fields, the API trims any leading and trailing white space. For example, if the value of a labelfield is entered as "MyObject " the value is stored in the database as "MyObject".Basic Steps for Updating Metadata ComponentsUse this process to update metadata components:1. Create an array of the components you wish to update. All components must be of the same type.2. Invoke the updateMetadata() call, passing in the array of metadata components to update.A SaveResult object is returned for each component you tried to update. It contains information about whether theoperation was successful, the name of the component updated, and any errors returned if the operation wasn’t successful.Sample Code—Javapublic void updateCustomObjectSync() {try {CustomObject co = new CustomObject();String name = "MyCustomObject1";co.setFullName(name + "__c");co.setDeploymentStatus(DeploymentStatus.Deployed);50