~u5218464/schooltool-book/schooltool-book

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Customizing Demographics &mdash; The SchoolTool Book</title>
    
    <link rel="stylesheet" href="_static/flourish.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '2.1.1',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="_static/jquery.colorbox-min.js"></script>
    <script type="text/javascript" src="_static/flourish.js"></script>
    <link rel="shortcut icon" href="_static/favicon.ico"/>
    <link rel="author" title="About these documents" href="about.html" />
    <link rel="top" title="The SchoolTool Book" href="index.html" />
    <link rel="up" title="Populating Your School" href="populating.html" />
    <link rel="next" title="Adding People" href="persons.html" />
    <link rel="prev" title="Creating a User Account" href="user.html" />
<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Ubuntu:regular,bold&subset=Latin" />

  </head>
  <body>
<div class="schooltool">
  <div class="header">
    <h1 class="brand">
      <a href="http://www.schooltool.org/">
        <span class="school">school</span><span class="tool">tool</span>
        <img alt="Logo" src="_static/logo-small.png" />
      </a>
    </h1>
    <ul class="navigation">
      <li>
        <a href="http://schooltool.org/">
          Home
        </a>
      </li>
      <li>
        <a href="features.html">
          Features
        </a>
      </li>
      <li>
        <a href="http://launchpad.net/schooltool-project/+announcements">
          News
        </a>
      </li>
      <li>
        <a href="screenshots.html">
          Screenshots
        </a>
      </li>
      <li>
        <a href="system-requirements.html">
          Download
        </a>
      </li>
      <li>
        <a href="index.html">
          Documentation
        </a>
      </li>
      <li>
        <a href="about.html">
          Contact
        </a>
      </li>
    </ul>
    <script type="text/javascript">
      $(document).ready(function() {
        $(window).scroll(function() {
          var scrollTop = $(window).scrollTop();
          if (scrollTop > 64) {
            $('div.related').css('position', 'fixed');
            $('div.related').css('top', '0');
          } else {
            $('div.related').css('position', 'absolute');
            $('div.related').css('top', '64px');
          }
        });
      });
    </script>
    
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="persons.html" title="Adding People"
             accesskey="N">next</a></li>
        <li class="right" >
          <a href="user.html" title="Creating a User Account"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">The SchoolTool Book</a> &raquo;</li>
          <li><a href="populating.html" accesskey="U">Populating Your School</a> &raquo;</li> 
      </ul>
    </div>
<!-- Search Bar -->
<div id="search-box">
  <form class="search-form" id="google-appliance-search-form" method="get"
        accept-charset="UTF-8"
        action="search.html">
      <div>
        <div id="edit-keys-wrapper" class="form-item">
          <input type="text" class="form-text"
                 onfocus="if(this.value=='Type to search'){this.value=''}"
                 onblur="if(this.value==''){this.value='Type to search';}"
                 value="Type to search" size="20" id="edit-keys" name="q"
                 maxlength="255" />
            <input type="hidden" value="yes" name="check_keywords" />
            <input type="hidden" value="default" name="area" />
        </div>
        <img src="_static/arrow.png" class="form-submit"
             onclick="$(this).closest('form').submit()"
             style="cursor: pointer" />
      </div>
    </form>
  </div>
  <!-- End Search Bar -->
  </div>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="customizing-demographics">
