Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

...

This UAT Guide is designed to help colleges understand the changes made to the new CCCApply Race & Ethnicity section changes, in CCCApply implemented in December 2018. 

The following step-by-step guide will help college staff better understand the changes and perform user testing for adding the new (optional) Colleges that want to start downloading the new ethnicity-ancestry responses immediately following the release, should use this guide to add the new data field to their CCCApply Standard & International download files and begin collecting the new data following the Pilot download file and run a test download job in preparation of the Production release.  For release information, please see the Release 6.3.0 release (December 7, 2018). Summary Notes.

Note

For detailed information on the approved change request and corresponding tech specifications, see 2018-18R: New Race & Ethnicity Implementation 2018.
For detailed information on the background information and research and proposal behind this implementation proposal, see Ethnicity-Ancestry Expansion Proposal
For all release notes, see Release 6.3.0 Summary Notes

Table of Contents

New Race Ethnicity Full Data Field

...


...

UAT GOALS & OBJECTIVES 

The new Race & Ethnicity Implementation is made up of user interface changes (new layout) and a lot of new race and ethnicity response/value checkboxes that display based on the user's selections.

The new values are collected in one new data field ('race_ethnic_full') has been added to the database to capture all the new race group and ethnicity values; however, we have purposely designed this addition to be seamlessly backwards compatible, which means the field is optional and colleges do not need to make any adjustments to their downloads unless they opt to add the new data field when they are ready

UAT GOALS & OBJECTIVES 


User Acceptance Testing (UAT) Step-by-Step Guides help colleges prepare for new features or changes to the CCCApply applications. The new Race & Ethnicity implementation of 2018 includes a changes to the user interface and a new data field to capture all the new race groups and ethnicities that are added to the database. Reminder, no changes were made to the existing data fields; therefore colleges are not required to take any action relative to the new implementation. The objectives for the Race & Ethnicity 2018 user acceptance testing are:The objectives for college user testing are:  

...

