DocumentatieAEM 6.5Handboek

Ontwikkeling met SAP-Commerce Cloud developing-with-sap-commerce-cloud

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar
NOTE
Het eCommerce-kader kan met elke oplossing voor eCommerce worden gebruikt. Bepaalde details en voorbeelden die hier worden behandeld zien de hybrisoplossing.

Het integratieframework bevat een integratielaag met een API. Hiermee kunt u:

  • plug-in een eCommerce-systeem en haal productgegevens naar Adobe Experience Manager (AEM)

  • bouwen AEM componenten voor handelsmogelijkheden onafhankelijk van de specifieke eCommerce-motor

chlimage_1-11

NOTE
API documentatieis ook beschikbaar.

Verscheidene uit-van-de-doos AEM componenten worden verstrekt om de integratielaag te gebruiken. Deze zijn momenteel:

  • een productweergaveonderdeel
  • een winkelwagentje
  • uitchecken

Voor onderzoek, wordt een integratiehaak verstrekt die u het AEM onderzoek, het onderzoek van het eCommerce systeem, een derdenonderzoek, of een combinatie van daarvan laat gebruiken.

Selectie van eCommerce-engine ecommerce-engine-selection

Het eCommerce-kader kan bij elke eCommerce-oplossing worden gebruikt; de motor die wordt gebruikt, moet identificeerbaar zijn door AEM:

  • eCommerce Engines zijn OSGi-services die de interface CommerceService ondersteunen

    • Motoren kunnen worden onderscheiden door een service-eigenschap commerceProvider

  • AEM ondersteunt Resource.adaptTo() for CommerceService en Product

    • De adaptTo -implementatie zoekt naar een cq:commerceProvider -eigenschap in de hiërarchie van de bron:

      • Indien gevonden, wordt de waarde gebruikt om de raadpleging van de handelsdienst te filtreren.

      • Indien niet gevonden, wordt de hoogste commerciële dienst gebruikt.

    • Er wordt een cq:Commerce -mix gebruikt, zodat de cq:commerceProvider kan worden toegevoegd aan bronnen met een sterk type.

  • De eigenschap cq:commerceProvider wordt ook gebruikt om naar de juiste definitie van de handelsfabriek te verwijzen.

    • Bijvoorbeeld, correleert een cq:commerceProvider bezit met de waarde hybris met de configuratie OSGi voor Dag CQ Commerce Factory voor Hybris (com.adobe.cq.commerce.hybris.impl.HybrisServiceFactory) - waar de parameter commerceProvider ook de waarde hybris heeft.

    • Hier kunnen verdere eigenschappen, zoals versie van de Catalogus worden gevormd (wanneer aangewezen en beschikbaar).

Zie de volgende voorbeelden:

cq:commerceProvider = geometrixx
in een standaard AEM installatie is een specifieke implementatie vereist. Het voorbeeld Geometrixx bevat bijvoorbeeld minimale extensies voor de algemene API
cq:commerceProvider = hybris
hybrusimplementatie

Voorbeeld example

/content/store
+ cq:commerceProvider = hybris
  + mens
    + polo-shirt-1
    + polo-shirt-2
    + employee
+ cq:commerceProvider = jcr
  + adobe-logo-shirt
    + cq:commerceType = product
    + price = 12.50
  + adobe-logo-shirt_S
    + cq:commerceType = variant
    + size = S
  + adobe-logo-shirt_XL
    + cq:commerceType = variant
    + size = XL
    + price = 14.50
NOTE
Met CRXDE Lite kunt u zien hoe dit wordt verwerkt in de productcomponent voor de hybris-implementatie:
/apps/geometrixx-outdoors/components/hybris/product/product.jsp

Ontwikkeling van hybris 4 developing-for-hybris

De hybris-uitbreiding van het eCommerce Integration Framework is bijgewerkt om Hybris 5 te ondersteunen, terwijl achterwaartse compatibiliteit met Hybris 4 behouden blijft.

