Release notes for Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2.
Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2 is supported with new
documentation. The on-product .chm based documentation is still available from the
Start menu, but is supplemented with a web help suite.
Breaking Changes
- CommercePaymentMethod has been removed, and is replaced with Connect PaymentMethod
entity
- The GetPaymentMethodsRequest has been renamed CommerceGetPaymentMethodsRequest.
- The GetPaymentMethodsResult has been removed,and is replaced with Connect
GetPaymentMethodsResult.
- Commerce.orders.getPaymentMethods pipeline has been removed, and is replaced with
Connect commerce.payments.getPaymentMethods pipeline.
- CommerceOrderServiceProvider.GetPaymentMethods() is deprecated, and is replaced with
Connect PaymentServiceProvider.GetPaymentMethods().
- CommerceShippingMethod has been removed, and is replaced with Connect ShippingMethod
entity.
- GetShippingMethodsRequest has been renamed CommerceGetShippingMethodsRequest.
- GetShippingMethodsResult has been removed, and is replaced with Connect
GetShippingMethodsResult.
- GetShippingMethodsResult has been removed, and is replaced with Connect
GetShippingMethodsResult.
- GetShippingMethodsResult has been removed, and is replaced with Connect
GetShippingMethodsResult.
- Commerce Server depends on .NET 4.5.1. Code that references Commerce Server assemblies
must be changed to target .NET 4.5.1. You may still access web services or go through COM
interfaces to maintain compatibility where there are no direct refereces to Commerce
Server assemblies.
- Due to changes in the .NET Framework, as of .NET 3.5, GetEnumerator() does not exist as
a member of the DataTable or DataSet classes. GetEnumerator() has moved to
System.Data.DataSetExtensions.dll as an extension method. Any attempt to foreach over the
Rows of a DataTable or similar operation will fail unless a reference to
System.Data.DataSetExtensions.dll is added to your projects that use Commerce Server
DataTables or DataSets.
- Commerce Server requires the latest Visual C++ 2013 runtime, which is installed
automatically by the installer in a customer environment. Native code that accesses
Commerce Server native COM objects should not require any changes.
- ADODB Recordsets that are returned to client code from Commerce Server COM objects are
not automatically populated with default values. Any attempt to MoveFirst() or MoveNext()
will fail when the Recordset.EOF = true, because there are no rows. Visual Basic 6 allows
you to MoveFirst() on a Recordset that has no rows, and will return a Recordset that
allowed that operation for clients operating on the Recordset. Visual Basic 6 will also
construct an empty, default Recordset on the client side, even if the server returned
null. This is no longer allowed. The simplest fix is just to change your code to check if
the Recordset state is not closed, and ensure it is not empty before invoking operations
involving any rows.
- Change any references to CommerceServer.Core.Interop.Configuration .MSCSCFG .dll to use
CommerceServer.Core.Configuration.dll, and change all type references. For example:
GlobalConfigFreeThreaded is changed to IGlobalConfigGlobalConfigAdminFreeThreaded is
changed to IGlobalConfig2 SiteConfigFreeThreaded is changed to
ISiteConfigSiteConfigReadOnly is changed to ISiteConfigReadOnly.
- You do not need to go through the legacy
CommerceServer.Core.Internal.Profiles.BusinessDataAdminInterop wrapper
(CommerceServer.Core.Profiles.DataManagement.dll), but it is still available to support
legacy dependencies. Customers using the BusinessDataAdminInterop class should not have to
make any changes. Customers using the new CommerceServer.Core.Profiles.dll instead of the
legacy VB6 COM object, will have to change ref params to pass the parameters by
value.
For customers upgrading from Commerce Server 2009R2 or earlier, be aware that
Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2 has introduced
extensive breaking changes, including, but not limited to:
- Namespaces
- Registry entries
- GUI Cascades and command syntax
- File names and directories
A detailed accounting of breaking changes in Excel format is available at
http://sdn.sitecore.net/downloads/SitecoreCommerceCommerceServerBreaking.download. The purpose of this spreadsheet is to provide you with
guidance on migrating your existing solutions from Commerce Server 2009R2 or earlier to
Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2. It contains mappings
illustrating the old and new names for assemblies, namespaces and other artifacts. This
spreadsheet contains a number of sheets that allow you to filter and pivot on the various
namespaces and or / assemblies to help plan your migration.
Highlights for Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2
- Updated to work with the new Sitecore XP 8.0 functionality.
- A user must be in the role "sitecore\Commerce Staging" to have permission to run a
Commerce Server Staging project from the Sitecore Publishing dialog .
- Profile Cards can be directly applied to items that represent categories and
products.
- All languages used on Commerce Server catalogs are now fully registered in
Sitecore.
Known Issues
The following are known issues for the
Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2
Deployment Scripts Do Not Work with SQL 2014
The deployment scripts for installation of Commerce Server 11.2 do not work with SQL 2014.
A solution for this issue is being prepared.
Some Dialogs Do Not Work in Experience Editor When Using the MVC Site
When using the MVC site, some dialogs do not work in the Experience Editor. This is caused
by a collision between prototype.js and JQuery. To resolve the issue, do the following:
- In \Views\Shared\_Layout.cshtml move the @Scripts.Render("~/js/jquery") reference at
the bottom of the file to just above the closing </head> tag.
- In \Scripts\main.js replace all instances to $ with jQuery
- In \Views\Catalog\_Home.cshtml replace all instances to $ with jQuery
Exceptions May Occur During Publish to Web
When publishing to the Web, you may receive an exception that is not shown in the script
output, but only in the logs. For
example:
4628 2014:09:17 10:34:58 ERROR Cannot find dictionary domain for the dictionary entry '/sitecore/system/Settings/Workflow/Check
in'('{49D654D8-19C1-4DFC-BE0F-7A7D2314340F}').
4628 2014:09:17 10:34:58 ERROR Cannot find dictionary domain for the dictionary entry '/sitecore/system/Settings/Workflow/Check
in'('{49D654D8-19C1-4DFC-BE0F-7A7D2314340F}').
To
resolve the issue, retry the publishing action.
IE10 Crashes While Scrolling Large Numbers of Products
In Merchandising Manager, when you select more than 100 items in the Item Picker, Internet
Explorer 10 may crash. The suggested workaround is to upgrade to Internet Explorer 11.
Merchandising Manager Product Sort Page Does Not Sort in IE10
In Merchandising Manager, when using Internet Explorer 10, the sorting of products on the
Product tab does not always sort the full list. The suggested workaround is to upgrade to
Internet Explorer 11.
Merchandising Manager Static Catalog Group Changes and Disables Save Button
In Merchandising Manager, when changing the list of catalogs that are associated to a
Static Catalog Group, the Save button will not become enabled. To
enable the Save button, change the name of the Catalog Group, and
then press the Tab key. Change your selected catalogs, revert the
name of the Catalog Group to its original value, and then save.
Merchandising Manager Sequencing Dialogs are Missing Buttons in Firefox
When attempting to sequence items in Merchandising Manager using the Firefox browser, the
buttons to move items up and down in the list are not being displayed. The suggested
workaround is to use an alternate supported browser when using Merchandising Manager.
Merchandising Manager Category Creation Silently Fails When There is a Preexisting
Category with the Same Name.
In Merchandising Manager, if you attempt to create a Category with the same name as an
existing Category, it will fail with no error message, making it appear as if the new
Category was created.
Faceting by non-string data types when using Lucene returns invalid
facet names
If you attempt to receive facets for a field that is not a string data type, for example List
Price, the names for the facets returned are encoded rather than displaying their numeric
value.
Searching Within Merchandising Manager will Fail if Empty Catalogs Exist
Merchandising Manager searches across all catalogs in your system. If an empty catalog exists,
the search may fail. The workarounds for this issue are as follows:
- Delete all empty catalogs.
- Add at least one item to all empty catalogs.
Do Not Change Back Ordered Quantity or Preordered Quantity Fields in Product and Variant
Inventory Details
The fields for Back Ordered Quantity and Preordered Quantity are computed fields, and should
not be edited by the Business User.
Backup Staging Data to Retain the Staging Environment
A known issue exists where staging data is lost during migration to Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2. If you wish to keep
your staging environment you must perform a backup before starting any part of the
migration. For complete instructions on performing a backup and restoring your staging
environment, please see http://support.commerceserver.net/KnowledgebaseArticle51140.aspx
Error 1316 During a Commerce Server Repair
You may receive
Error 1316.A network error occurred while attempting to read
from the file Path\SSCERuntime-ENU.msi as an error message when you repair
Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2. This issue is
related to the following Microsoft KB article,
http://support.microsoft.com/kb/970876. To resolve this issue, follow these steps:
- Using Add or Remove Programs in Control Panel, Remove Microsoft SQL Server Compact 3.5
SP2 x64 ENU
- Using Add or Remove Programs in Control Panel, Remove Microsoft SQL Server Compact 3.5
SP2 ENU
- Rerun repair on Sitecore Commerce 8.0 powered by Commerce Server and Commerce Server
11.2. After the repair operation, the correct versions of SQL Server Compact 3.5 will be
installed.
Database.SelectItems does not return results for some products
When you query for products that include a "-" in the ProductID Database.SelectItems
does not return results for those products. The product ID needs to be enclosed in #
characters. The correct query format is : /sitecore/Commerce/Catalog
Management/Catalogs/Adventure Works
Catalog/Departments/Boots/#AW074-04#/*[@CommerceItemType=\"variant\"]
Keyboard Access for UI Controls
Some controls are not accessible using the keyboard. For example, the action bar that contains
controls to filter, create, delete, etc.