# Allowed Functions

Inline Transformation Functions allow you to apply operations directly inside expressions wrapped with `{{ }}`. Functions can be chained, and execution happens left to right. The output of one function becomes the input for the next.

Example: `{{ 3.response.name.toUpper().startsWith("A").fallback(false) }}`

### Boolean Functions

#### toBoolean()

* Converts the current value to a boolean using the Convert utility.
* Allowed Parameters: None
* Structure: `toBoolean()`
* Examples:
  * `{{ "true".toBoolean() }}`
  * `{{ 1.toBoolean() }}`

#### toggle()

* Toggle the current boolean value (True becomes False, False becomes True).
* Allowed Parameters: None
* Structure: `toggle()`
* Examples:
  * `{{ is_active.toggle() }}`
  * `{{ true.toggle() }}`

#### and()

* Perform a logical AND between the current boolean value and another value.
* Allowed Parameters: rhs (Any)
* Structure: and(rhs)
* Examples:
  * `{{ is_valid.and(is_authenticated) }}`

#### or()

* Perform a logical OR between the current boolean value and another value.
* Allowed Parameters: `rhs (Any)`
* Structure: `or(rhs)`
* Examples:
  * `{{ is_admin.or(is_editor) }}`

### String Functions

#### toUpper()

* Converts the current string value to uppercase.
* Allowed Parameters: None
* Structure: `toUpper()`
* Examples:
  * `{{ user.name.toUpper() }}`

#### toLower()

* Converts the current string value to lowercase.
* Allowed Parameters: None
* Structure: `toLower()`
* Examples:
  * `{{ "HELLO".toLower() }}`

#### trim()

* Remove leading and trailing whitespace from the current string value.
* Allowed Parameters: None
* Structure: `trim()`
* Examples:
  * `{{ " hello ".trim() }}`

#### toString()

* Converts the current value to a string.
* Allowed Parameters: None
* Structure: `toString()`
* Examples:
  * `{{ price.toString() }}`

#### contains()

* Check if the current string value contains the given substring.
* Allowed Parameters: `substring (string)`
* Structure: `contains(substring)`
* Examples:
  * `{{ email.contains("@") }}`

#### startsWith()

* Check if the current string value starts with the given prefix.
* Allowed Parameters: `prefix (string)`
* Structure: `startsWith(prefix)`
* Examples:
  * `{{ phone.startsWith("+1") }}`

#### endsWith()

* Check if the current string value ends with the given suffix.
* Allowed Parameters: `suffix (string)`
* Structure: `endsWith(suffix)`
* Examples:
  * `{{ filename.endsWith(".pdf") }}`

#### replace()

* Replace all occurrences of a substring with a new substring.
* Allowed Parameters: `old (string), new (string)`
* Structure: `replace(old,new)`
* Examples:
  * `{{ text.replace("bad", "good") }}`

#### slugify()

* Convert the current string value into a slug (lowercase, hyphen-separated).
* Allowed Parameters: None
* Structure: `slugify()`
* Examples:
  * `{{ title.slugify() }}`

#### split()

* Split the current string value into a list using the given separator.
* Allowed Parameters: `sep (Any)`
* Structure: `split(sep)`
* Examples:
  * `{{ tags.split(",") }}`

#### substring()

* Extract a substring using start and optional end indices.
* Allowed Parameters: `start (int), end (int, optional)`
* Structure: `substring(start,end)`
* Examples:
  * `{{ "Elephant".substring(0, 3) }}`

#### toTitleCase()

* Convert the current string value to title case (capitalize each word).
* Allowed Parameters: None
* Structure: `toTitleCase()`
* Examples:
  * `{{ "john doe".toTitleCase() }}`

#### toNumber()

* Convert the current string value to a number.
* Allowed Parameters: None
* Structure: `toNumber()`
* Examples:
  * `{{ "42.5".toNumber() }}`

#### padStart()

* Pad the current string on the left until it reaches the given length.
* Allowed Parameters: `length (int), char (string, optional)`
* Structure: `padStart(length,char)`
* Examples:
  * `{{ "5".padStart(2, "0") }}`

