Nuxeo Platform User Documentation

Nuxeo Poll

Updated: October 16, 2020

This add-on is deprecated since Nuxeo Platform 6.0.

The Nuxeo Poll package enables Nuxeo Platform users to create surveys and have a visual overview of the results.

To make polls visible to users without making them find them, they are displayed to users in he left column of the page, below the Worklist. This way, open polls are always displayed to the user so he can vote on it at anytime.

Creating a New Poll

Poll can be created only in spaces that have the "SuperSpace" facet. On a default Nuxeo Platform, this means workspaces, sections and templates. Only users with Manage everything right in these spaces can access the Polls tab and so create new polls.

To create a new poll:

  1. On a workspace, section or template, click on the Polls tab.
  2. Click on the Create a new poll button.
  3. Fill in the creation form and click on the Create button. The poll is created. Depending on the start date you selected, the poll is immediately started or not:
  • if the start date is the current date, the poll is immediately started and users can start voting;
  • if the start date is after the current date, the poll is not started immediately. Users don't see it yet. The poll will start automatically when the starting date is reached. Or you can start the poll before by clicking the Open it link in the Poll status box.

Poll parameters

Field Description
Question Type the question users will be answering.
Description Type an optional text that explains why you do this poll for instance. This description is not displayed to users in the poll widget.
Answers Click on Add and type the first possible answer in the displayed text box. Repeat this for each choice users will have.
Start Date Select the date from which the poll should be available to users.
End Date Select the date at which the poll will close.

Defining Who Can Participate to the Poll

Polls are created in workspaces and sections. By default, the same access rights are applied on the poll as on the space in which they are created. This means that by default the poll is displayed to the users that have access to the workspace or the section. However, you may want to address more users, or on the contrary only a specific population of users. You can manage the access rights on the poll directly.

To be able to participate to the poll, users just need to have Read access to it. It is then automatically displayed to them on the left column of pages below the worklist, until they vote on it or the poll ends.

Opening a Poll

When you create a poll, you can indicate when the poll should start. If you select the current date as the starting date, the poll is immediately "Open" and available to users. However, if you select a future date, the poll is "In project" and is not displayed to users yet. In that case, the poll will automatically be opened by the system when the start date is closed.

If you haven't selected a start date, you can open the poll manually at any time by clicking the Open it link in the Poll status box on the Summary tab. The poll is then started and displayed to users.

Closing a Poll

Just like you indicate when the poll should start, you can also select an end date. In that case, your poll will automatically close when the end date is reached. If you haven't selected an end date, you can close it manually at any time by clicking the Close it link in the Poll status box on the Summary tab. The poll results are now displayed on the poll Summary tab. Users cannot vote on the poll, which is not displayed in the poll widget in the left column.

Participating to a Poll

When a poll is open, it is automatically displayed to users in the left column of pages so they can vote on it. To vote on a poll, select your answer and click on the Cast vote button. The temporary results of the poll are displayed. The poll is not available anymore for votes or consultation after you browsed another page or logged out.By default, results are displayed as a pie chart. Use the drop down list to display them as a bar chart.

 

Other documentation about this package