Add New Download Field for Social Security Number/TIN Exceptions

Request No.

IA-2015-01

Requester

Gloria Zarabozo, Diablo Valley College

Target release

5.4.0 - March 31, 2016

Application(s)

OpenCCC Account, OpenCCC Edit Account
CCCApply Standard Application
BOG Fee Waiver Application
International Application

Environment(s)

Pilot / Production

Documentation

CCCApply Data Dictionary v1.0 (2016)
2016-2017 BOG Specification
CCCApply International Application v1.0 (2016) 

Change to Download File

Yes

Change to Logic

No

 

 


Problem Statement or Business Need

The purpose of the change is to identify if applicants that choose the "No SSN" checkbox are international students, nonresident aliens, or other legitimate exceptions, that may not have, and/or may not be required to have, an SSN/TIN at the time of account creation or while applying to a California Community College.

 


Proposed Solution

This is an approved change request by the CCCApply International App Advisory Committee. A new downloadable data field (Y/N checkbox question) has been added to the OpenCCC Account (Page 1) in the Social Security Number/TIN section for international students, nonresident aliens, and other legitimate exceptions, that do not have a Social Security Number or Taxpayer Identification Number at the time of account creation and/or applying to a California Community College. The new question and Yes/No checkbox data field will only appear if the user checks "Yes" to the preceeding question (SSN No), "I do not have a Social Security Number/Taxpayer Identification Number, or decline to provide one at this time."  If the new SSN Exceptions question and checkbox appears, the SSN Encouragement Language pop-up box will appear or not appear based on the user's answer to the new Exceptions question. If the user checks "Yes = I do not have a SSN/TIN because I am an international student, or other legitimate exception" THEN do not display the SSN Encouragement Language pop-up box and confirmation link. As long as the user has a check (= Yes) in the SSN Exceptions checkbox, the system will continue to not display the SSN Encouragement pop-up box even if the user edits their OpenCCC account settings in the future, If the user does not identify as an international student, or other legitimate exception, then display the SSN Encouragement Language pop-up box and maintain the existing validation specifications that are currently in place; "encouraging" the user to enter their SSN/TIN per the state and federal IRS regulations and penalties for students that do not provide this important information.


Requirements Summary

#Description
1Add a new conditional question and checkbox field (downloadable data field) to the Social Security Number question section on Page 1 of the OpenCCC Account Creation page (Account table).
2Make adjustments to the “SSN No” checkbox question, rules, and text; change onscreen question text to: International students, nonresident aliens, and other exceptions, may not have a Social Security Number (or Taxpayer Identification Number) and should check this box.
3This behavior should also happen in the Account Profile rules for SSN_No. If an "ssn_exception" applicant comes into the Account Mailing/Edit Account page from an Application and updates some of their profile account, do not display the "SSN Encouragement Language" when they finish and "continue".
4Add new data field to Download Client for Apply, BOG, IA and Account.
5Update the "SSN Encouragement" language pop-up box rules and validation based on the user's response to new "SSN Exception" checkbox field.

Change Specifications

Add new conditional question and downloadable data field to the Social Security Number section in the OpenCCC Account.

a. New downloadable data field: SSN Exception = <ssn_exception>

Data element: ssn_exception

Format: Checkbox question (1 = Yes/ 0 = No)

b. Conditional Checkbox Question & Text:

Only appears if the previous checkbox (SSN_No) is checked Yes (Yes = 1).

Question/prompt text reads:
<checkbox format>  I am an international student, nonresident alien, or other exception, and I do not have a Social Security Number or Taxpayer Identification Number.

Alternate text below the checkbox text - this only appears if the ssn_no checkbox is selected (Yes = 1).
"Check this box only if you are an international student, or other legitimate exception, and not required to have a Social Security Number or Taxpayer Identification Number."

c. Input Rules / Error Validation:

Optional user response.

If ssn_exception is checked (not empty), then DO NOT DISPLAY the SSN Encouragement Language pop-up box (upon clicking “Continue” to go to page 2 of Account Creation; or “Save and Return” to return to the application from the Edit Account Profile screen).

If ssn_exception is not checked (is empty), then DISPLAY the SSN Encouragement Language pop-up box and input rules (when applicant clicks “Continue” to go to page 2 of Account Creation, or “Save and Return” to go back to the application from Edit Account Profile screen) and enforce the input rules for the SSN Encouragement Language.

Update the “SSN No” data field question specifications

As follows:

a. Edit the additional question text that appears below the SSN No <ssn_no> checkbox question to remove the word “Undocumented” from the sentence. The new text reads as follows:

“International students, nonresident aliens, and other exceptions, may not have a Social Security Number (or Taxpayer Identification Number) and should check this box.”

b. Add new Condition 3 to the input rules to accommodate for the ssn_no field. New Condition 3 will read as follows:

“Condition 3: If ssn_no checkbox is not empty and the “ssn_exception” field is empty, then display the SSN Encouragement Language pop-up box (see language in ssn_no table), which prompts: “Enter SSN” to go back to change responses, or “I Decline” to acknowledge regulations and admonishments and to continue to Page 2: Account Creation:

*NOTE: This behavior should also happen in the Account Profile rules for SSN_No. If an "ssn_exception" applicant comes into the Account Mailing/Edit Account page from an Application and updates some of their profile account, do not display the "SSN Encouragement Language" when they finish and "continue".

Update the Download Client with SSN Exception date field

a.  See "Change to Download File" section for detailed specifications and "Update to the latest Download File Jar File" for latest .jar link.

Update the SSN Encouragement Language pop-up box rules and validation

 a.  Add new validation rules for the SSN Encouragement Language pop-up box based on the new SSN Exception data field response.

If user checks "Yes" - if ssn_exception box is not empty - then DO NOT display the SSN Encouragement Language pop-up box during Account Creation, or any time the user edits their Account profile (as long as the checkbox remains "not empty";

If user does not check the new checkbox - if ssn_exception IS EMPTY - the display the SSN Encouragement Language pop-up box and maintain the existing rules and validation that currently exist for users that do not provide a SSN/TIN at the time of Account Creation or any time the user edits their Account profile and does not provide their SSN/TIN or check the ssn_exception checkbox.
 

Top


Changes to Data Download File

This approved change request resulted in one new data field added to the OpenCCC Account/Edit Profile Account system. This field is downloadable and should be added to the college download file as described below.   

New Downloadable Data Field:  SSN Exception <ssn_exception>

Actions Required by College:  

  1. See below for information on updating to the latest Download Client Jar File. This step should be completed first before modifying your Download Format XML files.
  2. Modify your existing Download Format XML fiels to include the new SSN Exception data field listed above. NOTE: The SSN Exception field has been added to the OpenCCC Account, which means it will pass through the submitted application to your download file. To ensure this field will appear in each application download file (Standard Application, BOG Application, and International Application) all three Download Format XML files must be modified to include this data field.
  3. To ensure the new data field will download in the correct format, refer to the new SSN Exception data element specifications in the CCCApply Data Dictionary v.2016.1, as well as the Download Client User Guide.  
  4. This data field has been added to the OpenCCC Account table.
  5. Map the new SSN Exception <ssn_exception> data field to your student information system as required.


Update Your Download Client Jar Files

Step 1: To implement the new OpenCCCApply data fields and field values, you must first update your system to the version Java 7, then update to the latest version of the Download Client jar file
Information and instructions are detailed in the CCCApply Download Client User Guide v.2016.1 The Download Client manages all three CCCApply applications (Standard, BOG, and International) and you only need to update the one jar file for applications.

Step 2: Modify your Download Format XML file to include the new data fields..NOTE: The data value changes made to the Foster Youth Status and the Military Status fields, you must go through this update process; however there are no additional actions required to implement these changes.

NOTE: We recommend you test these changes in the PILOT environment before the Production release. Reference the Download Client User Guide for details.

**If you have been experiencing any issues with your downloads since the March 31 release, please see Download Client Solutions for March 2016  for troubleshooting information.

Top


Changes to Logic

There are no changes to the CCCApply residency algorithm logic based on this new data field or change to Account Creation/Edit Account Profile specifications. 


Supporting Documentation 

Below is additional documentation (i.e., CCCCO legal opinions, residency and/or education code citations, legislation citations, supplemental information, etc.) to be referenced in support of this change request. 

DescriptionFile or LinkType
Data DictionaryCCCApply Standard Application Data Dictionary v.2016.1Click the hyperlink to download the PDF
Data DictionaryCCCApply International Application Data Dictionary v.2016.1Click the hyperlink to download the PDF
User GuideCCCApply Download Client User Guide v.2016.1Link to User Guide page

User Guides

All the CCCApply User Guides have been updated with the latest code and changes from the March 2016 Annual Update and the new CCCApply International Application launch.
View the CCCApply User Guides in the Public Documentation space or visit CCCApply Project Site > Documentation > User Guides.

 

Top