Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
exam_document_build [2017/03/16 14:21]
steveclarke [Publish Options]
exam_document_build [2017/03/21 11:10] (current)
steveclarke [Publish Options]
Line 33: Line 33:
 ^Field^Description^ ^Field^Description^
 |Language|Determines the language of the document being printed.| |Language|Determines the language of the document being printed.|
-|Output Format|CE supports PDF, DOCX (open document) and Secure Exam Output. ​ NoteSecure Exam Output requires SecureExam software. ​FIXME link+|Output Format|CE supports PDF, DOCX (open document) and Secure Exam Output. ​ NoteSecure Exam Output requires SecureExam software. ​See [[start#​Other Software|SecureExam]]
-|Exam Instance|For Exams with multiple Instances, the Instance must be selected so Document Build knows which sequence to order the Items in.|+|Exam Instance|For Exams with multiple ​[[stats_terminology#​instance|Instances]], the Instance must be selected so Document Build knows which sequence to order the Items in.|
 |Water Mark|A text field to include a simple Water Mark on each page of the document.| |Water Mark|A text field to include a simple Water Mark on each page of the document.|
 |Item Numbering|Controls how Items are numbered in the document formats are: 1., 1), A., A), a., a), i., i)| |Item Numbering|Controls how Items are numbered in the document formats are: 1., 1), A., A), a., a), i., i)|
Line 50: Line 50:
 |Page Break after Item|If checked a page break will occur in the document after each item, rendering one Item per page.| |Page Break after Item|If checked a page break will occur in the document after each item, rendering one Item per page.|
  
-Note: If Track Changes ​FIXME link is implemented there is an additional option as to whether to Include Track Changes or render the Item Text as if all changes have been accepted.+Note: If [[concepts#​track changes|Track Changes]] is implemented there is an additional option as to whether to Include Track Changes or render the Item Text as if all changes have been accepted.
  
  
Line 58: Line 58:
 ==== Templates ==== ==== Templates ====
 {{:​buildnewdocumenttemplates.png?​600|}} {{:​buildnewdocumenttemplates.png?​600|}}
 +
 +The document build process uses many templates to control the appearance of the various objects (cover pages, end pages, section titles, item text, option text, meta data, etc.).  ​
 +
 +=== Templates ===
 +^Template^Description^
 +|Exam Template|Cover page for the Exam document. ​ This page or pages is added as to the start of the document. ​ This template may contain proprietary tags.|
 +|Exam End Template|End page for the Exam document. ​ This page or pages is added as to the end of the document.|
 +|Item Template|This template is used for controlling how the Items are rendered. ​ Font, margins, line spacing, placement of elements are all controlled by this template. ​ This template contains proprietary tags.|
 +|Option Template|This template is used for controlling how the options of Items are rendered. ​ Font, margins, line spacing, placement of elements are all controlled by this template. ​ This template contains proprietary tags.|
 +|Item Fields Template|When fields are Included on a document (see Include Fields below) this template is used to control the format of how they appear. ​ This template contains proprietary tags.|
 +|Meta Template|When [[item_edit_meta|meta fields]] are Included on a document (see Include Fields below) this template is used to control the format of how they appear. ​ This template contains proprietary tags.|
 +|Stats Template|When Stats fields are Included on a document (see Include Fields below) this template is used to control the format of how they appear. ​ This template contains proprietary tags.|
 +|Section Template|This template controls how Section labels at the start of each Section are formatted. ​ This template contains proprietary tags.|
 +|Other Text Template|This template controls how other text rendered in the document appears. ​ This text includes messages about repeated Attachments,​ tables of content, etc.|
 +
 +=== Template Files ===
 +These templates are either HTML files or Word documents that are stored within the {CE}\Components\IW\APP_Data\Templates\{Language}\ folders on the CE server. ​ Placing files into these folders will add them to the respective Template drop down lists.
 +
 +[[start|TDA]] can assist with customizing or modifying templates as the formatting is proprietary to the Item Writing Application.
 +
  
 ==== Include Fields ==== ==== Include Fields ====
 {{:​buildnewdocumentincludefields.png?​600|}} {{:​buildnewdocumentincludefields.png?​600|}}
  
 +Include fields is used to include additional information about the Exam or the Items and the objects they are linked to (Authors, Competencies,​ References, Copyrights, etc.)  Checking any field will have that field appear inline with the Exam or the respective Item during document build.  ​
 +
 +Most fields are formatted using the Item Fields Template (see above). ​ [[item_edit_meta|Rich text or (meta)]] fields linked to the Item are controlled using the Meta Template (see above). ​ Stats fields are controlled using the Stats Template (see above).
 +
 +=== Stats ===
 +To Include Statistical data, a Stats Set must be selected. ​ Exams can have multiple [[stats_concepts#​stats results set|Stats Results sets]] calculated for them.  Each Stats Results set is based on the Sessions of registrants that were calculated. ​ To view a particular Stats Results set, the Stats results set must be selected. ​ To do this, click the **Select Stats** button.  ​
 +
 +This will open a Stats Selector. ​ Here, the user can use the Stats Selector grid to filter to the Stats Result they wish to view.  For more on grid navigation, click [[general_navigation_grids|here]]. ​ Once they select a Stats Result set, click the **Select** button.
 +
 +=== Stats Fields ===
 +There are two types of Stats fields that can be added to a document. ​ The first type is the specific field. ​ Examples include: Difficulty, Point Biserial Exam, Value High.  Unless otherwise specified each field is a specific field. ​ Click [[stats_item|here]] for more on these fields. ​ Other stats listing are below.
 +
 +**Top 50/Bottom 50 Distribution**
 +{{:​buildnewdocumenttop50.png?​600|}}
 +
 +For each option and all options combined (Total), displays: ​
 +  * the count of candidates who scored in the bottom 50% of the Exam who selected the option
 +  * the count of candidates who scored in the top 50% of the Exam who selected the option
 +  * total count of candidate who selected the option.
 +
 +**Distractor Analysis**
 +{{:​buildnewdocumentdistractoranalysis.png?​600|}}
  
 +For each option and all options combined (Total), displays: ​
 +  * the count of candidates who scored in the top 27%of the Exam who selected the option
 +  * the count of candidates who scored in the middle 46% of the Exam who selected the option
 +  * the count of candidates who scored in the bottom 27% of the Exam who selected the option
 +  * total count of candidate who selected the option.
 +  * The point biserial of candidates who selected this option.