Maintenance - ALN (formerly CFDA)

Overview

The ALN (formerly CFDA) maintenance table is used to establish and maintain numeric codes and textual description values for the Assistance Listing Number (ALN)(formerly Catalog of Federal Domestic Assistance (CFDA) number). This data serves as reference information that is made available for display and selection in various areas of the system.  The table allows you to manually maintain entries or you can also set up a batch integration to populate this table from sam.gov who maintains ALNs for the Federal government.  More information on how to manually maintain entries or set up the batch job to populate ALNs is below.

Manually Creating a ALN Entry

Those that have the appropriate permissions can manually create or edit a ALN entry the maintenance document and the below fields are available and required for entry.

• ALN Number - The numeric value assigned by grants.gov as a result of validation against the database in the sam.gov website. 
• ALN Program Title Name - The textual name associated with the numeric value commonly used to refer to the program verbally or in writing. 
• ALN Maintenance Type Id - When set to Automatic, this indicates updating from the batch job that validates information against the sam.gov website. When set to Manual, this indicates updating of this ALN record in Kuali is done via the editing of the ALN Maintenance Document. 
• Active - Indicates whether or not the ALN record is active in the system, and thus made available for selection in other document lookups if marked active. 

ALN Batch Job Configuration

Rather than manually maintain the list of ALN numbers you can set up the batch job to automatically populate the ALN numbers.  This ALN batch job functionality ensures the Assistance Listing Number (ALN) table in Kuali is automatically updated with data from the sam.gov website so that the ALN values available for selection on a Kuali document are current and valid.  To enable you have to set the below described parameters - if setting this up for the first time we always recommend testing this in a lower environment first before moving it to your Production environment.
Note: These batch job names reference previous terminology for ALN, which is CFDA. When updating UI references from CFDA to ALN, these job names were not updated. 

• CFDA_BATCH_JOB_CRON_EXPRESSION - The ALN cron job is set to run at 6am every Sunday morning as the default (0 0 6 ? * SUN). For a detailed explanation on the cron trigger and to modify it, please reference online cron expression tools/documentation.
• CFDA_BATCH_JOB_CRON_START_TIME - Start date/time of the ALN job - typically this is only set once and doesn't have to be modified after.  This allows you to future date the start of the job if you have never enabled. 
• CFDA_BATCH_JOB_ON - Determines if the ALN job is enabled; must be set to true to enable or false to disable.
• CFDA_BATCH_NOTIFICATION_RECIPIENT - Principal name of the person that should receive an email notification when the ALN batch job runs.  Enter only the user's Principal Name from their Person record and the system will derive the configured email in that user's Person record.
• KC CFDA_GOV_URL - Url of the ALN maintained site from sam.gov for the full csv list of current ALNs to be used in the batch job to population into the ALN maintenance table.  URL configured: https://s3.amazonaws.com/falextracts/Assistance%20Listings/datagov/AssistanceListings_DataGov_PUBLIC_CURRENT.csv