Survey Macro

Name Survey Plugin
Vendor Confluence Community
Authors Matt Wizeman, Frank Stiller
Homepage http://confluence.atlassian.com/display/CONFEXT/Survey+Macro
Issue Management http://developer.atlassian.com/jira/browse/CSRVY
Continuous Integration n/a
Categories Content Macros
Most Recent Version 1.1.7
Availability Confluence v2.1.3 to v3.0.0_01
State Stable
Support Unsupported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Survey+Macro
Java API Docs n/a
Download Source http://svn.atlassian.com/svn/public/contrib/confluence/survey-plugin/tags/1.1.7
Download JAR nic-survey-macro-1.1.7.jar

Overview

This plugin is accessible through the Confluence Repository Client.

Plugin Versions

Version Date State License Price
Show description 1.1.7 (#7) 28 Oct 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • bundling brazilian portuguese language (1.1.6b)
  • display the vote given for a comment (1.1.6c)
  • vote items are again rendered with wiki-rendering (1.1.6d)
  • Resolved Issues:

The JIRA server does not support trust requests. Issues have been retrieved anonymously. You can set the macro to always use an anonymous request by setting the anonymous parameter to true
JIRA Issues (2 issues)
Key Priority Summary Updated asignee Reporter Status
CSRVY-8 Major Display the vote given for a comment Jul 14, 2008 Paulo Tamaki Resolved
CSRVY-7 Minor Support for brazilian language Jul 11, 2008 Paulo Tamaki Resolved

Contributors

  • Frank Stiller — Developer

Show description 1.1.6 (#6) 02 Jun 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • better handling of rich text editor (renderer)
  • better handling (empty lines are no valid votes)
  • implemented i18n (Languages: english and german). If you have another language build the plugin with a modified SurveyPlugin_locale.properties-file or attach it to a improvement-issue.

Contributors

  • Frank Stiller — Developer

Show description 1.1.5 (#5) 14 May 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • added parameter for survey and vote: locked
  • Anonymous can see result (if locked and not restricted)
  • Resolved Issues:

The JIRA server does not support trust requests. Issues have been retrieved anonymously. You can set the macro to always use an anonymous request by setting the anonymous parameter to true
JIRA Issues (1 issues)
Key Priority Summary Updated asignee Reporter Status
CSRVY-1 Major introduce a finished-parameter to the macros May 14, 2008 Frank Stiller Resolved

Contributors

  • Frank Stiller — Developer

Show description 1.1.4 (#4) 24 Apr 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • added parameter for survey: title
  • added parameter for survey: showComments
  • improved comments-handling (added the ballotname to the id)
  • decreased power of heading by one, e.g. ballot will now be h3
  • title-parameter has some visual improvements and is a base for multi-surveying on one page
  • Anonymous can see result (if enabled and not restricted), logged in must have completed survey to see it

Contributors

  • Frank Stiller — Developer

Show description 1.1.3 (#3) 21 Apr 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • Checked in the Sources to the Atlassian-SVN-Repository
  • Updated this page accordingly with the Repository-Macro (issues related can now be created in the JIRA-Project)
  • added parameter for survey: choices

Contributors

  • Frank Stiller — Developer

Show description 1.1.2-ptv (#2) 21 Apr 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

  • Changed the database-storage-field from String to Text
  • Resolved Issues:

The JIRA server does not support trust requests. Issues have been retrieved anonymously. You can set the macro to always use an anonymous request by setting the anonymous parameter to true
JIRA Issues (1 issues)
Key Priority Summary Updated asignee Reporter Status
CSRVY-2 Major vote/survey macro does not support large number of users May 16, 2008 Frank Stiller Resolved

Contributors

  • Frank Stiller — Developer

Show description 1.0.0 (#1) 19 Mar 2006 Stable Freeware / Open Source (BSD) Free

Release Notes

  • Initial release

Contributors

  • Matt Wizeman — Developer

Downloads

Date 2009-Jan 2009-Feb 2009-Mar 2009-Apr 2009-May 2009-Jun 2009-Jul
Hits 242 201 232 202 191 218 7

Description/Features

Like the vote macro but need to collect data and comments on many issues at once? The Survey Macro is perfect for performance reviews and multi-question surveys.

This entry includes two parts: an enhanced version of the original vote macro, and a new multi-question Survey Macro, which builds on the Vote Macro. The Vote Macro can still be used on its own.

Compatibility Matrix (confluence vs plugin version)

v macro \ confluence > v2.1.3 v2.5.6 v2.8.* v2.9.* v2.10.* v3.0-m8
v. 1.0.0          
v. 1.1.3-1.1.7  

Empty entries just state that it hasnt been tested. On the other hand its compiled against confluence 2.1.4 and should be backwards compatible all the way

Upgrading from v.1.0.0 or from the Vote-Plugin to 1.1.*+

Due to the necessary change of saving data to the text-field in 1.1.* you have to update your old data in the database accordingly. See the MySQL-Command sample posted directly under this list:

--this will change the value and type from string to text
update os_propertyentry set key_type=6, text_val=string_val
where entity_key like 'vote.%'
--this nulls the old stringvals
update os_propertyentry set string_val=null
where entity_key like 'vote.%'
--comments handling:
--this will change the value and type from string to text
update os_propertyentry set key_type=6, text_val=string_val where entity_key like 'survey.%.commenters';
--this nulls the old stringvals
update os_propertyentry set string_val=null where entity_key like 'survey.%.commenters';

If you cant see some old values, maybe you have some unnecessary Html-Tags in your data, try (under MySQL):

--this will cut the occurance on the right of the html tag </p>
update os_propertyentry set entity_key=left(entity_key,length(entity_key)-4)
where entity_key like 'vote.%' and right(entity_key,4)='</p>'
--this will cut the occurance on the right of the html tag <br/>
update os_propertyentry set entity_key=left(entity_key,length(entity_key)-5)
where entity_key like 'vote.%' and right(entity_key,5)='<br/>'
--this will cut the occurance of the html tag <p> which can occur within the vote-saved string
update os_propertyentry set entity_key=REPLACE(entity_key,'<p>','')
where entity_key like 'vote.%<p>%'

You can run the sql-commands without restarting confluence, but it will take some time till the macros render it correctly, so a restart cant be bad. I would recommend:

  1. Shut down Confluence
  2. run the sql-commands on the database (here it was mysql)
  3. startup confluence
  4. uninstall the vote or old survey plugin
  5. upload the new plugin via the admin console

Vote Macro

New features added to the Vote Macro include:

  • Upgraded to work on newer versions of Confluence.
  • The summary display now shows the user which option they voted for.
  • Added the ability to let users change their votes.
  • Added the ability to specify a list of users allowed to cast votes.
  • Added the ability to specify a list of users allowed to view the results.

Survey Macro

The survey macro allows Confluence users to be polled on several issues by creating a new vote macro instance for each issue. The user casts a single vote per issue and can submit a comment with their vote. Once finished, they're shown a summary of everyone's votes (depending on their access level).

In addition to the functionality of the Vote Macro described above, the survey macro also provides:

  • The ability to store user comments for each issue. Visibility of user comments is controlled by the "viewers" parameter in the same way that votes are.
  • A rolled-up summary of the voting on each issue. Viewing of this summary data is also controlled by the viewers parameter.

Installation

  1. Install the plugin jar using the admin interface
  2. You're done!

Usage

Full documentation on the use of these two macros can be found in your Confluence "full notation guide" after installing the macros.

Using the Vote Macro

Using this macro is largely the same as in its previous version, and it's backward-compatible – all existing instances will still operate as expected. The new functionality is made available through a set of macro parameters.

The body of the macro defines the options that the users will be allowed to vote on. Each new line is considered a new ballot entry.

The parameters supported by this macro are:

Parameter Required Default Description
  true   This is the title of the ballot and must be the first parameter.
voters false all users This is a comma separated list of usernames who are allowed to cast a vote. Users not in this list will not be allowed to vote, but if they are viewers will be shown the results of the vote. If this parameter is not specified, all users with access to the page are considered voters.
viewers false all users This is a comma separated list of usernames who are allowed to see the vote results. Users not in this list will be allowed to vote but after doing so will simply be shown which item they voted for. If a user is in this list but is not a voter, they will be taken straight to the results. If this parameter is not specified, all users will be able to see the results.
changeableVotes false false This parameter, if set to true, will allow the voters to change their vote after it has been cast.
locked false false Dont allow any further voting. Show a lock Symbol to indicate that.

Using the Survey Macro

The body of this macro defines the categories that the users will be polled on. Each line of the body is treated as a separate category and should be written in the format "title - description". The title is always required, but the dash and the description are optional.

The parameters supported by this macro are:

Parameter Required Default Description
voters false all users This is a comma separated list of usernames who are allowed to cast a vote. Users not in this list will not be allowed to vote, but if they are viewers will be shown the results of the vote. If this parameter is not specified, all users with access to the page are considered voters.
viewers false all users This is a comma separated list of usernames who are allowed to see the survey results. Users not in this list will be allowed to vote but after doing so will simply be shown which item they voted for. If a user is in this list but is not a voter, they will be taken straight to the results. If this parameter is not specified, all users will be able to see the results.
changeableVotes false false This parameter, if set to true, will allow the voters to change their votes after they have been cast.
choices false default-List (1-5) Add a comma separated list which will be used for each survey line, can still be overriden in each line
showSummary false true shall the Summary be displayed?
title false default: none If a title is specified a lightgrey box will be shown around the whole survey (more compact) and it will perform better if you have more than one survey-macro on the same page
showComments false true Shall Comments-Handling be enabled? (show, add, edit, delete)
locked false false Dont allow any further voting. Show a lock Symbol to indicate that. Image for Survey will only be displayed if you have the title-flag also. (It is still shown on the vote-elements)

Examples

This is a survey where users can change their votes. User1 and user2 are allowed to vote and only user3 can see the results.

    {survey:changeableVotes=true|voters=user1,user2|viewers=user3}
    Overall Experience - How useful is this macro?
    Ease of Use - Please rate the ease of using this macro in your page.
    Quality - Did you encounter any errors when using this macro?
    {survey}

This is a survey where users can change their votes. All users with access to the page are allowed to vote and only user3 can see the results.

    {survey:changeableVotes=true|viewers=user3}
    Overall Experience - How useful is this macro?
    Ease of Use - Please rate the ease of using this macro in your page.
    Quality - Did you encounter any errors when using this macro?
    {survey}

This is a survey where users can change their votes. The choices Parameter has been given and so in each 3 the default is replaced by these choices. At the second Vote this Parameter is overriden and the inline is used (low, medium, high).

    {survey:changeableVotes=true|choices=1 - High, 2 - Medium, 3 - Low}
    Overall Experience - How useful is this macro?
    Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
    Quality - Did you encounter any errors when using this macro?
    {survey}

This is the traditional use of the vote macro.

    {vote:What is your favorite color?}
    Red
    Green
    Blue
    {vote}

This will produce a vote where only user1 is allowed to see the results.

    {vote:What is your favorite color?|viewers=user1}
    Red
    Green
    Blue
    {vote}

This is a vote where only user2 and user3 can vote. Again, only user1 can see the results.

    {vote:What is your favorite color?|voters=user2,user3|viewers=user1}
    Red
    Green
    Blue
    {vote}

Screenshots

Open Issues / Future Version-Requests

Labels

quiz quiz Delete
poll poll Delete
macro macro Delete
codegeist codegeist Delete
plugin plugin Delete
non-repository non-repository Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Apr 11, 2006

    Andrew Miller says:

    While I really like this and it is compatible with the vote macro syntax, it unf...

    While I really like this and it is compatible with the vote macro syntax, it unfortunately doesn't display the results of ballots made with the vote macro.

    That makes it kind of hard for us to migrate to it (although I'd like to) as all previous voting resulst will be gone.

    1. May 16, 2008

      Frank Stiller says:

      Just for completeness. That is a problem how values are fetched. So there is som...

      Just for completeness. That is a problem how values are fetched. So there is sometimes an html tag like <br/> or </p> which is then not correctly fitting to the current state on the page. Maybe this can be caught and truncated in a future release.
      Same thing is when you change a Answer-Line, you will loose the votes for that answer (as he cant identify this line anymore, even if you just change one character). Could probably be fixed while giving an id in the first few chars of a line, but that would be a redesign of the architecture and maybe for a release 2.0

  2. May 11, 2006

    Dick says:

    This is exactly what we are looking for. Thanks for this brilliant plugin. But ...

    This is exactly what we are looking for. Thanks for this brilliant plugin.

    But I would like to ask one thing, if I have more than one question under a heading, is there anyway to do it?

    Will that be something like:

    Overall Experience - How useful the macro is?|How often do you use it?

    Thanks

    1. Jul 10, 2006

      Matt Wizeman says:

      That shouldn't be a difficult change to make. Have you already modified the code...

      That shouldn't be a difficult change to make. Have you already modified the code to do this? If not, I can go ahead and make the update for you and post the new version.

      1. Feb 21, 2007

        Jenine Wech says:

        Is this change in the latest version? If so, what is the syntax for creating mul...

        Is this change in the latest version? If so, what is the syntax for creating multiple questions under the same heading?

  3. Jul 10, 2006

    patrice saint-louis says:

    There is problem with the macro. Everytime on saves the survey after editing, t...

    There is problem with the macro.

    Everytime on saves the survey after editing, the CR/LF are gone!.  We have to  reformat everytime.

    ?? is this a bug? 

    1. Jul 10, 2006

      Matt Wizeman says:

      I'm not sure if this is a bug with the macro or not. We have noticed here that m...

      I'm not sure if this is a bug with the macro or not. We have noticed here that many of the macros that depends on CR/LF (like the survey and vote macro) don't do well with the rich text editor. Have you tried using the wiki editor on those pages to see if that clears it up?

      1. Jul 12, 2006

        patrice saint-louis says:

        Yes, even with the WIKI editor. Once saved it is OK.  But as soon as you ed...

        Yes, even with the WIKI editor. Once saved it is OK.  But as soon as you edit the page again it goes back to:

        Unknown macro: {vote}

        Very High High Medium Low

        instead of

        Unknown macro: {vote}

        Very High

        High

        Medium

        Low


        1. Sep 23, 2006

          Michael Redinger says:

          Same problem here (on Confluence 2.2.9).

          Same problem here (on Confluence 2.2.9).

          1. Oct 04, 2007

            Rene Duquesnoy says:

            Same problem with 2.6   

            Same problem with 2.6   

            1. Nov 14, 2007

              Dave Jones says:

              Has anyone found a solution to this problem?  We'd like to use the survey m...

              Has anyone found a solution to this problem?  We'd like to use the survey macro, but this is a show-stopper for us.

        2. Nov 14, 2007

          Dave Jones says:

          I discovered a workaround that works for my site: As with most Confluence wiki ...

          I discovered a workaround that works for my site:

          As with most Confluence wiki sites, our site is set up so that 'Rich Text' is the default markup style.  That seems to be what is causing the problem.

          Here's how to workaround the issue on a page that includes CR/LF-dependent macros:

              * edit the page -- the 'Rich Text' edit page will appear with the text deformatted
              * select the 'Wiki Markup' tab -- the text will still be deformatted
              * click on 'Make Wiki Markup Default' to the right of the tabs
              * click on the 'Cancel' button
              * edit the page again -- the edit page will open in 'Wiki Markup' mode with the formatting you are expecting.
              * do NOT, under any condition, click on the 'Rich Text' tab

          (Alternatively, you could ask your wiki administartor to reconfigure the wiki so that 'Wiki Markup' was the default editing style for all pages.  Or, better yet, have him disable 'Rich Text' editing -- does anyone ever use that?)
           

          1. May 21, 2008

            Scott Leslie says:

            Did this problem ever get fixed? We are running Confluence 2.4.4and the Survey M...

            Did this problem ever get fixed? We are running Confluence 2.4.4and the Survey Macro 1.5 and every page edit causes the CR/LF to disappear within the vote macro. The above workaround is just that, a workaround, and not a fix. Asking my users to edit pages in wiki mode is not an option.

            1. May 23, 2008

              Frank Stiller says:

              Scott i never used the wysiwig Editor as it is to limited, but i checked the ren...

              Scott i never used the wysiwig Editor as it is to limited, but i checked the renderoption of the plugin and i found a solution i uploaded a nic-survey-macro-1.1.6-beta.1.jar which contains a hardcoded RenderMode.NO_RENDER for both Survey and Vote-Macros. With my tests it worked out fine, switching between wiki and Richt Text Mode. Just give me a note if it works for you and i will bundle it.

              1. May 23, 2008

                Scott Leslie says:

                Frank, thanks for this. We are right in the midst of upgrading our confluence in...

                Frank, thanks for this. We are right in the midst of upgrading our confluence installs, so it may take a week or so before I can finally test it, but promise to report back on the results. Thanks again, cheers, Scott

  4. Aug 01, 2006

    Rohit Kumbhar says:

    Is it possible to define the responses while using a survey macro? Something oth...

    Is it possible to define the responses while using a survey macro? Something other than default ones.

    Thanks!

    1. Aug 02, 2006

      Rohit Kumbhar says:

      I modified the source myself to do it! Should I send you a patch. Just askin...

      I modified the source myself to do it! Should I send you a patch. Just asking because I dont know if this is a functionality you want to give!

      1. Aug 08, 2006

        Randy Mysliwiec says:

        I'm currently using a survey application written in coldfusion but I'd love to s...

        I'm currently using a survey application written in coldfusion but I'd love to switch to this one.  However, I'd need to define the responses.  Would it be possible to get your patch?

        1. Aug 08, 2006

          Rohit Kumbhar says:

          Sent! Thro a mail!

          Sent! Thro a mail!

          1. Aug 08, 2006

            Matt Wizeman says:

            I'll have some time this weekend for a bit of coding. If you want to send it my ...

            I'll have some time this weekend for a bit of coding. If you want to send it my way I'll roll it into the main code so you don't have to keep patching.

            1. Aug 08, 2006

              Rohit Kumbhar says:

              I couldn't find your email, so I have attached the whole directory to this page ...

              I couldn't find your email, so I have attached the whole directory to this page

              Unknown macro: {MODIFIED.nic-survey-macro.zip}

              .

              Modifications:
              1. Added fundtionality to specify custom choices.
              e.g.
              o/b survey c/b
              Question 1-Question 1 Description-Chocie1-Choice2-Choice3

              o/b survey c/b
              NOTE: No paces before/after the "-". Not giving any choices will bring up the default 5 choices

              2. Added parameter "showSummary" : Default is true. Survey summary wont be shown if set to false. I wrote this because i had a particular need for it.
              e.g.
              o/b survey:showSummary=false c/b
              Question 1-Question 1 Description-Chocie1-Choice2-Choice3
              o/b survey c/b

               
              Modified files:
              SurveyMacro.java
              Survey.java
              surveymacro.vm

              1. Aug 08, 2006

                Matt Wizeman says:

                Thanks!

                Thanks!

              2. Aug 08, 2006

                Rohit Kumbhar says:

                I am sorry I forgot to mention that the "tests" are not included as they will fa...

                I am sorry I forgot to mention that the "tests" are not included as they will fail during the build.

              3. Aug 26, 2006

                Stephan Carter says:

                Any chance of getting these updates as a JAR? Not being a developer, I don't ha...

                Any chance of getting these updates as a JAR? Not being a developer, I don't have a clue on what to do with the attached directory.

                Just a noob trying to get by...thanks!

                1. Aug 26, 2006

                  Rohit Kumbhar says:

                  Download the MODIFIED.nic-survey-macro.zip from the attachments, extract and use...

                  Download the MODIFIED.nic-survey-macro.zip from the attachments, extract and use the jar file from the target directory.

                  1. Dec 21, 2006

                    Mike says:

                    What's the syntax for specifying answers for a survey?

                    What's the syntax for specifying answers for a survey?

                    1. Dec 21, 2006

                      Rohit Kumbhar says:

                      Question 1-Question 1 Description-Chocie1-Choice2-Choice3

                      Question 1-Question 1 Description-Chocie1-Choice2-Choice3

                      1. Dec 21, 2006

                        Mike says:

                        Excellent! One more request - can you make the comments optional e.g. Unknown m...

                        Excellent! One more request - can you make the comments optional e.g.

                        Unknown macro: {survey....|comments=false}
  5. Aug 21, 2006

    Stuart Gilberd says:

    We are having issues with the results dissapearing for periods of time using the...

    We are having issues with the results dissapearing for periods of time using the vote macro. When I arrived this morning: the page we are using the macro showed on that I had not yet voted (even though I had). Right now it looks like I have voted on all the questions. We have had several other users complaining about this.

    One user, when he visits the page, sees some questions voted for and others not. When he tries to vote for the un-voted questions that question then shows as voted for but one that was voted for now becomes un-voted.

    The page has about 6 votes on it. Most have the answers Yes/No/Neutral. We are using confluence 2.2.7 on Java 5. Most of our users are using Firefox.

    Hopefully that makes sense. Anyone have any suggestions?

  6. Aug 29, 2006

    Peter R. says:

    Does this work under 2.2.x?

    Does this work under 2.2.x?

  7. Dec 08, 2006

    Edgar Vonk says:

    Nice macro! Do you maintain issues in JIRA for this macro? I have one: when you...

    Nice macro!
    Do you maintain issues in JIRA for this macro?

    I have one:
    when you use the macro in a comment in Confluence, voting fails and results in a 404 error. E.g.:

    The requested URL /confluence$generalUtil.customGetPageUrl($content)&vote.choice=Ja&
    ballot.title=Kunnen+we+iets+met+het+Survey+Macro was not found on this server.
    1. Dec 09, 2006

      JayG says:

      Thanks for the catch. The macro has been updated to allow voting within commen...

      Thanks for the catch. The macro has been updated to allow voting within comments.

  8. Feb 12, 2007

    Neil Arrowsmith says:

    I have some comments about this plug-in: If you have more than a screen's wort...

    I have some comments about this plug-in:

    1. If you have more than a screen's worth of questions, answering a question will jump you back to the top of the page. Makes it quite confusing filling in answers as you have to find where you'd got up to.
    2. I'm using the enhanced version that lets you specify alternative answers. With this, the Summary boxes in the results don't always display an appropriate summary. If my question isn't of the "Good-Very Good-Bad" type, then the Average Score value is meaningless. For example, my question is "What department are you in? Development, Support, etc."
    3. There are no admin facilities. The ability to add comments is a great feature but, as a site admin, if I can't see who made the comment, and can't delete it, I don't want the comments feature there. Of course, I can go through the database to see who made the comment, and I can log in as that user to delete the comment, but a check on "confluence-administrators" group membership and a delete option would be much appreciated.

    It would also be nice to "close" a question, meaning the results were displayed for anyone visiting the page, and leave the other questions open to be answered.

    Just my £0.02. Great improvement on the vote macro though.

    1. Feb 21, 2007

      Jenine Wech says:

      I am very excited about this macro. Thank you! Can you tell me what the "enh...

      I am very excited about this macro. Thank you! Can you tell me what the "enhanced version" is?

  9. Feb 21, 2007

    Bob Swift says:

    Nice macro! Here are some comments: I tried uploading to install and that did...

    Nice macro! Here are some comments:

    1. I tried uploading to install and that didn't seem to work (on 2.2.9), had to put in WEB-INF/lib to make work
    2. Seems to have a restriction of only one survey macro per page - otherwise add comment only goes to first macro. Probably needs an id.
    3. Seems there are 2 branches of this now with the Dec update not including the modified updates by Rohit - it would be nice to get back to a single source
    4. Can this project be added to SVN and Jira?
    5. Would like this available via Confluence repository
    6. Does this work on 2.3?
    7. Is the original author still looking after this or is someone else picking this up?
    1. Jul 18, 2008

      Frank Stiller says:

      Hy Bob, some time since you posted here but for completeness: its uploading v...

      Hy Bob,
      some time since you posted here but for completeness:

      1. its uploading via Administrators-Page now
      2. should perform better now
      3. it is now under sourcecontrol the repository macro
      4. it is checked in to svn and Jira
      5. available since 1.1
      6. it should be downwards compatible to 2.1.3
      7. we all are asked to picking it up , but i like to comment
        Thanks for your suggestions and i want to thank you for your great plugins, we are using them a lot (excel, sql, ..)
  10. Mar 13, 2007

    Frankenstein says:

    This is definitely a nice plugin. Just a couple of things I noticed: (see end of...

    This is definitely a nice plugin. Just a couple of things I noticed: (see end of comment for details)
    1. the "add comment" field seems buggy
    2. "showSummary" is not very useful and when removed (from the code) still displays on the page

    conf version: 2.2.10

    details;
    1. I have installed the MODIFIED version of the plugin (see attachments) to take advantage of the custom names; e.g.,

    {survey:changeableVotes=true}
    Soft Drinks - Choose one - Coca Cola - Diet Coke - Nestea Iced Tea - Root Beer - Canada Dry - Mountain Dew - Sprite - Dr. Pepper - Pepsi - Diet Pepsi - Other (add comment) - None
    {survey}

    However, for each survey listed on the page (I have about 6 altogether), clicking the corresponding "add comment" link takes the user to the top-most "add comment" section of the first survey. Strange is that i don't see any issues in the logs.

    2. I added the showSummary parameter and decided I could not use it because it gave a summary for how often the given survey was voted on rather than the metrics for each category within a summary. For example above, I would see that "soft drinks" were voted on n times rather than "Coke" was voted on 3 times and "Diet Coke" was voted on only twice. So I removed it from the code but the summary still shows on the main survey page. I have not attempted to restart the app, but maybe I will later.

    Other than that, I think this is a great plugin and could be very useful.

    cheers,
    -Jess

    1. Jul 11, 2007

      Rohit Kumbhar says:

      I hadn't really tried for the multiple surveys on a page scenario. Do you have a...

      I hadn't really tried for the multiple surveys on a page scenario. Do you have a fix?

  11. Jul 11, 2007

    Jason Hill says:

    The modified version of the macro seems to be corrupted.  Is it possible to...

    The modified version of the macro seems to be corrupted.  Is it possible to get a new version of it so I can utilize custom responses?

    1. Jul 11, 2007

      Rohit Kumbhar says:

      Did you try to install the zip file? Or did you unzip the MODIFIED.nic-survey-ma...

      Did you try to install the zip file? Or did you unzip the MODIFIED.nic-survey-macro.zip and try installing the nic-survey-macro-1.0.jar under the folder "target" ?

      Regards
      Rohit

      1. Jul 11, 2007

        Jason Hill says:

        I tried to unzip the folder and it said it was corrupted.  I have no access...

        I tried to unzip the folder and it said it was corrupted.  I have no access to its contents.

        1. Jul 11, 2007

          Rohit Kumbhar says:

          Err..I could unzip it right now!

          Err..I could unzip it right now!

  12. Jul 11, 2007

    Jason Hill says:

    when I try to open it, its corrupted.  When I try to unzip it, it says ther...

    when I try to open it, its corrupted.  When I try to unzip it, it says theres no files to extract

  13. Jul 17, 2007

    steffenj says:

    Is this macro incompatible with Confluence v2.5.4? Will there be or is there an ...

    Is this macro incompatible with Confluence v2.5.4? Will there be or is there an updated version? Because it seems somewhat broken after upgrading from 2.3 to 2.5.

    We found that the survey macro was gone after the upgrade. So I've uploaded the "v1.0" binary from here again, via the admin console. This restored the survey functionality but all survey choices are now named "$choice.renderedDescription" instead of "Outstanding", "Satisfactory", etc.

    1. Aug 28, 2007

      Ansar MK says:

      Do you have voting macro installed, if yes uninstall that and enable survey macr...

      Do you have voting macro installed, if yes uninstall that and enable survey macro..

      Regards

       Ansar MK

  14. Aug 06, 2007

    Ankur Palkar says:

    Does this macro allow for creating a survey with answers accepted as text instea...

    Does this macro allow for creating a survey with answers accepted as text instead of selecting from the fixed options?

    I would like to create a survey in which some questions can allow users to select one of the multiple choice answers while other questions require a user to enter text in a text area.

  15. Sep 11, 2007

    kloda says:

    Please give to attachments version of this macro without comments, they are not ...

    Please give to attachments version of this macro without comments, they are not working in clickr theme, thanks.

  16. Oct 29, 2007

    Collin Summers says:

    Any chance to get better reporting out of the surveys and votes?  We would ...

    Any chance to get better reporting out of the surveys and votes?  We would like to at least know who has participated.  Maybe using the reporting macro.... Any ideas on what I'd need to do to get some reports out?

    Thanks... 

  17. Nov 08, 2007

    hernan guelman says:

    when will this be available via the Plugin Repository?

    when will this be available via the Plugin Repository?

  18. Dec 21, 2007

    Tom Miller says:

    What is the status of this plugin? Is it stable for 2.6 / 2.7? This looks lik...

    What is the status of this plugin? Is it stable for 2.6 / 2.7?

    This looks like it could be a really nice plugin.  I need something like this and unfortunately, I am not a Java programmer and this would take me for ever to modify.  But I am great at testing and writing up documentation.  Anyone out there want to work with me to improve this plugin?

    Fix Summary

    Add QType pararmeter   Default - Survey  Other Values:  YesNo, TrueFalse, List (one Answer), MultiList (All that Apply).

  19. Jan 24, 2008

    David Keene says:

    Great plugin, please can you tell me how to view all the comments made, I can on...

    Great plugin, please can you tell me how to view all the comments made, I can only see the comments that I have made although I am a viewer.

  20. Feb 01, 2008

    Jens Dein says:

    Are there any way to modify the text that shows up for the 5 choices in each que...

    Are there any way to modify the text that shows up for the 5 choices in each question in the survey? Perhaps a way of defining the choices for all questions in a single survey would be nice

    Perhaps like :

    {survey:changeableVotes=true|viewers=user3|choices=red,green,blue}
        Overall Experience - How useful is this macro?
        Ease of Use - Please rate the ease of using this macro in your page.
        Quality - Did you encounter any errors when using this macro?
        {survey}
    

    This would make a more compact version of the vote macro where there are many questions with similar choices - but definable by user. This could also solve translation issues...

    1. May 21, 2008

      Frank Stiller says:

      Hy Jens, fixed with release 1.1.3. Thanks for the suggestion. -Frank

      Hy Jens,

      fixed with release 1.1.3. Thanks for the suggestion.

      -Frank

  21. Mar 26, 2008

    Jason Ellis says:

    I am getting this: What's with that funky $choice.renderedDescription?  C...

    I am getting this:

    What's with that funky $choice.renderedDescription?  Can anyone give me a pointer?  I am using the following syntax: Question 1-Question 1 Description-Chocie1-Choice2-Choice3

    1. Apr 02, 2008

      Patricia Kale says:

      Hi Jason, I am seeing the same thing that you did. I used the example code for ...

      Hi Jason,

      I am seeing the same thing that you did. I used the example code for the survey plugin given in the documentation at the top of this page. It produced a table with the $choice.renderedDescription strings rather than the choices (e.g. 5 - Outstanding) shown in the screenshots. I also noticed that the first slide in the screenshots also has the $choice.renderedDesription string in the survey table. We are running Confluence 2.7.2.

      -Pat 

      1. May 21, 2008

        Frank Stiller says:

        I do not currently have a 2.7 Version to test, but if i use the following Code: ...

        I do not currently have a 2.7 Version to test, but if i use the following Code:

        {survey:title=test123}
        Question 1-Question 1 Description-Chocie1-Choice2-Choice3
        {survey}
        

        it gets rendered like this:

        As the choose-images of your screenshot look more like the http://confluence.atlassian.com/display/CONFEXT/vote+macro-plugin. Can you check you dont have the vote-macro/plugin installed anymore and are running the survey-plugin?

        P.S.

        I also noticed that the first slide in the screenshots also has the $choice.renderedDesription string in the survey table

        Thats probably because, all attached screenshots get rendered there and the Image by Jason is also a attached Screen.

  22. Apr 13, 2008

    Jeyaraj Jeyasankar says:

    Hi,  This is a nice macro but there is a restriction on how many users can...

    Hi,

     This is a nice macro but there is a restriction on how many users can vote using the "vote" macro. The casted votes are being stored in the STRING_VAL property which is only 255 bytes long. With our userid length being 6 bytes long, we couldn't have more than 36 votes per choice.

    We have thousands of users who may need to use this feature once enabled.

    - Are there any plans to use a different property attribute, like TEXT_VAL?

    - Are there any other alternatives? Increasing STRING_VAL may not help as I need a large size, to accomdate over 1000 users, meaning a minimum of 7K in length.

    Please advise.

    Thanks.

    1. May 14, 2008

      Frank Stiller says:

      Hy Jeyaraj, i am thinking to switch to the new design myself. I tested a bit an...

      Hy Jeyaraj,

      i am thinking to switch to the new design myself. I tested a bit and modified the sources by Rohit. The package nic-survey-macro-1.1.2-ptv.zip contains some sql-commands (in the root-folder) to transform old vote entries to show up with the new plugin. Also they show how to store the string_val values to the text_val field.
      Ok, its not much, here are the sql-commands :
      Edit: see the upgrade guide on this page!

      This Plugin then uses only the text_val field anymore. There isnt a smooth chance to check for string_val and transform it via code, so you should do this traversal by SQL.

      Best thing to do the upgrade:

      1. Shut down Confluence
      2. run the sql-commands on the database (here it was mysql)
      3. startup confluence
      4. uninstall the vote or old survey plugin
      5. upload the new plugin via the admin console

      All tests and compilation were done with the latest confluence-2.8.0, as i didnt change any library-references it should be compatible to all older versions (as the original was running against 2.1?).

      1. May 14, 2008

        Jeff Schnitter says:

        I ran into a problem where I had nic-survey-macro-1.0 installed on Confluence 2....

        I ran into a problem where I had nic-survey-macro-1.0 installed on Confluence 2.6.2 and launched a survey intended for 250+ people. I ran into the limitation described above. I believe the SQL statements above cover the case where no comments have been made. I needed to add the following SQL statements to allow my existing votes to still be usable after upgrading to nic-survey-1.1.2-ptv:

        update os_propertyentry set key_type=6, text_val=string_val where entity_key like 'survey.%.commenters';
        update os_propertyentry set string_val=null where entity_key like 'survey.%.commenters';
        
        1. May 14, 2008

          Frank Stiller says:

          Hy Jeff, i am sorry The posted Code is for Vote only, if you have old Survey-D...

          Hy Jeff,

          i am sorry

          The posted Code is for Vote only, if you have old Survey-Data you should adjust it per sample

          . I wrote that on the upgrade documentation, but you are right, in the comment it isnt written and i did not have any comments when i changed the type.

          I will update the page to make it more clear (and delete the sql-comments, so it is maintained only in one place).
          I just uploaded a v. 1.1.5 of the survey-plugin. It allows now to close a survey/vote with giving the locked-parameter.

          1. May 14, 2008

            Jeff Schnitter says:

            No worries, Frank. Looks like I read the doc incorrectly. I'd like to say that...

            No worries, Frank. Looks like I read the doc incorrectly.

            I'd like to say that despite the troubles I ran into with the older version, this is a tremendous plugin. I've created surveys with Survey Monkey before and my Confluence survey was incredibly easy to create and immediate access to the results is awesome. A Confluence survey is far easier to create than in Survey Monkey.

            I have two questions based on my initial use of the survey:

            • Would it be possible to merge the changes from Rohit into the base plugin? I needed the
              flexibility of those changes so I used your nic-survey-plugin-1.1.2-ptv, but it's
              confusing, then, to know how this correlates to the official plugin.
            • I ran into what I think is a bug, but needed to against which version I should open it,
              but was confused based on my previous comment. Some users were watchers on the page and
              when the page was updated they received the survey results and the comments even though
              they weren't watchers on the page, so watching the page completely bypassed the desire for
              limiting the number of users who could see the results. Can this be fixed?
            1. May 15, 2008

              Frank Stiller says:

              All 1.1 builds are based on the uploaded sources by Rohit, you can see the sou...
              • All 1.1 builds are based on the uploaded sources by Rohit, you can see the sources in the SVN-Repository, the Comments by him are there (so the "-" delimited list should work).
              • If they are watchers of the page, surely they get notified of changes. I must honestly say i did not really use/test the viewers/voters functionality so far. But it seems you are right, the watcher of the page does not get its notification rendered by the watchers rights, but with the editors rights, so you see what the Last Editor saw. If that is correct, that would be more a bug of confluences notification.

              I tested a bit around:

              • if a user watches a page and afterwards the page gets restricted, he doesnt get notified at all
              • if a user watches a page and is not in the viewers list of this macro he has other renderings then the potential editor, he still gets notified with the editors rendering... so i think thats a bug at least on confluence 2.5.6 i just tested this. Can you commit this also? I would then raise a bug against confluence.
  23. Apr 18, 2008

    hajo van Ravenswaay says:

    A major drawback of the survey macro is that you need to specify single users i...

    A major drawback of the survey macro is that you need to specify single users instead of groups!!

    Overall I am happy with the functionality of the survey- and vote- macro. No(t too much ) complaints about that. The ease of editing, creating and setting permissions in Confluence is perfect.

    However, I run into a more fundamental issue; does Confluence aim to create a complete survey environment? If so, I need a couple of more question styles besides options currently available. One could also think of a reporting sheet, gathering all answers of questions on a page (the survey macro does, but not if you combine it with the vote-macro or the rate-macro).

    So far I found the following options for questions;

    • The Likert scale (offered by the Survey-macro or the rate-macro)
    • The pick an answer option (offered by the vote- macro). .

    Our users ask for more functinality, for example;

    • Vote macro; possibility to tick multiple answers.
    • A rating option;
      • E.g. "Rank the following options from 1 to 6 according to your preference"
      • E.g. Sliding scales on a set of topics => the scales add up to a balanced total
    • A skip option fo a question; e.g. if you answer "yes" on a prior question, skip the next question. If you answer "no", you get the next question asking for more details.
    • A pulldown menu option; instead of 5 sentences with a tick option, you get a single pulldown box from where a user can select his/her answer.

    Curious or such functionality is deemed feasible and useful. I hope so

    1. May 21, 2008

      Frank Stiller says:

      Vote macro; possibility to tick multiple answers. Ok, thats a request mentioned ...

      Vote macro; possibility to tick multiple answers.

      Ok, thats a request mentioned by several users, but currently with only one choice you can be sure its changeable to another (the old choice gets unvoted) but with multiple and the current function there wouldnt be a unvoting (as it is additive). So i see two valid possibilities:

      • allow to unvote on a voted choice
      • give a Button to uncheck all votes on the current question

      Rank the following options from 1 to 6 according to your preference

      didnt get the point for that. Whats the difference to the current behaviour?

      A skip option fo a question; e.g. if you answer "yes" on a prior question, skip the next question. If you answer "no", you get the next question asking for more details.

      With the current implementation its very difficult, as the options are made for customization. So there should be like a parameter on a question with reference to the previous. Maybe it would be sufficient if the dependent just looks for a yes/no or if the previous got the first option, e.g. marked.
      But then still there should be a check whether the previous has been hit at all (i think on other surveys around its the same you can just check the option (or not) and it gets validated on submit (which will be difficult here, as there isnt any such done button ))

      A pulldown menu option; instead of 5 sentences with a tick option, you get a single pulldown box from where a user can select his/her answer.

      That would be the easiest part, as it should be just some changes in the vm (displaying).
      It would be great if you can create some issues so it stays on scope at: http://developer.atlassian.com/jira/browse/CSRVY
      thanks.

      1. May 21, 2008

        hajo van Ravenswaay says:

        Rank the following options from 1 to 6 according to your preference didnt get th...

        Rank the following options from 1 to 6 according to your preference
        didnt get the point for that. Whats the difference to the current behaviour?

        Frank; the idea you is you have a number of options and want people to indicate theirer order of preference for all or a subset of your options. Data like this has much more value for analysis because you can discern an order between options. Currently I would have to make X questions like "Which of the following options would be your number one choice?" and so on for every 2nd 3rd etc option I want info about. It would be far more powerful if this can  be depicted in a single question.

        For example; In which order would you like to have the enhancements of surevy functionality;

        -- Adaptable UI

        -- Pull Down menu

        -- XX

        -- YY

        -- Etc.

        An answer could be   5. Adaptable UI, 1 Pull Down menu, 3  XX, Etc.

        Does this make sense to you? 

        1. May 21, 2008

          Frank Stiller says:

          Hajo, thanks for making it more clear for me (Ordering of the given options). Th...

          Hajo, thanks for making it more clear for me (Ordering of the given options). That would also go in the direction of multiple choices . Does make sense, of course, but it isnt fixable that easy.

  24. May 14, 2008

    John Miller says:

    I added this macro and tried to use some of the new features.  Picking the ...

    I added this macro and tried to use some of the new features.  Picking the options per question works, but not the choices parameter to set the defaults.  locked, choices, showComments (trying to set to false), all appear to be just ignored.  We are running 2.8.0.  We have tried stopping then starting the confluence install.  That did not help.  I have tried uninstalling then reinstalling the plug-in but that did not help either.

     Any help would be appreciated.

    John 

    1. May 15, 2008

      Frank Stiller says:

      Which version of the plugin do you use? it is stated in the release notes when w...

      Which version of the plugin do you use? it is stated in the release notes when which parameter was added.

      1. May 15, 2008

        John Miller says:

        I am running the latest version.  1.1.5

        I am running the latest version.  1.1.5

        1. May 15, 2008

          Frank Stiller says:

          Did you prior use the vote-plugin (still installed) ? The Survey-Plugin is a suc...

          Did you prior use the vote-plugin (still installed) ? The Survey-Plugin is a successor of this (uses an advanced Version of the vote-macro). To be sure there is not a ghost anymore around you can check the plugin-cache in your workingdir.

  25. Jun 28, 2008

    Andy Brook says:

    I just looked at this with Confluence 2.8.1, plugin version 1.1.6, looks promisi...

    I just looked at this with Confluence 2.8.1, plugin version 1.1.6, looks promising, I pasted in the colour vote and a survey given at the top of this page, it looked great. But every time I saved the page, I got another 'vote' rendered in the page, after 5 edits wondering what going on I had mulitple votes that didn't reflect the wiki markup. Looks like a bug unless I misunderstand what this is trying to do..

    1. Jun 30, 2008

      Frank Stiller says:

      Hy Andy, sounds strange. I cant reproduce such a behaviour. I just did the same,...

      Hy Andy, sounds strange. I cant reproduce such a behaviour. I just did the same, in a 2.8.1 instance with 1.1.6 plugin-version i pasted in the colour-vote and it rendered like expected, even with editing and saving several times. Only the one vote i could make was there.
      I dont really believe it is possible that the macro is self voting as it should only get active when you click on the ballots. The only thing i can say you is to check whether you have problems with other macros, having the vote-plugin installed could be a problem (but even that wouldnt count on edit), such things. Maybe you could also check in the database what will be there before you save and after you save.
      --Frank

  26. Jul 03, 2008

    Maureen Akins says:

    When this macro is rendered, the summary of results area appears on the page bef...

    When this macro is rendered, the summary of results area appears on the page before the questions. (Of course, it says I can't see the results until I vote and then it will display the summary preceeding the questions.) I'd like to reverse that order, allowing the results to be displayed on the page after the questions appear, like

    Question
    • choice
    • choice
    • choice
    Summary

    Results

    Is there any way to do that? I didn't see it in the parameter set.

    1. Jul 14, 2008

      Frank Stiller says:

      Maureen, that isnt possible without modifying the layout. So you have create a i...

      Maureen, that isnt possible without modifying the layout. So you have create a improvement request in this plugins JIRA-Project or you have to compile it yourself.

      --Frank

      Edit: i bundled the possibility to a 1.1.6c release: http://svn.atlassian.com/svn/public/contrib/confluence/survey-plugin/jars/nic-survey-macro-1.1.6c.jar, the parameters are showTopSummary=false or showLast=true

  27. Jul 17, 2008

    Marie-Eve Racicot says:

    This is a great macro! One question though...If I want to use it to run a su...

    This is a great macro! One question though...If I want to use it to run a survey internally but wish to see all the comments entered by the different voters, how would I do so without being a voters myself? Am I missing something?

     M-E

    1. Jul 18, 2008

      Frank Stiller says:

      The Comments are rendered if you are able to see the summary, usually for an unr...

      The Comments are rendered if you are able to see the summary, usually for an unrestricted macro (without setting viewers-parameter e.g.) you have to vote first or browsing anonymous on the page.

      I know there are forums with polls out there, where you can choose to see the results/comments without vote first, that would be an improvement request (like making it switchable by the current user to display)

      --Frank

      1. Jul 21, 2008

        Marie-Eve Racicot says:

        Thank you Frank for the quick answer, I will dig further to better understand wh...

        Thank you Frank for the quick answer, I will dig further to better understand why I don't see the compilation of the comments. One last question: does the macro v1.1.6 compatible with Confluence 2.7.3? I am testing it locally right now on my latop using an evaluation copy of 2.8 confluence, although my company is still running the 2.7.3 version and therefore the macro would need to be compatible with this older version.

        Let me know,

        thanks

        M-E

      2. Jul 21, 2008

        Marie-Eve Racicot says:

        Ok, I've tried it on our company installation (Confluence v2.7.3) and the survey...

        Ok, I've tried it on our company installation (Confluence v2.7.3) and the survey is displaying proeprly however it doesn't keep the votes, meaning that whenever the user click on a choice, the checkmarke turns green and right away goes back to blue. If I then lock the survey, it shows me a summary where 0 votes were stored as if no one voted.

        Anyone encountered issues with the 2.7.3 (or perhaps 2.7.x) version?

        1. Jul 22, 2008

          Frank Stiller says:

          I just had some issues with a 2.7.1 instance. The solution was to uninstall my p...

          I just had some issues with a 2.7.1 instance. The solution was to uninstall my preuploaded vote-plugin (after that it rendered correctly). If you have the outdated vote-plugin or survey-plugin v1 then you should probably also check the upgrade-instructions for the database (otherwise that could be a problem).

          Whether something is stored in the database you can try the following SQL-Command:

          select * from os_propertyentry where entity_key like 'vote%'

          Otherwise i did not encounter any problem, neither with 2.5, 2.7 nor 2.8

          --Frank

          1. Jul 22, 2008

            Marie-Eve Racicot says:

            Hi Frank, Unfortunately, I didn't find any vote-macro jar file in the confluenc...

            Hi Frank,

            Unfortunately, I didn't find any vote-macro jar file in the confluence installation nor did the select *  from os_propertyentry where entity_key like 'vote%' returned any results so there has to be something else preventing the plugin to work on our system.

            Perhaps a restart of the confluence service will do?

            1. Jul 23, 2008

              Frank Stiller says:

              Marie-Eve can you check the log-files whether there is any hint/message (when yo...

              Marie-Eve can you check the log-files whether there is any hint/message (when you upload the plugin, when you vote, ...)? A restart can help, but only because i cant really reproduce this behaviour (its not necessary usually).
              You could also check the plugin-cache directory (just some default checks), whether there are no zombies.

  28. Jul 21, 2008

    Y van den Berg says:

    I have two questions: 1. I want anonymous users to vote - How can I do that? I ...

    I have two questions:

    1. I want anonymous users to vote - How can I do that? I have used the Survey makro, and did not add the viewers and voters parameter. It did not allow any voting or viewing. I also tried to add a parameter viewers=Anonymous| voters=Anonymous, but an anonymous user can still not vote.

    2. If I use the vote macro - how can I (as the administrator) see the results of all the votes after a specific time?

    1. Jul 22, 2008

      Frank Stiller says:

      Anonymous voting is not possible. This macro works while remembering the users w...

      Anonymous voting is not possible. This macro works while remembering the users who have voted (as they should usually have only 1 vote each) and thats impossible with unidentified users. There are several issues with anonymous voting. And basically is this plugin not thought for that right now. You can probably create a new feature request for that, but it's quite a different check so that will take a while.

      This plugin does not validate groups or permissions of Confluence. So everyone who can access the page have the same possibilities and only the macro's parameters are counted (viewers, voters,..). The only thing of Confluence is inherited, whether the current Confluence-user can access the page (and therefore see's the poll) or whether he can edit the page and therefore can change the source/poll.

      --Frank

  29. Sep 10, 2008

    Thomas Schmidt says:

    We are using the survey macro containing 18 categories (Title - Description). T...

    We are using the survey macro containing 18 categories (Title - Description).

    The last 2 categories don't seem to work. Is it possible that the number of categories for a survey is limited to 16 ?

    1. Sep 10, 2008

      Frank Stiller says:

      There is only the limitation of a confluence page, as the title, description, ca...

      There is only the limitation of a confluence page, as the title, description, categories are stored within and fall under their terms.

      Probably there is a parsing problem or hinderance around point 16. The Macro renders like this: within the {survey}-Macro each line represents a vote. Each line is parsed via the - (hyphen), first is the name of the vote, 2nd is the subtitle and all other (if present) are rendered as override for specific options at this vote.

      If you want you can file a issue where we can discuss the exact matter of this. I can say that e.g. is working with 20 items:

      {survey:changeableVotes=true|choices=1 - High, 2 - Medium, 3 - Low}
      1 Overall Experience - How useful is this macro?
      2 Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      3 Quality - Did you encounter any errors when using this macro?
      4 Another Overall Experience - How useful is this macro?
      5 Another Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      6 Another Quality - Did you encounter any errors when using this macro?
      7 Another Overall Experience - How useful is this macro?
      8 Another Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      9 Another Quality - Did you encounter any errors when using this macro?
      10 Another Overall Experience - How useful is this macro?
      11 Another Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      12 Another Quality - Did you encounter any errors when using this macro?
      13 Another Overall Experience - How useful is this macro?
      14 Another Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      15 Another Quality - Did you encounter any errors when using this macro?
      16 Another Overall Experience - How useful is this macro?
      17 Another Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
      18 Another Quality - Did you encounter any errors when using this macro?
      19 Another Vote, this time without description
      20 this will be the 20st
      {survey}
      
      1. Sep 10, 2008

        Thomas Schmidt says:

        Thanks for the hint. The Titles of these 2 categories contained special charact...

        Thanks for the hint.

        The Titles of these 2 categories contained special characters. Curiously the macro doesn't care about some Descriptions containing these characters, too.

        Never the less it works after removing these characters from the titles.

        Now I need the survey to be reset.

        Cut & Paste and saving the page in between doesn't work...

        1. Sep 10, 2008

          Frank Stiller says:

          there are 3 ways to "reset" the Survey: Delete the page and create a new (or ...

          there are 3 ways to "reset" the Survey:

          1. Delete the page and create a new (or paste it on a new page), as the propertyentries get deleted when the page is removed.
          2. Rename the titles of the single votes (as the keys are the titles within the storage-engine) / the results of the old surveys are still in the database.
          3. Delete the votes in the database directly. You can retrieve whatever votes done with this sql-command (MySQL):
            select * from os_propertyentry where entity_key like 'vote%' and entity_id like '<pageid>'
            , just replace <pageid> with the id of the surveys-page.
  30. Oct 16, 2008

    Paul Csapo says:

    Hi, this is a great plugin. Works on 2.8.1 too. I noticed there is a choices=1 ...

    Hi, this is a great plugin. Works on 2.8.1 too.
    I noticed there is a choices=1 parameter.. does this mean that if we set it to "choices=2" we can capture 2 ticks/votes?

    When I tried it, it would not let me tick 2 options per question.

    regards,
    Paul

    1. Oct 16, 2008

      Frank Stiller says:

      Hy Paul, i am sorry but thats not possible so far. The choices Parameter gives ...

      Hy Paul,

      i am sorry but thats not possible so far. The choices Parameter gives you the chance to give the survey-macro customized default-options. If you not use this parameter the list with point 1 (unsatisfactory) to point 5 (Outstanding) is used by default.

      --Frank

      1. Oct 16, 2008

        Paul Csapo says:

        Thanks Frank, I just made a basic survey, with 2 questions, and using choices=1 ...

        Thanks Frank,
        I just made a basic survey, with 2 questions, and using choices=1 - High, 2 - Medium, 3 - Low from one of your examples.
        The survey page works fine, and when i vote on both answers, the results summary appears.

        But, the average score is given as "3.0"
        Are you able to please explain more about how this is calculated?
        Also, is there any way that the actual results table, can summarise the total votes per question and answer?

        Eg, instead of this as the summary:

        Question Total Votes Average Score Average Score
        1 Overall Experience 1 3 greenbar
        2 Ease of Use 1 3 greenbar


        How about something like this? (where Low/med/high etc are the options that were available):

        Question Total Votes Low Med High
        1 Overall Experience 17 12 0 5
        2 Ease of Use 13 0 10 3


        It would save us having to scroll down to each question, and then locating the number of votes.
        (Not sure how possible this is with complex surveys, but if this was possible, as long as all the questions have the same answer choices of answer, I think it would work quite well).

        regards,
        Paul

        1. Oct 16, 2008

          Frank Stiller says:

          Paul, the choices Parameter just taking labels (forget about the numbers). The n...

          Paul, the choices Parameter just taking labels (forget about the numbers). The numbers are "generated" by the macro, so the first value is the upperbound and the last is the lowerbound (means 3 .. 1). So if you vote on the first items you have a Score of 3 later on (which usually means the high number or good). The calculated summary will be just the sum of all votes divided by the number of voters.

          I agree the aggregated values would be good, but it isnt that trivial (or at least there are quite some cases to catch), sure as long as the answers are of the samce structure it is quite easy, feel invited to implement it . So in your sample it would likely be rendered as:

          Question Calculation Average Score
          Overall Experience (12*3+0*2+5*1) / 17 2.41
          1. Oct 16, 2008

            Paul Csapo says:

            Thanks Frank

            Thanks Frank

  31. Oct 23, 2008

    Tracy Adams says:

    I have the following that, in 2.2.9 using vote macro rendered properly (links lo...

    I have the following that, in 2.2.9 using vote macro rendered properly (links looked like links), in 2.8.2 we have survey installed, but the links render as text.  Any ideas?:

    {vote:Where should we go to lunch next?}
    \[4912 Thai Cuisine \| http://www.4912thaicuisine.com\]
    \[Pacific \| http://www.chengspacific.com\]
    \[Charlie Chiang \| http://www.charliechiangs.com\]
    \[A Taste of Burma \| http://www.atasteofburma.com/\]
    \[Angeethi Indian Restaurant \| http://www.angeethiva.com\]
    \[Cheesecake Factory \| http://www.thecheesecakefactory.com\]
    \[Tijuana Flats \| http://www.tijuanaflats.com\]
    \[Mayuri Indian Restaurant \| http://www.mayurimahal.com/home.html\]
    \[Benihana \| http://www.benihana.com\]
    \[Delia's \| http://www.555us.com/555va/201/20165/20165_countryside_cafe.htm\]
    {vote}
    
    
    1. Oct 24, 2008

      Frank Stiller says:

      Hy Tracy, i am sorry but that was intended to be a bugfix, as this resolved the ...

      Hy Tracy, i am sorry but that was intended to be a bugfix, as this resolved the issue with the wysiwyg-editor (see the comment from May, 23rd)... Well feel invited to raise a bug/improvement request in this projects JIRA for trying to render just the poll-element or try a older release e.g. 1.1.5.

      Edit: As it was a trivial problem i fixed it in a 1.1.6d release: http://svn.atlassian.com/svn/public/contrib/confluence/survey-plugin/jars/nic-survey-macro-1.1.6d.jar. Please install it manually and if it works out well (as in my tests) i will probably bundle it in the future thanks

  32. Nov 24, 2008

    Hideyuki Mukai says:

    I'm using Confluence Ver. 2.8.0 Build:#1318 with mysql and Survey Macros ver. is...

    I'm using Confluence Ver. 2.8.0 Build:#1318 with mysql
    and Survey Macros ver. is 1.1.7.
    I'd like to use this survey macro to get answers from approx. 100 users.
    Is it possible for this survey macro to get result from 100 users?
    I'm a biginner and I couldn't understand the above discussion about the number of users this macro can accept.
    Thank you in advance.

    Hideyuki Mukai

    1. Nov 25, 2008

      Frank Stiller says:

      Hello Hideyuki, the main improvement for 1.1 was to use the text-property as sto...

      Hello Hideyuki, the main improvement for 1.1 was to use the text-property as storage. So it depends from your database, how long that will be exactly, for MySQL it is mediumtext, which means: L + 3 bytes, where L < 2^24 ~ 16Mio Chars?, see also http://dev.mysql.com/doc/refman/5.0/en/storage-requirements.html. It should be large enough for more than 10000 users. --Frank

      1. Nov 25, 2008

        Hideyuki Mukai says:

        Hi Frank, Thank you for your response.  So simply speaking, this survey ma...

        Hi Frank,

        Thank you for your response.  So simply speaking, this survey macro 1.1.7 with mysql can accept 100 users, right?

        If I should change some setting of Mysql for this survey macro to accept 100 users, please let me know.  I'm a beginner but I can handle phpMyAdmin.

        Best regards,

        Hideyuki Mukai.

        1. Nov 25, 2008

          Frank Stiller says:

          yes, 100 should be a subset of 10000 . You dont have to manipulate anything. Jus...

          yes, 100 should be a subset of 10000 . You dont have to manipulate anything. Just use the macro as documented and the Plugin/Confluence should take care of the rest. The sample with MySQL was just a guidance what is possibly storable (which depends on the Database you setup Confluence against, but there is no real difference in the storage engines we use it for). --Frank

          1. Nov 25, 2008

            Hideyuki Mukai says:

            Hi Frank, I'm relieved.  Thank you very much. -Hideyuki

            Hi Frank,

            I'm relieved.  Thank you very much.

            -Hideyuki

  33. Nov 28, 2008

    Sebastian Bleher says:

    Hello! I'm using the Survey Macro and got a problem: my choices go from 10 ...

    Hello!

    I'm using the Survey Macro and got a problem: my choices go from 10 to 0. When I vote 0 it shows the average of 1, when I vote 1 it shows the average of 2 and so on. So the average is always one higher than the real average. One way to solve the problem could be to have choices from 1 to 10, but in my case I need choices from 0 to 10. How is it possible to get in this case the right average shown?

    Thanks a lot for your help in advance!

    Kind regards, Sebastian

    1. Nov 28, 2008

      Frank Stiller says:

      As posted for Paul some comments earlier, the actual labels you may called 0 to ...

      As posted for Paul some comments earlier, the actual labels you may called 0 to 10, but the numbering is done internally, starting with 1 (as that is the natural start for human-calculations). I am sorry, you cant override this without modifying the Codebase. It should be fairly easy to build in another flag, like startZeroBased=true or equal. Or some flag like useChoicesAsNumbers=true if you have overriden the parameters like that.
      The problem always is to maintain for future releases with each modifications. If the overriding labels are not parsable as numbers that is the main problem with such a dynamic feature. Can you give me the example how you gave the choices the user has for the poll? or any favored method? --Frank

      1. Nov 28, 2008

        Sebastian Bleher says:

        Hi Frank, thanks for your fast answer! Here an example for the choices: ch...

        Hi Frank,

        thanks for your fast answer!

        Here an example for the choices: choices=10 very high, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 very low

        1. Dec 02, 2008

          Frank Stiller says:

          After some experimentation i think i have some solution. I built a new release, ...

          After some experimentation i think i have some solution. I built a new release, which you can get here: http://svn.atlassian.com/svn/public/contrib/confluence/survey-plugin/jars/nic-survey-macro-1.1.7.1.jar

          I added the follwing two Parameters: startBound, iterateStep, with these you can now totally configure your results, either e.g.: startBound=50, iterateStep=-10 or startBound=3, iterateStep=2 should both work. In your case something like this worked in my tests:

          {survey:title=My little Survey|startBound=0|iterateStep=1|choices=10 very high, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 very low}
          

          The ordering is still a bit tricky, but probably that is just everyones taste . I would be glad to get any feedback on that. Happy Voting. --Frank

          1. Jun 24

            Jean-Baptiste Catté says:

            Thanks Francks! I have just installed this version and startBound=0 is very use...

            Thanks Francks!

            I have just installed this version and startBound=0 is very usefull to me: it didn't make thanks to gave 1 point to the answer "I am not interested by this activity"

  34. Dec 07, 2008

    David Keene says:

    I've notice an issue with 2.9.1 with choices that is not there in 2.10. If I us...

    I've notice an issue with 2.9.1 with choices that is not there in 2.10.

    If I use choices=1 - Pass, 2 - Fail as options it defaults to the standard 5 options.

    Please can someone offer some help with this issue.

    Kind regards

    Dave

    1. Dec 08, 2008

      Frank Stiller says:

      David, i just tested it and i could not find any problems with your wished scena...

      David, i just tested it and i could not find any problems with your wished scenario, see the attached screenshot: [^surveychoices2_10.JPG]. Probably the option could not be parsed correctly (it would help if you could write down the survey-header line). And there is no Plugin-Version 2.9. --Frank

      1. Dec 08, 2008

        David Keene says:

        Hi Frank, thanks for the quick reply. I have attached images from Confluence &#...

        Hi Frank, thanks for the quick reply.

        I have attached images from Confluence [2.9.1|^surveydk 2-9-1.JPG] and Confluence [2.10|^surveydk 2-10.JPG], Both using the same scenario. Please notice that 2.9.1 uses the default scenario rather than the requested pass - fail.

        {survey:changeableVotes=true\|voters=user1,user2,user3,user4,user5,user6\|viewers=DKeene\|choices=1 - Pass, 2 - Fail\|title=Windchill 7 - 8 Users - This test is to address issues related to drawing views}Start Wildfire 3 M170 - Authenticate with your current Windchill server
        
        survey}

        Any help would be most appreciated.

        Keep up the good work

        Kind regards

        Dave

        1. Dec 09, 2008

          Frank Stiller says:

          Hy David, i created a issue for inspection @ http://developer.atlassian.com/jira...

          Hy David, i created a issue for inspection @ http://developer.atlassian.com/jira/browse/CSRVY-12 (i think it makes more sense to track it there). As a small spoiler i couldnt find any problems with your posted code neither with confluence 2.9.1 nor 2.10. cheers Frank

          EDIT: I removed the given Screens as they are all added to the gallery, dont think that is really helpfull to all others. They are uploaded to the linked Issue.

          1. Dec 09, 2008

            David Keene says:

            Hi Frank Thanks for your timely response Regards Dave

            Hi Frank

            Thanks for your timely response

            Regards

            Dave

  35. Dec 15, 2008

    Sean V says:

    Is there anyway to implement a "Not Applicable" choice that doesn't affect overa...

    Is there anyway to implement a "Not Applicable" choice that doesn't affect overall averages? Currently, any summary of responses that include a Not Applicable choice are not accurate.

    PS: A small UI suggestion: The blue checkmarks that represent unvoted choices actually look "selected" to a new user, causing a bit of confusion. A better choice would be a gray checkmark, which more universally says "not yet selected".

    1. Dec 29, 2008

      Frank Stiller says:

      Sure, everything is possible. But such Exceptions to regular poll-answers must b...

      Sure, everything is possible. But such Exceptions to regular poll-answers must be implemented correctly. It would go the same way like http://developer.atlassian.com/jira/browse/CSRVY-4 (Skip Option). If i understand you right you mainly want that feature on the {survey}-macro. This option would add such a choice to every single question. Is that what you had in mind? (With the current implementation of Questions you cant override it inline (at least not without bringing in more special characters)).

      With the color thing: Gray should be: you cant select this option, Blue means: you can vote on this choice, Green means: this is your selected choice. Cant see any bad colors here. Please raise a Improvement-Request in the JIRA-Project and add Screenshots (Icons) with your desired scenario if you feel not happy with the current setting. Thanks.

  36. Jan 29

    Richmond-rae Dalisay says:

    Hi all, A very interesting plugin. Just an observation, is it possible for the ...

    Hi all,

    A very interesting plugin. Just an observation, is it possible for the plugin to track the users who answered/voted in the survey? Let say a list or a report that provides all of the users who answered/voted on the page. On that way we can check who are the users who answered/voted in the survey.

    Thanks in advance.

    1. Feb 02

      Frank Stiller says:

      Of course, thats the way the plugin stores the votes in the database and its jus...

      Of course, thats the way the plugin stores the votes in the database and its just a matter of how to display it. If you like, create a New Feature-Issue in this Plugins-JIRA Project with any ideas/wishes you have to get the information shown. Thanks --Frank

      1. Apr 23

        Richmond-rae Dalisay says:

        Hi Frank, Thanks for the reply. Do you have any idea where the plugin stores i...

        Hi Frank,

        Thanks for the reply.

        Do you have any idea where the plugin stores its value in the database? What specific table? I'm having a hard time finding it.

        Btw, here is the survey macro I used:

        {survey}
        Knowledge - This is the knowledge category.
        Communication - This is the communication category.
        {survey}
        

        Thanks in advance.

        1. Apr 23

          Frank Stiller says:

          of course. The votes are stored in the table os_propertyentry and the keys used ...

          of course. The votes are stored in the table os_propertyentry and the keys used start either with vote or with survey, e.g. you can use this SQL-statement (MySQL):

          select * from os_propertyentry where entity_key like 'vote%'

          --Frank

          1. May 14

            Mario Ruiz says:

            Hi Frank, when I run the select statement you said I don't have any user names: ...

            Hi Frank, when I run the select statement you said I don't have any user names:

            confluence_ContentEntityObject 17794336 vote.Quality.1 - High 6 Unchecked 0 (Excluded) 0 0

            how could I get it?

            Thank you.

            1. May 14

              Mario Ruiz says:

              Ok... I found out what was happening.... It's necessary to click on (Excluded) t...

              Ok... I found out what was happening.... It's necessary to click on (Excluded) to see the values....

              Thank you.

  37. Mar 02

    Preston Manwaring says:

    When I post any of the example code into the wiki to test the survey, all I get ...

    When I post any of the example code into the wiki to test the survey, all I get are database references like the 6th screen shot.  For example, when I post the code:

    {survey:changeableVotes=true\|choices=1 - High, 2 - Medium, 3 - Low}
    Overall Experience - How useful is this macro?
    Ease of Use - Please rate the ease of using this macro in your page. - Low - Medium - High
    Quality - Did you encounter any errors when using this macro?
    {survey}
    

    I get

    Overall Experience Choose
    $choice.renderedDescription
    $choice.renderedDescription
    $choice.renderedDescription

    What is this "$choice.renderedDescription" stuff?  This is a first time install on confluence 2.10.

    Thanks -- Preston

    1. Mar 02

      Preston Manwaring says:

      Nevermind.  I found the solution buried in a previous posting.  Thanks...

      Nevermind.  I found the solution buried in a previous posting.  Thanks anyway.

  38. Mar 09

    Nicholas Bignell says:

    I am trying to publish the results of a survey (performed by removing the viewer...

    I am trying to publish the results of a survey (performed by removing the viewers= parameter) completed last month. I would like all the comments to be suppressed, but this doesn't seem possible. Using the showComments=false will only suppress comments made by the user viewing the results - any other comments made by other users are still visible. Is this what the macro intended?

    1. Mar 10

      Frank Stiller says:

      I can reproduce this with a 1.1.6 of this Plugin. But it's not there anymore wit...

      I can reproduce this with a 1.1.6 of this Plugin. But it's not there anymore with a 1.1.7, so i would ask you to use the latest version if not already. Currently there is a 1.1.7.3 available, at least for manual installation: here. Please let me know if that doesn't resolve your Problem.

  39. May 10

    Ximon Eighteen says:

    The highest JAR file version I could find to download was 1.1.4 from here: ht...

    The highest JAR file version I could find to download was 1.1.4 from here:

    http://svn.atlassian.com/svn/public/contrib/confluence/survey-plugin/jars/

    What has happened to the newer versions?

    1. May 11

      Frank Stiller says:

      By clicking on your link, i can see 11 jar files. So i guess its more a problem ...

      By clicking on your link, i can see 11 jar files. So i guess its more a problem on your site, could you try it with another browser, e.g.? And what is happening if you click on the Download jar, on this page (which should be direct you to the latest release, which is exactly at that location)?

  40. May 28

    Josh says:

    Is there a way to modify the macro to allow anonymous users to vote, u...

    Is there a way to modify the macro to allow anonymous users to vote, users who do not log in but can view the page? 

    1. Jun 01

      Frank Stiller says:

      Sure there is always a way to do things in Software, but there is now way withou...

      Sure there is always a way to do things in Software, but there is now way without modifying the sourcecode. Currently the loginname is logged in the database and they are summed up for saying how many users have voted. There is no validation for ip-address or endless-voting for Anonymous so far, and no parameter for it is available therefore.

  41. Jun 17

    sensui says:

    Great plugin! But i have a problem, can viewer see the result(summary) even if h...

    Great plugin!
    But i have a problem, can viewer see the result(summary) even if he/she have not voted yet?
    Sometime I need see the result but i'm not a voter.

    1. Jun 17

      Frank Stiller says:

      Currently that will work if the survey has the parameter locked=true, of course ...

      Currently that will work if the survey has the parameter locked=true, of course then voting isnt possible anymore.

      1. Jun 17

        sensui says:

        Thank you for your reply. Although the "locked" parameter can not be set when su...

        Thank you for your reply.
        Although the "locked" parameter can not be set when survey is in progress, it almost fulfills our requirements.

        And another issue, now when user voted an option, if the page is useing the {card}marco), that's a little inconvenient to re-seclect the tab and roll the page to continue voting other options. Can this be improved?

        1. Jun 17

          Frank Stiller says:

          Of course. The tasklist-macro e.g. should work like that, so it would be just di...

          Of course. The tasklist-macro e.g. should work like that, so it would be just digging a bit and implementing, but nonetheless i cant do such improvements right now, as it costs time and its some functionality which is working. So i am sorry to say but that would be a improvement with low priority, at least on my schedules .

          1. Jun 17

            sensui says:

            I understood... thank u.

            I understood... thank u.