Employer Address Maintenance {GCS4-2}


{GCS-22} has been split up into two programs e.g. {GCS4-1} for the creation of the 'Employer' and {GCS4-2} for the creation of the addresses.

The 'Employer' is identified by the 'Reference Number' that is assigned on capturing of the Employer Details on {GCS4-1}.  A valid 'Reference Number' or 'Employer Code' is mandatory for retrieving of Contact / Address / Communication details of the Employer.

Records cannot be deleted.  According to a set of rules as explained below an 'End Date' must be entered before a new record for the same address type can be created.

Validations will be done against {GCS-24 / GCS4-3} for the following values:

1.  Primary Contact:


Take note that a 'Master Detail' relationship exits between the 'List of Contacts', 'Contact', 'Address' and 'Communication' panel box / tabs.

Field Type
&
Length
Description
Reference Number N7 Valid 'Reference Numbers' from {GCS4-1}. 
Contact TypeA2{GCS4-3 / GCS-24} - for system 'E' - Employer and Type 'C' - Contact and Reference is not equal to 'P'.  'Primary Contact' or contact for sequence''0' cannot be created here - this should have already been created on capturing of a record on {GCS4-1}. A warning will be issued if a record with the same 'Address Type' already exists and was created before the current date or on the current date.
Contact RelationshipA5A List of Values is available with data as defined on {GCS-28}.  
Contact NameA40On entering of a valid 'Contact Type' the description will be populated from {GCS4-3 / GCS-24}.
Start DateDD-MON-YYYYOn creation of a new record, the system date will be populated into the 'Start Date' field.
End DateDD-MON-YYYYA 'Contact' cannot be ended:
  • if there are active address and / or communication records linked.  
  • The 'Primary Contact' cannot be ended.  
  • None of the contact types can be ended when validation type 'CA' in {GOPS-22} is set to 'N' and; 
  • a specific 'Contact Type' cannot be ended if the indicator on {GCS-24} is set to 'N'.
Contact SequenceSystem Generated.
PrimaryA1
  • The 'Primary' indicator on a new record is set to 'Y', unless its 'Contact Type' is not flagged as 'Primary' for a 'Reference Type' on {GCS-24}; and 
          there exists an active 'Contact' record for the same 'Reference Type' and different 'Contact Type' that is marked as primary on {GCS-24}.
  • When the user saved the new record, the;
    • Primary indicator is set to 'N'; and
    • The Primary is set to 'Y' on another Contact record for same reference type, when found.
RemarksA80User can add relevant 'Remarks'.
RemarksA80User can add relevant 'Remarks'.

Example:

Example of ...



Address Panel box:

1.  Update of records with 'End Date' populated is not allowed.
2.  Valid End Date cannot be earlier than the 'Start Date'.
3.  Update of Address and Postal Code is allowed only when validation 'CB' {GOPS-22} is set to 'Y'.
4.  Check if the 'Postal Code' is mandatory on {GOPS-22} for validation 'MP'.
5.  Update of End Date is not allowed when:
6.  On ending of address record with primary = 'Y':
7.    End Date cannot be populated on new record.
8.    Contacts (other than Primary Contact) :

Field Type
&
Length
Description
Address TypeA2A List of Values is available for selection by the user as defined on {GCS-24} for 'System Code Reference Type' equals 'E' - Employer, 'Code' equals 'I - Employer General' and 'Select the Relevant Type' equals 'A - Address'.
PrimaryA1Primary indicatory is set as per 'Primary' indicator rules for Contact / Address / Communication as defined on {GCS-24}.
Address Line 1A80User defined address.
Address Line 2A80User defined address.
Address Line 3A80User defined address.
Address Line 4A80When Address Line 4 is left empty, it will be populated with the 'City / Town' corresponding to the selected 'Postal Code'.
Postal CodeN4Postal Code is mandatory when validation 'MP' is set to 'Y' on {GOPS-22}.
Start DateDD-MON-YYYYThe 'Start Date' will be populated with the system date on creation of a address.
End DateDD-MON-YYYYEnd Date is NULL and cannot be populated on capturing of new record

Example:

Example of ...



Processing Rules for 'Communication' panel box:

A Master / Detail relationship exists between the Contact and Communication records . The link is on the Reference Number and Contact Sequence Number for the Employer Sub-system.

1.    Update of records with 'End Date' populated is not allowed.
2.    Valid 'End Date' cannot be earlier than the 'Start Date'.
3.    Update of the 'Communication Number' is allowed only when validation 'CB' {GOPS-22} is set to Y.
4.    On ending of communication record with primary = 'Y':
5.    End Date cannot be populated on new record.
6.    New communication records cannot be created under cancelled (has End Date) contact.
7.    End existing record (populate end date)  for the same Contact Sequence / Communication Type (if it exists) and set its primary indicator to 'N' (if it was 'Y'). The 'End Date' will be set to the 'System Date'.


Field Type
&
Length
Description
Communication TypeA2A List of Values is available as defined on {GCS-24} - for system 'E' - Employer and Type 'T' - Communication.  A warning is issued if a record with the same 'Communication Type' already exists and was created before current date.
On entering of a valid 'Communication Type',  the 'Primary' indicator on this record is set to 'Y' unless the 'Address Type' is not flagged as primary for a Reference Type on {GCS-24} and there exists active Address record for the same Reference Type / Contact Sequence Number and a different 'Address Type' that is marked as 'Primary' on {GCS-24}.
Communication NumberA80When Communication Type's reference type is 'E' (email), the value is validated by the standard email validations:
  • No special chars ascii(0-37) and <,>,[,],",;,:,'
  • First char can't be @
  • Only one @ allowed
  • Dot (.) musn't be followed by @
  • At least one dot after @
  • Length after last . must be between 2 and 4
  • Include at least 1 @
  • Cannot end with . 
  • Cannot end with , 
  • May not have 2 .. next to each other.
PrimaryA1Indication if this is the 'Primary' Communication type.
Start DateDD-MON-YYYYWill be populated with the system date on the creation of a new Communication record.
End Date DD-MON-YYYY Update of 'End Date' is not allowed when:
  • Validation 'CA' in {GOPS-22} set to 'N'.
  •  For a specific 'Address Type the 'can end' indicator is set to 'N' on {GCS-24}


Example:

Example of ...



Examples  
  Delete if not applicable


Processing
Rules
 
  No special processing rules.







See Also:



History of Changes

Date System Version By Whom Job Description
15-May-2018 v04.1.0.0 Magda van der Westhuizen T227403 Employment Addresses. This was {GCS-22} on INT3.0.