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

CRUD-Based CallscreateMetadata()SyntaxSaveResult[] = metadatabinding.createMetadata(Metadata[] metadata);UsageUse the createMetadata() call to add one or more metadata components to your organization. This call executessynchronously, meaning the call returns only when the operation completes.This call can be used to create 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 FieldsRequired fields are determined by the metadata components being created. For more information about specific componenttypes, see Metadata Components and Types.Valid Data 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 whitespace. For example, if the value of a labelfield is entered as "MyObject ", the value is stored in the database as "MyObject".Basic Steps for Creating Metadata ComponentsUse the following process to create metadata components:1. Design an array and populate it with the components that you want to create. All components must be of the same type.2. Call createMetadata() with the component array passed in as an argument.3. A SaveResult object is returned for each component you tried to create. It contains information about whether theoperation was successful, the name of the component created, and any errors returned if the operation wasn’t successful.Sample Code—Javapublic void createCustomObjectSync() {try {CustomObject co = new CustomObject();String name = "MyCustomObject1";co.setFullName(name + "__c");co.setDeploymentStatus(DeploymentStatus.Deployed);co.setDescription("Created by the Metadata API");co.setEnableActivities(true);co.setLabel(name + " Object");co.setPluralLabel(co.getLabel() + "s");co.setSharingModel(SharingModel.ReadWrite);CustomField nf = new CustomField();47