Widget Discussion


Apps - Widget - Discussion icon.png  Ce type de widget appartient à la catégorie EasyVista de la bibliothèque des widgets. S'appuyant sur un datasource EasyVista Discussions, il permet d'implémenter une zone de discussion liée à Product name - ev itsm.png.

  • Le fonctionnement des discussions est identique à celui d'Product name - ev itsm.png -  Open url.png voir Description
  • La discussion peut être liée à un objet précis d'Product name - ev itsm.png (ex. : un incident, un problème).

Remarques

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

  • Caractéristiques des listes de discussions :
    • Lorsqu'une réponse est apportée à une discussion, celle-ci remonte automatiquement en tête de liste.
    • Les discussions sont triées par ordre chronologique décroissant.
    • Une séparation est affichée entre les discussions non lues et les discussions lues. Une discussion est considérée comme lue dès qu'elle est affichée.
    • Les 10 discussions les plus récentes sont affichées par défaut ; les 10 discussions suivantes peuvent être affichées par le bouton [ AFFICHER PLUS ] en bas de la liste des discussions.
    • Chaque discussion est identifiée par une icône spécifique à sa catégorie.
               Example documentation icon FR.png  Discussion - Question icon.png pour une discussion de type Question
    • La photo affichée en regard de chaque discussion / réponse est celle téléchargée via les informations personnelles de l'utilisateur connecté. Si elle n'est pas renseignée :
      • la photo est celle renseignée dans Product name - ev itsm.png ;
      • s'il s'agit d'un utilisateur inexistant dans Product name - ev itsm.png, aucune photo n'est affichée.
  • Une synchronisation automatique (en temps réel ou suivant la fréquence de rafraîchissement automatique du datasource) est effectuée entre les discussions créées/modifiées dans Product name - ev itsm.png et dans Product name - ev sas.png.
    • Le widget Discussion peut être lié à une liste d'objets Product name - ev itsm.png via un widget Data Viewer. Dans ce cas, la section Master/Detail du datasource EasyVista Discussions permet d'afficher uniquement les discussions de l'objet courant -  voir Procédure
          Example documentation icon FR.png  Afficher uniquement les discussions relatives au problème P170730_00004
    • Le widget peut afficher toutes les discussions ou uniquement celles que l'utilisateur connecté peut voir (discussions de son domaine ou d'un niveau supérieur, discussions de l'un de ses groupes, discussions sur lesquelles il est nommément invité, discussions dont il est l'auteur), via un filtre sur le datasource EasyVista Discussions.
  • Le profil de modérateur (accès au menu Administration > Gérer mes discussions donnant les droits pour gérer ses propres discussions) ne peut s'appliquer qu'aux utilisateurs connectés qui sont définis dans Product name - ev itsm.png.

Exemple

Implémentation d'un widget Discussion Description
Apps - Widget Discussion - List.png
  • (1) : Zone dédiée à la recherche (saisie de mots clés)
  • (2) : Zone dédiée à la création d'une nouvelle discussion
  • (3) : Fil de discussion - l'auteur de la discussion apparaît sur la partie gauche
  • (4) : Séparation entre les discussions non lues (partie haute) et les discussions lues (partie basse)
  • (5) : Discussion lue et fermée, affichée sur un fond gris
  • (6) : Discussion lue et ouverte, affichée sur un fond blanc
  • Discussion - Wizards list icon.png : ouvre la liste des assistants
  • Discussion - Question icon.png : icône renseignant sur le type de discussion
  • Apps - Delete 2 icon.png : supprime la réponse
  • liens hypertextes Reply, Update, Follow, Unfollow : permettent de répondre à une discussion, de modifier une réponse, de suivre une discussion ou de se désabonner

Best Practice big icon.pngBonnes pratiques

  • Lorsque le nombre de discussions est important, ne renseignez pas la propriété Widget Height de la section Theme. Ceci permet d'utiliser l'ascenseur vertical de la fenêtre du navigateur et non celui du widget.
  • Vous pouvez modifier l'apparence graphique (police, taille des caractères, alignement, couleur...) des différentes composantes du widget via la section Theme, en sélectionnant l'élément souhaité.
  • Vous pouvez afficher le nombre total de discussions / nombre de discussions non lues en utilisant des champs particuliers du datasource EasyVista Discussions.
        Example documentation icon FR.png

Liste des propriétés

Content

DataSource

DataSource : Source de données externes liée au widget. 

  • La liste déroulante affiche tous les datasources disponibles dans l'application. 
  • Pour modifier le datasource ou visualiser son contenu, cliquez sur Apps - Edit icon.png. Le bouton Apps - datasources Properties - Preview button.png sous la propriété Configure Field Types affiche le nombre de lignes (maximum 15) et de colonnes extraites.
  • Pour définir un nouveau datasource, cliquez sur Apps - Add datasource icon.png Add Data Source dans le volet Objets.

Read Only : Indique si l'utilisateur connecté peut uniquement lire les discussions (case cochée) ou également en créer ou y répondre (case non cochée).

  • En mode Lecture seule, le cadre (2) permettant la création d'une nouvelle discussion, l'icône Discussion - Wizards list icon.png d'accès à la liste des assistants et les liens hypertextes ne sont pas visibles.

Show Search Bar : Indique si la zone de recherche (1) est affichée (case cochée) ou non (case non cochée). 

  • Lorsque la zone est visible, elle est automatiquement placée en haut du widget et ne peut pas être déplacée.
  • Vous pouvez modifier l'apparence de la zone (police, taille des caractères, alignement, couleur...) via la section Theme, en sélectionnant l'élément Search Area.