#### padEnd()

* Pad the current string on the right until it reaches the given length.
* Allowed Parameters: `length (int), char (string, optional)`
* Structure: `padEnd(length,char)`
* Examples:
  * `{{ "5".padEnd(3, "0") }}`

#### parseJSON()

* Parse the current string value as JSON safely.
* Allowed Parameters: None
* Structure: `parseJSON()`
* Examples:
  * `{{ json_string.parseJSON() }}`

### Numeric Functions

#### add()

* Add a given number to the current value.
* Allowed Parameters: `number (Any)`
* Structure: `add(number)`
* Examples:
  * `{{ 10.add(5) }}`

#### subtract()

* Subtract a given number from the current value.
* Allowed Parameters: `number (Any)`
* Structure: `subtract(number)`
* Examples:
  * `{{ 20.subtract(5) }}`

#### increment()

* Increase the current numeric value by 1.
* Allowed Parameters: None
* Structure: `increment()`
* Examples:
  * `{{ count.increment() }}`

#### decrement()

* Decrease the current numeric value by 1.
* Allowed Parameters: None
* Structure: `decrement()`
* Examples:
  * `{{ count.decrement() }}`

#### round()

* Round the current float value to the specified decimal places.
* Allowed Parameters: `decimals (int, optional)`
* Structure: `round(decimals)`
* Examples:
  * `{{ 3.14159.round(2) }}`

#### toInteger()

* Convert the current float value to an integer.
* Allowed Parameters: `args (Any)`
* Structure: `toInteger(args)`
* Examples:
  * `{{ 9.99.toInteger() }}`

***

### List Functions

#### length()

* Get the number of items in the current list.
* Allowed Parameters: None
* Structure: `length()`
* Examples:
  * `{{ items.length() }}`

#### push()

* Append an item to the end of the current list.
* Allowed Parameters: `item (Any)`
* Structure: `push(item)`
* Examples:
  * `{{ cart.push("apple") }}`

#### prepend()

* Insert an item at the beginning of the current list.
* Allowed Parameters: `item (Any)`
* Structure: `prepend(item)`
* Examples:
  * `{{ history.prepend("new_event") }}`

#### pop()

* Remove the last item from the current list.
* Allowed Parameters: None
* Structure: `pop()`
* Examples:
  * `{{ stack.pop() }}`

#### removeAt()

* Remove the item at the specified index.
* Allowed Parameters: `index (int)`
* Structure: `removeAt(index)`
* Examples:
  * `{{ list.removeAt(0) }}`

#### extend()

* Extend the list by appending all items from another list.
* Allowed Parameters: `items (Any)`
* Structure: `extend(items)`
* Examples:
  * `{{ list_a.extend(list_b) }}`

#### unique()

* Remove duplicate items from the current list.
* Allowed Parameters: None
* Structure: `unique()`
* Examples:
  * `{{ categories.unique() }}`

#### join()

* Join all items in the list into a string.
* Allowed Parameters: `sep (Any)`
* Structure: `join(sep)`
* Examples:
  * `{{ words.join(" ") }}`

#### pluck()

* Extract values for a given key from each dictionary in the list.
* Allowed Parameters: `key (Any)`
* Structure: `pluck(key)`
* Examples:
  * `{{ users.pluck("id") }}`

#### filter()

* Filter items based on a condition (use 'element' as context).
* Allowed Parameters: `condition (string)`
* Structure: `filter(condition)`
* Examples:
  * `{{ numbers.filter("element > 10") }}`

***

### JSON Functions (Objects and Arrays)

#### setKey()

* Set a key in the JSON object to the given value.
* Allowed Parameters: `key (Any), value (Any)`
* Structure: `setKey(key,value)`
* Examples:
  * `{{ user.setKey("status", "active") }}`

#### removeKey()

* Remove a key from the JSON object.
* Allowed Parameters: `key (Any)`
* Structure: `removeKey(key)`
* Examples:
  * `{{ user.removeKey("password") }}`

