byondpro
Functional Specifications
×
Menu
Index

Change Multiple Location Codes

 
The system will navigate the user to this page, when the user selects more than one record (including "Select All") from the Results Table and clicks on the Change Multiple Location Codes button.
 
The functionalities of this page are as follows.
 
Selected values from search filters in Find Location section
Filtered records when clicks on the Find button
Functionalities
#
Site
Area
Area S1
Area S2
Area S3
Type
Location
1
SAC
-
-
-
-
-
-
All the locations belongs to SAC
1a. When the user selects all the locations of the "Site", the system allows the user to change ONLY the "Site" segment of the location codes - see Screen 1a.

1b. When the user selects all the locations of a particular "Area" - refer 2a.

1c. When the user selects all the locations of a particular "Area S1", which the "Area S1" is in a same "Area" - refer 3a.

1d. When the user selects all the locations of a particular "Area S2", which the "Area S2" is in a same "Area S1" and a same "Area" - refer 4a.

1e. When the user selects all the locations of a particular "Area S3", which the "Area S3" is in a same "Area S2", a same "Area S1" and a same "Area" - refer 5a.
 
1f. When the user selects ONLY few locations (with same code segments or different code segments),  the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a
2
SAC
A1
-
-
-
-
-
The locations belongs to A1 of SAC
2a. When the user selects all the locations of an "Area", the system allows the user to change ONLY the "Area" segment of the location codes - see Screen 2a

2b. When the user selects all the locations of a particular "Area S1", which the "Area S1" is in a same "Area" - refer 3a.

2c. When the user selects all the locations of a particular "Area S2", which the "Area S2" is in a same "Area S1" and a same "Area" - refer 4a.

2d. When the user selects all the locations of a particular "Area S3", which the "Area S3" is in a same "Area S2", a same "Area S1" and a same "Area" - refer 5a.

2e. When the user selects ONLY few locations (with same code segments or different code segments),  the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a 
3
SAC
A1
S1
-
-
-
-
The locations belongs to S1 which the S1 is in A1 of SAC
3a. When the user selects all the locations of an "Area S1", the system allows the user to change ONLY the "Area S1" segment of the location codes - see Screen 3a
 
3b. When the user selects all the locations of a particular "Area S2", which the "Area S2" is in a same "Area S1" and a same "Area" - refer 4a.

3c. When the user selects all the locations of a particular "Area S3", which the "Area S3" is in a same "Area S2", a same "Area S1" and a same "Area" - refer 5a.

3d When the user selects ONLY few locations (with same code segments or different code segments),  the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a 
4
SAC
A1
S1
EAST
-
-
-
The locations belongs to EAST (Area S2) in S1 which the S1 is in A1 of SAC
4a. When the user selects all the locations of an "Area S2", the system allows the user to change ONLY the "Area S2" segment of the location codes - see Screen 4a

4b. When the user selects all the locations of a particular "Area S3", which the "Area S3" is in a same "Area S2", a same "Area S1" and a same "Area" - refer 5a.

4c. When the user selects ONLY few locations (with same code segments or different code segments),  the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a
5
SAC
A1
S1
EAST
LEFT
-
-
The locations belongs to LEFT (Area S3) in EAST (Area S2) of S1 which the S1 is in A1 of SAC
5a. When the user selects all the locations of an "Area S3", the system allows the user to change ONLY the "Area S3" segment of the location codes - see Screen 5a

  5b. When the user selects ONLY few locations (with same code segments or different code segments),  the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a
6
SAC
A1
S1
EAST
LEFT
807
-
The "807" typed locations belongs to LEFT (Area S3) in EAST (Area S2) of S1 which the S1 is in A1 of SAC
6a. When the user selects more than one location to all locations from a same "Type", the system allows the user to change ONLY the "Type" segment and the "Location" of the location codes - see Screen 6a
7
Either these Filters are selected or not selected
SAC-A1-S1-EAST-LEFT-807-LOC1
Only the LOC1
7a. As this is a single location code change, the system allows the user to change the "Type" segment and the "Location" segment of the location code - refer Change Single Location Code.
 
Screen 1a Change Multiple Location Codes
1

Batch Location Code Update

2

Change Multiple Location Codes

This is the main section of the page.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Section Header
-
-
-
-
Text
-
-
-
-
3

Info Text

This describes how many locations will be moved as the result of this functionality.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Info Text
-
The Info Text will be "You are about to change <<No.of selected records>> Location codes."
-
-
Text
-
-
-
-
4

