Oracle® Retail Order Management System (CWSerenade)

Release Notes Release 5.0

March 2015

ii

Oracle® Retail Order Management System Release Notes, Release 5.0

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

 

Contact Information   

30500 Bruce Industrial Parkway Cleveland, OH 44139 USA Toll Free: 888.328.2826 Tel: 440.498.4414 Fax: 440.542.3043 

1800 West Park Drive Westboro, MA 01581  Tel:508.655.7500 Fax:508.647.9495 

7031 Columbia Gateway Drive Columbia, MD 21046‐2289 Tel: 443.285.6000 

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 4 of 44

Table of Contents

Table of Contents .................................................................................................................... 4 

Release Overview .................................................................................................................. 5 Prerequisites .......................................................................................................................... 5 Alerts ...................................................................................................................................... 5 Documentation ....................................................................................................................... 6 Features ................................................................................................................................. 7 

Ecommerce / Order Entry / Customer Service ................................................................... 8 Additional Refund Order History Messages ................................................................... 8 Additional Order History Messages for Orders Maintained in a Batch ........................... 8 Secured Feature to Bypass CTI Reason Code .............................................................. 9 Identifying Store Returns ................................................................................................ 9 Item Availability by Item Search ................................................................................... 10 Search by Open Status ................................................................................................ 11 Purchase History from Relate ....................................................................................... 12 Wish List Integration with Relate .................................................................................. 14 Streamlined Order Inquiry (DORI) ................................................................................ 16 Additional Charges & Label Printing in WRBI ............................................................... 18 CC Net Exchange Billing .............................................................................................. 21 Locate Message Upgrade ............................................................................................ 26 

Inventory .......................................................................................................................... 28 Display Item Transaction History (DITH) Screen Rewrite............................................. 28 Price Tags .................................................................................................................... 28 

Merchandising and Marketing .......................................................................................... 34 Promotion Date Search ................................................................................................ 34 

System Operations ........................................................................................................... 36 JBoss Replaced by TomEE .......................................................................................... 36 Changed Authentication for Initial Signon .................................................................... 37 Authenticated Web Services ........................................................................................ 37 IJCT Start\Stop Periodic Functions with Parameter ..................................................... 40 Credit Card Tokenization with CWIntegrate Site .......................................................... 40 PayPal Direct Connection ............................................................................................. 41 User Security Logging .................................................................................................. 41 

Issue Resolution .................................................................................................................. 43 Compatibility Matrix ............................................................................................................. 44 

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 5 of 44

Release Overview

These release notes briefly describe the enhancements and new features in CWSerenade v5.0 (5.0.150305-1350). For more information about this release, including a description of all resolved deficiencies and further explanation of the new features, refer to the CWSerenade v5.0 (5.0.150305-1350) PTF Listing.

NOTE: The rebranding for the latest version of this document is in development as part of post MICROS acquisition activities. References to former MICROS product names may exist throughout this document.

Prerequisites

Prior to installing this upgrade, you must be on CWSerenade v4.7 (4.7.140731-1236) or higher, which was released in August 2014.

Alerts

There are several changes to CWSerenade v5.0 that may affect your use of the application. • The DITH screen has been modified to have a new column order and now limits the initial

return of results to 500 records.

• Jboss has been replaced by TomEE. • Support for IE 10 and 11 is now available natively.

• With this release of CWSerenade we are assuming SSL will be enabled and that you have a

SSL certificate at the time you install 5.0. This means that you will NOT be able to access CWSerenade through port 8080. We do give you the option to disable SSL as part of the install. This means that port 8080 will allow access to CWSerenade and you do not have to supply an SSL certificate.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 6 of 44

• New security rules prohibit us from delivering and using generic users ADMIN, ORDERAPI, WMSUSER, EXTERNAL, and CHANADV. As part of the install you will be prompted to provide a ‘default user id’ that will be used in place of all existing generic logins.

We will automatically delete the users above from the database if the password expire date is still set to 12/31/1999 which is what we originally set it to. This protects us from deleting a user that was put in use as a real sign-on.

• HTML is no longer supported as part of announcements that render on the initial Home screen. Allowing HTML on the screen was identified as a cross site scripting security vulnerability. If you have any HTML defined in Work with Announcements (WANN) or in any descriptions of codes, items, etc., it will no longer render and should be removed.