De standaardinstellingen in de code worden ingesteld voor Hybris 5.

Voor de ontwikkeling van Hybris 4 is het volgende vereist:

  • Wanneer het aanhalen van gemaakt, voeg het volgende bevel-lijn argument aan het bevel toe

    -P hybris4

    De vooraf geconfigureerde distributie van Hybris 4 wordt gedownload en in de bundel ingesloten cq-commerce-hybris-server .

  • In de OSGi configuratiemanager:

    • Schakel Hybris 5-ondersteuning voor de parser Standaardreactie uit.

    • Zorg ervoor dat de dienst van de Handler van de Authentificatie van Hybris Basis een lagere de dienstrangschikking heeft dan de dienst van de Handler van de Handler van Hybris OAuth.

Sessieafhandeling session-handling

hybris gebruikt een gebruikerssessie om informatie op te slaan , zoals het winkelwagentje van de klant . De sessie-id wordt geretourneerd door hybris in een JSESSIONID -cookie die bij volgende aanvragen naar hybris moet worden verzonden. Als u wilt voorkomen dat de sessie-id in de opslagplaats wordt opgeslagen, wordt deze gecodeerd in een ander cookie dat in de browser van de winkel wordt opgeslagen. De volgende stappen worden uitgevoerd:

  • Op het eerste verzoek, wordt geen koekje geplaatst op het verzoek van de verkoopster; zo wordt een verzoek verzonden naar de hybris instantie om een zitting tot stand te brengen.

  • De sessiecookies worden uit de reactie geëxtraheerd, gecodeerd in een nieuw cookie (bijvoorbeeld hybris-session-rest ) en ingesteld op de reactie op de gebruiker. De codering in een nieuwe cookie is vereist, omdat de oorspronkelijke cookie alleen geldig is voor een bepaald pad en anders niet vanuit de browser wordt teruggestuurd in volgende aanvragen. De padgegevens moeten aan de waarde van het cookie worden toegevoegd.

  • Op volgende aanvragen worden de cookies gedecodeerd uit de hybris-session-<*xxx*> cookies en ingesteld op de HTTP-client die wordt gebruikt om gegevens van hybris aan te vragen.

NOTE
Er wordt een nieuwe, anonieme sessie gemaakt wanneer de oorspronkelijke sessie niet meer geldig is.

CommerceSession commercesession

  • Deze zitting "bezit"het winkelwagentje

    • toevoegen/verwijderen/enz. uitvoeren

    • de verschillende berekeningen op het karretje uitvoert;

      commerceSession.getProductPrice(Product product)

  • Verkrijgt de opslagplaats voor orde gegevens

    CommerceSession.getUserContext()

  • Vertoningen de betaling verwerkingsverbinding

  • Vertoningen de verwezenlijking verbinding

Productsynchronisatie en -publicatie product-synchronization-and-publishing

Productgegevens die in hybris worden bewaard, moeten in AEM beschikbaar zijn. Het volgende mechanisme is geïmplementeerd:

  • Een eerste lading id's wordt geleverd door hybris als voer. Deze feed kan worden bijgewerkt.
  • hybris verstrekt via een diervoeder bijgewerkte informatie ( dat AEM opiniepeilingen ) .
  • Wanneer AEM productgegevens gebruikt, verzendt het verzoeken terug naar hybris voor de huidige gegevens (voorwaardelijk krijgen verzoek gebruikend laatste gewijzigde datum).
  • Bij hybriden is het mogelijk de voederinhoud op declaratieve wijze te specificeren.
  • Het toewijzen van de voederstructuur aan het AEM inhoudsmodel gebeurt in de voederadapter aan de AEM kant.

