Les variables du Studio : brancher vos visuels sur vos données
C’est ce qui sépare le Studio d’un outil de création classique. Ailleurs, vous recopiez le prix, la surface, le DPE, les photos. Ici, vous posez une variable : un bloc qui va chercher l’information dans votre base Prospeneo.
Vous créez le modèle une fois. Vous le générez ensuite pour n’importe quel bien, et chaque bloc se remplit tout seul.
Comment ça marche
Une variable est un emplacement réservé. Dans l’éditeur, elle affiche un exemple. Au moment de générer le document pour un bien réel, l’exemple est remplacé par la vraie valeur.
Ouvrez l’onglet Variables dans la barre de gauche, choisissez une catégorie, cliquez sur la variable. Elle se pose sur le canevas comme n’importe quel élément : vous la déplacez, vous la redimensionnez, vous changez sa police et sa couleur.
Cherchez plutôt que de parcourir
Il y a une centaine de variables. Le champ de recherche, en haut de l’onglet, est le bon réflexe : tapez « prix », « chauffage », « logo », la liste se réduit aux variables correspondantes et les catégories vides disparaissent. Vous trouvez en deux secondes ce qu’un parcours catégorie par catégorie vous ferait chercher une minute.
L’orange, c’est ce qui n’est pas encore rempli
C’est le repère le plus utile de l’éditeur : une variable non résolue s’affiche toujours en orange. Un texte noir est un texte que vous avez tapé ; un texte orange est un emplacement qui attend sa donnée.
Chaque bloc variable porte aussi son libellé (⚡ suivi du nom) au-dessus de son coin haut-gauche. C’est du repère d’édition : ni l’orange ni le libellé n’apparaissent sur le document final.
Conseil : Sur un modèle chargé, les libellés se chevauchent et masquent ce que vous placez. Le bouton Masquer les libellés, dans l’onglet Variables, les fait disparaître d’un coup — les blocs restent là, seuls les repères s’effacent. Indispensable dès que vous ajustez des éléments serrés.
Attention : Un bloc variable ne se modifie pas au double-clic, contrairement à un texte normal. Son contenu est un emplacement réservé : le modifier casserait le lien avec la donnée. Vous pouvez en revanche le déplacer et le redimensionner librement.
Les variables disponibles
Dans l’onglet Variables, elles sont rangées en six catégories. Chacune correspond à un endroit précis de votre base : c’est là que la valeur ira se chercher au moment de générer le document.
| Catégorie | Ce qu’elle contient |
|---|---|
| Annonce | tout ce qui décrit le bien en vente ou en location : prix, honoraires, surface, pièces, référence, descriptif, photos, DPE |
| Estimation | l’avis de valeur : fourchette de prix, graphiques, carte du bien, courbes de marché |
| Propriété | le bien lui-même, indépendamment d’une annonce : adresse, cadastre, lots et surfaces, codes d’accès |
| Contact | la personne : nom, téléphone, email |
| Agence | votre point de vente : nom, logo, coordonnées, mentions légales |
| Document | le document en cours : date d’édition, numérotation des pages |
La distinction Annonce / Propriété est celle qui surprend le plus. Une propriété existe dans votre base même sans être en vente ; l’annonce, c’est sa mise sur le marché. Le prix est une variable Annonce. L’adresse et les codes d’accès sont des variables Propriété. Un modèle d’estimation puise surtout dans Propriété et Estimation, une fiche vitrine surtout dans Annonce.
> Quelques variables apparaissent grisées dans le panneau : elles sont au catalogue mais la donnée n’est pas encore branchée côté serveur. Elles sont visibles pour annoncer ce qui arrive, et ne se posent pas sur le canevas — vous ne pouvez pas créer un bloc qui resterait vide. :
Inutile de lister ici les dizaines de variables de chaque catégorie : le champ de recherche vous y amène plus vite. Quelques-unes méritent en revanche une explication à part.
Max ou Élastique : les deux comportements
Voilà le point qui déroute au début. Vous dessinez un cadre pour un prix, et le prix réel fait « 1 250 000 € » là où votre exemple faisait « 250 000 € ». Que doit faire le cadre ?
Il n’y a pas une bonne réponse, il y en a deux — et chaque variable a la sienne. Regardez le petit badge sur son libellé : Mx ou El. Cliquez dessus, l’explication s’ouvre dans l’éditeur.
| Max (Mx) | Élastique (El) | |
|---|---|---|
| Le cadre s’ajuste | en hauteur | en largeur |
| La taille du texte | ne change jamais | ne change jamais |
| Si le texte est trop long | la fin est coupée « … » | rien n’est coupé, le cadre s’allonge |
| Limite | ne dépasse jamais la hauteur que vous dessinez | aucune |
| Pour | un paragraphe : descriptif, prestations | une valeur courte : titre, nom, prix |
Max respecte la boîte que vous avez dessinée. Vous lui donnez une hauteur maximale, elle ne la dépassera pas : un descriptif à rallonge sera coupé plutôt que de déborder sur le bloc du dessous. Et si le texte est plus court que prévu, le cadre se réduit au texte au lieu de laisser un grand vide.
Élastique fait l’inverse : elle s’adapte au contenu, sans limite, en largeur. Tout s’affiche, toujours.
Grouper des variables : ce qui bouge, ce qui ne bouge pas
C’est ici que tout se joue, et c’est simple une fois la règle comprise :
> Une variable ne déplace que les blocs groupés avec elle. Seule, elle grandit et rétrécit dans son coin sans rien décaler autour. :
Le sens du mouvement suit le type :
-
Élastique → sa ligne. Elle emmène les blocs collés à côté d’elle.
-
Max → sa colonne. En se réduisant, elle fait remonter les blocs en dessous d’elle.
Une élastique collée à du texte libre
Le cas classique : vous écrivez « Prix de vente : » en texte libre, et vous collez juste derrière la variable Prix.
Sans groupe, la variable s’allonge de « 250 000 € » à « 1 250 000 € » et passe sous votre texte, ou laisse un trou béant. Groupez les deux : le texte reste collé à la variable, quelle que soit sa longueur. L’espace entre les deux ne bouge jamais.
L’alignement de la variable décide du sens où ça pousse :
-
Alignée à gauche — son bord gauche est figé, elle grandit vers la droite.
-
Alignée à droite — son bord droit est figé, elle grandit vers la gauche.
-
Centrée — elle grandit des deux côtés à la fois, à parts égales.
C’est la clé du placement. Une variable alignée à droite, calée sur la marge droite de votre affiche, ne débordera jamais de la page : elle s’allonge vers l’intérieur. La même alignée à gauche partirait dans le vide.
D’où la règle pratique : mettez le libellé à gauche, alignez la variable à gauche, l’ensemble grandit vers la droite — vers la marge, là où il y a de la place.
Deux variables Max l’une sous l’autre
Même logique, à la verticale. Un titre « Descriptif » et le descriptif en dessous : si le bien n’a pas de descriptif, la variable se réduit à rien mais le titre, lui, reste — vous imprimez un « Descriptif » suivi de blanc.
Groupez le titre avec sa variable : ils ne font plus qu’un bloc. La variable se réduit, le titre remonte avec elle, et les blocs de la même colonne suivent. Vous n’avez plus de trous dans vos avis de valeur.
Conseil : Ce réflexe — grouper chaque variable avec son titre — est celui qui vous fera gagner le plus. C’est aussi lui qui déclenche la suppression des pages vides sur une estimation, expliquée plus bas.
> Une carte groupée remonte d’un seul bloc, et les colonnes de côté ne bougent pas. Vos deux colonnes ne se décalent pas l’une l’autre : chacune vit sa vie. :
L’étiquette DPE
Une variable dédiée qui affiche l’étiquette énergie et climat aux couleurs réglementaires.
[!danger] Attention L’étiquette DPE est encadrée par la loi. Sur un support physique (affiche, fiche vitrine), elle doit occuper au minimum 5 % de la surface du document — le Studio applique ce plancher automatiquement, au redimensionnement comme à la saisie manuelle. Pour une annonce diffusée sur Internet, la règle est différente : 180 × 180 pixels minimum. Dans tous les cas, l’étiquette doit rester lisible et en couleur.
La carte du bien
Variables > Estimation > Carte du bien. Une carte de situation centrée sur l’adresse, avec le contour de la parcelle cadastrale et un repère rouge. Elle se pose comme un bloc image au format paysage.
Si l’adresse est introuvable, la carte reste vide plutôt que d’afficher un mauvais emplacement.
Le QR code
Un QR code qui mène à la page web du bien. Utile sur une fiche vitrine : le passant scanne et arrive sur l’annonce.
Vous n’avez aucune URL à saisir, la variable la trouve seule, dans cet ordre :
-
La page publiée du bien. Dès que l’annonce est diffusée quelque part — un site de la gamme Vitrinellis, une autre passerelle — le QR pointe sur cette page. Le passant tombe sur l’annonce elle-même, avec les photos et le descriptif.
-
À défaut, le site de votre point de vente — l’adresse renseignée dans Prospeneo au niveau du point de vente. Le QR ramène alors sur votre site, pas sur le bien.
> Un bien pas encore diffusé renvoie donc vers votre site, pas vers une page qui n’existe pas. Si le point de vente n’a pas d’URL renseignée non plus, la variable reste vide : pensez à remplir ce champ une bonne fois, il sert à tous vos modèles. :
Les graphiques d’estimation
Pour vos avis de valeur :
-
Graphique d’estimation — les barres prix minimum, prix maximum, valeur locative et prix souhaité. Il s’adapte si une valeur manque.
-
Prix au m² des biens vendus, budget des acquéreurs, durée moyenne de vente — des courbes sur 12 mois, chacune avec ses propres couleurs pour ne pas les confondre.
Conseil : Ces trois courbes servent à un seul objectif : montrer au vendeur, chiffres à l’appui, où se situe son prix. Le budget réel des acquéreurs du secteur et la durée moyenne en vente disent souvent mieux qu’un long discours qu’un bien est trop cher.
Le tableau des lots et surfaces
L’agencement du bien, présenté en tableau structuré.
Prévisualiser avec des données réelles
Dans l’éditeur, les variables affichent des exemples. Pour vérifier votre mise en page avec de vraies données, ouvrez Prévisualiser avec des données réelles en bas de l’onglet Variables.
Choisissez le type d’identifiant, saisissez-le, puis Remplacer les variables. Le visuel se remplit avec les données de ce bien.
| Choix | Quand l’utiliser |
|---|---|
| Type auto (détecter) | vous ne savez pas trop : Prospeneo essaie de reconnaître ce que vous avez saisi |
| ID annonce | vous testez une fiche vitrine, une fiche client ou une fiche privée |
| ID estimation | vous testez un avis de valeur |
Où trouver ces références ? C’est le lien dépliable, juste sous le champ. Il vous les indique :
-
ID annonce — sur la fiche annonce, badge # à côté du titre
-
ID estimation — sur la fiche estimation, sous le titre
Attention : L’identifiant doit correspondre au type de document que vous testez. Si vous prévisualisez un modèle d’estimation avec un ID d’annonce, les variables de la catégorie Estimation resteront vides : une annonce ne porte pas de fourchette de prix ni de courbes de marché, ce sont deux objets différents dans votre base. Vous croiriez à un modèle cassé alors que c’est simplement la mauvaise référence.
C’est exactement pour ça que le menu déroulant existe : forcez ID estimation pour tester une estimation, ID annonce pour une fiche. En cas de doute, laissez Type auto.
Si la référence n’existe pas, Prospeneo vous le dit : Référence non reconnue.
> La prévisualisation ne modifie pas votre modèle. Réinitialiser la prévisualisation ramène les exemples, et un simple rechargement fait la même chose : le modèle reste générique et réutilisable pour n’importe quel bien. C’est le comportement voulu. :
Quand une donnée manque
Une variable sans donnée laisse un blanc, elle n’affiche jamais l’exemple à la place. Le bloc garde sa place dans la mise en page.
Sur une estimation, vous pouvez aller plus loin : groupez une variable avec son titre (sélectionnez les deux, puis groupez). Si la variable ne renvoie rien, le titre disparaît avec elle, et la page entière est retirée du PDF ainsi que de la numérotation. Un bien sans lots et surfaces ne sortira pas d’avis de valeur avec une page « Lots & surfaces » vide.