Version 24.3.0

New features

ID Description

CCSF-875

Updated the dependencies of WebDAV deployment module.

CCSF-653

Minor implementation updates.

CCSF-652

Replaced internal cache implementation.

CCSF-651

Reworking of individual code segments.

CCSF-650

Replaced internal JSON implementation.

Version 24.2.0

Highlights

CCSF-816 - Added possibility to configure certificates for WebDAV deployment
The WebDAV deployment task now offers the possibility to configure a keystore for certificates via the following three optional parameters: javax_net_ssl_keyStore, javax_net_ssl_keyStorePassword, javax_net_ssl_keyStoreType. Further information can be found at Chapter 4.8.4. WebDAV deployment.

New features

ID Description

CCSF-859

Updated the dependencies of ContentConnect and JSTL module.

CCSF-816

Added possibility to configure certificates for WebDAV deployment.

Version 23.8.0

New features

ID Description

CCSF-863

Updated used libraries

Version 22.11.1

Update Notice

CCSF-840 - Configuration field for divergent store hostname added to project component
If the hostname of the store differs from the hostname for the Open Commerce API, this led to problems when determining the render template of products or categories. With the newly added configuration field, such a deviating hostname of the store can be additionally specified. This field is optional and only needs to be filled in if the hostname of the store differs from the hostname of the Open Commerce API. For more information on configuring the field, see the documentation in Chapter 4.4. Configuring the project component.

CCSF-839 - Fixed incorrect regex in preview_generation template of the reference project
In order to correct the problem in an already existing project, open the format template preview_generation and search for s=****/ and remove this character sequence.

Fixed issues

ID Description

CCSF-840

Configuration field for divergent store hostname added to project component

CCSF-839

Fixed incorrect regex in preview_generation template of the reference project

Version 22.11.0

New features

ID Description

CCSF-821

Updated OCAPI version in use to 22.10

CCSF-820

Fix of broken links within the documentation

CCSF-819

Updated cartridges for SFRA 6.2.0 compatibility

Version 22.8.0

New features

ID Description

CCSF-810

Updated company name to Crownpeak Technology GmbH

Version 22.7.0

Fixed issues

ID Description

CCSF-825

Improved error handling in the ProxyServlet

Version 22.2.0

Fixed issues

ID Description

CCSF-806

Fixed the deletion of slot configurations for categories containing whitespaces

Version 21.12.0

New features

ID Description

CCSF-793

Updated OCAPI version in use to 21.10

Version 21.9.1

Update Notice

CCSF-788 - Extended category object

All of the properties of a Category provided by the Commerce Cloud can now be accessed within the project.

Property Type Method

catalog_id

String

getCatallogId()

categories

[Category]

getCategories()

creation_date

Date

getCreationDate()

description

Localized<String>

getDescription(Language language)

id

String

getId()

image

String

getImage()

last_modified

Date

getLastModified()

link

String

getLink()

name

Localized<String>

getName(Language language)

online

Boolean

isOnline()

page_description

Localized<String>

getPageDescription(Language language)

page_keywords

Localized<String>

getPageKeywords(Language language)

page_title

Localized<String>

getPageTitle(Language language)

parent_category_id

String

getParentCategoryId()

position

Double

getPosition()

thumbnail

String

getThumbnail()

New features

ID Description

CCSF-788

Extended category object

Version 21.9.0

Highlights

CCSF-794 - Recertification
FirstSpirit Connect for Salesforce Commerce Cloud in Version 21.1.0 is recertified in the Salesforce Commerce Cloud Marketplace.

The version number 21.1.0 refers to the part of the integration available via the Marketplace. The versioning within the Marketplace differs from the versioning of the releases. In terms of content, the part of the integration available via the Marketplace corresponds to version 21.9.0.

New features

ID Description

CCSF-794

Recertification in the Salesforce Commerce Cloud Market

CCSF-791

Updated cartridges for SFRA 6.0.0 compatibility

CCSF-790

Fix of broken links within the documentation

Version 21.4.0

New features

ID Description

CCSF-765

Category filter for the category report added

Version 21.3.0

Highlights

CCSF-758 - Added use of sorting rules for category links

Sorting rules provided by the Commerce Cloud can now be used for links to category pages.

To integrate the sorting rules within a link template, the template must be extended by the following input component:

<CMS_INPUT_COMBOBOX name="lt_sortingRule" hFill="yes" noBreak="no" singleLine="no" useLanguages="no">
    <CMS_INCLUDE_OPTIONS type="public">
        <NAME>DemandwareConnect_SortingRulesValueProvider</NAME>
    </CMS_INCLUDE_OPTIONS>
    <LANGINFOS>
        <LANGINFO lang="*" label="Sorting Rule" description="Select a sorting rule for products on the referenced page."/>
    </LANGINFOS>
</CMS_INPUT_COMBOBOX>

Then, the reference to a category can be extended to include the sorting rule:

