Client Shipment List

From UG

Contents 1 Dev 2 Business Requirements and Needs (Problem) 3 High-Level Design (Solution) 4 Detailed Design (Specs) 4.1 Filters 4.2 Table 4.3 Add to Watch List and Add Nickname Feature 5 Use Cases 5.1 UC1 5.2 UC2 5.3 UC3 6 Test Cases and QA 6.1 TC1 6.2 TC2 7 Next Version and RFC 8 Tweaks 9 Ver 3.0 major re-design

Dev

• 0000921: [Client.ListAll] http://mantis.jaguarfreight.com/mantis/view.php?id=921

Business Requirements and Needs (Problem)

User needs:

• br1) a panel where he can see all shipments (allowed for that user to see).
• br2) way to create and manage a list of most important shipments and monitor them
• br3) way to create nickname for most important shipments

High-Level Design (Solution)

• (br1) present panel similar to "Jag App List All"
• (br2), (br3) combine operation of adding nickname and adding CT to Watch List
• watch list will be displayed on another page
• CTs that are "watched" must be listed on "List All" as well

Detailed Design (Specs)

This component is similar to List CTs in Internal(Jaguar) App. But it is not same, for example columns are different, etc.

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: http://mantis.jaguarfreight.com/wiki/List_CTs#Definition_of_UNDEFINED_LIVE_DELIVERED_ARCHIVED

Table

Table Fields def (same for all tabs):

• MOT
  • this is icon: air, ocn or truck
• Nickname
  • alphanumeric???
  • visible chars: 13
  • max chars: ???
  • validation: ???
• CT#
  • double click forwards to CT Details Page
• Created On
  • CT.DB.CreatedOn field
  • format... example 17 Jul 2009
• Shipper
  • CT.GT.Shipper
  • Display only Company-City
• Consignee
  • CT.GT.Consignee
  • Display only Company-City
• Status
  • Display Pending for CT that is waiting for approval from operator

Table Paging:

• Needs standard ZK paging.
• 15 CTs per page

Table Sorting: next version

Table Searching: next version

Default order: show sorted by CT#, latest at the top

Default tab: Live

Link from CT to Shipment details:

Two options:

• double click
• select Ct and click on "Show selected button"

In both cases CT Details page would open up.

Add to Watch List and Add Nickname Feature

It allows to add any CT from List All to Watch List. See UC3 below!

Use Cases

UC1

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

Solution: click on appropriate tab

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"

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
• 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

TC1

Test all use cases

TC2

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] -- 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] -- Tira 4:41 PM. 19 Sep 2009 (UTC)

Next Version and RFC

sorting: must sort by any column

• use standard ZK sorting (click on table header)
• accommodate this test case:
  • user is on page X
  • user clicks on column Y
  • system must sort and present page 1

searching and filtering: similar to Addrbook

Tweaks

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. -- Tira 5:40 PM 27 Oct 2009

tw2) Add a search filter for shipment list by nickname, shipper, or consignee. See picture for more explanation. -- Tira 5:40 PM 1 Dec 2009

Ver 3.0 major re-design

See http://mantis.jaguarfreight.com/wiki/List_CTs#Ver_3.0_major_re-design