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

Metadata TypesPicklist (Including Dependent Picklist)FieldsPicklist contains the following fields:Field NamecontrollingFieldpicklistValuessortedField TypestringPicklistValue[]booleanDescriptionThe fullName of the controlling field if this is a dependent picklist.A dependent picklist works in conjunction with a controlling picklistor checkbox to filter the available options. The value chosen in thecontrolling field affects the values available in the dependent field.This field is available in API version 14.0 and later.Required. Represents a set of values for a picklist.Required. Indicates whether values should be sorted (true), or not(false).PicklistValueThis metadata type defines a value in the picklist and specifies whether this value is the default value. It extends the Metadatametadata type and inherits its fullName field. Note the following when working with picklist values:• When you retrieve a standard object, you all picklist values are retrieved, not just the customized picklist values.• When you deploy changes to standard picklist fields, picklist values are added, updated or deleted as needed.• You can’t set a picklist value as inactive, but if the picklist value is missing and you invoke an update() call, the missingvalue becomes inactive.Field NameallowEmailclosedcolorcontrollingFieldValuesconvertedField Typebooleanbooleanstringstring[]booleanDescriptionIndicates whether this value lets users email a quote PDF (true),or not (false). This field is only relevant for the Status field inquotes. This field is available in API version 18.0 and later.Indicates whether this value is associated with a closed status(true), or not (false). This field is only relevant for the standardStatus field in cases and tasks. This field is available in API version16.0 and later.Indicates the color assigned to the picklist value when used in chartson reports and dashboards. The color is in hexadecimal format; forexample #FF6600. If a color is not specified, it will be assigneddynamically on chart generation. This field is available in APIversion 17.0 and later.A list of values in the controlling field that are linked to this picklistvalue. The controlling field can be a checkbox or a picklist. Thisfield is available in API version 14.0 and later. The values in thelist depend on the field type:• Checkbox: checked or unchecked.• Picklist: The fullName of the picklist value in thecontrolling field.Indicates whether this value is associated with a converted status(true), or not (false). This field is only relevant for the standardLead Status field in leads. Your organization can set its ownguidelines for determining when a lead is qualified, but typically,you want to convert a lead as soon as it becomes a real opportunity97