Salesforce
Salesforce Connector には、Salesforce オブジェクトを操作するための API が用意されています。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
この統合を使用するには、API アクセスが有効になっている Salesforce アカウントにアクセスする必要があります。 API アクセス権を持つ Salesforce エディションを確認するには、 Salesforce の記事を確認してください。 接続するには、[サインイン] を選択 します。 Salesforce ログインを指定するように求められます。画面の残りの部分に従って接続を作成します。 コネクタで現在使用されている既定の API バージョンは v58.0 です。
これで、この統合の使用を開始する準備ができました。
注
Salesforce コネクタは、 Microsoft CoPilot Studio で使用できるようになりました。
既知の問題と制限事項
- Salesforce に対してクエリに含めることができるフィールドの数には制限があります。 制限は、列の種類、計算列の数などによって異なります。"クエリが選択しているフィールドが多すぎるか、フィルター条件が複雑すぎます" というエラーが表示された場合は、クエリが制限を超えています。 これを回避するには、"クエリの選択" 詳細オプションを使用し、実際に必要なフィールドを指定します。
- Salesforce セッション設定によって、この統合がブロックされる可能性があります。 [セッションの送信元 IP アドレスへのロック] 設定が無効になっていることを確認してください。
- Salesforce API アクセスを有効にする必要があります。 アクセス設定を確認するには、現在のユーザーのプロファイル設定に移動し、[API が有効] チェック ボックスを検索します。
- Salesforce 試用版アカウントには API アクセス権がないため、使用できません。
- "Picklist (Multi-Select)" 型のユーザー設定フィールドは、レコードの 作成 アクションと レコードの更新 (V3) アクション ( それぞれの非推奨バージョンを含む) ではサポートされていません。
- Salesforce の "カスタム ドメイン" サインインを使用した新しい接続の作成はサポートされていません。
-
Order Byパラメーターで null 許容フィールドを使用すると、次の操作で実行時エラーが発生する可能性があるため避ける必要があります。レコードの取得、レコードの作成時、レコードの作成または変更時。 - レコードが変更された場合、トリガーは 標準オブジェクトのレコード変更のみを検出できますが、標準オブジェクトの添付ファイルの変更を検出することはできません。
- "Id" 列のないカスタム テーブルで、次のトリガーとアクションが正しく機能できませんでした。 レコードが作成されたとき、 レコードが作成または変更されたとき、 レコードの取得、 レコードの作成、レコードの 更新 (V3)、 レコードの削除。
- レコードが作成または変更されると 、トリガーは新しい項目と変更された項目の両方を返します。 返されたアイテムが新規または変更されたかどうかを確認するには、その "CreatedDate" フィールドと "LastModifiedDate" フィールドの値を比較します。 新しい項目では、これらの値は等しいと予想されます。 この点に関して、このトリガーが適用される項目には両方のフィールドが必須です。
- 複雑なオブジェクト (入れ子になったオブジェクトを含むオブジェクト、以下の例を参照) は、 レコードの作成 と レコードの更新 (V3) ( それぞれの非推奨バージョンを含む) ではサポートされていません。 この制限を回避するには、フラット オブジェクト構造を使用する必要があります。
- SOQL クエリの実行 と レコードの取得 アクションは、"クエリ" API に基づいています。 そのため、API の制限 (削除済みアイテムなど) により、すべてのレコードが返されるわけではありません。
- Update レコード (V3) を使用してデータが既定値に設定される問題が発生した場合、これはヘッダー "sforce-auto-assign" が true に設定されているためです。 これを回避するには、 HTTP 要求アクションの送信 を使用し、カスタム ヘッダー値を "sforce-auto-assign: false" に設定することをお勧めします。
- Salesforce コネクタには認証に関する特別な処理が含まれていますが、Salesforce バックエンドの制限により、長期間使用しないとトークンが期限切れになり、ユーザーが "Bad_OAuth_Token/セッションの有効期限切れまたは無効" エラーが発生する可能性があります。 資格情報を使用して再ログインしてください。
- この制限に対処できるようになりましたが、使用するには新しい接続を作成する必要があります。 既存の接続は引き続き機能しますが、上記の問題が発生する可能性があります。
MerchandiseExtID__c フィールドを持つ入れ子になったオブジェクトがあるため、サポートされていない複合オブジェクトの例を次に示します。
{
"Name" : "LineItemCreatedViaExtID",
"Merchandise__r" :
{
"MerchandiseExtID__c" : 123
}
}
上記の複合オブジェクトの例は、IS でサポートされているフラット オブジェクトとして書き換えられます。
{
"Name" : "LineItemCreatedViaExtID",
"MerchandiseExtID__c" : 123
}
添付ファイルのアップロード
Salesforce API では、次のオブジェクトの添付ファイルのアップロードがサポートされています: 'Account'、'Asset'、'Campaign'、'Case'、'Contact'、'Contract'、'Custom objects'、'EmailMessage'、'EmailTemplate'、'Event'、'Lead'、'Opportunity'、'Product2'、'Solution'、'Task'。 添付ファイルをアップロードするには、 レコードの作成 アクションを使用し、必要なフィールドとパラメーターの意味に関する Salesforce ドキュメント ページ を参照してください。
Salesforce の Power Apps の委任可能な関数と操作
特定のデータ型に対するこれらの Power Apps 操作は、(Power Apps 内でローカルに処理するのではなく) 処理のために Salesforce に委任される場合があります。
最上位レベルの関数
| Delegable | |
|---|---|
| 平均 | いいえ |
| Filter | イエス |
| LookUp | イエス |
| マックス | いいえ |
| Min | いいえ |
| Search | イエス |
| ソート | イエス |
| SortByColumns | イエス |
| 合計 | いいえ |
フィルター述語と LookUp 述語
| Salesforce | |
|---|---|
| じゃない | イエス |
| IsBlank | いいえ |
| TrimEnds | いいえ |
| Len | いいえ |
| +, - | いいえ |
| <、 <=、=、 <>、 >、 >= | イエス |
| And (&>)、Or (||)、Not (!) | イエス |
| で | イエス |
| StartsWith | いいえ |
コネクタの詳細
コネクタの詳細については、 詳細なセクションを参照してください。
一般的な制限
| 名前 | 価値 |
|---|---|
| コネクタによって同時に処理される要求の最大数 | 50 |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| カスタム Salesforce ログイン URI を使用したログイン | カスタム Salesforce ログイン URI を使用したログイン | 米国政府 (GCC) のみ | 共有可能 |
| Salesforce アカウントでログインする | ログインに Salesforce 資格情報を指定します。 | すべてのリージョン | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
カスタム Salesforce ログイン URI を使用したログイン
認証 ID: CustomLoginURIAuth
適用: 米国政府 (GCC) のみ
カスタム Salesforce ログイン URI を使用したログイン
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Salesforce ログイン URI | 文字列 | https://custom-domain-or-instance.my.salesforce.com | 正しい |
| Salesforce API のバージョン | 文字列 | Salesforce API バージョン。 既定では、空白のままにするか、v58.0 を使用します |
Salesforce アカウントでログインする
認証 ID: BasicAuthentication
適用対象: すべてのリージョン
ログインに Salesforce 資格情報を指定します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ログイン URI (環境) | 文字列 | Salesforce ログイン URI。 運用環境の場合は、空白のままにするか、 https://login.salesforce.com | |
| Salesforce API のバージョン | 文字列 | Salesforce API バージョン。 既定では、空白のままにするか、v58.0 を使用します |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ログイン URI (環境) | 文字列 | Salesforce ログイン URI。 運用環境の場合は、空白のままにするか、 https://login.salesforce.com | |
| Salesforce API のバージョン | 文字列 | Salesforce API バージョン。 既定では、空白のままにするか、v58.0 を使用します |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 900 | 60 秒 |
アクション
| HTTP 要求を送信する |
呼び出す Salesforce REST API 要求を作成する |
| Salesforce からケース レコードを取得する |
この操作では、Salesforce から Case レコードを取得します。 |
| Salesforce からユーザー レコードを取得する |
この操作では、Salesforce からユーザー レコードを取得します。 |
| Salesforce から取引先企業レコードを取得する |
この操作では、Salesforce から取引先企業レコードを取得します。 |
| Salesforce から営業案件レコードを取得する |
この操作では、Salesforce から営業案件レコードを取得します。 |
| Salesforce から製品レコードを取得する |
この操作では、Salesforce から Product レコードを取得します。 |
| Salesforce から連絡先レコードを取得する |
この操作は、Salesforce から Contact レコードを取得します。 |
| Salesforce 用 MCP サーバー |
Salesforce 用 MCP サーバー |
| SOQL クエリを実行する |
SOQL クエリを実行します。 |
| SOSL 検索クエリの実行 |
指定した SOSL 検索 qyery を実行する |
| すべてのジョブを取得する |
すべてのジョブの一覧を取得する |
| オブジェクトの種類を取得する |
この操作では、使用可能な Salesforce オブジェクトの種類が一覧表示されます。 |
| ジョブ データをアップロードする |
CSV データを使用してジョブのデータをアップロードします。 |
| ジョブの作成 (V2) |
非同期処理のために Salesforce に送信される一括操作 (および関連付けられたデータ) を表すジョブを作成します。 ジョブ データのアップロード要求を使用してジョブ データを提供します。 |
| ジョブの作成 [非推奨] |
このアクションは非推奨になりました。 代わりに ジョブの作成 (V2) を使用してください。
|
| ジョブの結果を取得する |
完了したジョブの結果の種類に基づいてレコードの一覧を取得します。 |
| ジョブを削除する |
ジョブを削除します。 削除するには、ジョブの状態が UploadComplete、JobComplete、Aborted、または Failed である必要があります。 |
| ジョブを閉じるまたは中止する |
ジョブを閉じるか中止します。 UploadComplete を使用してジョブを閉じるか、Aborted を使用してジョブを中止します。 ジョブを閉じると、Salesforce はジョブをキューに入れ、処理のためにデータをアップロードします。ジョブ データを追加することはできません。 ジョブを中止しても、ジョブはキューに登録または処理されません。 |
| ジョブ情報を取得する |
ジョブに関する詳細情報を取得します。 |
| レコードの作成 [非推奨] |
この操作により、レコードが作成されます。 |
| レコードの取得 [非推奨] |
このアクションは非推奨になりました。 代わりに Get レコード を使用してください。
|
| レコードの更新 (V3) |
この操作により、レコードが更新され、null 値が許可されます。 |
| レコードの更新 [非推奨] |
このアクションは非推奨になりました。 代わりに Update レコード (V3) を使用してください。
|
| レコードの更新 [非推奨] |
この操作では、レコードが更新されます。 |
| レコードを作成する |
この操作により、レコードが作成され、null 値が許可されます。 |
| レコードを削除する |
この操作により、レコードが削除されます。 |
| レコードを取得する |
この操作では、"潜在顧客" のような特定の Salesforce オブジェクトの種類のレコードを取得します。 |
| レコードを取得する |
この操作はレコードを取得します。 |
| 外部 ID でレコードを取得する |
この操作では、外部 ID を使用してレコードを取得します。 |
| 外部 ID によるレコードの挿入または更新 (アップサート) (V2) |
この操作では、外部 ID を使用してレコードを挿入または更新 (アップサート) します。 |
| 外部 ID によるレコードの挿入または更新 (アップサート) [非推奨] |
このアクションは非推奨になりました。 代わりに、 外部 ID (V2) によるレコードの挿入または更新 (アップサート) を使用してください。
|
HTTP 要求を送信する
呼び出す Salesforce REST API 要求を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
完全 URI または相対 URI。 相対 URI の例: /services/data/v41.0/sobjects/account |
|
メソッド
|
Method | True | string |
HTTP メソッド (既定値は GET)。 |
|
Body
|
Body | binary |
要求本文の内容。 |
|
|
コンテンツタイプ
|
ContentType | string |
本文の content-type ヘッダー (既定値は application/json)。 |
|
|
CustomHeader1
|
CustomHeader1 | string |
カスタム ヘッダー 1。 形式: header-name: header-value で指定する |
|
|
CustomHeader2
|
CustomHeader2 | string |
カスタム ヘッダー 2。 形式: header-name: header-value で指定する |
|
|
CustomHeader3
|
CustomHeader3 | string |
カスタム ヘッダー 3。 形式: header-name: header-value で指定する |
|
|
CustomHeader4
|
CustomHeader4 | string |
カスタム ヘッダー 4。 形式: header-name: header-value で指定する |
|
|
CustomHeader5
|
CustomHeader5 | string |
カスタム ヘッダー 5。 形式: header-name: header-value で指定する |
戻り値
- response
- ObjectWithoutType
Salesforce からケース レコードを取得する
この操作では、Salesforce から Case レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce からユーザー レコードを取得する
この操作では、Salesforce からユーザー レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce から取引先企業レコードを取得する
この操作では、Salesforce から取引先企業レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce から営業案件レコードを取得する
この操作では、Salesforce から営業案件レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce から製品レコードを取得する
この操作では、Salesforce から Product レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce から連絡先レコードを取得する
この操作は、Salesforce から Contact レコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
Salesforce 用 MCP サーバー
Salesforce 用 MCP サーバー
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
jsonrpc
|
jsonrpc | string | ||
|
id
|
id | string | ||
|
メソッド
|
method | string | ||
|
params
|
params | object | ||
|
結果
|
result | object | ||
|
エラー
|
error | object | ||
|
sessionId
|
sessionId | string |
戻り値
- Body
- MCPQueryResponse
SOQL クエリを実行する
SOQL クエリを実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
SOQL クエリ
|
query | True | string |
SOQL クエリ テキスト。 動的パラメーターは、'@paramName' 構文を使用して指定できます。 |
|
クエリ パラメーター
|
parameters | object |
SOQL クエリの動的パラメーター。 キーはパラメーター名です (記号は '@' を除く)、値はパラメーター値です。 |
戻り値
- response
- object
SOSL 検索クエリの実行
指定した SOSL 検索 qyery を実行する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
SOSL 検索文字列
|
q | True | string |
SOSL 検索文字列 |
戻り値
SOSL 検索クエリ応答
すべてのジョブを取得する
すべてのジョブの一覧を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
コンカレンシー モード
|
concurrenyMode | string |
コンカレンシー モード |
|
|
PK チャンクが有効になっているか
|
isPkChunkingEnabled | boolean |
PK チャンクが有効になっているか |
|
|
ジョブの種類
|
jobType | string |
ジョブの種類 |
|
|
クエリ ロケーター
|
queryLocator | string |
クエリ ロケーター |
戻り値
- Body
- GetAllJobsResponse
オブジェクトの種類を取得する
ジョブ データをアップロードする
CSV データを使用してジョブのデータをアップロードします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
jobId | True | string |
職務 ID |
|
CSV ファイルの内容
|
body | True | binary |
アップロードする CSV データ |
ジョブの作成 (V2)
非同期処理のために Salesforce に送信される一括操作 (および関連付けられたデータ) を表すジョブを作成します。 ジョブ データのアップロード要求を使用してジョブ データを提供します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Object
|
object | True | string |
処理されるデータのオブジェクト型。 |
|
Operation
|
operation | True | string |
ジョブの処理操作。 |
|
列区切り記号
|
columnDelimiter | string |
CSV ジョブ データに使用される列区切り記号。 |
|
|
外部 ID フィールド名
|
externalIdFieldName | string |
更新するオブジェクトの外部 ID フィールド。 アップサート操作にのみ必要です。 フィールド値は、CSV ジョブ データにも存在する必要があります。 |
|
|
行の終了
|
lineEnding | string |
CSV ジョブ データに使用される行の末尾。データ行の末尾を示します。 |
|
|
コンテンツ タイプ
|
contentType | string |
ジョブのコンテンツ タイプ。 |
戻り値
'CreateJobV2' 操作の出力
- Body
- CreateJobResponse
ジョブの作成 [非推奨]
このアクションは非推奨になりました。 代わりに ジョブの作成 (V2) を使用してください。
非同期処理のために Salesforce に送信される一括操作 (および関連付けられたデータ) を表すジョブを作成します。 ジョブ データのアップロード要求を使用してジョブ データを提供します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
列区切り記号
|
columnDelimiter | string |
列区切り記号 |
|
|
外部 ID フィールド名
|
externalIdFieldName | string |
外部 ID フィールド名 |
|
|
行の終了
|
lineEnding | string |
行の終了 |
|
|
Object
|
object | True | string |
Object |
|
Operation
|
operation | True | string |
Operation |
戻り値
- Body
- JobInfo
ジョブの結果を取得する
完了したジョブの結果の種類に基づいてレコードの一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
jobId | True | string |
職務 ID |
|
結果の種類
|
resultType | True | string |
結果の種類 |
戻り値
- response
- string
ジョブを削除する
ジョブを削除します。 削除するには、ジョブの状態が UploadComplete、JobComplete、Aborted、または Failed である必要があります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
jobId | True | string |
職務 ID |
ジョブを閉じるまたは中止する
ジョブを閉じるか中止します。 UploadComplete を使用してジョブを閉じるか、Aborted を使用してジョブを中止します。 ジョブを閉じると、Salesforce はジョブをキューに入れ、処理のためにデータをアップロードします。ジョブ データを追加することはできません。 ジョブを中止しても、ジョブはキューに登録または処理されません。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
jobId | True | string |
職務 ID |
|
状態
|
state | True | string |
状態 |
戻り値
- Body
- JobInfo
ジョブ情報を取得する
レコードの作成 [非推奨]
この操作により、レコードが作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
記録
|
item | True | dynamic |
作成するレコード。 |
戻り値
レコードの取得 [非推奨]
このアクションは非推奨になりました。 代わりに Get レコード を使用してください。
この操作はレコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル
|
table | True | string | |
|
id
|
id | True | string |
戻り値
レコードの更新 (V3)
この操作により、レコードが更新され、null 値が許可されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
テーブル名 |
|
レコード ID
|
id | True | string |
item キー |
|
更新するアイテム
|
item | True | dynamic |
更新するアイテム |
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
レコードの更新 [非推奨]
このアクションは非推奨になりました。 代わりに Update レコード (V3) を使用してください。
この操作により、レコードが更新され、null 値が許可されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
テーブル名 |
|
レコード ID
|
id | True | string |
item キー |
|
更新するアイテム
|
item | True | dynamic |
更新するアイテム |
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
レコードの更新 [非推奨]
この操作では、レコードが更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
レコード ID
|
id | True | string |
更新するレコードの一意識別子。 |
|
記録
|
item | True | dynamic |
プロパティが変更されたレコード。 |
戻り値
レコードを作成する
この操作により、レコードが作成され、null 値が許可されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
テーブル名 |
|
記録
|
item | True | dynamic |
記録 |
戻り値
レコードを削除する
この操作により、レコードが削除されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
レコード ID
|
id | True | string |
削除するレコードの一意識別子。 |
レコードを取得する
この操作では、"潜在顧客" のような特定の Salesforce オブジェクトの種類のレコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値は 0)。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
レコードを取得する
この操作はレコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
テーブル名 |
|
レコード ID
|
id | True | string |
item キー |
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
外部 ID でレコードを取得する
この操作では、外部 ID を使用してレコードを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
外部 ID フィールド
|
externalIdField | True | string |
Salesforce オブジェクトの外部 ID フィールドとしてマークされたフィールド。 |
|
外部 ID
|
externalId | True | string |
取得するレコードの外部 ID。 |
戻り値
外部 ID によるレコードの挿入または更新 (アップサート) (V2)
この操作では、外部 ID を使用してレコードを挿入または更新 (アップサート) します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
外部 ID フィールド
|
externalIdField | True | string |
Salesforce オブジェクトの外部 ID フィールドとしてマークされたフィールド。 |
|
外部 ID
|
externalId | True | string |
アップサートするレコードの外部 ID。 |
|
記録
|
item | True | dynamic |
プロパティが変更されたレコード。 |
戻り値
外部 ID によるレコードの挿入または更新 (アップサート) [非推奨]
このアクションは非推奨になりました。 代わりに、 外部 ID (V2) によるレコードの挿入または更新 (アップサート) を使用してください。
この操作では、外部 ID を使用してレコードを挿入または更新 (アップサート) します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
外部 ID フィールド
|
externalIdField | True | string |
Salesforce オブジェクトの外部 ID フィールドとしてマークされたフィールド。 |
|
外部 ID
|
externalId | True | string |
アップサートするレコードの外部 ID。 |
|
記録
|
item | True | dynamic |
プロパティが変更されたレコード。 |
戻り値
トリガー
| レコードが作成されたとき |
この操作は、新しく作成されたレコードがある場合にトリガーされます。 |
| レコードが変更されたとき |
この操作は、新しく変更されたレコードがある場合にトリガーされます。 |
レコードが作成されたとき
この操作は、新しく作成されたレコードがある場合にトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
レコードが変更されたとき
この操作は、新しく変更されたレコードがある場合にトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Salesforce オブジェクトの種類
|
table | True | string |
"潜在顧客" のような Salesforce オブジェクトの種類。 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
定義
CreateJobResponse
'CreateJobV2' 操作の出力
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Object
|
object | string |
処理されるデータのオブジェクト型。 |
|
Operation
|
operation | string |
ジョブの処理操作。 |
|
列区切り記号
|
columnDelimiter | string |
CSV ジョブ データに使用される列区切り記号。 |
|
外部 ID フィールド名
|
externalIdFieldName | string |
更新するオブジェクトの外部 ID フィールド。 アップサート操作にのみ必要です。 フィールド値は、CSV ジョブ データにも存在する必要があります。 |
|
行の終了
|
lineEnding | string |
CSV ジョブ データに使用される行の末尾。データ行の末尾を示します。 |
|
コンテンツ タイプ
|
contentType | string |
ジョブのコンテンツ タイプ。 |
|
API バージョン
|
apiVersion | float |
ジョブが作成された API バージョン。 |
|
コンカレンシー モード
|
concurrencyMode | string |
ジョブのコンカレンシー モード。 |
|
コンテンツ URL
|
contentUrl | string |
このジョブのジョブ データのアップロード要求に使用する URL。 ジョブが 'Open' 状態の場合にのみ有効です。 |
|
Id で作成
|
createdById | string |
ジョブを作成したユーザーの ID。 |
|
作成日
|
createdDate | date-time |
ジョブが作成された UTC タイム ゾーンの日付と時刻。 |
|
ID (アイディー)
|
id | string |
このジョブの一意の ID。 |
|
ジョブの種類
|
jobType | string |
ジョブの種類。 |
|
State
|
state | string |
ジョブの現在の処理状態。 |
|
システム Modstamp
|
systemModstamp | date-time |
ジョブが完了した UTC タイム ゾーンの日付と時刻。 |
表
テーブルを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
Name | string |
テーブルの名前。 この名前は実行時に使用されます。 |
|
DisplayName
|
DisplayName | string |
テーブルの表示名。 |
|
DynamicProperties
|
DynamicProperties | object |
コネクタによってクライアントに提供される追加のテーブル プロパティ。 |
TablesList
テーブルの一覧を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
value
|
value | array of Table |
テーブルの一覧 |
GetAllJobsResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Done
|
done | boolean |
Done |
|
誌
|
records | array of JobInfo | |
|
次に修正された URL
|
nextRecordUrl | string |
次のレコード URL |
JobInfo
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
API バージョン
|
apiVersion | float |
API バージョン |
|
列区切り記号
|
columnDelimiter | string |
列区切り記号 |
|
コンカレンシー モード
|
concurrencyMode | string |
コンカレンシー モード |
|
コンテンツ タイプ
|
contentType | string |
コンテンツ タイプ |
|
コンテンツ URL
|
contentUrl | string |
コンテンツ URL |
|
ID で作成
|
createdById | string |
ID で作成 |
|
作成日
|
createdDate | date-time |
作成日 |
|
外部 ID フィールド名
|
externalIdFieldName | string |
外部 ID フィールド名 |
|
ID
|
id | string |
ID |
|
ジョブの種類
|
jobType | string |
ジョブの種類 |
|
行の終了
|
lineEnding | string |
行の終了 |
|
Object
|
object | string |
Object |
|
Operation
|
operation | string |
Operation |
|
State
|
state | string |
State |
|
システム Mod スタンプ
|
systemModstamp | date-time |
システム Mod スタンプ |
CheckJobResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
APEX 処理時間
|
apexProcessingTime | number |
APEX 処理時間 |
|
API のアクティブな処理時間
|
apiActiveProcessingTime | number |
API のアクティブな処理時間 |
|
API バージョン
|
apiVersion | float |
API バージョン |
|
列区切り記号
|
columnDelimiter | string |
列区切り記号 |
|
コンカレンシー モード
|
concurrencyMode | string |
コンカレンシー モード |
|
コンテンツ タイプ
|
contentType | string |
コンテンツ タイプ |
|
コンテンツ URL
|
contentUrl | string |
コンテンツ URL |
|
ID で作成
|
createdById | string |
ID で作成 |
|
作成日
|
createdDate | date-time |
作成日 |
|
外部フィールド名
|
externalFieldName | string |
外部フィールド名 |
|
ID
|
id | string |
ID |
|
ジョブの種類
|
jobType | string |
ジョブの種類 |
|
行の終了
|
lineEnding | string |
行の終了 |
|
Object
|
object | string |
Object |
|
Operation
|
operation | string |
Operation |
|
再試行
|
retries | number |
再試行 |
|
State
|
state | string |
State |
|
systemModStamp
|
systemModStamp | date-time | |
|
合計処理時間
|
totalProcessingTime | number |
合計処理時間 |
SOSLSearchQueryResponse
SOSL 検索クエリ応答
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
searchRecords
|
searchRecords | array of SearchRecordObject |
SOSL 検索クエリによって返される検索レコードの一覧 |
SearchRecordObject
SOSL クエリによって返される個々のレコード
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
型
|
attributes.type | string |
レコードの種類 |
|
URL
|
attributes.url | string |
オブジェクトの取得に使用できる API パス |
|
ID (アイディー)
|
Id | string |
レコードの一意識別子 |
ObjectWithoutType
MCPQueryResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
jsonrpc
|
jsonrpc | string | |
|
id
|
id | string | |
|
メソッド
|
method | string | |
|
params
|
params | object | |
|
結果
|
result | object | |
|
エラー
|
error | object |
文字列
これは基本的なデータ型 'string' です。
オブジェクト
’オブジェクト’ という種類です。