chlimage_1-12

  • De importer (b) wordt gebruikt voor de initiële installatie van de paginaboomstructuur in AEM voor catalogi.

  • Veranderingen in de hybris in de catalogus worden via een diervoeder aan AEM gemeld en vervolgens doorgegeven aan AEM b)

    • Product toegevoegd/verwijderd/gewijzigd met betrekking tot catalogusversie.

    • Goedgekeurd product

  • De hybris-extensie biedt een pollingimporter ("hybris"-schema), die kan worden geconfigureerd om wijzigingen met een opgegeven interval in AEM te importeren (bijvoorbeeld elke 24 uur waarin het interval in seconden wordt opgegeven):

    code language-javascript 
        http://localhost:4502/content/geometrixx-outdoors/en_US/jcr:content.json
     {
     * "jcr:mixinTypes": ["cq:PollConfig"],
     * "enabled": true,
     * "source": "hybris:outdoors",
     * "jcr:primaryType": "cq:PageContent",
     * "interval": 86400
     }

  • De catalogusconfiguratie in AEM herkent Geleide en Online catalogusversies.

  • Voor het synchroniseren van producten tussen catalogusversies moet de bijbehorende AEM pagina (a, c) worden geactiveerd of gedeactiveerd.

    • Het toevoegen van een product aan een Online catalogusversie vereist activering van de pagina van het product.

    • Voor het verwijderen van een product is deactivering vereist.

  • Voor het activeren van een pagina in AEM © is een controle (b) vereist. Dit is alleen mogelijk als

    • Het product is in een Online catalogusversie voor productpagina's.

    • De referenced producten zijn beschikbaar in een Online catalogusversie voor andere pagina's (bijvoorbeeld, campagnepagina's).

  • De geactiveerde productpagina's moeten tot de online versie van de productgegevens toegang hebben {(d).

  • De AEM Publish-instantie vereist toegang tot hybris voor het ophalen van product en gepersonaliseerde gegevens (d).

Architectuur architecture

Architectuur van product en varianten architecture-of-product-and-variants

Eén product kan meerdere variaties hebben, bijvoorbeeld van kleur en/of grootte. Een product moet bepalen welke eigenschappen variatie drijven; de Adobe richt deze variantassen.

Niet alle eigenschappen zijn echter variantassen. Variaties kunnen ook van invloed zijn op andere eigenschappen. De prijs kan bijvoorbeeld afhankelijk zijn van de grootte. Deze eigenschappen kunnen niet door de verkoopster worden geselecteerd en worden daarom niet als variantassen beschouwd.

Elk product en/of elke variant wordt vertegenwoordigd door een middel, en daarom kaarten 1:1 aan een opslaggegevensopslagknoop. Het gevolg is dat een specifiek product en/of specifieke variant op unieke wijze kan worden geïdentificeerd door het pad ervan.

De product/variant-bron bevat niet altijd de werkelijke productgegevens. Het kan een representatie zijn van gegevens die op een ander systeem (zoals hybris) worden opgeslagen. Productbeschrijvingen en prijzen worden bijvoorbeeld niet opgeslagen in AEM, maar in real-time opgehaald via de eCommerce-engine.

Elke productbron kan worden vertegenwoordigd door een Product API . De meeste aanroepen in de product-API zijn variatiespecifiek (hoewel variaties gedeelde waarden van een voorouder kunnen overerven), maar er zijn ook aanroepen die de set variaties ( getVariantAxes(), getVariants() enzovoort) weergeven.

NOTE
In feite wordt een variant as bepaald door wat Product.getVariantAxes() retourneert:
  • hybris definieert het voor de implementatie van hybris
Hoewel producten (in het algemeen) vele variantassen kunnen hebben, behandelt de uit-van-de-doos productcomponent slechts twee:

  1. size

  2. plus één of meer

Deze extra variant wordt geselecteerd via de eigenschap variationAxis van de productreferentie (meestal color voor Geometrixx Outdoors).

Productverwijzingen en productgegevens product-references-and-product-data

In het algemeen staan productgegevens onder /etc en productverwijzingen onder /content .

Er moet een 1:1-kaart zijn tussen productvariaties en productgegevensknooppunten.

