BMEcat Format

Both BMEcat (version 1.2) and BMEcat 2005 are supported in STEP and use an XML-based standard for electronic data transfer by electronic catalogs. For more information about the standard, search the web.

BMEcat requires the 'X.Import.BMEcat' license and / or the 'X.Export.BMEcat' license. No add-on components must be installed.

For more information on BMEcat 2005, refer to the BMEcat 2005 Format documentation here.

Format Availability

BMEcat is available for selection in:

  • IIEP - refer to Creating an Inbound Integration Endpoint here
  • Import Manager - refer to Creating a Data Import here
  • Export Manager - refer to Creating a Data Export here
  • OIEP - refer to Creating an Outbound Integration Endpoint here

Mapping

This format requires creating a data map between STEP and the data being processed, and may also include data transformations. For details, refer to Data Mapping here.

To map price data for eCatalogs in outbound integration endpoints (OIEPs) or in the Export Manager, first expand Commercial (eCatalog) as shown in the screenshot below. Next, expand the relevant eCatalog (in this example, 'Acme Prices'), then select the relevant price list. In this example, the price list is named 'Price.' Then click the arrow icon next to Price in the conversion column to export the data associated with the commercial term into the BMEcat export.

A user can map multiple price lists from the same eCatalog, but cannot map price lists from multiple eCatalogs. If this is attempted, the system displays a warning message that looks like this:

For more information on configuring eCatalogs for export via BMEcat, refer to the 'Configure an eCatalog Configuration for BMEcat' section of the Creating an eCatalog Configuration topic in the eCatalogs documentation here.

BMEcat 1.2 and BMEcat 2005 are the only formats that allow access to Product Attribute Link metadata attributes, via the transformation aspect 'Closest Attribute Link Meta Data.' For details, refer to Aspect - Transform Outbound here.

If mapping an ETIM file to the BMEcat2005 format, refer to the LOV Value-ID or Value Aspect topic here.

Inbound Data

Inbound Parameters

  • Validate determines if STEP checks the validity of the BMEcat file against a BMEcat DTD file before loading any data.
  • Conversion Preview displays data being imported when the BMEcat DTD file is in the system., otherwise the field is empty.

Import Manager

IIEP

Outbound Data

Exporting the BMEcat format involves supplying header data and catalog / product data via the parameters displayed on the Select Format step and during the Map Data step. Some information is required, as is indicated on the Map Data step. Although the export process can be run while mandatory fields are missing, the background process (BGP) will fail.

Outbound Parameters

  1. For the Export Validate parameter, select an option from the dropdown to determine how mandatory fields (marked in red on the Map Data step) are handled during export:
  • Warn and skip missing mandatory data - When a value is missing, the product is not exported and the execution report includes the warning 'Skipping product ([ID] / [Name]) missing mandatory data: xxxx.'
  • Warn and allow missing mandatory data - When a value is missing, the product is exported minus the missing mandatory data, and the execution report includes the warning 'Found product ([ID] / [Name]) missing mandatory data: xxxx.'
  • Abort on missing mandatory data - When a value is missing, the export fails and the execution report includes 'Aborting export due to product ([ID] / [Name]) missing mandatory data: xxxx' and the time of the failure.
  1. For the Validate XML parameter, Yes indicates that the BMEcat 1.2 export file is validated against the BMEcat DTD included in STEP. When validation fails, the BGP also fails, and the problem is reported in the BGP execution report. If set to No, validation is skipped, and the BGP does not fail due to differences found compared to the DTD.
  2. For the Price update only? parameter, No indicates that the catalog section of the file is included. If set to No, the catalog section is excluded and only fields related to prices are exported.
  3. For the Update count parameter, allows you to track the version number displayed in the tag with the 'prev_version' XML attribute within the file. This parameter must be manually incremented as needed.
  4. For the Allow Empty Values parameter, Yes indicates that data sources that are mapped but do not have a value are exported. If set to No, mapped data sources without values are skipped during export.
  5. For an explanation of the remaining parameters, search the web to find and refer to the 'Specification BMEcat® Version 1.2' document. No validation is performed on the text entered or the selections made, but if Validate XML = Yes, errors will be reported in the execution report, as defined above.

Export Manager

OIEP