SalesforceClient
Attributes
TRIGGER_OPERATIONS
module-attribute
TRIGGER_OPERATIONS: Dict[str, Dict[str, Any]] = {'GetOnNewItems': {'operation_id': 'GetOnNewItems', 'path': '/{connectionId}/datasets/default/tables/{table}/onnewitems', 'method': 'get', 'required_parameters': ['table'], 'callback_payload_type': 'ItemsList'}, 'GetOnUpdatedItems': {'operation_id': 'GetOnUpdatedItems', 'path': '/{connectionId}/datasets/default/tables/{table}/onupdateditems', 'method': 'get', 'required_parameters': ['table'], 'callback_payload_type': 'ItemsList'}}
Classes
TablesList
dataclass
TablesList(*, value: Optional[List[Table | Mapping[str, Any]]] = None, next_link: Optional[str] = None)
Response for Get object types
Attributes
value
class-attribute
instance-attribute
List of Tables
GetItemByExternalIdResponse
dataclass
ItemsList
dataclass
ItemsList(*, value: Optional[List[Item | Mapping[str, Any]]] = None, next_link: Optional[str] = None)
Response for Get records
Attributes
value
class-attribute
instance-attribute
List of Items
ObjectEntity
dataclass
GetAllJobsResponse
dataclass
GetAllJobsResponse(*, done: Optional[bool] = None, records: Optional[List[JobInfo | Mapping[str, Any]]] = None, next_record_url: Optional[str] = None)
Response for Get all jobs
Attributes
done
class-attribute
instance-attribute
Done
CheckJobResponse
dataclass
CheckJobResponse(*, apex_processing_time: Optional[float] = None, api_active_processing_time: Optional[float] = None, api_version: Optional[float] = None, column_delimiter: Optional[str] = None, concurrency_mode: Optional[str] = None, content_type: Optional[str] = None, content_url: Optional[str] = None, created_by_id: Optional[str] = None, created_date: Optional[str] = None, external_field_name: Optional[str] = None, id: Optional[str] = None, job_type: Optional[str] = None, line_ending: Optional[str] = None, object: Optional[str] = None, operation: Optional[str] = None, retries: Optional[float] = None, state: Optional[str] = None, system_mod_stamp: Optional[str] = None, total_processing_time: Optional[float] = None)
Response for Get job info
Attributes
apex_processing_time
class-attribute
instance-attribute
apex_processing_time: Optional[float] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'apexProcessingTime'})
APEX Processing Time
api_active_processing_time
class-attribute
instance-attribute
api_active_processing_time: Optional[float] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'apiActiveProcessingTime'})
API Active Processing Time
api_version
class-attribute
instance-attribute
api_version: Optional[float] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'apiVersion'})
API Version
column_delimiter
class-attribute
instance-attribute
column_delimiter: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'columnDelimiter'})
Column Delimiter
concurrency_mode
class-attribute
instance-attribute
concurrency_mode: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'concurrencyMode'})
Concurrency Mode
content_type
class-attribute
instance-attribute
content_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentType'})
Content Type
content_url
class-attribute
instance-attribute
content_url: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentUrl'})
Content URL
created_by_id
class-attribute
instance-attribute
created_by_id: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdById'})
Created By ID
created_date
class-attribute
instance-attribute
created_date: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdDate'})
Created Date
external_field_name
class-attribute
instance-attribute
external_field_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'externalFieldName'})
External Field Name
id
class-attribute
instance-attribute
ID
job_type
class-attribute
instance-attribute
job_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'jobType'})
Job Type
line_ending
class-attribute
instance-attribute
line_ending: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'lineEnding'})
Line Ending
object
class-attribute
instance-attribute
Object
operation
class-attribute
instance-attribute
Operation
retries
class-attribute
instance-attribute
Retries
state
class-attribute
instance-attribute
State
JobInfo
dataclass
JobInfo(*, api_version: Optional[float] = None, column_delimiter: Optional[str] = None, concurrency_mode: Optional[str] = None, content_type: Optional[str] = None, content_url: Optional[str] = None, created_by_id: Optional[str] = None, created_date: Optional[str] = None, external_id_field_name: Optional[str] = None, id: Optional[str] = None, job_type: Optional[str] = None, line_ending: Optional[str] = None, object: Optional[str] = None, operation: Optional[str] = None, state: Optional[str] = None, system_modstamp: Optional[str] = None)
Response for Close or abort a job
Attributes
api_version
class-attribute
instance-attribute
api_version: Optional[float] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'apiVersion'})
API Version
column_delimiter
class-attribute
instance-attribute
column_delimiter: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'columnDelimiter'})
Column Delimiter
concurrency_mode
class-attribute
instance-attribute
concurrency_mode: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'concurrencyMode'})
Concurrency Mode
content_type
class-attribute
instance-attribute
content_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentType'})
Content Type
content_url
class-attribute
instance-attribute
content_url: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentUrl'})
Content URL
created_by_id
class-attribute
instance-attribute
created_by_id: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdById'})
Created By ID
created_date
class-attribute
instance-attribute
created_date: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdDate'})
Created Date
external_id_field_name
class-attribute
instance-attribute
external_id_field_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'externalIdFieldName'})
External ID Field Name
id
class-attribute
instance-attribute
ID
job_type
class-attribute
instance-attribute
job_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'jobType'})
Job Type
line_ending
class-attribute
instance-attribute
line_ending: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'lineEnding'})
Line Ending
object
class-attribute
instance-attribute
Object
operation
class-attribute
instance-attribute
Operation
state
class-attribute
instance-attribute
State
SOSLSearchQueryResponse
dataclass
SOSLSearchQueryResponse(*, search_records: Optional[List[SearchRecordObject | Mapping[str, Any]]] = None, metadata: Optional[Dict[str, Any]] = None)
Response for Execute SOSL search query
ObjectWithoutType
dataclass
MCPQueryResponse
dataclass
MCPQueryResponse(*, jsonrpc: Optional[str] = None, id: Optional[str] = None, method: Optional[str] = None, params: Optional[Dict[str, Any]] = None, result: Optional[Dict[str, Any]] = None, error: Optional[Dict[str, Any]] = None)
Response for MCP server for Salesforce
CreateJobResponse
dataclass
CreateJobResponse(*, object: Optional[str] = None, operation: Optional[str] = None, column_delimiter: Optional[str] = None, external_id_field_name: Optional[str] = None, line_ending: Optional[str] = None, content_type: Optional[str] = None, api_version: Optional[float] = None, concurrency_mode: Optional[str] = None, content_url: Optional[str] = None, created_by_id: Optional[str] = None, created_date: Optional[str] = None, id: Optional[str] = None, job_type: Optional[str] = None, state: Optional[str] = None, system_modstamp: Optional[str] = None)
Response for Create a job
Attributes
object
class-attribute
instance-attribute
The object type for the data being processed.
operation
class-attribute
instance-attribute
The processing operation for the job.
column_delimiter
class-attribute
instance-attribute
column_delimiter: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'columnDelimiter'})
The column delimiter used for CSV job data.
external_id_field_name
class-attribute
instance-attribute
external_id_field_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'externalIdFieldName'})
The external ID field in the object being updated. Only needed for upsert operations. Field values must also exist in CSV job data.
line_ending
class-attribute
instance-attribute
line_ending: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'lineEnding'})
The line ending used for CSV job data, marking the end of a data row.
content_type
class-attribute
instance-attribute
content_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentType'})
The content type for the job.
api_version
class-attribute
instance-attribute
api_version: Optional[float] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'apiVersion'})
The API version that the job was created in.
concurrency_mode
class-attribute
instance-attribute
concurrency_mode: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'concurrencyMode'})
The concurrency mode for the job.
content_url
class-attribute
instance-attribute
content_url: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'contentUrl'})
The URL to use for Upload Job Data requests for this job. Only valid if the job is in 'Open' state.
created_by_id
class-attribute
instance-attribute
created_by_id: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdById'})
The ID of the user who created the job.
created_date
class-attribute
instance-attribute
created_date: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'createdDate'})
The date and time in the UTC time zone when the job was created.
id
class-attribute
instance-attribute
Unique ID for this job.
job_type
class-attribute
instance-attribute
job_type: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'jobType'})
The job's type.
state
class-attribute
instance-attribute
The current state of processing for the job.
GetItemResponse
dataclass
PatchItemInput
dataclass
PatchItemResponse
dataclass
PatchItemByExternalIdInput
dataclass
PatchItemByExternalIdResponse
dataclass
Response for Insert or Update (Upsert) a Record by External ID
PostItemInput
dataclass
PostItemResponse
dataclass
ExternalIdFieldsList
dataclass
TableMetadata
dataclass
TableMetadata(*, name: Optional[str] = None, title: Optional[str] = None, x_ms_permission: Optional[str] = None, x_ms_capabilities: Optional[TableCapabilitiesMetadata | Mapping[str, Any]] = None, schema: Optional[ObjectEntity | Mapping[str, Any]] = None, referenced_entities: Optional[ObjectEntity | Mapping[str, Any]] = None, web_url: Optional[str] = None)
Response for GetMetadataForGetItem
Attributes
name
class-attribute
instance-attribute
Table name
title
class-attribute
instance-attribute
Table title
BlobDataSetsMetadata
dataclass
BlobDataSetsMetadata(*, source: Optional[str] = None, display_name: Optional[str] = None, url_encoding: Optional[str] = None)
CreateJobParameters
dataclass
CreateJobParameters(object: str, operation: str, *, column_delimiter: Optional[str] = None, external_id_field_name: Optional[str] = None, line_ending: Optional[str] = None, content_type: Optional[str] = None)
Definition: CreateJobParameters
Attributes
column_delimiter
class-attribute
instance-attribute
column_delimiter: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'columnDelimiter'})
The column delimiter used for CSV job data.
external_id_field_name
class-attribute
instance-attribute
external_id_field_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'externalIdFieldName'})
The external ID field in the object being updated. Only needed for upsert operations. Field values must also exist in CSV job data.
DataSet
dataclass
DataSet(*, name: Optional[str] = None, display_name: Optional[str] = None, query: Optional[List[PassThroughNativeQuery | Mapping[str, Any]]] = None)
DataSetsList
dataclass
DataSetsMetadata
dataclass
DataSetsMetadata(*, tabular: Optional[TabularDataSetsMetadata | Mapping[str, Any]] = None, blob: Optional[BlobDataSetsMetadata | Mapping[str, Any]] = None)
Definition: DataSetsMetadata
ExecuteSoqlQueryParameters
dataclass
Definition: ExecuteSoqlQueryParameters
Attributes
query
instance-attribute
SOQL Query text. Dynamic parameters can be specified using '@paramName' syntax.
ExternalIdField
dataclass
Definition: ExternalIdField
Attributes
name
class-attribute
instance-attribute
Name of the external ID field, used at runtime.
Item
dataclass
Definition: Item
PassThroughNativeQuery
dataclass
Procedure
dataclass
Definition: Procedure
Attributes
name
class-attribute
instance-attribute
Procedure name
Table
dataclass
Table(*, name: Optional[str] = None, display_name: Optional[str] = None, dynamic_properties: Optional[Dict[str, ObjectEntity | Mapping[str, Any]]] = None)
Definition: Table
TableCapabilitiesMetadata
dataclass
TableCapabilitiesMetadata(*, sort_restrictions: Optional[TableSortRestrictionsMetadata | Mapping[str, Any]] = None, filter_restrictions: Optional[TableFilterRestrictionsMetadata | Mapping[str, Any]] = None, select_restrictions: Optional[TableSelectRestrictionsMetadata | Mapping[str, Any]] = None, is_only_server_pagable: Optional[bool] = None, filter_function_support: Optional[List[str]] = None, server_paging_options: Optional[List[str]] = None)
Definition: TableCapabilitiesMetadata
Attributes
is_only_server_pagable
class-attribute
instance-attribute
is_only_server_pagable: Optional[bool] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'isOnlyServerPagable'})
Server paging restrictions
TableFilterRestrictionsMetadata
dataclass
TableFilterRestrictionsMetadata(*, filterable: Optional[bool] = None, non_filterable_properties: Optional[List[str]] = None, required_properties: Optional[List[str]] = None)
Definition: TableFilterRestrictionsMetadata
Attributes
filterable
class-attribute
instance-attribute
Indicates whether this table has filterable columns
TableSelectRestrictionsMetadata
dataclass
TableSortRestrictionsMetadata
dataclass
TableSortRestrictionsMetadata(*, sortable: Optional[bool] = None, unsortable_properties: Optional[List[str]] = None, ascending_only_properties: Optional[List[str]] = None)
Definition: TableSortRestrictionsMetadata
Attributes
sortable
class-attribute
instance-attribute
Indicates whether this table has sortable columns
TabularDataSetsMetadata
dataclass
TabularDataSetsMetadata(*, source: Optional[str] = None, display_name: Optional[str] = None, url_encoding: Optional[str] = None, table_display_name: Optional[str] = None, table_plural_name: Optional[str] = None)
Definition: TabularDataSetsMetadata
Attributes
source
class-attribute
instance-attribute
Dataset source
display_name
class-attribute
instance-attribute
display_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'displayName'})
Dataset display name
url_encoding
class-attribute
instance-attribute
url_encoding: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'urlEncoding'})
Dataset url encoding
CreateJobRequest
dataclass
CreateJobRequest(object: str, operation: str, *, column_delimiter: Optional[str] = None, external_id_field_name: Optional[str] = None, line_ending: Optional[str] = None)
Definition: CreateJobRequest
Attributes
column_delimiter
class-attribute
instance-attribute
column_delimiter: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'columnDelimiter'})
Column Delimiter
external_id_field_name
class-attribute
instance-attribute
external_id_field_name: Optional[str] = dataclass_field(default=None, kw_only=True, metadata={'wire_name': 'externalIdFieldName'})
External ID Field Name
InstanceUrlResponse
dataclass
GetCurrentUserInfoResponse
dataclass
SearchRecordObject
dataclass
Definition: SearchRecordObject
Attributes
attributes
class-attribute
instance-attribute
Attributes of a search record
CloseJobRequest
dataclass
MCPQueryRequest
dataclass
MCPQueryRequest(*, jsonrpc: Optional[str] = None, id: Optional[str] = None, method: Optional[str] = None, params: Optional[Dict[str, Any]] = None, result: Optional[Dict[str, Any]] = None, error: Optional[Dict[str, Any]] = None, callback_endpoint: Optional[str] = None)
Definition: MCPQueryRequest
SalesforceClient
SalesforceClient(connection_runtime_url: str, credential: AsyncTokenCredential | AzureKeyCredential, *, max_retry_attempts: int = 3, timeout: float = 30.0, use_exponential_backoff: bool = True, initial_retry_delay_seconds: float = 0.5, maximum_retry_delay_seconds: float = 120.0, retry_jitter_factor: float = 0.1, retry_unsafe_http_methods: bool = False, transport: Optional[AsyncHttpTransport] = None, **kwargs: Any)
Bases: ConnectorClientBase
Typed client for salesforce connector.
Initialize a SalesforceClient.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
connection_runtime_url
|
str
|
The connection runtime URL from Azure Portal. |
required |
credential
|
AsyncTokenCredential | AzureKeyCredential
|
Caller-owned Azure Core credential. |
required |
max_retry_attempts
|
int
|
The maximum number of request attempts. |
3
|
timeout
|
float
|
The network timeout in seconds for each request. The value configures Azure Core retry and transport deadlines. Nonpositive values disable SDK and transport deadlines. |
30.0
|
use_exponential_backoff
|
bool
|
Whether retries use exponential backoff. |
True
|
initial_retry_delay_seconds
|
float
|
The initial retry delay in seconds. |
0.5
|
maximum_retry_delay_seconds
|
float
|
The maximum retry delay in seconds. |
120.0
|
retry_jitter_factor
|
float
|
The jitter fraction applied to retry delays. |
0.1
|
retry_unsafe_http_methods
|
bool
|
Whether unsafe HTTP methods may be retried. |
False
|
transport
|
Optional[AsyncHttpTransport]
|
Optional Azure Core async HTTP transport closed by the client through its asynchronous lifecycle. |
None
|
**kwargs
|
Any
|
Optional Azure Core pipeline policy settings. |
{}
|
Methods:
list_tables
list_tables(*, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get object types
This operation lists the available Salesforce object types.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetTables.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_item_by_external_id
async
get_item_by_external_id(table: str, external_id_field: str, external_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Get a Record by External ID
This operation retrieves a record using an external ID.
Swagger operation ID: GetItemByExternalId.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
The Salesforce object type like 'Leads'. |
required |
external_id_field
|
str
|
Field marked as external ID field on Salesforce object. |
required |
external_id
|
str
|
External ID of the record to retrieve. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items
list_items(table: str, *, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get records
This operation gets records of a certain Salesforce object type like 'Leads'.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
The Salesforce object type like 'Leads'. |
required |
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_account
list_items_table_account(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get Account records from Salesforce
This operation gets Account records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_account.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_user
list_items_table_user(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get User records from Salesforce
This operation gets User records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_user.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_case
list_items_table_case(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get Case records from Salesforce
This operation gets Case records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_case.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_opportunity
list_items_table_opportunity(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get Opportunity records from Salesforce
This operation gets Opportunity records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_opportunity.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_product2
list_items_table_product2(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get Product records from Salesforce
This operation gets Product records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_product2.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_items_table_contact
list_items_table_contact(*, filter: Optional[str] = None, orderby: Optional[str] = None, top: Optional[int] = None, skip: Optional[int] = None, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get Contact records from Salesforce
This operation gets Contact records from Salesforce.
Returns an Azure Core async pager that follows the connector continuation URL.
Swagger operation ID: GetItems_table_contact.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
filter
|
Optional[str]
|
An ODATA filter query to restrict the entries returned (e.g. stringColumn eq 'string' OR numberColumn lt 123). |
None
|
orderby
|
Optional[str]
|
An ODATA orderBy query for specifying the order of entries. |
None
|
top
|
Optional[int]
|
Total number of entries to retrieve (default = all). |
None
|
skip
|
Optional[int]
|
The number of entries to skip (default = 0). |
None
|
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
delete_item
async
delete_item(table: str, id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> None
Delete record
This operation deletes a record.
Swagger operation ID: DeleteItem.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
The Salesforce object type like 'Leads'. |
required |
id
|
str
|
The unique identifier of record to delete. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Name | Type | Description |
|---|---|---|
None |
None
|
The operation completes without a response body. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
execute_soql_query
async
execute_soql_query(input: ExecuteSoqlQueryParameters | Mapping[str, Any], *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Execute a SOQL query
Execute a SOQL query.
Swagger operation ID: ExecuteSoqlQuery.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
ExecuteSoqlQueryParameters | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_all_jobs
list_all_jobs(*, concurreny_mode: Optional[str] = None, is_pk_chunking_enabled: Optional[bool] = None, job_type: Optional[str] = None, query_locator: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get all jobs
Get a list of all jobs
Returns a single-page Azure Core async collection.
Swagger operation ID: GetAllJobs.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
concurreny_mode
|
Optional[str]
|
Concurrency Mode. |
None
|
is_pk_chunking_enabled
|
Optional[bool]
|
Is PK Chunking Enabled. |
None
|
job_type
|
Optional[str]
|
Job Type. |
None
|
query_locator
|
Optional[str]
|
Query Locator. |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
upload_job_data
async
upload_job_data(input: bytes, job_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> None
Upload job data
Uploads data for a job using CSV data.
Swagger operation ID: UploadJobData.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
bytes
|
The binary request body. |
required |
job_id
|
str
|
Job ID. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Name | Type | Description |
|---|---|---|
None |
None
|
The operation completes without a response body. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_job_info
async
get_job_info(job_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Get job info
Retrieves detailed information about a job.
Swagger operation ID: GetJobInfo.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
job_id
|
str
|
Job ID. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
close_job
async
close_job(input: CloseJobRequest | Mapping[str, Any], job_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Close or abort a job
Closes or aborts a job. Use UploadComplete to close a job, or Aborted to abort a job. If you close a job, Salesforce queues the job and uploaded data for processing, and you can't add any additional job data. If you abort a job, the job does not get queued or processed.
Swagger operation ID: CloseJob.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
CloseJobRequest | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
job_id
|
str
|
Job ID. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
delete_job
async
delete_job(job_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> None
Delete a job
Deletes a job. To be deleted, a job must have a state of UploadComplete, JobComplete, Aborted, or Failed.
Swagger operation ID: DeleteJob.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
job_id
|
str
|
Job ID. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Name | Type | Description |
|---|---|---|
None |
None
|
The operation completes without a response body. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_job_record_results
async
get_job_record_results(job_id: str, result_type: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Get job results
Retrieves a list of records based on the result type for a completed job.
Swagger operation ID: GetJobRecordResults.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
job_id
|
str
|
Job ID. |
required |
result_type
|
str
|
Result Type. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
execute_sosl_query
async
execute_sosl_query(q: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Execute SOSL search query
Execute the specified SOSL search qyery
Swagger operation ID: ExecuteSOSLQuery.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
q
|
str
|
SOSL search string. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
http_request
async
http_request(input: bytes, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Send an HTTP request
Construct a Salesforce REST API request to invoke
Swagger operation ID: HttpRequest.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
bytes
|
The binary request body. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
mcp_salesforce_management
async
mcp_salesforce_management(input: MCPQueryRequest | Mapping[str, Any], *, session_id: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
MCP server for Salesforce
MCP server for Salesforce
Swagger operation ID: mcp_SalesforceManagement.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
MCPQueryRequest | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
session_id
|
Optional[str]
|
sessionId. |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
create_job
async
create_job(input: CreateJobParameters | Mapping[str, Any], *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Create a job
Creates a job, which represents a bulk operation (and associated data) that is sent to Salesforce for asynchronous processing. Provide job data via an Upload Job Data request.
Swagger operation ID: CreateJobV2.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
CreateJobParameters | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_item
async
get_item(table: str, id: str, *, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Get record
This operation gets a record.
Swagger operation ID: GetItem_V2.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
table name. |
required |
id
|
str
|
item key. |
required |
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
patch_item
async
patch_item(input: PatchItemInput | Mapping[str, Any], table: str, id: str, *, select: Optional[str] = None, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Update record
This operation updates a record and allows null values.
Swagger operation ID: PatchItem_V3.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
PatchItemInput | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
table
|
str
|
table name. |
required |
id
|
str
|
item key. |
required |
select
|
Optional[str]
|
Specific fields to retrieve from entries (default = all). |
None
|
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
patch_item_by_external_id
async
patch_item_by_external_id(input: PatchItemByExternalIdInput | Mapping[str, Any], table: str, external_id_field: str, external_id: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Insert or Update (Upsert) a Record by External ID
This operation inserts or updates (upserts) a record using an external ID.
Swagger operation ID: PatchItemByExternalIdV2.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
PatchItemByExternalIdInput | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
table
|
str
|
The Salesforce object type like 'Leads'. |
required |
external_id_field
|
str
|
Field marked as external ID field on Salesforce object. |
required |
external_id
|
str
|
External ID of the record to upsert. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
post_item
async
post_item(input: PostItemInput | Mapping[str, Any], table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Create record
This operation creates a record and allows null values.
Swagger operation ID: PostItem_V2.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
PostItemInput | Mapping[str, Any]
|
The request body. Mapping keys use serialized Swagger wire names. |
required |
table
|
str
|
table name. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
list_external_id_fields
list_external_id_fields(table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> AsyncItemPaged[dict[str, Any]]
Get External ID Fields
This operation retrieves external ID fields of Salesforce object type.
Returns a single-page Azure Core async collection.
Swagger operation ID: GetExternalIdFields.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
The Salesforce object type like 'Leads'. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
AsyncItemPaged[dict[str, Any]]
|
AsyncItemPaged[dict[str, Any]]: An Azure Core pager over connector
results. Consume it with |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_metadata_for_get_item
async
get_metadata_for_get_item(table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
GetMetadataForGetItem
Swagger operation ID: GetMetadataForGetItem.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
table. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_metadata_for_patch_item
async
get_metadata_for_patch_item(table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
GetMetadataForPatchItem
Swagger operation ID: GetMetadataForPatchItem.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
table. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_metadata_for_post_item
async
get_metadata_for_post_item(table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
GetMetadataForPostItem
Swagger operation ID: GetMetadataForPostItem.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
table. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |
get_table
async
get_table(table: str, *, timeout: Optional[float] = None, headers: Optional[Mapping[str, str]] = None, client_request_id: Optional[str] = None, response_hook: Optional[ConnectorResponseHook] = None) -> dict[str, Any] | None
Get object metadata
This operation gets the object metadata for a Salesforce object type.
Swagger operation ID: GetTable.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
table
|
str
|
Salesforce object type like 'Leads'. |
required |
timeout
|
Optional[float]
|
The request timeout in seconds. |
None
|
headers
|
Optional[Mapping[str, str]]
|
Additional HTTP request headers. |
None
|
client_request_id
|
Optional[str]
|
A caller-provided request identifier. |
None
|
response_hook
|
Optional[ConnectorResponseHook]
|
A callback invoked with the connector response. |
None
|
Returns:
| Type | Description |
|---|---|
dict[str, Any] | None
|
dict[str, Any] | None: The connector operation result. |
Raises:
| Type | Description |
|---|---|
ConnectorException
|
If the connector request fails. |