Client Shipment List

From UG

Revision as of 15:56, 20 May 2010 (edit) Montira (Talk | contribs) (→Figure 4. Archived Shipment List) ← Older edit		Current revision as of 21:40, 29 November 2010 (edit) (undo) Montira (Talk | contribs) (→Table)
(48 intermediate revisions not shown)
Line 4:		Line 4:
	== Biz Analyst Intro ==		== Biz Analyst Intro ==
-	Shipment List provides list of CT(s)# that are undefined, live, delivered, and Archived in the system. This applies to Client visibility	+	Shipment List provides list of CTs that are undefined, live, delivered, and Archived in the system. This applies to Client visibility rule
	== Business Requirements and Needs ==		== Business Requirements and Needs ==
Line 11:		Line 11:
	* Way to create and manage a list of most important shipments and monitor them		* Way to create and manage a list of most important shipments and monitor them
	* Way to create nickname for most important shipments		* Way to create nickname for most important shipments
		+	* Provide a filter that can segregate modes on shipment list
	== Sys Analyst Intro ==		== Sys Analyst Intro ==
-	* Create a Panel that is almost similar to "Jag App List All"	+	* Create a Panel that is almost similar to "Jag App List All" except:
		+	:* Truck CTs are displayed on the same tabs as other modes
	:* It consists of 4 tabs:		:* It consists of 4 tabs:
	:** Undefined		:** Undefined
Line 20:		Line 22:
	:** Archived		:** Archived
	:** Default to Live tab		:** Default to Live tab
-	:* CTs shipment list must apply client visibility rule	+	* Deleted CTs are not included on the reports.
-	:* Create an ability to add nickname and add CT to Watch List	+	* CTs shipment list must apply client visibility rule
-	:** Watch List will be displayed on another page	+	* Create an ability to add nickname and add CT to Watch List
-	:** CTs that are on Watch List, MUST be listed on Shipment List as well	+	:* Watch List will be displayed on another page
-	:* Create an ability to show shipment detail	+	:* CTs that are on Watch List, MUST be listed on Shipment List as well
		+	* Create an ability to show shipment detail
	* Panel should show 15 shipment records per page		* Panel should show 15 shipment records per page
		+	* Provide check boxes to filters shipments as user can segregate any modes they want. It is always default to all modes of transportation for the fresh account. Client can manage their own setting by checking/unchecking MOT of shipments list. It will show the last updated filters.
	* Create a Search shipment line feature		* Create a Search shipment line feature
	* Shipment record on shipment list shows:		* Shipment record on shipment list shows:
Line 34:		Line 38:
	:* Shipper		:* Shipper
	:* Consignee		:* Consignee
-	* Shipment records can be sorted	+	:* Auth (Undefined Mode ONLY)
		+	* Shipment records can be sorted by column throughout all pages
		+	* Nickname on Shipment List is held when user removes shipment from Watch List
	== Design ==		== Design ==