Allow Follow : Indique si les liens Follow / Unfollow permettant à l'utilisateur connecté de suivre ou se désabonner d'une discussion pour être averti de tout nouvel échange la concernant sont disponibles (case cochée) ou non (case non cochée).

  • Lorsque la propriété est active, les liens sont affichés uniquement sur les discussions dont l'utilisateur n'est pas l'auteur.
SearchPlaceholder

Search Placeholder : Texte affiché dans la zone de recherche (1), qui est automatiquement effacé dès que l'utilisateur commence sa saisie.
         Search placeholder example.png

Best Practice icon.png  Utilisez ce champ comme une aide à la saisie, par exemple en indiquant les critères de recherche disponibles.

New Conversation Placeholder : Texte affiché dans la zone dédiée à la création d'une nouvelle discussion (2), qui est automatiquement effacé dès que l'utilisateur commence sa saisie.
 

Theme

   Open url.png  voir Description des propriétés

Procédures

Comment implémenter un widget Discussion

1. Définissez la source de données du widget via un datasource EasyVista Discussions.

  • Si les discussions portent sur un objet précis d'Product name - ev itsm.png, renseignez la section Master / Detail.

2. Définissez le widget Discussion :

  • dans la liste déroulante Datasource, sélectionnez le datasource EasyVista Discussions ;
  • cochez les propriétés du widget ;
  • définissez l'apparence des différentes zones du widget en sélectionnant l'élément souhaité dans la section Theme.

4. Passez en mode Exécution et testez le bon fonctionnement du widget.

  • Allez sur Product name - ev itsm.png et créez une discussion ou apportez une réponse à une discussion. Vérifiez que les mises à jour s'effectuent bien sur votre application.
  • Si le widget est accessible en mode Modification, créez une discussion via l'application et vérifiez que celle-ci apparaît dans Product name - ev itsm.png.

Comment afficher les discussions d'un objet précis ev Service ManagerProduct name - ev itsm - big.png

Product name - ev sas.png Product name - ev itsm.png

Un clic sur l'un des enregistrements affiche les discussions associées.

Apps - Widget Data Viewer example ev SAS.png

Discussion - Problems icon.png : indique le type d'objets

- un survol de l'icône affiche la référence ;

- un clic ouvre la fiche de l'objet dans Product name - ev itsm.png.

Apps - Widget Data Viewer example ev SM.png

1. Ajoutez un datasource EasyVista et sélectionnez la requête parent affichant la liste des objets souhaités.

Example documentation icon FR.png  Pour afficher la liste des problèmes d'Product name - ev itsm : Operation > Problems & Known Errors > Problems

2. Ajoutez un widget Data Viewer et faîtes-le pointer sur le datasource EasyVista créé précédemment.

3. Ajoutez un datasource EasyVista Discussions et renseignez la section Master/Detail :

  • Master Datasource : Sélectionnez le datasource EasyVista créé à l'étape 1.
  • Master Field : Sélectionnez la clé PK.
  • Detail Field : Sélectionnez la clé FK_ID_TABLE_NAME.

4. Ajoutez un widget Discussion et faîtes-le pointer sur le datasource EasyVista Discussions.

5. Passez en mode Exécution et testez le bon fonctionnement du widget Discussion en cliquant sur les enregistrements du widget Data Viewer.

Comment afficher le nombre de discussions non lues via un widget Menu

         Apps - Widget Menu - Widget Menu example.png

1. Ajoutez un widget Menu sur l'application. Note : Ne renseignez pas le champ Datasource For New Request.

2. Dans la section Data, cliquez sur [ ADD ITEM ] et ajoutez un élément de menu Nombre de discussions non lues.

3. Configurez le compteur des discussions non lues :

  • cliquez sur Apps - Edit icon.png ;
  • allez sur l'onglet Indicator et cochez la case Show Indicator ;
  • sélectionnez le datasource EasyVista Discussions sur lequel pointe le widget Discussion ;
  • cliquez sur [ # ] en regard du champ Field pour ouvrir le Data Picker puis :
    • cliquez sur le champ NB_NOT_READ ;
    • dans la liste déroulante # Row, sélectionnez la ligne (# Row) 0 (Note : Ne sélectionnez pas la valeur current record) ;
    • cliquez sur Apps - Add icon.png 
    • configurez l'indicateur, notamment sa position souhaitée par rapport au libellé ;
    • sur [ OK ].

4. Allez sur Product name - ev itsm.png, connectez-vous avec un autre utilisateur autorisé aux discussions et créez une nouvelle discussion.

5. Revenez sur Product name - ev sas.png, passez en mode Exécution et testez le bon affichage du compteur.

Comment est configuré le nombre total de discussions dans l'application modèle Service Workplace

         Apps - Widget Discussion - Service Workplace example.png

1. Allez sur la page 17.0 My Discussions et affichez le widget KPI.

2. Cliquez sur Apps - Edit icon.png en regard de l'option de menu My Discussions.

3. Allez sur l'onglet Indicator : le champ Field sélectionné à partir du data picker pointe sur le champ COUNT_COLUMN.

Tags:
Modifié par Utilisateur inconnu le 2017/10/10 13:58
Créé par Administrator XWiki le 2015/01/26 18:02

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Glossaire

Powered by XWiki ©, EasyVista 2020