Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Revert to keep 002.9 instead 002.9.5


Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue


Panel
titleSommaire

Table of Contents
stylenone

Zone des problèmes

Concept

Lorsque vous êtes en train d'éditer une météo possédant des erreurs ou des avertissements, un nouveau menu (encadré en orange) va apparaitre :

  • Vous pouvez le redimensionner en hauteur à l'aide du bouton Image Removed,
  • Il apparaît seulement si il y a des erreurs ou des avertissements,
  • Il permet de visualiser et d'accéder plus rapidement aux erreurs et avertissements,
  • Passé une certaine hauteur, une barre de défilement apparaît.
Panel

Image Removed

Types de problèmes

Erreurs

Les problèmes catégorisés comme erreur sont ceux empêchant la sauvegarde de la météo, ils sont affichés en rouge dans la zone des problèmes.

Avertissements

Les problèmes catégorisés comme avertissement sont ceux n'empêchant pas la sauvegarde de la météo, ils sont affichés en orange dans la zone des problèmes.

Navigation et outils

Lorsque vous êtes en train d'éditer une météo ayant des erreurs, ces dernières vont êtres regroupées en 2 catégories, les erreurs générales et les erreurs concernant les Widgets.

  • Chacune de ces 2 catégories seront affichées dans leur onglet respectif accessible en cliquant dans l'en-tête,

  •  Chaque onglet possède 2 compteurs chacun  (éventuellement caché si non nécessaire) , un rouge pour afficher le nombre d'erreur(s) et un orange qui affiche le nombre d'avertissement(s) (dans le cas des Widget le compteur affiche le nombre d'erreur(s) et d'avertissement(s) de toutes les Widget de la météo).

Panel

Image Removed

Général

C'est dans cet onglet que vont être affichés les erreurs et avertissements liés à la configuration du formulaire JSON qui ne concernent pas les widgets (liens externes, layout, grid, etc...). 

  • Vous y retrouvez les 2 compteurs pour avoir un aperçu rapide du nombre d'erreur présent dans le JSON,
  • Vous pouvez localiser rapidement les erreurs et les avertissements dans le JSON grâce aux liens JSON  que se trouvent en face de chaque message.
Panel

Image Removed

Widget