Productverwijzingen moeten ook een knooppunt hebben voor elke gepresenteerde variatie - maar er is geen verplichting om alle variaties weer te geven. Als een product bijvoorbeeld S, M, L-variaties heeft, kunnen de productgegevens als volgt zijn:

etc
|──commerce
|  |──products
|     |──shirt
|       |──shirt-s
|       |──shirt-m
|       |──shirt-l

Een catalogus van het type "Big and Tall" kan alleen het volgende bevatten:

content
|──big-and-tall
|  |──shirt
|     |──shirt-l

Tot slot is er geen verplichting om productgegevens te gebruiken. U kunt alle productgegevens onder de verwijzingen in de catalogus plaatsen; maar u kunt niet echt veelvoudige catalogi hebben zonder alle productgegevens te dupliceren.

API

com.adobe.cq.commerce.api.Product interface com-adobe-cq-commerce-api-product-interface

public interface Product extends Adaptable {

    public String getPath();            // path to specific variation
    public String getPagePath();        // path to presentation page for all variations
    public String getSKU();             // unique ID of specific variation

    public String getTitle();           // shortcut to getProperty(TITLE)
    public String getDescription();     // shortcut to getProperty(DESCRIPTION)
    public String getImageUrl();        // shortcut to getProperty(IMAGE_URL)
    public String getThumbnailUrl();    // shortcut to getProperty(THUMBNAIL_URL)

    public <T> T getProperty(String name, Class<T> type);

    public Iterator<String> getVariantAxes();
    public boolean axisIsVariant(String axis);
    public Iterator<Product> getVariants(VariantFilter filter) throws CommerceException;
}

com.adobe.cq.commerce.api.VariantFilter com-adobe-cq-commerce-api-variantfilter

/**
 * Interface for filtering variants and AxisFilter provided as common implementation
 *
 * The <code>VariantFilter</code> is used to filter variants,
 * for example, when using {@link Product#getVariants(VariantFilter filter)}.
 */
public interface VariantFilter {
    public boolean includes(Product product);
}

/**
 * A {@link VariantFilter} for filtering variants by the given
 * axis and value. The following example returns a list of
 * variant products that have a value of <i>blue</i> on the
 * <i>color</i> axis.
 *
 * <p>
 * <code>product.getVariants(new AxisFilter("color", "blue"));</code>
 */
public class AxisFilter implements VariantFilter {

    private String axis;
    private String value;

    public AxisFilter(String axis, String value) {
        this.axis = axis;
        this.value = value;
    }

    /**
     * {@inheritDoc}
     */
    public boolean includes(Product product) {
        ValueMap values = product.adaptTo(ValueMap.class);

        if(values != null) {
            String v = values.get(axis, String.class);

            return v != null && v == value;
        }

        return false;
    }
}

  • het Algemene Mechanisme van de Opslag

    • Productknooppunten zijn nt:unstructured .

    • Een productknooppunt kan zijn:

      • Een verwijzing, met de elders opgeslagen productgegevens:

        • Productverwijzingen bevatten een eigenschap productData , die verwijst naar de productgegevens (doorgaans onder /etc/commerce/products ).

        • De productgegevens zijn hiërarchisch; de productkenmerken worden overgeërfd van de voorouders van een productgegevensknooppunt.

        • De verwijzingen van het product kunnen lokale eigenschappen ook bevatten, die die in hun productgegevens worden gespecificeerd met voeten treden.

      • Een product zelf:

        • Zonder een eigenschap productData .

        • Een productknooppunt dat alle eigenschappen lokaal bevat (en geen eigenschap productData bevat), neemt productkenmerken rechtstreeks van zijn eigen voorouders over.

  • AEM-generische Structuur van het Product

    • Elke variant moet een eigen bladnode hebben.

    • De interface van het product vertegenwoordigt zowel producten als varianten, maar het verwante gegevensopslagknooppunt is specifiek waarover het is.

    • Het productknooppunt beschrijft de productkenmerken en de variantassen.

