Référence du connecteur Zoho CRM
Bêta
Cette fonctionnalité est en Bêta. Pour l'utiliser, un administrateur de workspace doit activer Lakeflow Connect for Zoho CRM sur la page Previews . Consultez Gérer les aperçus Databricks.
Cette page contient des informations de référence pour le connecteur Zoho CRM géré, y compris les tables source prises en charge et les schémas de table de destination.
Tables sources prises en charge
Le connecteur Zoho CRM prend en charge les tables sources suivantes, toutes sous le schéma source default :
Table source | Clé primaire | Description | Mode de synchronisation | Champ de curseur |
|---|---|---|---|---|
|
| Enregistrements de prospect. | Incrémentiel |
|
|
| Enregistrements de contact. | Incrémentiel |
|
|
| Enregistrements de compte. | Incrémentiel |
|
|
| Enregistrements d’affaires. | Incrémentiel |
|
|
| Enregistrements de campagne. | Incrémentiel |
|
|
| Enregistrements d’activité de tâche. | Incrémentiel |
|
|
| Enregistrements d'activité des appels. | Incrémentiel |
|
|
| Enregistrements des activités de réunion et d'événement. | Incrémentiel |
|
|
| Notes jointes aux enregistrements. | Incrémentiel |
|
|
| Enregistrements des fournisseurs. | Incrémentiel |
|
|
| Enregistrements de devis. | Incrémentiel |
|
|
| Enregistrements des commandes Ventes. | Incrémentiel |
|
|
| Enregistrements de bon de commande. | Incrémentiel |
|
|
| Enregistrements de solution. | Incrémentiel |
|
|
| Enregistrements de cas. | Incrémentiel |
|
|
| Enregistrements de factures. | Incrémentiel |
|
|
| Enregistrements de produits. | Incrémentiel |
|
|
| Entrées de l’historique des étapes pour les transactions. | Incrémentiel |
|
Tables de modules personnalisés |
| Une table par module personnalisé que Zoho CRM signale comme pris en charge par l'API et consultable. Chaque nom de table est le nom de l’API du module en minuscules. | Incrémentiel |
|
|
| Enregistrements de catalogue de prix. | Incrémentiel |
|
|
| Articles de ligne sur les factures. | Incrémentiel |
|
|
| Articles de ligne sur les devis. | Incrémentiel |
|
|
| Postes de ligne sur les commandes de vente. | Incrémentiel |
|
|
| Postes de commande d'achat. | Incrémentiel |
|
|
| Rôles dans la hiérarchie des rôles de l’organisation. | refresh complète uniquement | |
|
| Profils utilisateur. | refresh complète uniquement | |
|
| Devises configurées pour l’organisation. | refresh complète uniquement | |
|
| Détails de l'organisation. | refresh complète uniquement | |
|
| Rôles de contact disponibles pour les transactions. | refresh complète uniquement | |
|
| Territoires configurés dans la Gestion de territoire. | refresh complète uniquement | |
|
| Utilisateurs de l'organisation. | Incrémentiel |
|
|
| Étapes de l'affaire pour chaque pipeline et layout. | refresh complète uniquement | |
|
| Étiquettes définies pour chaque module. | Incrémentiel |
|
|
| Métadonnées de pièce jointe pour les enregistrements. | Incrémentiel |
|
|
| Territoires assignés à chaque utilisateur. | refresh complète uniquement |
Options du connecteur
Pour savoir comment l’utiliser, consultez les Exemples.
Option | Type | Portée | Obligatoire | S'applique à | Description |
|---|---|---|---|---|---|
| Chaîne | Pipeline | Oui | Toutes les tables incrémentielles | Date et heure les plus anciennes à partir desquelles les données doivent être ingérées, au format |
Transformations automatiques des données
Pour les tables de module, les tables d'éléments et les tables de module personnalisées, Databricks transforme les types de champs Zoho CRM en types de données compatibles avec Delta comme suit : Chaque type de champ affiche le nom de l'interface utilisateur Zoho CRM s'il y a lieu, suivi de sa valeur data_type dans l' API de métadonnées des champs Zoho CRM.
Type de champ Zoho CRM | Type de Delta |
|---|---|
Ligne unique ( | Chaîne |
Plusieurs lignes ( | Chaîne |
E-mail ( | Chaîne |
Téléphone ( | Chaîne |
Site web ( | Chaîne |
Liste de sélection ( | Chaîne |
| Tableau de chaînes ( |
Nombre automatique ( | Chaîne |
Image de profil ( | Chaîne |
| Entier grand |
Entier long ( | BigInt ou String lorsque l’API renvoie la valeur sous forme de chaîne |
Décimal ( | Double |
| Double |
Devise ( | Decimal(19, 4) |
| Decimal(19, 4) |
| Booléen |
| Date |
| Horodatage |
Formule ( | Basé sur le type de retour de la formule : Double ( |
Résumé du cumul ( | Basé sur le type de retour : Double ( |
Recherche ( | Variante |
Propriétaire ( | Variante |
Utilisateur ( | Variante |
| Variante |
Recherche à sélection multiple ( | Variante |
Recherche multi-utilisateurs ( | Variante |
Sous-formulaire ( | Variante |
Upload de fichier ( | Variante |
Upload d’image ( | Variante |
Adresse ( | Variante |
| Variante |
| Variante |
| Variante |
| Variante |
Schémas de table de destination
Tables de modules et tables de modules personnalisées
Le connecteur construit le schéma de chaque table de module, table d'élément et table de module personnalisée à partir des métadonnées de champ de ce module dans Zoho CRM. Chaque champ devient une colonne nommée avec le nom de l'API du champ, et le type de données de la colonne suit les transformations de données automatiques. Les colonnes incluent donc des champs personnalisés et varient selon l'organisation Zoho CRM. Chaque table possède également une colonne id de type STRING.
Ces tables sont 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 et attachments.
Le connecteur crée une table de module personnalisé pour chaque module personnalisé que Zoho CRM signale comme pris en charge par l'API et visible par l'utilisateur de la connexion. Le nom de la table est le nom de l'API du module en minuscules. Par exemple, un module personnalisé avec le nom de l'API Projects est placé dans la table projects.
Clé principale : id
Champ de curseur : Modified_Time
Les tables avec des colonnes VARIANT ne prennent pas en charge la dimension à évolution lente (SCD) de type 2. La plupart des tables de module ont des champs de recherche, tels que le propriétaire de l’enregistrement, qui correspondent à VARIANT.
roles
Clé primaire : id
Mode de synchronisation : Full refresh uniquement
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profiles
Clé primaire : id
Mode de synchronisation : Full refresh uniquement
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
currencies
Clé primaire : id
Mode de synchronisation : refresh complète uniquement
Disponibilité : nécessite la multi-devise, qui est disponible dans l’édition Professional ou supérieure.
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
organization
Clé primaire : id
Mode de synchronisation : Full refresh uniquement
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
contact_roles
Clé primaire : id
Mode de synchronisation : Full refresh uniquement
Champ | Type de données |
|---|---|
|
|
|
|
|
|
territories
Clé primaire : id
Mode de synchronisation : refresh uniquement
Disponibilité : Nécessite la Gestion de territoire, qui est disponible dans l’édition Enterprise ou supérieure.
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.
users
Clé principale : id
Champ de curseur : Modified_Time
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2 car elle contient des colonnes VARIANT.
stages
Clé primaire : layout_id, pipeline_id, id
Mode de synchronisation : Full refresh uniquement
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
tags
Clé principale : id
Champ de curseur : modified_time
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
user_territories
Clé primaire : user_id, id
Mode de synchronisation : Full refresh uniquement
Disponibilité : Requiert la gestion de territoire, disponible dans les éditions Enterprise ou supérieures.
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
Permissions OAuth requises
Le connecteur demande les étendues OAuth suivantes en lecture seule pour le client autonome Zoho. Pour plus d’informations, consultez la page Étendues OAuth de Zoho CRM.
Autorisation | Requis pour |
|---|---|
| Tables de modules, tables d'articles, tables de modules personnalisés, |
|
|
| Tables de module, tables d'éléments, tables de module personnalisées |
| Découverte de modules personnalisés, |
| Découverte de schéma pour les tables de module, les tables d’élément et les tables de module personnalisées |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|