Les vues


Note : Cette page décrit l'écran d'édition de vues autonomes, mais la description des critères, de leurs conditions et de leur mode de saisie est identique pour une vue supportant un reporting.
Definition

Une vue est un objet permettant la consultation des informations contenues dans les tables. Elle agit sur la présentation des informations, tant sur leur regroupement que sur leur mise en page.

EndDefinition

Chaque vue :

  • est bâtie sur une requête parent permettant de travailler sur un ensemble d'informations homogènes des bases de données ;
  • peut contenir des ruptures :
    • les données sont regroupées et triées par niveaux agissant comme une hiérarchie de filtres ; 
    • les informations finales de la vue sont affichées sous forme de liste contenant des colonnes paramétrées (une ligne par enregistrement).
  • peut contenir des alertes graphiques permettant de modifier la mise en forme d'un champ lorsque sa valeur répond à certaines conditions (mise en évidence des valeurs critiques sur les informations finales de la vue)  - Open url.png voir Exemple ;
  • peut être rattachée :
    • soit à une option de menu (ex. : vue Matériels par localisation disponible sur l'inventaire des matériels) : dans ce cas, elle fonctionne de façon autonome et est une fonctionnalité à part entière de Service Manager ;
    • soit à un reporting, afin d'en délimiter son périmètre (ex. : vue définie pour le reporting Nb d'incidents en retard cette semaine) : dans ce cas, elle ne fonctionne qu'au travers de cet objet et en fait partie intégrante. 
  • peut utiliser le service Google Maps de géolocalisation, afin de positionner des marqueurs Google map icon.png sur une carte à partir du libellé, adresse, ville, pays des localisations.

Exemples

1. La vue Matériels rattachée à l'option de menu Inventaire des matériels est définie avec les critères suivants :

  • 2 niveaux de rupture : Modèle > Localisation (dernier niveau)
  • 3 informations finales à afficher : Catégorie ; Matériel ; Statut

    Comment s'effectue la navigation ?

  • Sélection de la vue ==> affichage du 1er niveau de rupture = tous les modèles
             View - Final presentation - drilldown level 1.png
  • Sélection d'un modèle ==> affichage du 2ème niveau de rupture = toutes les localisations dans lesquelles le modèle est disponible
             View - Final presentation - drilldown level 2.png
  • Sélection d'une localisation de dernier niveau ==> affichage des informations finales sous forme d'une grille = tous les matériels rattachés au modèle disponible dans la localisation
     

    Représentation finale de la vue
         View - Final presentation without visual alerts.png


2. Des alertes graphiques sont définies sur le champ Statut :

  • Alerte pour le statut En panne :
         condition = En panne  ;  police = Arial  ;  style = Bold  ;  couleur du fond = rouge
  • Alerte pour le statut En stock :
         condition = En stock  ;  police = Arial  ;  style = Normal  ;  couleur du fond = vert

    Représentation finale de la vue : des pastilles de couleur sont affichées devant chaque statut répondant aux conditions
         View - Final presentation with visual alerts.png

