BMEcat 2005 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.

To use the BMEcat functionality, the BMEcat commercial license needs to be enabled. Contact Stibo Systems to begin the process of enabling a license or licenses for your system.

For more information on BMEcat (version 1.2), refer to the BMEcat Format documentation here.

Format Availability

BMEcat 2005 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 details.' Then click the arrow icon next to Price in the conversion column to export the data associated with the commercial term into the BMEcat 2005 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 2005 and BMEcat 1.2 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.

Note: When using the auto map option in the BMEcat 2005 format to input eCl@ss or ETIM data, the auto map will initially try to match the attribute IDs in the import file with the IDs of attributes in the system. If no match is found, the auto map then adds the prefix 'eClass_ or 'ETIM_' to the input attribute's IDs that failed to match to attribute IDs in the system, and attempts to match the attribute IDs again. If no match is found, the user must manually map the attribute.

For more information on auto mapping, refer to the Inbound Map Data - Auto Map topic in the Data Mapping documentation here.

Inbound Data

Inbound Parameters

The following parameters are displayed on the inbound wizards:

  • Sample is updated automatically when the format is selected.
  • Refresh button updates the Conversion Preview pane.
  • Conversion Preview displays data being imported.

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 of the outbound wizards. 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.

Important: In order to export using BMEcat 2005, the BMEcat component model must be configured first. Refer to the BMEcat 2005 Component Model Configuration topic in the Data Exchange documentation for more information.

For details on configuration of BMEcat 2005 for ETIM data, refer to the BMEcat 2005 for ETIM Data Configuration topic here.

Outbound Parameters

The parameters that are available to fill out are controlled by the XML template that is uploaded. The fields listed below are ones that will display for all users.

  • In the Include Standard field, make a selection from the dropdown menu: ETIM, ECLASS, or General. If other standards have been configured, they will also display in the dropdown.

  • Template: Depending on what was selected in the Include Standard parameter will dictate what templates are available to select from in the dropdown for template options. For example, if ETIM was selected as the Standard, only templates associated with the ETIM BMEcat template standard will display as option in the dropdown. Once selected, it will populate the 'Sample' field.

  • The Sample field populates automatically depending on the Template selected.

    Note: For more information on Generic XML instructions, refer to the Generic XML Outbound Processing Instructions topic in the Data Exchange documentation here

  • For the Allow empty tags parameter, Yes indicates that export tags with empty values are included in the output. If set to No, tags containing empty values are not included in the export.

    For example, setting this parameter to Yes enables all ETIM attributes, even those without a value in STEP, to be exported. Additionally, when ETIM values exported via BMEcat are empty, they should be represented by a dash (-). For information on transforming an empty attribute value to a text string, refer to the Replace the whole value section in the Transformations topic of the Resource Materials documentation here.

  • The required Export data for selected contexts parameter allows you to output values for language dependent attributes, for example, the ETIM Short Description, Long Description, Keyword, and Remark values, and others. Select Yes in the dropdown to display the Select Contexts link. Click the link, select the required contexts for the export from the Select Contexts dialog, and click the Select button.

    The chosen contexts will be presented as <LANGUAGE> elements within the <HEADER> section of the exported XML file. If the system contains the specified context-dependent attribute values, they will be incorporated into the <PRODUCT_DETAILS> segment.

    Important: When using an OIEP for BMECat format export, ensure consistency between the contexts specified in the 'Export data for selected contexts' parameter and OIEP > Configuration tab > Configuration section > Contexts parameter. A mismatch may lead to contexts being presented differently in the exported file: those added in OIEP > Configuration tab > Configuration section > Contexts parameter will appear in the <PRODUCT_DETAILS> element, and those in 'Export data for selected contexts' parameter will be in the <HEADER> element.

  • The Select default context parameter shows the default context that is selected for the output. The parameter only displays contexts that were selected in the Export data for selected contexts parameter, and automatically selects the first context from the list. However, this can be changed by clicking the dropdown menu and selecting a different option.

  • The Catalog Group parameter can be defined if a catalog group structure is needed. When exporting an eCatalog, click the ellipsis button (), to eliminate the 'CLASSIFICATION_SYSTEM' section in the output file, on the Select Object dialog click the 'Select None' button.

For an explanation of additional parameters, search the web to find and refer to the 'Specification BMEcat® 2005' document. No validation is performed on the templates entered or the selections made, but if the Validate XML parameter displays and is = Yes, any errors will be reported in the execution report.

Export Manager

OIEP

Note: When using an OIEP for BMECat format export, there is a subtle distinction in how contexts are filled in the <HEADER> and <PRODUCT_DETAILS> elements. Specifically, for the context-dependent attribute values populated in the <PRODUCT_DETAILS> element, the values set in OIEP > Configuration tab > Configuration section > Contexts parameter take precedence and are populated accordingly. However, the contexts presented as <LANGUAGE> elements within the <HEADER> section are determined by the settings made in the above mentioned 'Export data for selected contexts' parameter itself.