Champs et mapping

Acta n’impose aucun champ. Chaque donnée renvoyée par les sources (SIREN, dénomination, code NAF, adresse…) est écrite dans le champ de votre choix. Ce rangement, le mapping, se règle sans code dans la page Configuration Acta.

Ouvrir l’éditeur de mapping

1. Ouvrez l’application Acta depuis le lanceur d’applications, puis l’onglet Configuration Acta. L’assistant de la barre d’utilitaires y mène aussi, par son étape « Mapping des champs ».
2. Cliquez sur la section 3. Mapping des champs.
3. Choisissez l’objet à régler dans la liste : Compte, Piste, ou Autre objet… pour un objet personnalisé (saisissez alors son nom d’API, par exemple Fournisseur__c).

L’éditeur liste toutes les données officielles qu’Acta sait fournir, rangées par thème : identité, activité, adresse, géolocalisation et suivi. Chaque ligne indique la source de la donnée et un exemple de valeur. En face, vous choisissez où la ranger.

Droits nécessaires

Pour modifier le mapping, il faut l’ensemble d’autorisations Acta, administration et l’autorisation système Personnaliser l’application. Sans elle, l’éditeur s’affiche en lecture seule.

Le mapping fourni par défaut

Objet	Donnée	Champ cible	Mode
Compte	denomination	Nom du compte (Name)	Si vide
Compte	street, postalCode, city, country	Adresse de facturation	Si vide
Compte	latitude, longitude	Coordonnées de facturation	Si vide
Piste	denomination	Société (Company)	Si vide
Piste	street, postalCode, city, country	Adresse	Si vide
Piste	latitude, longitude	Coordonnées	Si vide

Tout est en mode Si vide : Acta complète sans rien écraser. Vous pouvez modifier, désactiver ou compléter ces lignes. Pour aller plus loin, il faut vos propres champs : c’est l’objet des deux étapes suivantes.

Préparer les champs SIREN et SIRET

Salesforce n’a pas de champ SIREN, ni de champ pour le code NAF ou la TVA. Créez ceux dont vous avez besoin sur chaque objet à enrichir. Pour démarrer sur le compte, voici le jeu conseillé. Les quatre premiers sont indispensables : les deux identifiants, et deux champs pour voir le résultat de chaque enrichissement.

Libellé	Nom d’API	Type	Champ source Acta	Mode
SIREN	SIREN__c	Texte (9)	siren	Si vide
SIRET	SIRET__c	Texte (14)	siret	Si vide
Statut d’enrichissement	StatutEnrichissement__c	Texte (20)	enrichmentStatus	Toujours
Message d’enrichissement	MessageEnrichissement__c	Texte (255)	enrichmentMessage	Toujours
Code NAF	CodeNAF__c	Texte (10)	nafCode	Toujours
Forme juridique	FormeJuridique__c	Texte (4)	legalFormCode	Toujours
Numéro de TVA	NumeroTVA__c	Texte (13)	vatNumber	Toujours
Dernière synchronisation	DerniereSynchro__c	Date/Heure	lastSync	Toujours

Pour chaque champ :

1. Configuration > Gestionnaire d’objets > Compte > Champs et relations > Nouveau.
2. Choisissez le type, puis saisissez le libellé, la longueur et le nom indiqués. Pour le SIREN, cochez ID externe si vous voulez dédoublonner vos comptes par SIREN.
3. Sécurité au niveau du champ : rendez le champ visible pour tous les profils qui utilisent les comptes. Acta écrit avec les droits de l’utilisateur : un champ en lecture seule pour lui ne sera pas rempli.
4. Présentations de page : ajoutez le champ à la présentation du compte, de préférence dans une section « Données légales ».

Faites de même sur la piste si vous voulez l’enrichir (au moins SIREN, SIRET et le statut).

Un mapping, deux usages

Le mapping des champs siret et siren sert aussi à lire l’identifiant : quand l’enrichissement ne reçoit pas d’identifiant, il cherche d’abord le SIRET, puis le SIREN, dans les champs mappés de l’enregistrement. Sans ces deux lignes de mapping, l’enrichissement automatique ne trouvera jamais l’identifiant.

Régler le mapping

Sur chaque ligne de donnée officielle :

Colonne	Choix	Explication
Champ à remplir	SIREN (SIREN__c)	Seuls les champs de type compatible sont proposés. — Ne pas remplir — laisse la donnée de côté
Écriture	Si vide / Toujours	Si vide complète seulement les champs vides et respecte les saisies de vos utilisateurs. Toujours remplace la valeur à chaque enrichissement
Transformation	Telle quelle	MAJUSCULES ou minuscules, pour les textes
Alerte si changement	coché	Signale quand la donnée officielle diffère de la valeur enregistrée, même en mode Si vide : par exemple un SIRET qui change après un déménagement

Un même champ ne peut recevoir qu’une seule donnée : en cas de doublon, les lignes concernées passent en rouge et l’enregistrement est bloqué. À l’inverse, une donnée peut remplir plusieurs champs : le bouton + au bout de la ligne ajoute un champ cible.

Quand tout est prêt, cliquez sur Enregistrer : toutes les modifications partent en une fois. Salesforce déploie le réglage en quelques secondes ; un bandeau l’indique et vous recevez une notification à la fin. Annuler les modifications revient au mapping enregistré.

Le filtre Toutes les données / Données utilisées permet de ne garder à l’écran que les lignes déjà mappées.

Proposer automatiquement

Le bouton Proposer automatiquement pré-remplit les lignes d’après le nom de vos champs : un champ appelé SIREN__c ou « Code NAF » est reconnu tout seul. Rien n’est enregistré : vérifiez les propositions, corrigez si besoin, puis cliquez sur Enregistrer.

Déclarer le mapping de vos champs

Une fois les champs du tableau Préparer les champs créés sur le compte :

1. Choisissez l’objet Compte, puis cliquez sur Proposer automatiquement.
2. Vérifiez que chaque champ est en face de la bonne donnée, et réglez le mode d’écriture indiqué dans le tableau.
3. Cochez Alerte si changement sur le SIRET si vous voulez être prévenu d’un changement d’établissement.
4. Cliquez sur Enregistrer.

Si aucun champ de l’objet ne reçoit le SIRET, un avertissement s’affiche en haut de la section : choisissez son champ sur la ligne SIRET. Sans lui, l’enrichissement automatique ne saura pas quelle entreprise chercher.

Les deux champs de suivi (statut et message) vous permettent de voir le résultat directement sur le compte, et de construire une vue de liste des comptes en erreur.

Règles appliquées

• Les valeurs sont converties vers le type du champ cible (texte, nombre, date, case à cocher) et tronquées à sa longueur.
• Une donnée absente n’efface jamais une valeur existante.
• Un champ que l’utilisateur ne peut pas modifier est ignoré, sans erreur.
• Un champ cible qui n’existe pas est ignoré : vérifiez l’orthographe du nom d’API si une donnée n’arrive pas.

Sans la page Configuration

Le mapping est stocké dans le type de métadonnées personnalisées Mapping de champ. La page Configuration Acta ne fait que le modifier pour vous. Pour un déploiement entre orgs (bac à sable vers production), ces enregistrements se déploient comme n’importe quelle métadonnée : avec un ensemble de modifications ou sf project deploy start.