CallOptions

Specifies the options needed to work with a specific client. This header is only available for use with the Partner WSDL.

API Calls

The defaultNamespace element supports the following calls: create(), merge(), queryAll(), query(), queryMore(), retrieve(), search(), update(), and upsert().

The client element supports all of the above calls, plus the following: convertLead(), login(), delete(), describeGlobal(), describeLayout(), describeTabs(), describeSObject(), describeSObjects(), getDeleted(), getUpdated(), process(), undelete(), getServerTimestamp(), getUserInfo(), setPassword(), and resetPassword().

Fields

Element Name	Type	Description
client	string	A string that identifies a client.
defaultNamespace	string	A string that identifies a developer namespace prefix. Use this field to resolve field names in managed packages without having to fully specify the fieldName everywhere. For example, if the developer namespace prefix is `battle`, and you have a custom field in your package called botId, you can set this header, and then queries such as the following will succeed: query("SELECT id, botId__c from Account"); In this case the actual field queried is the battle__botId__c field. Using this field allows you to write client code without having to specify the namespace prefix. Without this field specified, the full name of the field would have to be used for the query to succeed. In the example above, you would have to specify battle__botId__c. Note that if this field is set, and the query specifies the namespace as well, the response will not include the prefix. For example, if you set this header to `battle`, and issue a query like `query("SELECT id, battle__botId__c from Account");`, the response would use a `botId__c` element, not a `battle_botId__c` element. Describe calls ignore this header, so there will be no ambiguity between fields with namespace prefixes and customer fields of the same name without the prefix.

Element Name

Type

Description

client

string

A string that identifies a client.

defaultNamespace

string

A string that identifies a developer namespace prefix. Use this field to resolve field names in managed packages without having to fully specify the fieldName everywhere.

For example, if the developer namespace prefix is battle, and you have a custom field in your package called botId, you can set this header, and then queries such as the following will succeed:

query("SELECT id, botId__c from Account");

In this case the actual field queried is the battle__botId__c field.

Using this field allows you to write client code without having to specify the namespace prefix. Without this field specified, the full name of the field would have to be used for the query to succeed. In the example above, you would have to specify battle__botId__c.

Note that if this field is set, and the query specifies the namespace as well, the response will not include the prefix. For example, if you set this header to battle, and issue a query like query("SELECT id, battle__botId__c from Account");, the response would use a botId__c element, not a battle_botId__c element.

Describe calls ignore this header, so there will be no ambiguity between fields with namespace prefixes and customer fields of the same name without the prefix.