STEPXML Comparison Tool Prerequisites

Typically this type of work requires a Super User to carry out the task. The user would require in depth knowledge of STEPXML, System Setup, and how to use export and import manager.

Accessing the System Compare Tool

To access the STEP System Administration data, the user must have Super Users privileges, i.e., be an administrator of the system. The user will require all the privileges necessary to make the updates the imported XML requires.

Important: A lot of memory is required to run this tool, therefore the STEPXML Comparison Tool has been superseded by the change packages functionality and may be removed in a future release. It is recommended that users transition to using change packages, which are described in the Change Packages section of the Configuration Management documentation here.

Go to File > Export > Compare System Setup Exports... to display the Compare System Setup Exports dialog.

Moving configuration without using the STEP comparison tool

It is possible to move configuration from one STEP instance to another without using the comparison tool.
This process will only add / modify configuration loaded onto a target system. If you then need to identify what is different from the source and target machines the comparison tool will need to be used.

Move all configurations from one STEP system to another

  • Back-up target system
  • Export XML from Source system excluding assets, classifications, products, and entities
  • Run a Cross Context export if configuration is stored in more dimension points, i.e., LOVs, attribute names, etc.
  • Import onto target system
  • Check execution report for errors and resolve

What configuration can be moved from one system to another?

Before a user can use the comparison tool the STEP export manager needs to be used to export STEPXML from the source and target systems.

When configuring the export the following will need to be selected:

  • Add the parent node for configuration files being which need to be moved from the source to the target
    If this is not done the import will fail on import the configuration files as the folder it resides in will not exist
  • Select the STEP configurations that need to be exported

All parameters available in the Export Manager are defined in the STEPXML Outbound Parameters topic in the Data Exchange documentation here. The Global Settings, Data Objects, and Publishing options are not valid for the STEPXML Comparison Tool.

Only the Configuration parameters in Export Manager for the STEPXML format are available for comparison with this tool as shown in the following section.

Configuration

Configuration Parameter

Description

Include Action Sets

Select No or Yes to control output of a list of all actions applied to each action set.

For more information, refer to Action Sets in System Setup documentation here.

Include Asset Push Event Queues

Asset push event queues are exported as follows:

  • Select All to output all asset push event queues.
  • Select Selected to output all asset push event queues based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no asset push event queues.

Include Asset Push Configurations

Asset push configurations are exported as follows:

  • Select All to output all asset push configurations.
  • Select Selected to output all asset push configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no asset push configurations.

Include Attributes

For attributes, the validation base types, dimension dependencies applied units, applied LOV hierarchy filters, calculated templates, and so on, are exported as follows:

  • Select All to output all attributes, including fundamental system specific attributes (having an ID that starts with stibo. or asset.).
  • Select Selected or Minimum to output attributes based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no attributes.

For more information, refer to Attributes in System Setup documentation here.

Include Attribute Groups

For attribute groups, the view definitions and settings applied to attribute groups are exported as follows:

  • Select All to output all attribute groups.
  • Select Selected or Minimum to output attribute groups based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no attribute groups.

For more information, refer to Attribute Groups in System Setup documentation here.

Include Attribute Transformations

Select No or Yes to control output of attribute transformations and their configurations.

For more information, refer to Attribute Transformations in System Setup documentation here.

Include Bulk Update Configurations

Assets saved as bulk update configurations are exported as follows:

  • Select Yes to output all bulk update configurations.
  • Select Minimum to output bulk update configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select No to output no bulk update configurations.

For more information, refer to Bulk Updates documentation here.

Include Business Rules (Global) and Libraries

For global business rules and libraries, the ID, name, links, on approve setting, dependencies, valid object types, and templates are exported as follows:

  • Select All to output all global business rules and libraries.
  • Select Selected or Referenced to output attributes based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no global business rules or libraries.

Templates are exported in Base64 and can only be imported without modifications into another STEP system.

For more information, refer to Business Rules documentation here.

Include Collection Definitions

Select No or Yes to control output of collections groups and collections, including search URLs. The exported file will not contain products, classifications, or assets included in a collection.

For more information, refer to Collections in the Getting Started documentation here.

Include Component Models

Select No or Yes to control output of details of component models, including ID, name, object types and links. The Component Model node in System Setup displays all available component models on your system.

For more information, refer to the Component Models topic in System Setup documentation here.

Include Contexts

