# Formulas

## Contents

How are Formulas Used in Osmos?

Supported Formulas

Getting Started

## How are Formulas Used in Osmos?

Formulas can be used to complete complex transforms on data from one or more input columns. We have several predefined formulas (such as CONCAT, DATE, ADD, IF, IFERROR, etc.) that can be used together.

## Supported Formulas

Our formulas fall into one of the following four categories noted below. For more information about a specific formula, navigate to one of the pages below.

## Getting Started

**Step 1**: Once you have mapped the input (uploaded) column(s) to the output (cleaned) column, **click on any cell in the output column to open the Data Cleanup panel** on the right.

**Step 2**: Select **Use Formulas** at the bottom of the panel.

**Step 3**: Click into the formula bar to see the list of available formulas.

**Step 4**: Continue typing the name of the formula, or scroll through the list of formulas to find the one you are looking for, then select the formula.

**Step 5**: Provide formula inputs according to the format shown in the helper box for that specific formula. Ensure that the formula is complete and closing parentheses are included.

**Note**: Inputs within square brackets are optional.

**Step 6**: After providing the input(s) for the formula, press enter to submit the formula. The formula will output values for each cell in the output column.

**Note**: If you are uploading a file to clean up (i.e. not using Osmos Pipelines) and you need to make edits to specific cells in the output column after applying a formula, click on any cell in the output column and provide a single-cell edit.

**Step 7**: Use the toggles at the top of the page to filter for rows with errors and/or rows flagged for review, and edit the formula or add the “iferror” formula to resolve any errors.

**Note**: If you are uploading a file to clean up (i.e. not using Osmos Pipelines) you can also resolve errors by manually skipping that row using the row level checkboxes, or by providing a single-cell edit by clicking on any cell in the output column and editing the value.

**Step 8**: Once you are done, **click Save** and move onto the next output column. If you want to restart and choose a different Data Cleanup method for this column, click Start Over.

## Escape Characters

Osmos allows the use of escape characters in formulas to allow the inclusion of characters in a string when those characters already serve a specific function in the formula engine. Specifically, if a user wished to write a formula which references a field which contains double quotes, escape characters are necessary. See examples:

`$"Quantity"`

references the field`Quantity`

`$"/"Quantity/""`

references the field`"Quantity"`

`$""Quantity""`

Is syntactically incorrect, and will cause a formula to break

Last updated