Aller au contenu principal

Données et interactions

Les widgets basés sur les données utilisent une Source de données enregistrée dans la Vue Utilisateur. Une source peut être réutilisée par plusieurs widgets de la même vue.

Types de sources​

Environnement​

Utilise une connexion préconfigurée et rendue disponible par l’administrateur. C’est le choix recommandé lorsque la même connexion doit être gérée de manière centralisée.

Manuel​

Permet d’enregistrer une connexion protégée directement dans la vue, lorsque cette possibilité est activée par l’administrateur.

L’écran permet de sauvegarder, vérifier, révoquer ou supprimer la connexion. Les valeurs sensibles ne sont pas affichées après sauvegarde. Pour Oracle, il faut indiquer si le nom de la base de données représente un SID ou un Service name.

Modèle Sémantique​

Utilise des champs et des mesures d’un Modèle Sémantique publié et accessible. Il est possible de :

  • suivre automatiquement la dernière version publiée ;
  • conserver la version actuelle ;
  • sélectionner des dimensions, des colonnes et des mesures via des cases à cocher ;
  • personnaliser l’alias de chaque champ, initialement égal au nom du champ ;
  • consulter les différences lorsque le modèle publie une nouvelle version.

Créer une source relationnelle​

  1. Sélectionner Données et ensuite Sources de données privées.
  2. Entrer un nom reconnaissable.
  3. Choisir le type de connexion.
  4. Sélectionner une connexion autorisée.
  5. Utiliser Test connexion.
  6. Charger le catalogue disponible ; l’indicateur animé confirme que la lecture est en cours.
  7. Configurer la requête.
  8. Sauvegarder et utiliser Prévisualisation des données. La prévisualisation peut être fermée avec la commande correspondante et est fermée automatiquement en passant à une autre source.
  9. Associer la source au widget sélectionné.

Le catalogue affiche tous les schémas contenant des tables ou des vues lisibles, jusqu’à 500 objets par schéma.

Si le chargement dépasse le temps maximum du serveur, l’Éditeur affiche un message explicite : réessayer et, si le problème persiste, contacter l’administrateur en indiquant l’heure du tentative.

Avec une connexion SAP HANA, le catalogue affiche les tables, les vues et les colonnes visibles par l’utilisateur configuré dans la connexion. Les objets sélectionnés peuvent être utilisés dans le Query Builder et la Prévisualisation des données. Si un objet attendu ne compare pas, vérifier avec l’administrateur les permissions attribuées sur la base de données.

Query Builder​

Le Query Builder permet de configurer une lecture sans écrire SQL. Les éléments suivants sont disponibles :

  • schéma et table de départ ;
  • dimensions et colonnes ;
  • mesures et agrégations ;
  • alias ;
  • jointures ;
  • conditions organisées en groupes AND/OR ;
  • tris ;
  • limite facultative des lignes.

Vérifier la Prévisualisation après chaque modification pertinente, surtout lorsque des jointures ou des conditions imbriquées sont présentes.

SQL personnalisé​

Le mode SQL personnalisé accepte uniquement des interrogations de lecture. Utiliser des paramètres déclarés au lieu de concaténer des valeurs insérées par les utilisateurs.

En passant du Query Builder à SQL personnalisé, Sybot génère la syntaxe conforme à la connexion sélectionnée. Pour SAP HANA, les identificateurs sont délimités avec des guillemets doubles ; une requête modifiée manuellement reste sous le contrôle de l’utilisateur.

L’éditeur permet de :

  • formater l’interrogation ;
  • déclarer des paramètres et des valeurs initiales ;
  • utiliser les paramètres dans les filtres de la vue ;
  • vérifier le résultat dans la Prévisualisation.

Les interrogations non autorisées sont rejetées avec un message ; ne pas tenter d’éviter les contrôles.

Associer les données aux widgets​

Dans le panneau Données et visualisation du widget :

  1. sélectionner la source ;
  2. choisir dimension, catégorie ou hiérarchie ; les listes déroulantes affichent nome_entità.nome_campo par ordre alphabétique ;
  3. sélectionner les mesures à afficher ;
  4. configurer l’agrégation et le format ;
  5. contrôler le résultat dans la Prévisualisation.

Les paramètres d’un widget individuel ne modifient pas la définition de la source partagée.

Voici la traduction en français du document d'utilisation de Sybot 2.0 :

Quand les données sont en cours de chargement, chaque widget affiche au centre un indicateur animé au-dessus de l'inscription Chargement…. L'indicateur reste visible jusqu'à la fin de la requête ; avec des sources LIVE, l'attente dépend également des temps de réponse du système interrogé.

Trier un graphique​

Pour chaque graphique, il est possible de choisir dans l'Éditeur un tri par défaut croissant ou décroissant sur la catégorie ou sur l'une des mesures affichées. C'est cet ordre initial utilisé en Prévisualisation et dans la vue publiée ; lorsque le graphique utilise une hiérarchie, le tri sur la catégorie suit le niveau affiché.

Pendant la consultation, ouvrir le menu des trois points ou le menu contextuel du graphique et choisir Tri. Il est possible d'appliquer temporairement un ordre différent ou de sélectionner Pré-défini de la vue. Le choix temporaire ne modifie pas la Vue Utilisateur et est perdu en rechargant la page.

Sur les graphiques en secteurs et baguettes, les couleurs configurées sont associées à la valeur de la catégorie. Changer le tri modifie la disposition des catégories, mais pas leur couleur : la correspondance visuelle reste donc stable.

Couleurs et images des catégories​

