SOAP API Developer Guide

Introduction to SOAP API
About SOAP API
Release Notes
Quick Start: SOAP API
Core Data Types Used in API Calls
Tooling API Objects in the Enterprise WSDL
API Call Basics
Field Types
Primitive Data Types
Error Handling
Security and the API
Authorization Through External Client Apps or Connected Apps and OAuth 2.0
SOAP API End-of-Life Policy
Using the Partner WSDL
Obtaining the Partner WSDL File
Calls and the Partner WSDL
Objects, Fields, and Field Data and the Partner WSDL
Queries and the Partner WSDL
Namespaces in the Partner WSDL
Package Versions and the Partner WSDL
User Interface Themes
Examples Using the Partner WSDL
Reference
Using the API with Salesforce Features
Glossary
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Objects, Fields, and Field Data and the Partner WSDL

The enterprise WSDL file defines all the specific objects (such as Account and Contact) in a Salesforce org. In contrast, the partner WSDL file defines a single, generic object (sObject) that represents all the objects. For a particular object, its type is defined in the name field in the returned DescribeSObjectResult.

With the partner WSDL, your client application code handles fields as arrays of name-value pairs that represent the field data. When referring to the name of an individual field, use the value in its name field of the Field type in the DescribeSObjectResult.

Languages vary in the way they handle name-value pairs and map typed values to the primitive XML data types defined in SOAP messages. With the enterprise WSDL, the mapping is handled implicitly. With the partner WSDL, however, you manually manage values and data types when building client applications. Specify the object type before you assign field values. When specifying the value of a particular field, use a value that is valid for the field (range, format, and data type). Make sure that you understand the mapping between data types in your programming language and XML primitive data types. See SOAPType for more information.