CRSJ6010 - Approved Course Transfer

Table of Contents


Overview

This job transfers approved Course information from the Curriculum Amendments and Proposals (CAPS) area to the Callista Course Structure and Planning (CRS) subsystem.

A course proposal is ready for transfer when it has been approved and has a System Transfer Status of READY or ERROR. (Records with ERROR will be processed again to see if the issue has been fixed.)

As an outcome of this process: a new Course could be created, a new version of an existing Course could be created, or details of an existing Course version could be updated or deleted.

For a proposal that requests a course update, the job can update all appropriate fields that exist in the CRS subsystem except for the primary key of any table.

Note: Where a new course version is created that is based on an existing course version, the elements not specified in the proposal will be inherited from the course version on which the proposal is based, not necessarily the latest version of the course. When creating a new version of a course, it is recommended that it is based on the latest version of the course and that any data required from earlier versions, be imported into the proposal.

Verification of all existing course business rules occurs and if a business rule fails when validating, then a System Transfer Status of ERROR is recorded for the affected proposal. When a validation fails, the transfer job rolls back all Inserts, Updates and Deletes for the proposal and the processing moves onto any remaining approved proposals that are ready to transfer.

To assist in identifying errors raised during the transfer, all errors are logged into the system extract logs. More information can be accessed through Generate Extract XML File (GENJ1000), which retrieves the error messages from the log.

A successful transfer moves the proposal to a COMPLETE status. Once the job finishes, a summary in the run log will appear noting how many successful Inserts, Updates and Deletes were transferred and the number of errors that occurred.

There are no parameters for this job. It can be run in Immediate or Scheduled mode, but it is recommended that this job is run as an overnight process.

Return to Top

Summary

This is a high level summary of the actions performed by this job.

Return to Top

Job Detail

The following provides a more detailed view of the processing required to transfer approved course proposal information from the Course Proposals to the Callista Course Structure and Planning subsystem.

Note: This job calls the package CRSK_PRC_CAPS_CRS_DATA which extracts and transfers each of the fields from the Proposals (PAA) subsystem into the CRS subsystem.

1. Insert into S_EXTRACT Table

A record is inserted into the s_extract table, as this is the parent table to s_extract_record where all errors will be logged. The parameters to be inserted are:

2. Check for Required System Data

Check that the required system transfer statuses and system proposal outcomes have been defined.

System Proposal Outcomes - NEW-CRS, NEW-CRS-V, UPD-CRS-V, NO-TRF-CRS, and System Transfer Statuses - ERROR, READY, COMPLETE must be defined for this job to transfer proposals, if not, the job will not proceed.

3. Determine the Proposals to Transfer

For a proposal to be transferred: the System Proposal Instance Status must be APPROVED, Proposal Transfer Status must be READY or ERROR and the Proposal Type must have a System Proposal Type of COURSE, but the System Proposal Outcome Type must not be CRS-POC.

4. For Each of the Proposals Identified, Transfer the Data into the CRS Subsystem

a). Course and Course Version Details

b). Other Course Details

Use this table to determine if the data in each section below should be inserted, updated or deleted.

System Proposal Outcome Insert
(Element)
Update
(Item)
Delete
(Element)
Action
NEW-CRS Any Any N Insert and validate.
NEW-CRS N N Y Ignore (Do not Insert).
NEW-CRS-V N N N For CRS and CRV data the record will need to be inserted.
All other data will be rolled over.
NEW-CRS-V Y N N Insert and validate (new data).
NEW-CRS-V N Y N Update and validate (update existing data).
NEW-CRS-V N N Y Update and validate (delete existing data).
NEW-CRS-V Y N Y Ignore (new data entered but now deleted)(a).
UPD-CRS-V N N N Context information, don't validate as not inserting.
UPD-CRS-V Y N N Insert and validate (new data).
UPD-CRS-V N Y N Update and validate (update existing data).
UPD-CRS-V N N Y Delete and validate (delete existing data).
UPD-CRS-V Y N Y Ignore (new data entered but now deleted).
NEW-USRDEF Any Any Any Not transferred.

c). Transfer Process

The following data may be involved in the transfer process:

Transfer of Course User-Defined Data

User defined data for each element (listed above), is transferred into the COURSE_USER_DEF_DATA_STRUCTURE and COURSE_USER_DEF_DATA tables in the Course Structure and Planning (CRS) subsystem and referenced to the course. This data may be transferred back to the PAA subsystem in the case where a new proposal is created in PAA that is based on the same existing course.

