Guide - 7.8 API Changes

Table of Contents


Product Version

7.8

Product To Version

7.8
Status

final

1 Changes

DescriptionAPI changesHow to migrate
PromotionCombinationEvaluator does not declare "throw Exception" anymore

The methods

public void setApplicationContext(String registryName)
public void setActionDescriptorRegistry(ActionDescriptorRegistry anActionDescriptorRegistry)

in the interface

com.intershop.component.marketing.capi.promotion.combination.PromotionCombinationEvaluator

do not have a "throws Exception" clause anymore

Remove throws clause from your custom implementation of the interface

Check if try/catch block can be removed from the calling code

Java code of cartridge sld_pmc

com.intershop.sellside.pmc.capi.PageletModelUtils

removed getPageEntryPointDefinitionsByContextObjectRelation(ContextObjectRelation<PageEntryPointDefinition> relation, App app) - deprecated since 7.4

removed getComponentEntryPointDefinitionsByContextObjectRelation(ContextObjectRelation<ComponentEntryPointDefinition> relation, App app) - deprecated since 7.4

Use equally named methods with pagelet model repository parameter instead of app. The model repository can be retrieved as part of an ApplicationBO extension.
Java code of cartridge bc_pmc

com.intershop.component.pmc.capi.model.PageletModelRepository

Added getConfigurationParameterDefinition(String qualifiedName)

com.intershop.component.pmc.capi.model.EMFPageletModelRepository

Added getConfigurationParameterDefinition(String qualifiedName)

com.intershop.component.pmc.capi.pagelet.PageletEntryPointMgr

removed getRootPageEntryPoints(Domain domain) - deprecated since 7.4

com.intershop.component.pmc.capi.pagelet.PageletMgr

removed getPagePageletDefinitions(Domain site) - deprecated since 7.4

removed getComponentPageletDefinitions(Domain site) - deprecated since 7.4

removed getPagelet(PersistentObject persistentObject, Domain domain) - deprecated since 7.0

com.intershop.component.pmc.capi.pagelet.ContentSharingProvider

removed getContentRepositoryDomainBySite(Domain site) - deprecated since 7.4

PageletEntryPointMgr

Use getRootPageEntryPoints(Domain, PageletModelRepository) instead of getRootPageEntryPoints(Domain domain)

PageletMgr

Use PageletModelRepository API instead of getPagePageletDefinitions(Domain site)

Use PageletModelRepository API instead of getComponentPageletDefinitions(Domain site)

Use AssignmentStrategyProvider API instead of getPagelet(PersistentObject persistentObject, Domain domain)

ContentSharingProvider

Use getContentRepositoryDomainByApplication(Application) instead of getContentRepositoryDomainBySite(Domain site)

Pipelets of cartridge bc_pmc

GetPageEntryPointDefinitionByQualifiedName

Remove deprecated Site parameter - deprecated since 7.4

Made PageletModel parameter required

UpdateSlotVisibility

As to Enhanced Content Sharing rework this pipelet has been deprecated.

GetSlotDefinitions

Completely removed as it is deprecated since 7.4

GetContextObjectRelationExtensions

Removed old context-object-relation-extensions pipelets as they have been replaced (since 7.2) by View Context concept

GetContextObjectRelationExtension

Removed old context-object-relation-extensions pipelets as they have been replaced (since 7.2) by View Context concept

GetPageletDefinitions

Completely removed as it is deprecated since 7.4.

GetSlotDefinitions

Use PageletModelRepository API instead

GetPageletDefinitions

Use PageletModelRepository API instead

Queries of cartridge bc_pmc

Query processor PageletDefinitionUtils

Removed old context-object-relation-extensions query processor as it has been replaced (since 7.2) by View Context concept

GetSubCategoriesByCategories.query

Removed as concept is outdated.

SearchRootCategoriesByPagelet.query

Removed from bc_pmc as concept is outdated.

SearchSlotDefinitionQualifiedNamesByCategories.query

Removed from bc_pmc as concept is outdated.

SearchSlotsByDefinitionAndCategory.query

Removed from bc_pmc as concept is outdated.

SearchSubcategoriesByParentCategoryAndPagelet.query

Removed from bc_pmc as concept is outdated.

GetSubCategoriesByCategories

