Advanced Use Cases
      Back to home
      1. Help Center
      2. Using Unito
      3. Advanced Use Cases

      What are field transformers?

      These advanced settings allow you to fine-tune how your Unito flows sync data between tools. Here's how.

      In this article:

      What are field transformers?

      Field transformers are custom configurations that can be applied to individual Unito flows. These configurations define specific transformations and manipulations that take place between a source tool (where data is coming from) and the destination tool (where it's going). These transformations happen the moment Unito pulls data from that source tool. That means these transformed fields are essentially indistinguishable from regular fields, allowing your flow to do anything it could usually do — like filtering work items with those fields.

      Here are a few examples of what these field transformers can do:

      • Concatenating two or more fields. For example, automatically adding an identifier or a priority level to an Asana task title.
      • Performing mathematical calculations. This can eliminate entire steps from your workflow by transforming numerical data between tools instead of putting that load on your destination tool.
      • Converting HTML to plain text. This can get around limitations around text and formatting in some tools.
      • Serializing objects: A transformer can pull individual pieces of data from a single field, put them in a specific order, and send that serialized data to a field in another tool in that order.
        • For example, one tool might separate an address into a street name, a city, and a country, in a single field while another field displays that address as a single line of information. A transformer can pick out the data from the first field, put it in the right order, and sync it to the second field as a single piece of data.
      • Picking a single value from a group: For example, imagine a flow between one tool where a task has multiple tags, like "high priority," "blocked," and "decision needed" and another tool where tasks can only have a single tag. With a field transformer, your flow could pick just a single tag from that first task (e.g. "blocked") and sync it to the other tool.

      How to set up a transformer

      Field transformers can be applied to Unito flows through custom JSON configurations added to a flow's advanced settings. Here's how.

      1. Reach out to your account executive and ask for the JSON configuration your use case needs.
      2. Go to your Unito Dashboard and click the three dots on the flow you want to apply your configuration to.
      3. Click Edit.
      4. Click Advanced options.
      5. Paste your field transformer in the text box under Advanced features.

      Limitations to keep in mind

      While field transformers can make your flows a lot more flexible, they do have some limitations.

      • Not available with all connectors: Reach out to your account executive to know if field transformers are supported for your integrations.
      • Only one-way: When a flow applies a transformer to a field, that field becomes a one-way field. You won't be able to sync data in both directions between fields when using field transformers.