Changeset 12896 for main/waeup.kofa/trunk/src/waeup/kofa/students/utils.py

Timestamp:

1 May 2015, 05:45:41 (10 years ago)

Author:

Henrik Bettermann

Message:

Add StudentsUtils.increaseMatricInteger method which allows to use various
matric number counters when computing the matric number.

File:

• main/waeup.kofa/trunk/src/waeup/kofa/students/utils.py (modified) (3 diffs)

main/waeup.kofa/trunk/src/waeup/kofa/students/utils.py

@@ -516 +516 @@
         return None, payment
 
+    def increaseMatricInteger(self, student):
+        """Increase counter for matric numbers.
+
+        This counter can be a centrally stored attribute or an attribute of 
+        faculties, departments or certificates. In the base package the counter
+        is as an attribute of the site configuration object.
+        """
+        grok.getSite()['configuration'].next_matric_integer += 1
+        return
+
     def constructMatricNumber(self, student):
+        """Fetch the matric number counter which fits the student and
+        construct the new matric number of the student.
+
+        In the base package the counter value is returned.
+        """
         next_integer = grok.getSite()['configuration'].next_matric_integer
         if next_integer == 0:
@@ -526 +541 @@
 
         If the student's matric number is unset a new matric number is
-        constructed using the next_matric_integer attribute of
-        the site configuration container and according to the
-        matriculation number construction rules defined in the
-        constructMatricNumber method. The new matric number is set,
-        the students catalog updated and next_matric_integer
-        increased by one.
+        constructed according to the matriculation number construction rules
+        defined in the constructMatricNumber method. The new matric number is 
+        set, the students catalog updated. The corresponding matric number
+        counter is increased by one.
 
         This method is tested but not used in the base package. It can
         be used in custom packages by adding respective views
-        and by customizing constructMatricNumber according to the
-        university's matriculation number construction rules.
-
-        The method can be disabled by setting next_matric_integer to zero.
+        and by customizing increaseMatricInteger and constructMatricNumber
+        according to the university's matriculation number construction rules.
+
+        The method can be disabled by setting the counter to zero.
         """
         if student.matric_number is not None:
@@ -552 +565 @@
             return _('Matriculation number exists.'), None
         notify(grok.ObjectModifiedEvent(student))
-        grok.getSite()['configuration'].next_matric_integer += 1
+        self.increaseMatricInteger(student)
         return None, matric_number