Select No or Yes to control output of dimensions, dimension points, contexts, applied dimension points, and locale settings.

For more information, refer to Contexts in System Setup documentation here.

Include Context Qualifiers

Select No or Yes to control output of a list of qualifiers used in exported data. When used in combination with export of product, classification, or asset data, controls qualifier IDs and dimension point IDs.

For more information, refer to Contexts in System Setup documentation here.

Include Data Container Definitions

Data container types are exported as follows:

  • Select All to output all data container types.
  • Select Selected or Minimum to output data container types based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no data container types.

For more information, refer to Data Containers in System Setup documentation here.

Include Derived Event Types

Select No or Yes to control output of objects created in System Setup as Derived Event Type.

For more information, refer to Derived Events in System Setup documentation here.

Include eCatalogs

Select No or Yes to control output of eCatalog configurations and price lists. Does not include product selection lists.

For more information, refer to eCatalogs here.

Include Event Processors

Control output of event processor information, including ID, name, links, and configuration.

  • Select All to output all event processors.
  • Select Minimum to output event processors based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no event processors.

For more information, refer to Event Processors in System Setup documentation here.

The configurations are exported in Base64 and can only be imported without modifications into another STEP system.

Include Event Queues

Select No or Yes to control output of event queues and applied message templates, output formatting, and triggering definitions.

Include Export Configurations

Assets saved as export configurations are exported as follows:

  • Select All to output all export configurations.
  • Select Minimum to output export configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no export configurations.

For more information, refer to Maintaining a Saved Export Configuration in Data Exchange here.

Include Image Conversion Configurations

Image conversion configurations are exported as follows:

  • Select All to output all image conversion configurations.
  • Select Selected or Minimum to output image conversion configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no image conversion configurations.

Include Import Configurations

Assets saved as import configurations are exported as follows:

  • Select All to output all import configurations.
  • Select Minimum to output import configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no import configurations.

For more information, refer to Maintaining a Saved Import Configuration in Data Exchange documentation here.

Include Integration Endpoints

Control output of integration endpoint ID, name, and configurations. The configurations are exported in Base64 and can only be imported without modifications into another STEP system.

  • Select All to output all integration endpoints.
  • Select Selected to output only integration endpoints in the selected hierarchy based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no integration endpoints.

For more information, refer to the integration endpoint topics in Data Exchange documentation here.

Include Key Definitions

Select No or Yes to control output of definitions of objects created as keys.

For more information, refer to the Unique Keys in System Setup documentation here.

Include Link, Reference and Object Types

Important: Use caution when handling reference types and object types with an ID that start with stibo. since they are fundamental objects.

User-created object types created below the 'Setup Group type root' node and system-specific object types, link types, and system specific reference types are exported as follows:

  • Select All to output all edge, reference, and object types.
  • Select Selected or Minimum to output only link, reference, and object types in the selected hierarchy based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no link, reference, and object types.

For more information, refer to Reference and Link Types in System Setup documentation here.

Note: Edge types are identified with either 'PA' (product to attribute link type) or 'CA' (classification to attribute link type).

Include List of Values

LOV definitions and values in LOVs, including applied meta attributes, validation base types, and applied units are exported as follows:

  • Select All to output all LOV definitions and values.
  • Select Selected or Minimum to output LOV definitions and values based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no LOV definitions or values.

For more information, refer to List of Values (LOVs) in System Setup documentation here.

Include Match Codes

Select No or Yes to control output of match code information, including ID, name, links, setup group, valid entity hierarchies, and valid object types.

For more information, refer to Matching, Linking, and Merging documentation here.

Include Matching Algorithms

Control output of matching algorithms, including ID, name, links, and configuration.

For more information, refer to Matching, Linking, and Merging documentation here.

  • Select All to output all matching algorithms.
  • Select Selected to output matching algorithms based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no matching algorithms.

The configurations are exported in Base64 and can only be imported without modifications into another STEP system.

Include Setup Entities

Control output of setup entities including ID, name, links, and configuration. The configurations are exported in Base64 and can only be imported without modifications into another STEP system.

  • Select All to output all setup entities.
  • Select Selected to output setup entities based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no setup entities.

Include Setup Groups

Control output of setup groups that are defined in system setup to hold integration endpoints, Web UI configurations, STEP workflows, and business rules.

  • Select All to output all setup groups.
  • Select Selected to output setup groups based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no setup groups.

