Skip to main content

OneStream

OneStream Transformation Rules Quick Tip

One of the reasons companies choose, OneStream XF, is because the product is a platform and included in the platform are various engines with one of those engines being the stage integration engine.  With the appropriate requirements and design, the dimension library and stage integration engine can be leveraged by a company to create a standard chart of accounts “CoA” that may not exist for a variety of reasons one of which is due to acquisitions that have resulted in multiple ERP’s.  Once the standard CoA is created in the OneStream XF dimension library, the stage integration engine and transform rules can be used to map the ERP data to the standard CoA. The Quick Tip in this blog will focus on how to create One-To-One transformation rules using Excel that can then be imported into OneStream.

So why Excel and One-To-One transformation rules?  A common scenario I have encountered in my career is that when Company A acquires Company B a member of the acquisition or consolidation team will specify using Excel which accounts from the acquired companies’ ERP equals which account in the standard CoA.  Instead of rekeying the transformation rules into OneStream, the source to target mapping provided can be uploaded to OneStream reducing development time and improving accuracy.  To begin the Quick Tip, I will start by demonstrating how to extract transformation rules from OneStream application, GolfStream.

After logging into the application, select “Application” -> “Data Collection” -> “Transformation Rules“.

2021 03 000002

With Rule Groups displayed, select “HoustonAccounts” after expanding “Account Dimensions”.

2021 03 000003

From the Transformation Rules Toolbar, select the “Export selected group to a TRX file2021 03 000005 icon.

2021 03 000006

Depending on the file associations on your computer, you may receive a dialog box with “No application is associated with the specified file for this operation”.  If this is the circumstance, create a file association for extension “TRX” to Notepad or your preferred text editor.  If you are unfamiliar with this process, access OneStream support and specifically KB0010896 for the steps.  With the file association created, the extract will open in a text editor an example of which is the second image.  Note, the extract will include all transformation rule types:  Composite, Range, List, and Mask in addition to One-To-One; however, the focus will be on One-To-One for this Quick Tip, and rules which are not One-To-One have been deleted from the export.

2021 03 000008

2021 03 000023

Comparing the first row exported to the first row in the One-To-One OneStream transformation rules, we can determine that the first “1” value prior to the comma is the Source Value, the next value “2” is the Target Value, the fourth value “4” is the Description, and the fifth value “5” is the Order.  With the output format determined, the next step will be to replicate this format using Excel.  Note, the third column “3” in the export file and Flip Sign will be discussed during the creation of the format in Excel.

2021 03 000088

2021 03 000011

To begin the creation of the format in Excel, I imported the export “TRX” file into Excel using standard functionality as the TRX file is a comma-delimited file.  Once this was done, I inserted a blank row as row 1 and then keyed headers for the columns.  Note, the third column in the export is not used for One-To-One transformation rules and is labeled as such.

2021 03 000029

In column F, the process of creating the format will occur using the Concatenate function.  First, the source value format will be specified which is the formula “=CONCATENATE(“”””,A2,””””,”,”)

2021 03 000036

2021 03 000024

Next the Target Value format will be created in Column G with formula “=CONCATENATE(“”””,B2,””””,”,”)“.

2021 03 000037

2021 03 000027

In columns H, I, and J, the next three columns will be created which are formulas:  “=CONCATENATE(“,”)“, “=CONCATENATE(“”””,D2,””””,”,”)“, and “=+E2” respectfully.  The next three images also display the formulas for columns H, I, and J.

2021 03 000044

2021 03 000046

2021 03 000048

With the formulas “format” for each column created, the last step prior to addressing “Flip Sign” is to combine the formulas in cells F1 to J1 in cell K1 which is the formula,  “=CONCATENATE(F2,G2,H2,I2,J2)“.

2021 03 000050

2021 03 000052

With the format created for circumstances when Flip Sign is not needed, I will now address Flip Sign which typically applies to accounts classified in OneStream as a liability or revenue accounts that should be flipped from ledger signs “credits / negative numbers” to reporting signs “positive numbers“. To facilitate this example, I have moved SourceValue “11220” to row 3 and deleted the other imported rows.

2021 03 000055

2021 03 000054

For “Row 3“, the first step will be to copy the formulas from F2 to K2 down to F3 to K3 using standard Excel functionality.

2021 03 000057

To indicate Flip Sign is needed, the addition of a single hyphen is required before the Target Value which results in the following updated formula “=CONCATENATE(“”””,”

“,B3,””””,”,”)“.

2021 03 000058

2021 03 000061

With the formulas “format” created in columns F to J and then combined in column K, copy the contents of cells K2 and K3 to Notepad.

2021 03 000064

After the contents are copied to Notepad, save the file with your preferred name and a TRX extension enclosing the filename and extension in double-quotes when using Notepad.  Once this is done, “Save” the file.

2021 03 000065

Return to “Application” -> “Data Collection” -> “Transformation Rules” to begin the import process.

2021 03 000002

From the Transformation Rules Toolbar, select the “Import a TRX file into the selected group2021 03 000084 icon.  Note prior to this step the existing Transformation Rules were deleted from the group.

2021 03 000083

After the “Select Trx File” file dialog box renders, select the “Ellipsis2021 03 000085 icon.

2021 03 000066

Navigate to and select the file, ImportQuickTip.trx, previously created.  Once this is done, select “OK“.

2021 03 000068

Select “OK” after the files is imported successfully.

2021 03 000087

The HoustonAccounts group will now display the One-To-One Transformation Rules which were imported.

2021 03 000070

I hope this blog was helpful and thank you for your time in reading.  Should you have any questions, feel free to either post a comment or email me at terry.ledet@perficient.com.

Tags

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Terry Ledet, Senior Solutions Architect

Terry is a Senior Solutions Architect at Perficient and a OneStream Certified Professional (OCP) - Lead Architect R1. He is a frequent speaker at Splash and passionate about making clients successful. When not blogging about OneStream, Terry is a husband, parent, and baseball enthusiast.

More from this Author

Categories
Follow Us