Documentation

The following documentation has been created or updated for this release.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 7 of 44

Document Title Description

Installation Instructions Describes how to upgrade the application to v5.0 (5.0.150305-1350).

Release Notes Describes at a high level the new features available in CWSerenade v5.0 (5.0.150305-1350)

CWSerenade v5.0 (5.0.150305-1350) PTF Listing

Describes the new enhancements and resolved deficiencies in CWSerenade v5.0 (5.0.150305-1350), and is organized by functional areas for ease of distribution.

Screen XML Change Listing

Identifies all screen XMLs that have been modified as part of the upgrade.

Database Change Listing

Identifies database tables that have been changed as part of the upgrade.

Database New Table Listing

Identifies database tables that have been added as part of the upgrade.

Email Template Change Listing

Identifies all email templates that have been added or modified as part of the upgrade.

Online Help Updated version of the online help to be used as a reference for CWSerenade users.

CWSerenade v5.0 User Configuration

Guide to be referenced when creating and updating users.

CWSerenade v5.0 Configuration and Operations Guide

Updated version of the Configuration and Operations Guide to be referenced when configuring properties and performing other system management tasks.

CWSerenade v5.0 Data Security and Encryption Guide

Updated version of the Data Security and Encryption Guide to be referenced when setting up encryption or validating security procedures. This document is password protected.

CWSerenade v5.0 E-Commerce Manual

Updated version describes key integration points between CWSerenade and a web storefront.

CWSerenade v5.0 Reports Guide

Updated version describes various reports available in CWSerenade.

Documented Project Listing

Identifies the features that have been newly documented in the online help and other reference guides.

Features

This section includes brief summaries of some of the enhancements to CWSerenade 5.0 (5.0.150305-1350). Refer to the PTF Listing for a complete list of all enhancements.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 8 of 44

Ecommerce / Order Entry / Customer Service

Additional Refund Order History Messages Now when a user modifies a refund in any way through Work with Refunds, an order transaction history message will be written indicating the date, time, user, and description of what change was made.

Additional Order History Messages for Orders Maintained in a Batch Previously there was no way to know what user maintained an order that was in a batch. With this release we now write an order transaction history message to indicate it was maintained while still within the batch.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 9 of 44

Secured Feature to Bypass CTI Reason Code Currently if a user is flagged to be a CTI user and SCV G98 – Require CTI Reason is set to Y a reason code must always be entered when exiting inquiry or maintenance of an order. We have introduced a new Secured Feature B24 – Bypass CTI Reason Code which will suppress the Order Inquiry Reason Code pop up window for all those who have the new secured feature set to *ALLOW. The new secured feature is being delivered set to *EXCLUDE.

Identifying Store Returns Currently when a return is processed in the store and sent to CWSerenade we send an email to the customer and we also include it in our sales feed to Relate. In a lot of cases the POS will also include the transaction in feeds because that is where the transaction is actually occurring. They are also providing the customer with a paper or emailed receipt for the return. With this latest release of CWSerenade we are providing a new SCV M22 – Return Disposition Code to Exclude in Relate Sales Feed which supports storing a return disposition code to identify the store returns.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 10 of 44

If the Return Disposition code on a line matches this value and the Suppress Refund flag on the Order Payment Method is set to Y we will not include that line on a confirmation email or in the sales feed to Relate.

Item Availability by Item Search With this release we modified the Display Item Availability screen to now display both Item and SKU description on the same display. In order to display the SKU description the offer was removed from this screen. If the display item alias functionality (SCV D56) is being used we display the item number for the alias instead of the SKU description.

As part of this enhancement we also created a new SKU Availability screen that allows you to enter an item number and have all the SKUs for that item returned with their associated availability. If a non-sku’d item is entered on this new screen an error message will be returned.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 11 of 44

Search by Open Status As part of CWSerenade 5.0 we now provide the ability to search by Open status from the Order Inquiry and Scan By Order Date screens.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 12 of 44

Purchase History from Relate We now support purchase history integration with Relate to provide a mechanism to review Retail, Call Center, and eCommerce completed sales and return transactions. A customer’s purchasing history can be viewed from the:

• Work with Customer Suite (WCST)

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 13 of 44

