100 lines
3.1 KiB
Python
100 lines
3.1 KiB
Python
#
|
|
# Copyright (c) 2013 Helmut Merz helmutm@cy55.de
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
#
|
|
|
|
"""
|
|
Interfaces for surveys used in knowledge management.
|
|
"""
|
|
|
|
from zope.interface import Interface, Attribute
|
|
from zope import interface, component, schema
|
|
|
|
from cybertools.knowledge.survey import interfaces
|
|
from loops.interfaces import IConceptSchema, ILoopsAdapter
|
|
from loops.util import _
|
|
|
|
|
|
class IQuestionnaire(IConceptSchema, interfaces.IQuestionnaire):
|
|
""" A collection of questions for setting up a survey.
|
|
"""
|
|
|
|
defaultAnswerRange = schema.Int(
|
|
title=_(u'Answer Range'),
|
|
description=_(u'Number of items (answer options) to select from.'),
|
|
default=4,
|
|
required=True)
|
|
|
|
feedbackHeader = schema.Text(
|
|
title=_(u'Feedback Header'),
|
|
description=_(u'Text that will appear at the top of the feedback page.'),
|
|
default=u'',
|
|
missing_value=u'',
|
|
required=False)
|
|
|
|
feedbackFooter = schema.Text(
|
|
title=_(u'Feedback Footer'),
|
|
description=_(u'Text that will appear at the end of the feedback page.'),
|
|
default=u'',
|
|
missing_value=u'',
|
|
required=False)
|
|
|
|
|
|
class IQuestionGroup(IConceptSchema, interfaces.IQuestionGroup):
|
|
""" A group of questions within a questionnaire.
|
|
"""
|
|
|
|
minAnswers = schema.Int(
|
|
title=_(u'Minimum Number of Answers'),
|
|
description=_(u'Minumum number of questions that have to be answered. '
|
|
'Empty means all questions have to be answered.'),
|
|
default=None,
|
|
required=False)
|
|
|
|
|
|
class IQuestion(IConceptSchema, interfaces.IQuestion):
|
|
""" A single question within a questionnaire.
|
|
"""
|
|
|
|
required = schema.Bool(
|
|
title=_(u'Required'),
|
|
description=_(u'Question must be answered.'),
|
|
default=False,
|
|
required=False)
|
|
|
|
revertAnswerOptions = schema.Bool(
|
|
title=_(u'Negative'),
|
|
description=_(u'Value inversion: High selection means low value.'),
|
|
default=False,
|
|
required=False)
|
|
|
|
|
|
class IFeedbackItem(IConceptSchema, interfaces.IFeedbackItem):
|
|
""" Some text (e.g. a recommendation) or some other kind of information
|
|
that may be deduced from the res)ponses to a questionnaire.
|
|
"""
|
|
|
|
|
|
class IResponse(interfaces.IResponse):
|
|
""" A set of response values given to the questions of a questionnaire
|
|
by a single person or party.
|
|
"""
|
|
|
|
|
|
class IResponses(Interface):
|
|
""" A container or manager of survey responses.
|
|
"""
|
|
|