Zoho CRM コネクタ リファレンス
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for Zoho CRM を有効にする必要があります。Databricksのプレビューの管理を参照してください。
このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、管理対象の Zoho CRM コネクタのリファレンス情報が記載されています。
サポートされているソーステーブル
Zoho CRMコネクターは、defaultソーススキーマ下の以下のソーステーブルをサポートしています。
ソーステーブル | プライマリーキー | 説明 | 同期モード | カーソルフィールド |
|---|---|---|---|---|
|
| リードレコード。 | インクリメンタル |
|
|
| 連絡先レコード。 | インクリメンタル |
|
|
| アカウントレコード。 | インクリメンタル |
|
|
| 案件レコード。 | インクリメンタル |
|
|
| キャンペーンレコード | インクリメンタル |
|
|
| タスクアクティビティレコード。 | インクリメンタル |
|
|
| 通話アクティビティレコード。 | インクリメンタル |
|
|
| 会議とイベントのアクティビティレコード。 | インクリメンタル |
|
|
| レコードに添付されたメモ。 | インクリメンタル |
|
|
| ベンダーレコード。 | インクリメンタル |
|
|
| 見積レコード。 | インクリメンタル |
|
|
| 受注レコード。 | インクリメンタル |
|
|
| 発注レコード。 | インクリメンタル |
|
|
| ソリューションレコード。 | インクリメンタル |
|
|
| ケースレコード。 | インクリメンタル |
|
|
| 請求書レコード。 | インクリメンタル |
|
|
| 製品レコード。 | インクリメンタル |
|
|
| 取引のステージ履歴エントリ。 | インクリメンタル |
|
カスタムモジュールテーブル |
| Zoho CRMがAPIでサポートされており、表示可能であるとレポートするカスタムモジュールごとに1つのテーブル。各テーブル名は、小文字のモジュールのAPI名です。 | インクリメンタル |
|
|
| 価格表レコード。 | インクリメンタル |
|
|
| 請求書の品目。 | インクリメンタル |
|
|
| 見積の明細項目。 | インクリメンタル |
|
|
| 受注の明細項目。 | インクリメンタル |
|
|
| 発注書の品目。 | インクリメンタル |
|
|
| 組織のロール階層のロール。 | フル更新のみ | |
|
| ユーザープロファイル。 | フル更新のみ | |
|
| 組織用に設定された通貨。 | フル更新のみ | |
|
| 組織の詳細。 | フル更新のみ | |
|
| 取引で使用可能な連絡先ロール。 | フル更新のみ | |
|
| テリトリー管理で構成されたテリトリー。 | フル更新のみ | |
|
| 組織内のユーザー。 | インクリメンタル |
|
|
| パイプラインと Layout ごとの取引ステージ。 | フル更新のみ | |
|
| 各モジュールに定義されたタグ。 | インクリメンタル |
|
|
| レコードの添付ファイルメタデータ。 | インクリメンタル |
|
|
| 各ユーザーに割り当てられたテリトリー。 | フル更新のみ |
コネクターオプション
使用方法については、「例」を参照してください。
オプション | Type | スコープ | 必須 | 適用先 | 説明 |
|---|---|---|---|---|---|
| String | パイプライン | はい | すべての増分テーブル | データの取り込みを開始する最も古い日時( |
自動データ変換
モジュールテーブル、アイテムテーブル、カスタムモジュールテーブルの場合、DatabricksはZoho CRMフィールドタイプを以下のようにDelta互換データタイプに変換します。各フィールドタイプには、適用されるZoho CRM UI名が表示され、その後にZoho CRMフィールドメタデータAPIのdata_type値が続きます。
Zoho CRM フィールドタイプ | Delta型 |
|---|---|
単一行 ( | String |
マルチライン( | String |
Eメール ( | String |
電話番号 ( | String |
ウェブサイト ( | String |
ピックリスト ( | String |
| 文字列の配列 ( |
自動番号 ( | String |
プロファイル画像( | String |
| BigINT |
ロング整数 ( | BigInt。または、APIが値を文字列として返す場合はString |
Decimal ( | Double |
| Double |
通貨( | Decimal(19, 4) |
| Decimal(19, 4) |
| Boolean |
| Date |
| タイムスタンプ |
数式 ( | 数式の戻り値の型に基づきます: Double ( |
ロールアップサマリー ( | 戻り値の型に基づきます:Double ( |
検索 ( | バリアント |
所有者( | バリアント |
ユーザー( | バリアント |
| バリアント |
複数選択ルックアップ ( | バリアント |
マルチユーザー検索 ( | バリアント |
サブフォーム ( | バリアント |
ファイルのupload ( | バリアント |
画像のUpload ( | バリアント |
アドレス( | バリアント |
| バリアント |
| バリアント |
| バリアント |
| バリアント |
宛先テーブルのスキーマ
モジュールテーブルとカスタムモジュールテーブル
コネクタは、Zoho CRMのモジュールのフィールドメタデータから各モジュールテーブル、アイテムテーブル、カスタムモジュールテーブルのスキーマを構築します。各フィールドはフィールドのAPI名で名前が付けられた列になり、列のデータ型は自動データ変換に従います。したがって、列にはカスタムフィールドが含まれ、Zoho CRM組織によって異なります。すべてのテーブルには、型がSTRINGのid列もあります。
これらのテーブルは、leads、contacts、accounts、deals、campaigns、tasks、calls、events、notes、vendors、quotes、sales_orders、purchase_orders、solutions、cases、invoices、products、deal_history、price_books、invoiced_items、quoted_items、ordered_items_sales_order、purchase_items、および attachments です。
コネクタは、Zoho CRM が API でサポートされ、接続ユーザーが閲覧できると報告する各カスタムモジュールに対して、1 つのカスタムモジュールテーブルを作成します。テーブル名は、小文字のモジュールの API 名です。たとえば、API 名が Projects のカスタムモジュールは、projects テーブルに格納されます。
主キー: id
カーソルフィールド: Modified_Time
VARIANT列を持つテーブルは、slowly changing dimension (SCD) タイプ2をサポートしていません。ほとんどのモジュールテーブルには、VARIANTにマップするレコード所有者などのルックアップフィールドがあります。
roles
プライマリキー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profiles
プライマリキー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
currencies
主キー: id
同期モード: 全更新のみ
可用性: Multi-Currencyが必要です(Professionalエディション以上で利用可能)。
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
organization
プライマリキー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
contact_roles
プライマリキー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
territories
プライマリキー: id
同期モード: 全更新のみ
可用性: テリトリー管理が必要です(Enterpriseエディション以上で利用可能)。
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルには VARIANT 列があるため、SCD タイプ 2 はサポートされていません。
users
主キー: id
カーソルフィールド: Modified_Time
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルには VARIANT 列があるため、SCD タイプ 2 はサポートされていません。
stages
プライマリキー: layout_id, pipeline_id, id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tags
主キー: id
カーソルフィールド: modified_time
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
user_territories
プライマリキー: user_id、id
同期モード: 完全更新のみ
可用性: Enterprise エディション以上で使用可能な Territory Management が必要です。
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
必要なOAuth権限
コネクターは、Zoho Self Clientに対して以下の読み取り専用OAuthスコープを要求します。情報については、「 Zoho CRM OAuth スコープ」を参照してください。
権限 | 必要なもの |
|---|---|
| モジュールテーブル、アイテムテーブル、カスタムモジュールテーブル、 |
|
|
| モジュールテーブル、アイテムテーブル、カスタムモジュールテーブル |
| カスタムモジュールの検出、 |
| モジュールテーブル、アイテムテーブル、およびカスタムモジュールテーブルのスキーマ検出 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|