Supply Chain Intelligence

Supply Chain
Intelligence

Drill Through
Configuration Guide
2013

Drill Through Configuration Guide 2013

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Copyright and Disclaimer

Copyright © 2000 - 2013 Manhattan Associates, Inc. All rights reserved.

This documentation, as well as the software described in it, is furnished under license and may be used or copied
only in accordance with the terms of such license. The information in this documentation is furnished for informational
use only, is subject to change without notice, and should not be construed as a commitment by Manhattan
Associates, Inc. (“Manhattan”). No third party patent liability is assumed with respect to the use of the information
contained herein. While every precaution has been taken in the preparation of this documentation, Manhattan
assumes no responsibility for errors or omissions.

EXCEPT WHERE EXPRESSLY PROVIDED OTHERWISE, ALL CONTENT, MATERIALS AND INFORMATION,
ARE PROVIDED ON AN "AS IS" AND "AS AVAILABLE" BASIS. MANHATTAN EXPRESSLY DISCLAIMS ALL
WARRANTIES OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-
INFRINGEMENT.

Except as permitted by license, no part of this documentation may be reproduced, stored in a retrieval system, or
transmitted, in any form by any means, electronic, mechanical, recording, or otherwise, without the prior written
permission of Manhattan Associates.

Manhattan Associates is a registered trademark of Manhattan Associates, Inc.

All other brands, products, or services are trademarks, registered trademarks, or service marks of their respective
companies or organizations.

Contact Address:

Manhattan Associates, Inc.

2300 Windy Ridge Parkway,
Atlanta, Georgia 30339

http://www.manh.com/

Region Telephone Email

+1 877.756.7435 (U.S. and Canada only)

Americas callcenter@manh.com
+1 404.965.4025

Drill Through Configuration Guide 2013

(00) 800.988.0885 (China only)
Asia asiacustomersupport@manh.com
+86 21 3311 3499

Europe, Middle +44 (0) 1344 318400 (UK)

emeacustomersupport@manh.com
East, and Africa +31 (0)30 214 3400 (NL)

Australia +61 1300787050 aucustomersupport2@manh.com

Unsure whom to contact? Call +1 404.965.4025 and you will be routed to the appropriate support group.

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Table of Contents
Overview .................................................................................................................................... 4
Drill Through to SCPP UI from SCI Report ........................................................................................... 4
Base Drill Through links ........................................................................................................................ 4
Browser Settings ................................................................................................................................... 7
Configuring a Drill Through ................................................................................................................... 7
Steps .........................................................................................................................................................7
Creating report Expressions for drill through URL .............................................................................. 11
How To Run SCI Drill Through Reports ? ........................................................................................... 11

Drill Through Configuration Guide 2013

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Overview
The purpose of this document is to describe how to configure the base Drill Through functionality. It
guides you through the following:
• Describes the value of the Drill Through functionality.
• Identifies the base drill through links.
• Identifies limitations of the drill through links.
• Describes how to create custom drill through links.

Drill Through to SCPP UI from SCI Report

From the SCPP webtop, users can navigate to the Cognos public folders, and can run any report. In the
latest SCI release, authors can code reports so that users can navigate from an SCI report directly to the
data in the application (CBO).

Note: CBO is the internal Manhattan layer that serves as a framework for common business objects,
such as ORDERS and ASN. CBO facilitates the shared platform across Manhattan SCOPE products.

Base Drill Through links

SCI provides links to the following data in the CBO and WM applications/pages:
• ORDERS (CBO)
• ORDER_LINE_ITEM (CBO)
• ASN (CBO)
• ASN-DETAIL (CBO)
• TASK_HEADER (WM)
• TASK-DTL (WM)

Drill Through Configuration Guide 2013

Hyperlinks can be created in the reports to navigate to CBO or WM application/page through single sign
on.

Each Hyper link in the Drill through report will have a URL that points to a specific page in the
Applications, like CBO/WM. The URL will also contain request parameters to be passed to the page to
open a specific record. The values for these request parameters have to be passed from cognos reports.

