# Cartes Les Cartes vous permettent d'afficher les éléments "champs Adresse" sous forme de cartographie. \ Ainsi, chaque point de la carte affiche un enregistrement sous la forme d'une icône dont vous pouvez paramétrer la couleur. ## ➕ Créer une Carte Depuis l'onglet *Données* de la barre d'ajout d'un élément, cliquez sur **Ajouter un affichage** puis sur **Carte**. Vous pouvez ensuite cliquer sur l’élément Carte placé dans votre page afin d’en modifier les paramètres. ## ⚙️ Paramétrer une Carte {% hint style="info" %} Pensez à renommez votre Calendrier afin de le retrouver plus facilement dans l'application. {% endhint %} ### 🗂️ Paramétrage des sources {% hint style="info" %} Une source est créée par défaut. Vous pouvez en ajouter d’autres en cliquant sur « Ajouter une source » en bas de la configuration. {% endhint %} 👉🏼 Vous pouvez renommer votre source en cliquant sur le crayon à côté de son nom :

1️⃣ Sélectionnez la table source à partir de laquelle les enregistrements seront récupérés pour être affichés sur la carte.\ \ 2️⃣ Choisissez ensuite quels enregistrements vous souhaitez afficher.

Choix des enregistrements à afficher

👉🏼 De l'**Utilisateur connecté** : signifie que les réponses qui s'afficheront sur la Carte seront issues des enregistrements remplis par l'Utilisateur uniquement. \ Par exemple : si l'Utilisateur a rempli 2 workflows "Ajouter un chantier", alors 2 marqueurs apparaîtront sur la Carte. \ \ 👉🏼 Des **Groupes auxquels appartient l'Utilisateur** : signifie que les réponses qui s'afficheront sur la Carte seront issues des enregistrements remplis par l'Utilisateur ET des enregistrements remplis par les Utilisateurs faisant partie du même Groupe. \ Par exemple : si Marie et Paul font partie du même Groupe et qu'ils ont renseignés 2 chantiers chacun, alors 4 marqueurs apparaîtront sur la Carte. \ \ 👉🏼 **Tout le monde** : signifie que les réponses qui s'afficheront dans la Liste seront issues des enregistrements remplis par tous les Utilisateurs de l'Application.

3️⃣ Sélectionnez le champ de la table source correspondant à l'adresse qui doit être utilisée pour l’affichage sur la Carte 4️⃣ Choisissez l’icône à afficher pour marquer les emplacements sur la carte. 5️⃣ Déterminez la couleur de l’icône. Vous pouvez définir la couleur depuis : * Une valeur personnalisée : en sélectionnant la couleur directement depuis un sélecteur de couleur. * La valeur d'un champ : en sélectionnant une variable de [champ couleur ](https://ksaar.gitbook.io/ksaar-documentation/les-elements/les-champs#le-champ-couleur)à utiliser.

Option disponible dans les paramètres de la source

Exemple de paramétrage de la couleur d'une carte - couleur en fonction du statut

6️⃣ Définissez le titre des marqueurs à afficher lors du survol. Il est possible d'utiliser des variables pour personnaliser le titre en fonction des enregistrements. 7️⃣ Choisissez la redirection lorsque l'Utilisateur cliquera sur l'icône. La redirection peut s'effectuer vers un **Workflow**, une **Fiche**, un **Suivi** ou un **lien externe**. \ Vous pouvez aussi afficher une **Description** pouvant contenir des variables.\ Par exemple : dans le cas d'une Carte qui affiche tous les chantiers d'une entreprise Titre à affiche : {Nom du Chantier}\ Description : {Adresse du chantier}\ {Client lié } 📱 {Numéro de mobile}

Aperçu côté USER lors du clic sur une icône

Déterminez également si vous souhaitez afficher un bouton menant vers une fiche lors de l’ouverture de la description du marqueur. Le cas échéant, sélectionnez la fiche ainsi que le texte du bouton affiché sous la description. Exemple : « Modifier le chantier ».

Aperçu côté USER lors d'un clic sur une icône avec bouton qui mène vers une fiche

7️⃣ *(facultatif)* Ajoutez des filtres afin de conditionner l’affichage des enregistrements sur la Carte. Vous pouvez définir des conditions d'affichage des enregistrements en fonction : * de la valeur prise par un **champ Utilisateur** (identifiés par le (U) devant leur identifiant unique) * de la valeur prise par un **champ de la Table** * d'un Persona, d'un Utilisateur, d'une Table, d'une étape de suivi en cours, de la date de création, de la date de modification, du statut de l'enregistrement Cela me permet par exemple, de créer une seule et même carte avec plusieurs sources d'adresses et de pouvoir décider qui peut voir la source.
Par exemple, je créer une Carte avec deux sources : * la localisation des Chantiers * la localisation des Techniciens
Je veux que les deux sources soient visibles par la Persona Directeur et par la Persona Comptable mais je veux que les Techniciens ne puissent voir que la localisation des Chantiers: * Au niveau de la source Techniciens, je clique sur le menu données puis sur l'onglet Filtres * Je programme ma condition : * Type de champ : Autre * Champ à tester : Persona * Comparaison : Différent de * Valeur : Technicien

Cela signifie que la source "Techniciens" **s'affiche SI** la Persona est différente de Techniciens. ### 🗺 Définir la vue par défaut de la Carte pour les utilisateurs Cette option permettra aux utilisateurs de se retrouver à un endroit que vous aurez choisi lors de l'affichage de la Carte. Vous pouvez choisir l'emplacement et le niveau de Zoom. \ Par défaut, lorsque vous ajoutez une Carte, celle-ci est centrée sur la ville de Paris.\ \ 👆🏼Ainsi, pour des adresses majoritairement situées à Bordeaux, il convient de déplacer la carte sur la ville de Bordeaux. Au contraire, si les adresses sont situées aux quatre coins de la France, il conviendra alors de dézoomer la carte pour avoir un aperçu de la France entière.

### 🔽 Paramètres spécifiques à l'emplacement 1️⃣ *(facultatif)* Centrez la carte par rapport à un champ adresse Dans les paramètres spécifiques à l'emplacement, vous pouvez choisir de centrer la carte par rapport à un champ adresse d'une table ou d'un utilisateur. Ce paramètre est prioritaire par rapport à la vue par défaut, mais si le champ choisi est vide, la carte sera centré par rapport à la vue par défaut.

2️⃣ *(facultatif)* Filtrez une carte par un élément champ Zone Géographique Cette fonctionnalité vous permet de filtrer votre Carte et de rechercher à l'intérieur de celle-ci : * une localité * un temps de trajet (en transport) 👉🏼 Cette option s’affiche uniquement si un champ *Zone géographique* est présent à l’emplacement où la carte est insérée. Pour en savoir plus sur cette fonctionnalité et comment la paramétrer\ 👉🏼 [**rendez-vous sur ce lien**](https://ksaar.gitbook.io/ksaar-documentation/les-elements/les-champs#le-champ-zone-geographique) 3️⃣ *(facultatif)* Filtrez les enregistrements. Ce type de filtre fonctionne comme les **filtres de la source de données**, mais il est **spécifique à l’emplacement** où la carte est positionnée. 👉🏼 Cela permet de définir des filtres différents selon l’endroit où la carte est utilisée, indépendamment des filtres globaux de la source. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ksaar.gitbook.io/ksaar-documentation/laffichage-des-donnees/cartes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.