Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added more details for updating proposal status

...

Update PD Proposal Status

Request: "Please update proposal number 1234 to the 'Approved & Submitted' status."

Example Ticket: INC0712970

Code Block
languagesql
themeEclipse
title1. View proposal status values
select * from proposal_state;

...

Code Block
languagesql
themeEclipse
title3. Update status of selected proposal
update eps_proposal set status_code='6' where proposal_number='1234';


Side Note: Besides updating status_code for the proposal, we may also need to make sure the proposal's document status matches the new proposal status_code. For example, if we change the proposal status to 'cancelled', we also need to make sure the document status is set to 'cancelled'. In document table 'krew_doc_hdr_t', column 'doc_hdr_id' is the document number.

Code Block
languagesql
themeEclipse
titleFind document number for PD proposal
select proposal_number, document_number, status_code from eps_proposal where proposal_number='1234';


Code Block
languagesql
themeEclipse
titleupdate PD proposal document status
update krew_doc_hdr_t set doc_hdr_stat_cd='S' where doc_hdr_id='486290';


Remove Previous Grants.gov Tracking ID from PD

Request: Cannot remove previous Grants.gov tracking ID from proposal

Example Ticket: INC0712387

Code Block
languagesql
themeEclipse
title1. View Grants.gov info for selected proposal
select * from s2s_app_submission where proposal_number='1234';


Code Block
languagesql
themeEclipse
title2. Remove value for GG Tracking ID from selected proposal
update s2s_app_submission set GG_TRACKING_ID=null where proposal_number='1234';

Update Opportunity Title

Request: The opportunity title on an application contains an unsupported character, resulting in an error which states "Must be an alphanumeric character or punctuation".

This often happens when the title contains a non-ASCII character, such as "smart quotes" or long hyphens copied from Word/Outlook/etc.

Code Block
languagesql
themeEclipse
title1. Update the proposal AND s2s tables with the new title, replacing the invalid character with the correct one
update eps_proposal set program_announcement_title='DoD Peer Reviewed Alzheimer''s, Research Partnership Award' where proposal_number='5997'; -- The double apostrophe in Alzheimer''s results in a single apostrophe in the final output
update s2s_opportunity set opportunity_title='DoD Peer Reviewed Alzheimer''s, Research Partnership Award' where proposal_number='5997';


Fix Missing/Invalid Fiscal Year on PD Unrecovered F&A

Request: Proposal encounters an error during routing referencing an invalid fiscal year. ("Fiscal year must be between X and Y")

Example Ticket: INC0729118

Code Block
languagesql
themeEclipse
title1. Find budget ID for selected proposal
select proposal_number, budget_id, final_version_flag, status_code from eps_proposal_budget_ext where proposal_number='1234'; -- Status code of 1 = Complete, 2 = Incomplete

...

Code Block
languagesql
themeEclipse
title3. Update Fiscal Year value for selected UF&A line
 update eps_prop_idc_rate set fiscal_year='2020' where budget_id='2345' and unrecovered_fna_id='3';

...

Add New Delegate Central Admin

Request: Add user with UTLN 'mgoldb10' as a Delegate Central Administrator for all departments.

update s2s_app_submission set GG_TRACKING_ID=null where proposal_number='1234'
Code Block
languagesql
themeEclipse
title1. View Grants.gov info for selected proposal
select * from s2s_app_submission where proposal_number='1234';
Code Block
languagesql
themeEclipse
title2. Remove value for GG Tracking ID from selected proposal
Run procedure to create unit_administrator rows for all units using the given UTLN
exec add_delegate_central_admin('mgoldb10');

Institutional Proposal (IP)

...

Update IP Status

Request: "Please update the status of IP ####### to 'Not Funded'."

Code Block
languagesql
themeEclipse
title1. View IP status values
select * from proposal_status;

...

