Calls and the Partner WSDL

The partner WSDL file defines exactly the same API calls found in the enterprise WSDL file. A client application using the partner WSDL will likely use the following API calls to determine an organization’s metadata:

Task / Call	Description
`describeGlobal()`	Retrieves a list of available objects for your organization’s data.
`describeLayout()`	Retrieves metadata about page layouts for the specified object type.
`describeSObject()`	`describeSObject()` has been superseded by `describeSObjects()`.
`describeSObjects()`	Use to obtain metadata for a given object. You can first call to retrieve a list of all objects for your organization, then iterate through the list and use to obtain metadata about individual objects.
`describeTabs()`	In the user interface, users have access to standard apps (and may also have access to custom apps) as listed in the Lightning Platform app menu at the top of the page. Selecting a standard app or custom app in the user interface allows the user to switch between the listed apps at any time.

To explore an organization’s metadata, a client application can:

Call describeGlobal() to obtain a list of available objects.
In the returned DescribeGlobalResult object, retrieve an array of DescribeGlobalSObjectResult objects by calling sobjects.
Get the sObject type name for each returned sObject by calling name on the DescribeGlobalSObjectResult objects.
The DescribeGlobalSObjectResult object provides some metadata about the sObject, such as whether the sObject is createable or updateable. If you want to get more information about particular sObjects, like their fields and child relationships, call describeSObjects() by passing it an array of the sObject type names that you’re interested in obtaining more information about.

sObject Reference Reuse

An sObject reference can’t be reused within a single operation.

Use a different reference. For example, the following code snippet creates an account and contact with a custom field and an event using two different references:

1SObject account = new com.sforce.soap.partner.sobject.wsc.SObject();
2    account.setType("Account");
3    account.setField("Name","myAccount");
4    account.setField("XID1__c", "1");
5    SObject refAcc1 = new com.sforce.soap.partner.sobject.wsc.SObject();
6    refAcc1.setType("Account");
7    refAcc1.setField("XID1__c", "1");
8    SObject refAcc2 = new com.sforce.soap.partner.sobject.wsc.SObject();
9    refAcc2.setType("Account");
10    refAcc2.setField("XID1__c", "1");
11    
12    SObject contact = new com.sforce.soap.partner.sobject.wsc.SObject();
13    contact.setType("Contact");
14    contact.setField("LastName", "LName");
15    contact.setField( "XID2__c", "2");
16    contact.setField( "Account", refAcc1);
17    SObject refCon = new com.sforce.soap.partner.sobject.wsc.SObject();
18    contact.setType("Contact");
19    contact.setField( "XID2__c", "2");
20    
21    
22    SObject event = new com.sforce.soap.partner.sobject.wsc.SObject();
23    contact.setType("Event");
24    contact.setField("Subject", "myEvent");
25    contact.setField( "ActivityDateTime", Calendar.getInstance());
26    contact.setField("DurationInMinutes", 60);
27    contact.setField("Who", refCon);
28    contact.setField("What", refAcc2);
29    
30    client.create(new SObject[] { account, contact, event}); // exception thrown here

Any call that takes a parameter of the form sObject[] sObjects is subject to this limitation.

See Also

Setting Up Your Java Developer Environment: Install the Web Services Connector (WSDL-Based APIs)