3 Banner Student Population Selection / Letter Generation

3
Workbook
Banner Student
Population Selection / Letter Generation
Communication Plans
Training Workbook
Integrated Information System (IIS) Project
Confidential & Proprietary
© 2007-08 Ivy Tech Community College. All rights reserved. This documentation is proprietary information of Ivy
Tech Community College and is not to be copied, reproduced, lent or disposed of, nor used for any purpose other than
that for which it is specifically provided without the written permission of Ivy Tech Community College. The
unauthorized possession, use, reproduction, distribution, display or disclosure of this material or the information
contained herein is prohibited.
Prepared By:
Ivy Tech Community College
9301 E. 59th Street, Suite 156
Indianapolis, Indiana 46216
www.ivytech.edu
Version 1.0 SEP07
Banner Student PopSel / LetGen / CommPl
i
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Contents
About this workbook ................................................................................................... iv
Workbook revision history ...................................................................................... iv
SECTION 1: OVERVIEW............................................................................................. 1
Letter Generation in Banner...................................................................................... 1
SECTION 2: POPULATION SELECTION PROCESSING ..................................... 2
Lesson: Overview of Information Management in Banner .......................................... 3
Storing Information in Banner .................................................................................. 4
Selecting Records in Banner Using SQL.................................................................. 5
Using Conditions in SQL.......................................................................................... 7
Lesson: Population Selection Setup Process ................................................................ 9
Defining an Application.......................................................................................... 10
Defining Simple Population Selection Rules.......................................................... 11
Running a Population Selection.............................................................................. 14
Viewing Population Selection Results.................................................................... 17
Performing a Query on a Selected Population ........................................................ 19
Copying Population Selection Rules ...................................................................... 20
Defining a Manual Population Selection ................................................................ 23
Creating a "Manual" Population Selection ............................................................. 24
Deleting the Results of a Population....................................................................... 26
Viewing Defined Objects........................................................................................ 27
SECTION 3: LETTER GENERATION PROCESS ................................................. 29
Lesson: Letter Generation Process ............................................................................. 30
Creating Letter Code............................................................................................... 32
Creating Paragraph Code ........................................................................................ 34
Creating Simple Variable Rules.............................................................................. 36
Copying the Rules from an Existing Variable to a New One ................................. 38
Defining the Contents of a Paragraph ..................................................................... 39
Reviewing and Changing the Contents of a Paragraph........................................... 41
Creating a Letter by Adding Paragraphs................................................................. 42
Using the Letter Extract Process............................................................................. 43
Using the Letter Generation Print Report ............................................................... 47
Using the Letter Generation Print Report ............................................................... 52
Banner Student PopSel / LetGen / CommPl
ii
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
SECTION 4: COMMUNICATION PLAN PROCESSING ..................................... 54
Lesson: Setting up Communication Plans .................................................................. 55
Determining Material Recipients............................................................................ 56
Defining Materials and Rules ................................................................................. 57
Using Material Groups............................................................................................ 58
Associating Materials with Plans............................................................................ 58
Using Communication Plans................................................................................... 59
Assigning Communication Plans ............................................................................ 60
Lesson: Implementing Communication Plans ............................................................ 61
Defining Material Codes......................................................................................... 62
Define Base Information for Material..................................................................... 64
Define Group Codes ............................................................................................... 66
Attach Materials to Group Codes ........................................................................... 67
Define Communication Plan Codes........................................................................ 68
Attach Materials to Communication Plans ............................................................. 69
Assigning Communication Plans ............................................................................ 70
Assigning a Communication Plan to an Individual ................................................ 71
Using the Communication Plan Change Window .................................................. 72
Using the Collector File .......................................................................................... 74
APPENDIX A: GLOSSARY OF TERMS.................................................................. 76
APPENDIX B: VALIDATION FORMS .................................................................... 77
Banner Student PopSel / LetGen / CommPl
iii
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
About this workbook
Workbook goal
The goal of this workbook is to provide you with the knowledge and practice to process
communications at Ivy Tech. The workbook is divided into these sections:
•
•
•
•
Overview
Population Selection Process
Letter Generation Process
Communication Plan Process
Intended audience
Staff members who are responsible for written communication with prospects and
applicants, and students should complete this workbook and use it for reference.
Prerequisites
Before you can complete this workbook, you should have:
•
•
Completed the computer-based training (CBT) “Banner 7 Fundamentals”
Access to and awareness of institution and departmental policies and procedures
regarding inquiry and applicant processing.
Workbook revision history
VERSION
DATE
REVISION
0.1
July 2007
Initial pre-release workbook
0.2
July 2007
Changes to 0.1 pgs. 10, 13, 21, 22, 24, 28, 37-44, 46,
48, 50, 63-70, move pgs. 40-41 to 24-25, renumber
workbook.
1.0 SEP07
September 2007
Changes to pgs. 19, 30-31, 61, 65, renumber
workbook.
Banner Student PopSel / LetGen / CommPl
iv
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Section 1: Overview
Letter Generation in Banner
This workbook is intended to teach you to identify and group entities in the database (for
example, people, vendors, and organizations). You will define selection criteria to
identify and extract a subset of these entities to use in Banner reports, processes, and
letters.
Banner Student PopSel / LetGen / CommPl
1
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Section 2: Population Selection Processing
Purpose
Banner Population Selection is a mechanism for selecting a group of people or
organizations, with shared common data, based on specific criteria. Because Banner
stores a great deal of information, it is possible to select groups using simple and complex
criteria. The purpose of this section is to explain population selection processing at Ivy
Tech.
Objectives
At the end of this section, you will be able to:
•
•
•
•
•
•
Understand how data is stored and retrieved in Banner
Identify the population you wish to select.
Identify the table and field names within Banner you wish to select in order to
create the rules associated with a specific population.
Create validation and rules forms based on the tables and field names identified
for the population selected.
Run the process.
Review the output.
Set up Tasks
•
Before you can complete this section, the population selection validation forms
should already be set up.
Common Navigation Tips
Go to . . .
Enter
Enter the 7-digit form name (XXXXXXX) in the GO TO . . . field and select
the Enter key to access the form.
Tab
Use the TAB key to move from field to field in a sequential order in a block
of information.
T (or any
alpha
character)
Enter T (or any alpha character) in any date field to indicate that you want to
use today’s date (current date).
Next Block
Ctrl PgDn
You perform the Next Block function, Ctrl then PgDn keys, to access the
Next Block of information.
Banner Student PopSel / LetGen / CommPl
2
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Lesson: Overview of Information Management in
Banner
Banner Population Selection is a mechanism for selecting a group of people or
organizations, which share common data, based on specific criteria.
Lesson Overview
In this lesson, you will learn to:
¾
Understand how information is stored in Banner
¾
Select records in Banner using SQL
¾
Use Conditions in SQL
NOTE: Rule and validation forms are set up on the Banner System. Unless code is
required, this step is performed only once.
Banner Student PopSel / LetGen / CommPl
3
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Storing Information in Banner
How information is stored
To understand Population Selection, it is helpful to understand how Banner stores
information. The Oracle database (which is the basis of Banner) is made up of tables and
rows much like a spreadsheet. For example, view the table below.
Last Name
First Name
Middle Name
ID
Spaulding
John
Forrest
578688818
Smith
Mary
Therese
003525454
Williams
Tom
Mitchell
952854785
NOTE: All of the last names are stored in the first column, and all of the information
about John Forrest Spaulding is stored in one row, or record.
Role of the PIDM
To ensure that the information on a specific record in one table is connected to the correct
record in another table, Banner uses a field, called PIDM, which has the same value for a
record in every table. Every time a new person or non-person is added to the system,
Banner generates a unique PIDM. This number is used for every record in every table
that pertains to the person created.
To store the vast amount of data used by Banner clients, the system has thousands of
tables. For example, the table SPRIDEN stores name and ID information (e.g. last name,
first name, prefix, suffix, etc); the table SPRADDR stores address information, and the
table SPBPERS stores personal information (e.g., sex, birth date, and ethnicity).
Example 1 - SPRIDEN Table
PIDM
Last Name
First Name
Middle Name
ID
0000001
Spaulding
John
Forrest
578688818
0000002
Smith
Mary
Therese
003525454
0000003
Williams
Tom
Mitchell
952854785
Banner Student PopSel / LetGen / CommPl
4
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Example 2 - SPRADDR Table
PIDM
Street
City
State
ZIP
0000001
1 Main Street
Henniker
NH
03242
0000002
2 Elm Street
Dearborn
MI
51245
0000003
3 Beech Street
New Durham
NH
3454
To display name and address information for Mary Smith, Banner can connect the two
records using the PIDM. Thus, Mary Smith lives at 2 Elm Street, Dearborn, MI 51245.
NOTE: Every table in Banner that contains information about a person or non-person
uses the PIDM to identify the record.
Selecting Records in Banner Using SQL
What is SQL?
Banner uses a SQL (Structured Query Language) to ask for information from the
database. A SQL statement is composed of three parts. Below are the three SQL
statement parts and the questions asked to get the last names of everyone living in New
Hampshire.
•
•
•
select clause - the LAST NAME
from clause - from the NAMES and IDS table and the ADDRESSES table
condition or where clause - where the STATE is New Hampshire or 'NH'
NOTE: Both tables are mentioned in the From clause because one is for selecting from
and the other uses the conditions. You would surround the letters NH in single quotes;
this tells Banner that it should look for the literal value NH in that field.
NOTE: SQL is literal and case sensitive.
Banner Student PopSel / LetGen / CommPl
5
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Query results
The result of our query would be the following when reviewing the two tables involved:
•
•
Spaulding
Williams
SPRIDEN Table
PIDM
Last Name
First Name
Middle Name
ID
0000001
Spaulding
John
Forrest
578688818
0000002
Smith
Mary
Therese
003525454
0000003
Williams
Tom
Mitchell
952854785
SPRADDR Table
PIDM
Street
City
State
ZIP
0000001
1 Main Street
Henniker
NH
03242
0000002
2 Elm Street
Dearborn
MI
51245
0000003
3 Beech Street
New Durham
NH
3454
NOTE: Banner field names have no spaces (use underlines to connect words), and they
always begin with the table name.
EXAMPLE: SPRIDEN_ID and SPRADDR_STAT_CODE
If this were a real Banner query, it would use the field and table names from Banner. The
result would look similar to this:
select spriden_last_name
from spriden, spraddr
where spraddr_stat_code = ‘NH’
NOTE: To find table and field names in Banner, you can either select the field that you
want to pull information from and select Dynamic Help Query or place the cursor in the
field, hold the shift key down, and double click.
Banner Student PopSel / LetGen / CommPl
6
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using Conditions in SQL
Multiple conditions
Some statements may require more than one condition. For example, you may get a
request for “the last names of all the males from Massachusetts.” The statement would
look like this:
AND Statement - must meet all conditions
where spbpers_sex = ‘M’ and
spraddr_stat_code = ‘MA’
Another option is or. A request for “the last names of everyone from Massachusetts or
Connecticut would read:
OR Statement - only has to meet either condition, not both
where spraddr_stat_code = ‘MA’ or
spraddr_stat_code = ‘CT’
Using and and or
By combining and and or, the data can be manipulated, but the user must be careful.
Consider the request for “last names of all males from Massachusetts or Connecticut.” It
might incorrectly be assumed that the statement would be written:
select spriden_last_name
from spriden, spraddr, spbpers
where spbpers_sex = ‘M’ and
spraddr_stat_code = ‘MA’ or
spraddr_stat_code = ‘CT’
Unfortunately, the results are wrong because Banner interpreted the request as “the last
names of all males from Massachusetts or everybody in Connecticut! In other words,
Banner combined the first two lines of the where clause and kept the third line as a
separate condition. Banner can be told to combine portions of a where clause by using
parenthesis:
select spriden_last_name
from spriden, spraddr, spbpers
where spbpers_sex = ‘M’ and
(spraddr_stat_code = ‘MA’ or
spraddr_stat_code = ‘CT’)
Banner Student PopSel / LetGen / CommPl
7
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using operators
Often, the information wanted requires more flexibility than simply saying that a value
equals some other value. Banner provides many of these operators, including
•
•
•
•
•
•
•
•
•
equals
not equals
in
not in
like
not like
between
is null
is not null.
For example, you may want to identify individuals, whose state equals PA and their ACT
composite score is greater than 25 or their zip code is between 19131 and 19355.
select spriden_last_name
from spriden, spraddr,, sortest
where spraddr_stat_code = ‘PA’ and sortest_tesc_code = ‘A05’ and
(sortest_test_score > 25 or spraddr_zip between ‘19131’ and ‘19355’)
In this case, the last line provides a list for Banner to choose from.
NOTE: The word null has a special meaning in SQL. It means the field has nothing in it.
That is different from having 0 in it. Zero is a value.
What is selected?
The Population Selection process only selects IDs (actually PIDMs); you cannot use it for
selecting benefits, employee classes, payroll, or any other information. Only PIDMs can
be selected and only persons or non-persons have PIDMs.
Banner Student PopSel / LetGen / CommPl
8
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Lesson: Population Selection Setup Process
Before Banner can process general population selection you need to
•
•
•
identify the population you wish to select
identify the field names being used in the population selection
set or create specific forms and rules in which to select the population.
The purpose of this lesson is to outline the set-up process and detail the procedures to set
up the Banner system to handle Population Selection at Ivy Tech.
Lesson Overview
In this lesson, you will learn to:
¾
define applications
¾
define simple population selection rules
¾
run a population selection
¾
view population selection results
¾
perform a query on a selected population
¾
copy population selection rules
¾
define a manual population selection
¾
delete the results of a population
¾
view defined objects
There is also an exercise at the end for you to complete on your own.
Banner Student PopSel / LetGen / CommPl
9
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Defining an Application
An application is a functional area with similar characteristics that can be applied to
Population Selections and variables. Applications are already provided in Banner by
module; you will just need to select one. For admissions purposes, you will typically
access the admissions application.
¾
To review the application choices
STEP ACTION
1
Access the Application Inquiry Form (GLIAPPL). –GLIVRBL – list of variables in each
module.
Banner Student PopSel / LetGen / CommPl
10
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Defining Simple Population Selection Rules
The Population Selection Definition Rules Form (GLRSLCT) is used to define, maintain,
and copy a Population Selection. A Population Selection is a set of rules used to select
IDs from the Banner database for reports, processes, and letters. An application, selection
ID, and creator ID uniquely identify a Population Selection.
The population selection allows the user to add more specific information to the
application. This information is not added to the main application because it is only going
to be used once.
Scenario
The Director of Admissions is planning an orientation meeting and wants to invite only
new first time freshmen. She wants to use Population Selection to prepare her invitations.
In defining her population rule, the Director just needs to specify new first time freshman
in the application-level rules.
Banner Student PopSel / LetGen / CommPl
11
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
Follow these steps to complete the process
STEP ACTION
1
Identify the name of the base table and field name for student type in the Admissions
module to capture new first time freshmen.
2
Access the Admissions Application Form (SAAADMS).
3
Select an existing person in the Key block.
4
Perform a Next Block function.
5
Place the cursor in the field that contains student type.
6
Select Dynamic Help Query option on the Help menu or place the cursor in the field
and hold the shift key down while you double click.
7
The field box will contain the name of the field that holds the data and the block field
contains the name of the base table -- make a note of this information and exit the
form.
8
Access the Population Selection Definition Rules Form (GLRSLCT).
9
In the application box, enter the code 'Admissions'.
10
In the Selection ID, enter the new selection ID name using your initials and
FIRST_TIME.
Example: MS_FIRST_TIME
11
The Creator field automatically populates with creators login name.
12
Perform a Next Block function to the Selection Description block.
13
Enter a new description – ‘Select New Freshmen'.
14
If you select to Lock the selection, only your user login can delete or execute this
population selection. Do not select any options.
15
Perform a Next Block function to the Definition block.
16
Enter SARADAP_PIDM
17
Tab to the Form field and enter SARADAP.
18
Perform a Next Block function to the Rules block.
19
Enter SARADAP_ADMT_CODE in the data element field.
20
Enter an (=) sign in the operator field.
21
Enter ‘FT’ in the value field - first time freshmen. Make sure to include the single
quotes.
Banner Student PopSel / LetGen / CommPl
12
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
22
Click the Save icon.
23
Click the Exit icon.
NOTE: You will se the message "Performing Population Selection Compilation, please
wait". If your Population Selection is compiled successfully, you will exit the form. If it
does not compile successfully, you are returned to GLRSLCT and an error message
displays.
Banner Student PopSel / LetGen / CommPl
13
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Running a Population Selection
The Population Selection Extract Process (GLBDATA) is used to extract IDs (people and
non-persons) from the Banner database based on the rules entered on the Population
Selection Definition Rules Form (GLRSLCT).
If the results of this extract identify the population receiving a letter, it should be
executed before running the Letter Extract Process (GLBLSEL). If the results of this
extract identify the population to be used in a report, it must be executed before running
that report.
The Process Submission Control Form (GJAPCTL) lets you run a report or process and
save the parameters as user-level defaults. If you want to save more than one set of
parameters for the report or process, you can save the current set with a unique name. The
defaults in each set are associated with the user ID and the job parameter set.
Scenario
We are now going to apply our application/rules to pull a population of applicants who
are new first time freshmen.
Banner Student PopSel / LetGen / CommPl
14
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To run the extraction process
STEP ACTION
1
Access the Population Selection Extract Process (GLBDATA).
2
Enter the desired printer name in the Printer field. Note: You can enter DATABASE
to write the report to a table for on-line viewing and to enable the saving of the report
to a shared folder on a designated network drive.
3
Enter these parameter values.
Description
Value
01
Selection Identifier 1
Enter initials and FIRST_TIME
Example: MS_FIRST_TIME
02
Selection Identifier 2
Leave empty.
03
New Selection Identifier
Leave empty.
04
Description for new selection
Leave empty.
05
Union/Intersect/Minus
Leave empty. This combines population
selections.
06
Application Code
Enter ADMISSIONS
07
Creator ID of Selection ID
Enter your user ID (If using someone
else’s population selection you would
enter the ID of the creator of the
population selection).
08
Detail Execution Report
Leave empty.
4
Click the Save Parameter Set as checkbox if you want to save the parameter.
5
Enter a name and description in the parameter Name and Description fields if you
want to save the parameters.
6
Click the Submit radio button.
7
Click the Save icon to execute the report. Result: The Auto hint line displays the job
submission number for the report log and list file.
8
Select Review Output on the Options menu to review the report.
9
Click the Exit icon.
10
The output is now ready to run with the Letter Generation process (GLBLSEL and
SLRLETR), which will extract the Population Selection result values, track, and
prepare the letter for mailing.
Banner Student PopSel / LetGen / CommPl
15
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Banner Student PopSel / LetGen / CommPl
16
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Viewing Population Selection Results
The Population Selection Extract Data Form (GLAEXTR) is used to display the
population of IDs extracted from the database for a specified selection identifier. A
population is uniquely identified by an application, selection ID, creator ID, and user ID.
Population Identifiers
Application
functional area that controls the population
Selection ID
identifies the Population Selection, or set of rules, that selected the IDs
User ID
Oracle ID of the user who selected the population. This ID defaults to
the ID of the person logged on Banner, but you can enter another ID.
The user ID must be an ID that previously ran the extract to obtain a
population.
Creator ID
ID of the individual who created the Population Selection
Individuals identified by the population selection may be removed using this form. An ID
may also be added to the Population Selection using this form.
The Population Selection Extract Inquiry Form (GLIEXTR) is used to display a
population. The form is for queries only.
You can click the Search icon to display Population Selection IDs on the Population
Selection Inquiry Form (GLISLCT). The creator ID is the Oracle ID of the user who
created the Population Selection. If a Population Selection is locked, only the creator ID
can display any populations created with the Population Selection.
Scenario
The Director of Admissions has extracted the population of new first time freshmen
applicants and has asked her assistant to prepare and mail the invitations for an
orientation meeting. The assistant wants to know how many invitations to print. She also
is curious about the results and wants to see who will receive this invitation.
Banner Student PopSel / LetGen / CommPl
17
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
Follow these steps to complete the process
STEP ACTION
1
Access the Population Selection Extract Inquiry Form (GLIEXTR).
2
Enter your application code in the Application field.
EXAMPLE: ADMISSIONS.
3
Enter MS_FIRST_TIME in the Selection ID field.
NOTE: By clicking the Search icon next to the Selection ID field you can search for
your application. The Creator ID and User ID fields are populated.
4
Select the Sort by Name radio button.
5
Perform a Next Block function.
6
Review the names.
NOTE: If you receive the message “One or more of the persons in this list has
Confidential Information,” click OK.
7
Click the Rollback icon.
8
Select the Sort by ID radio button.
9
Perform a Next Block function.
10
Review the names.
11
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
18
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Performing a Query on a Selected Population
The Population Selection Extract Data Form (GLAEXTR) or the Population Selection
Extract Inquiry Form (GLIEXTR) may be used to display the population of IDs extracted
from the database for a specified selection identifier. The Population Selection Extract
Inquiry Form (GLIEXTR) allows you to either sort by name or ID.
Scenario
Invitations are ready to go out to the new first time freshmen. The Director's Assistant
wants to verify the list to make sure a few known first time freshmen are on the list.
¾
Follow these steps to complete the process
STEP ACTION
1
Access the Population Selection Extract Inquiry Form (GLIEXTR).
2
Ensure that the Key block information still reflects the Population Selection you have
been working with.
Example: Select New Freshmen
Application: ADMISSIONS
Selection ID: MS_FIRST_TIME
3
Select the Sort by Name radio button.
4
Perform a Next Block function.
5
Perform an Enter Query function.
6
Enter W% in the Name field to select all last names that begin with a W.
7
Perform an Execute Query function.
8
Review the results to determine if someone with the last name of ‘White’ is to receive an
invitation.
9
Perform an Enter Query function.
10
Enter B% in the Name field to select all last names that begin with B.
11
Perform an Execute Query function.
12
Review the results to determine if someone with the last name of ‘Brown’ is to receive an
invitation.
13
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
19
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Copying Population Selection Rules
The Population Selection Definition Rules Form (GLRSLCT) is used to copy rules in an
existing Population Selection and to create a new Population Selection. By changing the
application and selection ID, your ID becomes the creator ID. A copied Population
Selection can be changed as needed.
Scenario
We are now going to make a copy of the original rule and modify it so that it pulls only
transfer students.
¾
To copy existing rules
STEP ACTION
1
Access the Population Selection Definition Rules Form (GLRSLCT).
2
Enter the code for the admissions application previously created in the Application
field. Example: ADMISSIONS
Banner Student PopSel / LetGen / CommPl
20
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
3
Enter the previous code 'MS_FIRST_TIME' for the population selection in the
Selection ID field.
NOTE: The ID used to create the original population selection is displayed in the
Creator ID field.
4
Perform a Next Block function.
5
Select the Copy option from the Options menu.
6
Information in the Copy From block should be populated.
7
Enter the same application code in the Application field of the Copy To block.
EXAMPLE: ADMISSIONS
8
Enter your initials and 'TRANSFER' in the Selection ID field. Ex. MS_TRANSFER
NOTE: The Creator ID field self-populates with the ID used to log into the Banner
System.
9
Click the Save icon.
NOTE: After the rules have been copied, you are returned to the Population Selection
Definition Form.
10
Enter a new description for the copied Selection ID in the Description field.
EXAMPLE: Transfer Applicants.
Banner Student PopSel / LetGen / CommPl
21
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
11
Perform a Next Block function twice to navigate to the Rules block.
12
Change the Value of the Data Element (SARADAP_ADMT_CODE) to TR instead of
FT.
Data Element SARADAP_ADMT_CODE Operator = Value ‘TR’
13
Click the Save icon.
14
Click the Exit icon.
NOTE: You will see the message “Performing Population Selection Compilation,
please wait.” If the Population Selection is compiled successfully, you exit the form. If it
does not compile successfully, you are returned to GLRSLCT and an error message
displays.
Banner Student PopSel / LetGen / CommPl
22
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Defining a Manual Population Selection
The Population Selection Definition Rules Form (GLRSLCT) also allows you to
manually select individuals who will receive letters. Or, it allows you to add individuals
to the results of a previously ran selection list.
Scenario
Add people to the results of the MS_FIRST_TIME selection list using the Population
Selection Extract Data Form (GLAEXTR).
¾
To define a population selection manually
STEP ACTION
1
Access the Population Selection Extract Data Form (GLAEXTR).
2
Enter the previous Application Name and ID.
Example: ADMISSIONS and MS_FIRST_TIME
3
Perform a Next Block function.
4
Select the drop down box under 'ID'.
5
Click on the Person Search in the 'Option List'.
6
Place a (D% or F% or N%) in the ID field and perform an execute query function.
7
Select student IDs of a few females to be added to the list.
8
Double-click on the appropriate ID to return it to the Population Selection Extract Data
Form.
9
Continue this process until all individuals selected to attend have been entered.
10
Click the Save icon.
NOTE: Notice that the System/Manual indicator for the person you have added is
M(anual), and for the others, it is S(ystem). You are now ready to run this Population
Selection with your invitation.
11
Click the Exit icon.
NOTE: You will see the message “Performing Population Selection Compilation,
please wait”. If your Population Selection is compiled successfully, you exit the form. If
it does not compile successfully, you are returned to GLRSLCT and an error message
displays.
Banner Student PopSel / LetGen / CommPl
23
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Creating a "Manual" Population Selection
In order to export your letter, you will need a list of people to attach to the letter. For this
exercise, you will create a manual population selection which will require no rules in the
Population Selection Definition Rules Form (GLRSLCT).
¾
To complete the process
STEP ACTION
1
Access the Population Selection Definition Rules Form (GLRSLCT).
2
Select ADMISSIONS application in the application field.
3
Enter a Selection ID named your initials and "AD_HOC". Example: MS_AD_HOC
4
Perform a Next Block function.
5
Enter a description for you selection. Example: List of Applicants
6
Select the Manual option.
NOTE: Because there are no rules attached to this selection, you will not see a
compilation message.
7
Perform a Next Block function.
8
Enter SARADP_PIDM in the Selection field.
9
Enter SARADAP in the From field
10
Click the Save icon.
Banner Student PopSel / LetGen / CommPl
24
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
11
Click the Exit icon.
STEP ACTION
12
Access the Population Selection Extract Data Form (GLAEXTR).
13
Select the ADMISSIONS application in the Application field.
14
Select the Selection ID created earlier. Example MS_AD_HOC.
15
Click on the Delete All option.
16
Perform a Next Block function.
17
Click the Insert Record icon.
18
Click the Search icon in the ID drop down box.
19
Select Person Search from the list.
20
Enter the names/IDs of two applicants.
21
Click the Save icon.
NOTE: Notice that the System/Manual indicator for the persons you have added is
M(anual).
22
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
25
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Deleting the Results of a Population
The Population Extract Data Form (GLAEXTR) is used to modify the population of IDs
extracted from the database for specified selection identifier.
Scenario
Invitations for orientation have now gone out to first time freshmen and the results are no
longer needed in the population selection. However, the rules used (select first time
freshmen) will be used again. The assistant wants just to delete the results.
¾
To delete a population selection manually
STEP ACTION
1
Access the Population Selection Extract Data Form (GLAEXTR).
2
Enter the previous Application Name and Selection ID.
EXAMPLE: ADMISSIONS and MS_FIRST_TIME
3
Perform a Next Block function.
4
Review the list of names.
5
Click the Rollback icon.
6
Click the Delete All Checkbox.
7
Click the Yes button to indicate that you want to delete the results.
8
Click the Exit icon.
9
Access the Population Selection Extract Inquiry Form (GLIEXTR).
10
Verify that the results have been deleted. You should receive the message "Warning:
No Records Exist."
11
Click OK.
12
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
26
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Viewing Defined Objects
The Object Definition Rules Form (GLROBJT) is used to define and maintain an object.
An object is a set of common rules used in many different population selections and
variables.
Objects are not required, but they simplify data entry and provide some consistency.
Once you define a set of rules as an object, you can reference the object rather than
manually entering the rules each time they are needed. For example, many variables and
Population Selections use the current record for names and IDs.
You can create an object with the rule SPRIDEN_CHANGE_IND IS NULL and insert
this object whenever it is needed.
Objects are not directly associated with an application. They can be referenced in any
variable or Population Selection in any application. The selection rules that are contained
within an object contain the same components as the selection rules used to define an
application.
Scenario
The Director of Admissions wants to select all men applicants who are divorced. He has
not worked much with Population Selection but knows that objects exist that define men
who are divorced. He decides to try it.
Banner Student PopSel / LetGen / CommPl
27
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To view definitions for existing objects
STEP ACTION
1
Access the Object Definition Rules Form (GLROBJT).
2
Select Men in the Object field.
3
Perform a Next Block function.
4
Review the definition of the object men.
5
Perform a Roll Back function.
6
Select Divorced in the Object field.
7
Perform a Next Block function.
8
Review the definition of the object divorced.
9
Click the Exit icon.
NOTE: These objects can be selected when creating your population selection in the
Rule block.
Banner Student PopSel / LetGen / CommPl
28
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Section 3: Letter Generation Process
Purpose
The purpose of this section is to demonstrate how to generate a letter for a particular
population in Banner Student. The letter is produced by combining Banner data generated
from the results of a Population Selection or Communication Plan rule and merging it
with the letter generation template.
This data can be exported to an external file which can later be retrieved and inserted into
the "mail merge" function in Word or WordPerfect or be generated from within Banner
itself. Banner-generate letters will be referred to as "printed" letters. Exported letters
will be known as "downloaded" letters.
Objectives
At the end of this section, you will be able to:
¾
Understand how letter generation works
¾
Understand how data is extracted for letter generation
¾
Use the letter generation process
Set up Tasks
•
Before you can complete this section, the letter generation validation forms
should already be set up.
Common Navigation Tips
Go to . . .
Enter
Enter the 7-digit form name (XXXXXXX) in the GO TO . . . field and select
the Enter key to access the form.
Tab
Use the TAB key to move from field to field in a sequential order in a block
of information.
T (or any
alpha
character)
Enter T (or any alpha character) in any date field to indicate that you want to
use today’s date (current date).
Next Block
Ctrl PgDn
You perform the Next Block function, Ctrl then PgDn keys, to access the
Next Block of information.
Banner Student PopSel / LetGen / CommPl
29
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Lesson: Letter Generation Process
Lesson Overview
In this lesson, you will learn to:
¾
Create the letter code
¾
Create the paragraph codes
¾
Build the paragraphs
¾
Build the letter
¾
Identify the Population to receive the letter
¾
Extract variable data
¾
Generate the letter
Need to Know Information
•
•
Letter Generation allows you to extract data from Banner based on a given
population, merge extracted data with text, print the results, and maintain a log of
printed letters.
Letter Generation extracts specific data and merges it with paragraphs customized
for your implementation. The extracted data is from the PIDMs, which are
extracted during a Population Selection
SELECT spriden_last_name
FROM spriden
WHERE pop_sel criteria
Naming Convention Decision
In the following documentation/steps, you will see that the naming convention uses
initials. However, this is only for training purposes. During the letter generation process,
a decision was made to use the following:
All letters will begin with the region code and the number of the campus and then have a
code of RE for RECRUITING or AP for APPLICANTS (ADMISSIONS). In some
regions, for instance Terre Haute, the number 1 will be used for all campuses – G1 for all
campuses. Some regions will use the specific campus number – A1, A2, A3, or A4. This
will be regionally determined.
Banner Student PopSel / LetGen / CommPl
30
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
EXAMPLES
Region Prefix
Campus
Office or Function
Name
G
1
RECRUITING
G1RE_INQ_1
G
1
ADMISSIONS
G1AP_ACCEPT
A
1
ADMISSIONS
A1AP_ACCEPT
A
2
ADMISSIONS
A2AP_ACCEPT
A
3
ADMISSIONS`
A3AP_ACCEPT
Banner Student PopSel / LetGen / CommPl
31
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Creating Letter Code
You will use the Letter Code Validation Form (GTVLETR) to define codes that identify
the letters you can generate in Banner. Examples of letters include acknowledgement,
applicant, and financial aid offers.
The first step in creating a new letter is establishing the letter code. Once the letter code
has been defined, you will be creating and using paragraphs in the system to indicate the
contents of this letter.
¾
To establish the letter code
STEP ACTION
1
Access the Letter Code Validation Form (GTVLETR).
2
Perform a query in the Letter Code field using your first and last initials (Example,
Mary Smith will query on MS).
NOTE: The message "Query caused no records to be retrieved" should display. If a
Letter code using your initials does display, choose other non-existing initials.
3
Exit the query and roll back.
4
Click the Insert Record icon.
5
In the Letter Code field, enter your initials and the characters EXPORT.
Example: MS_EXPORT
6
Enter a name for your letter in the Description field, using your name in the text.
Example: Mary Smith's Export Letter
Banner Student PopSel / LetGen / CommPl
32
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
7
Leave the Allow Duplicates checkbox unchecked. Checking this box will allow
duplicates of this letter to be requested or produced for a person.
NOTE: If the Allow Duplicates checkbox is unchecked, you may enter an alternate
letter code. The alternate letter code will be created for a person if they are selected
to receive a duplicate letter via the Dues Acknowledgment Process (AAPACKN) or the
Pledge Gift Acknowledgement (AGPACKN), or if they have already received the letter
in the primary key field.
NOTE: If the Allow Duplicates checkbox is unchecked and the Alternate Letter Code
field is empty, no letter is generated for an ID selected to receive a duplicate letter.
8
Click the Save icon.
9
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
33
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Creating Paragraph Code
The Paragraph Code Validation Form (GTVPARA) is used to define codes that identify
the paragraphs used in Banner letters. Paragraph codes can be assigned to letters on the
Letter Process Form (GUALETR).
Create the first paragraph code using your initials.
NOTE: You can use the same paragraph for either printed letters or downloaded letters.
The system will extract only variables from the paragraphs when using the download
feature.
¾
To create the paragraph code
STEP ACTION
1
Access the Letter Code Validation Form (GTVPARA).
2
Perform a query in the Paragraph Code field using your first and last initials (Example,
Mary Smith will query on MS).
NOTE: The message "Query caused no records to be retrieved" should display. If a
Paragraph code using your initials does display, choose other non-existing initials.
3
Exit the query and roll back.
4
Click the Insert Record icon.
5
In the Paragraph Code field, enter your initials and the characters EXP.
Example: MS_EXP
6
In the description field, enter Export Letter.
Banner Student PopSel / LetGen / CommPl
34
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
7
Enter text that describes your paragraph in the Comment field.
NOTE: It is helpful to list all of the variables that will be included in your paragraph.
The variables you need to include are: First Name, Last Name, Address, Admit Term,
and Missing Checklist Items.
8
Click the Save icon.
9
Click the Exit icon.
Letter example
The letter will look like this:
Date
<Prefix><First Name><Middle Name><Last Name>, <Suffix>
<Address Line 1>
<Address Line 2>
<City>, <State> <Zip>
Dear <Preferred Name>,
We recently converted our database information to the Banner system. Please verify the
information below. If there are any errors, contact our office at 1-800-555-5555.
<Gender>
<Current ID>
<Marital Status>
Sincerely,
Ms. Sue Doe
Banner Student PopSel / LetGen / CommPl
35
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Creating Simple Variable Rules
The Variable Rules Definition Form (GLRVRBL) is used to define, maintain, and copy a
variable. A variable is a specific piece of data in the database and the set of rules used to
select that data. Variables are used to insert variable data into letters and reference
subqueries in application rules, population selection rules, and variable rules. Any data
element associated with an ID can be defined as a variable.
NOTE: Each variable has to be created only once.
Before beginning to create your paragraph contents, you must check and make sure that
the application you will be using "owns" all of the variables required.
Banner Student PopSel / LetGen / CommPl
36
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To create the variable rules for the application
Step Action
1
Access the Letter Code Validation Form (GLRVRBL).
2
Enter the application name in the Application field.
3
Enter the name for the variable in the Variable field. Start the variable name with an
asterisk (*).
NOTE: For easy identification, include your initials. Example: *MS_ID.
4
Perform a Next Block function.
5
Enter a description for your variable in the Description field. Example ID
6
Click the down arrow next to the Type field, to designate this variable as First, meaning
the first variable to be processed by GLBLSEL. You will have to choose one variable to
use first. It is recommended that the first variable is a field that will always contain
data: for example, first name or last name.
7
Perform a Next Block function.
8
Enter SPBPERS_NAME_PREFIX in the Select field. This is the prefix column from the
SPBPERS table.
9
Enter SATURN.SPBPERS in the From field. This is the table name.
10
Enter Name Prefix in the Description field. This is a description for the logic in the
sequence.
11
Click the Save icon.
12
Click the Exit icon.
NOTE: You see the message Performing Variable Compilation, please wait. If the
variable is compiled successfully, the form will exit automatically. If your variable does
not compile successfully, an error message displays. An acknowledgement is required.
The Process Results Form (GJARSLT) displays and the error that caused the
compilation to terminate displays along with any other previous error messages.
Using the steps above, create variables for the other data elements that you are using
in your letter. Remember to click the Save icon and click the Exit icon after creating
each variable so your variables compile successful.
Banner Student PopSel / LetGen / CommPl
37
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Copying the Rules from an Existing Variable to a New
One
The Variable Rules Definition Form (GLRVRBL) is used to copy the rules from an
existing variable to a new one.
¾
To copy rules from one variable to another
STEP ACTION
1
Access the Letter Code Validation Form (GLRVRBL).
2
Enter the code for ADMISSIONS in the Application field.
3
Review the list of variables defined within the application. Select the variable
*FNAME.
4
Select the Copy Variable option from the Options menu.
5
Enter a new application code in the Application field of the Copy to block, or select it
from the list of Values.
6
Enter the new variable name in the Variable field.
NOTE: Remember to put an (*) asterisk at the beginning.
7
Click the Save icon.
8
Click the Exit icon.
9
Copy all of the variables used in your sample letter from the application Admissions to
your personal application.
NOTE: Don't forget to save each time you copy or the new variable does not compile.
All saved variables will be compiled at one time when you exit.
Banner Student PopSel / LetGen / CommPl
38
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Defining the Contents of a Paragraph
Initially when you are creating letters and paragraphs, you will structure your letter and
create your paragraphs to attach to your letter.
The stages of the process are described below:
¾
Identify variables for the letter
¾
Identify the population for the letter using Population Selection, Pending
Mail, or Manual Selection
¾
Extract the variables
¾
Generate the letter
¾
Send the letter to the printer.
The Paragraph Form (GUAPARA) is used to build a paragraph that can be inserted in
letters on the Letter Process Form (GUALETR). A paragraph can include text, variables,
and formatting commands.
Banner Student PopSel / LetGen / CommPl
39
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
About the letters
All letters must have at least one paragraph defined. Additional paragraphs may be
created for organizing variables to be downloaded.
Paragraph example
The paragraph you define will contain the following information:
Today’s Date
Mary Smith (your name)
Street Address Line 1
Street Address Line #2
Street Address Line #3
City, State, Zip Code
Dear Mary,
(Text would go here. The text is defined in the mail merge letter of the chosen word processing
application, such as Microsoft Word or Corel WordPerfect.)
¾
To define the contents of the paragraph you created previously
STEP ACTION
1
Access the Paragraph Form (GUAPARA).
2
Enter the paragraph code name you created earlier in the Paragraph field. Example
MS_EXP
3
Perform a Next Block function.
4
Click on the drop down box under the Text/Variable/Formatting Command.
5
Select the ADMISSIONS application in the Application field.
6
Perform a Next Block function.
7
Execute the query function.
8
Select the variables listed below one at a time.
- *TDATE
- *FNAME
- *LNAME
- *STR1
- *STR2
- *STR3
- *CITY
- *STATE
9
Click the Save icon. Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
40
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Reviewing and Changing the Contents of a Paragraph
After reviewing a sample copy of the letter, you realized that you did not include term as
a variable. You need to change the paragraph to include the variable for term.
¾
To make the changes
STEP ACTION
1
Access the Paragraph Form (GUAPARA).
2
Enter the paragraph code you created. Example: MS_EXP
3
Perform a Next Block function.
4
Tab down to *STATE
5
Click the Insert Record icon.
6
Add the ZIPC code variable -- *ZIPC.
7
Click the Save icon.
8
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
41
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Creating a Letter by Adding Paragraphs
You will use the Letter Process Form (GUALETR) to build a letter from paragraphs
created on the Paragraph Form (GUAPARA). Note: If using the download option, you
can create paragraphs that contain only variables. If you use paragraphs that contain
formatting commands, text and variables, the download process will select only the
variables.
Scenario
You finished defining the individual paragraph for the new first time freshmen
orientation letter and defining a code for the letter. You are ready to define the contents
of the letter.
¾
To define the contents of the letter
STEP ACTION
1
Access the Letter Process Form (GUALETR). Here you will combine your paragraph
codes to form a letter.
2
Enter the letter code name you created earlier in the Letter field or perform a query to
locate your letter code. Example: MS_EXPORT
3
Perform a Next Block function.
4
Choose the paragraph you just created. Example: MS_EXP
5
Enter 1 in the Sequence field.
6
Click the Save icon.
7
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
42
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using the Letter Extract Process
You finished setting up your letter. It is time to produce your letters. The Letter Extract
Process (GLBLSEL) extracts the data as specified in the variables that are in the
requested letter. The extracted data is inserted into the Letter Collector Table
(GLRCOLR).
The Letter Extract Process (GLBLSEL) extracts variable data from the Banner database
to be included. This COBOL program is run before executing the Letter Generation Print
Process (GLRLETR). GLBLSEL can be run for all pending letters (letters waiting to be
printed) for a letter code or for a letter code for a specific population. This form will also
inform users if a letter cannot be created because the ID did not match the selection or
address criteria. The log file will list the names and IDs for those who did not receive the
letter because of the missing address or because other non-address selection criteria was
not met.
Banner Student PopSel / LetGen / CommPl
43
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To complete the process
STEP ACTION
1
Access the Letter Extract Process (GLBLSEL).
2
Navigate to the Printer Control block and select the printer that you are using.
Example: DATABASE
3
Navigate to the Parameter Values block and enter the above parameters for the job
submission.
#
Parameter
Description
01
Application (Required)
Select or type in the ADMISSIONS application.
02
Process Pending Letters
N is the default. N only processes a specific
letter. Y produces all pending letters for the
letter code entered in the next parameter.
Procedurally, pending letters should be printed
for only a specific letter code. If you select Y,
you cannot use the Population Selection
parameters.
(Required)
03
Letter Code (Required)
Mary Smith would enter MS_EXPORT.
04
Selection ID
Letters are produced from this Population
Selection. You cannot use a Population
Selection if you selected Y in parameter 02
Process Pending Letters. Enter the Selection
ID for the letter. Example: MS_FIRST_TIME
05
Creator ID
Required only if using a Population Selection.
This is the ID of the person who created the
Population Selection ID.
06
User ID
Required only if using a Population Selection. It
is the user ID of the person who ran GLBDATA
to create the Population Selection.
Banner Student PopSel / LetGen / CommPl
44
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
07
Term Code
Student system only. Required only when
extracting Pending Student System letters
(when parameter 02 = Y). One term can be
processed per run. Example: 200820
08
Aid Year
Financial Aid system only. Required for those
letters that are pending for the aid year
specified. Only one aid year is extracted per
run.
09
Address Selection Date
Enter the address date for which the address of
choice must be effective. If no date is entered,
the current date is used. If you want to use a
value other than the system date, you can
enter a not-null value on GJAPCTL.
10
Address Type (Required)
The address selection is a three-character
field. The first character is the priority of the
address and the remaining two characters are
the address type from the Address Type Code
Validation Form (STVATYP).
Example: 1MA, 2PR
In this example, the mailing address (MA) is
the first choice and the permanent address
(PR) is the send choice. Each type must be
entered on a separate line. Use the Insert
Record function to create a new line. Enter
parameter number 10 and the description
defaults. Enter the new address type in the
Values field.
11
Detailed Error Report
Valid values are Y or N. Example: N
12
Detailed Execution
Report
Valid values are Y or N. Example: Y
4
Navigate to the Submission block.
5
Select the Submit radio button, if necessary.
6
Click the Save icon. Note: Note the number in the auto hint line after saving.
7
Review the output by selecting Review Output from the Options menu.
NOTE: Use the number you noted in the previous step to review the output of the
GLBSEL run. By reviewing the output, you can see the IDs that did not have
addresses and will not have letters created for them.
8
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
45
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Banner Student PopSel / LetGen / CommPl
46
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using the Letter Generation Print Report
After you have run the Letter Generation Extract Process (GLBLSEL), the Letter
Generation Print Report (GLRLETR) needs to be executed. You have the option to:
•
•
•
generate either letters or a file that can be downloaded to Word or WordPerfect
print a summary report
update the General Mail Table (GURMAIL).
Banner Student PopSel / LetGen / CommPl
47
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To complete the process
STEP ACTION
1
Access the Letter Generation Print Report (GLRLETR).
2
Navigate to the Printer block and enter DATABASE.
NOTE: To do a download of data, you would always want to use DATABASE. Note:
You can review the output on the Save Output Review Form (GJIREVO) where job
outputs can be viewed regardless of file extension. The log file can be viewed for
GLBLSEL. The log, list and doc (for mail merge) files can be viewed for GLRLETR.
These files can be written to the database, if so requested, and can be displayed or
saved to your local desktop machine.
3
Navigate to the Parameter Values block to enter the parameters for your job. Use the
table on the previous pages.
#
Parameter
Description
01
Application Code
Select or type in the ADMISSIONS
application.
(Required)
02
Word Process Extract
Option
Enter the number corresponding to the
extract needed:
(Required)
• 0 – Banner “printed” letter (default)
• 1 – Microsoft Word “download” file
• 2 – WordPerfect “download” file
Choosing 1 or 2 produces an output file that
contains a header record containing all of the
variables that are used in the letter and the
records for each ID in the population
separated by commas. The name of the file
that is produced is the name of the letter with
the extension.doc.
Example: James Quick’s letter would be
JQ_LETR.doc. Enter 1 for Microsoft Word
"download".
03
Print ALL Pending Letters
(Required)
04
Letter Code
(Required)
05
Sort Variable
Banner Student PopSel / LetGen / CommPl
Enter Y to print all pending letters for the
application code. Enter N to print a specific
letter. The default value is N.
Enter the letter code of the letter to be
printed. Example: MS_EXPORT
To sort the printed letters in a specific order,
enter the name of a variable that determines
the order. The sort variable must be
contained in the letter.
48
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
06
Term Code
(Required)
07
Module Code
(Required)
Required for the Student System only. All other
systems use the default value of 999999. Example:
200820
Enter the one character module code associated with
the letter being produced. This code updates the
print date of published materials in the mail table that
matches the module code entered and produces a
list of the recipients and their materials in the report
control information. Published materials are items
that are sent to individuals but are not printed by
Banner Letter Generation, such as college catalogs,
sports brochures, and preprinted forms.
A Admissions
B Billing
C Constituent
G Gifts/Pledges
F Registration
H History
R Recruiting
S Student
Enter S for Student
08
Audit Indicator
Enter Y to run in audit mode. One sample letter is
produced for each letter code extracted. No updates
are done. Enter N to produce letters and a summary
report. It updates the print dates for the generated
letters existing on the Mail Query Form (GUIMAIL) or
creates a new entry. It also deletes all the data in the
Letter Collector Table (GLRCOLR) for the letters
selected to print.
09
Free Format Date 1
Used only for producing letters via Banner. It is not
used if you are performing an extract for Microsoft
Word or WordPerfect. Enter a free formatted date to
be printed on the requested letter for variable
*DATE1. *DATE1 can be a variable on a letter that
has not been built on the Variable Rules Definition
Form (GLRVRBL). Its value becomes what is entered
for the parameter.
10
Free Format Date 2
Used only for producing letters via Banner. It is not
used if you are performing an extract for Microsoft
Word or WordPerfect.
Enter a free formatted date to be printed on the
Banner Student PopSel / LetGen / CommPl
49
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
requested letter for variable *DATE2. *DATE2 can be
a variable on a letter that has not been built on the
Variable Rules Definition Form (GLRVRBL). Its value
becomes what is entered for the parameter.
11
Free Format Date 3
Used only for producing letters via Banner. It is not
used if you are performing an extract for Microsoft
Word or WordPerfect. Enter a free formatted date to
be printed on the requested letter for variable
*DATE3. *DATE3 can be a variable on a letter that
has not been built on the Variable Rules Definition
Form (GLRVRBL). Its value becomes what is entered
for the parameter.
12
Aid Year Code
Required only for the Financial Aid System
4
Navigate to the Submission block.
5
Select the Submit radio button, if necessary.
6
Click the Save icon.
7
Click the Exit icon.
8
Select Options.
9
Select Review Output (GJIREVO).
10
Double click in the File Name field. Should return .log file and .doc file.
11
Double click on the .doc file.
12
Save to temporary file.
13
Click the Exit icon.
14
Select Options
15
Select Show Document (Save and Print File).
16
Select Save File (Output saved as file c:\temp\glrletr_19425.doc) - Example
17
Select OK.
18
Create Letter in Word or WordPerfect.
19
Select Tools.
20
Select 'Letter and Mailings…'.
21
Select Mail Merge.
Banner Student PopSel / LetGen / CommPl
50
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
22
Select document type: letters and Next.
23
Select starting document: use the current document and Next.
24
Select recipients: use and existing list.
25
Select browse and find the .doc file you just saved and Next.
26
Click a location in the document, and then click More items.
27
Select a field and select insert then close.
28
Repeat these steps until all recipient information is entered and Next.
29
Preview the letter.
30
Edit, Save, or Print the letter.
Banner Student PopSel / LetGen / CommPl
51
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using the Letter Generation Print Report
After you have run the Letter Generation Extract Process (GLBLSEL), the Letter
Generation Print Report (GLRLETR) needs to be executed. You have the option to:
•
•
•
generate either letters or a file that can be downloaded to Word or WordPerfect
print a summary report
update the General Mail Table (GURMAIL).
Banner Student PopSel / LetGen / CommPl
52
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Summary
As a result of completing this workbook, you have
•
•
•
•
•
•
•
defined the contents of a paragraph
reviewed and change the contents of a paragraph
created a letter by adding paragraphs
defined the rules for a single variable using several data elements
copied the rules from an existing variable to a new one
created a variable using a join
generated a print report.
Banner Student PopSel / LetGen / CommPl
53
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Section 4: Communication Plan Processing
Purpose
The purpose of this section is to explain the Communication Plan processing at Ivy Tech.
Communication Plan processing permits you to automatically assign a recruit, applicant,
or student to a communication plan online, according to their campus, level, degree, and
college, and the rules defined for your institution.
Automatic mail generation helps the institution communicate quickly and efficiently with
prospects, applicants, and students. Based on the various "attributes" of a person and their
stage of processing (recruiting, admissions, general student), the system generates
different pieces of mail automatically. In the same manner, you can enter requests for
specific mailings to be produced. All mailings are dated and marked with a material code,
letter code, and communication plan where applicable, so you can keep a full audit trail
of correspondence sent to a person. You develop the actual letters online to send to a
person according to the specific needs of your institution.
Objectives
At the end of this section, you will be able to:
•
•
Set up communication plans
Implement communication plans
Set up Tasks
•
Before you can complete this section, the communication plan validation forms
should already be set up.
Common Navigation Tips
Go to . . .
Enter
Enter the 7-digit form name (XXXXXXX) in the GO TO . . . field and
select the Enter key to access the form.
Tab
Use the TAB key to move from field to field in a sequential order in a
block of information.
T (or any alpha
character)
Enter T (or any alpha character) in any date field to indicate that you want
to use today’s date (current date).
Next Block
Ctrl PgDn
You perform the Next Block function, Ctrl then PgDn keys, to access the
Next Block of information.
Banner Student PopSel / LetGen / CommPl
54
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Lesson: Setting up Communication Plans
Lesson Overview
In this lesson, you will learn to:
¾
¾
¾
¾
¾
¾
Determine material recipients
Define materials and rules
Use material groups
Associate materials with plans
Use communication plans
Assign communication plans
There is also an exercise at the end for you to complete on your own.
Need to Know Information
Communication plan processing is initiated in a variety of situations in the Recruiting and
Admissions module when these conditions occur:
• new application or recruiting record, and curriculum records are added, and
applicant communication plan matches are found on SOACOMM,
• a new curriculum or field of study is added to a recruit or applicant record, and
new applicant communication plan matches are found on SOACOMM,
• the withdrawal code is added or changed, or a new source/background institution
code is added, and active communication plan records exist for the recruit or
applicant.
• a curriculum record is deleted, and active communication plan records exist for
the recruit or applicant.
• a recruiting or admissions record is deleted or inactivated, and active
communication plan records exist.
• a recruiting or admissions curriculum or field of study record is inactivated, and
active communication plan records exist.
• the recruiting or admissions curriculum is changed and active communication
plan records exist.
Banner Student PopSel / LetGen / CommPl
55
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Determining Material Recipients
A communication plan defines standard materials and groups of materials to be sent to a
prospect/applicant/student at pre-defined time intervals. Once a person is assigned to a
communication plan, material is generated on the Student Mail Form (SUAMAIL).
Please note that the person must meet the material rule criteria for each specific material
in order to receive all materials in the plan. Otherwise, only those materials within the
plan for which the person is qualified are generated on the Student Mail Form
(SUAMAIL).
In order to be qualified to receive a specific material, the person must meet all the
required criteria as defined on the Material Form (SOAMATL). On this form, the
institution defines the required attributes which a person must have in order to receive the
material.
For instance, perhaps your institution has an Institutional Scholarship program called
"Presidential Scholarship for Freshman Minority Students". You would only like those
students that have: (1) received a score of 700 or better on either the Math SAT or the
Verbal SAT, (2) are members of a minority ethnic group, and (3) are new freshman at
your institution. The Material Form (SOAMATL) allows you to establish such
requirements, giving you strong controls over the materials that leave your institution.
If a specific material is part of a person's communication plan, and the individual meets
all the criteria for the material, the material is generated automatically to the Student Mail
Form (SUAMAIL). If a communication plan is added for a person, but the person does
not meet the required criteria to receive the material, no materials are generated. When
the individual does meet the criteria, and the plan is still active, the material is generated
for the person at that time.
Banner Student PopSel / LetGen / CommPl
56
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
For example, a prospect may be in the communication plan defined for undergraduate
students interested in the College of Business. A specific material, such as a College
Night Follow-Up Letter, may be associated with this communication plan. The material
rules for this letter may require that the prospect have a contact defined as "college
night". At the time the plan is assigned, the person did not have a contact of college night.
However, three weeks later, the college night contact is entered. At this time, the College
Night Follow-Up Letter is automatically generated on the Student Mail Form
(SUAMAIL).
Defining Materials and Rules
When materials are defined on the Material Form (SOAMATL), the user must first define
specific information regarding the material in the Material information. These specifics
include indicating whether the material is a published work or is generated within the
system using Letter Generation. If the material is generated, a corresponding letter code
must be entered. Initials and the capability of overriding initials are defined here. This
section is also where the user determines whether a duplicate mailing of this material is
permitted.
There are a set of rules in the Material Rules section which may be used to designate who
receives certain materials. The following criteria may be used in combination to
determine which materials should be created for a person: Department, Major, Contacts,
Interests, Attributes, Gender, State or Province, Ethnicity, Legacy, Citizenship, Recruit
Type, Test Scores, Admission Type, Admission Decision, Student Type, Source,
Application Status, ESP Code, and Region or Division.
If a person meets the criteria defined for a specific material, and it is part of their
communication plan, the system sends the individual the corresponding material.
Automatic mailing of materials is based on a person's characteristics and the status of the
recruiting record, admissions application, or general student record.
Material rules have an OR condition within a rule type, and rules have an AND condition
among rule types. For example, in the Material Rules section, the codes which determine
the rules for each field, such as the Department field, follow the OR condition. The codes
which determine the rules for all the fields in the section, from Department through
Region Or Division, follow the AND condition in relation to each other.
Suppose your institution offers scholarships to new freshmen who have scored well on
either the SAT verbal or SAT mathematics tests. You should set up rules for this
scholarship material or letter that indicate these requirements. To accomplish this task,
you should enter in the test score rules that the person must have an SAT verbal score OR
an SAT math score of 700, AND a student type of "B" (new freshman) to receive this
material. Only these people with a student type of "B", and either an SAT verbal or SAT
math score or 700 or better, will receive this material. Materials are only generated for
departments, majors, and general student admit codes and student types when a
communication plan is added.
Banner Student PopSel / LetGen / CommPl
57
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Materials for non majors, departments, and general student admit codes and student types
are generated from the following forms:
SAAACKL
SAAADMS
SAADCRV
SAAQUIK
SGASADD
SGASTDN
SLARMAP
SOAAPPT
SOACCOL
SOAPLAN
SOATEST
SPACMNT
SPAIDEN
SPAPERS
SRAQUIK
SRARECR
Using Material Groups
Once all materials have been defined, and their corresponding rules have been
established, material groups may be used. Using group codes is a shorthand method of
assigning a group of materials to multiple communication plans, rather than assigning
each material individually to each communication plan.
Groups of materials are defined on the Communication Group Form (SOACGRP). Use
this form to specify the material codes which you would like to be part of the
communication group. An example of a group of materials may be Athletic Brochures.
Instead of adding each athletic brochure at your institution to each communication plan,
use group code processing to ease data entry. On the Communication Group Form
(SOACGRP), enter the group code for Athletic Brochures in the Key Information, and
add the material codes for such things as football brochures, baseball brochures, and field
hockey brochures. Adding the group code to your communication plans associates each
of the materials in the group with the plan. Please note that the rules for each material are
checked individually. If a person meets the rules for the football brochure, and no others
in this group, they will only receive the football brochure.
Associating Materials with Plans
After defining your institution's materials, material rules, and communication groups, you
must determine which materials and groups of materials will be part of each of your
institution's communication plans. Materials and communication groups are added to a
plan on the Communication Plan Form (SOACPLN). Use this form to define individual
materials for a plan and their associated wait days and to assign groups of materials to a
communication plan. If a specific material is added for a communication plan, and that
material is also part of a group of materials, the system does not generate the material
twice to the Student Mail Form (SUAMAIL). It checks your plan rules and only
generates one of the materials that is needed.
Banner Student PopSel / LetGen / CommPl
58
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using Communication Plans
Communication plans may be automatically generated online in the Recruiting,
Admissions, and General Student Modules and are controlled by the user. If a person
meets the requirements to be assigned to a communication plan as defined on the
Communication Rules Form (SOACOMM), the Communication Plan Change window
appears, and the user is given the option to assign a communication plan, or exit from the
window.
To exit from the window, you must make some change to the record (such as remove a
plan and Save, change a plan and Save) or simply save the existing/assigned plans. Use
the Return button to return to the main window of the form. The following criteria,
Campus, Level, College, Degree, Field of Study Type, Field of Study Code (major), and
Curricula (Primary, Secondary, Any) as defined on the Communication Rules Form
(SOACOMM), and the person's stage of processing, either recruit, applicant, or student
(learner), determine the communication plan in which a person is placed. You can define
rules that will assign a communication plan based upon any field of study type (i.e., not
just major) and/or elements in the primary curriculum, secondary curricula, or all
curricula.
When creating your institution's communication plan rules, be aware that any fields
which are left blank are treated as wildcards. For example, if your institution has two
communication plans, one for undergraduate level and one for graduate level students,
you should create your rules with an undergraduate level code specified for the
undergraduate communication plan. Level would be the only rule defined for the plan, so
any person at that level and indicated processing stage (recruit, applicant, or student) is
placed in that communication plan. The same would be true for the graduate level
students.
Please note that communication plans may be set up at a broad level by using one rule,
such as by level only, or they may be specific for each campus, level, college, and degree
combination. This decision should be made prior to implementing this functionality at
your institution.
Banner Student PopSel / LetGen / CommPl
59
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Assigning Communication Plans
The Communication Plan Assignment Form (SOAPLAN) is used to assign or view
assigned communication plans for a person. The Module Indicator radio group value of
Recruiting, Admissions, or Student, indicates which module the plan is for. A
communication plan follows a person through these modules and may be turned off or on
as processing changes or as the plan changes according to the rules which have been
defined.
A person may have multiple active plans. Multiple plans may exist within a module or
across modules. For example, if your recruiting communication plan rules are set up as
different plans for different campuses, and a student is a prospect for both campuses, that
student may have active recruiting communication plans for both campuses.
Also, if a student is currently enrolled at your institution as an undergraduate student and
has a student communication plan and is also considered a prospect for the graduate
program, the student may also have an active recruiting module communication plan.
Electronic Prospect Load Process (SRTLOAD)
Admissions Decision Calculation Report (SARBDSN)
Student Type Update (SHRTYPE)
A person's communication plans are differentiated by term code and application or
sequence number on the Communication Plan Assignment Form (SOAPLAN). The term
code is associated with recruiting or admissions status, while the application or sequence
number identifies the specific recruiting or admissions application. When the Active
(Indicator) in the Assignment section is checked, the person will receive materials for the
plan code. When the Mail Exists (Indicator) in the Assignment section is checked, the
materials have been automatically posted to the Student Mail Form (SUAMAIL) and
have been sent via Letter Generation, based on the plan code that generated the materials.
Perform a Count Query Hits function from the Plan field in the Assignment section to
create materials for a new communication plan for the person whose ID is in the Key
Information.
Banner Student PopSel / LetGen / CommPl
60
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Lesson: Implementing Communication Plans
The plan can be as simple as assembling stacks of materials you currently send out and
labeling those stacks or planning on paper.
Lesson Overview
In this lesson, you will learn to:
¾
¾
¾
¾
¾
¾
Define material codes
Define base information for material
Define group codes and attach materials
Define communication plan codes
Attach materials to communication plans
Assign communication plans
There is also an exercise at the end for you to complete on your own.
Need to Know Information
•
•
•
•
Items sent to recruits and/or students
Events (dates, for example) that trigger when each item is sent
Items that are triggered by events and “whim” items
Variables for each letter that is sent
Naming Convention Decision
In the following documentation/steps, you will see that the naming convention uses
initials. However, this is only for training purposes. During the communication plan
process, a decision was made to use the following:
All communication plans will begin with the region code and the number of the campus.
In some regions, for instance Terre Haute, the number 1 will be used for all campuses –
G1 for all campuses. Some regions will use the specific campus number – A1, A2, A3, or
A4. The rest of the name will be regionally determined.
EXAMPLES
Region Prefix
Campus
G
1
A
1
A
2
Banner Student PopSel / LetGen / CommPl
61
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Defining Material Codes
The Material Code Validation Form (STVMATL) is used to define codes that identify the
materials you can generate in Banner. Examples of materials include letters, view books,
and brochures.
NOTE: If the material is a generated letter, you must define a corresponding letter code in
GTVLETR first.
Banner Student PopSel / LetGen / CommPl
62
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
¾
To establish the material code and attach the material
The first step in creating new material is establishing the material code. Once the
material code has been defined, you will be able to attach the material to the code.
STEP ACTION
1
Access the Material Code Validation Form (STVMATL).
2
Click the Insert Record icon.
3
In the Material Code field, enter your initials and the characters "BS."
Example: MSBS
4
Enter a name for your material in the Description field, using your name in the text.
Example: Mary Smith's Bumper Sticker.
5
Click the Insert Record icon.
6
In the Material Code field, enter your initials and the characters "VB."
Example: MSVB
7
Enter a name for your material in the Description field, using your name in the text.
Example: Mary Smith's View Book.
8
Click the Insert Record icon.
9
In the Material Code field, enter your initials and the characters "WL."
Example: MSWL
10
Enter a name for your material in the Description field, using your name in the text.
Example: Mary Smith's Welcome Letter.
11
Click the Save icon.
12
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
63
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Define Base Information for Material
The Material Form (SOAMATL) is used to indicate whether the material is published or
generated. Published materials are not created from within Banner (ex: a catalog).
Generated materials are created from within Banner such as letters. If generated, you
must enter the letter code. You will also define the rules which the
recruit/applicant/student must meet to receive this material.
NOTE: Material Rules - a box with lines through it means that there is a rule set up using
criteria from this button. If all boxes are solid, that means that everyone will receive this
material.
¾
To define material and material rules
STEP ACTION
1
Create an initial code in STVINIT. Example: MS. Then select this initial code in the
generated materials block. (Regionally determined)
2
Access the Material Form (SOAMATL).
3
Enter the code you created for the bumper sticker. Example: MSBS
4
Perform a Next Block function.
5
Enter P in the published or generated field.
Banner Student PopSel / LetGen / CommPl
64
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
6
Click the Allow duplicate entry on SUAMAIL checkbox.
7
Perform a Next Block into the Rules Block.
8
Select the Admission Type.
9
Search in the Admission Type and select FT for new and click OK. Click the Return
button. Click the Save icon.
10
Enter the code you created for the view book. Example MSVB
11
Perform a Next Block function.
12
Enter P in the published or generated field.
13
Click the Allow duplicate entry on SUAMAIL checkbox.
14
Perform a Next Block into the Rules Block.
15
Select the Admission Type.
16
Search in the Admission Type and select FT for new and click OK. Click the Return
button. Click the Save icon.
17
Enter the code you created for the welcome letter. Example MSWL.
18
Perform a Next Block function.
19
Enter G in the published or generated field.
20
Click the Allow duplicate entry on SUAMAIL.
21
In the generated materials block for letter, enter the letter code you created earlier in
the GTVLETR form. Example: MS_EXPORT.
22
Perform a Next Block into the Rules Block.
23
Select the Admission Type.
24
Search in the Admission Type and select FT for new and click OK.
25
Click the Return button. Click the Save icon. Click the Exit icon.
NOTE: Material rules have an OR condition within a rule type, and rules have an AND
condition among rule types. For example, in the Material Rules section, the codes which
determine the rules for each field, such as the Department Rules field, follow the OR
condition. The codes which determine the rules for all fields in the section, from
Department through Region or Division, follow the AND condition in relation to each
other.
Banner Student PopSel / LetGen / CommPl
65
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Define Group Codes
The Communication Group Code Validation Form (STVCGRP) is used to define groups.
Once all materials have been defined and their corresponding rules have been established,
you may use material groups -- GROUPS are optional. Using group codes is a shorthand
method of assigning the code to multiple communication plans, rather than assigning the
code individually to each communication plan. (Example: Attach all athletic brochures
to a group then attach the group to a communication plan rather than attaching the
brochures individually).
¾
To define a group code
Step Action
1
Access the Communication Group Code Validation Form (STVCGRP).
2
Insert a record -- blank line.
3
Enter a new name in the group code. Example ADMCO.
4
Enter a description 'Admission’s Welcome.’
5
Click the Save icon.
6
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
66
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Attach Materials to Group Codes
Use the Communication Group form (SOACGRP) to attach selected materials to your
group.
¾
To attach materials to a group code
STEP ACTION
1
Access the Communication Group Code Validation Form (SOACGRP).
2
Enter the group code you created earlier in the STVCGRP form. Example: ADMW.
3
Perform a Next Block function.
4
Select the three materials you created and defined earlier. Example: MSBS, MSVB,
and MSWL
NOTE: Wait Days may be assigned to designate when materials should be sent for a
plan. By using this methodology, you need only associate the group code with your
communication plans, and if the members assigned to the plan meet the criteria for
any or each of the materials within the group, they are automatically sent those
materials for which they qualify. This processing should ease the burden of data entry
when communication plans are created at your institution.
5
Click the Save icon.
6
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
67
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Define Communication Plan Codes
Use the Communication Plan Code Validation Form (STVCPLN) to define
communication plans. These codes define the communication plans to which recruits /
applicants / students may be assigned at your institution.
¾
To define communication plan codes
Step Action
1
Access the Communication Plan Code Validation Form (STVCPLN).
2
Insert a record -- blank line.
3
Enter a new name in the group code. Example MSAP
4
Enter a description 'Mary's New Admission Plan.’
5
Click the Save icon.
6
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
68
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Attach Materials to Communication Plans
Use the Communication Plan Form (SOACPLN) to attach selected materials to a
communication plan. Once you have defined the communication plan codes, materials,
and communication groups, you need to specify which materials and groups should be
part of each communication plan. This form is used to assign materials and groups of
materials to a communication plan. Groups of materials are set up, added to
communication plans, and maintained at the group level. Materials assigned to a plan,
which are also included in groups of materials assigned to a plan, are not duplicated when
mailed. Wait Days may be assigned to designate when materials should be sent for a
plan.
¾
To attach materials to and/or groups to a communication plan
Step Action
1
Access the Communication Plan Form (SOACPLN).
2
Enter the group code you created earlier in the STVCPLN form. Example: MSNR
3
Perform a Next Block function.
4
Select any materials that you would like included in the communication plan.
5
Perform a Next Block function to add groups to the communication plan.
6
Select the group you created earlier in SOACGRP. Example: MSAP
7
Click the Save icon.
8
Click the Exit icon.
Banner Student PopSel / LetGen / CommPl
69
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Assigning Communication Plans
Use the Communication Rules Form (SOACOMM) to establish the rules by which the
system automatically assigns a person to the specified communication plan. The person
must match all criteria of the plan for the communication plan to be assigned. Now that
you have fully defined the communication plans to be used at your institution, you must
specify the rules which a recruit/applicant/student must meet in order to become assigned
to a communication plan. The form is also used to calculate the communication plan to
which a person is assigned when a record is added or updated in the database.
NOTE: If a recruiting level is not defined during the Electronic Prospect Load Process
(SRTLOAD), the default value of level 00 will be assigned to each of the added
recruiting records. If you choose to use this default level value and intend to use
communication plan processing, you need to create communication plan rules for the 00
level on the Communication Plan Rules Form (SOACOMM). Otherwise, your newly
created recruits will not be assigned to a communication plan. It is also important to note
that the default level value of 00 is also used when initially creating recruiting records on
the Recruit Prospect Information Form (SRARECR) and the Quick Recruit Form
(SRAQUIK).
¾
To specify assignment rules
STEP ACTION
1
Access the Communication Rules Form (SOACOMM).
2
Set up the rules associated with you communication plan.
You define rules by Level, Campus, College, Degree, Field of Study Type, Field of
Study Code (major), and Curricula (Primary, Secondary, Any). These criteria, as well
as the person's stage of processing the Recruiting, Admissions, or General Student
modules determine which plan a person is placed in. Any fields which are left blank
are treated as wildcards.
3
Select the communication plan grouping you just created under the recruit section.
Example: MSAP
Banner Student PopSel / LetGen / CommPl
70
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
STEP ACTION
4
Click the Save icon. Click the Exit icon.
Assigning a Communication Plan to an Individual
If you wish to assign a communication plan to an individual person, you can use the
Communication Plan Assignment Form (SOAPLAN) to do so. This is handled much the
same way as the SOACOMM form, but it just selects specific persons.
Banner Student PopSel / LetGen / CommPl
71
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using the Communication Plan Change Window
The Communication Plan Change Window displays in the forms listed below, if any
curriculum record is added or updated in the database and this causes a change of
communication plan.
•
•
•
•
•
•
•
•
Recruit Prospect Information Form (SRARECR)
Quick Recruit Form (SRAQUIK)
Admissions Application/Checklist Summary Form (SAAACKL)
Admissions Application Form (SAAADMS)
Quick Entry Form (SAAQUIK)
Admissions Decision Form (SAADCRV)
General Student Form (SGASTDN)
Communication Plan Collector Form (SOACCOL)
The Communication Plan Change window for the student is automatically displayed on
SAAADMS, SAAQUIK, SRAQUIK, SRARECR, and SGASTDN under the following
conditions:
•
•
•
•
•
•
A new host record (SRBRECR, SARADAP, SGBSTDN) is added along with its
primary curriculum, and a communication plan matches the curriculum.
A new curriculum or field of study is added to a host record, and a
communication plan matches the curriculum and does not currently exist for the
student's recruiting, application, or general student record.
A host record is inactivated by a withdrawal or other source/background
institution code (SRBRECR, SARADAP), or the student status on the general
student record (SGBSTDN) is inactive.
A host record is deleted, and communication plans exist for that record.
A curriculum or field of study is deleted, and communication plans exist for the
host record.
A curriculum or field of study is inactivated, and communication plans exist for
the host record.
The Communication Plan Change window is not displayed automatically from
SOACCOL and SAAACKL. The user must select the Communication Plan item from the
Options Menu.
The Communication Plan Change window is displayed automatically from SAADCRV if
the resulting decision is to create a new general student record, or when a new curriculum
is added for the student, and a new communication plan matches the curriculum.
Banner Student PopSel / LetGen / CommPl
72
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
When the Communication Plan Change Window appears in one of these forms, the user
is given the option to delete, inactivate, or ignore the initial communication plan and any
pending materials, and the option to add the new communication plan. This is all done by
setting the checkboxes to Yes, No, Inactivate, or Delete (by checking or unchecking
them) and then saving the data and acknowledging the change. If no change in plans is
desired, use Save to exit from the window.
Note: To exit from the window, you must make some change to the record (such as
remove a plan and Save, change a plan and Save) or simply save the existing/assigned
plans. Use the Return button to return to the main window of the form.
For example, when a recruiting record is first added to the database via the Recruit
Prospect Information Form (SRARECR), if the prospect's campus, level, college, and
degree match a communication rule on the Communication Rules Form (SOACOMM),
the Communication Plan Change Window appears. The user may save this
communication plan or exit from the window.
As the prospect becomes an applicant, similar steps must be taken to delete, inactivate, or
continue with recruiting communication plans and the addition of admissions or general
student plans. The Communication Plan Change Window will appear in the Admissions
Application Form (SAAADMS) when a record is added to the database. After the
admissions record is saved to the database, the system determines whether a
communication plan exists, needs to be changed, or should be added for the person.
At the time the Communication Plan Change Window appears in the Admissions
Application Form (SAAADMS), the user is given the option to:
•
•
•
•
A host record is inactivated by a withdrawal or other source/background
institution code (SRBRECR, SARADAP), or the student status on the general
student record (SGBSTDN) is inactive.
A host record is deleted, and communication plans exist for that record.
A curriculum or field of study is deleted, and communication plans exist for the
host record.
A curriculum or field of study is inactivated, and communication plans exist for
the host record.
The Communication Plan Change window is not displayed automatically from
SOACCOL and SAAACKL. The user must select the Communication Plan item from the
Options Menu. The Communication Plan Change window is displayed automatically
from SAADCRV if the resulting decision is to create a new general student record, or
when a new curriculum is added for the student, and a new communication plan matches
the curriculum.
Banner Student PopSel / LetGen / CommPl
73
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Using the Collector File
The Communication Plan Collector Form (SOACCOL) contains changes that occur in a
communication plan. Records added to the form may be updated individually online by
performing a Count Query Hits function or by selecting the Communication Plan item on
the Options Menu. If a change is being made to a communication plan, the
Communication Plan Change Window appears. If the collector record is to add materials
only, no window appears after performing a Count Query Hits function; however, the
materials are generated. After processing a collector record on this form, delete the record
from the collector file.
The Communication Plan Processing Report (SORCPLN) allows you to process all
collector records in batch. You may clean up the collector file prior to running this batch
process by entering the Communication Plan Collector Form (SOACCOL) and deleting
those records which you do not wish to process.
Banner Student PopSel / LetGen / CommPl
74
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Similar steps need to be taken when an applicant becomes a student. Please note that after
registration exists, changes in student information that may cause a plan change (campus,
level, college, degree) must be made on the Student Course Registration Form
(SFAREGS), and that the Communication Plan Change Window will not appear in this
form. Instead, a collector file which can be viewed online in the Communication Plan
Collector Form (SOACCOL) is updated with the changes made that cause the
communication plan to change or materials to be sent. Note that any batch process which
may affect a communication plan or materials to be sent to a plan member also updates
this collector file. Batch processes which may cause an update to the collector file are:
Banner Student PopSel / LetGen / CommPl
75
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Appendix A: Glossary of Terms
Population Selection Terminology
Application
The Application Code field is used to enter the Application for which the
selection is being defined.
NOTE: This is required to run the process.
Selection ID
The selection field contains the name of the selection being defined.
NOTE: This is required to run the process.
Creator ID
The name of the user who created the selection being defined.
NOTE: This is required to run the process.
Data element
Database column name to be used as part of the rules statement (the
field name or data you wish to extract).
Operator
The operator equals (=), less than (<), greater than (>), etc. are to be
used as part of the rules statement.
Value
The value to be compared (literal text, date value, number, another
column or a subquery) as part of the rules statement.
Variable
A specific piece of data in the database and the set of rules used to
select that data.
Dynamic
parameter
A parameter that allows you to enter a different distinct value every time
you utilize the rule in which it was created.
Banner Student PopSel / LetGen / CommPl
76
Training Workbook v1.0 SEP07
Integrated Information System (IIS) Project
Confidential & Proprietary
Appendix B: Validation Forms
Communication Plan
Validation Forms
STVMATL Material Code Validation Form
STVCGRP Communication Group Code Validation Form
STVCPLN Communication Plan Code Validation Form
Application Rule/Control Forms
SOAMATL Material Form
SOACGRP Communication Group Form
SOACPLN Communication Plan Form
SOACOMM Communication Rules Form
SOACCOL Communication Plan Collector Form
SOAPLAN Communication Plan Assignment Form
Reports/Processes
SORCPLN Communication Plan Processing Report
Banner Student PopSel / LetGen / CommPl
77
Training Workbook v1.0 SEP07