Voorbeeld example-1

+ banyan_shirt
    - cq:commerceType = product
    - cq:productAttributes = [jcr:title, jcr:description, size, price, color]
    - cq:productVariantAxes = [color, size]
    - jcr:title = Banyan Shirt
    - jcr:description = Flowery, all-cotton shirt.
    - price = 14.00
    + banyan_shirt_s
        - cq:commerceType = variant
        - size = S
        + banyan_shirt_s_red
            - cq:commerceType = variant
            - color = red
        + banyan_shirt_s_blue
            - cq:commerceType = variant
            - color = blue
    + banyan_shirt_m
        - cq:commerceType = variant
        - size = M
        + banyan_shirt_m_red
            - cq:commerceType = variant
            - color = red
        + banyan_shirt_m_blue
            - cq:commerceType = variant
            - color = blue
    + banyan_shirt_l
        - cq:commerceType = variant
        - size = L
        + banyan_shirt_l_red
            - cq:commerceType = variant
            - color = red
        + banyan_shirt_l_blue
            - cq:commerceType = variant
            - color = blue
    + banyan_shirt_xl
        - cq:commerceType = variant
        - size = XL
        - price = 18.00

Architectuur van het winkelwagentje architecture-of-the-shopping-cart

Onderdelen

  • Het winkelwagentje is eigendom van de CommerceSession:

    • CommerceSession voegt toe of verwijdert, enzovoort.
    • De CommerceSession voert ook de diverse berekeningen op de kar uit. "

  • Hoewel de CommerceSession niet rechtstreeks met een cart te maken heeft, moet deze ook informatie over catalogusprijzen verstrekken (aangezien de eigenaar van prijzen is)

    • Prijzen kunnen verschillende opties hebben:

      • Kwantiseringen.
      • Andere valuta's.
      • BTW-plichtig en btw-vrij.

    • De modifiers zijn open-end met de volgende interface:

      • int CommerceSession.getQuantityBreakpoints(Product product)
      • String CommerceSession.getProductPrice(Product product)

Opslag

  • Opslag

    • In het hybris-geval is de hybris-server eigenaar van het winkelwagentje.
    • In het AEM-generische geval, worden de wortels van opgeslagen in de ClientContext.

Personalization

  • Stem altijd verpersoonlijking door de ClientContext.

  • In alle gevallen wordt een ClientContext /version/ van het winkelwagentje gemaakt:

    • Producten moeten met de methode CommerceSession.addCartEntry() worden toegevoegd.

  • In het volgende voorbeeld ziet u een voorbeeld van de informatie over winkelwagentjes in de ClientContext:

chlimage_1-13

Architectuur van uitchecken architecture-of-checkout

Kar en de Gegevens van de Orde

CommerceSession bezit de drie elementen:

  1. Inhoud winkelwagentje

  2. Prijsstelling

  3. De orderdetails

  4. inhoud van de Kar

    Het schema voor de inhoud van het winkelwagentje wordt bepaald door de API:

    code language-java 
    public void addCartEntry(Product product, int quantity);
public void modifyCartEntry(int entryNumber, int quantity);
public void deleteCartEntry(int entryNumber);

  5. Prijsbepaling

    Het prijsschema wordt ook bepaald door de API:

    code language-java 
    public String getCartPreTaxPrice();
public String getCartTax();
public String getCartTotalPrice();
public String getOrderShipping();
public String getOrderTotalTax();
public String getOrderTotalPrice();

  6. de Details van de Orde

    Nochtans, zijn de ordedetails niet bevestigd door API:

    code language-java 
    public void updateOrderDetails(Map<String, String> orderDetails);
public Map<String, String> getOrderDetails();
public void submitOrder();

