CloudTools for Salesforce (プレビュー)
Apptigent CloudTools は、クラウドに接続された任意のアプリまたはワークフローからアクセスできる、Salesforce 向けのさまざまなデータ統合アクションを提供します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Apptigent のサポート |
| URL | https://www.apptigent.com/help |
| support@apptigent.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Apptigent |
| Website | https://www.apptigent.com |
| プライバシー ポリシー | https://www.apptigent.com/help/privacy-policy/ |
| カテゴリ | 生産性 |
Salesforce のシームレスなクロスプラットフォーム クラウド統合を使用して、重要なビジネス プロセスを自動化します。 Power Apps と Power Automate を Salesforce 組織に簡単に接続して、顧客情報の取得、取引のクローズ、レコードの作成、リードの変換、一括ジョブの実行、クイック アクションの実行、ファイルのアップロード、レコードへのドキュメントの関連付け、フィードの更新、リンクされたファイルの取得などを行うことができます。 SOQL、SOSL、GraphQL を使用して高度なクエリやシーチを実行することもできます。 CloudTools は、任意のアプリまたはワークフローから簡単にアクセスできるようにすることで、エンタープライズ CRM データの可能性を引き出します。
[前提条件]
CloudTools には、有効な Salesforce ライセンス、Salesforce 組織 (任意のエディション) での CloudTools マネージド パッケージのインストール、および現在の CloudTools サブスクリプション (個別請求) が必要です。 開始する方法の詳細な手順については、 https://www.apptigent.com/solutions/cloudtools/configurationを参照してください。
資格情報を取得する方法
次の簡単な手順に従って、ライセンス (API) キーを生成します。
- Salesforce App Exchange を使用して CloudTools マネージド パッケージをインストールします。
- アプリ起動ツールで [Apptigent CloudTools] リンクを選択して、CloudTools 構成ページを起動します。
- 画面の指示に従って、接続されているアプリを作成し、ライセンス キーを生成します。
- キーをコピーし、Power Apps、Power Automate、または Azure Logic Apps の新しい接続ダイアログで指定します。
既知の問題と制限事項
Salesforce Sales Cloud の CloudTools をインストールして構成するには、Salesforce のシステム管理者アクセス許可が必要です。 組織内に十分なアクセス許可がない場合は、Salesforce 管理者に問い合わせてください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ライセンス キー | securestring | CloudTools ライセンス キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アクション - クイック アクションについて説明する |
クイック アクションのすべてのプロパティを取得する |
| アクション - クイック アクションの取得 |
組織内のすべてのクイック アクションの一覧を取得する |
| アクション - クイック アクションの実行 |
必要なデータを使用してクイック アクションを実行する |
| オブジェクト - Describe オブジェクト |
sObject のすべてのメタデータとフィールドを取得する |
|
オブジェクト - s |
組織内のすべての sObject の一覧を取得する |
| オブジェクト - オブジェクト フィールド |
sObject のフィールドを取得する |
| オブジェクト - オブジェクト メタデータ |
sObject のメタデータを取得する |
| オブジェクト - オブジェクトの更新可能なフィールド |
sObject の更新可能なフィールドを取得する |
| クエリ - GraphQL クエリ |
Graph QL クエリを実行してオブジェクトを取得し、データを記録する |
| クエリ - SOQL クエリ |
SOQL クエリを実行する |
| クエリ - 検索クエリ |
検索 (SOSL) クエリを実行する |
| ジョブ - すべてのジョブを取得する |
すべてのジョブに関する情報を取得する |
| ジョブ - ジョブの一括結果の取得 |
一括ジョブの結果情報を取得する |
| ジョブ - ジョブの中止 |
ジョブを中止する |
| ジョブ - ジョブの削除 |
ジョブを削除する |
| ジョブ - 一括クエリ ジョブの作成 |
一括クエリ ジョブを作成する |
| ジョブ - 一括ジョブの状態を取得する |
ジョブの状態を確認する |
| ジョブ - 一括挿入ジョブの作成 |
一括挿入ジョブを作成する |
| ファイル - ドキュメント メタデータ |
ファイルに関する情報を取得する (ContentDocument) |
| ファイル - ドキュメントのバージョン |
個々のファイルのバージョン情報の一覧を取得する (ContentDocument) |
| ファイル - ドキュメントの共有 |
ファイル (ContentDocument) をレコードに関連付け、共有プロパティを設定する |
| ファイル - バージョンの作成 |
新しい ContentVersion オブジェクトとしてファイルをアップロードする |
| ファイル - バージョンの取得 |
個々のファイル バージョンを取得する (ContentVersion) |
| ファイル - バージョン情報 |
個々のファイル バージョンに関する情報を取得する (ContentVersion) |
| ファイル - パブリック リンクの作成 |
認証されていないユーザーがアクセスできるパブリック ファイル リンクを作成する |
| フィード - フィード項目の作成 |
レコードに関連付けられた新しいフィード項目を作成する |
| フィード - レコード フィードを取得する |
Chatter レコード フィードを取得する |
| レコード - リンク されたファイル |
レコードにリンクされているすべてのファイルに関する情報を取得する |
| レコード - レコードの作成 |
指定したオブジェクト型の新しいレコードを作成する |
| レコード - レコードの削除 |
指定したオブジェクト型のレコードを削除する |
| レコード - レコードの取得 |
指定したオブジェクト型のレコードを取得する |
| レコード - レコードの更新 |
指定したオブジェクト型のレコードを更新する |
| 潜在顧客 - 潜在顧客の変換 |
リードを変換する |
| 組織 - API バージョンの一覧表示 |
組織内でサポートされているすべての API バージョンの一覧を取得する |
| 組織 - 最新の API バージョン |
組織でサポートされている最新の API バージョンを取得する |
アクション - クイック アクションについて説明する
クイック アクションのすべてのプロパティを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
オブジェクト名または項目名 |
戻り値
- Body
- outputStringResult
アクション - クイック アクションの取得
アクション - クイック アクションの実行
必要なデータを使用してクイック アクションを実行する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | True | string |
クイック アクション名 |
|
データ
|
data | True | object |
クイック アクション データ |
戻り値
- Body
- outputStringResult
オブジェクト - Describe オブジェクト
sObject のすべてのメタデータとフィールドを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名の選択
|
name | True | string |
sObject の名前 |
戻り値
- Body
- outputStringResult
オブジェクト - sObject の一覧表示
オブジェクト - オブジェクト フィールド
sObject のフィールドを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名
|
name | True | string |
sObject の名前 |
戻り値
- Body
- outputStringResult
オブジェクト - オブジェクト メタデータ
sObject のメタデータを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名
|
name | True | string |
sObject の名前 |
戻り値
- Body
- outputStringResult
オブジェクト - オブジェクトの更新可能なフィールド
sObject の更新可能なフィールドを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名
|
name | True | string |
sObject の名前 |
戻り値
- Body
- outputStringResult
クエリ - GraphQL クエリ
Graph QL クエリを実行してオブジェクトを取得し、データを記録する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Query
|
query | True | string |
GraphQL クエリ テキスト |
戻り値
- response
- object
クエリ - SOQL クエリ
SOQL クエリを実行する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クエリ
|
query | True | string |
SOQL クエリ テキスト (エンコードなし) |
戻り値
- response
- object
クエリ - 検索クエリ
検索 (SOSL) クエリを実行する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
query | True | string |
検索クエリ テキスト (エンコードなし) |
戻り値
- response
- object
ジョブ - すべてのジョブを取得する
ジョブ - ジョブの一括結果の取得
一括ジョブの結果情報を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
職務 ID
|
jobId | string |
職務 ID |
|
|
ジョブの種類
|
jobType | string |
ジョブの種類 |
|
|
結果の種類
|
resultType | string |
取得する結果セットの種類 |
|
|
ロケータ
|
locator | string |
レコード ロケーター |
|
|
最大レコード数
|
maxRecords | string |
返されるレコードの最大数 |
戻り値
- response
- object
ジョブ - ジョブの中止
ジョブを中止する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
オブジェクト ID |
|
タイプ
|
type | True | string |
Object Type/オブジェクトの種類 |
戻り値
- Body
- outputStringResult
ジョブ - ジョブの削除
ジョブを削除する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
オブジェクト ID |
|
タイプ
|
type | True | string |
Object Type/オブジェクトの種類 |
戻り値
- Body
- outputStringResult
ジョブ - 一括クエリ ジョブの作成
一括クエリ ジョブを作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クエリ操作
|
operation | string |
クエリ操作の種類 |
|
|
列区切り記号
|
delimiter | string |
出力ファイルの列区切り記号 |
|
|
行の終了
|
lineEnding | string |
出力ファイルの行終端記号。 LF for Unix/Linux/Mac OS、CRLF for Windows |
|
|
Query
|
query | string |
大規模な結果セット SOQL クエリ (エンコードなし) |
戻り値
- response
- object
ジョブ - 一括ジョブの状態を取得する
ジョブの状態を確認する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
オブジェクト ID |
|
タイプ
|
type | True | string |
Object Type/オブジェクトの種類 |
戻り値
- Body
- outputStringResult
ジョブ - 一括挿入ジョブの作成
一括挿入ジョブを作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名
|
objectName | string |
sObject 型の名前 (営業案件など) |
|
|
ファイル形式
|
fileFormat | string |
ファイル形式 (現在サポートされている CSV のみ) |
|
|
行の終了
|
lineEnding | string |
入力ファイルの行終端記号。 UNIX/Linus/Mac OS 用 LF、CRLF for Windows |
|
|
File
|
file | file |
バイナリ ファイル データ (25 MB の制限) |
戻り値
- response
- object
ファイル - ドキュメント メタデータ
ファイルに関する情報を取得する (ContentDocument)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント ID
|
documentId | True | string |
取得するファイル コンテンツ ドキュメントの ID |
戻り値
- response
- object
ファイル - ドキュメントのバージョン
個々のファイルのバージョン情報の一覧を取得する (ContentDocument)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
バージョン ID
|
documentId | True | string |
取得するバージョンを含むコンテンツ ドキュメント オブジェクトの ID |
戻り値
- response
- object
ファイル - ドキュメントの共有
ファイル (ContentDocument) をレコードに関連付け、共有プロパティを設定する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント ID
|
documentId | True | string |
ファイルの ID (ContentDocument オブジェクト) |
|
レコード ID
|
recordId | True | string |
ファイルが関連付けられるレコードの ID |
|
可視性
|
visibility | True | string |
ファイルにアクセスできるユーザー |
|
Permissions
|
permissions | True | string |
共有アクセス許可 (ビューアー [表示のみ]、コラボレーター [表示/編集/共有]、関連レコードから推論) |
戻り値
- response
- object
ファイル - バージョンの作成
新しい ContentVersion オブジェクトとしてファイルをアップロードする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
name | string |
ファイルの名前 (拡張子を含む) |
|
|
Title
|
title | string |
ファイルのタイトル |
|
|
ドキュメント ID
|
documentId | string |
(省略可能)ContentDocument オブジェクトの ID (既存のファイルに新しいバージョンを追加する場合にのみ使用されます) |
|
|
変更の理由
|
reasonForChange | string |
(省略可能)変更の説明 |
|
|
File
|
file | file |
バイナリ ファイル データ |
戻り値
- response
- object
ファイル - バージョンの取得
個々のファイル バージョンを取得する (ContentVersion)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
バージョン ID
|
versionId | True | string |
取得するファイル バージョンの ID |
戻り値
- response
- object
ファイル - バージョン情報
個々のファイル バージョンに関する情報を取得する (ContentVersion)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
バージョン ID
|
versionId | True | string |
取得するファイル コンテンツ バージョンの ID |
戻り値
- response
- object
ファイル - パブリック リンクの作成
認証されていないユーザーがアクセスできるパブリック ファイル リンクを作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
バージョン ID
|
versionId | True | string |
ファイルのコンテンツ バージョン ID |
|
ファイル名
|
name | True | string |
ファイル名 |
|
ブラウザーで表示
|
viewInBrowser | boolean |
ブラウザーで表示するためのプレビュー リンクを作成する |
|
|
ダウンロードを許可する
|
allowDownload | boolean |
ファイルの内容を取得するためのダウンロード リンクを作成する |
|
|
パスワード
|
password | boolean |
パスワード |
|
|
Expiration
|
expiration | string |
有効期限 (省略可能) |
戻り値
- Body
- outputPublicLink
フィード - フィード項目の作成
レコードに関連付けられた新しいフィード項目を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フィード コンテンツ
|
body | True | string |
フィード 項目のコンテンツ。 より複雑な投稿の型については、プレーン テキスト値または 'messageSegments' JSON オブジェクトを受け入れます ( https://bit.ly/4706k0Mを参照)。 |
|
レコード ID
|
recordId | True | string |
関連付けられているレコード ID |
戻り値
- response
- object
フィード - レコード フィードを取得する
Chatter レコード フィードを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコード ID
|
recordId | True | string |
レコードの ID |
戻り値
- response
- object
レコード - リンク されたファイル
レコードにリンクされているすべてのファイルに関する情報を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
レコード ID
|
recordId | True | string |
レコード ID |
|
リンクの種類
|
linkTypes | True | string |
含めるリンク ファイルの種類 |
戻り値
- response
- object
レコード - レコードの作成
指定したオブジェクト型の新しいレコードを作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名の選択
|
name | True | string |
作成されるオブジェクトの種類 |
|
body
|
body | True | dynamic |
レコード作成の入力 |
戻り値
- response
- object
レコード - レコードの削除
指定したオブジェクト型のレコードを削除する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名の選択
|
name | True | string |
削除されるオブジェクトの種類 |
|
レコード ID
|
recordId | True | string |
削除するレコードの ID |
戻り値
- response
- object
レコード - レコードの取得
指定したオブジェクト型のレコードを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名の選択
|
name | True | string |
取得されるオブジェクトの種類 |
|
レコード ID
|
recordId | True | string |
取得するレコードの ID |
戻り値
- response
- object
レコード - レコードの更新
指定したオブジェクト型のレコードを更新する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
オブジェクト名の選択
|
name | True | string |
更新されるオブジェクトの種類 |
|
レコード ID
|
recordId | True | string |
更新するレコードの ID |
|
body
|
body | True | dynamic |
レコード更新の入力 |
戻り値
- response
- object
潜在顧客 - 潜在顧客の変換
リードを変換する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
潜在顧客 ID
|
leadId | True | string |
潜在顧客識別子 |
|
営業案件の作成
|
createOpportunity | boolean |
変換時に営業案件レコードを作成します。 既定値は True です。 |
|
|
営業案件名
|
opportunityName | string |
作成する営業案件の名前を設定します。 名前が指定されていない場合、この値の既定値は潜在顧客の会社名になります。 |
|
|
リード ソースを上書きする
|
overwriteLeadSource | boolean |
ターゲット連絡先オブジェクトの LeadSource フィールドを、ソース リード オブジェクトの LeadSource フィールドの内容で上書きします。 既定値は false です。 |
|
|
通知メールの送信
|
sendNotificationEmail | boolean |
所有者に通知メールを送信します。 既定値は false です。 |
|
|
アカウント ID を使用したマージ
|
mergeAccountId | string |
潜在顧客がマージされるアカウントの ID。 既存のアカウントを更新する場合にのみ使用します。 |
|
|
連絡先 ID とのマージ
|
mergeContactId | string |
潜在顧客がマージされる連絡先の ID (mergeAccountId で指定されたアカウントに既に関連付けられている必要があります)。 既存の連絡先を更新する場合にのみ使用します。 |
|
|
営業案件 ID とのマージ
|
mergeOpportunityId | string |
リードがマージされる営業案件の ID。 既存の営業案件を更新する場合にのみ使用します。 |
|
|
所有者 ID
|
ownerId | string |
新しく作成されたアカウント、連絡先、または営業案件を所有しているユーザーの ID。 空白の場合は、潜在顧客の所有者の値が使用されます。 |
戻り値
- response
- object
組織 - API バージョンの一覧表示
組織 - 最新の API バージョン
定義
outputActionList
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
results | array of object |
結果 |
|
items
|
results | object |
outputPublicLink
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
オブジェクト ID
|
objectId | string |
コンテンツ配布オブジェクト ID |
|
Success
|
success | boolean |
操作の成功または失敗を示します |
|
パスワード
|
password | string |
自動生成されたパスワード値 |
|
ウェブアドレス
|
url | string |
パブリック URL |
outputStringResult
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
result | string |
テキスト応答 |
outputVersionList
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
results | array of object |
結果 |
|
items
|
results | object |
オブジェクト
これは型 'object' です。