o Customer Scan Screen o Customer Sold To Option Screen

• Streamlined Order Inquiry (DORI)

• Order Entry\Maintenance Suite (OEOM)

o Customer Scan Screen o CTI Customer Selection Screen o Display More Options Screen

Transactions are sorted based on Purchase Date (newest to oldest), then by Transaction ID, then by Item/SKU. Lifetime to date and year to date summaries are displayed on the bottom portion of the screen. There is a Transaction Search Limit configuration in Relate’s Conflate tool to limit the number of transactions to be returned. The default value is set to 50, which means the newest 50 transactions will be returned in the results.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 14 of 44

Wish List Integration with Relate With CWSerenade 5.0 we are integrated with Relate for Wish List. The Wish List functionality allows customers to add products to a wish list from any channel or purchase items that they have previously stored on a wish list. An option has been added to SCV L52 - Relate Integration Values to indicate whether or not the Wish List functionality should be utilized. SCV L37 - Relate Customer Integration must also be set to INTERACT.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 15 of 44

The Wish List can be accessed from the Customer Selection Screen, the More Options Screen in OE\OM, and the More Options Screen in WCST.

The wish list provides a view of the items the customer wants and the current inventory position for the product, the date the product was added to the wish list, and which channel the product was added in.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 16 of 44

The action button will allow a CSR to delete an item from the wish list, view the item information for the product, or add it to the order.

Wish list does not support storing a quantity of the desired product. If a customer wants 2 of an item they would need to add the product twice. If an item is ordered we remove it from the wish list when the order is accepted. If the order is not accepted the item will remain on the wish list.

Streamlined Order Inquiry (DORI) For this release we added the shipment date to the products section of the DORI screen. If you place your cursor over the Qty Shipped field for an order line on the order, the system now displays the most recent shipment date for the item on the order, in MM/DD/YYYY format. The text No Ship Date Found displays if the system could not find a shipment date for the item on the order.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 17 of 44

On the Order History window in DORI we added the Time, in HH:MM:SS format, that the order activity occurred.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 18 of 44

Additional Charges & Label Printing in WRBI In CWSerenade 5.0 we have added the ability to add additional charges within Work with Return by Item (WRBI). This new option only displays if you have authority to Secured Feature A24 - Additonal Charge Access. If there are existing additional charges on the order you will not see them in this window. We also added a new field called Charge Added which display the additional charges added to the order during the current session. This new field will only display if you added additional charges in WRBI.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 19 of 44

We also added an option to print an item label. Selecting this new option advances you to the Print labels window where you can specify an item/sku by UPC or item naumber and SKU code and indicate the number of item UPC labels to print. This option will only display if SCV K30 - Default Scan Method for Pick Pack Verification contains a value. The system sends the label to the printer specified for the PPI label type for your user profile or thru Work with User Label Printers (WULP). If neither of these are defined then we use the printer specified in SCV K47 - Printer for Pick/Pack Item Labels.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 20 of 44

The last change in WRBI was to add a new qty field to the edit Item Return Disposition Values window which allows you to chanage the return quantity by selecting the Change Qty option to make the field enterable.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 21 of 44

CC Net Exchange Billing

With the CWSerenade 5.0 release we provide the ability to hold a credit invoice for a return in order to net it against the debit invoice for the exchange item in order to reduce the number of transactions. New SCV M23 – Use CC Net Exchange Billing controls whether the system will hold a credit invoice and refund for a return in order to net it against the debit invoice for an exchange item. The default for this new SCV is N. New SCV M24 – Hold Days for CC Netting defines the number of days to hold a credit invoice and refund for a return in order to net it against the debit invoice for an exchange item. The delivered value for this new SCV is 0. New SCV M25 – Default Auth Code for CC Netting defines the authorizaiton code for the system to use when creating a manual authorization to allow for the netting of invoices during the credit card net exchange billing process. We have a new system delivered flexible payment option, EXC – Net Billing For Exchanges. You cannot change or delete this code or use this flexible payment option for deferred\installment billing.

If you have the M23 – Use CC Net Exchange Billing scv selected, you cannot define an alternate refund type or an alternate refund category for a Credit Card pay type. If an alternate refund type or an alternate refund category is defined for an existing pay type, the system will ignore the alternate refund values and instead perform credit card net exchange billing for eligible orders.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 22 of 44

