> For the complete documentation index, see [llms.txt](https://docs.blynk.io/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blynk.io/en/blynk.console/templates/datastreams/enumerable.md).

# Enumerable

This Datastream specific fields INCOMING and OUTCOME allow to transform integer data to string.

![](/files/-MS3M6Y7FX-xGOwEKXdE)

Example:\
Device has sets of three positions: Open, Vent, Closed. In means of servo they are: 130, 20 and 0\
This Datastream allows you to link these values: 130=Open, 20=Vent, 0=Closed\
So each time servo reaches any of those positions you'll get a readable state result instead of degrees.\
\
Follow these steps to create value translation:

1. click **add row**
2. set integer value than can be sent by your Device in **INCOMING** field
3. in **OUTCOME** type string value that will be used/viewed instead of original integer value
4. you can assign a color to this conversion
5. click **add row** to set further conversion values

![](/files/-MSh4nL9gvnfPXwD_g5k)

{% hint style="info" %}
Suppose the device sends a value that is not within the specified range of options for the Enumerable datastream. In that case, the cloud will set the datastream's value to the specified Fallback value. This ensures that the datastream maintains a valid state even if unexpected or erroneous data is received from the device.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.blynk.io/en/blynk.console/templates/datastreams/enumerable.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.