To tie the report hyperlink to the application data, you will need to identify the following information:

• Functional area where to navigate

• Application (CBO/WM) hostname and port.
• URL to hit the specific pages
• Request parameters to be passed with the URL

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Following is the details of all the URLs and request parameters for all the areas.

Note: The Database column/Table Name given here is just a context for the report author to
understand what gets passed in the URL, but you may be passing value from any other table or column
(Which is referring to the ones specified below).

ORDERS:

Application CBO

Navigation Key /cbo/transactional/distributionorder/view/DODetailsMainHeader.xhtml

Request parameter DistributionOrderId

names
ORDER_ID From ORDERS table.
Data Base Column Data Type – Numeric.

ORDER_LINE_ITEM:

Application CBO

Navigation Key /cbo/transactional/distributionorder/view/DOLineDetails.xhtml

Request parameter DistributionOrderId , orderLineItemId

names
DistributionOrderId --- >> TC_ORDER_ID from ORDERS Table. (Varchar)
Data Base Column. orderLineItemId --- >> LINE_ITEM_ID from ORDER_LINE_ITEM table (Numeric)

ASN:

Drill Through Configuration Guide 2013

Application CBO

Navigation Key /cbo/transactional/asn/ASNList.xhtml

Request parameter qf_ASN.TC_ASN_ID – Pass TC_ASN_ID as the parameter.

names
TC_ASN_ID from ASN table.
Data Base Column. Data type (Varchar)

ASN_DETAIL:

Application CBO

Navigation Key /cbo/transactional/asn/ASNDetails.xhtml

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Request parameter asnId

names
ASN_ID from ASN table.
Data Base Column Data type (Numeric)

TASK_HEADER:

Application WM

Navigation Key / wm/taskmgmt/ui/TaskHdrList.jsflps

Request parameter qf_TASK_HDR.TASK_ID

names
TASK_ID From TASK_HDR table. (Numeric)
Data Base Column.

TASK_DTL:
The URL and request parameters for TASK_DTL are same as that of TASK_HEADER. There is no direct
URL to navigate to TASK_DTL page in WM, navigation to this page is only through the header item.

Note: Users can also edit any data after navigating to these pages.

Drill Through Configuration Guide 2013

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Browser Settings
Browser settings mentioned below has to be done before running Drill through report.

Microsoft Internet Explorer 9 :

In Internet Options >> Under Tabbed Browsing Settings ,

Check the Always open Pop-ups in a new tab option , then restart Internet Explorer.

Mozilla FireFox :

Settings :

1. Type about.config in the Mozilla browser.

2. Look for parameter browser.link.open_newwindow.restriction. (Its default value is 2)
3. Change it to 0.
4. Restart Mozilla.

Configuring a Drill Through

• These instructions are based on an example scenario, to illustrate how to configure the feature.
The below example steps can be followed similarly for other pages as well.
• The example below depicts how to navigate to the ORDER_LINE_ITEM (CBO) page for a
specific Order Line_Item_ID in CBO.

Steps

Drill Through Configuration Guide 2013

1. Pull all the query items required in the list report into report page.[We assume that report author
has prerequisite knowledge on the reporting framework package required to create these reports]

2. Identify the navigation URL in CBO which can navigate to an ORDER_LINE_ITEM page [Refer
details of the navigation keys for all the functional areas in the section above]. In this case
navigation key will be “/cbo/transactional/distributionorder/view/DOLineDetails.xhtml”.

3. Identify the request parameters to be passed to open the ORDER_LINE_ITEM page for a specific
Order Line Item ID [Refer details of the request parameters for all the functional areas in the
section above]. In this case , request parameters will be DistributionOrderId , orderLineItemId.

4. Identify what are the data items in the framework package which correspond to the request
parameters identified in step 3 [Refer details of DB Column names for all the functional areas in
the section above]. In this case , following is the mapping.

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

S.No Request Parameter Name DB Column Name Data Item in Framework

1 DistributionOrderId TC_ORDER_ID from [Order ID] from framework.

ORDERS Table.

2 orderLineItemId LINE_ITEM_ID from [DB Order Line Item ID] from

