| #summary Survey entity model |
| #labels Phase-Design,Contents-Skeleton,Design-Model |
| |
| _*Eventually, this topic should be populated by the output of*_ `pydoc`. |
| |
| {{{ |
| class Survey(db.Model): |
| """Model of an authored "template" for Reviews of Proposals and other Works. |
| |
| A Survey is a Work made up of one or more Questions. (The Answers to |
| a specific instance of an "answered Survey" are stored in a separate model |
| called a Review.) |
| |
| Surveys are even used as templates for comments and scoring annotations |
| to various Works, such as Proposals. See the Review model for specific |
| examples. |
| |
| A Survey entity participates in a number of relationships: |
| |
| work) a required 1:1 relationship with a Work entity that contains the |
| general "work" properties of the Survey. The back-reference in the Work |
| model is a Query named 'survey'. |
| |
| work.authors: the Authors of the Work referred to by this relation |
| are the authors of the Survey of questions and potential answers. |
| |
| work.title: the title of the Survey, used to help identify the |
| Survey when seeking a "template" for creating a specific Review. |
| |
| work.abstract: displayed before the first Question in the Survey, |
| usually explanatory text. |
| |
| work.reviews: even Surveys can be "reviewed" (possibly commented on |
| during creation or annotated once put into use). |
| |
| questions) a required many:many relationship (many:many because a given |
| Question can be reused in more than one Survey) between Question entities |
| and, when combined, the Survey they form. See the SurveysQuestions |
| model for details. Using entities of the SurveyQuestions model to |
| related a given Question to a particular Survey, that Question can only |
| be asked once in a given Survey. Asking the same exact question more |
| than once does not seem like a common use case. |
| |
| reviews) a many:1 relationship with Review entities that indicate they |
| contain specific Answers to each of the Questions associated with the |
| particular Survey. This relation is implemented as the 'reviews' |
| back-reference Query of the Review model 'survey' reference. |
| """ |
| work = db.ReferenceProperty(reference_class=Work, required=True, |
| collection_name="survey") |
| }}} |
| |
| ---- |
| _Copyright 2008 Google Inc._ |
| _This work is licensed under a_ |
| [http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-attribution-2_5.html Creative Commons Attribution 2.5 License]. |
| [http://creativecommons.org/licenses/by/2.5/ http://soc.googlecode.com/svn/wiki/html/licenses/cc-by-2_5-88x31.png] |
