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

CRUD-Based Callsdelete()3. An AsyncResult object is returned for each component you triy to create, 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 create operations are completed. Start with a wait time of one second between iterations ofcheckStatus() calls, and double the wait time each time you make a subsequent call.Sample Code—JavaSee Step 3: Walk Through the Java Sample Code on page 7 for sample Java code using the create() call.ArgumentsNamemetadataTypeMetadata[]DescriptionArray of one or more metadata components.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[]delete()Deletes one or more components from your organization asynchronously.You can use this call to delete any of the objects that extend Metadata. For more details, see Metadata Components and Typeson page 75.SyntaxAsyncResult[] = metadataConnection.delete(Metadata[] metadata);UsageUse this call to delete one or more components from your organization.PermissionsYour client application must be logged in with the “Modify All Data” permission.Rules and GuidelinesWhen deleting components, consider the following rules and guidelines:• Your client application must be logged in with sufficient access rights to delete individual components within the specifiedcomponent. For more information, see “Factors that Affect Data Access” in the SOAP API Developer's Guide.• In addition, you might also need permission to access this component’s parent component.• To ensure referential integrity, this call supports cascading deletions. If you delete a parent component, you delete itschildren automatically, as long as each child component can be deleted.Basic Steps for Deleting Metadata ComponentsUse the following process to delete metadata components:43