[[:highmapsdrill|{{:wiki:flag_uk.png?45 }}]]

====== Description détaillée de la Cartographie drillable ======

Page Wiki Need4Viz pour l'exploration de MapLine avec un graphique à secteurs.

**Mise à jour pour N4V 2025.3.4**

===== Rendu =====

{{url>https://www.need4viz.com/dataviz/hcmaps.html width=600 height=400 noscroll noborder alignment=center}}

===== Descriptif =====

  * Carte permettant l'affichage d'une bulle ou d'un camembert pour chaque division. \\
  * La taille du camembert est une mesure. La couleur de la région est indiquée par une mesure. \\
  * Un drill sur chaque division affiche un sous niveau (répartition par division niveau 2) avec le même niveau d'information que pour le premier niveau (camembert et couleur par division de niveau 2)
  * Possibilité d'utiliser la fonctionnalité des éléments liés sur ce graphique (sur les premier et deuxième niveaux).

===== Paramètres =====

  * //Code zone niveau 1// : Code de zone de niveau 1 -> [[:maps_codes | Codes disponibles dans les cartes N4V]]
  * //Code zone niveau 2// : Code de zone de niveau 2 -> [[:maps_codes | Codes disponibles dans les cartes N4V]]
  * //Dim du camembert// : [Optionnel] répartition des mesures (camembert)

  * //Couleur zone niv 1// : [Optionnel] Mesure de la couleur de la zone de niveau 1
  * //Couleur zone niv 2// : [Optionnel] Mesure de la couleur de la zone de niveau 2

  * //Camembert/Bulle mes. 1// : [Optionnel] Mesure (pour le camembert ou la bulle si pas de dimension 2)
  * //Camembert/Bulle mes. 2// : [Optionnel] Mesure de la taille des camemberts ou de la bulle

  * //Couleurs du camembert// : [Optionnel] Couleur spécifique de la dimension dans le camembert (au format RGB - ex. "#F434A3")

===== Animations =====

  * Affichez les informations complètes de l'info-bulle lorsque vous déplacez la souris sur un graphique à secteurs sur la carte.
  * Explorez de la carte nationale à la carte régionale en cliquant sur le nom d'une région. La carte de la région affiche les mêmes informations que la carte nationale mais au niveau des départements. Pour revenir au niveau national, cliquez sur le bouton en haut de la carte des régions.
  * Cliquez sur les valeurs de couleur de la légende pour masquer/afficher les régions/départements correspondants.

===== Navigation =====

Utilisez la fonction lien élément natif Webi pour faire interagir ce graphique avec d'autres éléments du même rapport (tableaux/graphiques natifs Webi et/ou graphiques Need4Viz).
La liaison d'éléments peut être définie sur tous les objets ou individuellement sur l'une des dimensions du graphe.

===== Paramètres =====

Vous pouvez trouver des instructions pour accéder aux paramètres des graphiques Need4viz : [[Format Custom Element]].

Pour l'exploration Mapline, les paramètres disponibles sont :

**Global**

  * **Palette et style**
    * //Général// : Vous pouvez utiliser l'outil palette pour définir les couleurs utilisées pour construire le graphique.

**Paramètres étendus**

  * **Carte**
    * //Choix de la carte// : Choisissez une carte dans la liste.

  * **Global** -> Voir le guide de l'utilisateur pour la section "Global" [[global_extparam | ici]]

  * **Menu** -> Voir le guide d'utilisation de la section "Menu" [[menu_extparam | ici]]

  * **Options**
    * //Zoom & Déplacement// : Ces paramètres vous permettent d'activer/de désactiver le zoom, de définir la position du bouton de zoom et de définir la profondeur de zoom maximale. Vous pouvez également activer un zoom sur sélection, dans ce cas, le déplacement de la carte se fait par la combinaison Ctrl+Glisser.
    * //Libellés// : Ce paramètre permet de paramétrer les options des Libellés(Police, Contour, appliquer la police aux hyperliens). Vous pouvez également modifier le nom de propriété technique du nom de la zone dans les fichiers de cartes (niveau 1 & 2). Ce nom sera affiché (ou masqué) sur les cartes. Par défaut, "name" est la propriété technique du nom de la zone dans les fichiers cartographiques Need4Viz.
    * //Afficher les Libellés sur la carte// : Ce paramètre permet d'afficher ou non le nom des zones sans données et/ou les valeurs de mesures sur la carte. Vous pouvez également choisir de ne pas afficher les libellés des mesures sur les zones.
    * //Couleurs// : Ces paramètres permettent de changer les couleurs des zones (par défaut, valeurs nulles, bordure, survol). Les couleurs par défaut et de survol ne sont appliquées que si aucune mesure de division n'est fournie. Vous pouvez également choisir des couleurs dégradées pour la carte et le mini-graphique (les bulles ne sont pas rendues en couleurs dégradées mais avec une opacité variable)

  * **Sélection** -> Voir le guide utilisateur de la section "Sélection" [[drill_extparam | ici]]
    * //Exploration automatique// : Vous pouvez explorer automatiquement si une seule valeur dans le niveau supérieur ou non.
    * //Enregistrer l'exploration// : Vous pouvez choisir ici de ne pas enregistrer la dernière position forée (en revenant au graphique, la dernière position est automatiquement affichée)

  * **Contrôles** -> Voir le guide d'utilisation de la rubrique "Contrôles" [[control_extparam | ici]]

  * **Infobulle** -> Voir le guide d'utilisation de la rubrique "Infobulle" [[tooltip_extparam | ici]]

  * **Légende** -> Voir le guide d'utilisation de la rubrique "Légende" [[legend_extparam | ici]]

  * **Couleur de la division_1**
    * //Couleur de la division pour le niveau 1 (et niveau 2 si aucune seconde mesure n'est définie)// : Ce paramètre permet de préciser le nom de la mesure dans les libellés (remplace le nom de l'objet Webi, la variable %SECTION% N4V peut être utilisée dans l'étiquette), l'unité des régions à ajouter comme préfixe ou suffixe de mesure ainsi que la précision de mesure des régions. Vous pouvez également définir une étiquette personnalisée pour la mesure et un affichage spécifique pour les chiffres positifs/négatifs. Il permet également d'agréger ou non la mesure. Mesure valeur peut être masquée dans l'info-bulle. Le format d'affichage de la mesure (standard - ex. : 2 345.67, compact - ex. : 2.3K ou compact long - ex. : 2.3 milliers) peut également être défini.
    * //Palette de couleur// : Définissez ici la palette appliquée pour colorer les zones. Si "Couleurs par défaut" est défini, la palette définie dans l'option globale sera utilisée (ou des couleurs spécifiques définies dans les plages manuelles seront utilisées). Si la palette Webi (ou Palette personnalisée) est définie, cette palette sera utilisée (la couleur spécifique définie pour les gammes manuelles sera ignorée dans ce cas).
    * //Calcul des plages// : Ce paramètre permet de définir les plages automatiquement ou manuellement. Il permet également de choisir le nombre de gammes de couleurs (max de 10). Vous pouvez également réduire à 0 la précision des valeurs calculées des plages.
    * //Plages manuelles : valeurs hors plages// : Vous pouvez choisir ici la couleur des valeurs hors plages définies manuellement en dessous.
    * //Définitions manuelles des plages 1,2,3,4 et 5// : Ce paramètre permet de choisir la valeur maximale, minimale ainsi que le libellé souhaité pour la plage. Il permet également de choisir la couleur souhaitée pour cette même gamme.

  * **Couleur de la division_2**
    * //Couleur de la division pour le niveau 2 (uniquement si 2 mesures sont définies)// : Ce paramètre permet de préciser le nom de la mesure dans les libellés (remplace le nom de l'objet Webi, %SECTION% variable N4V peut être utilisée dans label), l'unité de régions à ajouter comme préfixe ou suffixe de mesure ainsi que la précision de mesure des régions. Vous pouvez également définir une étiquette personnalisée pour la mesure et un affichage spécifique pour les chiffres positifs/négatifs. Il permet également d'agréger ou non la mesure. La valeur de mesure peut être masquée dans l'info-bulle. Le format d'affichage de la mesure (standard - ex. : 2 345.67, compact - ex. : 2.3K ou compact long - ex. : 2.3 milliers) peut également être défini.
    * //Palette de couleurs// : Définissez ici la palette appliquée pour colorer les zones. Si "Couleurs par défaut" est défini, la palette définie dans l'option globale sera utilisée (ou des couleurs spécifiques définies dans les plages manuelles seront utilisées). Si la palette Webi (ou Palette personnalisée) est définie, cette palette sera utilisée (la couleur spécifique définie pour les gammes manuelles sera ignorée dans ce cas).
    * //Calcul des plages// : Ce paramètre permet de définir les plages automatiquement ou manuellement. Il permet également de choisir le nombre de gammes de couleurs (max de 5 pour une définition manuelle, 10 pour une définition automatique). Vous pouvez également réduire à 0 la précision des valeurs calculées des plages.
    * //Plages manuelles : valeurs hors plages// : Vous pouvez choisir ici la couleur des valeurs hors plages définies manuellement en dessous.
    * //Définitions manuelles des gammes 1,2,3,4 et 5// : Ce réglage permet de choisir la valeur maximale, minimale ainsi que le libellé souhaité pour la gamme 1. Il permet également de choisir la couleur souhaitée pour cette même gamme.

  * **Mesures graphiques**
    * //Mesure graphique 1// : Paramètres pour définir les propriétés de la mesure 1 (unité & précision). Vous pouvez également définir un libellé personnalisé pour la mesure et un affichage spécifique pour les chiffres positifs/négatifs. La précision de l'affichage en pourcentage de cette mesure dans le graphique peut être définie. Le format d'affichage de la mesure (standard - ex. : 2 345.67, compact - ex. : 2.3K ou compact long - ex. : 2.3 milliers) peut également être défini.
    * //Mesure graphique 2// : Paramètres pour définir les propriétés de la mesure 2 (unité & précision). Vous pouvez également définir un libellé personnalisé pour la mesure et un affichage spécifique pour les chiffres positifs/négatifs. Il permet également d'agréger ou non la mesure. La valeur de mesure peut être masquée dans l'info-bulle. Le format d'affichage de la mesure (standard - ex. : 2 345.67, compact - ex. : 2.3K ou compact long - ex. : 2.3 milliers) peut également être défini.

  * **Bulles** (des bulles sont affichées si aucune dimension 2 n'est fournie)
    * //Affichage// : Ces paramètres permettent d'afficher ou non les bulles
    * //Couleurs// : Vous pouvez définir ici l'échelle de couleurs pour les bulles et paramétrer pour afficher ou non l'échelle de coloration dans la légende
    * //Taille// : Vous pouvez définir ici la taille des bulles

  * ** Camemberts ** (les camemberts sont affichées dans le cas de la dimension 2 fournie)
    * //Info-bulle// : ces paramètres vous permettent de choisir le type de valeur/pourcentage à afficher dans la mesure du graphique/de l'info-bulle.
    * //Camemberts// : Choisissez d'afficher ou masquer les camemberts. Définissez ici la couleur et l'épaisseur des bordures des camemberts (pour les camemberts sur la carte ou les camemberts en pop-up). Vous pouvez aussi ajuster la taille des camembert par le facteur de zoom des graphiques.
    * //Mini-graphique en pop-up// : Par défaut, les secteurs sont affichés sur la carte mais vous pouvez choisir ici d'afficher un mini-graphique dans une pop-up qui apparaît lors d'un clic sur la zone de la carte. Le paramétrage permet également de choisir la taille de la fenêtre, le titre de la popup (vous pouvez utiliser la variable %ZONE_NAME% pour afficher le nom de la zone dans le titre) et le message à afficher dans l'infobulle. Vous pouvez également choisir le type de graphique utilisé ainsi que l'ordre d'affichage des valeurs.
    * //Mini-graphique scrollable (pop-up)// : Vous pouvez définir ici le mode de défilement (uniquement pour les mini-graphiques à barres/lignes dans un pop-up) du graphe. Deux modes sont disponibles : une barre de défilement apparaît lors du redimensionnement de la pop-up ou fixe le nombre de catégories à afficher lors du défilement.
    * //Couleurs du mini-graphique (pop-up)// : Vous pouvez définir ici les couleurs du mini-graphique dans le pop-up. Par défaut, chaque catégorie de votre graphique aura une couleur différente (couleurs de la palette), mais vous pouvez choisir de faire varier la couleur avec la valeur de la mesure (vous pouvez définir une valeur min/max de couleurs)
    * //Titre du mini-graphique (pop-up)// : Vous pouvez définir un titre (rappel des totaux pour différentes mesures du graphique) pour le mini-graphique dans une fenêtre séparée. Vous pouvez également définir des polices pour le titre du mini-graphique.
    * //Libellés du mini-graphique (pop-up)// : Vous pouvez choisir le format (valeur et/ou pourcentage) de la mesure affichée dans le mini-graphique dans une fenêtre séparée. Vous pouvez également définir des polices pour les étiquettes du mini-graphique.

**Exporter Serveur** -> Voir le guide utilisateur pour la section "Export Serveur" [[format_export_html | ici]]
   * Cliquez sur la fonction drill JS dans le fichier exporté : Vous pouvez ajouter (dans le HTML exporté) un appel de fonction JS personnalisée lorsque vous cliquez sur drilldown.

**Exporter FTP** -> Voir le guide utilisateur de la rubrique "Export FTP" [[format_export_ftp | ici]]
   * Cliquez sur la fonction drill JS dans le fichier exporté : Vous pouvez ajouter (dans le HTML exporté) un appel de fonction JS personnalisée lorsque vous cliquez sur drilldown.

**Exporter Sharepoint** -> Voir le guide de l'utilisateur pour la section "Export Sharepoint" [[format_export_sharepoint | ici]]
  * Cliquez sur la fonction drill JS dans le fichier exporté : Vous pouvez ajouter (dans l'export HTML) un appel de la fonction JS personnalisée lors du clic sur drilldown.

===== Articles connexes =====

Articles de la base de connaissances pour obtenir plus d'informations :

   * Personnalisez la liste des cartes dans le composant Mapline et Drilldown mapline : [[https://www.need4viz.com/support/kb/faq.php?id=25|Here]]