RA Accept Processing, called from WRTA and OEOM, has been modified so when an exchange transaction is accepted, the system now checks SCV M23. If it is set to Yes and the credit card pay type on the order does not already have a flexible payment option the system:

• Updates the ODT Seq # field in the RA Exchange Item table with the order detail sequence number of the exchange item added to the order so that a link exists between the exchange item and the returned item.

• Creates a manual authorization for the return amount, using the authorization code defined in SCV M25.

• Places the refund on hold and updates the hold until date based on the number of days defined in SCV M24.

The Order Inquiry screen has been modified to display EXC under the Line # for the order detail line that contains a return item associated with an exchange item.

We added a new field Net Bill on the Display Invoice screen that displays an asterisk if the invoice is currently pending for credit card net exchange.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 23 of 44

We modified the Work With Refunds and the Work with Refunds by Order screens to have a new Net column that displays an asterisk for a refund that is pending credit card net exchange billing.

The Change and Display Refund screens have new text next to the Amount Field to indicate that the refund is associated with a credit card net exchange billing. The pay type field on the Change Refund screen is also display only if this is a refund associated with a credit card net exchange billing.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 24 of 44

The Refund Due List by Order report was modified to display an asterisk after the amount if the refund has been flagged for Credit Card Next Exchange Billing.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 25 of 44

The Refund Due List by Type report was modified to display an asterisk after the amount if the refund has been flagged for Credit Card Next Exchange Billing.

Billing was modified so when the exchange transaction is processed, we assign the EXC deferred flexible payment option to the credit invoice and update the IPM Deposit Release Date with the calculated release date using the current date + the days defined in SCV M24. When the exchange item is billed we assign the EXC deferred flexible payment option to the debit invoice and update the IPM Auth # with the authorization code defined in SCV M25. The IPM Auth Date and the IPM Deposit Release date contain the current date. We update the IPM Deposit Relase Date for the credit invoice flagged for credit card net billing exchange to the current date, releasing the credit invoice for netting. As part of billing we also process the refund, even if the Hold Until Date for the refund has not been reached. The system does not print or email the credit card credit acknowledgement for the refund until the next time you run process refunds. Deposits was modified to net the credit invoice against the debit invoice. If the net difference is a credit, the system sends the credit invoice for settlement and refunds the customer’s credit card the net amount. If the net difference is a debit, the system sends the debit invoice for settlement and charges the customer’s credit card for the net amount. If the net difference is zero, the system does not send any invoice amount for settlement. We modified the Display Invoice Payment Method screen to have 2 new fields. The first is the Adjusted Amt field which shows the adjusted invoice amount after performing credit card net exchange billing. The second is the Deposit to Date field which shows the amount that was deposited against the invoice.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 26 of 44

Omni Channel Ordering Enhancements Important note: Customers using Locate and CWSerenade must be on Locate v5.0 higher or a .NET version of Locate (v3.0 or v3.1) to upgrade to CWSerenade v5.0.

Locate Message Upgrade We have modified CWSerenade to support Locate v5.0 Response Messages.

• The v4.1 response message and above were changed to include actual locations instead of a generic value for when split order is turned on.

We have modified CWSerenade to leverage the new attributes within the Locate v5.0 SubmitOrder Request Message and the Fulfillments Response Messages including:

1. New order header attributes: a. order_additional_freight_charges b. order_additional_charges c. ship_complete: Y or N d. freight_tax e. order_message: Up to 4000 characters f. gift_message: Up to 4000 characters

2. New order detail attributes:

a. item_upc_cd: UPC code

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 27 of 44

b. item_ean_cd: EAN code c. order_line_extended_freight d. order_line_customization_charge e. order_line_gift_wrap: Y or N f. order_line_ship_alone: Y or N g. order_line_ship_weight h. order_line_message: Up to 4000 characters i. customizations (repeating group): Each customization element can include a

customization_code and a customization_message. We modified CWSerenade to support the Locate ProductAvailability Web Service Message. This web service enables you to request availability information for one or more items and more than one fulfillment type at a time.

All enhancements will be supported with Split Order turned on and off. We also modified the Merchandise Locator Results screen to show the quantity available for pickup and a message if the item is available for delivery from the store.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 28 of 44