C'est dans cet onglet que vont être affichés les erreurs et avertissements liés à la configuration des Widgets dans le formulaire JSON.

  • Les informations sont affichées Widget par Widget, vous pouvez choisir laquelle vous voulez afficher à l'aide du menu de navigation situé sur la droite de l'en-tête, vous pouvez aussi y voir le numéro du Widget affiché,
  • Vous y retrouvez les 2 compteurs pour avoir un aperçu rapide du nombre d'erreur présent dans le JSON,
  • Lorsque vous changez de Widget, le formulaire JSON se déplace automatiquement sur la partie qui gère le Widget sélectionné,


  • Lorsque le pop-up d'édition est affiché, les erreurs apparaissent au-dessus du formulaire d'édition.

    Info

    Si vous cliquez sur l'icône à la fin d'un message d'erreur, cela va vous amener au bloc de configuration qui correspond à l'erreur.



    Image Added


    Validation du JSON

    Format invalide

    Le JSON est un format qui suit des règles très strictes.  (regarder page de Affichage et comportement du formulaire JSON - Météo).

    Si vous oubliez une virgule comme dans l'exemple ci-dessous, le JSON deviendra invalide et ne pourra pas être compris (même partiellement), il faudra donc le corriger pour le rendre "lisible" par Shinken.

    On ne peut pas vous dire quelle est l'heure exacte qui rend le format invalide, on peut juste vous donner la ligne à partir duquel le JSON devient invalide. La correction sera "surement" à faire sur cette ligne ou sur la ligne précédente.


    Dans mon exemple ici, il manque une virgule à la fin de la ligne 8 ce qui rend la ligne 9 invalide.

    Il est possible que d'autres erreurs existent dans des lignes qui suivent

    Panel

    Image Added


    Validation de la grille

    Erreurs

    Mauvaise configuration de la grille

    Paramètre de type de grille

    Le paramètre type doit toujours être égal à "grid" ( à ne pas modifier )

    Panel
    bgColor#fff4f4

    La valeur [ grisd ] pour la clé [ type ] est inconnue. Les valeurs possibles sont [ grid ]


    Paramètre nécessitant un entier positif ou une valeur positive

    Pour les paramètres suivants :

    • nb_tiles_in_width
    • nb_tiles_in_height
    • separation_grid_element_min
    • separation_grid_element_percent

    Si la valeur saisie n'est pas un entier positif ou valeur positive, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    nb_tiles_in_width   doit être un entier positif :   [ -60 ]

    nb_tiles_in_height  doit être un entier positif :  [ -50 ]

    separation_grid_element_min  doit être un entier positif :  [ -10 ]

    separation_grid_element_max  doit être un entier positif ou "unlimited" :  [ -20 ]

    separation_grid_element_percent  doit être positif :  [ -1 ]


    Paramètre nécessitant un entier positif ou une valeur définie

    Pour le paramètre separation_grid_element_max, si la valeur saisie n'est pas un entier positif ou unlimited, la sauvegarde ne s'effectuera pas et le   message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    separation_grid_element_max  doit être un entier positif ou "unlimited" :  [ -20 ]


    Paremètre "separation_grid_element_min" supérieur au paramètre "separation_grid_element_max"

    Si le paramètre separation_grid_element_min est supérieur au paramètre separation_grid_element_max, la sauvegarde ne s'effectuera pas et le   message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur de la clé  [ separation_grid_element_min ]  ne peut être supérieur à la valeur de la clé  [ separation_grid_element_max ]


    Widget en dehors de la grille

    Après le calcul des positions X et Y des widgets, si certains sont en dehors de la grille ( X ou Y non compris entre 0 et tiles_max_X et tiles_max_Y ), la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    Le widget est hors de la grille   (  localiser le widget concerné )


    Widgets qui se chevauchent

    Après le calcul des positions X et Y des widgets, si certaines se chevauchent, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    Chevauchement de widgets détectés. Cliquer sur les liens suivants pour localiser les widgets   [ 3 ]   et   [ 4 ]


    Validation des Widgets

    Erreurs communes aux widgets

    Valeur invalide dans les paramètres de positionnement des Widgets

    Si la valeur des paramètres position_x et position_y n'est pas un entier positif ( zéro compris ), la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    position_x   doit être un entier positif :   [ -30 ]   (  localiser le widget concerné )

    position_y  doit être un entier positif :  [ -4 ]   (    localiser le widget concerné )


    Valeur invalide dans les paramètres de taille des Widgets

    Si la valeur du paramètre width n'est pas un entier positif ou all, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    width   doit être un entier positif ou "all" :   [ -15 ]   (  localiser le widget concerné )


    Si la valeur du paramètre height n'est pas un entier positif, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    height   doit être un entier positif :   [ -5 ]   (  localiser le widget concerné )


    Si la valeur du paramètre width est "all" et que la valeur du paramètre position_x n'est pas à 0, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    position_x   doit être égale à 0 si width a la valeur "all" :   [ 10 ]   (  localiser le widget concerné )


    Couleur incorrecte dans un widget

    Le format de la valeur est une couleur web ( Voir :  https://en.wikipedia.org/wiki/Web_colors  )

    Certains caractères " , ; et '  sont interdits dans la couleur de fond de la barre d'information. Si un de ces caractères est présent dans la valeur de la clé text_color, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :


    Panel
    bgColor#fff4f4

    La valeur de la clé   text_color   est incorrecte :   [ black;red ]   (  localiser le widget concerné )


    Widget Titre

    Widget titre inexistant

    Si aucun widget titre n'est défini, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    L'existence d'un widget de type title_widget est obligatoire


    Plusieurs widget titre

    Si plusieurs widgets titre sont définis, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    Il ne peut y avoir qu'un seul widget de type title_widget


    Widget Séparateur

    Valeur invalide dans les paramètres d'espacement du texte

    Si la valeur d'un des paramètres suivants n'est pas un entier positif compris entre 0 et 100, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    • width_percent


    Panel
    bgColor#fff4f4

    width_percent   doit être un entier positif compris entre   0   et   100   :   [ -10 ]   (  localiser le widget concerné )


    Si le paramètre est supérieur à 100, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    width_percent   doit être un entier positif compris entre   0   et   100   :   [ 110 ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres text_align

    Si la valeur du paramètre text_align ne correspond à aucune des valeurs possibles listées ci-dessous, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    • left
    • center
    • right


    Panel
    bgColor#fff4f4

    La valeur   [ bottom ]   pour la clé   [ text_align ]   est inconnue. Les valeurs possibles sont   [ left, center, right ]   (  localiser le widget concerné )


    Widget Météo

    Élément d'un widget météo inexistant

    Si un élément d'un widget météo défini est inexistant ( au sein de l'ensemble défini pour la météo ), la sauvegarde s'effectuera, l'élément sera affiché dans la météo des services comme inexistante et le message d'erreur  suivant apparaîtra :

    Panel
    bgColor#fff4f4

    L'élément de type   [ host ]   avec l'item_uuid   [ c618793e4e3a4a599d6f1cd3bf2a16fdd ]   est inconnu [ item_type: host ]   (  localiser le widget concerné )


    Élément d'un widget météo mal défini

    UUID et nom de l'élément manquant

    Si dans l'élément d'un widget météo au moins une des clés n'est pas définie :

    • item_uuid,
    • item_name,

    la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    Au moins une des deux clés suivantes doit être renseignée :   [ item_uuid ]   ou   [ item_name ]   (  localiser le widget concerné )


    Type de l'élément manquant

    Si le type de l'élément d'un widget météo n'est pas défini, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur de la clé  [ item_type ]  est obligatoire  ( localiser le widget concerné )


    Type d'élément inconnu dans un widget météo

    Si la valeur item_type est différente de "host" ou "cluster", la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    L'élément de type   [ cluster ]   avec l'item_uuid   [ c618793e4e3a4a599d6f1cd3bf2a16fd ]   est inconnu [ item_type: cluster ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres background

    Si la valeur de la clé background est différente de " default ", "status_context_from_webui ", "context_then_status", "context_and_status", "only_status" ou "no_background " la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur   [ bad_value ]   pour la clé   [ background ]   est inconnue. Les valeurs possibles sont   [ status_context_from_webui, context_then_status, context_and_status, only_status, no_background ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres icon_type

    Les valeurs acceptées de la clé icon_type ne sont pas les mêmes pour la zone de gauche et la zone haute-droite

    Mauvaise valeur pour zone de gauche

    Si la valeur icon_type est différente de " default ", "status_context_from_webui", "context_then_status", "status_then_context", "only_status", "sla_tendency" ou "quality_service_iconla sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur   [ bad_value ]   pour la clé   [ icon_type ]   est inconnue. Les valeurs possibles sont   [ status_context_from_webui, context_then_status, status_then_context, only_status, sla_tendency, quality_service_icon ]   (  localiser le widget concerné )


    Mauvaise valeur pour zone haute-droite

    Si la valeur de la clé icon_type est différente de " default ", "status_context_from_webui", "context_then_status", "status_then_context", "only_status" ou "quality_service_iconla sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur [ bad_value ] pour la clé [ icon_type ] est inconnue ou non prise en charge par les widgets Météos. Les valeurs possibles sont [ default, status_context_from_webui, context_then_status, status_then_context, only_status, quality_service_icon ]  ( localiser le widget concerné )


    Valeur identique entre la zone de gauche et la zone haute-droite

    Si la valeur de la clé icon_type est le même entre les deux zones, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur de   top_right_area.icon_type   [ context_then_status ]   et celle de   left_area.icon_type   [ context_then_status ]   ne peuvent pas contenir toutes les deux le statut   (  localiser le widget concerné )


    Valeur invalide dans le paramètres displayed

    La valeur doit être un booléen ou "default". Si la valeur n'est pas booléenne, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    displayed  doit être un booléen :  [ bad_value ]   (    localiser le widget concerné )


    Valeur invalide dans le paramètres show_icon

    La valeur de la clé show_icon  doit être un booléen ou "default".  Si la valeur n'est pas booléenne, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    show_icon  doit être un booléen :  [ bad_value ]   (    localiser le widget concerné )


    Valeur invalide dans le paramètres property_used_as_name

    Si la valeur de la clé property_used_as_name est différente de " default ", " definition_name "ou "visualisation_namela sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur   [ bad_value ]   pour la clé   [ property_used_as_name ]   est inconnue. Les valeurs possibles sont   [ item_name, visualisation_name ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres nb_lines_max

    Si la valeur de la clé nb_lines_max n'est pas un entier positif ou "default", la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    nb_lines_max   doit être un entier positif :   [ bad_value ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres vertical_align

    Si la valeur de la clé vertical_align est différente de " default ", " bottom ", "middle"ou "top" la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    La valeur   [ bad_value ]   pour la clé   [ vertical_align ]   est inconnue. Les valeurs possibles sont   [ top, middle, bottom ]   (  localiser le widget concerné )


    Valeur invalide dans le paramètres font_zoom_percent

    Si la valeur de la clé font_zoom_percent n'est pas un entier positif ou "default", la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    font_zoom_percent   doit être un entier positif :   [ bad_value ]   (  localiser le widget concerné )


    Validation des liens externes

    Erreurs

    Nom manquant

    Si la clé link_name n'est pas renseignée, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :

    Panel
    bgColor#fff4f4

    link_name ne peut être vide


    Caractères interdits

    Certains caractères " , ; et '  sont interdits dans la couleur de fond de la barre d'information. Si un de ces caractères est présent dans la valeur de la clé background_color, la sauvegarde ne s'effectuera pas et le message d'erreur suivant apparaîtra :
    Panel
    bgColor#fff4f4

    La valeur de la clé   background_color   est incorrecte :   [ #F5A;736 ]


    Avertissements

    Contient http:// ou https://

    Les mots "http://" et "https://" ne doivent pas être présents dans la valeur de la clé link_base_url et links__default_base_url car elles seront construites à la sauvegarde grâce à la valeur choisie dans la clé links__default_link_protocol ou link_protocol.

    Panel
    bgColor#fff4f4

    La valeur de la clé link_base_url , ne doit pas commencer par "http://" ou "https://" :  [ https://adress_ip:7767 ]


    Éléments non visibles sur des liens externes accessibles sans authentification

    Il est possible dans l'interface de configuration de définir si un élément est visible ou non dans les vues ne nécessitant pas d'authentification. Si une météo comporte un de ces éléments avec un lien externe ne nécessitant pas d'authentification, un avertissement prévient l'utilisateur pour lui indiquer qu'un élément de sa supervision peut être visible par tout le monde.

    Panel
    bgColor#fff4f4

    Les éléments suivants ne sont pas visibles dans les liens externes accessibles sans authentification : [ nom de mon hôte 1, nom de mon hôte 2 ]


    Validation des utilisateurs

    Erreurs communes

    Valeur invalide dans le paramètre user_name

    Si la valeur de la clé user_name n'est pas une chaîne de caractère, la sauvegarde ne s'effectuera pas  et le message suivant apparaîtra (selon le type d'utilisateur):

    Panel
    bgColor#fff4f4

    La valeur de la clé  [ user_name ]  pour  [ previous_owner_user ]  doit être une chaîne de caractères.


    Valeur invalide dans le paramètre user_uuid

    Si la valeur de la clé user_uuid n'est pas une chaîne de caractère, la sauvegarde ne s'effectuera pas  et le message suivant apparaîtra (selon le type d'utilisateur):

    Panel
    bgColor#fff4f4

    La valeur de la clé  [ user_uuid ]  pour  [ owner_user ]  doit être une chaîne de caractères.


    Avertissements communs

    Utilisateur inexistant

    L'utilisateur peut ne plus être enregistré entre 2 mises à jours de météos (l'identifiant unique est introuvé). Dans ce cas, le message suivant apparaîtra (selon le type d'utilisateur):

    Panel
    bgColor#fff4f4

    Le  [ owner_user ]  avec le  [ user_uuid ]   [ 30067cfe5adf11e59a28080f08538 ]  n'existe pas.

    S'il n'y avait que user_name de défini, le message suivant apparaîtra à la place (selon le type d'utilisateur, toujours):

    Panel
    bgColor#fff4f4

    Le  [ owner_user ]  avec le  [ user_name ]   [ Un utilisateur inconnu ]  n'existe pas.


    Propriétaire

    Pas de propriétaire

    Une météo doit avoir un propriétaire. S'il n'y a ni user_name, ni user_uuid,  le message suivant apparaîtra:

    Panel
    bgColor#fff4f4

    Le  [ owner_user ]  n'est pas défini.

    Vous pouvez localiser rapidement les erreurs et les avertissements dans le JSON grâce aux boutons aux liens JSON que se trouvent en face de chaque message.
    Panel

    Image Removed

    Outils

    Carrousel

    Pour naviguez entre les différents Widgets en erreur, vous disposez d'un menu possédant 2 boutons (en bleu ci-dessous) :

  • Lorsque vous changer de Widget, le JSON ira automatiquement sur l'endroit qui décrit le Widget sélectionné, 
  • Lorsque vous êtes sur le dernier Widget en erreur de la liste et que vous appuyer sur Image Removed, vous revenez sur le premier Widget de la liste et inversement,
  • Dans la zone encadrée en orange est affiché le numéro du Widget sélectionné. Cette zone est cliquable, elle permet d'afficher et faire clignoter le widget sélectionné.
  • Si il n'y a qu'un widget en erreur, les deux boutons seront désactivés.
  • Panel

    Image Removed

    Cacher les problèmes

    Pour alléger la vue de la météo lorsque vous êtes en mode édition, vous pouvez choisir de cacher toutes les Widgets en appuyant sur le bouton Image Removed:

    • Cela masquera toutes les widgets possédant soit une/des erreur(s) soit un/des avertissement(s),
    • La météo aura l'affichage qu'elle aura lorsqu'elle sera vue depuis un lien externe. 
    Panel

    Image Removed

    Panel

    Image Removed