Operational Manual for Address and Communication


Previously, the address format consists of three (3) blocks that where attached to an application at design time.

Block one (1) displayed/maintained the contacts  for the specific entity where contact number 0 (zero) was the entity self. 

Block  two (2) displayed/maintained the address details for the contact queried in block one (1). 

Block three (3) displayed/maintained all communication detail for the contact queried on blocks one (1).


This has now changed for the ITS Integrator v0.1 release.  To date, September 2006, only for the Graduator system. Including the third party software setup.

There can be 4 formats available representing certain types of applications.


This document will explain and guide users on how to implement formats  "A" and "B".

 Format “A”

Format “B”

Third Party Software Addresses QAS.

Who is Experian QAS?


The international product "Quick Address Pro" is developed by a British company called QAS Ltd, website www.qas.com. Below is an extract from the website:
"Currently the system is available in several countries overseas. With over 10,000 customers worldwide, QAS software is changing the way businesses tackle address data quality. Our address validation software helps prevent spelling and formatting errors by enforcing address verification during data entry.

For the QAS Software to work certain system operational definitions must be setup in {GCS2-11}


SOD of addresses.

 
  1. S.O.D (System Operational Definition):  Address Application  3rd Part Software Program 1
Code Sub-System Description
AE GP Executable  of Address Software.
        

    The first executable program and parameter/s (if required) of the 3rd Party Software is stored in the Alpha Field.
    The IT1.1 address application will call the program referred to above when the cursor is moved into Address Line 1 and

  1. S.O.D.:  Address Application 3rd Party Software Path
Code Sub-System Description
AP GP Path to Address Software.

    The path for the two executable programs and will be stored in the Alpha Field.
    If this Alpha Fields is null then the site does not use the Address Application 3rd Party Software.  The Address Application functions then as current.

  1. S.O.D.:  Address Application 3rd Part Software Program 2
Code Sub-System Description
AR GP Executable Parameters.

    The second executable program and parameter/s (if required) of the 3rd Party Software is stored in the Alpha Field.
    The IT1.1 address application will call the program referred to above when the cursor is moved into Address Line 2 and

  1. S.O.D:  Address Application Character 3rd Party Software Indicator.
Code Sub-System Description
IC GP Identifying Characters.

    If the client uses the 3rd Party Software QAS software, the value <b0> must be entered in the Alpha field.
    If the client does not use the 3rd Party Software QAS software any other value must be entered in the Alpha field e.g. the character 'x'. This field must always have

    a value.

If a student presents an address that is not part of the data set in the QAS software, such as a foreign student, the QAS interface must be closed and the address detail captured manually. In such an instance, the fields External Address Type and DPID can not be updated.

The country code, city code and the QAS buttons (Upd Line 1, Upd Line 2 See img. Address Entered) are just visible with address records.   

     5.  S.O.D:  Provider Contact Type for Address Copy

Code Sub-System Description
PC GP Provider Contact Type for Address Copy
AC GP Address Type for Address Copy
UC GP Sub Division/Unit Contact Type for Address Copy

When an (I)nstitution or (S)chool (Providers) are selected during registration of a student {SDREGA-1}, an address record according to the selection will be inserted into the Address / Communication Detail block of the student.  

    6.  Supervisor Contact Type for Address Copy

Code Sub-System Description
SC GP Supervisor Contact Type for Address Copy

    7.  Next of Kin address:

CodeSub-SystemDescription
NCAPMandatory Next of Kin Communication and Residential Address


Related Menu Options:

GCS-24    Contact /Address / Communication Types   

Address Type and Description linked to a Primary Address Type Indicator, System Code Reference Type, Tel/Address/Contact Indicator and Address Reference Type Code.


GCS-26    Address Maintenance

A maintenance screen exists, which can be used to end addresses, and then delete unwanted records. Only records with an end date may be deleted and records may only ended if another record exists for the particular contact, address or communication reference gr up.

The first of these blocks (contact detail) serves as the key to the other two subsequent blocks (namely address and telephone detail fig 1.). The contact represents the Person/student/employer/debtor etc. for which addresses and/or telephone detail is carried on the system. Each contact for a particular person/student/employer/debtor etc. has a contact sequence number, making the contact unique for the particular person/student/employer/debtor etc. This number is used for identifying the addresses and/or telephone detail for the contact in question. The default Contact sequence = '0' always refers to the person/student/ employer/debtor etc. themselves - Primary contact.


The next block contains the address information for the contact selected. Each address record must always be linked to a particular contact via the contact sequence number. Multiple addresses can be linked to one contact sequence number. Each address is linked to a user defined address type, which is in turn linked to a reference type group key (this specifies the reference group to which a particular address type belongs - Postal address for the student system). This pre-determined ITS reference key groups the common address details together (i.e. all the postal addresses for a contact). The address reference types are created and linked to a pre-defined address reference group on {GCS-24 or GCS-25} in the standard codes system for the relevant ITS system.