Remarques

  • Ne confondez pas les vues décrites dans cette page et les vues SQL utilisées comme des tables au niveau des requêtes parents pour ajouter des champs.
  • Seul un profil ayant les droits d'édition des vues pour le module auquel est rattachée l'option de menu utilisant la vue peut modifier celle-ci.
  • Sur les vues autonomes (rattachées à une option de menu), les droits d'accès sont définis par profil
  • Vous pouvez ajouter manuellement d'autres champs à la requête parent de la vue, sous réserve de disposer des droits d'édition des affichages pour le module auquel est rattachée l'option de menu utilisant la vue.
    • Effectuez cette opération avant d'éditer la vue.
    • Les champs ajoutés manuellement sont affichés sous leur nom d'alias ; si celui-ci n'est pas renseigné, ils sont affichés sous leur nom physique.

      exemple  Alias : Téléphone ; Nom physique : PHONE_NUMBER

  • Sur chaque option de menu, une vue Liste est prédéfinie, permettant de visualiser la totalité des enregistrements sans rupture.
  • Un mode d'affichage par défaut est défini pour la vue.
    • Les vues avec ruptures peuvent également être affichées sous forme de graphiques via les icônes situées à droite de la liste déroulante Vue : Sector mode icon.png Secteurs, Histogram mode icon.png Histogramme, Geographical mode icon.png Carte géographique, Google map icon.png Géolocalisation Google Maps.
    • List mode icon.png permet d'afficher directement le mode Liste en passant les éventuels niveaux intermédiaires. 
  • Dans le cas des champs de type Arborescence (Localisation, Entité, Catégorie, Imputation analytique), seuls ceux de type Dernier niveau peuvent être définis comme niveau de rupture.
  • La mise en forme définie au travers des alertes graphiques n'est pas visible sur les impressions effectuées via Print icon.png.
  • Géolocalisation Google Maps via des marqueurs Google map icon.png positionnés sur une carte :
    • Elle utilise une API Google Maps nécessitant de disposer d'une clé d'API -  Open url.png  voir Procédure
    • Pour minimiser les allers-retours entre le poste client et les serveurs Google Maps, les informations de géo-décodage sont stockées dans la base une fois obtenues. Elles ne sont redemandées qu’en cas de changement d’adresse.

Bonnes pratiques

  • Pour qu'un regroupement ait un sens, sélectionnez comme niveaux de rupture des champs susceptibles de fédérer plus d'une valeur.

    exemple  Utiliser le code matériel comme rupture sur une liste d'équipements a peu de sens puisqu'il s'agit d'un code unique

  • Nom de la vue :
    • Donnez un nom "parlant" permettant de repérer facilement la hiérarchie des niveaux de rupture.
    • Demandez la génération automatique du nom après avoir défini les niveaux de rupture.
    • Lorsque vous modifiez les niveaux, modifiez le nom de la vue ou régénérez-le de façon automatique.
  • Alertes graphiques :
    • Utilisez les polices les plus courantes (Arial, Courrier, Verdana, Times) du fait de la grande disparité d’affichage des navigateurs Internet.
    • Dans les conditions, saisissez les valeurs exactes des champs, en respectant la casse et les accents.
    • Dans les conditions, si la valeur contient un tiret, encadrez-la d'apostrophes.

      exemple  Condition sur la priorité : '1 - Haute'

    • Dans un contexte multilingue, définissez autant d'alertes qu'il y a de valeurs possibles pour le champ selon la langue utilisée.

      exemple  Champ Statut : définition des valeurs Out of order (EN) et En panne (FR) au sein d'une même alerte

Spécificités des versions 2016 et antérieures

La fiche Vue des versions 2016 et antérieures présente certaines différences :

  • Accès
  • Interface graphique :
    • Écrans de la fiche Vue
    • Les alertes graphiques peuvent être définies en appliquant une couleur de fond et une couleur de texte sur les valeurs des champs.

Accès

Sur tous les écrans en mode Liste, option Éditer la vue Edit icon.png dans la liste Vue située dans le bandeau supérieur

Description de l'écran

         View.png

Barre d'outils

Add icon.png : Crée une nouvelle vue.

Save icon.png : Sauvegarde la vue.

Duplicate icon.png : Duplique la vue et la sauvegarde sous un autre nom. Toute la présentation de la vue est dupliquée.

Trash icon.png : Supprime la vue.

Nom de la vue : Libellé identifiant la vue. 

  • View - Multilingual labels icon.png : saisie manuelle des libellés multilingues du nom de la vue.
  • Sheet full icon.png : génération automatique du nom d'après la hiérarchie des niveaux de rupture. Règles de nommage appliquées :
    • vue sans rupture ==> Liste
    • vue avec un seul niveau de rupture ==> nom de la rupture
    • vue avec plusieurs niveaux de rupture ==> concaténation des noms de rupture séparés par des virgules (ex. : Marque, Modèle)

