create()

Deprecated. Adds one or more new metadata components to your organization asynchronously. This call is removed as of API version 31.0 and is available in earlier versions only. Use createMetadata() instead.

1AsyncResult[] = metadatabinding.create(Metadata[] metadata);

Use this call to add one or more metadata components to your organization.

This call is available in API version 30.0 and earlier only. This call isn’t available in API version 31.0 and later. Use createMetadata() instead.

Your client application must be logged in with the Modify Metadata Through Metadata API Functions or Modify All Data permission.

The metadata components being created determine required fields. For more information about specific component types, see Metadata Components and Types.

You must supply values that are valid for the field’s data type, such as integers for integer fields (not alphabetic characters). In your client application, follow the data formatting rules specified for your programming language and development tool. (Your development tool handles the appropriate mapping of data types in SOAP messages).

When storing values in string fields, the API trims any leading and trailing whitespace. For example, if the value of a label field is entered as "MyObject ", the value is stored in the database as "MyObject".

Use the following process to create metadata components:

1. Design an array, and populate it with the components you want to create. All components must be of the same type.
2. Call create() with the component array passed in as an argument.
3. An AsyncResult object is returned for each component you try to create, and is updated with status information as the operation moves from a queue to completed or error state. Call checkStatus() in a loop until the status values in AsyncResult indicate that all create operations are completed. Start with a wait time of 1 second between iterations of checkStatus() calls, and double the wait time each time you make a subsequent call.

See Step 3: Walk Through the Java Sample Code for sample Java code using the create() call.

• Type: Metadata[]

• Description: Array of one or more metadata components.

  Limit: 10.

  You must submit arrays of only one type of component. For example, you could submit an array of 10 custom objects or 10 profiles, but not a mix of both types.

AsyncResult[]