Discussion Widget


Apps - Widget - Discussion icon.png  This widget belongs to the EasyVista category in the widget library. It uses an EasyVista Discussions data source to implement a discussion forum for topics related to Product name - ev itsm.png.

  • Discussions work in the same way as in Product name - ev itsm.png. Open url.png See the description.
  • Discussions can be related to a specific Product name - ev itsm.png object, e.g. an incident or a problem.

Notes

 Open url.png  See General remarks on widgets.

  • Characteristics of the list of discussions:
    • When a reply is added to a discussion, the discussion will appear at the top of the list.
    • Discussions are sorted by reverse chronological order.
    • Unread and read discussions are separated in the display. Unread discussions are considered read once they are displayed.
    • The ten most recent discussions are displayed by default. You can click [ DISPLAY MORE ] at the bottom of the list of discussions to see the next ten discussions.
    • Each discussion is identified by an icon specific to its type.
               Example documentation icon EN.png  Discussion - Question icon.png for a Question discussion.
    • The photo displayed next to the discussion or reply is downloaded from the logged-in user's personal information. If this photo was not specified:
      • Then the photo used is the one specified in Product name - ev itsm.png.
      • If the user does not exist in Product name - ev itsm.png, no photo will be displayed.
  • Discussions created or updated in Product name - ev itsm.png and in Product name - ev sas.png are automatically synchronized, either in real-time or based on the automatic refreshment interval of the data source.
    • The Discussion widget can be linked to a list of Product name - ev itsm.png objects using a Data Viewer widget. If this is the case, the Master/Detail section of the EasyVista Discussions data source will only display discussions related to the current object. See the procedure.
          Example documentation icon EN.png You want to display only discussions related to problem P170730_00004
    • The widget can display all discussions or only those the logged-in users are authorized to see via a filter applied to the EasyVista Discussions data source. These can be discussions for the user domain or higher-level domain, discussions of one of their groups, discussions to which they are invited, or discussions they author.
  • The moderator profile that authorizes you to manage your own discussions and access Administration > Manage Discussions in the menu can only be applied to logged-in users defined in Product name - ev itsm.png.

Example

Implementation of a Discussion widget Description
Apps - Widget Discussion - List.png
  • (1): Search field for entering keywords.
  • (2): Field for creating a new discussion.
  • (3): Discussion thread displaying a photo of the author on the left.
  • (4): Separation between unread discussions at the top and read discussions at the bottom.
  • (5): Read and closed discussion displayed on a gray background.
  • (6): Read and open discussion displayed on a white background.
  • Discussion - Wizards list icon.png: Used to open the list of options.
  • Discussion - Question icon.png: Icon indicating the type of discussion, e.g. event, question or information.
  • Apps - Delete 2 icon.png: Used to delete the reply.
  • Reply, Update, Follow, Unfollow links: Used to add or modify a reply and follow or unfollow a discussion.

Best Practice big icon.pngBest practice

  • If there are numerous discussions, you should not specify the Widget Height property in the Theme section. This means that the vertical scrollbar of the browser will be used instead of the widget's.
  • You can modify the graphic properties of the different widget elements, e.g. font, size, alignment, or color, using the Theme section once you have selected the relevant element.
  • You can display the total number of discussions and unread discussions using specific fields in the EasyVista Discussions data source.
        Example documentation icon EN.png

List of properties

Content

DataSource

Data Source: External data source associated with the widget. 

  • The drop-down list displays all of the data sources available in the app. 
  • To modify the current data source or to view its contents, you should click Apps - Edit icon.png. The Apps - datasources Properties - Preview button.png button below the Preview property shows the number of rows (max. 15) and columns extracted.
  • To define and associate a new data source with a widget, click Apps - Add datasource icon.png in the Objects pane.

Read Only: Used to indicate if logged-in users can only read discussions (box is checked) or if they can also create and reply to discussions (box is not checked).

  • If you select Read Only, the field (2) for creating a new discussion, the Discussion - Wizards list icon.png  icon for accessing the list of options and the links will be hidden.

Show Search Bar: Used to indicate if the search field (1) should be displayed (box is checked) or not (box is not checked). 

  • If the field is visible, it will automatically appear at the top of the widget. It cannot be moved.
  • You can modify the graphic properties of the field, e.g. font, size, alignment, or color, using the Theme section once you have selected the Search Area element.