The next block contains the communication information for the contact selected. Each telephone number is linked to a telephone type, which is in turn linked to a reference type key. This pre-determined ITS reference key groups the common address detail together (i.e. all the home telephone numbers for a contact). The telephone reference types are also created and linked to a pre-defined telephone reference group on {GCS-27} in the standard code system for the relevant ITS system. Each telephone record is always linked to a particular contact via the contact sequence number. Multiple Telephone numbers can be linked to one contact sequence number.

GCS-27    System Reference Indicators

Each system may be linked to a Sub-System e.g. the Student system is linked to 'A' Student Alumni, 'S' Student and 'Q' Student Enquiry Subsystem Indicators. The description of the system and subsystem will be displayed. 


GCS-28    Relationships

In this option a list of relationship types, e.g.: father, sister, can be created. When contact detail is created for a user, this relationship code can be linked to the relevant contact person.

GCS-29    Query Addresses

This option affords the facility to obtain address information of users where the user number is not known.

GCS-35    Maintain Regions

This option is used to accommodate a region structure. Some clients (more specifically when distance education) need the functionality to link a student to a region as well. By creating a region structure, a student can be linked to a region code when an address is entered for the student. This functionality will only work for students with the address type specified by the user on {SMNT-12} for code 'A3' and subsystem 'BI' - 'Address Type of Region'. Every time that a new student address is entered for this address type, the system will select a region code from the structure as maintained in {GCS-35} for the student, according to the address entered. If no region found, the default region as specified for code 'A4' and subsystem 'BI' - 'Default Value for Region Code' on {SMNT-12} will be linked to the student. The region originally linked is always updateable. Whenever updated, a route will be created, informing a specific person at the institution that the region of the student changed and must be checked. The route that will be used must also be specified on {SMNT-12} for code 'A5' and subsystem 'BI' - 'Address Region Route' and defined on {GROU-1}.  
 
Example 1:


Execution:

Menu option is SREGB-1
Create a new student.
Click on Address/Communication/Detail
The system will default the contact sequence number CSN to '0'
 Go next block and insert a primary address.

Example of ...csn-0


Go back to the first block and "Insert a new record"
The CSN number now becomes "1"
Go next block and enter the address.

Example of ...csn-1


Go back to the first block and "Insert a new record"
The CSN number now becomes "2"
Go next block and enter the address.

Example of ...csn-2

 
When an address is entered and the address type selected is the address type defined on {SMNT-12} for code 'A3' and subsystem 'BI' - 'Address Type of Region', the system will link a region for the student. If nothing is defined for this system operational definition, this functionality will be ignored by the system. 
The system will only allocate a region on commit. Refer to om_addres_regions manual.


om_address-1b1.jpg

 
Click on the Button "Communication"     address button
Notice that the screen has somewhat changed its appearance.
The heading "address" has been replaced by "communication number"
Enter the communication detail.

NOTE: under contact type the user will be able to see exactly what record they are currently busy with.
The highlighted blue field represent the current record.

Example of ...addres-2

 
Click on "Address/Communication List"
When you go from record to record you will notice that you can now view the "address list" and the "communication list" at once.

om_address-3b1.jpg

 
Example 2.

This example will show the different search features in the Address / Communication.
This is only for "addresses"
On the fourth line of the address there is a LOV.
Click.

om_address-3b1.jpg

 
The following query facility is brought up.
Here you are able to query the following.
a) Box Addresses per Town and Magisterial District.
b) Street address per Town and Magisterial District.
c) Or both.

Example of ...address-5

 
Enter the following:
Select Street Address
In the Town field type in "Pretoria"

Example of ...address-6

 

The following information pertaining  to the search is derived.
Select from this list. The postal codes and the magisterial districts.

Example of ...address-7

 

Processing
Rules
 
  No special processing rules


See Also:



History Of Changes

Date System Version By Whom Job Description
31-Jan-2007 v01.0.0.0 Charlene van der Schyff t12345 New manual format.
24-Apr-2009 v01.0.0.0 Charlene van der Schyff t158153 Added additional information pertaining to Third Party Software Addresses QAS.
11-Jun-2009 v01.0.0.0 Charlene van der Schyff t158153 Added 3rd party software code and subsystem.
21-Sep2009 v01.0.0.1 Charlene van der Schyff t161944 Fix images. Were not showing in other versions.
30-Mar-2010 v02.0.0.0 Christel van Staden t160707 Add region type and region code.
21-Apr-2010 v02.0.0.1 Magda van der Westhuizen T161247 Add new SOD's AC, PC and SC.
05-Jul-2012 v02.0.0.2 Magda van der Schyff T183196 Refined region allocation rules
10-Dec-2012 v02.0.0.3 Amanda van Emmenis T187532 Add new SOD = UC  (Unit Contact Type)
07-Jun-2016v04.0.0.0Magda van der Westhuizent213598Add SOD NC / AP (Next of Kin) Address Type.