To export user-created object types created below the 'Setup Group type root' node, refer to the Include Link, Reference and Object Types configuration parameter above.

For more information, refer to Setup Groups in System Setup documentation here.

Include Status Flags

Workflow status flags are exported as follows:

  • Select All to output all workflow status flags.
  • Select Selected to output workflow status flags based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no workflow status flags.

For information, refer to the Status Flags topic in Workflows documentation here.

Include System Settings

Select No or Yes to control output of the following default settings defined on the Users and Groups root node:

  • Image & Document Settings flipper > Dimension Dependencies
  • Calculated Attribute Settings flipper > Dimension Dependencies
  • Product Information Manager Default Settings flipper
  • Flatplanner Default Settings flipper
  • DTP Default Settings flipper
  • GDSN Default Settings flipper
  • Terms List Settings flipper
  • WebServices Default Settings flipper
  • Web UI Default Settings flipper
  • Default Reference Type of Primary Image flipper
  • Table Default width and height flipper

For more information, refer to System Settings in System Setup documentation here.

Include Table Types

Row type definitions, column type definitions, and table type definitions, including applied transformations are exported as follows:

  • Select All to output all table types.
  • Select Minimum to output table types based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no table types.

For more information, refer to Tables documentation here.

Include Tags

Select No or Yes to control output of style tags, character tags, special characters, footnotes, and hyperlinks, including information about rendering, short cuts, and applied output formatting.

For more information, refer to Tags in System Setup documentation here.

Include Transformation Lookup Tables

Assets saved as transformation lookup table configurations are exported as follows:

  • Select All to output all transformation lookup table configurations.
  • Select Minimum to output transformation lookup table configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no transformation lookup table configurations.

For information, refer to the Transformation Lookup Tables topic in Resource Materials online help here.

Include Translation Configurations

Saved translation configurations are exported as follows:

  • Select All to export all saved translation configurations.
  • Select Selected to export selected saved translation configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to export no saved translation configurations.

For information on saving translation configurations for data objects, refer to the Starting a Structured Translation topic here. For information on saving translation configurations for setup objects, refer to the Structured Translation for Setup Objects topic here.

Include Units

Unit groups and units, including applied meta attributes, values, and base unit conversions are exported as follows:

  • Select All to output all unit groups and units.
  • Select Selected or Minimum to output unit groups and units based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no unit groups or units.

For more information, refer to Units in System Setup documentation here.

Include Users and User Groups

Control output of all user groups and users, including information about applied privileges, meta attributes, restricted GUI setup, etc.

User passwords are not included in the output. Since creating a new user requires a password, new users cannot be created via STEPXML import. However, changes to existing users can be imported.

Note: When changing a user from one assigned group to another, the user is added to the new group, but must be manually removed from the original group.

  • Select All to output all users or user groups. The Select Objects step allows you to limit the users and/or groups after setting the Export parameter to All, use the Add Objects link to define the objects to export.
  • Select Selected to output users or user groups based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no users or user groups.

For more information, refer to Users and Groups in System Setup documentation here.

Include Web UI Configurations

Control output of Web UI configurations in the exported file.

  • Select All to output all Web UI configurations.
  • Select Selected to output Web UI configurations based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no Web UI configurations.

For more information, refer to Managing Web UI Configurations in the Web User Interfaces here.

Include Websites

Select No or Yes to control output of websites, with and without workspace.

The legacy ‘Web Publisher’ used this option to publish data incrementally from STEP. OIEPs provide improved functionality for this same purpose. For more information, refer to the Data Exchange documentation here.

Include Workflows

Workflow information, including ID, name, links, valid object types, and configuration are exported as outlined below. The configurations are exported in Base64 and can only be imported without modifications into another STEP system.

  • Select All to output all workflows.
  • Select Selected to output workflows based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no workflows.

For more information, refer to Workflows documentation here.

Include Workflow Profiles

Workflow profiles (including information such as number of exceeded deadlines, how long the tasks have been assigned to the assignees, throughput for the month versus the last six months, etc.) are exported as follows:

  • Select All to output all workflow profiles.
  • Select Selected to output workflow profiles based on the explanation in the Minimum, Referenced, and Selected in STEPXML documentation here.
  • Select None to output no workflow profiles.

For more information, refer to Monitoring Workflows in Workflows documentation here.