Client MAWB Tracking

From UG

(Difference between revisions)
Jump to: navigation, search
(Figure 3. MAWB Tracking Result Valid)
(SOW 2)
 
(22 intermediate revisions not shown)
Line 1: Line 1:
[[Category:Client]]
[[Category:Client]]
 +
 +
==  Dev ==
 +
Parent Mantis: [http://mantis.jaguarfreight.com/mantis/view.php?id=939 939]
== Biz Analyst Intro ==
== Biz Analyst Intro ==
Line 17: Line 20:
*** Result for tracking shipment
*** Result for tracking shipment
-
==  Dev ==
 
-
Parent Mantis: [http://mantis.jaguarfreight.com/mantis/view.php?id=939 939]
 
==  Specs ==
==  Specs ==
-
 
+
1a) Tracking from MAWB Tracking link from Main Menu and Menu bar  
-
ss1a) Tracking from MAWB Tracking link from Main Menu and Menu bar  
+
* This component is similar to CT1 MAWB tracking
* This component is similar to CT1 MAWB tracking
* Client is able to track air shipments by selecting Airline and Air WayBill
* Client is able to track air shipments by selecting Airline and Air WayBill
Line 29: Line 29:
* See [[#Figure 1. MAWB Tracking design]]
* See [[#Figure 1. MAWB Tracking design]]
-
 
+
1b) Track Air shipment screen consists of
-
ss1b) Track Air shipment screen consists of
+
* It is a pop-up  
* It is a pop-up  
* Message: '''To select an airline, please use the scrolling lists available, or key-in the first letter of airline, and then enter the air waybill in the appropriate box'''
* Message: '''To select an airline, please use the scrolling lists available, or key-in the first letter of airline, and then enter the air waybill in the appropriate box'''
Line 38: Line 37:
* See [[#Figure 2. MAWB Tracking Airline dropdown]]
* See [[#Figure 2. MAWB Tracking Airline dropdown]]
-
 
+
1c) Integrate with Icarus System using HTTP request(GET Method)
-
ss1c) Integrate with Icarus System using HTTP request(GET Method)
+
* HTTP Parameters: userid, airline, and airway bill
* HTTP Parameters: userid, airline, and airway bill
* Client select Airline code and type Air Waybill numeric code
* Client select Airline code and type Air Waybill numeric code
-
 
+
1d) Result page from Airline response return information and generate and display in the HTML code on Icarus end  
-
ss1d) Result page from Airline response return information and generate and display in the HTML code on Icarus end  
+
* Result page provides:  
* Result page provides:  
** Airwaybill number
** Airwaybill number
Line 54: Line 51:
** Destination Port
** Destination Port
** Estimated Time of Departure
** Estimated Time of Departure
-
* See [[#]]
 
-
 
-
ss1e) 2 kinds of an airline response for air shipment
+
1e) 2 kinds of an airline response for air shipment
* All the results are generated and displayed in the HTML code on Icarus end.  
* All the results are generated and displayed in the HTML code on Icarus end.  
-
* Valid shipment result  
+
* '''Valid''' shipment result  
-
** See an example Client.ResultAWBValid picture for guidance
+
** See [[#Figure 3. MAWB Tracking Result Valid]]
-
* Invalid shipment result
+
* '''Invalid''' shipment result
** There is a simple validation on the parameters entered; if the data doesn’t match the format, a validation error will be displayed.
** There is a simple validation on the parameters entered; if the data doesn’t match the format, a validation error will be displayed.
-
** See an example Client.ResultAWBInValid picture for guidance
+
** See [[#Figure 4. MAWB Tracking Result Invalid]]
 +
'''NOTE:''' See Icarus documentation in Mantis for Input parameters and Airline response: [http://mantis.jaguarfreight.com/mantis/view.php?id=940 940]
-
'''NOTE:''' See Icarus documentation in Mantis for Input parameters and Airline response: http://mantis.jaguarfreight.com/mantis/view.php?id=940
 
-
 
+
2a) Track '''Air''' shipment from a specific shipment detail
-
ss2a) Track '''Air''' shipment from a specific shipment detail
+
* There is a button for tracking
* There is a button for tracking
-
** Reference: see picture from http://mantis.jaguarfreight.com/wiki/Client_Shipment_Details#Shipment_Details_Tab_SS
+
** Reference: see picture from [http://mantis.jaguarfreight.com/wiki/Client_Shipment_Details#Shipment_Details_Tab_SS Shipment Details Tab]
-
** It only shows when this shipment has '''Master Airway bill'''(11 digits: 3 digits code for airline, 8 digits for Airway bill) info (disappear when those info are not there)
+
** It only shows when this shipment has '''Master Airway bill'''(11 digits: 3 digits code for airline, 8 digits for Airway bill) info (hides when those info are not there)
* This button is integrated with Icarus system
* This button is integrated with Icarus system
* Result of tracking  
* Result of tracking  
-
ss2b) Track '''Ocean''' shipment from a specific shipment detail
+
2b) Track '''Ocean''' shipment from a specific shipment detail
* Client is able to track ocean shipment at shipment detail> Container tab
* Client is able to track ocean shipment at shipment detail> Container tab
* Track Shipment button
* Track Shipment button
-
** It shows only when this shipment has BOTH '''container number''' and '''shipping line''' info (disappear when those info are not there)
+
** It shows only when this shipment has BOTH '''container number''' and '''shipping line''' info (hides when those info are not there)
*** Container# format: XXXX-YYYYYY-Z
*** Container# format: XXXX-YYYYYY-Z
*** Shipping line (this field is mapped from Internal App> Ocean Shipment > ExpTab > b.4. Steamshipline:(v2)
*** Shipping line (this field is mapped from Internal App> Ocean Shipment > ExpTab > b.4. Steamshipline:(v2)
Line 86: Line 80:
* Result of tracking
* Result of tracking
-
'''NOTE:''' See Icarus documentation in Mantis for Input parameters and Ocean tracking response: http://mantis.jaguarfreight.com/mantis/view.php?id=1101
+
'''NOTE:''' See Icarus documentation in Mantis for Input parameters and Ocean tracking response: [http://mantis.jaguarfreight.com/mantis/view.php?id=1101 1101]
==  Use cases ==
==  Use cases ==
Line 93: Line 87:
'''Steps'''
'''Steps'''
* Client clicks MAWB Tracking from main menu or menu bar
* Client clicks MAWB Tracking from main menu or menu bar
-
* System is generated a window asking client for tracking info
+
* System generates a pop-up window asking client for tracking info
* Client selects an airline from drop down menu
* Client selects an airline from drop down menu
* Client types air waybill number and clicks submit button
* Client types air waybill number and clicks submit button
Line 106: Line 100:
'''Steps'''  
'''Steps'''  
-
* Client clicks on a specific Air shipment; two options
+
* Client clicks on a specific Air shipment; 2 options
-
** Double clicks on a specific Air shipment  
+
** Double clicks on a specific Air shipment from shipment list
** Click on a specific Air shipment and clicks "Show Selected" button
** Click on a specific Air shipment and clicks "Show Selected" button
In both cases CT Details page would open up.
In both cases CT Details page would open up.
Line 118: Line 112:
***** Valid shipment: shipment tracking information  
***** Valid shipment: shipment tracking information  
***** Invalid shipment: error message
***** Invalid shipment: error message
-
** If there is no info for Master Airway bill field, "Track Shipment" button is disappeared
+
** If there is no info for Master Airway bill field, "Track Shipment" button is hidden
*** Client is not able to track this particular shipment(No Track Shipment button)
*** Client is not able to track this particular shipment(No Track Shipment button)
Line 125: Line 119:
'''Steps'''
'''Steps'''
-
* Client clicks on a specific Ocean shipment; two options
+
* Client clicks on a specific Ocean shipment; 2 options
-
** Double clicks on a specific Ocean shipment  
+
** Double clicks on a specific Ocean shipment from shipment list
** Click on a specific Ocean shipment and clicks "Show Selected" button
** Click on a specific Ocean shipment and clicks "Show Selected" button
In both cases CT Details page would open up.
In both cases CT Details page would open up.
Line 137: Line 131:
***** Valid shipment: shipment tracking information  
***** Valid shipment: shipment tracking information  
***** Invalid shipment: error message
***** Invalid shipment: error message
-
** If there is some info for container# but NOT SS line(Shipping Line), "Track Shipment" button is disappeared
+
** If there is some info for container# but NOT SS line(Shipping Line), "Track Shipment" button is hidden
*** Client is not able to track this particular shipment(No Track Shipment button)
*** Client is not able to track this particular shipment(No Track Shipment button)
-
** If there is some info for SS line(shipping line) but NOT container#, "Track Shipment" button is disappeared
+
** If there is some info for SS line(shipping line) but NOT container#, "Track Shipment" button is hidden
*** Client is not able to track this particular shipment(No Track Shipment button)
*** Client is not able to track this particular shipment(No Track Shipment button)
-
** If there is NO info for BOTH container# AND SS line(Shipping Line), "Track Shipment" button is disappeared
+
** If there is NO info for BOTH container# AND SS line(Shipping Line), "Track Shipment" button is hidden
*** Client is not able to track this particular shipment(No Track Shipment button)
*** Client is not able to track this particular shipment(No Track Shipment button)
Line 149: Line 143:
qa2) Make sure all the component working properly
qa2) Make sure all the component working properly
-
 
-
== Tweaks from feedback Sep4, 2009 meeting ==
 
-
 
-
tw1) MAWB Tracking from Main Menu and menu bar - Can we come up with a different design that looks better on Client App in term of blending color better. It now looks like cut and paste the old design
 
-
 
-
==  Look And Feel ==
 
-
To make it more nicely design for CT2 client App, please see figure 1 below.
 
== Figures ==
== Figures ==
Line 170: Line 157:
==='''Figure 3. MAWB Tracking Result Valid''' ===
==='''Figure 3. MAWB Tracking Result Valid''' ===
[[File:ResultAWBValid.JPG]]
[[File:ResultAWBValid.JPG]]
-
 
==='''Figure 4. MAWB Tracking Result Invalid''' ===
==='''Figure 4. MAWB Tracking Result Invalid''' ===
Line 176: Line 162:
==  RFC ==
==  RFC ==
 +
 +
==  SOW 2 ==
 +
Mantis: [http://ct.jaguarfreight.com/mantis/view.php?id=3366 3366]
 +
 +
'''NOTE: MAWB interface with Icarus is no longer supported. Icarus suspended support and service of this interface in 2008. An alternate provider has been identified.''' (www.track-trace.com)
 +
 +
Behavior of the interface should remain as-is. The only change is to redirect to a new URL.
 +
 +
* Update MAWB interface to redirect to new URL:
 +
** For ALL Air Cargo - <nowiki>http://connect.track-trace.com/for/jaguarfreight/aircargo/MAWB_Number/action,direct</nowiki>
 +
*** Example: For Polar Air (403) Airway bill 65393440 - redirect user to http://connect.track-trace.com/for/jaguarfreight/aircargo/403-65393440/action,direct
 +
** For ALL Ocean Cargo - <nowiki>http://connect.track-trace.com/for/jaguarfreight/container/Container_Number/action,direct</nowiki>
 +
*** Example: For container number CLHU349929-8 - redirect user to http://connect.track-trace.com/for/jaguarfreight/container/CLHU3499298/action,direct
 +
* Note the '''/action,direct''' option as this removes an unnecessary track-trace frame from the browser window.
 +
 +
=== SOW 2 PIN ===
 +
* Any changes to interface was made.
 +
* For ocean tracking: carrier attribute does not sending in URL anymore.

Current revision as of 18:19, 9 April 2012


Contents

[edit] Dev

Parent Mantis: 939

[edit] Biz Analyst Intro

MAWB Tracking Shipment feature allows end users to track air and ocean shipments via the carrier's own website. This is currently achieved by using a 3rd party supplier (ICARUS).

[edit] Sys Analyst Intro

  • There are 2 ways of tracking
    • Tracking from MAWB Tracking link from Main Menu and Menu bar
      • Only Air Shipments
      • Stand alone tracking
      • Inputs: airline prefix code and Air Waybill code (Integrate with Icarus system)
      • Result for tracking shipment
    • Tracking shipment from a specific shipment detail
      • Air and Ocean shipments
      • There is a button to click for a specific shipment detail record in order to track
      • Button logic (see specs)
      • Result for tracking shipment


[edit] Specs

1a) Tracking from MAWB Tracking link from Main Menu and Menu bar

  • This component is similar to CT1 MAWB tracking
  • Client is able to track air shipments by selecting Airline and Air WayBill
  • This tracking does not link with any CTs#
  • See #Figure 1. MAWB Tracking design

1b) Track Air shipment screen consists of

  • It is a pop-up
  • Message: To select an airline, please use the scrolling lists available, or key-in the first letter of airline, and then enter the air waybill in the appropriate box
  • Airline prefix dropdown list(auto search by typing characters)
  • Air Waybill textbox (8 digits) and unique with validation: valid format is 8 numbers
  • Submit button
  • See #Figure 2. MAWB Tracking Airline dropdown

1c) Integrate with Icarus System using HTTP request(GET Method)

  • HTTP Parameters: userid, airline, and airway bill
  • Client select Airline code and type Air Waybill numeric code

1d) Result page from Airline response return information and generate and display in the HTML code on Icarus end

  • Result page provides:
    • Airwaybill number
    • Airline
    • Total Pieces
    • Weight
    • Fliend number
    • Date of Departure
    • Destination Port
    • Estimated Time of Departure

1e) 2 kinds of an airline response for air shipment

  • Invalid shipment result