Les graphiques utilisent une palette standard étendue, modifiable depuis le panneau Propriétés. Sur les graphiques en secteurs, baguettes et barres, il est possible de remplacer la couleur d'une catégorie par une image choisie du Catalogue d'images de la vue.

Image et couleur sont alternatifs :

  • en sélectionnant une image, la couleur et la commande fx correspondante de la même catégorie sont désactivées ;
  • pendant le chargement de l'asset, aucune couleur provisoire n'est affichée ;
  • en supprimant l’image, la configuration de la couleur est à nouveau disponible ;
  • pour chaque image, il est possible de choisir Remplir, Contenir ou Répéter.

Vérifier en Prévisualisation que le recadrage et la lisibilité de l'image sont adaptés à la taille et à la forme des éléments du graphique.

Filtres​

Des filtres sont disponibles pour :

  • catégorie ;
  • valeur libre ;
  • intervalle de dates ;
  • intervalle numérique.

Chaque filtre peut être associé à un ou plusieurs widgets cibles. Les widgets Filtres actifs et Réinitialiser les filtres rendent visibles et annulables les sélections de l'utilisateur.

Lorsque Filtre catégories utilise une source dérivée d'un Modèle Sémantique, le filtre est appliqué comme champ du modèle : Sybot utilise alors les relations définies dans le modèle pour atteindre les widgets cibles alimentés par le même modèle, même si les sources respectives sélectionnent des champs différents.

Dans le panneau Propriétés, Sélection catégories permet de choisir entre :

  • Simple, pour appliquer une valeur à la fois ;
  • Multiple, pour ouvrir une liste déroulante avec des cases à cocher et appliquer ensemble jusqu'à cent valeurs.

Le résumé de la liste indique combien de valeurs sont sélectionnées. Le widget Filtres actifs les affiche dans le même filtre et Réinitialiser les filtres les supprime en une seule opération. La liste ne se filtre pas automatiquement : après la première sélection, les autres catégories compatibles restent disponibles pour ajouter d'autres cases à cocher.

Le panneau Filtres avancés, lorsqu'il est activé dans les propriétés de la vue, collecte les champs filtrables de la page même sans widget dédié.

Interactions entre widgets​

Graphiques et tableaux peuvent envoyer une sélection à d'autres widgets.

Exemples :

  • sélectionner une barre pour filtrer une table ;
  • choisir une ligne pour afficher son détail dans un tiroir ;
  • utiliser une hiérarchie pour passer d'une catégorie générale à un niveau plus spécifique ;
  • afficher ou masquer un groupe de widgets via Visibilité widget.

La sélection est un contexte de l'interface et ne remplace pas les contrôles d'autorisation effectués par Sybot.

Dans la Tableau de données, la sélection simple se fait en cliquant directement sur la ligne et ne montre pas de cases radio. La sélection multiple conserve les cases à cocher, utiles pour vérifier les lignes qui participent à une action massive.

Cartes​

La Carte points cluster utilise des coordonnées géographiques et regroupe automatiquement les points lors du zoom et du redimensionnement.

La Carte coropletica colorie des zones en fonction d'une valeur agrégée. Des périmètres géographiques prédéfinis sont disponibles ; une carte personnalisée compatible peut être utilisée pour des besoins spécifiques. Les presets reconnaissent les codes géographiques et les noms, tant italiens qu'anglais. Les seuils peuvent être configurés via limite, étiquette et sélecteur de couleur ; seul le dernier peut être sans limite supérieure.

Vérifiez toujours en Prévisualisation que les clés géographiques, les coordonnées et les seuils correspondent aux données disponibles.

Workflow Widget​

Les widgets Workflow permettent, en fonction des permissions :

  • de lancer un Workflow ;
  • de passer des paramètres statiques ou des valeurs du record sélectionné ;
  • d'exécuter une action sur un ou plusieurs enregistrements ;
  • d'afficher l'état, l'avancement et le journal ;
  • d'interrompre une exécution active ;
  • de mettre à jour d'autres widgets après la fin.

Pour les widgets qui lancent un Workflow, l'Éditeur charge les paramètres configurés dans le Workflow, sauf ceux de type fichier. Il est possible de :

  • définir une valeur par défaut directement dans les propriétés du widget ;
  • activer fx pour calculer la valeur par défaut à partir des filtres et contextes disponibles ;
  • choisir d'afficher le panneau paramètres avant le lancement et en Prévisualisation ;
  • laisser le panneau désactivé pour utiliser directement la valeur par défaut et le mapping configurés.

Lorsque cela est activé, le panneau apparaît comme un surimpression compacte : l'utilisateur peut contrôler et modifier les valeurs modifiables en un seul passage. En Prévisualisation, le panneau affiche le résultat de la configuration, mais ne lance pas le Workflow. Les valeurs protégées ne sont pas stockées dans la Vue ; les laisser vides maintient la valeur par défaut protégée du Workflow.

Avant de publier :

  1. sélectionner le Workflow autorisé ;
  2. configurer la valeur par défaut, les formules ou le mapping des paramètres ;
  3. ajouter un texte de confirmation pour les actions pertinentes ;
  4. vérifier dans la Prévisualisation le panneau paramètres ;
  5. tester le lancement, l'erreur et l'arrêt à partir de la version publiée ;
  6. vérifier le comportement avec un utilisateur non propriétaire.

Diagnostic​

Lorsqu'une source échoue, la vue affiche un message sécurisé et, si disponible, une référence à communiquer à l'administrateur.

Vérifiez :

  • que la source est toujours active ;
  • que le Modèle Sémantique est publié ;
  • que les paramètres requis ont une valeur ;
  • que l'utilisateur dispose des projets et des rôles nécessaires ;
  • que la structure des données n'a pas été modifiée.