System Letter - CORF2520

Purpose

To allow the creation and maintenance of system letters. In particular, to allocate letter parameters, repeating groups and templates that can be used in the creation of letters.

Subsystem

Correspondence

Structure

Four Blocks

System Letter Definition

Letter Parameter

Letter Repeating Group

Letter Repeating Group Parameter

Image

 System Letters are correspondence items that are produced by a combination of letter parameters, letter phrases and text on a Word template. System letters must have been created as correspondence types in CORF2110.

The institution's specialist user(s) are able to determine what letter parameters (see CORF2510) are to be extracted from Callista. Additionally, the specialist user is able to determine which of these parameters are to appear in repeating groups. Repeating groups are special parameters that contain one or more parameters. Generally, these parameters will contain multiple values i.e. A repeating group that contains a parameter mapped to SUA will return all instances of units the student has been enrolled into, if included on the template.

Creating a new system letter

New system letters can be created for any sub-system that includes letter production facilities. The specialist user determines the correspondence type, and the appropriate system reference type. A system reference type determines which sub-system will be able to use the system letter. A template is mapped to the system letter, and is used to determine the place and format of values for parameters. (See specialist links below for Letter template design ).

Allocating letter parameters to the system letter.

Letter parameters that have been created in CORF2510 and haven't been restricted to another correspondence type are able to be selected for the system letter. It is important to note that for each occurrence of a system letter parameter (excluding those contained in a repeating group) to appear on a template, a letter parameter mapped to the system letter parameter is required. See important notes for particular sub-systems below.

Allocation of Repeating Groups

Letter parameters that have been selected for the system letter, may be allocated to repeating groups. Typically, letter parameters that may have more than one value are contained within repeating groups. Repeating groups are also able to be allocated as subordinate to other repeating groups. Each repeating group is required to contain at least one parameter.

Important notes for Admission Correspondence items.

If letter parameters that have been mapped to system letter parameters that return text from the rules engine are required, i.e. system letter parameters ADM_RUL_1 to ADM_RUL_19, the letter parameter that has been mapped to the system letter parameter of type ADM_COURSE is required to be defined for the system letter. The ADM_COURSE parameter may or may not appear on the template.

Letter parameters that have been mapped to type PHRASE require that the particular phrase(s) or phrase text be mapped to the parameter, for each individual letter, in ADMF3900.

Specialist Links

Admission Specialist.

Letter parameter types for admission correspondence.

Letter template design for admission correspondence.

Rules for admission correspondence.

 Assessments Specialist

Letter parameter types for academic transcript.

Letter template design for academic transcript.

 

 Future subsystem

 

 

Use this form to record the appropriate letter template, letter parameters and repeating groups to appear on a correspondence item.

Select the correspondence type, and enter the description of the letter, the System Reference Type, Letter Object, Template File Name only (not the path) and Letter Title.

Select the appropriate letter parameters to appear in the system letter (see important notes for sub systems above).

Press the Repeating Groups button for creation of repeating groups.

Enter a unique repeating group code, and allocate at least one parameter to the repeating group.

If the repeating group is to be displayed within another repeating group, select the superior group code.

System letters cannot be deleted if they have been used to create individual correspondence, rather the closed indicator in the System Letter Definition block should be used.

 

Rules/Notes:

Multiple letters can be created for correspondence types. The template is required to be in the directory specified in control.doc. The template must exist prior to recording a new system letter. If more than one occurrence of the system letter parameter is required on the template, multiple letter parameters must be selected. The letter parameters must be uniquely named and should not be a subset of another parameter name. E.g. do not use ADMISSION and ADMISSION_NAME. Repeating groups can only be four levels deep. I.e. only four levels of repeating groups can be subordinate to each other.

 

 

 

 

 

 

 

 

 

 

 

 

 

Last Modified on 20 June 2002