-	* See [[#]]	+	* This component is similar to List CTs in Internal(Jaguar) App. But it is not same, for example columns are different, Truck mode does not have its own tab, client visibility, etc.
-	* See [[#]]	+	* See [[#Figure 1. Live Shipment List]]
-	* See [[#]]	+	* See [[#Figure 2. Undefined Shipment List]]
-	* See [[#]]	+	* See [[#Figure 3. Delivered Shipment List]]
		+	* See [[#Figure 4. Archived Shipment List]]
-	This component is similar to List CTs in Internal(Jaguar) App. But it is not same, for example columns are different, etc.
	=== Filters ===		=== Filters ===
		+	* This panel shows ONLY CTs visible to logged user.See [[Client visibility rule]]
-	This panel shows ONLY CTs visible to logged user.See [[Client visibility rule]]	+	* Conditions for CT appearence on particular tab (Undefine, Live, Delivered, or Archived) is the same as here: [http://mantis.jaguarfreight.com/wiki/List_CTs#Definition_of_UNDEFINED_LIVE_DELIVERED_ARCHIVED Definition]
-	Conditions for CT appearence on particular tab (Undefine, Live, Delivered, or Archived) is the same as here: http://mantis.jaguarfreight.com/wiki/List_CTs#Definition_of_UNDEFINED_LIVE_DELIVERED_ARCHIVED	+	=== MOT ===
		+	See [http://mantis.jaguarfreight.com/wiki/List_CTs#Ver_3.0_major_re-design Updated MOT]
	=== Table ===		=== Table ===
-	'''Table Fields def'''  (same for all tabs):	+	'''Table Fields definition'''  (same for all tabs):
	* [[MOT]]		* [[MOT]]
-	** this is icon: air, ocn or truck	+	:* Type: icon - Air , Ocean, or Truck
	* Nickname		* Nickname
-	** alphanumeric???	+	:* Type:[[alphanumeric]]
-	** visible chars: 13	+	:* Widget: [[textbox]]
-	** max chars: ???	+	:* Visible Chars: 13
-	** validation: ???	+	:** Max Chars: [[TBD]]
	* CT#		* CT#
-	** double click forwards to CT Details Page	+	:* Show CT#
		+	:* Double click on CT record, it forwards to CT Shipment Details Page
	* Created On		* Created On
-	** CT.DB.CreatedOn field	+	:* Mapping: [[CT#Created_On]]
-	** format... example 17 Jul 2009	+	:* Format: DD MON YYYY
		+	:** For ex, 17 Jul 2009
	* Shipper		* Shipper
-	** CT.GT.Shipper	+	:* Mapping: [[CT#Shipper]]
-	** Display only Company-City	+	:* Display only Company-City
	* Consignee		* Consignee
-	** CT.GT.Consignee	+	:* Mapping: [[CT#Consignee]]
-	** Display only Company-City	+	:* Display only Company-City
-	* Status	+	* Auth
-	** Display Pending for CT that is waiting for approval from operator	+	:* Display Pending for CT that is waiting for approval from operator
		+	:* Widget: Green circle with check mark
	'''Table Paging:'''		'''Table Paging:'''
-	* Needs standard ZK paging.	+	* Uses standard ZK paging.
	* 15 CTs per page		* 15 CTs per page
-	'''Table Sorting:''' next version	+	'''Table Sorting:'''
		+	* Sort: Ascending/Descending per column throughout all pages
		+	* Use standard ZK sorting (click on table header)
-	'''Table Searching:''' next version	+	'''Table Searching:'''
		+	* Search Line
		+	:* Type: filter by Nickname, Shipper, and Consignee
		+	:* Widget: [[textbox]]
		+	:* Note: similar to Addrbook
		+	:* Apply for: search throughout all tabs.
-	'''Default order:''' show sorted by CT#, latest at the top	+	'''Table MOT Filter:'''
		+	* Filter
		+	:* Location: In front of MOT (Air, Ocean, Trucking-Air, Trucking-Ocean, Trucking-Domestic)
		+	:* Widget: [[Checkbox]]
		+	:* Note: Provide check boxes to filter shipments as user can segregate any modes they want. It is always default to all modes of transportation for fresh account, see [[#Figure 5. Segregate Shipment List ]]There is a default setting that can be managed through an individual’s client shipment list.
-	'''Default tab:''' Live	+	'''Default order:'''
		+	* show sorted by CT#, latest at the top, throughout all pages and all tabs
		+
		+	'''Default tab:'''
		+	* Live
	'''Link from CT to Shipment details: '''		'''Link from CT to Shipment details: '''
Line 93:		Line 119:
	Two options:		Two options:
	* double click		* double click
-	* select Ct and click on "Show selected button"	+	* select CT record and click on "Show selected button"
	In both cases CT Details page would open up.		In both cases CT Details page would open up.
		+
		+	=== Button ===
		+	* Apply Filter
		+	:* Search lines for shipments that contains ... search throughout all tabs.
		+	* Clear
		+	:* Clear info on search line value input
		+	* Add to Watch List
		+	:* Add shipment to Watch List
		+	* Show Selected
		+	:* Show shipment detail for a specific shipment
	=== Add to Watch List and Add Nickname Feature ===		=== Add to Watch List and Add Nickname Feature ===
-	It allows to add any CT from List All to Watch List.	+	* It allows user to add any CT from Shipment List to Watch List
-	See UC3 below!	+
		+	=== Archived Tab ===
		+	* Shipment should move from Delivered Tab to Archived Tab when its shipment actual delivery date pass 180 days.
	== Use Cases ==		== Use Cases ==
Line 104:		Line 142:
	=== UC1 ===		=== UC1 ===
-	'''Problem:''' User wants to see what shipments are ''live'', what are ''undefined'', ''delivered'' or ''archived''	+	'''Problem:''' User wants to see what shipments are ''live'', ''undefined'', ''delivered'' or ''archived''
	'''Solution:''' click on appropriate tab		'''Solution:''' click on appropriate tab
Line 122:		Line 160:
	'''Solution:'''		'''Solution:'''
-	*1 select CT (with no nickname)	+	1. Select CT (with no nickname)
-	*2 enter Nickname into textbox	+
-	*3 (optional) repeat step 2 for any number of CTs	+
-	*4 click on "Add to Watch List" button	+
-	*5 pop-up appears "Add selected shipments to Watch List? [Yes][No]"	+
-	** if Yes then pop-up appears "X CT's has been added to Watch List [OK]"	+
-	*** click "OK"	+
-	*** system displays new Nicknames	+
-	** if No nothing happens	+
-	== Test Cases and QA ==	+	2. Enter Nickname into textbox
		+	* If Nickname is not entered and add CT to Watch List, warning message pop-up shows: You must enter Nickname for shipment before you add to Watch List. [OK]
		+
		+	3. (optional) repeat step 2 for any number of CTs
-	=== TC1 ===	+	4. click on "Add to Watch List" button
-	Test all use cases	+	5. pop-up appears "Add selected shipments to Watch List? [Yes][No]"
		+	* If Yes then pop-up appears "X CT's has been added to Watch List [OK]"
		+	:* Click "OK"
		+	:* system displays new Nickname(s) on Shipment List
		+	* If No then nothing happens
-	=== TC2 ===	+	=== UC4 ===
-	a)	+
-	* Select CT that is already on watch list	+
-	* Click "Add to watch list"	+
-	* system must show warning "This shipment is already on Watch List"[OK] -- [[user:Tira|Tira]] 4:41 PM. 19 Sep 2009 (UTC)	+
-	b)	+
-	* Select CT that is not on watch list	+
-	* leave nickname textbox empty	+
-	* Click "Add to watch list"	+
-	* system must show warning "You must enter Nickname for shipment before you add to Watch List"[OK] -- [[user:Tira|Tira]] 4:41 PM. 19 Sep 2009 (UTC)	+
-	== Next Version and RFC ==	+	'''Problem:''' User wants to search for shipment that has shipper name xxxx
-	'''sorting:''' must sort by any column	+	'''Solution:'''
-	* use standard ZK sorting (click on table header)	+	* Type shipper name on the search line
-	* accommodate this test case:	+	* Click "Apply Filter"
-	** user is on page X	+	* System will show the records that contain the shipper name that user searches for throughout all tabs.
-	** user clicks on column Y	+
-	** system must sort and present page 1	+
-	'''searching and filtering:''' similar to Addrbook	+	=== UC5 ===
		+	'''Problem:''' User wants to add existing monitored CT to Watch List
-	== Tweaks ==	+	'''Solution:'''
		+	* Select CT that is already on watch list
		+	* Click "Add to watch list"
		+	* System shows warning message that "This shipment is already on Watch List"[OK]
-	tw1) Undefined MOT tab, shipment records that are authorized by client user SHOULD have some indicator that shipment is already authorized. It should have some indicator. For example, it can be color coded(orange) for the shipment or it can have a column indicated that. -- [[user:Tira|Tira]] 5:40 PM 27 Oct 2009	+	=== UC6 ===
-	tw2) Add a search filter for shipment list by nickname, shipper, or consignee. See picture for more explanation. -- [[user:Tira|Tira]] 5:40 PM 1 Dec 2009	+	'''Problem:''' User wants to add CT to Watch List without naming nickname
-	[[File:FilterShipmentList.JPG| thumb|500px|ClientApp.ListAll.SearchFilter.example]]	+
-	== Ver 3.0 major re-design ==	+	'''Solution:'''
-	See http://mantis.jaguarfreight.com/wiki/List_CTs#Ver_3.0_major_re-design	+	* Select CT that is not on watch list
		+	* Leave nickname textbox empty
		+	* Click "Add to watch list"
		+	* System must show message warning "You must enter Nickname for shipment before you add to Watch List"[OK]
		+	=== UC7 ===
		+
		+	'''Problem:''' User wants to segregate shipments by MOT
		+
		+	'''Solution:'''
		+	* User selects only checkbox(es) that are in front of the MOT in order to view specific MOT
		+	* User view MOT selected shipments throughout all tabs
		+	* Shipment list only shows MOT(s) that are selected or set on user profile
		+	* When user refreshes the page, filters should be set as the last filter value setting updated
		+
		+	== Test Cases and QA ==
		+	* Test all possibly use cases
	== Figures ==		== Figures ==
Line 184:		Line 228:
	=== Figure 4. Archived Shipment List ===		=== Figure 4. Archived Shipment List ===
	[[File:ArchivedShipment.JPG]]		[[File:ArchivedShipment.JPG]]
		+
		+	=== Figure 5. Segregate Shipment List ===
		+	[[File:SegregateShipmentByMOT.JPG]]
		+
		+	== History ==
		+	=== m1868 ===
		+	* Ability to held nickname on Shipment List when user removes shipment from Watch List
		+	* See [http://mantis.jaguarfreight.com/wiki/Client_Watch_List#m1868 Client Watch List]
		+	* Spec is updated: Y

---

Current revision as of 21:40, 29 November 2010

Contents 1 Mantis 2 Biz Analyst Intro 3 Business Requirements and Needs 4 Sys Analyst Intro 5 Design 5.1 Filters 5.2 MOT 5.3 Table 5.4 Button 5.5 Add to Watch List and Add Nickname Feature 5.6 Archived Tab 6 Use Cases 6.1 UC1 6.2 UC2 6.3 UC3 6.4 UC4 6.5 UC5 6.6 UC6 6.7 UC7 7 Test Cases and QA 8 Figures 8.1 Figure 1. Live Shipment List 8.2 Figure 2. Undefined Shipment List 8.3 Figure 3. Delivered Shipment List 8.4 Figure 4. Archived Shipment List 8.5 Figure 5. Segregate Shipment List 9 History 9.1 m1868

[edit] Mantis

• Parent Mantis:921

[edit] Biz Analyst Intro

Shipment List provides list of CTs that are undefined, live, delivered, and Archived in the system. This applies to Client visibility rule

[edit] Business Requirements and Needs

User needs:

• A panel where he can see all shipments (allowed for that user to see).
• Way to create and manage a list of most important shipments and monitor them
• Way to create nickname for most important shipments
• Provide a filter that can segregate modes on shipment list

[edit] Sys Analyst Intro

• Create a Panel that is almost similar to "Jag App List All" except:

• Truck CTs are displayed on the same tabs as other modes
• It consists of 4 tabs:
  • Undefined
  • Live
  • Delivered
  • Archived
  • Default to Live tab

• Deleted CTs are not included on the reports.
• CTs shipment list must apply client visibility rule
• Create an ability to add nickname and add CT to Watch List

• Watch List will be displayed on another page
• CTs that are on Watch List, MUST be listed on Shipment List as well

• Create an ability to show shipment detail
• Panel should show 15 shipment records per page
• Provide check boxes to filters shipments as user can segregate any modes they want. It is always default to all modes of transportation for the fresh account. Client can manage their own setting by checking/unchecking MOT of shipments list. It will show the last updated filters.
• Create a Search shipment line feature
• Shipment record on shipment list shows:

• MOT
• Nickname
• CT#
• Created On Date
• Shipper
• Consignee
• Auth (Undefined Mode ONLY)

• Shipment records can be sorted by column throughout all pages
• Nickname on Shipment List is held when user removes shipment from Watch List

[edit] Design

• This component is similar to List CTs in Internal(Jaguar) App. But it is not same, for example columns are different, Truck mode does not have its own tab, client visibility, etc.
• See #Figure 1. Live Shipment List
• See #Figure 2. Undefined Shipment List
• See #Figure 3. Delivered Shipment List
• See #Figure 4. Archived Shipment List

[edit] Filters

• This panel shows ONLY CTs visible to logged user.See Client visibility rule

• Conditions for CT appearence on particular tab (Undefine, Live, Delivered, or Archived) is the same as here: Definition

[edit] MOT

See Updated MOT

[edit] Table

Table Fields definition (same for all tabs):

• MOT

• Type: icon - Air , Ocean, or Truck

• Nickname

• Type:alphanumeric
• Widget: textbox
• Visible Chars: 13
  • Max Chars: TBD

• CT#

• Show CT#
• Double click on CT record, it forwards to CT Shipment Details Page

• Created On

• Mapping: CT#Created_On
• Format: DD MON YYYY
  • For ex, 17 Jul 2009

• Shipper

• Mapping: CT#Shipper
• Display only Company-City

• Consignee

• Mapping: CT#Consignee
• Display only Company-City

• Auth

• Display Pending for CT that is waiting for approval from operator
• Widget: Green circle with check mark

Table Paging:

• Uses standard ZK paging.
• 15 CTs per page

Table Sorting:

• Sort: Ascending/Descending per column throughout all pages
• Use standard ZK sorting (click on table header)

Table Searching:

• Search Line

• Type: filter by Nickname, Shipper, and Consignee
• Widget: textbox
• Note: similar to Addrbook
• Apply for: search throughout all tabs.

Table MOT Filter:

• Filter

• Location: In front of MOT (Air, Ocean, Trucking-Air, Trucking-Ocean, Trucking-Domestic)
• Widget: Checkbox
• Note: Provide check boxes to filter shipments as user can segregate any modes they want. It is always default to all modes of transportation for fresh account, see #Figure 5. Segregate Shipment List There is a default setting that can be managed through an individual’s client shipment list.

Default order:

• show sorted by CT#, latest at the top, throughout all pages and all tabs

Default tab:

• Live

Link from CT to Shipment details:

Two options:

• double click
• select CT record and click on "Show selected button"

In both cases CT Details page would open up.

[edit] Button

• Apply Filter

• Search lines for shipments that contains ... search throughout all tabs.

• Clear

• Clear info on search line value input

• Add to Watch List

• Add shipment to Watch List

• Show Selected

• Show shipment detail for a specific shipment

[edit] Add to Watch List and Add Nickname Feature

• It allows user to add any CT from Shipment List to Watch List

[edit] Archived Tab

• Shipment should move from Delivered Tab to Archived Tab when its shipment actual delivery date pass 180 days.

[edit] Use Cases

[edit] UC1

Problem: User wants to see what shipments are live, undefined, delivered or archived

Solution: click on appropriate tab

[edit] UC2

Problem: User wants to see shipment details for particular CT

Solution:

• option1) double click on the shipment record OR
• option2) click on the shipment record and press "Show Selected"

[edit] UC3

Problem: User wants to add CT to Watch List and add Nickname

Solution:

1. Select CT (with no nickname)

2. Enter Nickname into textbox

• If Nickname is not entered and add CT to Watch List, warning message pop-up shows: You must enter Nickname for shipment before you add to Watch List. [OK]

3. (optional) repeat step 2 for any number of CTs

4. click on "Add to Watch List" button

5. pop-up appears "Add selected shipments to Watch List? [Yes][No]"

• If Yes then pop-up appears "X CT's has been added to Watch List [OK]"

• Click "OK"
• system displays new Nickname(s) on Shipment List

• If No then nothing happens

[edit] UC4

Problem: User wants to search for shipment that has shipper name xxxx

Solution:

• Type shipper name on the search line
• Click "Apply Filter"
• System will show the records that contain the shipper name that user searches for throughout all tabs.

[edit] UC5

Problem: User wants to add existing monitored CT to Watch List

Solution:

• Select CT that is already on watch list
• Click "Add to watch list"
• System shows warning message that "This shipment is already on Watch List"[OK]

[edit] UC6

Problem: User wants to add CT to Watch List without naming nickname

Solution:

• Select CT that is not on watch list
• Leave nickname textbox empty
• Click "Add to watch list"
• System must show message warning "You must enter Nickname for shipment before you add to Watch List"[OK]

[edit] UC7

Problem: User wants to segregate shipments by MOT

Solution:

• User selects only checkbox(es) that are in front of the MOT in order to view specific MOT
• User view MOT selected shipments throughout all tabs
• Shipment list only shows MOT(s) that are selected or set on user profile
• When user refreshes the page, filters should be set as the last filter value setting updated

[edit] Test Cases and QA

• Test all possibly use cases

[edit] Figures

[edit] Figure 1. Live Shipment List

[edit] Figure 2. Undefined Shipment List

[edit] Figure 3. Delivered Shipment List

[edit] Figure 4. Archived Shipment List

[edit] Figure 5. Segregate Shipment List

[edit] History

[edit] m1868

• Ability to held nickname on Shipment List when user removes shipment from Watch List
• See Client Watch List
• Spec is updated: Y