Vue par défaut : Indique si la la vue est celle proposée par défaut lorsqu'une option de menu est sélectionnée (case cochée) ou non (case non cochée)
    exemple  Vue Localisation pour l'option de menu Inventaire des matériels

Modes d'affichage (Note : Uniquement pour une vue avec ruptures) : Liste de tous les modes d’affichage des données définis pour l'option de menu. Le mode affiché est celui appliqué par défaut lorsque la vue est sélectionnée : secteurs, histogrammes, ...

Password close icon.png : Définit les droits de visualisation de la vue par profil.

Vues existantes : Liste de toutes les vues définies pour l'option de menu. Pour afficher l'une d'entre elles, sélectionnez-la dans la liste déroulante et cliquez sur Select ok icon.png.

Champs disponibles

Liste des champs issus de la requête parent associée à la vue, et des éventuels champs supplémentaires ajoutés manuellement.

Bloc Prévisualisation

Drilldown (Note : Accessible uniquement après avoir positionné un champ dans le bloc Mode Liste) : Liste des champs définissant la hiérarchie des niveaux de rupture.

  • Le champ en haut de liste définit le niveau le plus haut ; le champ en bas de liste définit le dernier niveau.
  • Pour ajouter un niveau : cliquez-glissez le champ de la liste Champs disponibles vers le bloc Drilldown.
    • Le nombre de niveaux n'est pas limité.
    • Si aucun niveau n'est défini, la vue est de type Liste.
    • Pour les champs arborescents, seuls ceux de type Dernier niveau peuvent être définis comme niveau de rupture.
  • Pour ordonner les niveaux : cliquez-glissez les champs à l'intérieur du bloc Drilldown.
  • Pour supprimer un niveau : cliquez-glissez le champ du bloc Drilldown vers la liste Champs disponibles.
     

Mode Liste : Liste des champs identifiant les colonnes de la représentation finale de la vue.

  • Pour ajouter une colonne : cliquez-glissez le champ de la liste Champs disponibles vers le bloc Mode Liste.
  • Pour ordonner les colonnes : cliquez-glissez les champs à l'intérieur du bloc Mode Liste.
  • Pour supprimer une colonne : cliquez-glissez le champ du bloc Mode Liste vers la liste Champs disponibles.
     

Configuration d'un champ

Permet de définir des conditions particulières d'affichage des champs sur la représentation finale de la vue.
         View - alert.png

Accès : Clic sur Tools icon.png en regard du champ

Regroupement (Note : Uniquement pour un champ de type Date) : Permet de définir le mode de regroupement des enregistrements.

exemple  Pour visualiser rapidement tous les matériels arrivant à échéance en 2020 :

  • champ Date de fin de garantie = 01/09/2020
  • regroupement Par année = 2020