<h1>Customizing Demographics<a class="headerlink" href="#customizing-demographics" title="Permalink to this headline">ΒΆ</a></h1>
<p>SchoolTool allows you to modify the demographic information stored about each Person.  If you are using SchoolTool as the primary student information system for a school, you will probably need to customize the demographics fields to meet your local government&#8217;s reporting requirements.</p>
<p>Note that <strong>Prefix, First name, Middle name, Suffix</strong> and <strong>Preferred name</strong> are not customizable.  &#8220;Preferred name&#8221; is the name which a student prefers to be used by teachers, or for teachers the name they prefer to have used in correspondence with parents and students.</p>
<p><strong>Gender</strong> and <strong>Birthdate</strong> also cannot be changed.</p>
<p>You can limit fields to specific Groups, such as Students, Teachers or Administrators.  For example, this would allow you to have a &#8220;Certification&#8221; field for People in the &#8220;Teachers&#8221; Group that would not appear when you edited any other People.</p>
<p>Contact information &#8211; parents&#8217; names, address, phone, email, etc. &#8211; is stored separately.</p>
<p>To edit the default demographics fields, you must be logged in as a member of <strong>Site Managers</strong>. Select the <strong>School</strong> tab, and then click on the <strong>Customize: Demographics</strong> link in the sidebar.</p>
<blockquote>
<div><img alt="_images/demographics-schema-0.png" src="_images/demographics-schema-0.png" />
</div></blockquote>
<p>In the default settings, <strong>ID, Ethnicity, Language, Place of birth, and Citizenship</strong> can be edited or removed.  In this case, <strong>ID</strong> is just a generic text field which you can use for any student ID or number you might need to track.</p>
<p>You can delete, edit, and re-order the existing fields, and you can add your own custom fields.</p>
<p>In this example we will:</p>
<blockquote>
<div><ul class="simple">
<li>delete &#8220;Citizenship&#8221;;</li>
<li>reorder fields;</li>
<li>change the values in the &#8220;Ethnicity&#8221; list;</li>
<li>add &#8220;Enrollment Date&#8221;.</li>
</ul>
</div></blockquote>
<p>To delete a field, click <strong>Actions: Reorder or Delete Fields</strong> in the sidebar, and then click the red minus (<strong>-</strong>) icon next to the field you&#8217;d like to delete.  You can also reorder the fields here by changing the numbers in the first column of the table.  In both cases, the changes are applied immediately.</p>
<blockquote>
<div><img alt="_images/demographics-schema-1.png" src="_images/demographics-schema-1.png" />
</div></blockquote>
<p>To edit the values in a selection list from the main <strong>Demographics and Personal Information</strong> screen, click on the title of the field &#8211; for example, <strong>Ethnicity</strong>:</p>
<blockquote>
<div><img alt="_images/demographics-schema-2.png" src="_images/demographics-schema-2.png" />
</div></blockquote>
<p>To change the list values, simply edit the values in the <strong>Selection List</strong> text box.  Each line defines one value.  You can also specify whether the field is required, and if it should be limited to Students, Teachers and/or Administrators.</p>
<p>You can add six different types of fields:</p>
<blockquote>
<div><ul class="simple">
<li>Text Field: for a single line of text;</li>
<li>Integer Field: for whole numbers;</li>
<li>Description Field: for longer text entered through a textbox;</li>
<li>Date Field: entered through a calendar widget;</li>
<li>Yes/No Field: for a true/false boolean value;</li>
<li>Selection List: a list of string selected through a drop-down menu;</li>
</ul>
</div></blockquote>
<p>For our example, we will add an &#8220;Enrollment Date&#8221; field for the &#8220;Students&#8221; Group.  Click on <strong>Add: Date Field</strong>:</p>
<blockquote>
<div><img alt="_images/demographics-schema-3.png" src="_images/demographics-schema-3.png" />
</div></blockquote>
<p>And thus:</p>
<blockquote>
<div><img alt="_images/demographics-schema-4.png" src="_images/demographics-schema-4.png" />
</div></blockquote>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h4>Previous topic</h4>
  <p class="topless"><a href="user.html"
                        title="previous chapter">Creating a User Account</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="persons.html"
                        title="next chapter">Adding People</a></p>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
  <div class="footer">
    <p class="copyright">
        &copy; Copyright 2014, the Shuttleworth Foundation.  This work is licensed under the Creative Commons Attribution 3.0 Unported License.
    </p>
    <p>
      Last updated on May 22, 2014.
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.2.2.
    <a href="_sources/demographics-schema.txt"
             rel="nofollow">Show Source</a>
    </p>
  </div>
</div>
  </body>
</html>