Inventory

Display Item Transaction History (DITH) Screen Rewrite The Display Item Transaction History (DITH) screen has been rewritten in GWT. The new screen has a new column order and now limits the initial return of results to 500 records. We moved the transaction code column over next to the Date column for usability and the item and sku have been moved to be the first columns. The columns are now sortable columns. The item and sku search boxes are now exact match searches.

Price Tags CWSerenade now has an option to create price tickets via a Monarch printer during pick gen, RF PO Receiving, and RF Store Transfer. We created new SCV M28 – Order Type to Print Price Tags During Pick Generation which allows for the definition of the order type that must be assigned to an order to make it eligible for price tag creation during pick slip generation. The delivered value for this new scv is Blank.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 29 of 44

We have a new number assignment C12 - Price Tag Batch # that assigns the next sequence number to the PTG Batch # field in the Price Tag Batch table when a new price tag batch is created. We have a new screen Work with Price Tag Type (WPTY) that allows you to configure the types of price tags that you can assign to an item. For each price tag type you define whether you print the price on the tag and the printer to be used to print that price tag type.

Work with Items (MITM) has a new field, Tag Type, added to the Create and Change Item screens to allow for the assignment of a price tag type to an item. The system validates the price tag type against the Price Tag Type table.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 30 of 44

The RI Item Upload (RIIUPP) table has also had a new field, ITM Tag Type added to allow you to assign a price tag type to an item during the Retail Integration Item Upload Process (RIIU). The RF PO Select screen has a new field, Print Tag Options, which allows you to print price tags during RF PO Receipts. You have the option to print a price tag for all of the items on the specified PO or to print a price tag only for the items on the PO that are received.

The RF Transfer ID screen has a new field, Print Tag Options, which allows you to print price tags during RF Store Receipts. You have the option to print a price tag for all of the items on the specified transfer id or to print a price tag only for the items on the transfer id that are received.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 31 of 44

The system creates a price tag batch in the Price Tag Batch table in a printed status when the option is selected from either of the above RF screens. You can review and work with the batch in the Work with Price Tags (WPTG) menu option. Pick slip generation has been modified to create a record in the Price Tag Batch table when generating a pick for an order whose order type matches the order type code in the new SCV M28. The system includes a price tag detail for each item on the pick that is assigned a price tag type; the number of tags to print matches the quantity of the item picked. You can review and work with the batch in the Work with Price Tags (WPTG) menu option. Work with Price Tags (WPTG) is a new menu option that allows you to work with price tag batches that were created during pick slip generation, RF PO Receiving, or RF Store Transfer Receiving. It also provides tha ability to manually create batches. For each price tag detail you can select to delete, print, or update the number of tags to print and/or the type of tag to print. Manual batches can be created as an empty batch or based on the reserved items on an order. New Secured Feature J09 – Create/Change Price Tags controls whether a user has authority to create or change a price tag batch or price tag in the WPTG menu option. The default authority is delivered as *EXCLUDE.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 32 of 44

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 33 of 44

New settings have been added in the cwdirectcp.labelprinters.properties file: • MONARCH_PTR_TYPE: Enter the type of Monarch printer used to print price tags. The delivered Monarch printer type is MON_9855. When printing price tags, the printer sorts the tags by item number and tag type. • WMON01_PTR (where MON01_PTR is the Printer Name in the Price Tag Type table): The name of the server where the Monarch Print Driver is installed and the name of the Monarch printer used to print the price tag label. Enter the name of the server and the name of the Monarch printer in the following format: WMON01_PTR=\\\\server_name\\Monarch_printer_name • MON_CSV_FILE1 (where 1 is the Price Tag Type defined in the Price Tag Type table): The location on the CWSerenade application server where the MON01_label.csv file is located (where 01 is the Price Tag Type defined in the Price Tag table). The contents of this file determine the information that prints on the price tag label and how the information is presented on the label. The default location is the following, where C: is the root drive where CWSerenade is installed: C:\\CWSerenade\\LabelFormats\\MON01_label.csv Price tag types are delivered with CWSerenade; however you will need to set them up in the Work with Price Tag Types (WPTY) menu option. The delivered label formats for each price tag type and the Price Tag Data Mapping table contain the information required to print the data on

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 34 of 44