Allow Follow: Used to indicate if the Follow / Unfollow links allowing users to follow or unfollow discussions are displayed (box is checked) or not (box is not checked). When users follow a discussion, they will receive a notification when any update is made to the discussion.

  • When the property is enabled, links will be displayed only for discussions not authored by the user.
Failed to execute the [include] macro

New Conversation Placeholder: The text displayed in the field for creating a new discussion (2) is automatically cleared once the user starts typing.
 

Theme

   Open url.png See the description of properties.

Procedures

How to implement a Discussion widget

1. Define the data source for the widget using an EasyVista Discussions data source.

  • If the discussion is related to a specific Product name - ev itsm.png object, specify the Master/Detail section.

2. Define the Discussion widget:

  • Select the EasyVista Discussions data source from the Data Source drop-down list.
  • Select the properties of the widget.
  • Define the graphic properties of the widget by selecting the required elements in the Theme section.

4. Switch to execute mode and check the workability of the widget.

  • Go to Product name - ev itsm.png and create a discussion or add a reply. Check that updates are correctly made in your app.
  • If the widget is accessible in edit mode, create a discussion via the app and check that it appears in Product name - ev itsm.png.

How to display discussions related to a specific ev Service Manager objectProduct name - ev itsm - big.png

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

Click one of the records to display the associated discussions.

Apps - Widget Data Viewer example ev SAS.png

Discussion - Problems icon.png : Used to indicate the type of object.

- Move the cursor over the icon to see its reference.

- Right-click to open the form of the object in Product name - ev itsm.png.

Apps - Widget Data Viewer example ev SM.png

1. Add an EasyVista data source and select the parent query displaying the list of objects you want.

Example documentation icon EN.png  To display the list of Product name - ev itsm problems: Operation > Problems & Known Errors > Problems

2. Add a Data Viewer widget and link it to the previously created EasyVista data source.

3. Add an EasyVista Discussions data source and specify the Master/Detail section:

  • Master Data Source: Select the EasyVista data source created in step 1.
  • Master Field: Select the PK key.
  • Detail Field: Select the FK_ID_TABLE_NAME key.

4. Add a Discussion widget and link it to the previously created EasyVista Discussions data source.

5. Switch to execute mode and check the workability of the Discussion widget by clicking records displayed in the Data Viewer widget.

How to display the number of unread discussions using a Menu widget

         Apps - Widget Menu - Widget Menu example.png

1. Add a Menu widget to the app. Note: Do not specify the Data Source For New Request field.

2. In the Data section, click [ ADD ITEM ] and add the Number of unread discussions menu item.

3. Configure the counter for unread discussions:

  • Click Apps - Edit icon.png.
  • Select the Indicator tab and tick the Show Indicator box.
  • Select the EasyVista Discussions data source linked to the Discussion widget.
  • Click [ # ] next to Field to open the Data Picker. Next:
    • Click in the NB_NOT_READ field.
    • In the # Row drop-down list, select row (# Row) 0 (Note: Do not select the current record value).
    • Click Apps - Add icon.png.
    • Configure the indicator and its position as regards the text.
    • Click [ OK ].

4. Go to Product name - ev itsm.png. Log in using a user authorized to access and create discussions.

5. Return to Product name - ev sas.png. Switch to execute mode and check that the counter is working correctly.

How to configure the total number of discussions in the Service Workplace template app

         Apps - Widget Discussion - Service Workplace example.png

1. Go to the 17.0 My Discussions page and display the KPI widget.

2. Click Apps - Edit icon.png next to the My Discussions menu option.

3. Select the Indicator tab. The Field field selected in the Data Picker will point to the COUNT_COLUMN field.

Tags:
Last modified by Unknown User on 2017/10/10 13:58
Created by Administrator XWiki on 2015/01/26 18:02

Shortcuts

Recent Updates

Haven't been here in a while? Here's what changed recently:

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

Interesting Content

How to Automate Integration
Add a Shortcut to an App
History
Quick Dashboard
Full text search - Stop Words

Powered by XWiki ©, EasyVista 2017