Client Main Report

From UG

(Difference between revisions)
Jump to: navigation, search
(Client In Transit Report SS)
(Examples)
 
(72 intermediate revisions not shown)
Line 1: Line 1:
[[Category:Client_Reports]]
[[Category:Client_Reports]]
-
 
-
== Major Edits ==
 
-
* --[[User:Alex|Alex]] 22:21, 31 July 2009 (UTC) : added ''Business Requirements'' section
 
-
* --[[User:Alex|Alex]] 22:35, 31 July 2009 (UTC) : added alternative naming for specs (with "it" or "mw")
 
-
* --[[User:Alex|Alex]] 22:53, 31 July 2009 (UTC) : added it2)
 
-
* --[[User:Alex|Alex]] 23:15, 31 July 2009 (UTC) : updasted mw2)
 
-
* see wiki history for minor edits
 
==  Dev ==
==  Dev ==
Line 12: Line 5:
==  Business Requirements ==
==  Business Requirements ==
 +
Client Main Report is reusing the code from Internal App Main Report. There are some similarities and differences in term of list of filters, output and design.
-
* The goal of this component is to give client user ability to run reports
+
It allows client to create a report for his/her company's shipments. This applies client's visibility's rules.
-
* We can give same reports we have for Jag user
+
-
* Of course we need to adapt them:
+
-
** show client user only "his records" (that we allowed him to see)
+
-
** show client user only "his filters" (that we allowed him to see)
+
-
** output format might be different for jag vs non-jag user
+
== Specs ==
== Specs ==
-
'''ss1''' This component consists of:
+
* See Main report specs from Internal App > Main Report at  [[Main Wizard Report]]
-
* Client In Transit Report  
+
* There are 4 different categories for filters:
-
* Client Main (Wizard) Report
+
** General Filters
-
 
+
** Transportation Filters
-
'''ss2''' see separate sections in this doc for each report
+
** Date Filters
-
 
+
** Output
-
== Client In Transit Report SS ==
+
* Some filters require [[Client visibility rule]]
-
See [[Client In Transit Report (component)]]
+
* There is Reset Form button; It allows user to clear all the filters to the fresh beginning stage
-
 
+
* There is Generate Result button; system will generate result after user clicks this button
-
== Client Main (Wizard) Report SS ==
+
* Label of filters' names can be different from Internal Main Report
 +
* Each filter has "clr" button in order to clear info for a specific filter
 +
* See [[#Figure 1. Main report]]
-
mw1) (ss1) This is a client version of [[Main Wizard Report]]
+
=== General Filters ===
-
 
+
* All the same as Main report (Internal App) but these filters drop down list MUST be '''Client specific: Auto populated'''; it should show only the specific list for client:
-
mw2) (ss2) <strike>All same but: --[[User:Alex|Alex]] 23:24, 31 July 2009 (UTC)</strike> See additional specs for changes --[[User:Tira|Tira]] 11:33, 19 Aug 2009
+
** Client Company
-
* extra filter: [[Client visibility rule]]
+
*** Show/hide Client Companies list filter. When there is only client company in the filter, this filter section should be invisible. If there is more than one client companies, this filter becomes visible.
-
* '''new''' remove these filters:  
+
** Shipper
 +
** Consignee
 +
** Origin Country
 +
** Destination Country
 +
** Origin Region
 +
** Destination Region
 +
** Shipping Terms
 +
** Pickup Locations
 +
** Delivery Locations
 +
* The rest of filters are not required '''Client specific: Auto populated'''
 +
** P.O. contains:
 +
** SKU contains:
 +
** Customer Ref # contains:
 +
** Booking # contains: ''is applied only for OCEAN CTs''
 +
* List of filters that are not required, compare to Main Wizard Report on Internal App
** Export Ref # contains:
** Export Ref # contains:
** Import Ref # contains:
** Import Ref # contains:
** Jaguar 3rd Ref # contains:
** Jaguar 3rd Ref # contains:
-
 
-
[[File:ReportMainTabs.JPG|thumb|400 px|Client.Report.MainTabs]]
 
-
 
-
'''Additional specs''' --[[User:Tira|Tira]] 11:33, 19 Aug 2009
 
-
 
-
* There are 4 filters tabs: General Filters, Transportation Filters, Date Filters, and Output
 
-
 
-
* '''General Filters'''
 
-
** All the same but these filters drop down list MUST be '''Client specific: Auto populated''' (currently showing the whole long list, it should show only the specific list for client):
 
-
*** Client Company
 
-
*** Shipper
 
-
*** Consignee
 
