forked from drlippman/IMathAS
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathhelp.html
5130 lines (4757 loc) · 313 KB
/
help.html
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
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html lang="en">
<head>
<title>IMathAS Help</title>
<meta charset="utf-8" />
<style>
table td {
padding: 1px 10px;
}
table thead td {
font-weight: bold;
}
ul li {
margin-top: .3em;
}
span.icon {
padding-left: 5px;
padding-right: 5px;
background-color: #ff0;
color:#00d;
border: 1px solid #00f;
font-weight: bolder;
}
h1,h2,h3 {
margin-top: 1.5em;
margin-bottom: .5em;
}
h1 {
color: #00f;
}
h2,h3,h4,h5,h6 {
color: #00c;
}
div.h2 {
margin-left: 5px;
}
div.h3 {
margin-left: 10px;
}
div.h4 {
margin-left: 15px;
}
dd {
margin-bottom: .4em;
}
</style>
<link rel="stylesheet" href="iconfonts/style.css?v=081316" type="text/css" />
<link rel="stylesheet" href="tinymce4/skins/lightgray/skin.min.css?v=061416" type="text/css" />
</head>
<body>
<div class=h1>
<h1>IMathAS Help Documentation</h1>
<h2>Table of Contents</h2>
<ul>
<li><a href="#administration">Administration</a>
<ul>
<li><a href="#creatingcourses">Creating Courses</a>
<ul>
<li><a href="#coursecreationsettings">Course Creation Settings</a></li>
<li><a href="#addingteachers">Adding Teachers</a></li>
<li><a href="#transferingownership">Transfering Ownership</a></li>
<li><a href="#deletingcourse">Deleting</a></li>
</ul></li>
<li><a href="#questionsetmanagement">Question Set Management</a>
<ul>
<li><a href="#managequestionset">Manage Question Set</a></li>
<li><a href="#exportquestionset">Export Question Set</a></li>
<li><a href="#importquestionset">Import Question Set</a></li>
</ul></li>
<li><a href="#librarymanagement">Library Management</a>
<ul>
<li><a href="#managelibraries">Manage Libraries</a></li>
<li><a href="#exportlibraries">Export Libraries</a></li>
<li><a href="#importlibraries">Import Libraries</a></li>
</ul></li>
<li><a href="#installmacrofile">Install Macro File</a></li>
<li><a href="#deleteoldusers">Delete Old Users</a></li>
<li><a href="#importstudents">Import Students</a></li>
<li><a href="#managegroups">Manage Groups</a></li>
<li><a href="#diagnostics">Diagnostics</a></li>
<li><a href="#managingadministrators">Managing Administrators and Teachers</a>
<ul>
<li><a href="#addingadministrators">Adding Administrators and Teachers</a></li>
<li><a href="#rights">Rights</a></li>
<li><a href="#resettingadminpasswords">Resetting Admin Passwords</a></li>
<li><a href="#deletingadmin">Deleting</a></li>
</ul></li>
</ul></li>
<li><a href="#coursemanagement">Course Management</a>
<ul>
<li><a href="#coursepagelayout">Course Page Layout</a></li>
<li><a href="#addingitems">Adding Items</a>
<ul>
<li><a href="#blocks">Blocks</a></li>
<li><a href="#inlinetextitems">Inline Text Items</a></li>
<li><a href="#linkedtextitems">Linked Text Items</a></li>
<li><a href="#forumitems">Forum Items</a></li>
<li><a href="#assessments">Assessments</a>
<ul>
<li><a href="#assessmentsettings">Assessment Settings</a></li>
<li><a href="#addingquestionstoanassessment">Adding Questions to an Assessment</a>
<ul>
<li><a href="#questionicons">Icons used in question listing</a></li>
<li><a href="#questionintrotext">Adding an Introduction to a Question</a></li>
</ul></li>
<li><a href="#addingnewquestions">Adding New Questions</a></li>
<li><a href="#categorizequestions">Categorizing Questions</a></li>
<li><a href="#printcopies">Making Print Copies</a></li>
</ul></li>
</ul></li>
<li><a href="#quickview">Quick View</a></li>
<li><a href="#calendar">Calendar</a></li>
<li><a href="#questionsetmanagementcm">Question Set Management</a>
<ul>
<li><a href="#managequestionsetcm">Manage Question Set</a></li>
<li><a href="#exportquestionsetcm">Export Question Set</a></li>
<li><a href="#importquestionsetcm">Import Question Set</a></li>
</ul></li>
<li><a href="#librarymanagementcm">Library Management</a>
<ul>
<li><a href="#managelibrariescm">Manage Libraries</a></li>
<li><a href="#exportlibrariescm">Export Libraries</a></li>
<li><a href="#importlibrariescm">Import Libraries</a></li>
</ul>
</li>
<li><a href="#liststudents">List Students</a>
<ul>
<li><a href="#exceptions">Exceptions</a></li>
<li><a href="#resettingpasswords">Resetting Passwords / Changing Info</a></li>
<li><a href="#unenrolling">Unenrolling</a></li>
<li><a href="#importstudentscm">Import Students</a></li>
<li><a href="#sectioncodes">Assigning Section and/or Code Numbers</a></li>
<li><a href="#managelatepasses">Manage LatePasses</a></li>
<li><a href="#managetutors">Manage Tutors</a></li>
</ul></li>
<li><a href="#gradebook">Gradebook</a>
<ul>
<li><a href="#gradebooksettings">Gradebook Settings and Categories</a></li>
<li><a href="#offlinegrades">Offline Grades</a></li>
<li><a href="#gradebookdetail">Gradebook Detail</a></li>
</ul></li>
<li><a href="#stugroups">Student Groups</a></li>
<li><a href="#messages">Messages</a></li>
<li><a href="#copycourseitems">Copy Course Items</a></li>
<li><a href="#masschgdates">Change Dates</a></li>
<li><a href="#masschgassessments">Change Assessments</a></li>
<li><a href="#importexportitems">Import/Export Course Items</a></li>
<li><a href="#lti">LTI Integration</a>
<ul>
<li><a href="#lticanvas">Canvas Integration - Using Import (recommended)</a></li>
<li><a href="#lticanvas2">Canvas Integration - Manual Setup</a></li>
<li><a href="#ltibb">Blackboard Integration - Using Import (recommended)</a></li>
<li><a href="#ltibb2">Blackboard Integration - Manual Setup</a></li>
<li><a href="#ltid2l">D2L Brightspace Integration</a></li>
<li><a href="#ltimoodle">Moodle Integration</a></li>
<li><a href="#ltiother">LTI Integration for Other LMSs - Using Import</a></li>
<li><a href="#ltiother2">LTI Integration for Other LMSs - Manual Setup</a></li>
</ul></li>
</ul></li>
<li><a href="#writingquestions">Writing Questions</a>
<ul>
<li><a href="#questionparts">Question Parts</a></li>
<li><a href="#basiccontrolsyntax">Basic Control Syntax</a></li>
<li><a href="#randomizers">Randomizers</a></li>
<li><a href="#graphtablemacros">Graph/Table Macros</a></li>
<li><a href="#formatmacros">Format Macros</a></li>
<li><a href="#stringmacros">String Macros</a></li>
<li><a href="#arraymacros">Array Macros</a></li>
<li><a href="#generalmacros">General Macros</a></li>
<li><a href="#mathmacros">Math Macros</a></li>
<li><a href="#conditionalmacros">Conditional Test Macros</a></li>
<li><a href="#feedbackmacros">Feedback Macros</a></li>
<li><a href="#usingothermacros">Using Other Macros</a></li>
<li><a href="#mathentry">Math Entry</a></li>
<li><a href="#solver">Solver</a></li>
<li><a href="#writingcommon">Options Common to All Types</a></li>
<li><a href="#questiontypes">Question Types</a>
<ul>
<li><a href="#number">Number</a></li>
<li><a href="#calculated">Calculated</a></li>
<li><a href="#multiple-choice">Multiple-Choice</a></li>
<li><a href="#multiple-answer">Multiple-Answer</a></li>
<li><a href="#matching">Matching</a></li>
<li><a href="#function">Function (Algebraic Expression/Equation)</a></li>
<li><a href="#string">String</a></li>
<li><a href="#essay">Essay</a></li>
<li><a href="#draw">Drawing</a></li>
<li><a href="#ntuple">N-Tuple</a></li>
<li><a href="#calcntuple">Calculated N-Tuple</a></li>
<li><a href="#complexntuple">Complex N-Tuple</a></li>
<li><a href="#calccomplexntuple">Calculated Complex N-Tuple</a></li>
<li><a href="#algntuple">Algebraic N-Tuple</a></li>
<li><a href="#complex">Complex</a></li>
<li><a href="#calccomplex">Calculated Complex</a></li>
<li><a href="#numericalmatrix">Numerical Matrix</a></li>
<li><a href="#calculatedmatrix">Calculated Matrix</a></li>
<li><a href="#complexmatrix">Complex Matrix</a></li>
<li><a href="#calccomplexmatrix">Calculated Complex Matrix</a></li>
<li><a href="#algmatrix">Algebraic Matrix</a></li>
<li><a href="#interval">Interval</a></li>
<li><a href="#calcinterval">Calculated Interval</a></li>
<li><a href="#chemeqn">Chemical Equation</a></li>
<li><a href="#molecule">Chemical Molecule Drawing</a></li>
<li><a href="#fileupload">File Upload</a></li>
<li><a href="#multipart">Multipart</a></li>
<li><a href="#conditional">Conditional</a></li>
</ul></li>
</ul></li>
<li><a href="#usingimas">Using the System</a>
<ul>
<li><a href="#registering">Registering</a></li>
<li><a href="#loggingin">Logging In</a></li>
<li><a href="#homepage">Home Page</a>
<ul>
<li><a href="#userprofile">Changing Your User Profile</a>
<ul>
<li><a href="#accessibility">Accessibility and Display Preferences</a></li>
</ul></li>
<li><a href="#enrollinginacourse">Enrolling in a Course</a></li>
</ul></li>
<li><a href="#coursepage">Course Page</a></li>
<li><a href="#stucalendar">Calendar</a></li>
<li><a href="#coursemap">Course Map</a></li>
<li><a href="#takingassessments">Taking Assessments</a>
<ul>
<li><a href="#enteringmath">Entering Math</a></li>
</ul></li>
</ul></li>
</ul>
</div> <!-- h1 -->
<div class=h1>
<h1 id="administration">Administration</h1>
<p>From an administrator's home page, the Admin page can be reached by clicking
the "Go to Admin Page" link near the end of the page.</p>
<p>Not all the options described here may be available to you depending upon
your rights setting</p>
<div class=h2>
<h2 id="creatingcourses">Creating Courses</h2>
Create a new course by clicking the "Add New Course" button.
<div class=h3>
<h3 id="coursecreationsettings">Course Creation Settings</h3>
<p>When you add a new course or click the "Modify" link next to a course name,
enter the course name and an enrollment key. If you are allowing students to self-enroll then the enrollment key should be
given to students, and will be required for them to enroll in this course, along with the Course ID.
For new courses, the course ID will display when you return to the Admin page.</p>
<p>Other option:
<ul>
<li><strong>Enrollment Key</strong>: A entry password for students to self-enroll in the course. If you provide a semicolon-separated
list of keys, students can enroll with any of them, and the key will get recorded as the student's section</li>
<li><strong>Available</strong>: Whether course is available to students, and whether it should display on the instructor's
home page</li>
<li><strong>Lock for Assessment</strong>: Shuts down access to the course except for the specified assessment. Intended for
in-class testing situations.</li>
<li><strong>Theme</strong>: Change the look and feel of your course</li>
<li><strong>Icons:</strong> Whether to display icons next to different course items.</li>
<li><strong>Allow self un-enroll</strong>: Whether students should be able to unenroll themselves from your course (usually NO is
the best choice, so students can't accidentally delete their scores)</li>
<li><strong>Allow other instructors to copy</strong>: Whether other instructors should be allowed to copy
course items without needing an enrollment key. You can limit this ability to instructors in your
own group.</li>
<li><strong>Message System</strong>: allows you decide which features of the internal messaging system you
want to enable. This allows you restrict who, if anyone, the student can send messages to.</li>
<li><strong>Live Chat</strong>: Enable a live chat room for this course</li>
<li><strong>Student Quick-Pick Top Bar</strong>: What items, if any, to have in a bar at the top of the student's course page</li>
<li><strong>Instructor Quick-Pick Top Bar</strong>: What items, if any, to have in a bar at the top of the instructor's course page</li>
<li><strong>Instructor Course Management Links</strong>: Whether to have course management links at the bottom or along the
left side of the instructor's course page</li>
<li><strong>LTI access secret</strong>: A secret code to allow placement of your course into a BasicLTI consumer. <a href="#lti">More info</a></li>
</ul>
</div> <!-- h3 -->
<div class=h3>
<h3 id="addingteachers">Adding Teachers</h3>
After creating a course, click the "Add/Remove Teachers" link after the course
name. Here you can add or remove users authorized as a teacher for this course. Only Group and
full Admins have rights to add/remove teachers.
</div> <!-- h3 -->
<div class=h3>
<h3 id="transferingownership">Transfering Ownership</h3>
Click the "Transfer" link after the course name to transfer the ownership
of the course to another teacher/admin. In general, course ownership is not
highly important, but Course Creators can only modify courses for which
they have ownership.
</div> <!-- h3 -->
<div class=h3>
<h3 id="deletingcourse">Deleting</h3>
Clicking the "Delete" link after the course name will delete the course and
all items contained within the course. However, it will not delete any
questions added to the Question Set from within the course; the Question Set
is shared, and not linked to any course
</div> <!-- h3 -->
</div> <!-- h2 -->
<div class=h2>
<h2 id="questionsetmanagement">Question Set Management</h2>
<div class=h3>
<h3 id="managequestionset">Manage Question Set</h3>
<p>Clicking the "Manage Question Set" link will allow you to search through the
Question Set, modify questions, add questions, remove question, transfer ownership, or
add a set of questions to a question library. Only administrators or question owners
have the rights to remove a question. Be aware that if you remove
a question that is currently being used in an assessment (as shown in the "Times
Used" column), it will mess up that assessment.
</p>
<p>
The options available in the question set manager are:
</p>
<ul>
<li><strong>Modify</strong>: Change the source code of the question and make library assignments. You will only see this option for
questions you own or when the owner has given permission for anyone to modify the question.</li>
<li><strong>View</strong>: View the source code of the question and make library assignements. You will only see this option for question
you do not own.</li>
<li><strong>Template</strong>: Create a new question, using the code of an existing question as a starting point. When you template a
question, the original question is not changed.</li>
<li><strong>Delete</strong>: Delete the question completely from the questionset and all libraries. You will only see this option for
questions you own or when the owner has given permission for anyone to modify the question. You can delete many questions at once
by selecting questions with the checkboxes, then clicking the Delete button near the top of the page.</li>
<li><strong>Transfer</strong>: Transfer ownership of the question to another user. You will only see this option for
questions you own. You can transfer many questions at once
by selecting questions with the checkboxes, then clicking the Transfer button near the top of the page.</li>
<li><strong>Library Assignment</strong>: The Library Assignment button near the top of the page can be used with the checkboxes to add or change your
library assignments for the selected questions. This will not affect other people's assignments</li>
</ul>
<p>Note that the assignment of questions into libraries can be done by anyone, but only the person who made the assignment is able
to remove the question from the assigned library</p>
</div> <!-- h3 -->
<div class=h3>
<h3 id="exportquestionset">Export Question Set</h3>
Use the "Export Question Set" feature to export a portion of the Question Set
for backup or sharing. Use the search feature with the checkboxes to select
questions for inclusion in the export. Clicking the "Finalize" button, you
will be asked for a Library Description.
</div> <!-- h3 -->
<div class=h3>
<h3 id="importquestionset">Import Question Set</h3>
<p>
Use the "Import Question Set" feature to import a Question Set that you or
someone else had exported from IMathAS. Be sure to only import question sets from
trusted sources. After specifying an import file, you will be given a chance
to select specific questions from the set to be imported.
</p>
<p>
Imported questions will have ownership assigned to the importer. Select the
userights you want to apply to all imported questions. You also can import
the questions directly into an existing or new question library</p>
<p>If any questions (identified by a unique id) already exist in your system, you
will be asked if you want to update the existing questions, or add as new questions.
If you have modified questions previously imported, you may want to add as new. </p>
</div> <!-- h3 -->
</div> <!-- h2 -->
<div class=h2>
<h2 id="librarymanagement">Library Management</h2>
<div class=h3>
<h3 id="managelibraries">Manage Libraries</h3>
<p>
Use the library manager to remove, rename, change rights, change parent, or transfer
ownership of question libraries. Be aware that if a library is deleted, the
questions in that library will become unassigned; they are not deleted.
</p><p>
Libraries have a tree structure, where each library has a parent library. When you
add or modify a library, you can change it's parent library. If you change a library's
parent, all children library move with a library. You can only specify an empty
library or existing parent library as a parent.
</p>
<p>
Libraries have use rights. Options are:
</p>
<ul>
<li><strong>Private</strong>: Only the owner or an administrator can list questions in these libraries</li>
<li><strong>Closed to group, private to others</strong>: Anyone in group can list and use questions, , but only
the owner or an admin can add questions to the library. Hidden to anyone outside the group.</li>
<li><strong>Open to group, private to others</strong>: Anyone in group can list and use questions and add to the library.
Hidden to anyone outside the group.</li>
<li><strong>Closed to all</strong>: Everyone can list and use questions, but only the owner or an admin can add questions to the library</li>
<li><strong>Open to group, close to others</strong>: Anyone in group can list and use questions and add to the library.
Outside the group, users can only list and use questions; they cannot add questions to the library</li>
<li><strong>Open to all</strong>: Everyone can list and use questions and add to the library</li>
</ul>
<p>
With library rights, child rights take precedence over parent rights. For example,
if an open library is a child to a private library, the parent will not be hidden
from other users. However a private library as child to a private parent will be
hidden from other users.
</p>
<p>Depending upon the system configuration, non-admins may be limited to creating libraries that are private
to others outside their group. If this is the case, a non-admin will need to contact an admin to create a library
that is closed or open to all.</p>
<p>
Library assignments are done in question management. Library assignments can be done
by any user, but only the person who made the assignment can remove that assignment.
</p>
</div> <!-- h3 -->
<div class=h3>
<h3 id="exportlibraries">Export Libraries</h3>
Use the "Export Libraries" feature to export an entire library or tree
of libraries for backup or sharing. Use the tree to select libraries to export.
Note that if a parent library is selected, it's children libraries are automatically
included in the export, and heirarchy will be maintained. If libraries from different
trees are selected, the topmost libraries in each branch selected will be exported
at the same level.
</div> <!-- h3 -->
<div class=h3>
<h3 id="importlibraries">Import Libraries</h3>
<p>Use the "Import Libraries" feature to import an entire library or tree
of libraries. After selecting a file, the tree of libraries in the import file
will be shown, and you can deselect libraries you do not want to import. Note that
if a parent library is not selected, NONE of the children libraries will be added,
regardless of whether they're checked or not.</p>
<p>You will be asked if you want to update existing questions/libraries, or add as new. If
a library or question (identified by a unique id) in the import already exists on your system,
this will tell the importer whether to update the existing libraries/questions, or import
the libraries/questions as a new copy (a new unique id is assigned).
If you have modified questions previously imported, you may want to add as new. </p>
<p>
Imported libraries and questions will have ownership assigned to the importer. Select the
userights you want to apply to all imported questions and libraries. You can select
a parent in the library tree for all (top level) imported libraries</p>
<p>
If you load a file that does not have a library tree embedded in the file, you will
be told to use the Import Question Set feature instead. Even if a file has a library
tree, you can use the Import Question Set feature to import specific questions from
the file.
</p>
</div> <!-- h3 -->
</div> <!-- h2 -->
<div class=h2>
<h2 id="installmacrofile">Install Macro File</h2>
<p>A Macro Library contains macros (functions) which can be used in questions. These
expand the capabilities of IMathAS. If allowed, installation requires selecting the file name
from your local computer and clicking "Submit". Be aware that any existing
macro library of the same name will be replaced. A help file is automatically
generated for newly installed macro libraries.</p>
<p>
<strong>Warning!</strong>: Macro libraries are pure PHP (programming code), and have a large
security risk. <strong>Only install macro libraries from a trusted source</strong>
</p>
</div> <!-- h2 -->
<div class=h2>
<h2 id="deleteoldusers">Delete Old Users</h2>
Use the Delete Old Users option to delete users who have not accessed the system within
some specified number of months. You can delete just students, or all non-Admin users.
</div> <!-- h2 -->
<div class=h2>
<h2 id="importstudents">Import Students from File</h2>
Use the Import Students from File feature to register and enroll a set of students
automatically from a CSV (commas separated values) file. You can generate a CSV
file using any spreadsheet program.
<p>
The form will guide you through specifying which columns of the CSV file contain
First name, Last name, email address, and desired username. Once setting these options,
the first five rows of the file will be displayed so you can verify that the import
settings are correct. If you selected a class to enroll the imported students in,
the students will be both registered and enrolled in that class upon submission.</p>
</div> <!-- h2 -->
<div class=h2>
<h2 id="managegroups">Manage Groups</h2>
<p>Groups allow instructors to be divided into groups (by school, for example). Groups
can create group-specific libraries, and Group Admins can be assigned to have Admin
rights over group users and libraries. By default, users are added to a Default group.</p>
<p>Click <strong>Edit Groups</strong> to add, modify, or delete groups.</p>
</div> <!-- h2 -->
<div class=h2>
<h2 id="diagnostics">Diagnostics</h2>
<p>Diagnostics allow you to create a special login page for larger-scale diagnostic assessment.
This provides a way for students to access and take the diagnostic without needing
to register and enroll in a course. Also, it delivers them the correct assessment based
on a specified selection.</p>
<p>If you are a group admin or full admin, click the "Add New Diagnostic" button to set up
a new diagnostic. Diagnostics are linked with assessments in a course, so you should first
create a course and add your diagnostic assessments to that course.</p>
<p>Over two pages, you will be asked for:
<ul>
<li>Diagnostic name: the name of your diagnostic to display to students on the login page</li>
<li>Term designator: Can be changed each term for ongoing assessments to keep track of which term an assessment was taken in. Also will create a unique
username for each term, so same student ID could take the assessment again in the different term.</li>
<li>Linked with course: What course contains your diagnostic assessments. You must be listed as a teacher for the course</li>
<li>Available: Whether students can take the diagnostic</li>
<li>Public: Whether the diagnostic should be listed on the main Diagnostics list page at $imasroot/diag. If set to no,
students will have to be provided with the direct link to the diagnostic.</li>
<li>Allow Reentry: Whether students should be forced to complete the diagnostic in one sitting, or whether you'll allow them
to reaccess the test at a later time. If Yes, you can set a testing window that limits the number of minutes after first accessing
the diagnostic they can reenter the diagnostic.</li>
<li>Unique ID prompt: How you want to word the prompt for a unique user id</li>
<li>ID entry format: Lets you specify the format of the unique ID, so ensure valid IDs</li>
<li>Allow access IP addresses: IP addressed for which the diagnostic can be taken without a password. If you want to
allow access from anywhere, enter "*". You can use "*" for a wildcard as well, e.g. 123.45.* to allow any IP beginning
with 123.45.</li>
<li>Passwords: Passwords which will allow access to the diagnostic from other IP addresses. Passwords are not case sensitive.</li>
<li>Super passwords: These passwords will override the "allow reentry" time limit, if you specified one earlier. These passwords would be intended
for use by instructors or proctors, and generally would not be shared directly with students.</li>
<li>First level selector name: Students will be asked to select two items from pull-down lists, with the values in the second
depending upon the values in the first. The choice in the first list also dictates which assessment is delivered. For
selector name, specify what this selection should be called, filling in the blank "Please enter your ______". In many cases
the two selectors will be Course and Instructor, or Course and Section</li>
<li>First level selector options: Add options for the first level selector</li>
<li>Second level selector name: Secondary selection, with values depending upon the first-level selector choice. Fill in the blank
"Enter your _________". Second level selectors will be become the student's section identifier in the course, allowing you to
use the tutor system with diagnostics.</li>
<li>Deliver assessment: For each first-level selector, specify which assessment should be delivered if the student
selects that option</li>
<li>Second level selector options: For each first-level selector, specify the options for the second level selector.</li>
</ul>
<p>After submitting the second page, you will be provided with the direct access link to the diagnostic, which you can
provide to students or use to create a link from another website</p>
<p>In courses for which a diagnostic has been set up, the gradebook will display differently, showing the student unique ID,
the term, and the first and second selector values in addition to the students' names and scores</p>
</div> <!-- h2 -->
<div class=h2>
<h2 id="managingadministrators">Managing Administrators and Teachers</h2>
At the bottom of the admin page is a list of users. Group Admins will see the teachers in their group. For Full Admins,
teacher and higher level users are grouped by instructor Group, or are in the Default
group if you haven't defined groups. Student accounts can be listed by choosing the corresponding first letter of the last name. To approve
teachers who have filled out the "new instructor account request" form, choose Pending from the list. Note that if you require email confirmation
of students, they might also show up in the Pending list until they confirm their account.
<div class=h3>
<h3 id="addingadministrators">Adding Administrators and Teachers</h3>
You can add a new administrator, teacher, or student by clicking the "Add New User"
button. You will be asked to provide a username, user's name, and email. The
user's password defaults to 'password'. If a user
already has self-registered, and you want to promote them to administrator or teacher,
find them in the user list and click the "Change Rights" link.
</div> <!-- h3 -->
<div class=h3>
<h3 id="rights">Rights</h3>
When adding a new administrator or changing rights, there are several rights levels, each
higher level including the rights of the lower levels:
<ol>
<li><strong>Guest</strong>: Can access all class materials, including taking tests (however, test is restarted next time the guest user
accesses the test). Cannot enroll or unenroll in courses, or change
user info or password. Cannot post in forums</li>
<li><strong>Student</strong>: Can only access class materials - cannot edit anything</li>
<li><strong>Teacher</strong>: Can edit course materials and create assessments, but only in courses
to which they have been assigned as a teacher</li>
<li><strong>Course Creator</strong>: Can add courses, and they are automatically assigned as the teacher. Can delete courses
that they create.</li>
<li><strong>Diagnostic Creator</strong>: Can add courses, and they are automatically assigned as the teacher. Can delete courses
that they create. Can create diagnostics.</li>
<li><strong>Group Admin</strong>: Can add/delete teachers and set user rights, but only for users in their group. Can modify/delete questions
and libraries created by members of the group regardless of ownership or use rights. Can always create "open to all" libraries</li>
<li><strong>Full Administrator</strong>: Can add/delete administrators and set user rights. Can import macro files, if installation allows.
Can modify/delete questions and libraries regardless of ownership or use rights</li>
</ol>
</div> <!-- h3 -->
<div class=h3>
<h3 id="resettingadminpasswords">Resetting Admin Passwords</h3>
You can reset a user's password to 'password' by clicking the "Reset Password" link
next to the user's name.
</div> <!-- h3 -->
<div class=h3>
<h3 id="deletingadmin">Deleting</h3>
You can delete an administrator by clicking the "Delete" button next to their name.
Note that if they were teaching a course, this will unset them as a teacher, but
does not delete the course itself.
</div> <!-- h3 -->
</div> <!-- h2 -->
</div> <!-- h1 -->
<div class=h1>
<h1 id="coursemanagement">Course Management</h1>
Accessing a course as a teacher shows the course in management (edit) mode.
<div class=h2>
<h2 id="coursepagelayout">Course Page Layout</h2>
The course page consists of a list of items. There are six types of items:
<ul>
<li><strong>Blocks</strong>: Groupings of items (Inline Text, Linked Text, Assessments)</li>
<li><strong>Inline Text Items</strong>: Text that displays on the course page</li>
<li><strong>Linked Text Items</strong>: A summary displays on the course page. A link is provided
that can display text, an uploaded file, or a weblink</li>
<li><strong>Forum Items</strong>: Basic disussion forum</li>
<li><strong>Assessments</strong>: Tests or Practice questions</li>
<li><strong>Calendar</strong>: The course calendar, if you want to embed it on your course page</li>
</ul>
<p>Blocks have a colored header. If a block is displayed collapsed, click the block
name or the "Expand" button to view the block's contents. If the block is
displayed as a folder (has a folder icon next to it), click the block name to view
the block items.</p>
<p>Text items are preceded with an information <span class=icon>!</span> icon, forums are preceded with a
<span class=icon>F</span> icon, and assessments are preceded with a <span class=icon>?</span>
icon. The icons will be grey when the item is not available, and
(depending upon install settings) may change color as a deadline approaches. The color is
green at two weeks, yellow at one week, and red on due date.</p>
<p>The item order can be rearranged by using the number selector to the left of the
item. Items can also be moved into or out of blocks using this selector.</p>
</div> <!-- h2 -->
<div class=h2>
<h2 id="addingitems">Adding Items</h2>
Add an item by selecting the item type from the "Add Item" pulldown. Using the
"Add Item" pulldown inside a block will add the item to that block.
<div class=h3>
<h3 id="blocks">Blocks</h3>
For Blocks, you will asked to provide:
<ul>
<li><strong>Title</strong>: The title of the block</li>
<li><strong>Available after</strong>: The first date for the item to display to students</li>
<li><strong>Available until</strong>: The last date for the item to display to students</li>
<li><strong>When available</strong>: Whether you want to display the block Expanded, Collapsed, or as a folder when available</li>
<li><strong>When not available</strong>: Whether you want to hide the block from students when not available, or show
collapsed or as folder (depending on available setting). Use the show collapsed/folder option if the block contains items that students still need to be
able to access.</li>
<li><strong>Colors</strong>: Allows you to specify colors other than the defaults for blocks</li>
<li>
</ul>
</div> <!-- h3 -->
<div class=h3>
<h3 id="inlinetextitems">Inline Text Items</h3>
For Inline Text items, you will asked to provide:
<ul>
<li><strong>Title</strong>: The title of the item</li>
<li><strong>Hide title</strong>: If you want to hide the title and icon, and just display the text</li>
<li><strong>Text</strong>: The actual text (displays on course page)</li>
<li><strong>Files</strong>: You can attach one or more files to an inline text item. For each file, provide a description
of the file. A list of the descriptions, with links to the files, will display at the bottom of your text item.</li>
<li><strong>Available after</strong>: The first date for the item to display to students</li>
<li><strong>Available until</strong>: The last date for the item to display to students</li>
</ul>
</div> <!-- h3 -->
<div class=h3>
<h3 id="linkedtextitems">Linked Text Items</h3>
For Linked Text items, you will asked to provide:
<ul>
<li><strong>Title</strong>: The title of the item</li>
<li><strong>Summary</strong>: A description of the link (displays on course page)</li>
<li><strong>Text</strong>: Enter one of the following:
<ul>
<li>Type text in box provided. The text will display when link is clicked</li>
<li>Enter a weblink (like http://www.google.com). The link will take students to this weblink</li>
<li>Attach a file. The link will open the file. Note: Do not change the text on subsequent modifications</li>
</ul></li>
<li><strong>Available after</strong>: The first date for the item to display to students</li>
<li><strong>Available until</strong>: The last date for the item to display to students</li>
</ul>
</div> <!-- h3 -->
<div class=h3>
<h3 id="forumitems">Forum Items</h3>
For Forum items, you will asked to provide:
<ul>
<li><strong>Name</strong>: The name of the forum</li>
<li><strong>Description</strong>: A description of the forum (displays on course page)</li>
<li><strong>Available after</strong>: The first date for the item to display to students</li>
<li><strong>Available until</strong>: The last date for the item to display to students</li>
<li><strong>Group linked</strong>: If you have a group assessment, you can link the forum to the groups of that assessment. If you do this,
students viewing the forum will only see posts from their group members and instructors. Be aware that posts to group linked
forums often won't trigger the red "New Posts" flag on the home page.</li>
<li><strong>Allow anonymous posts</strong>: Whether you want to allow students to post anonymously</li>
<li><strong>Allow students to modify posts</strong>: Whether you want students to be able to modify their posts</li>
<li><strong>Email notify</strong>: Whether you want to receive an email whenever a new post is made on the forum</li>
<li><strong>Default display</strong>: Whether you want threads to display Expanded, Collapsed, or in Condensed format by default.
Users can change the display once they view the thread</li>
<li><strong>Students can reply by</strong>: Optionally set date restrictions for students replying to posts. Can be overridden in individual threads.</li>
<li><strong>Students can create new threads by</strong>: Optionally set date restrictions for students creating new threads</li>
<li><strong>Count in gradebook</strong>: Whether you want the forum to count in the gradebook for points. You will be able to assign points for individual posts made.</li>
<li><strong>Gradebook category</strong>: Category for the gradebook, if assigning points to the forum.
</ul>
<p>When you as a teacher start a new thread, you are given the option to have it be:</p>
<ul>
<li>A regular post</li>
<li>Always display at the top of the list</li>
<li>Displayed at top and locked (no replies can be made)</li>
<li>Displayed at top and replies are hidden from students</li>
</ul>
<p>You can use the middle two options to, for example, post discussion instructions. You can use the last option to post a question in
class, and have students respond without seeing other students' replies.</p>
<p>When viewing the forum thread list as an instructor, there is a "List Posts by Name" link which will list
all posts in the forum, grouped by student name. New threads are colored in black, replies in green</p>
</div> <!-- h3 -->
<div class=h3>
<h3 id="assessments">Assessments</h3>
<strong>Warning:</strong> Making changes to an assessment after students have already taken it
can seriously mess up those students' assessment results. It is NOT safe to change: Default points per problem or Default penalty.
<div class=h4>
<h4 id="assessmentsettings">Assessment Settings</h4>
You need to set the assessment settings when you add an assessment. You can
change these settings by clicking the "Modify Settings" link next to the
assessment in the course page.
<ul>
<li><strong>Name</strong>: The name of the assessment</li>
<li><strong>Summary</strong>: A description of the summary (shows on course page)</li>
<li><strong>Intro/Instructions</strong>: Displays at the top of the test (see below for details on making question-specific instructions)</li>
<li><strong>Available after</strong>: The first date for the item to be available to students</li>
<li><strong>Available until</strong>: The last date for the item to be available to students. Students must complete the assessment by this date - they will
be kicked out if they are in the middle of an assessment when this time is reached.</li>
<li><strong>Available for review</strong>: If the checkbox is clicked, the assessment will convert to review mode after the due date
until this date. Review mode defaults to Skip Around display, unlimited attempts, answers shown always. Scores are not
saved in Review mode.</li>
<li><strong>Count</strong>: Whether the assessment score should be counted in the gradebook, not counted in the grade total, or counted as extra credit.</li>
<li><strong>Copy Options From</strong>: If you have other assessments in your course already, you can select to copy the assessment settings
from another assessment.</li>
<li><strong>Password</strong>: If specified, requires student to enter this password to access the assessment. Leave blank to require no password.</li>
<li><strong>Time Limit</strong>: The time limit, in minutes, for the test (0 for none). If the student exceeds the
time limit, their test will be recorded, and you can decide whether or not
to accept it in the gradebook detail. Partial minutes are possible using decimal values. If you check the
"Kick student out at timelimit" box, then the assessment will automatically finalize at the timelimit, and submission
attempts after the timelimit will be rejected.</li>
<li><strong>Display method</strong>:
<ul>
<li><strong>Full test at once</strong>: All questions are displayed on one page</li>
<li><strong>One question at a time</strong>: One question is shown at a time. Students
must complete the questions in the order presented</li>
<li><strong>Full test, submit one at time</strong>: Full test is displayed, but student submits
answer to one question at a time. Student can skip between questions.</li>
<li><strong>Skip around</strong>: Students are provided with a navigation bar and can
jump between questions and complete them in any order</li>
<li><strong>Embedded</strong>: Similar to "Full test, submit one at time", but all questions are
always active, and any one can be submitted at any time. Questions can be embedded into the
Intro/Instructions using [QUESTION #] tags.</li>
</ul></li>
<li><strong>Default points per problem</strong>: How many points each problem should be worth by default.
This can be changed for individual problems.</li>
<li><strong>Default attempts per problem</strong>: How many attempts a student should have at each problem by default.
This can be changed for individual problems. Enter 0 for unlimited attempts</li>
<li><strong>Reattempts different versions</strong>: Reattempting a problem will regenerate the question with new numbers. By default,
reattempts of problems receive the same version of the problem. This option does not make sense to use with Homework mode.</li>
<li><strong>Default penalty per missed attempt</strong>: What percentage of points possible a student should lose
for an incorrect attempt. This can be changed for individual problems. You can select a penalty for
each missed attempt, to start after a certain number of missed attempts, or specify a penalty for the last possible attempt only.</li>
<li><strong>Feedback method</strong>: What detail the students should see
<ul>
<li><strong>No scores shown</strong>: No scores, including the total, are shown to the student. If reattempts are allowed,
the student is forced to retake all questions (even ones they got right the first time). With this
mode, access to grade detail in the gradebook controlled by the Show Answers setting.</li>
<li><strong>Final score</strong>: Only final (total) score is shown at the end. If reattempts are allowed,
the student is forced to retake all questions (even ones they got right the first time). With this
mode, access to grade detail in the gradebook controlled by the Show Answers setting.</li>
<li><strong>Show score on each at end</strong>: At the end of the test, the student is shown their score on
each question. If reattempts are allowed, they are then allowed to go back and reattempt
problems.</li>
<li><strong>Show as submitted</strong>: As each question is submitted, the score is shown, and students are
offered a chance to reattempt the problem (if allowed). This method does not apply to the
"Full test at once" display method.</li>
<li><strong>Practice Test</strong>: Same as above, and the test can be regenerated (re-randomized) whenever the student wants.
Students are given an opportunity to try similar problems to
the one presented after completing each question (when not in Full test at once mode). Scores are cleared each time
the test is regenerated, and scores are not shown by default in the gradebook. Answers can be shown after some number
of attempts.</li>
<li><strong>Homework</strong>: Like "Show as submitted", but students are given an opportunity to attempt a similar
question if they miss a question. Doing so resets attempts for that question (reseting attempt penalty as well).
Also, show answers (see below) can be set to show answers during the homework after a number of attempts. This is
best used in conjunction with the attempt penalty.</li>
</ul></li>
<li><strong>Show Answers</strong>: When (if ever) students should be able to see answers.
<ul>
<li><strong>Practice Tests and Homework</strong>: For practice tests and homework, you can set this to never, after 0,1,3,4,or 5 attempts are made,
or after last attempt. There is also an after last attempt option that will allow students to jump directly to the answer.</li>
<li><strong>Other Tests</strong>: For other tests, you can set this to never, after the assessment due date, after the last last attempt (in Skip Around and Full
test submitted one at time modes only), or immediately.
Answers will be available in the gradebook review of a test. <em>Note</em>: Do not use the "Immediately" option if you
are allowing multiple attempts per problem. Doing so would allow a student to complete the test, view the answers, then
reenter the test (since more attempts are allowed) and put in the correct answers. Also be aware that if an assessment
is set to allow review mode, that answers will be available to students in review mode.</li>
</ul></li>
<li><strong>Show hints when available</strong>: Whether or not to show hints if the question has them defined</li>
<li><strong>Allow use of LatePasses</strong>: If you have granted LatePasses to students, this will allow use of them on this assessment</li>
<li><strong>Make hard to print</strong>: Makes the assessment harder to print, for in-class tests</li>
<li><strong>Shuffle item order</strong>: Randomizes the order in which questions are presented</li>
<li><strong>Gradebook Category</strong>: If you have created gradebook categories, you can assign the assessment to one of those categories.</li>
<li><strong>Count</strong>: Whether to count the assessment in the gradebook</li>
<li><strong>Allow tutors to edit</strong>: Whether tutors should be able to change students' scores on this assessment</li>
<li><strong>Minimum Score for Credit</strong>: A minimum score which must be acheived to receive credit for the assessment. Set to 0 to accept all scores.
If set and score is not met, gradebook will display "NC" (No Credit).</li>
<li><strong>Show based on another assessment</strong>: Use this to hide this assessment until a specific score is acheived on another
assessment. Provide a point value and select an assessment to use this feature. Set the assessment to "Don't Use" to not use
this feature</li>
<li><strong>All questions same random seed</strong>: Usually not needed. This is only need for a set of questions designed to work together using the same random values</li>
<li><strong>All students receive same version of questions</strong>: All students receive the same first version of questions. If in practice test or homework mode, when
students request a similar problem, different students will receive different versions of the questions.</li>
<li><strong>Penalty for questions done while in exception/LatePass</strong>: A percent penalty to take on all questions submitted after the original assignment due date while under a due date exception.</li>
<li><strong>Is group assessment?</strong>: Allows students to specify group members for the assignment. All group members will receive the same score for the assignment</li>
<li><strong>Show question categories?</strong>: If you plan to categorize questions and would like the categories displayed while the student is taking the test, you can
select that option here</li>
<li><strong>LTI access secret</strong>: An access code to place this assessment in a BasicLTI-compliant consumer. <a href="#lti">More info</a></li>
</ul>
<p><strong>Qustion-specific instructions</strong> (deprecated)</p>
<p><em>Note</em>: The following approach is deprecated, and no longer recommended. Using the [+Text] button on the Add/Remove Questions
page instead to insert text between questions.</p>
<p>In the Intro/Instructions box, you can make question-specific instructions by putting a tag of the form [Q #] or [Q #-#] before the
text specific to that question or range of questions. Here is an example:</p>
<div style="border: 1px solid #000;padding:8px;">
<p>This is the general info<p>
<p>[Q 1]</p>
<p>This text will display before question 1</p>
<p>[Q 3-4]</p>
<p>This text will display before questions 3 and 4. Since there was no tag for question 2, it will display
directly after question 1, with no associated intro text. Likewise, if there was a question 5, it would
display directly after question 4 with no associated intro text.</p>
</div> <!-- special -->
</div> <!-- h4 -->
<div class=h4>
<h4 id="addingquestionstoanassessment">Adding Questions to an Assessment</h4>
<p>You can add existing questions to an assessment by clicking the "Select Library" button
to choose libraries to search, then the "Search" button to
list potential questions. Leave the "Search" entry blank to list all questions in the libraries selected. The checkboxes
can be used to search in all libraries (not just the selected ones), list only questions you own, or exclude questions you've already
added to your assessment.</p>
From this list you can:
<ul>
<li>Use the checkboxes to select questions, then click the "Add (using defaults)"
button to add the questions. Adding this way will use the assessment default settings for
points, attempts allowed, and penalty per attempt. You can change these later by
clicking the "Change Settings" link.</li>
<li>Use the checkboxes to select questions, then click the "Add"
button to add the questions. Adding this way will allow you to override the default settings for
points, attempts allowed, and penalty per attempt if you wish, and add a question multiple times.</li>
<li>Choose "Add" from the Action dropdown. This will allow you to change the default
question settings</li>
<li>Choose "Use as template for New Question" from the Action dropdown. This will create a new question based
upon the existing question. This allows you to avoid rewriting a question from
scratch if a similar question exists</li>
<li>Click "Preview" to preview the question</li>
</ul>
<p>Alternatively, you can click the "Select from Assessments" button to choose questions from existing assessments.
In this mode, select the assessments you wish to pull questions from and click "Use these assessments". Then select
the questions you wish to use.</p>
Once added to the assessment you can:
<ul>
<li><strong>Reorder Questions</strong>: Using the number selectors next
to each question will allow you to rearrange the order of the questions. This is only useful if you
are not shuffling the question order</li>
<li><strong>Group Questions</strong>: Use the checkboxes to select questions, then press the "Group"
button to group questions. Then you can specify how many questions from the group you want
the system to randomly assign to students, and whether to make that selection with or without
replacement.</li>
<li><strong>Change Settings</strong>: Override the default settings for points, attempts allowed, and
penalty per attempt, if desired. When done for one question using the "Change Settings" option
in the Action dropdown there
are more settings you can edit than when using the checkboxes and the "Change Settings" button.</li>
<li><strong>Edit Code</strong>: In the Action Dropdown. Change the question code or wording, if it is your question</li>
<li><strong>View Code</strong>: In the Action Dropdown. View the question code, if it is not your question</li>
<li><strong>Edit Personal Copy</strong>: In the Action Dropdown, if it is not your question.
Creates a copy of the question, and will trade out the original question for your personal copy.</li>
<li><strong>Template</strong>: In the Action Dropdown. Create a new question based on this one.
The original will not be removed from the assessment.</li>
<li><strong>Remove from assessment</strong>: From the Action dropdown, or use the checkboxes and
press the "Remove" button. Removes the question(s) from the assessment. This does not
delete the question itself. </li>
</ul>
<div class=h5>
<h5 id="questionicons">Icons used in question listing</h5>
<ul class="nomark">
<li><img src="img/video_tiny.png" alt="video"> Has a video help (if <img src="img/cc.png" alt="cc"> is shown, the video has captions)</li>
<li><img src="img/html_tiny.png" alt="help resource"> Has help resource</li>
<li><img src="img/assess_tiny.png" alt="detailed solution"> Has a written solution</li>
<li><svg aria-label="show work" viewBox="0 0 24 24" width="14" height="14" stroke="black" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"></path><path d="M16.5 3.5a2.121 2.121 0 0 1 3 3L7 19l-4 1 1-4L16.5 3.5z"></path></svg>
Has "show work" enabled</li>
<li><svg aria-label="rubric" viewBox="0 0 24 24" width="14" height="14" stroke="black" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"></path><rect x="8" y="2" width="8" height="4" rx="1" ry="1"></rect></svg>
Has a rubric associated</li>
</ul>
</div>
<div class=h5>
<h5 id="questionintrotext">Adding an Introduction to a Question</h5>
<p>In addition to the assignment Introduction, each question can have an individual introduction. A common example is to display a video and then a related question as part of a video assignment.</p>
<p>To add a question introduction, click on <span style="font-weight: bold">+ Text</span> below the last question. An editable text box will appear where you can write instuctions or drag in a video link. After you edit your text, click the <span class="mce-i-save" style="font-family: tinymce; font-weight: bold"> Save All</span> icon in the editor toolbar. You can expand/collapse each question intro by clicking the <span class="icon-pencil" style="font-weight: bold"> Expand and Edit</span> or <span class="icon-shrink2" style="font-weight: bold"> Collapse</span> icons in the lower right of the question intro. Once you modify a question intro, you'll need to save it to collapse it.</p>
<p>When you click <span class="mce-i-save" style="font-family: tinymce; font-weight: bold"> Save All</span>, all changes you have made in any other question intros will also be saved. If you leave a question intro with unsaved changes, the Save All button will be highlighted.</p>
<p>A question intro can be displayed for multiple consecutive questions (except on Embedded assignments). In the <span style="font-weight: bold">Show for</span> selector, select the number of questions that question intro should be used for.</p>
<p>Embedded assignments can include page titles. Check the <span style="font-weight: bold">New Page</span> checkbox to add a page title. Then add your title in the editor and save it.</p>
<p>Below the last questions is an <span class="icon-enlarge2" style="font-weight: bold"> Expand All</span> button which will expand all the question intros. Click on any one to edit it.<p>
</div> <!-- h5 -->
<h5>After the Assessment has been Taken</h5>
<p>If students have taken the assessment, you will not be allowed to make as many changes to the assessment, as it
will mess up existing student attempts. If you need to change the assessment a lot, you can clear all student attempts.
Otherwise you can change individual question settings (be careful!) or edit the question if it's yours. If there is a problem with
the question, you modify it, and want to give students another chance on that question, you can clear all attempts on a single question
by clicking the "Clear Attempts" link here</p>
</div> <!-- h4 -->
<div class=h4>
<h4 id="addingnewquestions">Adding New Questions</h4>
Click the "Add New Question" to write a new question from scratch, then add it to
the assessment. See the help section on <a href="#writingquestions">Writing Questions</a> for help on writing
new questions
</div> <!-- h4 -->
<div class=h4>
<h4 id="categorizequestions">Categorizing Questions</h4>
<p>After adding questions to an assessment, click the "Categorize Questions" button to categorize the questions
in the assessment. Categorization allows you and students to see a score breakdown by question category.</p>
<p>In the question categorization page, you will see each question listed, followed by a category pull-down. By default, the
list contains the names of all libraries containing the question. If you'd like to define a category not in the lists, type in
the new category name in the box provided and click the "Add Category" button. The new category name will now appear
in the pull-down lists next to each question, and can be selected to assign the question to that category. When you are done, click
the "Record" button.</p>
</div> <!-- h4 -->
<div class=h4>
<h4 id="printcopies">Making Print Copies</h4>
<p>After adding questions to an assessment, click the "Create Print Version" to layout your assessment for printing.</p>
<p>On the first page, you will be asked what you would like to include in the test header. You will also be asked to enter your
print margins setup. These can be found by choosing "Page Setup" from the "File" menu in your browser. In the Page Setup you may
also wish to remove the default header and footer materials included in printouts by your browser. </p>
<p>On the next page, you will see alternating blue and green rectangles indicating the size of pages. Use the resizing buttons
next to each question to increase or decrease the space after each question until the questions fall nicely onto the pages. You
can use Print Preview in your browser to verify that the print layout looks correct. After you have completed the print layout,
you will be given the chance to specify additional print options. Longer questions, such as those with graphs, may appear cut
off in the print layout page. Be sure to resize those questions to show the entire question.</p>
<p>On the next page, select how many versions of the test you would like to generate, and whether you'd like to generate answer
keys. After hitting continue, you print version of the test will be displayed. Choose Print in your browser to print your tests.</p>
</div> <!-- h4 -->
</div> <!-- h3 -->
</div> <!-- h2 -->
<div class=h2>
<h2 id="quickview">Quick View</h2>
<p>Quick view is a condensed view of the course page. You can use it to quickly look over
your entire course. It is more useful for major editing</p>
<p>It allows easy drag-and-drop
reordering of course items. Changes will not be recorded until the "Record Changes" button
is pressed.</p>
<p>You can also quickly rename items by clicking on their titles and changing the text.