Each record in the two tables referred to above, has a key corresponding to the System Table to which the record is related, for example a user defined field that has been added to a Course Offering Option will have a key that includes COURSE_CD, VERSION_NUMBER, CAL_TYPE, LOCATION_CD.

The process for transferring user-defined data from PAA to CRS is as follows:

CUDDS Column (Primary Key) values: Data Source from Proposals:
STRUCTURE_SEQUENCE_NUMBER PROPOSAL_INSTANCE_ITEM.PROPOSAL_INSTANCE_
ELEMENT_SEQUENCE_NUMBER
PROPOSAL_ELEMENT_CD PROPOSAL_INSTANCE_ITEM.PROPOSAL_ELEMENT_CD
SUP_STRUCTURE_SEQUENCE_NUMBER If the PROPOSAL_INSTANCE_ITEM.PROPOSAL_ELEMENT_CD is a User Defined element, then V_SUP_STRUCTURE_SEQUENCE
SUP_PROPOSAL_ELEMENT_CD If the PROPOSAL_INSTANCE_ITEM.PROPOSAL_ELEMENT_CD is a User Defined element, then V_SUP_PROPOSAL_ELEMENT_CD
STRUCTURE_LABEL PROPOSAL_ELEMENT.MENU_TITLE
CUDD Column (Primary Key) values: Data Source from Proposals:
COURSE_CD V_COURSE_VERSION_REC.COURSE_CD
VERSION_NUMBER V_COURSE_VERSION
PROPOSAL_ELEMENT_CD PROPOSAL_INSTANCE_ITEM.PROPOSAL_ELEMENT_CD
PROPOSAL_ITEM_CD PROPOSAL_INSTANCE_ITEM.PROPOSAL_ITEM_CD
STRUCTURE_SEQUENCE_NUMBER V_STRUCTURE_SEQUENCE_NUMBER
SEQUENCE_NUMBER COURSE_USER_DEF_DATA_SEQUENCE_NUMBER.nextval, new sequential number to be created
EFFECTIVE _START_DT SYSDATE
FIELDS 1 to 10
Field values are set depending on the column mappings between the CRS table Primary Key columns, FIELDS 1 to 10 and TABLE_NAME. See the Field Values table below for these values.
EFFECTIVE_END_DT NULL
S_FIELD_TYPE S_PROPOSAL_ITEM.S_FIELD_TYPE
PROMPT NVL(PROPOSAL_ITEM.OVERRIDE_PROMPT, S_PROPOSAL_ITEM.PROMPT)
FIELD_LENGTH S_PROPOSAL_ITEM.FIELD_LENGTH
CHARACTER_FIELD PROPOSAL_INSTANCE_ITEM.CHARACTER_FIELD
NUMBER_FIELD PROPOSAL_INSTANCE_ITEM.NUMBER_FIELD
DATE_FIELD PROPOSAL_INSTANCE_ITEM.DATE_FIELD
CLOB_FIELD PROPOSAL_INSTANCE_ITEM.CLOB_FIELD

Field Values:

Source (System Element Code): Field 1 Field 2 Field 3 Field 4 Field 5 Field 6 Field 7 Field 8-10 TABLE_ NAME
ALTEXIT EXIT_ COURSE _CD NULL NULL NULL NULL NULL NULL NULL ALTERNATIVE _EXIT
CAS AWARD _CD SEQUEN CE_ NUMBER NULL NULL NULL NULL NULL NULL COURSE _AWARD_ STATEMENT
CEPRC CAL_TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE REFER ENCE_ CD_TYPE SEQUENCE _NUMBER NULL NULL COURSE_ ENTRY_ POINT_ REF_CD
CO CAL_TYPE NULL NULL NULL NULL NULL NULL NULL COURSE_ OFFERING
COI CAL_TYPE CI_ SEQUEN CE_ NUMBER NULL NULL NULL NULL NULL NULL COURSE_ OFFERING _INSTANCE
COO CAL_TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE NULL NULL NULL NULL COURSE_ OFFERING _OPTION
COOAC CAL_TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE ADMISS ION_ CAT NULL NULL NULL CRS_OFF _OPTION _ADM_CAT
COOACTR ACAD_ CAL_ TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE ADM_ CAL_ TYPE NULL NULL NULL COO_ADM _CAL_TYPE _RSTRN
COOACUS CAL_TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE ADMISS ION_ CAT UNIT_ SET_CD US_ VERSION _NUMBER NULL COO_ ADM_CAT _UNIT_SET
COOBAP CAL_TYPE LOCATION _CD ATTEND ANCE _MODE ATTEND ANCE _TYPE BAPPP. BUSINESS _ACTIVITY _PROCESS _CD BAPPP. BAPTR_ SEQUENCE _NUMBER BAPPP. SEQUEN CE_ NUMBER NULL BAP
COON CAL_TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE REFER ENCE _NUMBER NULL NULL NULL COURSE _OFFERING _OPT_NOTE
COOUS CAL_TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE REFER ENCE _NUMBER NULL NULL NULL CRS_ OFF_ OPTION _UNIT_SET
COOUSBAP CAL_TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE UNIT_ SET_CD US_ VERSION _NUMBER BAPPP. BUSINESS _ACTIVITY _PROCESS _CD Field 8: BAPPP. BAPTR_ SEQUEN CE_ NUMBER
Field 9: BAPPP. SEQUEN CE_ NUMBER
Field 10: NULL
BAP
COP CAL_TYPE CI_SEQUEN
CE_ NUMBER
LOCA
TION _CD
ATTEND ANCE _MODE ATTEND ANCE _TYPE NULL NULL NULL COURSE_ OFFERING _PATTERN
COPAPAPO ACAD _CAL_ TYPE ACAD_CI _SEQUEN
CE_ NUMBER
LOCA
TION _CD
ATTAN DANCE _MODE ATTEND ANCE _TYPE ADM_CI SEQUENCE _NUMBER NULL NULL COP_AP_ ADMISSION _PERIOD _OVRD
COURSE NULL NULL NULL NULL NULL NULL NULL NULL COURSE_ VERSION
COUS CAL_TYPE UNIT _SET_CD US_ VERSION_ NUMBER NULL NULL NULL NULL NULL COURSE_ OFFERING _UNIT_SET
COUSBAP CAL_TYPE UNIT_ SET_CD US_ VERSION_ NUMBER BAPPP. BUSINESS _ACTIVITY _PROCESS _CD BAPPP. BAPTR_ SEQUEN CE_ NUMBER BAPPP. SEQUENCE _NUMBER NULL NULL BAP
COUSR CAL_TYPE SUP_ UNIT_ SET_CD SUP_US _VERSION _NUMBER SUB_ UNIT_ SET_CD SUB_US_ VERSION _NUMBER NULL NULL NULL CRS_OFF _UNIT _SET_ RELATION SHIP
CRSAWARD AWARD _CD NULL NULL NULL NULL NULL NULL NULL COURSE _AWARD
CRSAWARDOW AWARD _CD ORG_ UNIT_CD OU_
START
_DT
NULL NULL NULL NULL NULL COURSE _AWARD_ OWNERSHIP
CRSCAT COURSE _CAT NULL NULL NULL NULL NULL NULL NULL COURSE_ CATEGOR ISATION
CRSDFLTMIL MILESTONE _TYPE ATTEND ANCE _TYPE SEQUEN
CE_
NUMBER
NULL NULL NULL NULL NULL DFLT_ MILESTONE _SET
CRSFLDSTDY FIELD_ OF_ STUDY NULL NULL NULL NULL NULL NULL NULL COURSE _FIELD_ OF_STUDY
CRSFUNDSRC FUNDING _SOURCE NULL NULL NULL NULL NULL NULL NULL FUNDING _SOURCE _RESTRIC TION
CRSGRPMEM COURSE _TROUP _CD NULL NULL NULL NULL NULL NULL NULL COURSE _GROUP _MEMBER
CRSOWN ORG_ UNIT_CD OU_ START _DT NULL NULL NULL NULL NULL NULL COURSE _OWNER SHIP
CRSREFCD REFER ENCE _CD_ TYPE REFER ENCE _CD NULL NULL NULL NULL NULL NULL COURSE_ REFER ENCE_CD
CRVBAP BAPPP. BUSINESS _ACTIVITY PROCESS _CD BAPPP. SEQUEN CE_ NUMBER BAPPP. SEQUEN
CE_
NUMBER
NULL NULL NULL NULL NULL BAP
CRVNOTES REFER ENCE_ NUMBER NULL NULL NULL NULL NULL NULL NULL COURSE_ VERSION _NOTE
CRVRULE NULL NULL NULL NULL NULL NULL NULL NULL COURSE_ VERSION
CRVTOP TYPE_ OF_ PLACE _CD SEQUEN CE_ NUMBER NULL NULL NULL NULL NULL NULL CRV_ TYPE _OF_ PLACE
POS CAL_ TYPE SEQUEN CE_ NUMBER NULL NULL NULL NULL NULL NULL PATTERN _OF_ STUDY
POSP CAL_ TYPE POS_ SEQUEN CE_ NUMBER SEQUEN
CE_
NUMBER
NULL NULL NULL NULL NULL PATTERN _OF_ STUDY _PERD
POSU CAL_ TYPE POS_ SEQUEN CE_ NUMBER POSP_ SEQUEN
CE_
NUMBER
SEQUENCE _NUMBER NULL NULL NULL NULL PATTERN _OF_ STUDY_ UNIT
USER-CO CAL_ TYPE NULL NULL NULL NULL NULL NULL NULL COURSE_ OFFERING
USER-COI CAL_ TYPE CI_SEQUEN CE_NUMBER NULL NULL NULL NULL NULL NULL COURSE_ OFFERING _INSTANCE
USER-COO CAL_ TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE NULL NULL NULL NULL COURSE_ OFFERING _OPTION
USER_ COOAC CAL_ TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE ADMISS ION _CAT NULL NULL NULL CRS_OFF _OPTION ADM_CAT
USER_ COOUS CAL_ TYPE LOCATION _CD ATTEND
ANCE
_MODE
ATTEND ANCE _TYPE UNIT_ SET_CD US_ VERSION _NUMBER NULL NULL CRS_OFF _OPTION _UNIT_SET
USER _COUS CAL_ TYPE UNIT_ SET_CD US_ VERSION_ NUMBER NULL NULL NULL NULL NULL COURSE_ OFFERING _UNIT_SET
USER_ CRS NULL NULL NULL NULL NULL NULL NULL NULL COURSE_ VERSION
USER_ CRSAW AWARD _CD NULL NULL NULL NULL NULL NULL NULL COURSE _AWARD

