# Integer to UUID

## Description

This operation takes an integer value and converts it to a standard UUID format. The integer must be within the valid range for UUIDs (`0` to `2^128 - 1`).

UUIDs are 128-bit identifiers that are generated to be unique, typically represented as 32 hexadecimal digits, displayed in 5 groups separated by hyphens.

***

## Data types

These are the input/output expected data types for this operation:

### Input data

<img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F6GuAnpV6Z0PLg1eBmANb%2Fimage.png?alt=media&#x26;token=65feda0c-8dc9-44af-87f3-ec0fc3b2090a" alt="" data-size="line"> - String representing the integer value to be converted into UUID format.&#x20;

Note that integers must be within the valid range for UUIDs (`0` to `2^128 - 1`). You must provide values as strings in order to handle large values.

### Output data

<img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FUAfIIacPcQhMREihQ918%2Fimage.png?alt=media&#x26;token=d1a3c98b-14a7-41d8-9b16-5c5fafbc4b3c" alt="" data-size="line"> - Representation of the input integer value in standard UUID format (`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`).&#x20;

Output UUID values will be always in lowercase hexadecimal characters and padded with leading zeros to keep 32 hex characters.

***

## Example

Suppose you want to **transform** a series of **integer values** into their corresponding **UUID** identifiers. To do it:

1. In your Pipeline, open the required [Action](https://docs.onum.com/the-workspace/pipelines/actions) configuration and select the input **Field**.
2. In the **Operation** field, choose **Integer to UUID**.
3. Give your **Output field** a name and click **Save**. The values in your input field will be transformed. For example:

```
Input data - "20583658"

Output data - "00000000-0000-0000-0000-0000013a14ea"
```

{% hint style="info" %}
You can try out operations with specific values using the **Input** field above the operation. You can enter the value in the example above and check the result in the **Output** field.
{% endhint %}
