Data Import/Export Guide - AimsWeb+ Help Documentation | Obtain the Templates
Obtain the Templates
Your file must be in the data format needed to import the data. You may use the sample templates provided within aimswebPlus.
If you use the template, enter data on the Template tab, using the instructions on the
Layout and Conditional Req tabs (and for the User template, the RoleCode tab).
If you use a file that you have previously exported using Manage > Export or created from another source (such as a school file), refer to this guide and the templates for the newest information and format requirements.
To download the templates, use any of these locations:
• In aimswebPlus, click Manage and select Import. Click New Import, select the type of import to perform, and click Get Template File.
• In the aimswebPlus Help, in the Contents go to the Account/District/School Managers and select Import Templates and User Guide.
• In the aimswebPlus Help, see the Manage > Import topic.
Your browser controls how and where the file is downloaded. The template is a read-only Excel file. Save the file in any folder, and then copy it to enable editing your copy. It is useful to keep the original for reference.
Alternately, your school may have a method for creating import files. Your files must be in the same format as our template.
If this is not your initial import, you may export roster or user data, update the exported files as needed, and import the files.
The Roster template is used to create the account structure (districts, schools, and classes) by importing teachers and students, updating student demographics, and rostering students into classes.
Note: Import the Roster first if you are setting up your account for the first time or preparing for a new school year.
Demographics are assigned to the student and will apply to all scores in the file. Changing a demographic value via Roster import will not retroactively update scores that already exist in your account and are not included in the file to be edited by the import.
Use this template to add new users after setting up the account. This import will not update or edit information for existing users.
Font Color Meanings
The font colors indicate whether data is required, conditionally required, or optional.
Font Color Meanings
Red font Required
The information must be provided in your file.
The information is needed for certain conditions only (see the Description column and
Conditional Req Fields tab for details). The system checks to see if the item is entered when needed and records a message if missing. The column header is always required, even if none of the individual rows require data in that column.
Fields labeled Not Required do not require data. The column header is always required, even if none of the individual rows contain data in that column. If data is not supplied for some of these optional fields, you cannot report on them. For example: If you want to report TeacherPhone, you must supply that information. Optional data may be added later via the interface.
The tabs specify the data columns and requirements for each type of import. There are three tabs in the Roster template, and four in the User template.
• The Layout and Conditional Req Fields tabs contain guidelines and instructions.
• The Template tab contains headers only. Enter your data in this tab. You need to be viewing this tab when you save the spreadsheet as a text file.
• The UserRoles tab is only in the User template. To assign a user role, enter the code that corresponds to the desired role.
Templates are dated on the Layout tab with the date they were last updated. The template dates do not correspond with the application release dates. The templates are updated separately, so will seldom have the same dates. If you need to call support, it is helpful to have the template date available.
The Layout tab describes whether the data in a column is conditional, required, or not required, when the data is required, and the valid values for the data.
Column Name Lists the columns in the order they appear on the Template tab.
If you create your own file without using the template, ensure that the
Column names match the spelling and capitalization shown in the template, including no spaces.
Req Rule Data for the associated column is
Required , Conditionally Required
Required (ie, Optional).
Each requirement rule only applies to the data. The column headers are always required in the file.
If a rule is appropriate to the column, the rule shows where the data must be unique. For example, a ClassUID (unique identifier) is only required to be unique within a school while a DistrictUID must be unique across the entire account.
These rules are enforced within the import, and data that does not meet the conditions will result in a failed import file.
This shows the acceptable values for each column.
The values in your file must match the values listed here. Any deviation will result in a failed import file or rejected row. For example, if the valid values are <blank>, 0 and 1, but any other text is entered, the import will not process.
Note: in most cases <blank> (a field left blank) means "do not change the existing value in the database for this record."
This shows any special rules about the column data or explanation for codes used. For example, in the Roster template, the demographics corresponding to each code display in this column.
Conditional Req Field Tab
The following figure is a shortened view of a sample tab.
Conditional Req Field Tab
Column Name Identifies the columns on the Layout tab that are Conditionally Required.
Condition Shows the required conditions and dependencies.
Role Codes Tab (User Template only)
The User Roles tab is specific to the User Template and lists all of the available roles within aimswebPlus. Enter the User Role exactly as it displays in the template.
Role Codes Tab
Valid Role Code column
Lists the role code to be used when you add users. The code is the role name in this exact format, for example: ACCOUNT_MANAGER.
Identifies the role permissions.
The Template tab contains the import data, and will be saved as the import file. When you are ready to save you must be on the Template tab.
* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project