Début du chemin / Fin du chemin (Note : Uniquement pour un champ de type Arborescence qui n'est pas de dernier niveau) : Permet de sélectionner les niveaux à afficher.

  • La valeur 0 proposée par défaut permet l’affichage de tous les niveaux de l’arborescence.

exemple  Affichage du champ arborescent Localisation = Amérique du nord/USA/New-York/Manhattan/Broadway

  • début = 0, fin = 0 ==> Amérique du nord/USA/New-York/Manhattan/Broadway
  • début = 1, fin = 3 ==> USA/New-York/Manhattan
  • début = 4, fin = 5 ==> Manhattan/Broadway
  • valeur Localisation (dernier niveau) = Broadway

Alerte graphique : Permet de définir une mise en forme particulière lorsque la valeur d'un champ répond à certaines conditions  - Open url.png voir Exemple

  • Condition : Expression interprétée lors de l'exécution de la vue, permettant d'évaluer si l'alerte doit être appliquée au champ.
    Une condition se décompose en :
    • un opérateur : =, <, <=, >, >=, <>
    • une expression texte correspondant à l'une des valeurs du champ à tester et/ou à une variable d'environnement :
      • variables disponibles : today ==> Aujourd'hui ; now ==> Maintenant (date/heure courante)
      • les variables peuvent être combinées avec des valeurs et des opérateurs
      • les valeurs à tester doivent être encadrées d'apostrophes

exemple

  • champ Statut : condition ='En panne'
  • champ Priorité : condition >='3'
  • champ Urgence : condition '1 - Haute'
  • champ Incident - Enregistré le : condition today ==> rechercher les incidents créés aujourd'hui
  • champ Matériel - Date d'installation : condition today-20 ==> rechercher les matériels installés 20 jours avant aujourd'hui
  • champ Action - Début prévu le : condition >now ==> rechercher les actions planifiées après maintenant 
  • Couleur de fond : Couleur de la pastille positionnée devant la valeur du champ (par défaut : Blanc), sélectionnée à partir d'une palette de couleurs ou du code hexadécimal.
  • Police : Police de caractères (Arial, Times, ...) appliquée à la valeur du champ (par défaut : police du navigateur Internet).
    • Toutes les polices gérées par le navigateur sont disponibles.
    • Vous pouvez cumuler le nom et la taille de la police, en les séparant par une virgule.
               exemple  Arial, 10
  • Style : Style de la police de caractères appliqué à la valeur du champ (par défaut : Normal). Cliquez sur les styles souhaités.
  • Aperçu : Aperçu de la mise en forme du champ sur la représentation finale de la vue lorsque la condition est vérifiée.
  • Delete icon.png : Permet de supprimer une ligne de l'alerte.

Procédures

Comment créer une vue

Étape 1 (optionnelle) : Ajout des champs manquants dans la requête parent

Note : Vous devez être attaché à un profil ayant les droits de modification des vues.

1. Allez sur l'écran pour lequel vous voulez créer une vue, en mode Liste.

2. Cliquez sur Tools icon.png dans le bandeau supérieur et sélectionnez l'option Éditer.
La liste des champs de la fiche est affichée.

3. Ajoutez les champs souhaités  - Open url.png voir Procédure Comment modifier une requête parent.

4. Cliquez sur Enregistrer.
Vous revenez sur l'écran en mode Liste.

Étape 2 : Création d'une nouvelle vue

1. Allez sur l'écran en mode Liste.

2. Sélectionnez l'option Éditer la vue Edit icon.png dans la liste déroulante Vue dans le bandeau supérieur.
La fenêtre de configuration des vues est ouverte.

3. Sélectionnez la méthode de création de votre nouvelle vue.

  • Soit utilisez une vue existante :
    • sélectionnez le modèle dans la liste Vues existantes.
    • cliquez sur Select ok icon.png.
      La configuration de la vue est affichée.
  • Soit créez une nouvelle vue :
    • cliquez sur Add icon.png.
      • La liste des champs issus de la requête parent associée à la vue, et des éventuels champs supplémentaires ajoutés manuellement, est affichée dans le bloc Champs disponibles.
      • Le bloc Prévisualisation est réinitialisé.
       

Étape 3 : Définition des caractéristiques de la vue

Informations finale de la vue

1. Cliquez-glissez tous les champs identifiant les informations finales, de la liste Champs disponibles vers le bloc Prévisualisation > Mode Liste.

2. Ordonnez les colonnes via un cliquer-glisser des champs dans le bloc Prévisualisation > Mode Liste
 

Niveaux de rupture
    Note : Vous devez avoir positionné un premier champ dans le bloc Prévisualisation > Mode Liste.

1. Cliquez-glissez tous les champs identifiant les niveaux, de la liste Champs disponibles vers le bloc Prévisualisation > Drilldown.

2. Ordonnez les niveaux via un cliquer-glisser des champs dans le bloc Prévisualisation > Drilldown.
 

Mise en forme des champs sur la représentation finale de la vue

1. Cliquez sur Tools icon.png en regard du champ dans le bloc Prévisualisation.
La fenêtre de configuration des alertes graphiques est affichée.

2. Renseignez les informations à afficher en fonction du type de champ :

  • Regroupement sur un champ Date : sélectionnez le mode de regroupement souhaité.
  • Début du chemin / Fin du chemin sur un champ de type Arborescence : indiquez le premier niveau et le dernier niveau.

3. Définissez la mise en forme graphique des champs.

  • Cliquez sur Ajouter une condition.
  • Renseignez les attributs de mise en forme à appliquer lorsque la condition est vérifiée pour le champ.
    La zone Aperçu Preview area.png affiche la mise en forme.
  • Répétez les opérations pour chaque champ à mettre en valeur.
  • Pour supprimer une ligne, cliquez sur Delete icon.png.
  • Cliquez sur Enregistrer.
     

Étape 4 : Sélection des profils devant avoir accès à la vue

Note : Par défaut, tous les profils ont accès à la nouvelle vue.

1. Cliquez sur Password close icon.png dans la barre d'outils.

2. Cliquez-glissez les profils non autorisés de la liste Visible vers la liste Invisible.

3. Cliquez sur Enregistrer.

Étape 5 : Sauvegarde de la vue

1. Saisissez le nom de la vue dans la zone Name area.png.

Best Practice icon.png  Nommez la vue selon la hiérarchie des niveaux de rupture (champs disponibles dans le bloc Prévisualisation > Drilldown) en cliquant sur Generate name icon.png.

2. Renseignez les libellés multilingues via View - Multilingual labels icon.png.

3. Sauvegardez la vue suivant la méthode de création de votre nouvelle vue.

Vous avez créé la vue à partir d'un modèle

  • Cliquez sur Duplicate icon.png pour ne pas écraser le modèle.

Vous avez créé une nouvelle vue

  • Cliquez sur Save icon.png.

4. Cliquez sur Fermer la fenêtre.
Vous revenez sur l'écran en mode Liste.

Étape 6 : Test du bon fonctionnement de la vue

1. Sélectionnez la nouvelle vue dans la liste déroulante Vue.

2. Testez la navigation à travers la hiérarchie de ruptures.

3. Vérifiez l'affichage des résultats et les mises en forme graphiques des champs sur la représentation finale de la vue.

La géolocalisation via Google Maps

Dans une vue par localisation affichée sur une carte, l'icône Google map icon.png permet de géolocaliser chaque site automatiquement via le libellé de la localisation, l'adresse, la ville et le pays. Ces informations sont géolocalisées via une API Google Maps nécessitant de disposer d'une clé d'API.

         Google Maps Geocoding API - Schema.png

Notes

  • Toute version de Service Manager postérieure au fix 2015.201 utilise une clé API v3 de Google Maps. Pour les versions antérieures, recherchez une clé API v2 de Google Maps.
  • Le service de Google Maps permet uniquement le géocodage d'adresses statiques (i.e. connues à l'avance).
  • Veillez à ne pas divulguer votre clé d'API Google Maps : c'est en effet à partir de son utilisation que sont déclenchées et décomptées le nombre de requêtes de géolocalisation autorisées sur votre compte.
  • Limitation pour les utilisateurs de l'API Google Maps standard : 2 500 requêtes gratuites par jour ; 10 requêtes par seconde. Au-delà, vous devez activer la facturation à l'utilisation pour déverrouiller les quotas -  Open url.png   voir Limites d'utilisation de Google Maps Geocoding API 
  • À tout moment, vous pouvez vérifier si vous avez atteint votre quota de requêtes journalier -  Open url.png  voir Procédure
  • Si vous utilisez un proxy pour appeler le service Google Maps de géolocalisation, vous devez renseigner le paramètre divers {ADMIN} Port du proxy pour Google Maps.