each price tag correctly. Details as to the price tag types can be found in the release notes and in the documentation. We also have a new Periodic Function PPT – Purge Printed Price Tags that purges record in the Price Tag Batch table whose status is P. When purging, the system also purges the associated records in the Price Tag Work table. The program name for the periodic function is PFPPT.

Merchandising and Marketing

Promotion Date Search We now have the ability to search by start and end date in WPRO – Work with Promotions.

Clicking on the By Start Date option will display the screen below. The start date field is a greater than or equal to search.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 35 of 44

Clicking on the By End Date option will display the screen below. The end date field is a greater than or equal to search.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 36 of 44

New SCV M27 – Search Promotions by Start Date controls whether the select promotion screen in OE displays the current search or a new search by start date window. To have the selection screen be a search by start date set this new scv to Y.

The above screen displays when you click on Reprice in Order Entry when SCV I63 – Allow Manual Entry of Promotions is set to Y.

System Operations

JBoss Replaced by TomEE As part of this release we are replacing JBoss with TomEE. The biggest changes that you will notice are in the folder structures. Below is a guide to commonly referenced items with their old location and their new location. Object In Jboss In TomEE Application Logs, forms, integrations, etc.

C:\CWSerenade C:\Serenade\CWSerenade

Properties C:\jboss51\server\serenade\conf C:\Serenade\server\conf CWDirect.log file

C:\jboss51\server\serenade\log C:\Serenade\server\log

Database Configuration

C:\jboss51\server\serenade\deploy\mssql-s.xml C:\Serenade\server\conf\tomee.xml

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 37 of 44

xml Screen XML files

C:\Jenasys2 C:\Serenade\screens

Item Images C:\jboss51\server\serenade\deploy\Root.war\Pics C:\Serenade\server\webapps\Root\Pics

Changed Authentication for Initial Signon The authentication for the initial login process has been updated. The Login process is no longer part of CWSerenade application instead it is handled as part of the Web Server. Whenever a request comes into the web server, it will need to get authenticated. This change ensures no one will be able to access any web artifacts without first being authenticated.

Authenticated Web Services This change enables CWSerenade to require web service authentication. We are authenticating using “Basic Authentication,” an industry standard that requires that a specific username and password be included along with the HTTP header when the web service request is sent in. Upon receiving a message we retrieve the user and password from the HTTP header and authenticate against data that is stored within CWSerenade. CWSerenade has new fast path WWSA – Work with Web Service Authentication that allows you to indicate if authentication is required and to setup the user id and password. We are delivering all entries as required No. You must manually turn on the authentication.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 38 of 44

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 39 of 44

The password must meet the following criteria:

• Over 6 characters long

• Contain both numbers and letters

• Contain a special character

• Cannot begin or end with a number You can setup multiple users for each web service to support different applications accessing the same web service. If an error occurs within the authentication you will receive an error response. The error message samples are below: SOAP Error Will return a SOAP fault: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelo... <soapenv:Body> <soapenv:Fault> <faultcode>soapenv:Server.generalException</faultcode>

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 40 of 44

<faultstring>Invalid access</faultstring> <detail> <ns1:hostname xmlns:ns1="http://xml.apache.org/axis/">..</ns1:hostname> </detail> </soapenv:Fault> </soapenv:Body> </soapenv:Envelope> REST Error Will just return a string:

Access not allowed

IJCT Start\Stop Periodic Functions with Parameter We now have 2 new periodic functions with parameters to allow for stopping and starting IJCT jobs that are delivered for customer modifications. STRIJCT function, with program ILSTRGENER, can be setup to start a job. ENDIJCT function, with program ILENDGENER, can be setup to end a job. The IJCT job name to start or stop is what should be placed in the parameter field. The periodic process that runs these functions cannot pass a company parameter.

Credit Card Tokenization with CWIntegrate Site