$CMS_IF(!#global.preview)$
    $CMS_SET(set_lt_link)$$httpUrl('Search-Show','cgid','$CMS_VALUE(lt_id)$')$$CMS_IF(!lt_sortingRule.isEmpty)$&srule=$CMS_VALUE(lt_sortingRule.value.getId())$$CMS_END_IF$$CMS_END_SET$
$CMS_ELSE$
    $CMS_SET(set_lt_link)$$CMS_REF(pageref: "preview_dispatcher")$/forceRefresh=1?type=category&id=$CMS_VALUE(lt_id.urlEncode)$$CMS_END_SET$
$CMS_END_IF$

Due to the special handling of links within the ContentCreator, sorting rules only have an effect when viewing a store page outside the ContentCreator.

Fixed issues

ID Description

CCSF-777

Fixed an error when establishing a connection within the ProxyServlet

New features

ID Description

CCSF-774

Cache invalidation improved

CCSF-758

Added use of sorting rules for category links

Version 21.2.1

Fixed issues

ID Description

CCSF-773

Fixed handling of languages with hyphens

Version 21.2.0

Fixed issues

ID Description

CCSF-761

Moved scope of the library net.java.dev.designgridlayout:designgridlayout to avoid a conflict with WebForms

Version 20.9.1

Fixed issues

ID Description

CCSF-752

Loading of category information optimized

CCSF-751

Improved performance in the SiteArchitect

Version 20.7.2

Highlights

In this Version the required libraries JAF and JAXB are delivered directly with the ContentConnect module. This removes the dependency to the modules jaxb-fs-library-2.3.0.fsm and jaf-fs-library-1.2.0.fsm. These need to be uninstalled. It also removes support for Java 8.

New features

ID Description

CCSF-721

Replaced dependencies to jaf and jaxb modules with dependencies to the libraries

Version 20.7.1

Update Notice

CCSF-729 - Removed deprecated ContentSync pipeline and refactored importExamples.zip to a site export file
This release removes the deprecated ContentSync pipeline from the cartridge int_espirit_core. After updating this cartridge, existing import jobs need to be adjusted. The necessary steps are described in the 2.50.0 release notes.

Also, the file importExamples.zip in the metadata folder does not contain separate import files anymore, but is now a site export file. On import, the sites RefArch and RefArchGlobal will be adjusted and for both sites a ready to use import job will be created.

Fixed issues

ID Description

CCSF-726

Added hint about use of the preview in SiteArchitect to the documentation

New features

ID Description

CCSF-729

Removed deprecated ContentSync pipeline and refactored importExamples.zip to a site export file

CCSF-728

Support categories and products with special character ids

Version 20.4.1

Highlights

CCSF-719 - Added reindexing to job schedule
With version 2.50.0, in the delivered sample job schedule firstSpiritImportSchedule.xml the use of the Content-Sync pipeline was replaced by job steps provided by the Commerce Cloud. However, due to the removal of the Content-Sync pipeline, this job schedule does not rebuild the search index after successful import of the assets and slot configurations. This error has been fixed with this release by adding another job step of type SearchReindex to the sample job schedule.

Fixed issues

ID Description

CCSF-719

Added reindexing to job schedule

Version 20.4.0

Highlights

CCSF-715 - Added configurable handling of invalid certificates
In some cases, forwarding the sandbox url to an external url may result in a certificate error because the external url does not match the certificate url. The preview of the page cannot then be displayed correctly. In order to be able to display a preview of the page in these cases, the handling of certificates can now be configured via the two parameters storefront.downloader.certificatesCheck and storefront.downloader.sslWhitelist.

Information on how to configure the corresponding parameters can be found in chapter 4.6 of the documentation.

New features

ID Description

CCSF-715

Added configurable handling of invalid certificates

Version 20.3.0

Highlights

CCSF-716 - Introduced new versioning schema
With this version we introduce a new versioning scheme of our integration. The major version corresponds to the last two digits of the current year (2020 ⇒ 20). The minor version corresponds to the current month. The patch version is still used for bug fixes.

CCSF-696 - Update of documentation, renaming of cartridges and minor bug fixes
In this version, the following corrections were made to the reference project:

In line 8 of the section template Shop the look, the redundant CSS class hotspot-container has been removed to fix a problem with the layout of the section.

Old
<div id="hotspot" class="hotspot-container">
New
<div id="hotspot">

In the page template XML in the folder Technical And Configuration Templates, the value passed to the method call getXML was changed from true to false in lines 40 and 44. This means that the generated XML is no longer automatically indented, which fixes an error when creating new pages.

Old
$-- CONTENT ASSETS --$
$CMS_VALUE(ps_xmlCollector.getXml(true))$
$CMS_CASE("content_slot")$

$-- CONTENT SLOT CONFIGURATIONS --$
$CMS_VALUE(ps_xmlCollectorContentSlot.getXml(true))$
New
$-- CONTENT ASSETS --$
$CMS_VALUE(ps_xmlCollector.getXml(false))$
$CMS_CASE("content_slot")$

$-- CONTENT SLOT CONFIGURATIONS --$
$CMS_VALUE(ps_xmlCollectorContentSlot.getXml(false))$

Update Notice

CCSF-696 - Update of documentation, renaming of cartridges and minor bug fixes
The renaming of the cartridges does not require an update of existing cartridges. If, however, an update of existing cartridges should be made and thus the renaming of the cartridges should be adopted, the new names of the cartridges should be made known to the sites as described in the documentation in chapter 3.1. Setting up the cartridges.

Fixed issues

ID Description

CCSF-718

Fixed an error in the deletion of content assets in the cleanup task

New features

ID Description

CCSF-716

Introduced new versioning schema

CCSF-696

Update of documentation, renaming of cartridges and minor bug fixes

Version 2.51.0

Highlights

CCSF-706 - Crop icon replaced
With this version the visualization of the crop icon of the shoppable image has been improved. For this purpose, the icon was replaced within the reference project and the corresponding CSS was modified.

CCSF-482 - New format templates for headlines
With this version, the reference project provides two new format templates. These allow the use of first and second level headlines in DOM input components.

Update Notice

CCSF-706 - Crop icon replaced
For the replacement of the crop icon in an existing project, various changes to the project are necessary. First, the new crop icon must be copied from the reference project. It is located in the Technical Media Assets folder of the media store and is named Crop. Then you have to make changes to the CSS of the section template Shop the look and the format template Preview Metadata Additions.

In the output channel of the section template Shop the look, the value for right in line 57 must be increased from 2px to 5px:

)$style="position:absolute;bottom:15px;right:5px;"></div>