Verschepende Berekeningen

  • Orderformulieren moeten vaak meerdere verzendopties (en prijzen) bevatten.

  • De prijzen kunnen gebaseerd zijn op artikelen en gegevens van de bestelling, zoals gewicht en/of bezorgadres.

  • CommerceSession heeft toegang tot alle afhankelijkheden, zodat het op een vergelijkbare manier kan worden behandeld als productprijzen:

    • De CommerceSession is eigenaar van de verzendprijs.
    • Kan leveringsgegevens ophalen/bijwerken met updateOrder(Map<String, Object> delta)
NOTE
U kunt een verzendkiezer implementeren, bijvoorbeeld:
yourProject/commerce/components/shippingpicker :

  • In principe kan dit een kopie van foundation/components/form/radio zijn, maar met callbacks naar de CommerceSession for:

  • Controleren of de methode beschikbaar is

  • Prijsinformatie toevoegen

  • Kopers in staat stellen de bestelpagina in AEM bij te werken (inclusief de superset van verzendmethoden en de beschrijvende tekst), terwijl ze toch de controle hebben om de relevante CommerceSession -informatie beschikbaar te maken.

de Verwerking van de Betaling

  • De CommerceSession is ook eigenaar van de betalingsverwerkingsverbinding.

  • Implementatoren dienen specifieke aanroepen (naar hun gekozen betalingsverwerkingsservice) toe te voegen aan de CommerceSession -implementatie.

de Vervulling van de Orde

  • CommerceSession is ook eigenaar van de uitvoeringsverbinding.
  • Implementatoren moeten specifieke aanroepen (naar hun gekozen betalingsverwerkingsservice) toevoegen aan de CommerceSession -implementatie.

Zoekdefinitie search-definition

Na het standaard dienstAPI model, verstrekt het eCommerce-project een reeks op onderzoek betrekking hebbende APIs die door individuele handelsmotoren kunnen worden uitgevoerd.

NOTE
Momenteel implementeert alleen de hybris-engine de zoek-API uit-van-de-box.
Nochtans, is het onderzoek API generisch en kan door elke CommerceService individueel worden uitgevoerd.

Het eCommerce-project bevat een standaardzoekcomponent in:

/libs/commerce/components/search

chlimage_1-14

Dit gebruikt onderzoek API om de geselecteerde handelingsmotor (zie {de Selectie van de Motor van de Handel 0} eCommerce 🔗) te vragen:

Zoeken in API search-api

Het kernproject bevat verschillende algemene klassen/hulpklassen:

  1. CommerceQuery

    Beschrijft een zoekquery (bevat informatie over de querytekst, de huidige pagina, het paginaformaat, de sortering en de geselecteerde facetten). Alle eCommerce-services die de zoek-API implementeren, ontvangen instanties van deze klasse om hun zoekopdracht uit te voeren. Een CommerceQuery kan worden geïnstantieerd vanuit een aanvraagobject ( HttpServletRequest ).

  2. FacetParamHelper

    Is een hulpprogrammaklasse die één statische methode - toParams - verstrekt die voor het produceren van GET parameterkoorden van een lijst van facetten en één knevelwaarde wordt gebruikt. Dit is nuttig aan de UI kant, waar u een hyperlink voor elke waarde van elk facet moet tonen, zodat wanneer de gebruiker de hyperlink klikt de respectieve waarde van een knevel wordt voorzien. Als deze optie is geselecteerd, wordt deze uit de query verwijderd, anders toegevoegd. Hierbij wordt rekening gehouden met alle logica van het omgaan met meerdere/enkele facetten, het overschrijven van waarden enzovoort.

Het ingangspunt voor de zoekAPI is de methode CommerceService#search die een CommerceResult -object retourneert. Zie de API Documentatievoor meer informatie over dit onderwerp.

Gebruikersintegratie user-integration

