Pipelet: ImpEx ExportCatalog

Pipelet ExportCatalog

Exports selective information in the specified Catalog. This pipelet offers fine grained control over the information which gets exported through the ExportXXX input parameters. Additionally, it offers the ability to export a specific list of categories and/or products.

Group:

ImpEx

Flags:

Error Connector

Input Parameters

Catalog : Catalog Required

The catalog to export.

ExportFile : String Required

Export file path. This path is relative to the 'src' subdirectory within the top-level IMPEX directory.

Categories : Iterator Optional

Optional list of categories to export. If this parameter is provided, only the categories in the list are exported. If ExportSubCategories parameter is set to true, then all sub-categories of these categories are exported as well. If this parameter is empty or is not given, then the following rules apply: 1-all categories of the given catalog are exported. 2-The ExportSubCategories parameter is ignored. Categories in the list which do not belong to the given catalog and duplicate categories are ignored. Note that the exported categories determine which category assignments and possibly which products are exported.

ExportProducts : Boolean Optional

Default=true. Parameter indicating whether products are exported or not. If this parameter is set to true and a specific list of products is passed in the Products parameter, then those products will be exported. If this parameter is set to true but the Products parameter is not given, then only products bound to exported categories will be exported. In both cases, only products that are owned by the given Catalog parameter are exported.

ExportCategories : Boolean Optional

Default=true. Parameter indicating whether categories should be exported or not. This parameter is not entirely independent of other parameters because exported categories determine which category assignments and possibly which products are exported.

ExportSubCategories : Boolean Optional

Default=true. Parameter indicating whether to export sub-categories of the exported categories. This parameter is only meaningful if a specific list of categories is passed in the Categories parameter. Otherwise all catalog categories are exported.

OverwriteExportFile : Boolean Optional

Optional flag indicating whether to overwrite an existing export file or not. true=overwrite (default), false=don't overwrite. Default is true.

ExportCategoryAssignments : Boolean Optional

Default=true. Parameter indicating whether category assignments of the exported categories are exported or not. Only category assignments that are owned by the given Catalog parameter and are bound to an exported category are exported. Category assignments that are not owned by the given Catalog are ignored even if they are bounded to the exported categories.

ExportRecommendations : Boolean Optional

Default=true. Parameter indicating whether recommendations should be exported or not. Only recommendations owned by the given catalog are exported. Recommendations that are not owned by the given catalog are ignored even if they refer to exported products or categories.

ExportProductOptions : Boolean Optional

Default=true. Parameter indicating whether shared product options should be exported as part of the catalog export. Product options that are defined in the scope of a single product will always be exported as part of the product itself.

ExportVariationAttributes : Boolean Optional

Default=true. Parameter indicating whether shared variation attributes should be exported as part of the catalog export. Variation attributes that are defined in the scope of a single product will always be exported as part of the product itself.

Products : Iterator Optional

Optional list of products to export. If this parameter is provided, only the products in the list are exported. If this parameter is empty or is not given, then only products bound to exported categories are exported. In either case, products in the list which do not belong to the given catalog are ignored.

Output Parameters

ErrorCode : Integer : Optional

Export status code. Zero represents an export without process errors. Any other value indicates an error. This value will always be the same as the number after the "IMPEX-" prefix in Status.code.

ErrorMsg : String : Optional

Status message associated with the status code. This value will be the same as Status.message.

LogFileName : String : Optional

The name of the log file. This file is located in the 'log' subdirectory of the IMPEX area. This value will always be the same as the detail LogFileName in the returned Status object.

Status : Status : Optional

Status object representing the result of the export operation. The status property (Status.status) will be set to 0 if the export executed without any process errors or 1 otherwise. The code property (Status.code) will be set to one of the following values:

IMPEX-100 = One or more input parameters given were null.
IMPEX-102 = The given ExportFile exists and the OverwriteExportFile flag is false.
IMPEX-105 = The path of the given ImportFile is invalid, e.g. the path cannot contain "../".
IMPEX-150 = The 'Catalog' input parameter is missing.
IMPEX-156 = There is no data to export.
IMPEX-170 = Encountered an internal fatal error. Additional information is in the details of the Status object.
IMPEX-171 = System IO error.
IMPEX-173 = System input parameter is invalid.

The status object will always have the following detail:

LogFileName = (String) The log file name in which the import logged all debug, warning, and error messages.