Comment obtenir une clé d'API Google Maps

Étape 1 : Enregistrement de l'application Service Manager dans la console des API Google

1. Allez sur la page Google Maps Geocoding API.

2. Cliquez sur Obtenir une clé.

3. Connectez-vous à votre compte Google permettant d'accéder à la console des API Google.

4. Sélectionnez le mode de création du projet.

  • Vous utilisez déjà des API Google : sélectionnez le projet depuis lequel vous gérez vos applications dans la console.
  • Vous n'utilisez pas d'API Google : sélectionnez l'option Créer un projet

5. Cliquez sur Continuer.

  • Un message indique la création du projet.
  • Une nouvelle page Identifiants est ouverte.

Étape 2 : Génération de la clé d'API

1. Donnez un nom à la clé d'API propre à votre serveur.

2. Cliquez sur Créer.
La clé est générée et est affichée.
         Google Maps Geocoding API - Get a key (1).png

3. Copiez la clé via Google Maps Geocoding API - Copy icon.png et cliquez sur OK.
La page Identifiants est réactualisée.

Étape 3 : Ajout de la clé d'API Google Maps dans le fichier de configuration du serveur Apache

1. Ouvrez le fichier /Config/smo_config.php sur le serveur Apache.

2. Modifiez la ligne ci-dessous en remplaçant la valeur en jaune.

  • <Your GoogleMaps key value> : la nouvelle clé d'API copiée précédemment
    Attention : N'omettez pas les caractères ' '.