Er wordt gezorgd voor integratie tussen AEM en verschillende systemen voor e-handel. Hiervoor is een strategie nodig voor het synchroniseren van aankopen tussen de verschillende systemen, zodat AEM specifieke code alleen op de hoogte moet zijn van AEM en omgekeerd:

  • Verificatie

    AEM wordt verondersteld om het slechts vooreind van het Web te zijn en daarom alle authentificatie uitvoert.

  • Rekeningen in hybriden

    AEM maakt een bijbehorende (ondergeschikte) account in hybris voor elke winkel. De gebruikersnaam van dit account is gelijk aan de AEM gebruikersnaam. Een cryptografisch willekeurig wachtwoord wordt automatisch geproduceerd en (gecodeerd) opgeslagen in AEM.

Bestaande gebruikers pre-existing-users

Een AEM front-end kan vóór een bestaande hybris-implementatie worden geplaatst. Ook kan een hybris-engine aan een bestaande AEM-installatie worden toegevoegd. Hiertoe moeten de systemen bestaande gebruikers in elk systeem netjes kunnen verwerken:

  • AEM > hybriden

    • Wanneer u zich aanmeldt bij hybris, als de AEM gebruiker niet bestaat:

      • een hybrusgebruiker maken met een cryptografisch willekeurig wachtwoord
      • sla de hybris-gebruikersnaam op in de gebruikersmap van de AEM gebruiker

    • Zie: com.adobe.cq.commerce.hybris.impl.HybrisSessionImpl#login()

  • hybris > AEM

    • Wanneer het programma openen aan AEM, als het systeem de gebruiker erkent:

      • aanmelden bij hybris met de geleverde gebruikersnaam/pwd
      • Als dit lukt, maakt u de gebruiker AEM met hetzelfde wachtwoord (AEM-specifieke salt resulteert in AEM-specifieke hash).

    • Het bovenstaande algoritme wordt geïmplementeerd in een Sling AuthenticationInfoPostProcessor

      • Zie: com.adobe.cq.commerce.hybris.impl.user.LazyUserImporter.java

Het importproces aanpassen customizing-the-import-process

Uw aangepaste importhandler bouwen op bestaande functionaliteit:

  • moet de interface ImportHandler implementeren

  • kan de lus DefaultImportHandler uitbreiden.

/**
 * Services implementing the <code>ImportHandler</code> interface are
 * called by the {@link HybrisImporter} to create actual commerce entities
 * such as products.
 */
public interface ImportHandler {

  /**
  * Not used.
  */
  public void createTaxonomie(ImporterContext ctx);

  /**
  * Creates a catalog with the given name.
  * @param ctx   The importer context
  * @param name  The catalog's name
  * @return Path of created catalog
  */
  public String createCatalog(ImporterContext ctx, String name) throws Exception;

  /**
  * Creates a product from the given values.
  * @param ctx                The importer context
  * @param values             The product's properties
  * @param parentCategoryPath The containing category's path
  * @return Path of created product
  */
  public String createProduct(ImporterContext ctx, ValueMap values, String parentCategoryPath) throws Exception;

  /**
  * Creates a variant product from the given values.
  * @param ctx             The importer context
  * @param values          The product's properties
  * @param baseProductPath The base product's path
  * @return Path of created product
  */
  public String createVariantProduct(ImporterContext ctx, ValueMap values, String baseProductPath) throws Exception;

  /**
  * Creates an asset for a product. This is usually a product
  * image.
  * @param ctx             The importer context
  * @param values          The product's properties
  * @param baseProductPath The product's path
  * @return Path of created asset
  */
  public String createAsset(ImporterContext ctx, ValueMap values, String productPath) throws Exception;

  /**
  * Creates a category from the given values.
  * @param ctx           The importer context
  * @param values        The category's properties
  * @param parentPath    Path of parent category or base path of import if there is a root category
  * @return Path of created category
  */
  public String createCategory(ImporterContext ctx, ValueMap values, String parentCategoryPath) throws Exception;
}

Voor uw douanemanager die door de importeur moet worden erkend, moet het het service.ranking bezit met een waarde hoger dan 0 specificeren, bijvoorbeeld.

@Component
@Service
@Property(name = "service.ranking", value = 100)
public class MyImportHandler extends DefaultImportHandler
{
...
}
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2