With the 5.0 release of CWSerenade we are supporting tokenization via a CWIntegrate site. We added new SCV L41 – Tokenization IJCT Job that defines the process id for the integration layer job used to transmit Register Token messages between CWSerenade and the authorization service during the credit card tokenization process. The delivered job is CC_TOKEN. We also created a new IJCT job, CC_TOKEN, used to route the Register Token messages to the correct MQ queues and to identify how long to wait for a Register Token Response from the authorization service. You can define only one set of queues for the CC_TOKEN job, which means you can only use a single authorization service to perform credit card tokenization when using a CWIntegrate site. We created a new version 2.0 of the CWAuthorizationRequest message that has a new value for the ActionCode tag called RegToken which indicates that this is a Register Token Request message. The system generates the Register Token Request during the credit card tokenization process if you are using a CWIntegrate site for tokenization. We also added a new tag, tokenized, to the message that defines whether the number in the ccAccountNumber tag is the actual credit card number or a token received from the

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 41 of 44

authorization service during the credit card tokenization process. Valid values are Y which means the value is a token and N which means the value is the actual credit card number. We created a new version 3.0 of the CWAuthorizationResponse message that contains a new tag, tokenized, defines whether the number in the ccAccountNumber tag is the actual credit card number or a token received from the authorization service during the credit card tokenization process. Valid values are Y which means the value is a token and N or blank which means the value is the actual credit card number. We modified authorization processing when using the CWAuthorizationRequest xml message, to look at the tokenized tag to determine whether the number in the ccAccountNumber tag is the actual credit card number or a token. We created a new version 3.0 of the CWDepositRequest message with a new tag, tokenized, to the message that defines whether the number in the ccAccountNumber tag is the actual credit card number or a token received from the authorization service during the credit card tokenization process. Valid values are Y which means the value is a token and N which means the value is the actual credit card number. The deposit process was also modified when using the CWDepositRequest xml message, to look at the tokenized tag to determine whether the number in the ccAccountNumber tag is the actual credit card number or a token.

PayPal Direct Connection

The PayPal Direct Connection integration was enhanced as part of this release. When sending the PayPal DoCapture Request to PayPal, the system now populates the CURRENCYCODE in the request with the ASC Currency Code in the Auth Service Currency table that corresponds to the Currency in the Order Header Extended Table. If the Currency on the Order Header Extended table is blank, the system uses the currency code defined in scv A55 – Local Currency Code to determine which ASC Currency Code in the Auth Service Currency table to use. If a cross reference is not defined in the Authorization Service Currency table for the selected currency code, the system leaves the CURRENCYCODE in the PayPal DoCapture Request blank; PayPal treats a blank CURRENCYCODE as USD currency.

User Security Logging

A new before and after table has been created to record any change in user and user class authority. We also created a new table to record when a password was changed. We do not store the new password, we simply record that a password was changed.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 42 of 44

Various programs that deal with updating security at the user and user group level were changed to write records to the new audit tables when a security setting or password was changed.

We created a new screen Print User Security Audit Reports (PUSA) menu option that allows you to generate security audit reports.

We have 2 new reports that can be printed or downloaded to excel. The first report is the User Authority Changes Report.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 43 of 44

The second report is the Password Changes report.

Issue Resolution Several reported deficiencies have been resolved in CWSerenade v5.0. A complete list of the corrected deficiencies can be found in the PTF listing.

CWSerenade

Release Notes v5.0 (5.0.150305-1350)

March 2015 44 of 44

Compatibility Matrix Product Recommended Version CWData/Analytics 11.0 and higher CWStore and Store Site 12.0 or higher and Site 5.0 CWIntegrate 3.0, 4.0 CWValueCard 2.5 CWCollaborate 3.6.x Locate 3.0, 3.1, 5.0, 5.1 (no support for Locate v4.1) 5.2 Relate 8.8, 8.9, 9.0, 9.5, 10.5, 11.0 Vertex O 4.0.x, 5.0x, 6.0 eOne 11.5 or higher OCP 3.4 or higher Xstore 4.7 or higher QAS WebPro Address Hygiene 5.6.2 Paymentech Online v6.0 and 96-byte v1.7.1 Batch Format – Site v2.0;

also available without CWIntegrate site Litle Litle XML Reference Guide 8.2 v2.1 – Site v1.0 Cybersource 1.5.7 Jasper 5.1 SQL Server 2012 Windows 2012 Internet Explorer 8.0 or higher Safari Current version Chrome Current version Java 1.7 HornetQ 2.0 JBoss No Longer Supported TomEE 1.7