The Polls service lets you create, edit, take, and analyze online polls. With polls, you can survey your audience (such as their opinions and their experience level), check whether they can recall important information, and gather feedback on the efficacy of presentations.
This chapter includes the following sections:
This chapter is intended for users who want to create and manage polls, as well as administrators in Spaces with the
Configuration permission and individual space moderators who want to configure polls within their spaces. For more information, see Section 18.104.22.168, "Understanding Permissions and Permission Models in a Space."
In addition to taking available polls, you can do the following:
Create a poll. You can create quick polls with only a name, description, and question, or you can create detailed polls.
Create a template for polls. Templates contain the same questions, sections, and welcome and closing content.
Edit an existing poll; for example, add questions to the poll, change existing questions, or publish (open) and close the poll.
Take a specific or the most recently-published poll.
View poll results.
See the status of all polls and available actions for each poll, such as edit, delete, publish, analyze, and clear results.
The Polls service is integrated with the Instant Messaging and Presence service in the Polls Manager.
Figure 69-1 shows a sample quick poll.
More detailed poll functionality is available through the Polls Manager (Figure 69-2).
Polls created through the Polls Manager must be published and open to be taken. Users cannot take unpublished or closed polls.
The Polls task flows let you create, take, and manage polls. This section includes the following subsections:
On the General tab (Figure 69-5), enter a name and description for your poll, and the number of days for the poll to stay open. The name you enter appears in the Component Properties as a parameter in the Take Polls and View Poll Results task flows.
On the Question tab (Figure 69-6), design your one-question poll. Select the Add Comment Field box to add a custom field, such as Tell us more! or Other.
The same types of questions are available in Quick Polls and in the Polls Manager.
Quick polls can be managed with the Polls Manager. Or, in Edit Page mode, you can click the Design Poll button to edit the quick poll.
Figure 69-7 shows the poll users see.
To take a poll, simply select or enter your choice, and click Vote.
The Take Polls task flow (Figure 69-8) displays the most recently-published available poll, unless it is set to display a specific poll with the
Poll Id parameter. After a user submits a response for that poll, this task flow displays the next most recently-published poll.
The Polls Manager lets you create polls, view the status all current polls, and perform operations on existing polls, including edit, save (as poll or as a poll template), publish, clear results, close, analyze, and delete.
See the latest poll data by clicking the Refresh icon on the Polls Manager view (Figure 69-9).
To add a new poll, click Create Poll.
On the Design page, click Add to populate the poll with an existing template or with questions and surrounding text (Figure 69-10).
Click Add Section to enter any explanatory text in a rich text editor (Figure 69-11).
Click Add Question to add each poll question (Figure 69-12). New questions are added to top of the poll, so you may want to enter poll questions in reverse order.
There are four question types:
Multiple Choice (Only One Answer)
Multiple Choice (Multiple Answer)
Matrix of Choices (Only One Answer Per Row)
Matrix of Choices (Multiple Answers Per Row)
With matrix questions, responses are presented in columns and rows. In this example, the current design looks like Figure 69-13.
The same types of questions are available in Quick Polls and in the Polls Manager. For more information about adding questions, see "Creating a Quick Poll".
To apply a template, you must have an existing template saved. For example, when you save any poll, you can select to save it as a template (Figure 69-14).
After it is saved as a template, you later apply that poll template to other polls (Figure 69-15).
On the Schedule page (Figure 69-16), select publish and close options for the poll. Polls must be published and open to be taken. Users cannot take unpublished or closed polls.
In Publish Options, choose to keep the poll in draft mode for further editing, publish it immediately, or publish it on a future date. Click the Select Date and Time icon to enter the publishing time through a calendar. Click Edit Introduction Message to customize in the rich text editor the text provided at the beginning of the poll.
In Close Options, choose to close the published poll after it reaches a certain number of responses or on a certain date. If you select both options, then the poll closes when either condition is first met. Click the Select Date and Time icon to enter the closing time through a calendar. Click Edit Closing Message to customize in the rich text editor the text provided at the end of the poll.
On the Settings page, select what to display after the poll is taken (Figure 69-17). For example, you can set a custom URL or JSF task flow as a Thank You page that appears after the poll is taken.
On the Analyze page, poll owners can view results. Use the Questions box on the right to toggle between multiple questions (Figure 69-18).
If the poll included a field for poll takers to add comments, click View Summary to see consolidated comments (Figure 69-19).
The View Poll Result task flow provides a graphical view of poll results, similar to the Analyze page in the Poll Manager. The View Poll Results task flow must be set to display a specific poll with the
Poll Id parameter.
For more information, see Section 69.3, "Setting Polls Service Task Flow Properties."
The Polls service task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 69-22).
For information about accessing the Component Properties dialog, see Section 18.6.2, "Setting Properties on a Component."
The following sections provide information about properties of the Polls service task flows and describe the properties on the Parameters tab.
The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 69.3.2, "Polls Service Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 22, "Wiring Pages, Task Flows, Portlets, and UI Components."
Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow. These properties are common to all task flows. For more information, see Section 18.6, "Modifying Page Components."
The content of the Events tab depends on the events supported by the task flow. For more information, see Section 18.6.7, "Working with Component Contextual Events."
The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Section 18.6.5, "Working with Child Components."
All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language (EL) Expressions."
Wherever you enter EL on the generic Display Options tab in the Component Properties dialog, the entry is automatically validated. If the EL syntax is invalid, an error appears and the value is neither applied nor saved. Generic Display Options are those cataloged in Table 18-1.
EL validation is not performed on non-generic display options.
Table 69-1 describes the parameters that are unique to the Polls service task flows.
The space name from which polls are to be fetched. If this is supplied, then polls of that particular space are shown.
On the Home space, when this parameter is not supplied, it fetches polls from all spaces.
This parameter appears in the properties for the Polls Manager task flow.
This parameter determines whether to display only those polls created by the user.
Set to Yes to display only those polls created by the user. Set to No (default) to display all polls. If the
This parameter appears in the properties for the Polls Manager task flow.
The name of the poll to display, available from the dropdown list.
This parameter appears in the properties for the following task flows.
This parameter determines whether users can edit a quick poll.
When this parameter is set to No, the Design Poll button for editing the quick poll only appears in page edit mode only; it is not visible to users viewing the page. When this parameter is set to Yes, the Design Poll button appears in both view and edit modes, so users can edit the quick poll.
This parameter appears in the properties for the Quick Poll task flow.