The IRIS takes a folder of Smarter Balanced assessment items as input, and loads them in an iframe. A compiled WAR file is hosted in the Smarter Balanced artifactory. IRiS version 1.0.3 can be downloaded here.
This project is licensed under the Mozilla Public License Version 2.0.
We would be happy to receive feedback on its capabilities, problems, or future enhancements:
- For general questions or discussions, please use the Forum
- Use the Issues link to file bugs or enhancement requests.
- Feel free to Fork this project and develop your changes!
IRIS uses the iris/src/main/resources/settings-mysql.xml for application configuration.
The iris.ContentPath variable in iris/src/main/resources/settings-mysql.xml specifies the directory containing the Smarter Balanced assessment items.
This must be set to a valid directory or the application will not run.
The content path in the precompiled IRIS WAR file is /home/tomcat7/content.
This must be changed if you wish to host the content in a different directory.
IRIS requires a 25 character alphanumeric encryption key set in Apache Tomcat's conf/context.xml.
<Parameter name="tds.iris.EncryptionKey" override="false" value="24 characters alphanumeric Encryption key" />- Java 7
- Apache Tomcat 7 or newer
Deploy IRIS to Tomcat by placing the WAR file in the Tomcat webapps directory, then restarting Tomcat.
Navigate to {irisRootURL}/IrisPages/sample.xhtml.
To specify which item and accessibility options to load you must give the IRIS a JSON token with the following format.
{
"items": [{
"response": "",
"id": "I-ItemBank-ItemKey"
}],
"accommodations": [{
"type": "AccessibilityFamily",
"codes": ["AccessibilityCode1", "AccessibilityCode2"]
}
]
}For example, to load an item with bank 187 and key 856, with color contrast and print size accessibility options.
{
"items": [{
"response": "",
"id": "I-187-856"
}],
"accommodations": [{
"type": "ColorContrast",
"codes": ["TDS_CCYellowB"]
},{
"type": "Print Size",
"codes": ["TDS_PS_L4"]
}
]
}- Java 7
- Apache Maven
IRIS has a compile time dependency on several SmarterApp projects. You will need to configure Maven to fetch these from an artifactory, or build and install them locally using Maven. The SmarterApp artifactory is located at https://airdev.artifactoryonline.com/airdev/. If you want to build and install them locally they can be downloaded from SmarterApp's GitHub.
The SmarterApp managed compile time dependencies are:
- student
- item-renderer
- shared-tr-api
- tds-itemselection-aironline
- shared-web
- shared-logging
- shared-threading
- shared-test
- tds-dll-api
- tds-dll-mssql
- tds-dll-mysql
- ResourceBundler
- tds-itemselection-common
- item-scoring-api
- item-scoring-engine
- testscoring
- spellcheck