IAT Documentation

This panel enables you to create generic notes for the item or stimulus; to submit requests for creating graphics, animations, or simulations for the item or stimulus; or, if you are a teacher enrolled in an item writing workshop, to sketch out an outline of an item or cluster. It also enables you to access all these documents.

You can access IAT documentation without editing it using the Action Center, as described in the View subsection of Action Center. This allows you to access multiple documents for multiple entities with fewer clicks.

When you submit requests, an email containing the details you provided is automatically sent out to the applicable team. An applicable team member can log in to ITS, create what you requested, and close the request.

To create a document or request:

  1. From the IAT Documentation panel, click Create Document. A new browser tab or window opens, displaying the IAT Document Editor.

  1. From the Document Type dropdown list, select the type of document you wish to create. The available options are as follows:

    • Generic Notes: This allows you to add generic notes.

    • Graphic Request: This allows you to send a request to CAI’s Graphics team. They will create a graphic.

    • Animation Request: This allows you to send a request to CAI’s Animation team. They will create an animation.

    • Simulation Request: This allows you to send a request to CAI’s Animation team. They will create a simulation.

    • Item Template: This allows a teacher to sketch out an outline of an item.

    • Cluster Template: This allows a teacher to sketch out an outline of a cluster.

  1. In the text fields, enter information.

    • If you’re submitting a graphic request, enter your request in the text field.

    • If you’re submitting an animation or simulation request, the following fields are available:

      • Charge Code: This mandatory field refers to the project to which the hours spent working on the request will be charged.

      • Content Lead: This mandatory field refers to the person responsible for reviewing the files after the request is completed.

      • Animation Title or Simulation Title: Mandatory fields.

      • Dimensions: These fields indicate the width and height in pixels or as a percentage (such as 250px or 75%) based on the item or stimulus layout.

      • Storyboard: This section enables you to upload a storyboard (in .pptx format) detailing the request.

      • Language(s) (simulation only): The language(s) of the simulation. You must select at least one.

      • Behavior (simulation only): The type of simulation.

        • Interactive: The simulation itself contains controls. The initial conditions are specified in the simulator input panel. The output panel contains a button that instructs the interactive simulation to send any output to the simulator.

        • Timeline: The simulation itself contains no controls. The simulation is started by a button in the simulator input panel. When it completes, it sends its output to the simulator. The timeline type also includes slideshows, in which a series of slides appears depending on the input. Each slide has a specified display time. Once the last slide appears, any output is returned to the simulator.

        • Static: The initial conditions are selected in the simulator input panel. The simulation displays a single image based on the inputs.

      • Links to Additional Online Resources: Links to other similar animations or simulations.

      • Links to Existing Graphics: Links to any existing graphics related to the request.

      • Inputs and Outputs (simulation only): The inputs and outputs of the simulation.

      • Short Description: A short description of the animation or simulation.

    • If you’re creating an item template, fill out the item information in the following fields:

      • Grade

      • Content Alignment

      • DOK/Difficulty/Target Level

      • Task Demand (if applicable)

      • Passage Title/Stim ID (if applicable)

      • Item

      • Scoring Assertion(s)

      • Exemplar

      • Rationales

      • Notes

    • If you’re creating a cluster template, fill out the cluster information in the following fields:

      • Grade

      • Performance Expectation

      • DOK

      • Stimulus

      • Task Statement

      • Interactions

      • Scoring Assertion(s)

      • Exemplar

      • Notes

  1. Click Save.

  2. In the window that appears, provide a name for your document if applicable, enter a comment if desired, and click Save. If you edit later, your comment will be replaced.

  3. When a confirmation message appears, notifying you that the document or request has been created, click OK to return to the IAT Document Editor page.

  4. Click Close to return to the View\Edit Item page. The document is listed in the IAT Documentation panel and additional action icons are displayed.

  1. Do one of the following:

    • To edit the document or request, click Edit button. The IAT Document Editor opens in a new browser tab or window, displaying your document or request. Make updates as necessary and save.

    • To delete the document or request, click Delete button. Click OK in the confirmation pop-up that appears.

  1. If you created a request type of document and you need to submit the request to the appropriate team, click Submit on the User Action column for the request. The button name varies depending on the team to which the request is being submitted. A Submit request window appears.

  1. In the Submit request window, do the following:

    1. Optional: Edit the Cc field to include anyone who should be copied on the request. Start typing to get a dropdown listing possible recipients.

    2. In the Due Date field, specify the date by which the item is due.

    3. Optional: To prioritize the request, mark the High Importance checkbox.

    4. In the Message field, enter a message for the recipient team if desired.

    5. Click Send. An email is sent to the appropriate team and the Submit request window closes.

  2. Review and mark the request as complete or request additional updates in the following manner:

    • For animation or simulation requests:

      1. Once the request is submitted, the User Action column displays “N/A”. After the animation team uploads the requested file, the View and Mark as Complete buttons are displayed in the User Action column.

      2. To review the request, click View. The Animation View or Simulation View window appears.

      3. View the animation or enter simulation parameters and click Play Simulation to play the simulation as applicable.

      4. To submit a review, do the following:

        1. In the Review Comments field, enter review comments.

        2. Next, from the Review Outcome dropdown list, select the desired review outcome.

        3. Click Submit Review.

          • If you reject the file, the request will again be sent to the relevant team.

          • If you approve the file, a notification is sent to the appropriate team. You cannot make any further edits to the request. If edits are required, a new request needs to be submitted.

      5. Once the request is completed and approved, you can add the animation or simulation file to your item and click Mark as Complete to mark the request as completed.

    • For graphic requests:

      1. Once the request is submitted, the User Action column displays the Edits Completed and Mark as Closed buttons.

      2. If you wish to update the original request or if you wish to request changes to the graphic created by the Graphics team:

        1. Click Edit button to make edits or enter review comments in the IAT Document Editor.

        2. Once you have updated the request, click Edits Completed to indicate that all further requests have been entered. The Complete request window appears.

        3. Enter the necessary information and click Send.

        4. Once you are satisfied with the graphic, click Mark as Closed to close the request.

        5. In the confirmation pop-up, click Confirm.

        6. Once the request is closed, the User Action column displays N/A. You can no longer edit the request. You can view the request by clicking View button.

  1. Once the request is marked completed, you can add the graphic, animation, or simulation file to your item.

  2. To create a new request, follow the steps above. The documents and requests are displayed in separate sections in the IAT Documentation panel.