Optimized ISIR Configuration

Due to the significant changes to the ISIR in the 24/25 award year, Student Financial Aid is providing a more optimal approach for accessing ISIR fields within configuration.  This new approach can be utilized when accessing ISIR values anywhere ISIR configuration is used for 24/25 and future award years.

The new approach provides a new methods which will return a key value pair when accessing 24/25 ISIR fields. Instead of requiring a string, a type safe enum will be defined for each field. You will get the benefit of autocomplete functionality, delivered with JavaDoc, and the ability to leverage defined data types. For example, if a value is a date instead of a string being returned that needs to be parsed, it will return as a date.

Below we provide some examples of how the new configuration will work for 24/25 going forward.

Method Usage Example

get() 

Returns type-safe value or fails if no value is available

isirRecord.getField(IsirField.STUDENTFTIM_ADJUSTEDGROSSINCOME_FTI).get()     

returns [integer] 500

getAwardYear()

Returns an award year

 isirRecord.getField(IsirField.TXID_YEARINDICATOR).getAwardYear() 

returns [string] "2025"

getOr()

Returns a type-safe value or you can define a default value if no

value is available on the ISIR

isirRecord.getField(IsirField.TXID_RENEWALDATAUSED).getOr("No")  

returns [string] "No”

getOrNull() 

Returns type-safe value or null if no value is defined

isirRecord.getField(IsirField.FLAGS_STUDENTACTIVEDUTY).getOrNull()    

returns [null]

getRaw() 

Returns exact characters as they appear in the ISIR file

isirRecord.getField(IsirField.STUDENTFTIM_ADJUSTEDGROSSINCOME_FTI).getRaw() 

 returns [string] "500”

isFti()

Indicates if the field is flagged as FTI (requires CUI labeling)

isirRecord.getField(IsirField.STUDENTFTIM_ADJUSTEDGROSSINCOME_FTI).isFti()

returns [boolean] true

toString() 

Returns stringified representation of the value

Note for FTI fields the value will be returned with CUI labeling

isirRecord.getField(IsirField.STUDENTFTIM_ADJUSTEDGROSSINCOME_FTI).toString()

returns [string] "CUI//SP-TAX 500 CUI//SP-TAX"

getCorrection()

 Returns the correction flag for "Correction, Highlight, and Verify Flags" ISIR field

isirRecord.getField(IsirField.FLAGS_PARENTADJUSTEDGROSSINCOME).getOrNull().getCorrection()

returns [integer] 0

getHighlight()

 Returns the highlight flag for "Correction, Highlight, and Verify Flags" ISIR field

isirRecord.getField(IsirField.FLAGS_PARENTADJUSTEDGROSSINCOME).getOrNull().getHighlight()

returns [integer] 1

getVerify()

Returns the verify flag for "Correction, Highlight, and Verify Flags" ISIR field

isirRecord.getField(IsirField.FLAGS_PARENTADJUSTEDGROSSINCOME).getOrNull().getVerify()

returns [integer] 1

getAllFields()

Retrieves all ISIR field values

isirRecord.getAllFields(TXID_DEPENDENCYMODEL, TXID_SAI) 

Configuration that has direct access to the ISIR record:

Config with Direct Access to ISIR

When a script is being used and the ISIR award year is unknown (ie a 24/25 COA or NFF fund is being projected but the student may only have 23/24 ISIR):

Script is being used and the ISIR award year is unknown

24/25 ISIR Baseline Configuration Workbook Updates:

  • The following areas have been updated in Student Financial Aid baseline configuration to support the 24/25 ISIR
    • ISIR Regulatory Deadlines have been added to Regulatory Deadlines Configuration for 24/25
    • ISIR Verification Rules and Tracking Groups added for the 24/25 award year
    • ISIR Comment Codes Configuration added for 24/25 award year 
    • ISIR Reject Code Configuration added for 24/25 award year 
    • ISIR 24/25 Highlight Configuration added for 24/25 award year 
    • ISIR 24/25 Assumptions Configuration is no longer required 
      • To ensure you do not incorrectly configure assumptions for the 24/25 award year, we have added a validation error that will be thrown when a configuration is loaded with 24/25 Assumptions 
    • ISIR Discrepancy Configuration added for the 24/25 award year
    • ISIR MGMT Configuration added for the 24/25 award year 
    • DocMetaData Configuration added for the 24/25 award year
    • Documents Configuration added for the 24/25 award year
    • PJ Configuration added for the 24/25 award year

Steps to Enable

Use the Opt In UI to enable this feature. For instructions, refer to the Optional Uptake of New Features section of this document.

Offering: Student Financial Aid

  • Download your current Production environments baseline configuration
  • Determine what configuration changes are required to meet your business requirements
  • Update your configuration using the new methods described in this feature to access 24/25 ISIR fields within groovy script
    • Refer to Release 24A Release Notes on My Oracle Support (Doc ID 3000063.1) for the configuration scripting API  with further details of the new methods and new enums defined for each ISIR field
      • To access the defined enums and methods for the 24/25 ISIR fields, navigate to the Javadoc for SFP Scripting API, select com.oracle.sfp.scripting.api, and select IsirField<T> to view all of the ISIR fields
  • Apply 24/25 configuration updates to your test environment and confirm they are working as expected before promoting the configuration update to your production environment

Tips And Considerations

  • You will need to review every configuration that accesses ISIR fields to ensure that they are using the new methods to access the data for 24/25 Award Years and future
    • If you are attempting to access ISIR data using a method that is not supported for the award year, an application event error will be logged when the script executes.
  • When defining configuration that uses FTI values, you need to ensure to use one of the methods that outputs the FTI value without the CUI labelling
    • Example: using isirRecord.getField(IsirField.STUDENTFTIM_ADJUSTEDGROSSINCOME_FTI).getOrNull() will return the value as an integer without CUI labelling
  • In groovy scripts that need to access both 23/24 and 24/25 ISIR fields such as those used within packaging, you will need to identify the ISIR award year you are accessing within the script and conditionally use different methods to access the desired data.

Key Resources