Adobe Classifications adobe-classifications

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Adobe Classifications exports classifications data to Adobe Analytics in a scheduled manner. The exporter is an implementation of a com.adobe.cq.scheduled.exporter.Exporter.

To configure this:

  1. Navigate via Tools, Cloudservices to the Adobe Analytics section.

  2. Add a new configuration. You will see that the Adobe Analytics Classifications Configuration template displays below the Adobe Analytics Framework configuration. Supply a Title and Name as required:

    aa-25

  3. Click Create to configure the settings.

    chlimage_1

    Properties include the following:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
    Field Description
    Enabled Select Yes to enable the Adobe Classifications settings.
    Overwrite on conflict Select Yes to overwrite any data collisions. By default, this is set to No.
    Delete processed If set to Yes, deletes processed nodes after they are exported. The default is False.
    Export job description Enter a description for the Adobe Classifications job.
    Notification E-mail Enter an email address for Adobe Classifications notification.
    Report Suite Enter the Report suite to run the import job for.
    Data Set Enter the dataset relation ID to run the import job for.
    Transformer From the drop-down menu, select a transformer implementation.
    Data Source Navigate to the path for the data container.
    Export Schedule Select the schedule for the export. The default is every 30 minutes.
  4. Click OK to save your settings.

Modifying Page Size modifying-page-size

Records are processed in pages. By default, Adobe Classifications creates pages with a page size of 1000.

A page may be 25000 in size at maximum, per definition in Adobe Classifications and can be modified from the Felix console. During the export, Adobe Classifications locks the source node to prevent concurrent modifications. The node is unlocked after export, on error, or when the session is closed.

To change the page size:

  1. Navigate to the OSGI console at https://<host>:<port>/system/console/configMgr and select Adobe AEM Classifications Exporter.

    aa-26

  2. Update the Export Page Size as required, then click Save.

SAINTDefaultTransformer saintdefaulttransformer

NOTE
Adobe Classifications was previously known as the SAINT Exporter.

An Exporter may use a Transformer to transform the export data to a specific format. For Adobe Classifications, a subinterface SAINTTransformer<String[]> implementing the Transformer interface has been provided. This interface is used to restrict the data type to String[] which is used by the SAINT API and to have a marker interface to find such services for selection.

In the default implementation SAINTDefaultTransformer, the child resources of the exporter source are treated as records with property names as keys and property values as values. The Key column is added automatically as first column - its value will be the node name. Namespaced properties (containing :) are disregarded.

Node structure:

  • id-classification nt:unstructured

    • 1 nt:unstructured

      • Product = My Product Name (String)
      • Price = 120.90 (String)
      • Size = M (String)
      • Color = black (String)
      • Color^Code = 101 (String)

SAINT Header & Record:

Key
Product
Price
Size
Color
Color^Code
1
My Product Name
120.90
M
black
101

Properties include the following:

Property path
Description
transformer
A class name of a SAINTTransformer implementation
email
Notification e-mail address.
reportsuites
Report suite IDs to run the import job for.
dataset
Dataset relation ID to run the import job for.
description
Job description.
overwrite
Flag to overwrite data collisions. Default is false.
checkdivisions
Flag to check report suites for compatibility. Default is true.
deleteprocessed
Flag to delete the processed nodes after export. Default is false.

Automating Adobe Classifications Export automating-adobe-classifications-export

You can create your own workflow, so that any new imports launch the workflow to create the appropriate, and correctly structured, data in /var/export/ so that it can be exported to Adobe Classifications.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8