User Documentation
User Documentation
Breadcrumbs

Transformation Rules

Transformation rules harmonize interface metadata from diverse data sources into consistent, standardized formats. Use transformation rules to map inconsistent system names like "SFTP" or "RabbitMQ" to standardized business systems and automatically tag interfaces with relevant business objects.

💡

New to transformation rules?

Start with the Onboarding Guide - Step 3: Configure Transformation Rules for complete setup. This step covers daily usage and advanced configuration.

Access Transformation Rules

Navigate to Landscape → Transformation Rules to configure both system and object mapping rules.

image-20250821-115328.png
Transformation Rules interface showing Objects and Systems tabs for configuring interface mappings

Objects

The Objects tab assigns business objects to interfaces based on naming patterns. Multiple objects can be assigned to a single interface when patterns match.

What you see:

  • Interface column: Shows regex patterns (e.g. .*CurrencyRate.*, .*Customer.*)

  • Harmonized Object dropdown: Select from predefined business objects

  • Data Source column: Indicates which data source the rule applies to

  • Checkboxes to enable/disable each rule

image-20250821-124523.png
Objects tab showing interface patterns mapped to business objects like Currency Rate, Work Item, and Sales Order

How to use:

  1. Click "+" to add new object mapping rules

  2. Enter interface pattern using regex (use .* as wildcard)

  3. Select Harmonized Object from dropdown

  4. Check the checkbox to enable the rule

  5. Click Save to apply changes

Example patterns:

  • .*SalesOrder.* → Sales Order

  • .*Invoice.* → Invoice

  • .*Customer.* → Customer Data

Systems

The Systems tab harmonizes sender and receiver system names. The first matching rule is applied (first-match-wins logic).

What you see:

  • Interface column: Regex patterns for interface matching

  • Original System column: Raw system names from data sources

  • Harmonized System dropdown: Select standardized system names (see Systems)

  • Data Source column: Shows applicable data source

  • Checkboxes to activate rules

image-20250821-124654.png
Systems tab displaying transformation rules that map original system names to harmonized business systems

How to use:

  1. Click "+" to add system mapping rules

  2. Configure Interface pattern (use .* for any interface)

  3. Enter Original System name as it appears in raw data

  4. Select Harmonized System from dropdown

  5. Enable with checkbox and Save

Rule logic examples:

  • Map by system: .* + "SFTP" → "File Server (xChange)"

  • Map by interface: .*DeletedMessage.* + "RabbitMQ" → "Messaging Broker"

Order matters for system rules - place specific patterns before general wildcards since the first matching rule wins.

Apply and Validate

After configuring rules, update your inventory and verify the transformations worked correctly.


image-20250821-120659.png

Apply transformations:

  1. Click Update Inventory on the right side of the interface

  2. System processes all existing interfaces against your transformation rules

Verify success in Inventory:

  • Navigate to Inventory → Interfaces → Catalog

  • Success indicators: System names appear as blue hyperlinks, business objects populate in Tags column

  • Issues: Check Inventory → To-do for interfaces needing additional rules

image-20250821-124955.png
Interfaces Catalog showing successful transformations with populated Sender/Receiver columns and clickable system links

Best Practices

  • Test rules with specific patterns before using broad wildcards

  • Use meaningful regex patterns: .*Order.*, SAP.*, .*API$

  • Document rule purposes in Description fields

  • Review To-do list regularly for unmapped interfaces

  • Order system rules from most specific to most general /expand

For comprehensive setup and configuration details, see:

Learn more:

Last Updated: August 21, 2025