For a list of user-defined data for each core System Element, see Proposals Course System Data.

Deletion of User Defined Data in the CRS Subsystem:

If data is manually deleted from forms or tables in the CRS subsystem by an administrator, any associated child user-defined data is also deleted. User-defined data is located using the primary key value of its parent data. (Course user-defined data is stored in the COURSE_USER_DEF_DATA tables.)

Transfer of Course Structures

The job transfers the Course Structure (CRSW2600), Dependencies (CRSW2600) and Timelines (CRSW2650) associated with an approved Course Proposal Instance (PAAW1100) to the CRS subsystem, as follows:

5. For Each Proposal, Update the Proposal Status

If errors occur update the proposal instance transfer status to the value where the system value is ERROR and the system default ind is selected.

If no errors have occurred update the proposal instance transfer status to the value where the system value is COMPLETE and the system default ind is selected.

Once a NEW-CRS, NEW_CRS_V or UPD_CRS_V proposal has been successfully transferred, the new course version details are inserted into the PROPOSAL_INSTANCE_CRS_VERSION table. This is to help identify which proposal created which course version.

6. Generate Completion Message in Run Log

On completion of the job, the following details are recorded in the run log:

Started processing date and time
   Total records processed: NN (Successful: NN, Unsuccessful: NN)
   Total number of system extract records created: NN
   Completed processing date and time
Please query the system extract records for details of all errors and exceptions.
   System Log:
   - System Extract Type: PRPSL-CRV
   - System Extract Creation Date: date and time

Return to Top

Notes

Return to Top

Page last modified: 14 July, 2016 10:26 AM

History Information:

Release Version Project Change to Document
19.0 2106 - Learning Outcomes Added Course Learning Outcomes and Outcome Framework to Section 4c.
18.0.0.1 2087 - Entry Credit Added Volume of Learning to section 4c, list of data, and a new section for Course Structures.
17.0 1955 - Course Structures in PAA Added Course Structures to section 4c, list of data, and a new section for Course Structures.
17.0 1994 - New CS&P Data Added a new section for user defined data and related information.
16.1 1820 - Phase 3 Added new tables to the 'Transfer Process' section & a note to the Job Detail section.
15.0 1722 - 11g Upgrade Help page revised
13.0 1578 - CAPS 3 New Help page