Change From

This is a label to highlight the current code of the changing segment.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Label
-
-
-
-
Text
-
-
-
-
5

Current Site

This is the current Site (i.e. the Site code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
6

Change To

This is a label to highlight the section, which the section includes form element/s to change the segment/s.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Label
-
-
-
-
Text
-
-
-
-
7

Site

This allows to enter a Site.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This allows to enter any three (3) characters including numbers, letters and special characters. So the text field should be limited to maximum of 3 characters.
 
2. If the user enters lower case letters, it will automatically convert to the letters to upper case.
 
 
Optional
Enter a Site Code
Text
-
-
Active
-
8

Selected Records Table

This table includes all the selected records from the Results Table. Refer Selected Records Table for the functionalities of the table and refer the column details mentioned underneath it.
9

Change

This is a function of the change process.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Button
Post-conditions:
1. Retain the user in the same page.

2. Clear values from the Site text field.
 
3. For a successful location codes change, the current location codes will be updated to the newest location codes.
 
4. The fields of the Location record,
(LOCA_TYPE, LOCA_LOCATIONCODE) should be updated, when the user selects a .
 
5. The new location code will be displayed underneath the  New Location Code column.
 
6. The track/log record/s should be added to the "Tracking" list.
1. This button will be enabled/active, when the user enters a value for the text field (For Screen 6a - this button will be enabled/active, when the user selects a value for "Type" or enters value/s for "Ranges").
 
2. This button will be disabled/inactive, when the user clears/resets text field (For Screen 6a - this button will be disabled/inactive, when the user clears/resets both the "Type" and the "Ranges" elements).
 
3. While the location codes change task is being processing, it will show a message box - see Message Box 1.

5. For a successfully completed task, It will show a message box - see Message Box 2.
 
6. For a not completed task, It will show a message box - see Message Box 3. (This might be shown when the server timeouts occured).
-
-
-
-
-
Inactive
Message Box 1 -
Processing...

<<count of the remaining records goes here>> out of <<count of selected records goes here>> location codes remaining to be processed for location codes change task.

Message Box 2  - 
Location code change task is completed.
 
<<count of location records goes here>> location codes are changed.
 
Message Box 3 -
Location code change task is partially completed.

<<count of successfully changed location codes goes here>> out of <<count of selected records goes here>> location codes are changed.
10

Cancel

This is a function of the cancel process.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Button
Post-conditions:
1. Clear/reset the
Site text field.
 
2. Code change process will be discarded.

3. Navigate the user to the "Screen 1" in
Location Code Management Tool. and clear search filters in Find Location section.
-
-
-
-
-
-
Active
-


Screen 2a
Change Multiple Location Codes
1

Current Site

Refer Current Site in Screen 1a
2

Current  Area

This is the current Area (i.e. the Area code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
3

Area

This allows to enter an Area.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This allows to enter any four (4) characters including numbers, letters and special characters. So the text field should be limited to maximum of 4 characters.
 
2. When the user enters lower case letters, it will automatically convert the letters to uppercase.
Optional
Enter an Area Code
Text
-
-
Active
-

Screen 3a Change Multiple Location Codes
1

Current Area

Refer Current Area in Screen 2a
2

Current Area S1

This is the current Area S1 (i.e the Area S1 code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
3

Area S1

This allows to enter an Area S1.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This allows to enter any four (4) characters including numbers, letters and special characters. So the text field should be limited to maximum of 4 characters.
 
2. When the user enters lower case letters, it will automatically convert the letters to uppercase.
Optional
Enter an Area S1 Code
Text
-
-
Active
-

Screen 4a Change Multiple Location Codes
1

Current Area S1

Refer Current Area S1 in Screen 3a
2

Current Area S2

This is the current Area S2 (i.e the Area S2 code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
3

Area S2

This allows to enter an Area S2.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This allows to enter any six (6) characters including numbers, letters and special characters. So the text field should be limited to maximum of 6 characters.
 
2. When the user enters lower case letters, it will automatically convert the letters to uppercase.
Optional
Enter an Area S2 Code
Text
-
-
Active
-

Screen 5a Change Multiple Location Codes
1

Current Area S2

Refer Current Area S2 in Screen 4a
2

Current Area S3

This is the current Area S3 (i.e the Area S3 code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
3

Area  S3

This allows to enter an Area S3.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This allows to enter any four(4) characters including numbers, letters and special characters. So the text field should be limited to maximum of 4 characters.
 
2. When the user enters lower case letters, it will automatically convert the letters to uppercase.
Optional
Enter an Area S3 Code
Text
-
-
Active
-

Screen 6a Change Multiple Location Codes
1

Current Area S3

Refer Current Area S3 in Screen 5a
2

Current Type

This is the current Type (i.e the Location Type code) of the selected locations.
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text
-
-
-
-
Text
-
-
-
-
3

Type

This allows to select a Location Type.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Combo Box
Pre-conditions:
1. There should be at least one Location Type created by the System Administrator.
 
  • List all the Location Type names.
     
    2. The format of the options of the combo box: <<Type Name>> (<<Type Code>>)

    3. The combo box allows the user to either input a value directly or select a value from the options list.
     
-
Select a Type
Text
-
-
Active
-
4

Location Suffix for Bulk

This allows to select a Location Suffix.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Drop down
Pre-conditions:
1. There should be at least one Location Suffix created by the System Administrator.
 
Post-conditions:
1. The selected suffix will be appended to location code segment of all the locations.
 
 
  • List all the Location Suffixes.

    2. The options of the drop down will be; N, S, W, E, A, B, C, D, 8
     
-
Select a Suffix
Text
-
-
Active
-
5

Number of Characters in Location Segment

This allows to select a number to define the digits limit of the location code (Range 1, Range 2 and Range 3).
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Drop down
Post-conditions:
1.The digits limit of  Range 1, Range 2, Range 3 text fields will be defined based on the value selected in this drop down.
 
 
1. The options of the drop down will be; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
-
Select a Number
Number
-
-
Active
-
6

Range 1 Location From

This allows to enter a number which will be the starting number of Range 1.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a value for the Number of Characters in Location Segment drop down.
 
2. This button will be disabled/inactive, when the user clears/resets the Number of Characters in Location Segment drop down.
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
-
Enter a Number
Number
-
-
Inactive
-
7

Range 1 Location To

This allows to enter a number which will be the ending number of Range 1.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a value for the Number of Characters in Location Segment drop down.
 
2. This button will be disabled/inactive, when the user clears/resets the Number of Characters in Location Segment drop down.
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
 
4. This should ONLY allow to enter a  greater number than the value entered in Range 1 Location From.
-
Enter a Number
Number
-
-
Inactive
-
8

Range 2 Location From

This allows to enter a number which will be the starting number of Range 2.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a values for Range 1 Location From and Range 1 Location To text fields.
 
2. This button will be disabled/inactive, when the user clears/resets  Range 1 Location From and Range 1 Location To text fields.
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
 
4. This should NOT allow to enter a number in between Range 1 Location From and Range 1 Location To values.
-
Enter a Number
Number
-
-
Inactive
-
9

Range 2 Location To

This allows to enter a number which will be the ending number of Range 2.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a value for the Number of Characters in Location Segment drop down.
 
2. This button will be disabled/inactive, when the user clears/resets the Number of Characters in Location Segment drop down.
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
 
4. This should ONLY allow to enter a  greater number than the value entered in Range 2 Location From.
-
Enter a Number
Number
-
-
Inactive
-
10

Range 3 Location From

This allows to enter a number which will be the starting number of Range 3.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a values for Range 2 Location From and Range 2 Location To text fields.
 
2. This button will be disabled/inactive, when the user clears/resets Range 2 Location From and Range 2 Location To text fields
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
 
4. This should NOT allow to enter a number in between Range 2 Location From and Range 2 Location To values.
-
Enter a Number
Number
-
-
Inactive
-
11

Range 3 Location To

This allows to enter a number which will be the ending number of Range 3.
 
Type
Notes
Rules
Compulsory
Placeholder
Format
Edit
Size
Default
Messages
Text Field
-
 
1. This text field will be enabled/active, when the user selects a value for the Number of Characters in Location Segment drop down.
 
2. This button will be disabled/inactive, when the user clears/resets the Number of Characters in Location Segment drop down.
 
3. This allows to enter a number, which the digit count of the number should be limited to maximum of the selected number in Number of Characters in Location Segment drop down.
 
4. This should ONLY allow to enter a  greater number than the value entered in Range 3 Location From.
-
Enter a Number
Number
-
-
Inactive
-
 
The online help was created with Dr.Explain