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

CRUD-Based Callsupdate()1. Determine the fullName of each component you want to delete. See Metadata for more details on the fullName field.You can only delete components of the same type in a single call.2. Invoke the delete() call, passing in the array of metadata components with fullName specified.3. An AsyncResult object is returned for each component you try to delete, and is updated with status information as theoperation moves from a queue to completed or error state. Call checkStatus() in a loop until the status values inAsyncResult indicate that all the delete operations are completed. Start with a wait time of one second between iterationsof checkStatus() calls, and double the wait time each time you make a subsequent call.Sample Code—Javapublic void deleteCustomObject() {try {CustomObject co = new CustomObject();co.setFullName("MyCustomObject__c");AsyncResult[] ars = metadataConnection.create(new Metadata[]{co});AsyncResult asyncResult = ars[0];long waitTimeMilliSecs = 1000;while (!asyncResult.isDone()) {Thread.sleep(waitTimeMilliSecs);// double the wait time for the next iterationwaitTimeMilliSecs *= 2;asyncResult = mdConnection.checkStatus(new String[] {asyncResult.getId()})[0];System.out.println("Status is: " + asyncResult.getState());}} catch (ConnectionException ce) {ce.printStackTrace();} catch (InterruptedException ie) {ie.printStackTrace();}}ArgumentsNamemetadataTypeMetadata[]DescriptionArray of one or more metadata components. You only need to set the fullName fieldin the Metadata object.Limit: 10.You must submit arrays of only one type of component. For example, you could submitan array of 10 custom objects or 10 profiles, but not a mix of both types.ResponseAsyncResult[]update()Updates one or more components in your organization asynchronously.This call can be used to update any of the objects that extend Metadata. For more details, see Metadata Components andTypes on page 75.SyntaxAsyncResult[] = metadataConnection.update(UpdateMetadata[] metadata);44