Client Shipment List

From UG

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 Add to Watch List and Add Nickname Feature 6 Use Cases 6.1 UC1 6.2 UC2 6.3 UC3 7 Test Cases and QA 7.1 TC1 7.2 TC2 8 Next Version and RFC 9 Tweaks 10 Ver 3.0 major re-design 11 Figures 11.1 Figure 1. Live Shipment List 11.2 Figure 2. Undefined Shipment List 11.3 Figure 3. Delivered Shipment List 11.4 Figure 4. Archived Shipment List

Mantis

• Parent Mantis:921

Biz Analyst Intro

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

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

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

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

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

MOT

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:

• Needs standard ZK paging.
• 15 CTs per page

Table Sorting:

• Sort: Ascending/Descending per column

Table Searching:

• Search Line

• Type: filter by Nickname, Shipper, and Consignee
• Widget: textbox

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 record 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 user to add any CT from Shipment List to Watch List

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

Figures

Figure 1. Live Shipment List

Figure 2. Undefined Shipment List

Figure 3. Delivered Shipment List

Figure 4. Archived Shipment List