Elements and Sections in the Picklist XML Output File

The following table describes the elements and sections in the picklist XML output file.

Table Elements and Sections in the Picklist XML File

Description Element or Section

<IncludeAll> specifies whether the preconfigured configuration information is returned in addition to the customized configuration information (true), or if only the customized configuration information is returned. The default setting is false.

<data:IncludeAll>true</data:IncludeAll>

<ObjectName> contains the system name of the record type (object), which never changes.

<data:ObjectName>Account Team</data:ObjectName>

The <ListOfPicklists> section contains the details of the picklists fields.

<data:ListOfPicklists>
. . . 
</data:ListOfPicklists> 

The <Picklist> section contains all of the elements for one picklist field.

<data:Picklist>
. . .
</data:Picklist>

<Name> contains the system name of the picklist field within the record type.

<data:Picklist>
 <data:Name>Team Role</data:Name> 
. . .
</data:Picklist>

<WebSvcTag> contains the Web Services v2.0 integration tag name for the field. This element is read-only and is ignored in Upsert operations.

<data:Picklist>
. . .
  <data:WebSvcTag>Team Role</data:WebSvcTag>
. . .
</data:Picklist>

<OrderAllLanguages> specifies whether the values in the picklist field are to be ordered alphabetically for all languages (Y) or ordered according to the values specfied in the <Order> element (N).

<data:Picklist>
. . .
  <data:OrderAllLanguages>N</data:OrderAllLanguages>
. . .
</data:Picklist>

The <ListOfPicklistValues> section contains the details of the picklist field values.

<data:Picklist>
. . .
  <data:ListOfPicklistValues>
. . .
  </data:ListOfPicklistValues>
. . .
</data:Picklist>

The <PicklistValue> section contains the details of one picklist value:

  • <ValueId> is the identifier assigned to the specific picklist value. This element maps to the Id field in the Edit Picklist window for the picklist field.

  • <Disabled> specifies whether the value is disabled (true) or is not disabled (false).

<data:Picklist>  
. . .  
  <data:ListOfPicklistValues>
    <data:PicklistValue>  
      <data:ValueId>Executive Sponsor
      </data:ValueId>
      <data:Disabled>false</data:Disabled> 
 . . .   
     </data:PicklistValue>  
. . .  
  </data:ListOfPicklistValues> 
. . .  
</data:Picklist> 

The <ListOfValueTranslations> section contains the translation values for the picklist value.

<data:Picklist>
. . . 
  <data:ListOfPicklistValues> 
    <data:PicklistValue>
. . .
      <data:ListOfValueTranslations>
. . . 
      </data:ListOfValueTranslations>
. . .
    </data:PicklistValue>
. . .
  </data:ListOfPicklistValues>
. . .
</data:Picklist> 

The <ValueTranslation> section contains the translation values for one language:

  • <LanguageCode> contains the three-letter code for a language. For the list of language codes, see Language Codes and Their Corresponding Language and Country.

  • <Value> contains the picklist value in the language identified by the language code.

  • <Order> specifies the order for the picklist value within the set of picklist values in the specified language.

    Note: <Order> is a required value. If <OrderAllLanguages> specifies Y (the picklist values are to be ordered alphabetically for all languages), then the value in <Order> is ignored. If <OrderAllLanguages> specifies N or is not specified, then the picklist values are ordered according to the values specified in <Order>.
  • <Description> contains a description of the picklist value in the language identified by the language code.

<data:Picklist>
. . .
  <data:ListOfPicklistValues>
    <data:PicklistValue>
. . .
      <data:ListOfValueTranslations>  
        <data:ValueTranslation>
          <data:LanguageCode>ENU</data:LanguageCode>
          <data:Value>Executive Sponsor
          </data:Value>  
          <data:Order>2</data:Order>
          <data:Description>CEO of the division</data:Description>
        </data:ValueTranslation>
      </data:ListOfValueTranslations>
. . .
    </data:PicklistValue>
. . .
  </data:ListOfPicklistValues>
. . .
</data:Picklist>