Changeset 12902 for main/waeup.kofa/trunk/src/waeup/kofa

Timestamp:

5 May 2015, 04:37:21 (10 years ago)

Author:

Henrik Bettermann

Message:

We don't need to edit next_matric_integer in the base package.

Adjust interface.

Location:

main/waeup.kofa/trunk/src/waeup/kofa

Files:

• browser/pages.py (modified) (1 diff)
• students/interfaces.py (modified) (2 diffs)
• students/utils.py (modified) (1 diff)

main/waeup.kofa/trunk/src/waeup/kofa/browser/pages.py

@@ -782 +782 @@
         _('Add session configuration'),
         _('Remove selected')]
+    # We don't need to edit next_matric_integer in the base package.
     form_fields = grok.AutoFields(IConfigurationContainer).omit(
-        'frontpage_dict')
+        'frontpage_dict', 'next_matric_integer')
 
     @action(_('Save'), style='primary')

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

@@ -86 +86 @@
         """Create Payment object and set the payment data of a student for
         the payment category specified.
-
+        """
+
+    def increaseMatricInteger(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.
+        """
+
+    def constructMatricNumber(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 is returned which is as an attribute
+        of the site configuration object.
         """
 
@@ -93 +108 @@
 
         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 _composeMatricNumber 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.
         """
 

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

@@ -530 +530 @@
         construct the new matric number of the student.
 
-        In the base package the counter value is returned.
+        In the base package the counter is returned which is as an attribute
+        of the site configuration object.
         """
         next_integer = grok.getSite()['configuration'].next_matric_integer