Importacular User Guide

  1. Home
  2. Docs
  3. Importacular User Guide
  4. Advanced Importing
  5. Data Transformations

Data Transformations

Data Transformations allow you to work with data in your Data Source and manipulate it as it comes into Raiser’s Edge. The options available to you within Data Transformations differ based upon the type of field that you’re importing to within the Raiser’s Edge. All Data Transformations are case sensitive and the order of processing follows the order of the grid. You must select a Source Field Value in your mapping template in order to use a Data Transformation.

To watch a video tutorial showing a Data Transformation on a Fund field, click here.

The functionality of Data Transformation depends upon the field type for the data that you are mapping to that specific Raiser’s Edge field. Click on the links below to read more about what options are available for each of the different field types within the Raiser’s Edge.

Table based fields (such as – Fund, Appeal, Constituent Code, Solicit Code, etc.)

Text based fields (such as a Gift Reference, Last Name, Organisation Name, etc.)

Checkbox or Yes/No fields (such as ‘Is Inactive’, ‘Has no valid address’, etc.

Date based fields (such as a Gift Date, an Action Date, etc.)

Amount based fields (such as a Gift Amount, etc.)

You can dynamically change source data to accurately import inline with your RE standards. So for example if you use short codes for states/counties you might change all ‘New York’ to ‘NY’ as shown below.

You can choose  to make an exact match, match a whole word or match any letters in the source. The target can now be completely replaced or partially replaced. This is shown below. To read more about the different types of matches available, click here.

In the “Favourite Royal” attribute, if somebody enters “Elizabeth 2” it is matched on exactly and changed completely to “Elizabeth II”. If somebody enters the whole word “Lizzie” then wherever this is found in the field it will be changed to “Elizabeth” so that it could be used for instances of Elizabeth I or Elizabeth II. Finally if somebody enters the lower case letters “phil” it will be changed to uppercase “Phil”. This would catch where somebody has entered “phil”, “phillip” or “phillipe”. For more information on how text casing affects Data Transformations, see this Knowledgebase article and for more information on the order of processing with several settings in place, see this Knowledgebase article.

Catch All

In some cases you want to transform a set of values and any other values that do not match you want to set to a “catch all” value. This is useful, for example, when you have a default value e.g.  for country you may have UK -> United Kingdom, USA -> United States, etc. and any other should go to United States.

Another use is where the field is being used by many types of value. For example, there may be an event field for email actions consisting of values such as unsubscribe_click, read, open, forward etc. When mapping to a communication preference attribute you only want the unsubscribe_click to map to the attribute description of Unsubscribed. All other values should be blank. (For attributes this means they will not be added). This is shown below:

Only one row in the grid can be a catch all. The “From Source” cell is disabled for that row. To read more about the Catch All function, click here.

Stop Processing

The Stop Processing function allows you to set a row in your data transformation to be the final change should the field match multiple Source Field options. The row that has this box checked will be the final change for any records that match that particular row. Any source fields that do not match that row will process beyond that row in the grid. You can read more about this function here.

Import/Export the Grid

When working with Data Transformations, you can Export/Import the grid. This is helpful if you are using the same Source field options in multiple locations throughout your template or if you want to use the same options in another template. To see a video of how to export/import a grid of Data Transformations, click here.

This image has an empty alt attribute; its file name is yn5piNYzvXscFcSEWoIhK0yvfRWQwTRDhA.png

In the above image, you can see a sample Data Transformation grid.  To Export this template, you would select the option in the bottom right hand corner that points to the right. 

If you want to Import your saved grid, you can use the opposing image (that points to the bottom left corner).