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.2.1 Undefined 5.2.2 Live 5.2.2.1 Air and LCL/Client Consol 5.2.2.2 FCL 5.2.2.3 Truck-Ocean 5.2.2.4 Truck-Dom and Truck-Air 5.2.3 DELIVERED 5.2.4 = Air and LCL/Client Consol 5.2.5 FCL 5.2.6 Truck-Ocean 5.2.7 Truck-Dom and Truck-Air 5.3 ARCHIVED 5.3.1 Air and LCL / Client Consol 5.3.2 FCL 5.3.3 Truck-Ocean 5.3.4 Truck-Dom and Truck-Air 5.4 Note about valid Actual Delivery Date range 5.5 Note About Containers 5.6 Table 5.7 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.

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

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

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#

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

• See #Figure 1. Live Shipment List
• See #Figure 2. Undefined Shipment List
• See #Figure 3. Delivered Shipment List
• See #Figure 4. Archived Shipment 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