Links

Salesforce

Source Salesforceを使用して、Salesforce内のオブジェクトのデータを取得できます。オブジェクトは標準オブジェクト・カスタムオブジェクト共に対応しています。

Source Salesforce

入力例

name
required
description
json field for import
type
表示名
任意
タスクの表示名を入力します。
接続情報
必須
接続情報画面で設定した、Salesforceへの接続情報を選択します。
integration_name
string
Search Method
必須
オブジェクトのデータの取得方法を選択します。
「sobject」「soql」「report」が使用でき、いずれか一つを選択する必要があります。
search_method
string
sobject
必須(Search Methodがsobjectの場合)
オブジェクトのAPI参照名を指定します。
API参照名に関してはオブジェクトマネージャから確認できます。
例:
「商談」オブジェクトの場合は「Opportunity」と入力
「取引先」の場合は「Account」と入力
sobject
string
soql
必須(Search Methodがsoqlの場合)
SOQLはSalesforce データ専用に設計されたSQLライクなクエリ言語です。こちらを使用してオブジェクトのデータを取得することができます。
例として 「商談」オブジェクトのIdをすべて取得する場合
SELECT Id FROM Opportunity
「取引先」オブジェクトの「取引先名」「電話」フィールドを取得する場合
SELECT Name, Phone FROM Account
soql
string
report
必須(Search Methodがreportの場合)
Salesforce上で作成したレポートの、レポートIDを指定することでレポートのデータを取得することができます。
レポートIDは、対象のレポートをSalesforce上で開いた際に表示される、以下のようなURLのxxxxxxxx部分から確認することができます。
/lightning/r/Report/xxxxxxxx/view?queryScope=userFolders
report_id
string
SOQL クエリでSELECT * は出来ない
指定するフィールド名はオブジェクトマネージャなどを用いて確認してください。
report は上限 2000 件
Salesforce Report API には取得できるデータに 2000 件の上限があります。
report のデータを 2000 件よりも多く取得したい場合には report で収集・加工していることを SOQL クエリで再現すれば可能です。それぞれの report で実施している収集・加工によって書くべきクエリは異なります。

SQLサンプル

  1. 1.
    カラムをリネームする。 SELECT [Name] AS MY_Name FROM Account
  2. 2.
    カラムのデータを別のデータ型としてキャストする。 SELECT CAST(AnnualRevenue AS VARCHAR) AS Str_AnnualRevenue FROM Account
  3. 3.
    データを検索する。 SELECT FROM Account WHERE Industry = 'Floppy Disks'
  4. 4.
    クエリ条件に一致するアイテムの数を返す。 SELECT COUNT() AS MyCount FROM Account
  5. 5.
    クエリ条件に一致する一意のアイテムの数を返す。 SELECT COUNT(DISTINCT Name) FROM Account
  6. 6.
    クエリ条件に一致する一意のアイテムを返す。 SELECT DISTINCT Name FROM Account
  7. 7.
    データを要約する。 SELECT Name, MAX(AnnualRevenue) FROM Account GROUP BY Name
  8. 8.
    複数のテーブルからデータを検索する。 SELECT Customers.ContactName, Orders.OrderDate FROM Customers, Orders WHERE Customers.CustomerId=Orders.CustomerId SELECT User.Name, Amount, CloseDate From User, Opportunity WHERE User.Id=Opportunity.OwnerId SELECT Account.Name, StageName, Amount, CloseDate, Proposalproducts__c from Account, Opportunity
  9. 9.
    昇順で結果をソートする。 SELECT BillingState, Name FROM Account ORDER BY Name ASC
  10. 10.
    指定した行数に結果を制限する。 SELECT BillingState, Name FROM Account LIMIT 10