-
*** Origin Country (also update name from "Original Country" to "Origin Country"
 
-
*** Destination Country
 
-
*** Shipping Terms
 
-
*** Pickup Locations
 
-
*** Delivery Locations
 
** Remove Cargo Locations
** Remove Cargo Locations
-
 
+
* Transport Mode filters in General filters Tab has a logic connecting to Transportation Filters.
-
* Transport Mode filters in General Tab logic connect to Transportation Filters:
+
** IF client selects ANY OCEAN for transport mode, Transportation Filters tab will provide ONLY lists of ocean filters as below:
-
** IF client select ANY OCEAN and click check box, Transportation Filters tab will show ONLY ocean filters as below:
+
*** Container#s
*** Container#s
-
*** Shipping Line (also update name from "Steamshipline" to "Shipping Line"
+
*** Shipping Line  
-
*** Origin Port/Terminal (also update name from "Original Port/Terminal" to "Origin Port/Terminal"
+
*** Origin Port/Terminal  
*** Destination Port/Terminal
*** Destination Port/Terminal
*** Vessel Name Contains
*** Vessel Name Contains
-
** IF client select AIR and click check box, Transportation Filters tab will show ONLY air filters as below:
+
** IF client select AIR for transport mode, Transportation Filters tab will provide ONLY lists of air filters as below:
*** Airlines
*** Airlines
-
*** Origin Airport (also update name from "From Airport" to "Origin Airport"
+
*** Origin Airport
-
*** Destination Airport (also update name from "To Airport" to "Destination Airport"
+
*** Destination Airport
-
 
+
** IF client selects Truck-Domestic for transport mode, Transportation Filters tab will provide ONLY lists of Truck-Domestic filters as below:
 +
*** Pickup Trucker: The list must be auto populated only specific list that is applied to specific client.
 +
*** Delivery Trucker: The list must be auto populated only specific list that is applied to specific client.
 +
*** Pickup Trailer# contains: Text box for user’s input
 +
*** Delivery Trailer# contains: Text box for user’s input
 +
*** Origin City contains: Text box for user’s input
 +
*** Destination City contains: Text box for user’s input
 +
*** Origin State: The list of State(US) must be auto populated only specific list that is applied to specific client.
 +
*** Destination State: The list of State(US) must be auto populated only specific list that is applied to specific client.
 +
*** Origin Zip code contains: The list of zipcode
 +
*** Destination Zip code contains: The list of zipcode
 +
* Transport Mode filter list should includes all modes and Undefined mode as listed option
 +
* There is a filter Archived Check box, same as internal application main report that default to No Archived
 +
=== Transportation Filters ===
* '''Transportation Filters'''
* '''Transportation Filters'''
** '''AIR''' filters will ONLY show when client clicks AIR for Transport Mode in General filter tab
** '''AIR''' filters will ONLY show when client clicks AIR for Transport Mode in General filter tab
-
*** These filters drop down list MUST be '''Client specific: Auto populated'''(currently showing the whole long list, it should show only the specific list for client):
+
*** These filters drop down list MUST be '''Client specific: Auto populated'''; it should show only the specific list for client:
**** Airlines
**** Airlines
**** Origin Airport
**** Origin Airport
**** Destination Airport
**** Destination Airport
** '''OCEAN''' filters will ONLY show when client clicks ANY OCEAN for Transport Mode in General filter tab
** '''OCEAN''' filters will ONLY show when client clicks ANY OCEAN for Transport Mode in General filter tab
-
*** These filters drop down list MUST be '''Client specific: Auto populated'''(currently showing the whole long list, it should show only the specific list for client):
+
*** These filters drop down list MUST be '''Client specific: Auto populated'''; it should show only the specific list for client:
**** Container#s
**** Container#s
**** Shipping Line  
**** Shipping Line  
Line 86: Line 86:
**** Destination Port/Terminal
**** Destination Port/Terminal
**** Vessel Name Contains
**** Vessel Name Contains
-
** Remove these filters:
+
**'''TRUCK''' There is no any filters on Transportation filters except Truck- Domestic
 +
***'''TRUCK-DOMESTIC''' filters will ONLY show when client clicks Truck-Domestic for Transport Mode in General filter tab
 +
**** These filters drop down list MUST be '''Client specific: Auto populated'''; it should show only the specific list for client:
 +
***** Pickup Trucker
 +
***** Delivery Trucker
 +
***** Pickup Trailer# contains: Text box for user’s input
 +
***** Delivery Trailer# contains: Text box for user’s input
 +
***** Origin City contains
 +
***** Destination City contains
 +
***** Origin State
 +
***** Destination State
 +
***** Origin Zip code contains
 +
***** Destination Zip code contains
 +
**** Please NOTE that city, state, and zip code are for US and CANADA ONLY
 +
* Transport Mode filter list should includes all modes and Undefined mode as listed option
 +
* See [[#Figure 2. Transportation Filters]] for the case of no transport mode is selected or Truck mode(s) is selected from general filters
 +
* List of filters that are not required, compare to Main Wizard Report on Internal App
*** Pickup Truckers
*** Pickup Truckers
*** Delivery Truckers
*** Delivery Truckers
Line 92: Line 108:
*** Co-Loader Air
*** Co-Loader Air
 +
=== Date Filters ===
 +
* Order of Filters from the top to the bottom"
 +
** Estimated Pickup Date:
 +
** Actual Pickup Date:
 +
** Estimated Departure Date:  
 +
** Actual Departure Date:
 +
** Estimated Arrival Date:
 +
** Actual Arrival Date:
 +
** Estimated Delivery Date:
 +
** Actual Delivery Date: 
 +
* Date Logics:
 +
** "Delivery Date" cannot be before "Arrival Date", "Departure Date", and "Pickup Date"
 +
** "Arrival Date" cannot be before "Departure Date", and "Pickup Date"
 +
** "Departure Date" cannot be before "Pickup Date"
 +
* Must have "clear" button for every date field .
 +
* See [[#Figure 3. Date Filters]]
-
* '''Date Filters'''
+
=== Output ===
-
** Order of Filters from the top to the bottom"
+
* Output consists of a long list of headings
-
*** Estimated Pickup Date:
+
* Output list is multi-selected
-
*** Actual Pickup Date:
+
* Default: selected output list should be listed on the right box and the rest should be in output dropdown list
-
*** Estimated Departure Date:  
+
* User is able to manage the order of the output heading list by moving up and down
-
*** Actual Departure Date:
+
* User is able to add/remove the output heading list by moving it to the left or right
-
*** Estimated Arrival Date:
+
* See [[#Figure 4. Output]]
-
*** Actual Arrival Date:
+
* Label output heading as listed below
-
*** Estimated Delivery Date:
+
** '''Field // Apply to Mode // Default on the right box
-
*** Actual Delivery Date: 
+
** CT# // All modes // Yes
-
** Date Logics:
+
** Shipper // All modes // Yes
-
*** "Delivery Date" cannot be before "Arrival Date", "Departure Date", and "Pickup Date"
+
** Consignee // All modes // Yes
-
*** "Arrival Date" cannot be before "Departure Date", and "Pickup Date"
+
** Transport Mode // All modes // Yes
-
*** "Departure Date" cannot be before "Pickup Date"
+
** Departure // All modes // Yes
-
** Must have "clr" button for every date field [[File:ClrDateButton.JPG]]
+
** Destination // All modes // Yes
 +
** Actual Departure Date // All modes // Yes
 +
** Actual Arrival Date // All modes // Yes
 +
** Actual Delivery Date // All modes // Yes
 +
** Commodity Item PO# // All modes // No
 +
** Commodity Item SKU# // All modes // No
 +
** Commodity Item Description // All modes // No
 +
** Commodity Item Quantity // All modes // No
 +
** Commodity Item Total Pallets // All modes // No
 +
** Commodity Item Total Loose Packages // All modes // No
 +
** Commodity Item Gross Kg // All modes // No
 +
** Chargeable Weight // All modes // No
 +
** Departure Region // All modes // No
 +
** Destination Region // All modes // No
 +
** Notification Date // All modes // No
 +
** Authorization Date // All modes // No
 +
** Estimated Departure Date // All modes // No
 +
** Estimated Arrival Date // All modes // No
 +
** Estimated Delivery Date // All modes // No
 +
** Estimated Collection Date // All modes // No
 +
** Actual Collection Date // All modes // No
 +
** Vessel name // OCEAN // No
 +
** Flight Number // AIR // No
 +
** HAWB# // AIR // No
 +
** Container Description // OCEAN // No
 +
** Shipping Line // OCEAN // No
 +
** Airline // AIR // No
 +
** Commodity Item Extra Field 1 // All modes // No
 +
** Commodity Item Extra Field 2 // All modes // No
 +
** Commodity Item Extra Field 3 // All modes // No
 +
** Steamshipline Booking # // OCEAN // No
 +
** Commodity Item Gross Lb // All modes // No
 +
** Pickup Trucker // TRUCK-DOMESTIC // No
 +
** Delivery Trucker // TRUCK-DOMESTIC // No
 +
** Pickup Trailer# // TRUCK-DOMESTIC // No
 +
** Delivery Trailer# // TRUCK-DOMESTIC // No
 +
** Origin City // TRUCK-DOMESTIC // No 
 +
** Origin State // TRUCK-DOMESTIC // No
 +
** Origin Zip Code // TRUCK-DOMESTIC // No 
 +
** Destination City // TRUCK-DOMESTIC // No
 +
** Destination State // TRUCK-DOMESTIC // No
 +
** Destination Zip Code // TRUCK-DOMESTIC // No
-
 
-
* '''Output'''
 
-
** Logic for these lists. When client selects "Transport Mode" from General tab to AIR or Ocean, lists of AIR or Ocean hide/show to apply with particular Mode in output dropdown list.
 
-
** These header lists should be in output dropdown
 
-
*** '''Field // Mode'''
 
-
*** CT# // ALL
 
-
*** Shipper // ALL
 
-
*** Consignee // ALL
 
-
*** Mode // ALL
 
-
*** PO# // ALL
 
-
*** Item# // ALL
 
-
*** Origin Port // ALL
 
-
*** Destination Port // ALL
 
-
*** Origin Region // ALL
 
-
*** Destination Region // ALL
 
-
*** Notification Date // ALL
 
-
*** Authorization Date // ALL
 
-
*** ETS // ALL (this is mapped to field ExpTab 12b)
 
-
*** ATS // ALL (this is mapped to field ExpTab 12c)
 
-
*** ETA // ALL (this is mapped to field ExpTab 14b)
 
-
*** ATA // ALL (this is mapped to field ExpTab 14c)
 
-
*** Estimated Collection Date // ALL (this is mapped to a field in ContTab for FCL shipment)
 
-
*** Actual Collection Date // ALL (this is mapped to a field in ContTab for FCL shipment)
 
-
*** Requested Delivery Date // ALL (this is mapped to a field in ContTab for FCL shipment)
 
-
*** Actual Delivery Date // ALL (this is mapped to a field in ContTab for FCL shipment)
 
-
*** Total Pallets // ALL
 
-
*** Total Loose Packages // ALL
 
-
*** Total Weight // ALL
 
-
*** Total Chargeable Weight // ALL
 
-
*** Description // ALL
 
-
*** Vessel name //OCEAN
 
-
*** Flight Number // AIR
 
-
*** HAWB# // AIR
 
-
*** Container# (s) // OCEAN
 
-
*** Airline // AIR
 
-
*** Shipping Line // OCEAN
 
More information from fields above:
More information from fields above:
Line 150: Line 187:
Air
Air
-
  ETS :ExpTab 11b. Airport of Departure:
+
  ETD :ExpTab 11b. Airport of Departure:
-
  ATS :ExpTab 11c. ATD - Actual Time of Dept:
+
  ATD :ExpTab 11c. ATD - Actual Time of Dept:
  ETA :ExpTab 14b. ETA - Est Time of Arrival:
  ETA :ExpTab 14b. ETA - Est Time of Arrival:
  ATA :ExpTab 14c. ATA - Actual Time of Arrival:
  ATA :ExpTab 14c. ATA - Actual Time of Arrival:
Line 161: Line 198:
Ocean
Ocean
-
  ETS :ExpTab 12b. ETD:
+
  ETD :ExpTab 12b. ETD:
-
  ATS :ExpTab 12c. ATD:
+
  ATD :ExpTab 12c. ATD:
  ETA :ExpTab 14b. ETA:
  ETA :ExpTab 14b. ETA:
  ATA :ExpTab 14c. ATA:
  ATA :ExpTab 14c. ATA:
Line 169: Line 206:
  Requested Delivery Date: ContTab for FCL shipment, ImpTab 10. Estimated Delivery Date: for LCL
  Requested Delivery Date: ContTab for FCL shipment, ImpTab 10. Estimated Delivery Date: for LCL
  Actual Delivery Date: ContTab for FCL shipment, ImpTab 11. Actual Delivery Date: for LCL
  Actual Delivery Date: ContTab for FCL shipment, ImpTab 11. Actual Delivery Date: for LCL
-
 
Truck
Truck
-
  ETS :GenTab 9. Estimated Export Pick-Up Date:
+
  ETD :GenTab 9. Estimated Export Pick-Up Date:
-
  ATS :GenTab 10. Actual Export Pick-Up Date:
+
  ATD :GenTab 10. Actual Export Pick-Up Date:
  ETA :GenTab x. Estimated Delivery:
  ETA :GenTab x. Estimated Delivery:
  ATA :GenTab y. Actual Delivery:
  ATA :GenTab y. Actual Delivery:
Line 182: Line 218:
  Actual Delivery Date: GenTab y. Actual Delivery:
  Actual Delivery Date: GenTab y. Actual Delivery:
-
== Use cases ==
+
== Report output ==
-
==  QA ==
+
* HTML and xls
-
==  Look And Feel ==
+
* Show record() count on the report to indicate that how many shipments per mode
-
==  Tweaks ==
+
-
tw1) remove '''Go back''' button from the where Is top bar. -- Tira 11:20 AM 28 July 2009 (UTC)
+
==  Figures ==
 +
=== Figure 1. Main report ===
 +
[[File:MainReport.JPG]]
-
'''Note:''' Feedback from Simon on Oct2, 2009 -- [[user:Tira|Tira]] 9:10 AM 3 Oct 2009 (UTC)
 
-
tw2) Main Report: Default selected output list in the combo box as list below:
+
=== Figure 2. Transportation Filters ===
-
* Shipper
+
[[File:TransportModeFilter.JPG]]
-
* Consignee
+
-
* Mode
+
-
* Departure
+
-
* Destination
+
-
* Chargeable Weight
+
-
* Actual Departure Date
+
-
* Actual Arrival Date
+
-
* Actual Delivery Date
+
-
The rest of the list should be in default dropdown
 
-
tw3) Main Report: Update label names:
+
=== Figure 3. Date Filters ===
-
* from "Departure Estimated Date" to "Estimated Departure Date"
+
[[File:DateFilter.JPG]]
-
* from "Departure Actual Date" to "Actual Departure Date"
+
-
* from "Arrival Estimated Date" to "Estimated Arrival Date"
+
-
* from "Arrival Actual Date" to "Actual Arrival Date"
+
-
tw4) Main and In-transit Report: Show/hide Client Companies list filter. When there is only client company in the filter, this filter section should be invisible. If there is more than one client companies, this filter becomes visible.
+
 
 +
=== Figure 4. Output ===
 +
[[File:MainReportOutput.JPG]]
 +
 
 +
=== Figure 5. Transportation for Truck-Domestic ===
 +
[[File:TransportModeTruckDom.JPG]]
== Tweaks version 1.1.a ==
== Tweaks version 1.1.a ==
Line 220: Line 249:
tw3) Create download to excel button -> generate xls report
tw3) Create download to excel button -> generate xls report
 +
 +
== Tweak version 1.1.b ==
 +
 +
tw1) Main Report - List of Transport Mode (filter) MUST include "UNDEFINED" as well in order to see Undefined shipments -- [[user:Tira|Tira]] 11:00 AM Feb 2, 2010
 +
 +
== m2040 ==
 +
Mantis: [http://mantis.jaguarfreight.com/mantis/view.php?id=2047 2047]
 +
 +
=== SA ===
 +
* Add Booking # filter
 +
'''Booking #'''
 +
:* Label: Booking # contains:
 +
:* Widget: [[textbox]] , can be multiple selected
 +
:* Location: After Customer Ref # contains:
 +
* Add Booking # on Output tab
 +
:* Default: on the left side dropdown list
 +
NOTE: this field is applied to Ocean shipments ONLY
 +
 +
== m2444 ==     
 +
* 0002444: (Client Report: Main) Add No Archived Checkbox, same as internal application main report
 +
 +
As on http://mantis.jaguarfreight.com/wiki/Main_Report#Figure_3:_Main_Report_General_Filters
 +
 +
default to = Not Archived
 +
* spec updated? Yes
 +
 +
== m2236 ==
 +
* Mantis: [http://mantis.jaguarfreight.com/mantis/view.php?id=2236 2236]
 +
* See [http://mantis.jaguarfreight.com/wiki/Client_Main_Report#Transportation_Filters Transportation Filter]
 +
* See [[#Figure 5. Transportation for Truck-Domestic]]
 +
* Spec is updated: Y
==  RFC ==
==  RFC ==
rfc1) Simon would like to have dynamic filters for Client App by setting filters in Admin Mode for Non-jaguar Users  -- [[user:Tira|Tira]]  12:33PM 19 Aug 2009 (UTC)
rfc1) Simon would like to have dynamic filters for Client App by setting filters in Admin Mode for Non-jaguar Users  -- [[user:Tira|Tira]]  12:33PM 19 Aug 2009 (UTC)
 +
 +
== SOW ==
 +
 +
=== SOW 1 Enable sales invoices as output for clients with filter the output only specific bill to party visibility ===
 +
 +
* '''mantis''': [http://mantis.jaguarfreight.com/mantis/view.php?id=4560 '''4560''']
 +
 +
==== Core Requirements ====
 +
* Re-implement sales invoice as a Main Report output for clients BUT filter the output to show ONLY invoices issued to a bill to party that listed in the Client User's E0 Client Profile.
 +
* Include only “related bill to parties” invoices from a client interface
 +
:* see Client Profile – Part H >>> maybe a simple “enable client visibility” check box in that section with list of users who hve access to this invoices and see this fields as output in report.
 +
 +
==== Solution ====
 +
* Client user can ONLY see what is linked to his E0
 +
:* Client User Admin - Enable Financial section on user profile
 +
[[File: EnableFinancialVisibility.png]]
 +
:* Client Company Admin - Bill to parties linked
 +
[[File: ClientAdmin-BillToPartyCompany.png]]
 +
:* Main report (client) - sales invoices output
 +
* Select client users have visibility (it's a user specific access)
 +
:* Client Company Admin > enable list of users to see Financial data
 +
:* Mirroring enable list of users
 +
[[File: UsersToSeeFinancial.png]]
 +
 +
 +
<hr>
 +
 +
=== SOW 2 Client Visibility for Invoices in Main report ===
 +
 +
* '''mantis''': [http://mantis.jaguarfreight.com/mantis/view.php?id=4604 '''4604''']
 +
 +
==== Core Requirements ====
 +
* This is updated logic for filtering financial information in Client Application.
 +
* Where we are today:
 +
:* user will see ALL Invoices for ALL "Bill To Party" Companies linked to ALL "E0. Client Company" from Client User Admin
 +
* Where we want to go:
 +
:* user can see Invoices issued for only "Bill To Parties" selected in Client Company Admin for the CT's "E0. Client Company" to be visible ''(not implemented yet)''
 +
 +
==== Solution ====
 +
Logic Hierarchy for Client User:
 +
 +
* The FIRST question: Does the CLIENT want ANYONE to see FINANCIALS?
 +
:* E0 Client Profile > Check Box > Financial Visibility: yes / no ''(default is NO)''
 +
* The SECOND questions ''(only if first question answer is YES)'': What client users does the CLIENT allow to have visibility to financials?
 +
:* if first question answer is NO then NO USERS can have visibility.
 +
 +
==== Examples ====
 +
* '''User Profile Admin section'''. User A is Client User for "E0. Client Company" = {Elizabeth Arden; EA DOM}
 +
* '''Client Company Admin section'''. "E0. Client Company" linked to "Bill To Party":
 +
:* for Elizabeth Arden = {Elizabeth Arden Roanoke; EA Geneva}
 +
:* for EA DOM = {EA Domestic}
 +
 +
* '''Scenario 1'''.
 +
* E0 Visibility set for Client User in Client Company Admin to:
 +
:* Elizabeth Arden - Yes,
 +
:* EA DOM - Yes.
 +
* Enabled visibility:
 +
:* If EA DOM has a "EA Geneva" invoice, User A '''cannot''' see that invoice (only EA Domestic).
 +
 +
* '''Scenario 2'''
 +
* E0 Visibility set for Client User in Client Company Admin to:
 +
:* Elizabeth Arden - No,
 +
:* EA DOM - Yes.
 +
* Enabled visibility:
 +
:* Only CT's for E0 EADOM will "show" financial visibility to User A.
 +
:* This user will NOT see any financial information for E0 Elizabeth Arden CT's.
 +
 +
 +
<hr>

Current revision as of 14:42, 11 June 2014


Contents

[edit] Dev

Mantis parent: 0000591:Client.Reports

[edit] Business Requirements

Client Main Report is reusing the code from Internal App Main Report. There are some similarities and differences in term of list of filters, output and design.

It allows client to create a report for his/her company's shipments. This applies client's visibility's rules.

[edit] Specs

  • See Main report specs from Internal App > Main Report at Main Wizard Report
  • There are 4 different categories for filters:
    • General Filters
    • Transportation Filters
    • Date Filters
    • Output
  • Some filters require Client visibility rule
  • There is Reset Form button; It allows user to clear all the filters to the fresh beginning stage
  • There is Generate Result button; system will generate result after user clicks this button
  • Label of filters' names can be different from Internal Main Report
  • Each filter has "clr" button in order to clear info for a specific filter
  • See #Figure 1. Main report

[edit] General Filters

  • All the same as Main report (Internal App) but these filters drop down list MUST be Client specific: Auto populated; it should show only the specific list for client:
    • Client Company
      • Show/hide Client Companies list filter. When there is only client company in the filter, this filter section should be invisible. If there is more than one client companies, this filter becomes visible.
    • Shipper
    • Consignee
    • Origin Country
    • Destination Country
    • Origin Region
    • Destination Region
    • Shipping Terms
    • Pickup Locations
    • Delivery Locations
  • The rest of filters are not required Client specific: Auto populated
    • P.O. contains:
    • SKU contains:
    • Customer Ref # contains:
    • Booking # contains: is applied only for OCEAN CTs
  • List of filters that are not required, compare to Main Wizard Report on Internal App
    • Export Ref # contains:
    • Import Ref # contains:
    • Jaguar 3rd Ref # contains:
    • Remove Cargo Locations
  • Transport Mode filters in General filters Tab has a logic connecting to Transportation Filters.
    • IF client selects ANY OCEAN for transport mode, Transportation Filters tab will provide ONLY lists of ocean filters as below:
      • Container#s
      • Shipping Line
      • Origin Port/Terminal
      • Destination Port/Terminal
      • Vessel Name Contains
    • IF client select AIR for transport mode, Transportation Filters tab will provide ONLY lists of air filters as below:
      • Airlines
      • Origin Airport
      • Destination Airport
    • IF client selects Truck-Domestic for transport mode, Transportation Filters tab will provide ONLY lists of Truck-Domestic filters as below:
      • Pickup Trucker: The list must be auto populated only specific list that is applied to specific client.
      • Delivery Trucker: The list must be auto populated only specific list that is applied to specific client.
      • Pickup Trailer# contains: Text box for user’s input
      • Delivery Trailer# contains: Text box for user’s input
      • Origin City contains: Text box for user’s input
      • Destination City contains: Text box for user’s input
      • Origin State: The list of State(US) must be auto populated only specific list that is applied to specific client.
      • Destination State: The list of State(US) must be auto populated only specific list that is applied to specific client.
      • Origin Zip code contains: The list of zipcode
      • Destination Zip code contains: The list of zipcode
  • Transport Mode filter list should includes all modes and Undefined mode as listed option
  • There is a filter Archived Check box, same as internal application main report that default to No Archived

[edit] Transportation Filters

  • Transportation Filters
    • AIR filters will ONLY show when client clicks AIR for Transport Mode in General filter tab
      • These filters drop down list MUST be Client specific: Auto populated; it should show only the specific list for client:
        • Airlines
        • Origin Airport
        • Destination Airport
    • OCEAN filters will ONLY show when client clicks ANY OCEAN for Transport Mode in General filter tab
      • These filters drop down list MUST be Client specific: Auto populated; it should show only the specific list for client:
        • Container#s
        • Shipping Line
        • Origin Port/Terminal
        • Destination Port/Terminal
        • Vessel Name Contains
    • TRUCK There is no any filters on Transportation filters except Truck- Domestic
      • TRUCK-DOMESTIC filters will ONLY show when client clicks Truck-Domestic for Transport Mode in General filter tab
        • These filters drop down list MUST be Client specific: Auto populated; it should show only the specific list for client:
          • Pickup Trucker
          • Delivery Trucker
          • Pickup Trailer# contains: Text box for user’s input
          • Delivery Trailer# contains: Text box for user’s input
          • Origin City contains
          • Destination City contains
          • Origin State
          • Destination State
          • Origin Zip code contains
          • Destination Zip code contains
        • Please NOTE that city, state, and zip code are for US and CANADA ONLY
  • Transport Mode filter list should includes all modes and Undefined mode as listed option
  • See #Figure 2. Transportation Filters for the case of no transport mode is selected or Truck mode(s) is selected from general filters
  • List of filters that are not required, compare to Main Wizard Report on Internal App
      • Pickup Truckers
      • Delivery Truckers
      • Co-Loader Ocean
      • Co-Loader Air

[edit] Date Filters

  • Order of Filters from the top to the bottom"
    • Estimated Pickup Date:
    • Actual Pickup Date:
    • Estimated Departure Date:
    • Actual Departure Date:
    • Estimated Arrival Date:
    • Actual Arrival Date:
    • Estimated Delivery Date:
    • Actual Delivery Date:
  • Date Logics:
    • "Delivery Date" cannot be before "Arrival Date", "Departure Date", and "Pickup Date"
    • "Arrival Date" cannot be before "Departure Date", and "Pickup Date"
    • "Departure Date" cannot be before "Pickup Date"
  • Must have "clear" button for every date field .
  • See #Figure 3. Date Filters

[edit] Output

  • Output consists of a long list of headings
  • Output list is multi-selected
  • Default: selected output list should be listed on the right box and the rest should be in output dropdown list
  • User is able to manage the order of the output heading list by moving up and down
  • User is able to add/remove the output heading list by moving it to the left or right
  • See #Figure 4. Output
  • Label output heading as listed below
    • Field // Apply to Mode // Default on the right box
    • CT# // All modes // Yes
    • Shipper // All modes // Yes
    • Consignee // All modes // Yes
    • Transport Mode // All modes // Yes
    • Departure // All modes // Yes
    • Destination // All modes // Yes
    • Actual Departure Date // All modes // Yes
    • Actual Arrival Date // All modes // Yes
    • Actual Delivery Date // All modes // Yes
    • Commodity Item PO# // All modes // No
    • Commodity Item SKU# // All modes // No
    • Commodity Item Description // All modes // No
    • Commodity Item Quantity // All modes // No
    • Commodity Item Total Pallets // All modes // No
    • Commodity Item Total Loose Packages // All modes // No
    • Commodity Item Gross Kg // All modes // No
    • Chargeable Weight // All modes // No
    • Departure Region // All modes // No
    • Destination Region // All modes // No
    • Notification Date // All modes // No
    • Authorization Date // All modes // No
    • Estimated Departure Date // All modes // No
    • Estimated Arrival Date // All modes // No
    • Estimated Delivery Date // All modes // No
    • Estimated Collection Date // All modes // No
    • Actual Collection Date // All modes // No
    • Vessel name // OCEAN // No
    • Flight Number // AIR // No
    • HAWB# // AIR // No
    • Container Description // OCEAN // No
    • Shipping Line // OCEAN // No
    • Airline // AIR // No
    • Commodity Item Extra Field 1 // All modes // No
    • Commodity Item Extra Field 2 // All modes // No
    • Commodity Item Extra Field 3 // All modes // No
    • Steamshipline Booking # // OCEAN // No
    • Commodity Item Gross Lb // All modes // No
    • Pickup Trucker // TRUCK-DOMESTIC // No
    • Delivery Trucker // TRUCK-DOMESTIC // No
    • Pickup Trailer# // TRUCK-DOMESTIC // No
    • Delivery Trailer# // TRUCK-DOMESTIC // No
    • Origin City // TRUCK-DOMESTIC // No
    • Origin State // TRUCK-DOMESTIC // No
    • Origin Zip Code // TRUCK-DOMESTIC // No
    • Destination City // TRUCK-DOMESTIC // No
    • Destination State // TRUCK-DOMESTIC // No
    • Destination Zip Code // TRUCK-DOMESTIC // No


More information from fields above:

Air

ETD :ExpTab 11b. Airport of Departure:
ATD :ExpTab 11c. ATD - Actual Time of Dept:
ETA :ExpTab 14b. ETA - Est Time of Arrival:
ATA :ExpTab 14c. ATA - Actual Time of Arrival:
Estimate Collection Date: GenTab 9. Estimated Export Pick-Up Date:
Actual Collection Date: GenTab 10. Actual Export Pick-Up Date:
Requested Delivery Date: ImpTab b.Estimated Delivery Date:
Actual Delivery Date: ImpTab b.Actual Delivery Date:

Ocean

ETD :ExpTab 12b. ETD:
ATD :ExpTab 12c. ATD:
ETA :ExpTab 14b. ETA:
ATA :ExpTab 14c. ATA:
Estimate Collection Date: ContTab for FCL shipment, GenTab 9. Estimated Export Pick-Up Date: for LCL
Actual Collection Date: ContTab for FCL shipment, GenTab 10. Actual Export Pick-Up Date: for LCL
Requested Delivery Date: ContTab for FCL shipment, ImpTab 10. Estimated Delivery Date: for LCL
Actual Delivery Date: ContTab for FCL shipment, ImpTab 11. Actual Delivery Date: for LCL

Truck

ETD :GenTab 9. Estimated Export Pick-Up Date:
ATD :GenTab 10. Actual Export Pick-Up Date:
ETA :GenTab x. Estimated Delivery:
ATA :GenTab y. Actual Delivery:
Estimate Collection Date: GenTab 9. Estimated Export Pick-Up Date:
Actual Collection Date: GenTab 10. Actual Export Pick-Up Date:
Requested Delivery Date: GenTab x. Estimated Delivery:
Actual Delivery Date: GenTab y. Actual Delivery:

[edit] Report output

  • HTML and xls
  • Show record() count on the report to indicate that how many shipments per mode

[edit] Figures

[edit] Figure 1. Main report

File:MainReport.JPG


[edit] Figure 2. Transportation Filters

File:TransportModeFilter.JPG


[edit] Figure 3. Date Filters

File:DateFilter.JPG


[edit] Figure 4. Output

File:MainReportOutput.JPG

[edit] Figure 5. Transportation for Truck-Domestic

File:TransportModeTruckDom.JPG

[edit] Tweaks version 1.1.a

Note: tweaks below applies to both Main and In-transit report Tira 9:50 28 Oct 2009

tw1) Add summary shipment record() count on the report to indicate that how many shipments...

tw2) Create a HTML result page before excel report

tw3) Create download to excel button -> generate xls report

[edit] Tweak version 1.1.b

tw1) Main Report - List of Transport Mode (filter) MUST include "UNDEFINED" as well in order to see Undefined shipments -- Tira 11:00 AM Feb 2, 2010

[edit] m2040

Mantis: 2047

[edit] SA

  • Add Booking # filter

Booking #

  • Label: Booking # contains:
  • Widget: textbox , can be multiple selected
  • Location: After Customer Ref # contains:
  • Add Booking # on Output tab
  • Default: on the left side dropdown list

NOTE: this field is applied to Ocean shipments ONLY

[edit] m2444

  • 0002444: (Client Report: Main) Add No Archived Checkbox, same as internal application main report

As on http://mantis.jaguarfreight.com/wiki/Main_Report#Figure_3:_Main_Report_General_Filters

default to = Not Archived

  • spec updated? Yes

[edit] m2236

[edit] RFC

rfc1) Simon would like to have dynamic filters for Client App by setting filters in Admin Mode for Non-jaguar Users -- Tira 12:33PM 19 Aug 2009 (UTC)

[edit] SOW

[edit] SOW 1 Enable sales invoices as output for clients with filter the output only specific bill to party visibility

[edit] Core Requirements

  • Re-implement sales invoice as a Main Report output for clients BUT filter the output to show ONLY invoices issued to a bill to party that listed in the Client User's E0 Client Profile.
  • Include only “related bill to parties” invoices from a client interface
  • see Client Profile – Part H >>> maybe a simple “enable client visibility” check box in that section with list of users who hve access to this invoices and see this fields as output in report.

[edit] Solution

  • Client user can ONLY see what is linked to his E0
  • Client User Admin - Enable Financial section on user profile

File: EnableFinancialVisibility.png

  • Client Company Admin - Bill to parties linked

File: ClientAdmin-BillToPartyCompany.png

  • Main report (client) - sales invoices output
  • Select client users have visibility (it's a user specific access)
  • Client Company Admin > enable list of users to see Financial data
  • Mirroring enable list of users

File: UsersToSeeFinancial.png



[edit] SOW 2 Client Visibility for Invoices in Main report

[edit] Core Requirements

  • This is updated logic for filtering financial information in Client Application.
  • Where we are today:
  • user will see ALL Invoices for ALL "Bill To Party" Companies linked to ALL "E0. Client Company" from Client User Admin
  • Where we want to go:
  • user can see Invoices issued for only "Bill To Parties" selected in Client Company Admin for the CT's "E0. Client Company" to be visible (not implemented yet)

[edit] Solution

Logic Hierarchy for Client User:

  • The FIRST question: Does the CLIENT want ANYONE to see FINANCIALS?
  • E0 Client Profile > Check Box > Financial Visibility: yes / no (default is NO)
  • The SECOND questions (only if first question answer is YES): What client users does the CLIENT allow to have visibility to financials?
  • if first question answer is NO then NO USERS can have visibility.

[edit] Examples

  • User Profile Admin section. User A is Client User for "E0. Client Company" = {Elizabeth Arden; EA DOM}
  • Client Company Admin section. "E0. Client Company" linked to "Bill To Party":
  • for Elizabeth Arden = {Elizabeth Arden Roanoke; EA Geneva}
  • for EA DOM = {EA Domestic}
  • Scenario 1.
  • E0 Visibility set for Client User in Client Company Admin to:
  • Elizabeth Arden - Yes,
  • EA DOM - Yes.
  • Enabled visibility:
  • If EA DOM has a "EA Geneva" invoice, User A cannot see that invoice (only EA Domestic).
  • Scenario 2
  • E0 Visibility set for Client User in Client Company Admin to:
  • Elizabeth Arden - No,
  • EA DOM - Yes.
  • Enabled visibility:
  • Only CT's for E0 EADOM will "show" financial visibility to User A.
  • This user will NOT see any financial information for E0 Elizabeth Arden CT's.



Personal tools