Client Shipment List

From UG

(Difference between revisions)

Revision as of 17:27, 20 May 2010

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

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

Figures

Figure 1. Live Shipment List

Figure 2. Undefined Shipment List

Figure 3. Delivered Shipment List

Figure 4. Archived Shipment List

@@ Line 42: / Line 42: @@
 * 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 ===
@@ Line 50: / Line 54: @@
 === MOT ===
-==== Undefined ====
-* List all CTs that have MOT = undef and apply [[Client visibility rule]]
-==== Live ====
-===== Air and LCL/Client Consol =====
-* ImpTab.ActualDeliveryDate is empty
-===== FCL =====
-* ''CT/Master has no containers OR''
-* ''CT/Master has at least one container AND'' CT.ContainerTable.ContainerXActualDeliveryDate is empty for at least one container
-===== Truck-Ocean =====
-* ''CT has no containers OR''
-* ''CT has at least one container AND'' CT.ContainerTable.ContainerXActualDeliveryDate is empty for at least one container
-===== Truck-Dom and Truck-Air =====
-* GenTab.ActualDeliveryDate is empty
-==== DELIVERED ====
-===== Air and LCL/Client Consol ====
-* ImpTab.ActualDeliveryDate is FROM 180 days in the past TO today
-==== FCL ====
-* ''CT/Master has at least one container AND''
-* CT.ContainerTable.ContainerXActualDeliveryDate is FROM 180 days in the past TO today for <strike>ALL</strike> AT LEAST ONE container
-====   Truck-Ocean ====
-* ''CT has at least one container AND''
-* CT.ContainerTable.ContainerXActualDeliveryDate is FROM 180 days in the past TO today for <strike>ALL</strike> AT LEAST ONE container
-==== Truck-Dom and Truck-Air ====
-* GenTab.ActualDeliveryDate is FROM 180 days in the past TO today
-===  ARCHIVED ===
-==== Air and  LCL / Client Consol ====
-* ImpTab.ActualDeliveryDate is over 180 days in the past
-==== FCL ====
-* CT.ContainerTable.ContainerXActualDeliveryDate for ALL containers in CT/Master is over 180 days in the past
-==== Truck-Ocean ====
-* CT.ContainerTable.ContainerXActualDeliveryDate for ALL containers in CT is over 180 days in the past
-==== Truck-Dom and  Truck-Air ====
-* GenTab.ActualDeliveryDate is over 180 days in the past
-=== Note about valid Actual Delivery Date range ===
-Validation in the system is preventing users from entering Actual Delivery Date that is in the future. That is why date range from tomorrow to any other day in the future  is not considered in the logic above.
-=== Note About Containers ===
-* "CT/Master" means that if CT has no master system should apply logic to just containers attached to CT. And if CT has a Master then system should consider all CTs in the Master.
-* also see http://mantis.jaguarfreight.com/wiki/Containers_and_Contents_Component#FCL_.2F_LCL_vs_Ocean-Truck
 === Table ===
@@ Line 140: / Line 67: @@
 :** Max Chars: [[TBD]]
 * CT#
+:* Show CT#
+:* Double click on CT record, it forwards to CT Shipment Details Page
-** double click forwards to CT Details Page
 * 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
-** CT.GT.Shipper
+:* Mapping: [[CT#Shipper]]
-** Display only Company-City
+:* Display only Company-City
 * 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:'''
@@ Line 161: / Line 88: @@
 * 15 CTs per page
-'''Table Sorting:''' next version
+'''Table Sorting:'''
+* Sort: Ascending/Descending per column
-'''Table Searching:''' next version
+'''Table Searching:'''
+* Search Line
+:* Type: filter by Nickname, Shipper, and Consignee
+:* Widget: [[textbox]]
-'''Default order:''' show sorted by CT#, latest at the top
+'''Default order:'''
+* show sorted by CT#, latest at the top
-'''Default tab:''' Live
+'''Default tab:'''
+* Live
 '''Link from CT to Shipment details: '''
@@ Line 173: / Line 106: @@
 Two options:
 * 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.
 === 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!
-* See [[#Figure 1. Live Shipment List]]
-* See [[#Figure 2. Undefined Shipment List]]
+See UC3 below!
-* See [[#Figure 3. Delivered Shipment List]]
-* See [[#Figure 4. Archived Shipment List]]
 == Use Cases ==