NOTE: See Icarus documentation in Mantis for Input parameters and Airline response: 940


2a) Track Air shipment from a specific shipment detail

  • There is a button for tracking
    • Reference: see picture from Shipment Details Tab
    • It only shows when this shipment has Master Airway bill(11 digits: 3 digits code for airline, 8 digits for Airway bill) info (hides when those info are not there)
  • This button is integrated with Icarus system
  • Result of tracking

2b) Track Ocean shipment from a specific shipment detail

  • Client is able to track ocean shipment at shipment detail> Container tab
  • Track Shipment button
    • It shows only when this shipment has BOTH container number and shipping line info (hides when those info are not there)
      • Container# format: XXXX-YYYYYY-Z
      • Shipping line (this field is mapped from Internal App> Ocean Shipment > ExpTab > b.4. Steamshipline:(v2)
  • This button is integrated with Icarus system
  • Result of tracking

NOTE: See Icarus documentation in Mantis for Input parameters and Ocean tracking response: 1101

[edit] Use cases

uc1) Client tracks an AIR shipment without knowing shipment detail but knowing an airline and airway bill

Steps

  • Client clicks MAWB Tracking from main menu or menu bar
  • System generates a pop-up window asking client for tracking info
  • Client selects an airline from drop down menu
  • Client types air waybill number and clicks submit button
  • System is integrated with Icarus system
  • Icarus system generates a result of shipment tracking detail
    • There are 2 kinds of results
      • Valid shipment: shipment tracking information
      • Invalid shipment: error message


