| Info |
|---|
The user must have both CREATE and UPDATE for a given entity in order to use Mass Load. The USAS_MANAGER Role contains this access by default. USAS_Standard user also needs the permission of MODULE_IMPORT to see the menu option of Mass Load. |
The Mass Load program allows a district to import cash, expenditure and revenue data into the USAS-R from an outside source. This may include, but is not limited to, Excel, Access, Lotus and other third party software's that have the option to export data in a CSV (Comma Separated Values) format. The Mass Load program reads the data, imports and validates it, then writes it to the USAS file structures, thus eliminating manual entry. This might be useful for a district converting to USAS or for a district processing mass updates to varying fields.
All possible field values are outlined in the Miscellaneous notes section, under the Mass Load Criteria. Importable Entities and the required Object fields are outlined below under the Mass Load Criteria. To include additional Objects in the csv file, please see the Informational note under the Mass Load Criteria for how to obtain the additional Identifying fields used in the Header row of the csv file. Any records with fields that do not meeting meet the validity checks for USAS possible values validity checks are rejected. A message is written to the reports indicating iindicating what record included includes the invalid data will be written to the USASLOADERR report.
The CSV being read by the Mass Load options can include the fields in any order. The file must contain a header record which includes all the pre-defined field names (Req Column Desc) as the first record in the import file. The pre-defined field names are included in the Mass Load Criteria found in the Miscellaneous notes section of this chapter. Criteria found below. The remaining records in the file following the Header record will represent the data values being loaded.
The Custom Report Writer can be used to create the header file for you. To do so, Select the Object you you wish to import (i.e. Cash Account, Expenditure Account or Revenue Account). Once the object is selected, add the 'Identifying Fields' necessary to import the object. (These will be the required headers needed to correctly import the records. This list can be found below.) Generate the custom report using the Comma Separated Values-Field Names format.
From 
Once the header fields and data are populated on the csv file, from the Utilities menu,
- Click on 'Choose File' to select an outside file to import.
- Select an importable entity:
- Cash AccountDateTextField Definition
- Expenditure Account
- Revenue Account
- Click on Load.
...
| Info |
|---|
Each Object to be imported (i.e. Cash Account, Expenditure Account or Revenue Account) has to be created on a separate .CSV file. The The Identifying Fields below below have to be entered exactly how they are written. For more Identifying fields, please use the Custom Report Writer to find the field names needed for the data that will be mass loaded. 'Select Object' to open up the Property names and hover over the name with your mouse pointer: example. ('RegularItemConfig' Object - Employer Health Coverage identifying field would be employerHealthCoverage.CashAccount Object - the cash account dimensions are under 'Code'. code.fund would identify the fund code of the cash account. The appropriation account will be created for you when the first expenditure account is created. |
Example: To Mass Load Cash Account data - set up the custom report to pull the required Identifying Fields (Fund, SCC and description) and other desired Identifying fields that the user wants to load (i.e. dateRange.startDate or customFields.text.value). The csv file created will update the Cash Account to show the data loaded or specify the error on the USASLOADERR file.
Cash Account CSV Format
| Object to be Imported | Identifying Field Required |
|---|---|
| Fund | code.fund |
| Special Cost Center | code.scc |
Account Description | description |
Expenditure Account CSV Format
| Object to be Imported | Identifying Field Required |
|---|---|
| Fund | code.fund |
| Function | code.func |
| Object | code.object |
| Special Cost Center | code.scc |
| Subject | code.subject |
| Operational Unit | code.opu |
| Instructional Level | code.il |
| Job | code.job |
| Account Description | description |
Revenue Account CSV Format
| Object to be Imported | Identifying Field Required |
|---|---|
| Fund | code.fund |
| Receipt | code.receipt |
| Special Cost Center | code.scc |
| Subject | code.subject |
| Operational Unit | code.opu |
| Account Description | description |