Difference between revisions of "T2202A Data Generation"
(→Financial Aid) |
|||
Line 126: | Line 126: | ||
Aside from field values for these two tables, the other critical factor in production of the T4A and T2202A data files is that records exist at the time of exporting the data. That is, a fee or financial aid item must be retained in the system even if it has been discontinued. Details except for those identified as "critical" above may be changed, but the record must be present. This usually translates to keeping records for an additional academic year beyond discontinuance. | Aside from field values for these two tables, the other critical factor in production of the T4A and T2202A data files is that records exist at the time of exporting the data. That is, a fee or financial aid item must be retained in the system even if it has been discontinued. Details except for those identified as "critical" above may be changed, but the record must be present. This usually translates to keeping records for an additional academic year beyond discontinuance. | ||
+ | |||
+ | =T2202a.dat and T4a.dat field descriptions= | ||
+ | |||
+ | ==T2202A.Dat fields== | ||
+ | |||
+ | <table border> | ||
+ | <tr> | ||
+ | <td>Fieldname</td> | ||
+ | <td>Description</td> | ||
+ | <td>Example</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Namecust</td> | ||
+ | <td>Name</td> | ||
+ | <td>"CHARLES SCHULTZ" | ||
+ | </td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>textstre1 </td> | ||
+ | <td>Address </td> | ||
+ | <td>"99 BLUETREE CLOSE" </td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Namecity</td> | ||
+ | <td>City</td> | ||
+ | <td>"ST ALBERT"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Codestte</td> | ||
+ | <td>Province</td> | ||
+ | <td>"AB"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Codepstl</td> | ||
+ | <td>Postal Code</td> | ||
+ | <td>"T8N 2A1"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Codectry</td> | ||
+ | <td>Country</td> | ||
+ | <td>"CANADA"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Degree</td> | ||
+ | <td>Degree</td> | ||
+ | <td>"BA3 "</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>textopfl4</td> | ||
+ | <td>Student ID</td> | ||
+ | <td>"990137"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Wintot</td> | ||
+ | <td>Total Tuition for | ||
+ | Winter Term</td> | ||
+ | <td>"337.00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Winptmon</td> | ||
+ | <td>Part time months for | ||
+ | Winter Term</td> | ||
+ | <td>"04"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Winmon</td> | ||
+ | <td>Full time months for | ||
+ | Winter Term</td> | ||
+ | <td>"00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Sprtot</td> | ||
+ | <td>Total Tuition for | ||
+ | Spring/Summer Terms</td> | ||
+ | <td>"0.00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Sprptmon</td> | ||
+ | <td>Part time months for | ||
+ | Spring/Summer Terms</td> | ||
+ | <td>"00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Sprmon</td> | ||
+ | <td>Full time months for | ||
+ | Spring/Summer Terms</td> | ||
+ | <td>"00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Faltot</td> | ||
+ | <td>Total Tuition for Fall | ||
+ | Term</td> | ||
+ | <td>"720.00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Falptmon</td> | ||
+ | <td>Part time months for | ||
+ | Fall Term</td> | ||
+ | <td>"04"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Falmon</td> | ||
+ | <td>Full time months for | ||
+ | Fall Term</td> | ||
+ | <td>"00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>total99</td> | ||
+ | <td>Total Tuition for Year</td> | ||
+ | <td>"1057.00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Totalptmon</td> | ||
+ | <td>Total Part Time Months for Year</td> | ||
+ | <td>"08"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Totalmon</td> | ||
+ | <td>Total Full Time Months | ||
+ | for Year</td> | ||
+ | <td>"00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Sin</td> | ||
+ | <td>Social Insurance Number</td> | ||
+ | <td>"777888999"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Sortname</td> | ||
+ | <td>Name for alpha sort</td> | ||
+ | <td>"SCHULTZ CHARLES "</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Firstname</td> | ||
+ | <td>First name</td> | ||
+ | <td>"CHARLES"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Lastname</td> | ||
+ | <td>Surname</td> | ||
+ | <td>"SCHULTZ"</td> | ||
+ | </tr> | ||
+ | </table> | ||
+ | |||
+ | <u>A couple of notes:</u> | ||
+ | |||
+ | <u>Winter</u> is the first year term | ||
+ | listed when you extract the data. | ||
+ | |||
+ | <u>Spring/Summer</u> are all the terms | ||
+ | between the first year/term listed and the last. | ||
+ | |||
+ | <u>Fall</u> is the last term listed when | ||
+ | you extract the data. | ||
+ | |||
+ | ==T4A fields== | ||
+ | |||
+ | <table border> | ||
+ | <tr> | ||
+ | <td><b>Fieldname</b></td> | ||
+ | <td><b>Description</b></td> | ||
+ | <td><b>Example</b></td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>Namecust</td> | ||
+ | <td>Name</td> | ||
+ | <td>"ALEXANRA SMYTHE"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>textstre1</td> | ||
+ | <td>Address</td> | ||
+ | <td>"270 STORKDALE ROW"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>namecity</td> | ||
+ | <td>City</td> | ||
+ | <td>"LEDUC"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>codestte</td> | ||
+ | <td>Province</td> | ||
+ | <td>"AB"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>codepstl</td> | ||
+ | <td>Postal Code</td> | ||
+ | <td>"T4Q 2T9"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>codectry</td> | ||
+ | <td>Country</td> | ||
+ | <td>"CANADA"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>sin1</td> | ||
+ | <td>First 3 digits of Social | ||
+ | Insurance Number</td> | ||
+ | <td>"777"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>sin2</td> | ||
+ | <td>Second 3 digits of Social | ||
+ | Insurance Number</td> | ||
+ | <td>"888"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>sin3</td> | ||
+ | <td>Final 3 digits of Social | ||
+ | Insurance Number</td> | ||
+ | <td>"999"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>schtotal</td> | ||
+ | <td>Total scholarship amount</td> | ||
+ | <td>"2696.00"</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>sortname</td> | ||
+ | <td>Name for sorting</td> | ||
+ | <td>"SMYTHE ALEXANRA "</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>firstname</td> | ||
+ | <td>Firstname</td> | ||
+ | <td>"ALEXANRA "</td> | ||
+ | </tr> | ||
+ | <tr> | ||
+ | <td>lastname</td> | ||
+ | <td>Surname</td> | ||
+ | <td>"SMYTHE "</td> | ||
+ | </tr> | ||
+ | </table> |
Revision as of 05:12, 29 January 2008
There are several stages to the production of T2202 and T4A receipts. Preparation simply ensures that the necessary data is available and set up. Data Extraction creates files suitable for merge printing using Word. Validation attempts to reconcile the totals generated through this technique with totals from AccPac. Production is actually merge printing. A chart of the first three steps are cyclical; Validation may require returning to preparation and repeating data extraction.
Contents
Preparation
Preparation simply ensures that the necessary data is available and set up. This means having four specific areas of CrossRoad should be reviewed.
Genstats historical files
The term stats from CrossRoad are created in part by the generation of a file named Genstats. Existing records are stored in an historical file that is named by the convention GS[first two year digits from academic year][last two year digits from academic year][term number].dbf. So the file for term 1 of 2004/05 would be GS04051.DBF. These need to exist for every term in the calendar year being considered for this process.
Clear Accounts Receivable Records
This is in the Current Students window, under the menu entries Students | Global Processes | Accounts Receivable. The effect is to remove all a/r entries for specified terms from the current file and to place them into a history file. The history files are used for the data extraction. So this process must be complete for each year and term of the calendar year for which receipts are to be produced. These files are named following the convention INVL[first two digits of academic year][term number].dbf. So the file for term 1 of 2004/05 would be INVL041.DBF.
Financial Aid Receipt Checkbox
In the financial aid window there is a checkbox called Receipt. Those financial aid items that are to be receipted on a T4A by the institution should have this checked. Those that are not should not be checked. There is a verification process as data extraction occurs, so it is helpful to have a list of item codes handy.
QIFees Receipt Checkbox
Edited from Support Tables, the Receipt checkboxes should be checked for those items that are to be included in T2202A receipts.
Data Extraction
Data Extraction creates files suitable for merge printing using Word. This uses a command line utility called gent2202.exe. The usage is
Gent2202 [yearterms to be included]~[threshold for fulltime]~
The year/terms covered in ~ delimited list, followed by the full time threshold in credits. So, for example, the 1999 calendar year at King’s would use the command line:
Gent2202 1999/002:01:04:09.00~1999/003:05:05:03.00~2000/011:09:12:09.00~
Through the process, the operator is asked about including financial aid items, as well as entries from invlog that cannot be identified as fees or courses. Anything that is a tuition charge, a refund of tuition, and mandatory fees (as defined by CRA) should be included.
Financial Aid items identified should only those for which the institution is responsible to issue the receipt.
This process produces several files:
t2202inc.dbf | a/r entries included for T2202As. |
t2202exc.dbf | a/r entries included for T4As. |
months.dbf | Interim file that counts the number of credits per month |
t202inct.dbf | adds month counts for T2202 |
t202exct.dbf | adds month counts for T4A |
t202incz.dbf | Totals entries for T2202 |
t202excz.dbf | Totals entries for T4A |
T2202a.dat | Merge Print Data file for T2202As |
T4a.dat | Merge Print Data file for T4As. |
archives.lst | This file lists the students for whom data is generated but who are in archives. |
Validation
Validation attempts to reconcile the totals generated through this technique with totals from AccPac. There are two sets of totals: those for T2202As and those for T4As. Subtotals can be created in a number of ways, but Excel is quite a useful tool in this process. The two files that should be used are: t2202inc.dbf, t202exct.dbf.
For the first a simple sum is usually sufficient. With the second, a Pivot Table report can be helpful as it can give an award by award breakdown of totals.
NOTE: It is at this point that remedial action may need to be taken. There may be fees or financial aid items that were missed, or included when they should not have been. This can usually be remedied by changing flags in 1.3 and 1.4 and rerunning 2. In other cases entries may have been missed or students may have been omitted from historical genstats files. These can be corrected by using DBU to construct the necessary entries in the relevant files.
There may also be errors on the AccPac side that are pointed up through this process.
Once corrections have been made, validation should be repeated. Only when validation agrees should the next step be completed.
Production
Production is actually merge printing. This involves creating a Word template document that conforms to CRA specifications. This can take two forms: a document that prints the entire receipt (which must be approved by CRA) or a form which only prints the data onto preprinted laser forms. The latter prints much more quickly as the former must have the appropriate government logo printed three times for each page. This is a mail merge document to which the following files need to be attached: t2202a.dat and t4a.dat.
In the archive file containing this document, there are some other Microsoft Word files. One demonstrates the layout for T4A receipts in a merge document using the t4a.dat file imported into an Excel spreadsheet. The other is the layout documents for T2202As, but these have not yet been converted to merge print documents. There are two of these, one with the original form as a background image to assist with layout, the other with the background image removed.
Finally, the archives.lst file lists those students for whom records have been produced. Presumably these cannot be distributed by delivery to students on campus and so need to be pulled after printing.
Fields in QIFEES and Financial Aid Section and Effect on T4A/T2202A Production.
Fee Table
This table is accessed through support tables.
Field | Field Name | Type | Width | Dec. | Description |
1 | FEENAME | Character | 14 | Name == AccPac ItemCode. | |
2 | FEETYPE | Character | 1 | Type of Fee (X = fixed fee, C = per credit fee, R = per course fee, F = by FT/PT status) | |
3 | FEEAMOUNT | Numeric | 10 | 3 | Amount of fee |
4 | FEECOND | Character | 50 | Conditions for preselecting fee. | |
5 | FEEFT | Numeric | 10 | 2 | Fee for Full-Time students (if FeeType is F) |
6 | FEEPT | Numeric | 10 | 2 | Fee for Part-Time students (if FeeType is F) |
7 | FEEDESC | Character | 45 | Fee Description (long name in drop lists) | |
8 | FEEMAXIMUM | Numeric | 10 | 2 | Maximum fee amount charged (leave 0.00 for no maximum) |
9 | FEEMINIMUM | Numeric | 10 | 2 | Minimum fee amount charged (leave 0.00 for no minimum) |
10 | RECEIPT | Logical | 1 | Is this fee included on a T2202A?v |
The two items, then, that are critical to T2202A production are:
- field number 1, which matches the itemcode used in the A/R section as well as that used in AccPac.
- field number 10, which identifies fees which are to be included on the T2202A.
Financial Aid
This is accessed through the Financial Aid section.
Field | Field Name | Screen Name | Type | Width | Dec. | Description |
1 | FINAIDID | Aid Id: | Numeric | 5 | Numeric internal id | |
2 | NAME | Name: | Character | 60 | Name of Aid | |
3 | ACADEMIC | Academic | Logical | 1 | Is an academic award? | |
4 | NEED | Need | Logical | 1 | Is a need based award? | |
5 | OTHERCOND | Other Conditions: | Character | 100 | Other data used in award (fields from other tables) | |
6 | SEQUENCE | Reporting Sequence: | Character | 3 | Report Order Sequence | |
7 | HSORPS | Prefer High School GPA | Logical | 1 | Preferred average | |
8 | AMOUNT | Amount: | Numeric | 10 | 2 | Amount (or percentage if set below) |
9 | PCTPERTERM | % applied per term | Numeric | 6 | 2 | % of award applied per term |
10 | ITEMCODE | Item Code: | Character | 14 | Item code for AccPac | |
11 | AMTISPCT | Amount is % | Logical | 1 | If true, the amount is a % of tuition | |
12 | VALIDTERMS | Valid terms: | Character | 10 | Number of terms this can be applied to | |
13 | SCHBURAWAR | Unlabeled drop box | Character | 1 | Scholarship = S, Bursary = B, Award = A | |
14 | INTERNAL | Internal | Logical | 1 | True = Internal, False = External | |
15 | RECEIPT | Receipt | Logical | 1 | Include in T4A Receipts |
T4A critical items are Field number 10, itemcode, which matches the itemcode used in the A/R section as well as that used in AccPac. Field number 15, which determines whether this is included in the T4A data.
Aside from field values for these two tables, the other critical factor in production of the T4A and T2202A data files is that records exist at the time of exporting the data. That is, a fee or financial aid item must be retained in the system even if it has been discontinued. Details except for those identified as "critical" above may be changed, but the record must be present. This usually translates to keeping records for an additional academic year beyond discontinuance.
T2202a.dat and T4a.dat field descriptions
T2202A.Dat fields
Fieldname | Description | Example |
Namecust | Name | "CHARLES SCHULTZ" |
textstre1 | Address | "99 BLUETREE CLOSE" |
Namecity | City | "ST ALBERT" |
Codestte | Province | "AB" |
Codepstl | Postal Code | "T8N 2A1" |
Codectry | Country | "CANADA" |
Degree | Degree | "BA3 " |
textopfl4 | Student ID | "990137" |
Wintot | Total Tuition for Winter Term | "337.00" |
Winptmon | Part time months for Winter Term | "04" |
Winmon | Full time months for Winter Term | "00" |
Sprtot | Total Tuition for Spring/Summer Terms | "0.00" |
Sprptmon | Part time months for Spring/Summer Terms | "00" |
Sprmon | Full time months for Spring/Summer Terms | "00" |
Faltot | Total Tuition for Fall Term | "720.00" |
Falptmon | Part time months for Fall Term | "04" |
Falmon | Full time months for Fall Term | "00" |
total99 | Total Tuition for Year | "1057.00" |
Totalptmon | Total Part Time Months for Year | "08" |
Totalmon | Total Full Time Months for Year | "00" |
Sin | Social Insurance Number | "777888999" |
Sortname | Name for alpha sort | "SCHULTZ CHARLES " |
Firstname | First name | "CHARLES" |
Lastname | Surname | "SCHULTZ" |
A couple of notes:
Winter is the first year term listed when you extract the data.
Spring/Summer are all the terms between the first year/term listed and the last.
Fall is the last term listed when you extract the data.
T4A fields
Fieldname | Description | Example |
Namecust | Name | "ALEXANRA SMYTHE" |
textstre1 | Address | "270 STORKDALE ROW" |
namecity | City | "LEDUC" |
codestte | Province | "AB" |
codepstl | Postal Code | "T4Q 2T9" |
codectry | Country | "CANADA" |
sin1 | First 3 digits of Social Insurance Number | "777" |
sin2 | Second 3 digits of Social Insurance Number | "888" |
sin3 | Final 3 digits of Social Insurance Number | "999" |
schtotal | Total scholarship amount | "2696.00" |
sortname | Name for sorting | "SMYTHE ALEXANRA " |
firstname | Firstname | "ALEXANRA " |
lastname | Surname | "SMYTHE " |