define ('GOOGLE_MAPS_KEY', '<Your GoogleMaps key value>');

     exemple

define ('GOOGLE_MAPS_KEY', 'AIzaCyDq6C6oa93gvZHKNbABAf4dyIjfdjz4h7WL');

Étape 4 : Test du bon fonctionnement de la clé d'API Google Maps

1. Exécutez l'URL ci-dessous en remplaçant les valeurs en jaune.

  • <Your GoogleMaps key value> : la nouvelle clé d'API copiée précédemment
  • <Location to geolocate> : la localisation à tester
     

https://maps.googleapis.com/maps/api/geocode/json?sensor=false&address=<Location to geolocate>&key=<Your GoogleMaps key value>

     exemple  Tester le bon fonctionnement pour la localisation Boston

https://maps.googleapis.com/maps/api/geocode/json?sensor=false&address=Boston&key=AIzaCyDq6C6oa93gvZHKNbABAf4dyIjfdjz4h7WL

2. Vérifiez que le statut retourné par la requête de géocodage, indiqué à la fin de la page, est OK.
         Google Maps Geocoding API - Status OK.png

    Liste des statuts possibles :

  • OK : aucune erreur n'est survenue, l'adresse a été analysée et au moins un géocode a été trouvé.
  • ZERO_RESULTS : le géocode a réussi mais n'a renvoyé aucun résultat. Cela peut se produire si le géocodeur a reçu un paramètre address inexistant.
  • OVER_QUERY_LIMIT : vous avez dépassé votre quota.
  • REQUEST_DENIED : votre requête a été rejetée.
  • INVALID_REQUEST : il manque un élément dans la requête.
  • UNKNOWN_ERROR : la requête n'a pas pu être traitée en raison d'une erreur de serveur. Si vous essayez à nouveau, la requête pourrait aboutir.

Comment vérifier les quotas

1. Ouvrez la console des API Google.

2. Connectez-vous à votre compte Google permettant d'accéder à la console des API Google.

3. Cliquez sur Open menu icon.png  (1).

4. Sélectionnez l'option IAM et Administration puis l'option Quotas  (2).
Le nombre de requêtes autorisées est affichée en regard de la ligne du service Google Maps Geocoding API  (3).
         Google Maps Geocoding API - Quotas.png

5. Cliquez sur Edit icon.png en regard de la ligne du service.
Le nombre de requêtes exécutées dans la journée est affiché.
         Google Maps Geocoding API - Quotas - Update.png

Tags:
Modifié par Utilisateur inconnu le 2020/04/02 18:46
Créé par Administrator XWiki le 2013/03/25 18:18

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help
•  Service Bots

Glossaire

Powered by XWiki ©, EasyVista 2020