#### merge()

* Merge another dictionary into the current object.
* Allowed Parameters: `obj (Any)`
* Structure: `merge(obj)`
* Examples:
  * `{{ settings.merge(default_settings) }}`

#### pick()

* Create a new object containing only the specified keys.
* Allowed Parameters: `keys (Any)`
* Structure: `pick(keys)`
* Examples:
  * `{{ profile.pick(["name", "email"]) }}`

***

### DateTime Functions

#### fromTimestamp()

* Convert a Unix timestamp into a UTC datetime value.
* Allowed Parameters: `ts (int)`
* Structure: `fromTimestamp(ts)`
* Examples:
  * `{{ 1704067200.fromTimestamp() }}`

#### toTimestamp()

* Convert the current datetime value into a Unix timestamp.
* Allowed Parameters: None
* Structure: `toTimestamp()`
* Examples:
  * `{{ now.toTimestamp() }}`

#### format()

* Format the datetime into a string with optional timezone.
* Allowed Parameters: `format (string, optional), tz (string, optional)`
* Structure: `format(format,tz)`
* Examples:
  * `{{ event.date.format("%Y-%m-%d", "UTC") }}`

#### addDays()

* Add a given number of days to the current datetime.
* Allowed Parameters: `number (int)`
* Structure: `addDays(number)`
* Examples:
  * `{{ today.addDays(7) }}`

#### subtractDays()

* Subtract a given number of days from the current datetime.
* Allowed Parameters: `number (int)`
* Structure: `subtractDays(number)`
* Examples:
  * `{{ today.subtractDays(1) }}`

#### addHours()

* Add a given number of hours to the current datetime.
* Allowed Parameters: number (int)
* Structure: addHours(number)
* Examples:
  * `{{ now.addHours(2) }}`

#### diffDays()

* Calculate the difference in days between two datetimes.
* Allowed Parameters: other (Any)
* Structure: `diffDays(other)`
* Examples:
  * `{{ deadline.diffDays(now) }}`

#### isAfter()

* Check if the current datetime is after another datetime.
* Allowed Parameters: other (Any)
* Structure: `isAfter(other)`
* Examples:
  * `{{ delivery_date.isAfter(order_date) }}`

#### isBefore()

* Check if the current datetime is before another datetime.
* Allowed Parameters: other (Any)
* Structure: `isBefore(other)`
* Examples:
  * `{{ start_date.isBefore(end_date) }}`

#### startOfDay()

* Set the datetime to 00:00:00.
* Allowed Parameters: None
* Structure: `startOfDay()`
* Examples:
  * `{{ now.startOfDay() }}`

#### endOfDay()

* Set the datetime to 23:59:59.999999.
* Allowed Parameters: None
* Structure: `endOfDay()`
* Examples:
  * `{{ now.endOfDay() }}`

#### getDate()

* Extract the date portion as an ISO string (YYYY-MM-DD).
* Allowed Parameters: None
* Structure: `getDate()`
* Examples:
  * `{{ event.getDate() }}`

#### getTime()

* Extract the time portion as an ISO string (HH:MM:SS).
* Allowed Parameters: None
* Structure: `getTime()`
* Examples:
  * `{{ now.getTime() }}`

#### toISO()

* Convert the datetime into an ISO 8601 string.
* Allowed Parameters: None
* Structure: `toISO()`
* Examples:
  * `{{ updated_at.toISO() }}`

#### toRFC2822()

* Convert the datetime into an RFC 2822 string.
* Allowed Parameters: None
* Structure: `toRFC2822()`
* Examples:
  * `{{ created_at.toRFC2822() }}`

### Utility Functions

#### fallback()

* Returns the specified fallback value if a runtime error occurs during execution.
* Allowed Parameters: Any (accepts fallback value in syntax)
* Structure: `fallback("Fallback Value")`
* Examples:
  * `{{ user.address.city.fallback("N/A") }}`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dckapintegrator.com/project-manager/workflows/inline-transformations/allowed-functions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.