Overview
The Moveworks integration provides a ready-made function you can call when building mappings. It turns a record's custom fields into a set of name and value pairs, so you do not have to write that logic yourself in a formula.
Where you can use these functions
These functions are available anywhere you write a formula for the Moveworks integration:
Dynamic Formula mappings: where a destination field's value is produced by a formula rather than mapped directly from a source field.
Mapping collection filters: where a formula decides whether a record should be processed.
Error filters: a mapping collection's error filter, which sits alongside its collection filter. When the error filter's formula resolves to true, the transfer raises an error that is held in the Error Logs for review and is not retried automatically.
Translation collections: where a translation entry uses a formula as its source value.
How to use them
Call a function by name and pass the values it needs in parentheses, for example:
GetPropertiesFromCustomFields(CustomFields).Each function's signature shows its name, the parameters it accepts (with their types), and the type of value it returns. Use it as the reference for exactly how to call the function.
Function names and formula syntax are case-sensitive, so type each name exactly as shown. Whether the values a function matches are treated as case-sensitive varies by function, and is called out in the relevant parameter's description.
This function is synchronous, so you call it directly (no
awaitis required).The function runs at sync time, against the data in your connected Moveworks account and your iPaaS.com subscription.
The functions are grouped below by the area of the integration they support.
Custom Fields
GetPropertiesFromCustomFields
What it does: Reads a record's custom fields and returns them as a set of name and value pairs, keyed by the custom field name.
Signature: Dictionary<string, string> GetPropertiesFromCustomFields(object customFieldObj)
How to call it: GetPropertiesFromCustomFields(customFieldObj)
Parameter | Type | Required | Default | Description |
|
| Yes | N/A | The iPaaS.com custom fields to read, as a list of custom field entries. |
Returns: Dictionary<string, string>. A set of custom field name and value pairs. A field with no value is returned with an empty value, and the function returns null if no custom fields are supplied.
Example: A custom field named Moveworks Message Recipients with value example@gmail.com returns a pair mapping Moveworks Message Recipients to example@gmail.com.
When to use it: Use this in a Moveworks message mapping when you need a record's custom fields as name and value pairs, for example to map them to message slots.