Fix Award Stuck in 'Pending' State (Edit button doesn't appear)

Request: "Edit button does not appear for award 100000-00001."

Example Ticket: INC0728472

Code Block
languagesql
themeEclipse
title1. View versions and statuses for selected award
select award_number, sequence_number, award_id, award_sequence_status from award where award_number='100000-00001' order by sequence_number;

...

Code Block
languagesql
themeEclipse
title2. If no ACTIVE version, set the PENDING version to ACTIVE
update award set award_sequence_status='ACTIVE' where award_sequence_status='PENDING' and award_id='111111';


Fix Page Not Loading on Obligation Dates

Request: The award page gets stuck while loading, and attempting to move to another page results in a "The page has not finished loading" pop-up.

Example Ticket: INC0747018

Code Block
languagesql
themeEclipse
title1. Default the value of the Obligation Expiration Date to whatever the project end date is
-- Only run this on awards that don't have Time & Money already entered! If the award has dates and dollars, the problem is something else (and running this will overwrite the existing date data)
update award_amount_info set obligation_expiration_date=final_expiration_date where award_number='102734-00001';

Maintenance Tables

...

Add New State to State Table

Request: "Please add the states of (country) to the RAS state table."

Example Ticket: INC0718617

Code Block
languagesql
themeEclipse
title1. Insert new row for state (repeat for each state/province)
insert into krlc_st_t values ('SS', 'CC', sys_guid(), 1, 'State Name', 'Y'); 
-- Replace SS with two-digit state/province abbreviation; these are used in S2S submissions so they should match the official designations.
-- Replace CC with the two-digit country abbreviation (found in the Country maintenance table)
-- Replace State Name with the name of the state/province; this is what will display in the drop-down. Be careful about copy-pasting special characters as they may not show up correctly.

Remove Inactive Departments from User

Request: Person/User record cannot be edited because of inactive departments in their permissions.

Code Block
languagesql
themeEclipse
title1. Run stored procedure on user to clean up permissions for inactive departments
exec remove_inactive_unit_perms('efitzp01'); -- Replace with user's UTLN


Grant Admin permissions to a user (full access)

Code Block
languagesql
themeEclipse
title1. Assign admin permission to the given UTLN
exec give_user_admin_permissions('efitzp01'); -- Replace with user's UTLN


PeopleSoft Integration

...

Add New PeopleSoft Grant Prefix

...

Code Block
languagesql
themeEclipse
title2. Insert a new grant prefix
insert into ps_grant_prefix values ('ABC', sysdate, 'admin', 1, sys_guid());

Grant Admin permissions to a user (full access)

Code Block
;


Error in Fund Source / Grants Integration - Change the status from Error so that the row processes again.

Request: User error occurred for some reason in the fund/grant and the user wants the proposal to be "reset" so that PeopleSoft processes it again.

Example Ticket: INC0917104

Code Block
languagesql
themeEclipse
title1. Reset PS return status on TUPS_GRANT
update KCSO.TUPS_GRANT set PS_RETURN_STATUS = ' '  where award_number='103786-00001' and ps_ras_transaction_id = '000000037066' and PS_RETURN_STATUS = 'E';

Add/Update PeopleSoft Accountant Code assignments

Code Block
languagesql
themeEclipse
title1. View current accountant code assignments
select accountant_code, user_id from ps_accountant_codes order by to_number(accountant_code);


Code Block
languagesql
themeEclipse
title2a. Assign a new user to an existing accountant code
update ps_accountant_codes set user_id='efitzp01' where accountant_code='99';


Code Block
languagesql
themeEclipse
title2b. Create a new accountant code for the given user
insert into ps_accountant_codes values ('99', 'efitzp01', sysdate, 'admin', 1, sys_guid());


Code Block
languagesql
themeEclipse
title2c. Remove an existing accountant code
delete from ps_accountant_codes where accountant_code='99';

Add Federal Sponsor Mapping Info

exec give_user_admin_permissions('efitzp01'); -- Replace with user's UTLN
Code Block
languagesql
themeEclipse
title1. Assign admin permission to Insert new mapping row with the given UTLN
data
insert into ps_sponsor_mappings(sponsor_code, fed_agency, reporting_agency, display_acronym, mapping_level, update_timestamp, update_user, ver_nbr, obj_id) values
	('000000', 'DOD', 'DOD', 'DOD>USMA>', 1, sysdate, 'admin', 1, sys_guid());
	-- First parameter is the six-digit sponsor code
    -- Second parameter is the Federal Agency code
    -- Third parameter is the Reporting Agency code
    -- Fourth parameter is the Display Acronym
    -- Other parameters can be left with the provided values


Other

...

Update RAS Menu Files (Job Aids, Checklists, etc)

There are a number of files hosted on the RAS web servers that are linked in the main 'Researcher' menu of the application (screenshot below). Occasionally, new versions of these files will need to be uploaded.

To update these files, use WinSCP (or another SCP/FTP tool) to upload the new file to BOTH raweb-prod-01 and raweb-prod-02, and copy the file(s) to the directory:

/usr/local/apache-tomcat-8.5.38/webapps/ROOT/ras_docs/

Ensure that the filename matches the existing files so that the links will still work.

Image Added

Update Known Issues List

See Known Issues Page.