In the output channel of the format template Preview Metadata Additions under Format Templates  ContentConnect  Preview the CSS must be changed as follows:

<style type="text/css">
/** hide quickview and show more buttons **/
.image container a.quickview, .show-more
    display: none;
}
.fs-button-firstspirit.fs-button-firstspirit-hover {
        border: 1px solid transparent !important;
        background: unset !important;
}
</style>

In addition, a label for the input component st_cropButton must be specified in the form definition of the section template Shop the look:

<FS_BUTTON
    name="st_cropButton"
    hidden="yes"
    icon="media:crop"
    onClick="script:cc_crop"
    style="firstspirit"
    useLanguages="no">
    <LANGINFO>
      <LANGINFO long="*" label="Crop image"/>
    </LONGINFOS>
    <PARAMS>
      <PARAM name="formfield">#field.st_imageMap</PARAM>
    </PARAMS>
</FS_BUTTON>

CCSF-482 - New format templates for headlines
To use the new headline formats, you must first copy the format templates headline and sub_headline. They are contained within the reference project in the folder Format Templates  Custom Format Templates. Then the format templates can be included in each CMS_INPUT_DOM input component as in the following example:

<CMS_INPUT_DOM
    name="st_text"
    hFill="yes"
    listConfig="style:Listenart[0:Bullet Points|2:Numbers]"
    rows="10"
    table="no"
    useLanguages="yes">
    <FORMATS>
      <TEMPLATE name="p"/>
      <TEMPLATE name="headline"/>
      <TEMPLATE name="sub_headline"/>
    </FORMATS>
    [...]
</CMS_INPUT_DOM>

New features

ID Description

CCSF-706

Replaced the crop icon

CCSF-694

Updated external links in documentation

CCSF-482

Added new format templates for headlines

CCSF-247

Improved error messages in the project app configuration

Version 2.50.0

Update Notice

With this version, the Content Sync Pipeline receives the status deprecated. For this reason an update of the Job Schedules is recommended. In order to do this the job steps of type Custom.FirstSpirit.ImportLibrary or Custom.FirstSpirit.ImportSlotConfigurations should be replaced by job steps of the type ImportContent or ImportContentSlots. A detailed description of the configuration to be made is contained in the "Job Schedule Setup" chapter.

Fixed issues

ID Description

CCSF-672

Compatibility with the new ContentCreator

New features

ID Description

CCSF-692

Replaced Content-Sync Pipeline with new job steps

CCSF-691

Updated templates to work with Storefront Reference Architecture 4.4.1

Version 2.49.0

New features

ID Description

CCSF-667

WebDAV module now Java 11 compatible

Version 2.48.0

New features

ID Description

CCSF-681

Extended functionality for the page creator executable

Version 2.47.0

New features

ID Description

CCSF-679

Updated the english documentation

27. Help

The Technical Support of the Crownpeak Technology GmbH provides expert technical support covering any topic related to the FirstSpirit™ product. You can get and find more help concerning relevant topics in our community.

28. Disclaimer

This document is provided for information purposes only. Crownpeak Technology GmbH may change the contents hereof without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. Crownpeak Technology GmbH specifically disclaims any liability with respect to this document and no contractual obligations are formed either directly or indirectly by this document. The technologies, functionality, services, and processes described herein are subject to change without notice.