uc2) Client tracks an AIR shipment with knowledge of shipment detail

Steps

  • Client clicks on a specific Air shipment; 2 options
    • Double clicks on a specific Air shipment from shipment list
    • Click on a specific Air shipment and clicks "Show Selected" button

In both cases CT Details page would open up.

  • There is 2 cases:
    • If there is some info for Master Airway bill field, "Track Shipment" button is appeared
      • Client tracks this particular shipment by clicking "Track Shipment" button
      • System is integrated with Icarus system
      • Icarus system generates a result of shipment tracking detail
        • There are 2 kinds of results
          • Valid shipment: shipment tracking information
          • Invalid shipment: error message
    • If there is no info for Master Airway bill field, "Track Shipment" button is hidden
      • Client is not able to track this particular shipment(No Track Shipment button)


uc3) Client tracks an OCEAN shipment with knowledge of shipment detail

Steps

  • Client clicks on a specific Ocean shipment; 2 options
    • Double clicks on a specific Ocean shipment from shipment list
    • Click on a specific Ocean shipment and clicks "Show Selected" button

In both cases CT Details page would open up.

  • There is 4 cases:
    • If there is some info for BOTH container# AND SS line(Shipping Line), "Track Shipment" button is appeared
      • Client tracks this particular shipment by clicking "Track Shipment" button
      • System is integrated with Icarus system
      • Icarus system generates a result of shipment tracking detail
        • There are 2 kinds of results
          • Valid shipment: shipment tracking information
          • Invalid shipment: error message
    • If there is some info for container# but NOT SS line(Shipping Line), "Track Shipment" button is hidden
      • Client is not able to track this particular shipment(No Track Shipment button)
    • If there is some info for SS line(shipping line) but NOT container#, "Track Shipment" button is hidden
      • Client is not able to track this particular shipment(No Track Shipment button)
    • If there is NO info for BOTH container# AND SS line(Shipping Line), "Track Shipment" button is hidden
      • Client is not able to track this particular shipment(No Track Shipment button)

[edit] QA

qa1) Test uc1...uc3

qa2) Make sure all the component working properly

[edit] Figures

[edit] Figure 1. MAWB Tracking design

File:MAWBTracking.JPG


[edit] Figure 2. MAWB Tracking Airline dropdown

File:MAWBTrackingAIR.JPG


[edit] Figure 3. MAWB Tracking Result Valid

File:ResultAWBValid.JPG

[edit] Figure 4. MAWB Tracking Result Invalid

File:AirTrackInvalidAWB.JPG

[edit] RFC

[edit] SOW 2

Mantis: 3366

NOTE: MAWB interface with Icarus is no longer supported. Icarus suspended support and service of this interface in 2008. An alternate provider has been identified. (www.track-trace.com)

Behavior of the interface should remain as-is. The only change is to redirect to a new URL.

[edit] SOW 2 PIN

  • Any changes to interface was made.
  • For ocean tracking: carrier attribute does not sending in URL anymore.
Personal tools