--- loncom/enrollment/localenroll.pm	2008/11/25 13:16:26	1.32
+++ loncom/enrollment/localenroll.pm	2009/06/11 20:09:25	1.35
@@ -1,6 +1,6 @@
 # functions to glue school database system into Lon-CAPA for 
 # automated enrollment
-# $Id: localenroll.pm,v 1.32 2008/11/25 13:16:26 jms Exp $
+# $Id: localenroll.pm,v 1.35 2009/06/11 20:09:25 raeburn Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -41,8 +41,6 @@ described at http://www.lon-capa.org.
 
 =over
 
-=back
-
 =cut
 
 package localenroll;
@@ -348,7 +346,7 @@ sub create_password {
  
  fs03nop590 would be split as follows
  @{$codetitles} = ("year","semester","department","number")
- $$codes{{'year'} = '2003'
+ $$codes{'year'} = '2003'
  $$codes{'semester'} = 'Fall'
  $$codes{'department'} = 'nop'
  $$codes{'number'} = '590'
@@ -368,7 +366,10 @@ sub create_password {
 
  e.g., @{$$cat_order{'Semester'}} = ('ss','us','fs'); 
  returns 1 parameter: 'ok' if no processing errors. 
- 
+
+ Detailed help:
+ http://yourloncapaserver/adm/help/Institutional_Integration_Course_Codes.hlp
+
 =cut
 
 
@@ -378,6 +379,43 @@ sub instcode_format () {
     return $outcome;
 }
 
+=pod
+
+=item possible_instcodes()
+
+Gather acceptable values for institutional categories to use in course creation request form for official courses.
+
+ requires four arguments:
+ domain ($dom)
+ reference to array of titles ($codetitles)
+ reference to hash of abbreviations used in categories ($cat_titles).
+ reference to hash of arrays specifying sort order used in category titles ($cat_order).
+
+ e.g., 
+ @{$codetitles} = ("Year","Semester","Department","Number");
+
+ %{$$cat_titles{'Semester'}} = (
+                   fs => 'Fall',
+                   ss => 'Spring',
+                   us => 'Summer');
+
+ @{$$cat_order{'Semester'}} = ('ss','us','fs');
+
+ returns 1 parameter: 'ok' if no processing errors.
+
+=cut
+
+sub possible_instcodes {
+    my ($dom,$codetitles,$cat_titles,$cat_order) = @_;
+    @{$codetitles} = ();
+    %{$$cat_titles{'Semester'}} = ();
+    @{$$cat_order{'Semester'}} = ('ss','us','fs');
+    ($$cat_titles{'Department'},$$cat_order{'Department'}) = &get_all_depts($dom);
+    ($$cat_titles{'Year'},$$cat_order{'Year'}) = &get_possible_years($dom);
+    return 'ok';
+}
+
+
 
 =pod
 
@@ -398,7 +436,7 @@ sub instcode_format () {
      existing photo, photo was found to be missing from institution's
      data store, photo used is same as before, or photo was 
      deleted from storage on LON-CAPA server housing student's
-     information, no student ID was available. 
+     information, no student/employee ID was available. 
                
  (e) $action: the type of action needed. (e.g., update, delete);
  (f) $students: a reference to a hash with the keys set to student 
@@ -525,6 +563,9 @@ sub check_section {
 
      @{$code_order} = ('Semester','Year','Department','Number');
 
+ Detailed help:
+ http://yourloncapaserver/adm/help/Institutional_Integration_Course_Codes.hlp
+
 =cut
 
 sub instcode_defaults {