Info
Colleges that want to collect the new data should add the new Race Ethnicity Full data field to their download files and run (replace) the new transfer-client.jar (v.6.3.0.


Participating Colleges

User College user acceptance testing will be supported across the three main SIS systems. Support is also available for colleges with custom SIS systems.  Colleges are being solicited to volunteer for this effortColleges outreach will begin on Monday, November 19, to solicit volunteer IT and Admissions staff members to conduct testing. Reminder, no changes were made to the existing data fields; therefore colleges are not required to take any action relative to the new implementation.

...

UAT SUCCESS CRITERIA

For the new Race & Ethnicity changesImplementation 2018, our the goals for pre-release user testing are:

  • Colleges can continue to download the legacy data fields and formats without taking any action or making any changes to their files for the following fields:
    • hispanic
    • race_group
    • race_ethnic    (CCCApply Standard)
    • race_ethnicity (International) 
  • Colleges are able to add the new data field to their Format XML files, update the transfer-client.jar file (v.6.3.0), and download the new field with the expanded data:
    • race_ethnic_full
  • Colleges are able to get the legacy data fields and formats AND the new field/data 
  • Colleges can still comply with MIS data requirements successfully with the new Race & Ethnicity implementation in place.


Note

All Changes Are Backwards Compatible - No Actions Required: All the front-end changes (user interface upgrades, race/ethnicity layout) and all back-end changes (194 new race/ethnicity response options and new optional "Full" data field) being implemented in this release are designed to be seamlessly backwards compatible.  Admissions, Financial Aid, and IT staff can rest assured there is no action required by the colleges in this release.


...

UAT STEPS

Follow the steps below for successful user acceptance testing:  add the new Race & Ethnicity Full data field to your CCCApply Format Definitions XML file for both Pilot and Production environments.

...

  • Feedback should be categorized as bugs and enhancements. Only Severity 1 issues (issues that prevent critical business functions from being accomplished) will be considered as release blockers.
  • Reporting: User feedback should be noted in the result section. The following criteria should be followed and documented:
    • Any identified bugs with severity and priority 
    • Enhancement requests with priority identified



...

Data Field Information  

See recommended changes for updating your SuperGlue files with the new Race & Ethnicity data fields (2018).  

Data Field NameTypeData ElementFormat / LengthDownloadableReport Center / Admin RulesApplication
Hispanic / LatinoExisting, unchangedhispanicboolean Yes / No / XYesComing SoonCCCApply Standard & International

Race Group

Existing, unchanged

race_group

CSV string

YesComing SoonCCCApply Standard & International

Race Ethnicity

Existing, unchanged

race_ethnic

bpchar, 22 

Yes Coming SoonCCCApply Standard Only

Race Ethnicity

Existing, unchanged

race_ethnicity

bpchar, 22 

Yes Coming SoonCCCApply International Only

Race Ethnicity Full

NEW 

race_ethnic_full

CSV string, no spaces

Yes  (Must be added)Coming SoonCCCApply Standard & International

Race Ethnicity Full

NEW - SuperGlue

raceEthnicFull

CSV string

Yes (Must be added)Coming SoonCCCApply Standard & International

Hispanic

Data Field:  hispanic
Data Element:
<hispanic>

Notes: No changes, this field is a boolean true/false field that continues to work as in previous version

Example Format: boolean (true/false/null)

Race Group

Data Element: <race_group>

Notes: No changes, this field was intentionally left unchanged

Example Format: Apply: "04, 05, 08, 09, 14, 15, 17, 19, 20, 21", International:  "04,05,08,09,14,15,17,19,20,21" (note lack of spaces for Intl)

Maximum Expected Width: 78 characters (unchanged) (20 * 2 character long values + 18 commas + 18 spaces  + 2 surrounding quote marks for CSV delimiting in the output format)

Race Ethnicity

Data Element: <race_ethnic> (Apply) /  <race_ethnicity> (International)

NotesNo changes, this field was intentionally left unchanged

Example Format: YNYNNNNYNNNNNNNNNYNNN

Maximum Expected Width: 22 characters (unchanged) (22 character long string)

Race Ethnicity Full

Data Element: <race_ethnic_full>

Notes: race_ethnic_full is a new field that will store the CSV separated values for all the ethnicity section selections for both the higher level ethnic groups and the associated sub groups as listed above in the chart.

Example Format: "100,101,117,118,200,205,08,09,500,15,600,601,17,19,602,700,701,713,800,802,803"

Maximum Expected Width: 804 characters (201 * 3 character long values + 199 commas + 2 surrounding quote marks for CSV delimiting in the output format)


College Adaptor (SuperGlue) Data Element

For SuperGlue colleges, the new race_ethnic_full data element is called "raceEthnicFull"


...

UPDATING YOUR DOWNLOAD FILES

To download all the new Race & Ethnicity Full response values in your existing CCCApply download files, you must add the new <race_ethnic_full> field and update the (transfer-client.jar) file for this release (Release 6.3.0).  

Warning

Please be sure to backup your files before downloading new ones.

Update the Pilot Download Client Jar File

We recommend adding the fields and updating the Download Client Transfer file in the Pilot environment first before updating your Production Download Client with these fields. 

In your installed Pilot Download Client directory, replace the following files:

    • Replace transfer-client.jar (V6.3) with: transfer-client-V3.jar

Follow the instructions in the Pilot CCCApply Download Client User Guide.


Technical specifications for the Race Ethnicity Full data field can be found in: 

Change Specification:  2018-18R: New Race & Ethnicity Implementation 2018

Data Dictionaries:  CCCApply Standard Application Data Dictionary v.2018.2 

UAT: Race & Ethnicity Implementation 2018


Update the Production Download Client Jar File

To update your Download Client Transfer file for the Production environment, the process is the same as the Pilot environment update. The same jar file is used for both environment. 

In your installed Production Download Client directory, replace the following files:

    • Replace transfer-client.jar (V6.3.0) with: transfer-client-V3.jar

Follow the instructions in the CCCApply Download Client User Guide.

Technical data element specifications for the Race & Ethnicity data fields are listed in the CCCApply Standard Application Data Dictionary V.2018.2