ORDER_LINE_ITEM table framework.

5. Drag them to report page , the data items from the framework which map to the request
parameters to be passed. In this case they are [Order ID] and [DB Order Line Item ID] .Hide
them if they are not required to be rendered in the report output.

6. Create Following Query calculations (Calculated Query items) for [Order ID] and [DB Order
Line Item ID].

 Create a Query calculation name it calc_Order_line_item_id , and paste

trim(trailing, cast( [DB Order Line Item ID] , char(14) ))
in the expression. Follow the same approach for your other reports if you are passing
numeric parameter in drill through .
 Create a Query calculation, name it calc_Order_id , and paste
trim(trailing, [Order ID])
in the expression. Follow the same approach for your other reports if you are passing
varchar parameter in drill through .

Drag these calculations to reports page , and hide them if they are not required to be
rendered in the report output.

7. Drag a “Hyper Link” as a column in the report, and name it appropriately. This is the hyperlink
which will have drill through URLS.
a. Identify the Hostname and port for CBO Application.

b. Select the hyperlink column and in the properties , look for Text source section , and change
the Source Type as Data Item Value. And in the Data Item value , set it to point to
calc_Order_line_item_id.

Drill Through Configuration Guide 2013

c. In properties , Under URL Source , set the Source Type as report expression

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

d. In the Report Expression definition , copy the following expression .

'http://ma-india-u209.asia.manh.com:30000/manh/index.html?w=' +
URLEncode
(

'key='
+
URLEncode(
'/cbo/transactional/distributionorder/view/DOLineDetails.xhtml?DistributionOrderId=' +
[Report_Items].[clac_order_id] + '&orderLineItemId=' +
[Report_Items].[calc_Order_line_item_id] )
+
'&type=url'

Refer section creating Report Expressions for drill through given below.
e. Validate the report expression , and validate the report and save it.

Note: Only the highlighted portion will change for each of your specific report.

8. When you run the report , the Hyperlinks in the Report will show up as below.

Drill Through Configuration Guide 2013

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

9. Clicking on the Hyperlink , will open an Order_line_item_page specific to the [Order ID] and[DB
Order Line Item ID] that is passed in the URL.

You can create reports for all the functional areas given above by following similar steps.

Note: Logged in users might not have permissions to view pages for all the request values. Report
Authors should consider applying appropriate filters in the report , so that users gets to see only the
records or pages they have permission to access.

Drill Through Configuration Guide 2013

10

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.

Supply Chain Intelligence

Creating report Expressions for drill through URL

Following is the Format of the report expression that serves as URL source of the Hyperlinks.

'http://<HOST_NAME(cbo/wm)>:<APPLICATION_PORT>/manh/index.html?w=' +
URLEncode
(

'key='
+
URLEncode( '<NAVIGATION_KEY>?<REQUEST_PARAM1> =' + <DATA_ITEM_VALUE>+ '&<
REQUEST_PARAM2> =' + <DATA_ITEM_VALUE>)
+
'&type=url'

Only the highlighted portion will change for your specific report.

<HOST_NAME(cbo/wm)> - This corresponds to the hostname where CBO or WM application is installed.

<APPLICATION_PORT> - This corresponds to the application port , where CBO/WM application is

running.

<NAVIGATION_KEY> - Corresponds to the application page specific URL.

<REQUEST_PARAM> - This corresponds to the request parameter name that needs to be passed in the
hyperlink’s URL. There can be any number of request parameters depending on page that you are trying
to open. You should edit the report expression depending on your needs.

<DATA_ITEM_VALUE> - This is the framework Data item that has been mapped to the request
parameter in the URL.

How To Run SCI Drill Through Reports ?

1. Login to Dashboard application.

Drill Through Configuration Guide 2013

2. Navigate to SCI Public Folders, using SCI HOME menu link on Dashboard Application.
3. Navigate to the Drill Through report location.
4. Run the report and click on hyperlinks, which will open Specific product pages.

11

Copyright © 2013 Manhattan Associates, Inc. All rights reserved.