Datasource EasyVista

Modifié le 17/08/2022 17:48

Apps - Datasource - EasyVista icon.png  Ce type de datasource appartient à la catégorie Applications de la bibliothèque des datasources. Il permet de définir une source de données dynamique reliée à une option de menu Service Manager via une requête parent

  • Les données extraites peuvent être affinées via un filtre et agrégées via une vue définis pour l'option de menu.
  • Un datasource EasyVista possède des propriétés qui peuvent être passées en paramètres dans le lien URL de l'application, via des propriétés exposées (filtre, vue, recherche).
  • Il peut également servir de support à une relation maître-détail afin de lier 2 ensembles de données entre eux.

Remarques

   Open url.png  voir Remarques générales sur les datasources

  • Un datasource EasyVista est toujours relié à un connecteur de type EasyVista Service Manager.
  • L'utilisateur connecté a accès uniquement :
  • Il peut accéder soit aux données de son domaine courant (domaine sélectionné via la zone Informations utilisateur dans Service Manager), soit aux données du domaine Toute la société.

Exemples

  • Afficher les données Service Manager relatives au nombre de matériels en stock par localisation :
    • Requête parent liée à l'option de menu Service Manager Operation > Matériels > Inventaire des matériels
    • Filtre Matériels en stock
    • Agrégation des données à partir de la vue Matériels par localisation
               EVApps - datasource EasyVista - Datasource.png
  • Afficher (via un widget Data Viewer) uniquement les employés se prénommant Andrew, en utilisant les propriétés de recherche du datasource :
    • Requête parent liée à l'option de menu Service Manager Operation > Directory > Employees
    • Champ de recherche Search Field : Name
    • Valeur recherchée Search Value : Andrew
Sans filtrage Avec filtrage
Apps - datasource EasyVista - Search Value Example - No value.png Apps - datasource EasyVista - Search Value Example - With value.png

Liste des propriétés

Content

AliasConnector

Alias/Connector : Connecteur de type easyvista IT Service Manager utilisé par le datasource pour accéder à Service Manager.

Query : Requête parent liée à une option de menu définie dans Service Manager, à exécuter pour alimenter le datasource.

Filter : Filtre à appliquer à la requête parent, permettant de restreindre les données du datasource.

View : Vue à appliquer à la requête parent, permettant d'agréger les données du datasource.

ApplyDomains

Apply Domains : Indique si l'indicateur est calculé sur le domaine courant de l'utilisateur (case cochée - le domaine est sélectionné au niveau de Service Manager via la zone Informations utilisateur) ou sur le domaine Toute la société (case non cochée).

Force Search To Get Data : Lorsque le datasource est utilisé par un widget Data Viewer corrélé à un widget Search Filter, indique si les données du datasource sont affichées uniquement lorsqu'une recherche est effectuée et aboutit (case cochée) ou si toutes les données du datasource sont automatiquement affichées, sans avoir effectué de recherche (case non cochée).

Case cochée Case non cochée

Aucune recherche effectuée

Apps - datasource EasyVista - Force Search To Get Data on - No search.png


Une recherche effectuée

Apps - datasource EasyVista - Force Search To Get Data on - With search.png

Avec ou sans recherche

Apps - datasource EasyVista - Force Search To Get Data off.png

Preview

Configure Field Types : Ouvre l'éditeur des types de champs permettant de sélectionner les champs du datasource et de spécifier la nature de chaque champ (Date, Integer, ...) lorsqu'elle ne peut pas être déterminée automatiquement.

  • Le bouton Apps - datasources Properties - Preview button.png situé sous la propriété indique le nombre de lignes (dans la limite de 15) et de colonnes extraites. Cliquez dessus pour ouvrir l'éditeur.
  • Le bouton affiche No data available tant que les éléments obligatoires du datasource ne sont pas sélectionnés.
  • En mode Édition, seuls les 15 premiers enregistrements du datasource sont affichés.
  • En mode Exécution, la totalité des enregistrements du datasource est affichée.
  • Pour un datasource statique, les données affichées sont celles issues du dernier téléchargement de fichier.
  • Pour un datasource dynamique, les données affichées sont celles en cours au moment où vous ouvrez l'application en mode Édition.
SelectFirstRowAsCurrentRecord

Select First Row As Current Record : Indique si le premier enregistrement du datasource est sélectionné par défaut sur les widgets qui l'affichent (case cochée), ou non (case non cochée).

NoDataMessage

No Data Message : Message affiché lorsque le datasource ne contient aucune donnée.

AutoRefresh

Auto Refresh (Note : Uniquement pour un datasource dynamique) : Indique la fréquence de rafraîchissement automatique des données du datasource, en heures/minutes.

  • La réactualisation s'effectue en mode Exécution et en mode Édition, au lancement de l'application et lors d'un réaffichage de la page.

Attention : La réactualisation des données provoque une activité supplémentaire sur la plate-forme Service Apps.

Best Practice icon.png  

  • Définissez une fréquence de rafraîchissement automatique uniquement lorsque l'application doit rester affichée à l'écran durant une longue période et nécessite d'avoir en permanence les données en temps réel.

exemple  Consultation d'un tableau de bord

  • Ne renseignez pas de fréquence de rafraîchissement automatique lorsque l'application est juste utilisée à un instant t.

exemple  Affichage d'un portail avec consultation de catalogues

Search

Search Field : Liste des champs sur lesquels peut s'effectuer une recherche, afin d'accéder directement à certaines valeurs d'enregistrements du datasource.

exemple  Numéro d'incident, Nom intervenant

  • La liste des champs de recherche est fournie par EasyVista et ne peut pas être modifiée.
  • Dans les propriétés exposées, cette propriété est référencée sous le nom Search Value.

Search Value : Valeur appliquée au champ de recherche Search Field.

  • Automatiquement, tous les widgets pointant sur le datasource sont réactualisés et affichent uniquement la liste des enregistrements contenant la valeur recherchée  -  Open url.png  voir Exemple
  • Dans les propriétés exposées, il s'agit de la valeur par défaut de la propriété Search Value du datasource.

Order

Sort Order Aggregated : Lorsque le datasource contient des données agrégées (vue EasyVista avec ruptures), indique la colonne sur laquelle les données sont triées. Les données sont triées suivant l'ordre de tri sélectionné dans le champ Sort Order Aggregated Type : Ascendant / Descendant / Default qui utilise alors le tri par défaut du datasource.

Sort Order : Lorsque le datasource contient des données non agrégées (vue EasyVista sans rupture), indique la colonne sur laquelle les données sont triées. Les données sont triées suivant l'ordre de tri sélectionné dans le champ Sort Order Type : Ascendant / Descendant / Default qui utilise alors le tri par défaut du datasource.

Master/Detail

SectionMasterDetail

Master Datasource : Nom du datasource maître lié au datasource courant, dans une relation maître-détail.

Master Field : Nom de la clé principale du datasource maître, faisant la liaison avec le datasource courant.

  • Généralement, il s'agit de la colonne PK (Primary Key) de la table Service Manager.

Detail Field : Nom de la colonne du datasource courant identifiant la clé de la table Service Manager.

  • Généralement, il s'agit d'une colonne préfixée par FK (Foreign Key).

exemple  Afficher toutes les actions (datasource Détail) d'un incident (datasource Maître) :

  • Master Datasource = datasource Incidents défini via la requête parent Operation/Incidents/All Incidents
  • Master Field = PK identifiant la colonne Incident_ID de la table Incidents
  • Detail Field = FK_AM_ACTION_REQUEST_ID identifiant le numéro de l'action liée à l'incident
Tags :
Powered by XWiki © EasyVista 2024