Use equally named query from cartridge bc_mvc. Keep in mind to pass the value 'true' for the new parameter 'Recursive' when using it.

Queries of cartridge bc_mvc

DetermineCategoryPage.query

Removed from bc_pmc as concept is outdated.

DetermineProductPage.query

Removed from bc_pmc as concept is outdated.

GetCategoriesWithEntryPointAssignment.query

Removed from bc_pmc as concept is outdated.

DetermineCategoryPage.query, DetermineProductPage.query and GetCategoriesWithEntryPointAssignment.query have been replaced by View Context concept.

Pipelines from cartridge app_sf_responsive

Default-UpdatePersonalizationGroup

Removed as it is deprecated since IS 7.3.2.

ProcessProductReview-GetReviewsByAuthor

Removed as it was deprecated.

ProcessProductReview-IsReviewedByUser

Removed as it was deprecated.

ProcessProductReview-GetUserReview

Removed as it was deprecated.

ProcessProductReview-GetReviewList

Removed as it was deprecated.

ProcessProductReview-GetNavigationList

Removed as it was deprecated.

ProcessRecentlyViewedItems-AddRecentlyViewedProduct

Removed as it was deprecated.

ProcessRecentlyViewedItems-RemoveRecentlyViewProduct

Removed as it was deprecated.

ProcessSitemap-DetermineStandardCatalogs

Removed Parameters CurrentOrganization and CurrentUser since they were deprecated since IS 7.5

ProcessSitemap-GetSitemapCategories

Removed Parameter User since it was deprecated since IS 7.5

Default-UpdatePersonalizationGroup

Use Default-UpdateUserGroupsAndPGID instead.

ProcessProductReview-GetReviewsByAuthor

Use ProcessReview-GetReviewsByAuthor instead.

ProcessProductReview-GetUserReview

Use the BO extensions.

ProcessProductReview-GetReviewList

Use ProcessProductReview-GetReviews instead.

ProcessProductReview-GetNavigationList

Use the CreateNavigationList pipelet directly.

ProcessRecentlyViewedItems-AddRecentlyViewedProduct

Use ProcessRecentlyViewedItems-AddRecentlyViewedProductPO instead.

ProcessRecentlyViewedItems-RemoveRecentlyViewProduct

Use ProcessRecentlyViewedItems-RemoveRecentlyViewProductPO instead

Cartridge bc_basket

AddToBasketContext:
       Super interface extracted. AddToBasketContext extends the new AdjustBasketContext

BasketBO
       functionality which was deprecated for a longer time was removed
       new method validateBasket()

BasketProductLineItemBO
       functionality which was deprecated for a longer time was removed

RemoveFromBasketContext:
       Super interface extracted. RemoveFromBasketContext extends the new AdjustBasketContext

UpdateQuantityContext:
       Super interface extracted. UpdateQuantityContext extends the new AdjustBasketContext

AddToBasketContext:
    No code changes required

BasketBO:
    Delete implementation for removed methods
    Provide implementation for new method

BasketProductLineItemBO:
    Delete implementation for removed methods

RemoveFromBasketContext:
    No code changes required

UpdateQuantityContext:
    No code changes required

Cartridge bc_order_impexThe package structure changed from com.intershop.component.orderimpex.capi to com.intershop.component.order.impex.capi.Replace all occurrences of the old package in your code by the new package name.
Cartridge bc_address

AddressBO
       functionality which was deprecated for a longer time was removed

AddressBORepository
       new method deleteAddressBO()

AddressBO
     Delete implementation for removed methods

AddressBORepository
    Provide implementation for new method

Cartridge bc_shipping

com.intershop.component.shipping.capi.defaultshippingmethodselector.DefaultShippingMethodSelector

Added method setDefaultShippingMethod(ProductLineItem pli)

Implement new method if own implementation is used (default implementation has already been adapted)
Cartridge core

com.intershop.beehive.core.capi.test.request.RequestRule was moved to pf_core_test


Adjust dependency to pf_core_test
Cartridge bc_approval

com.intershop.component.approval.capi.business.basic.BusinessObjectApprovalExtensionImpl<T> and com.intershop.component.approval.capi.business.basic.BasicBusinessObjectApprovalExtensionFactory<T>: an abstract class was extracted



Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Tickets