---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/support/tasks-requester/ru/template-builder/reference/helper.transform.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tasks-requester/ru/llms.txt

# helper.transform

Создает новый массив, преобразуя каждый из элементов исходного массива.

Например, можно преобразовать массив ссылок на изображения в компоненты [view.image](https://yandex.ru/support/tasks-requester/ru/template-builder/reference/view.image.md), чтобы отобразить эти изображения. Это может пригодиться, если количество изображений в массиве заранее неизвестно.

[<svg xmlns="http://www.w3.org/2000/svg" width="168" height="36" fill="none" viewBox="0 0 168 36"><path fill="#E6E6E6" d="M0 8a8 8 0 0 1 8-8h152a8 8 0 0 1 8 8v20a8 8 0 0 1-8 8H8a8 8 0 0 1-8-8V8Z"/><path fill="#000" d="M17.553 12.962h7.854V23h-1.708v-8.568h-4.452V23h-1.694V12.962ZM30.529 23.14a3.96 3.96 0 0 1-1.428-.252 3.344 3.344 0 0 1-1.148-.728 3.605 3.605 0 0 1-.756-1.19c-.178-.467-.266-1.003-.266-1.61 0-.607.088-1.143.266-1.61.186-.467.438-.859.756-1.176.326-.327.71-.57 1.148-.728a3.96 3.96 0 0 1 1.428-.252c.513 0 .99.084 1.428.252a3.09 3.09 0 0 1 1.148.728c.326.317.583.71.77 1.176.186.467.28 1.003.28 1.61 0 .607-.094 1.143-.28 1.61a3.495 3.495 0 0 1-.77 1.19c-.327.317-.71.56-1.148.728a3.96 3.96 0 0 1-1.428.252Zm0-1.358c.56 0 1.022-.196 1.386-.588.373-.392.56-1.003.56-1.834 0-.821-.187-1.428-.56-1.82-.364-.401-.826-.602-1.386-.602-.55 0-1.013.2-1.386.602-.364.392-.546.999-.546 1.82 0 .83.182 1.442.546 1.834.373.392.835.588 1.386.588Zm8.33 1.358a4.65 4.65 0 0 1-1.581-.252 3.433 3.433 0 0 1-1.19-.742 3.33 3.33 0 0 1-.757-1.19c-.177-.467-.266-.999-.266-1.596 0-.588.09-1.115.267-1.582a3.162 3.162 0 0 1 1.96-1.918 4.544 4.544 0 0 1 1.596-.266 4.6 4.6 0 0 1 1.316.168c.382.112.685.252.91.42v1.344a3.68 3.68 0 0 0-.953-.434 4.036 4.036 0 0 0-1.175-.154c-1.503 0-2.255.807-2.255 2.422 0 1.615.738 2.422 2.212 2.422.477 0 .883-.051 1.218-.154a4.9 4.9 0 0 0 .953-.42v1.344a3.945 3.945 0 0 1-.91.42c-.364.112-.813.168-1.345.168Zm10.568-5.404L47.285 22.3h-1.19l-2.016-4.606V23h-1.47v-7.266h2.226l1.988 4.508 2.1-4.508h2.128V23h-1.624v-5.264Zm6.6 5.404a3.96 3.96 0 0 1-1.428-.252 3.345 3.345 0 0 1-1.148-.728 3.608 3.608 0 0 1-.756-1.19c-.178-.467-.266-1.003-.266-1.61 0-.607.088-1.143.266-1.61a3.45 3.45 0 0 1 .756-1.176 3.09 3.09 0 0 1 1.148-.728 3.96 3.96 0 0 1 1.428-.252c.513 0 .99.084 1.428.252a3.09 3.09 0 0 1 1.148.728c.326.317.583.71.77 1.176.187.467.28 1.003.28 1.61 0 .607-.093 1.143-.28 1.61a3.494 3.494 0 0 1-.77 1.19c-.327.317-.71.56-1.148.728a3.96 3.96 0 0 1-1.428.252Zm0-1.358c.56 0 1.022-.196 1.386-.588.373-.392.56-1.003.56-1.834 0-.821-.187-1.428-.56-1.82-.364-.401-.826-.602-1.386-.602-.55 0-1.013.2-1.386.602-.364.392-.546.999-.546 1.82 0 .83.182 1.442.546 1.834.373.392.835.588 1.386.588Zm8.055-4.732V23h-1.624v-5.95H60.26v-1.316h6.062v1.316h-2.24Zm7.482 6.09c-.55 0-1.026-.121-1.428-.364a2.904 2.904 0 0 1-.952-1.008v3.71H67.56v-9.744h1.484l.112 1.288c.243-.439.565-.784.966-1.036.402-.261.892-.392 1.47-.392.43 0 .836.08 1.218.238.392.15.733.383 1.022.7.29.308.518.7.686 1.176.178.467.266 1.017.266 1.652 0 .644-.088 1.204-.266 1.68a3.34 3.34 0 0 1-.7 1.176c-.289.308-.63.541-1.022.7-.392.15-.802.224-1.232.224Zm-.392-1.358c.58 0 1.046-.196 1.4-.588.364-.401.546-1.013.546-1.834 0-.812-.182-1.419-.546-1.82-.354-.401-.816-.602-1.386-.602-.289 0-.555.051-.798.154a1.678 1.678 0 0 0-.644.448 2.253 2.253 0 0 0-.42.77 3.232 3.232 0 0 0-.154 1.05c0 .41.052.77.154 1.078.103.299.243.55.42.756.178.196.388.345.63.448.252.093.518.14.798.14Zm11.064.686c-.103.065-.229.14-.378.224-.15.075-.327.145-.532.21a5.407 5.407 0 0 1-1.638.238c-1.335 0-2.333-.331-2.996-.994-.653-.663-.98-1.591-.98-2.786 0-.588.089-1.115.266-1.582.177-.467.425-.859.742-1.176a3.11 3.11 0 0 1 1.134-.742c.439-.177.92-.266 1.442-.266.541 0 1.027.089 1.456.266.439.177.798.443 1.078.798.28.355.471.793.574 1.316.112.523.117 1.134.014 1.834h-5.026c.065.663.285 1.162.658 1.498.373.327.957.49 1.75.49.579 0 1.06-.07 1.442-.21a6.69 6.69 0 0 0 .994-.462v1.344Zm-2.94-5.586c-.476 0-.877.145-1.204.434-.327.29-.541.719-.644 1.288h3.416c.019-.588-.112-1.022-.392-1.302s-.672-.42-1.176-.42Zm7.782.168V23h-1.624v-5.95h-2.198v-1.316h6.062v1.316h-2.24Zm9.33 3.444c0 .42-.079.789-.237 1.106-.15.317-.36.579-.63.784-.271.205-.593.36-.966.462a4.637 4.637 0 0 1-1.233.154h-2.8v-7.266h1.624v2.352h1.219c.951 0 1.694.196 2.225.588.532.392.799.999.799 1.82Zm-4.242-1.12v2.352h1.05c.449 0 .813-.089 1.093-.266.28-.187.42-.49.42-.91 0-.42-.126-.719-.379-.896-.251-.187-.615-.28-1.091-.28h-1.093Zm8.644-3.64h6.174V23h-1.624v-5.95h-2.926V23h-1.624v-7.266Zm12.002 7.406c-.55 0-1.026-.121-1.428-.364a2.906 2.906 0 0 1-.952-1.008v3.71h-1.624v-9.744h1.484l.112 1.288c.243-.439.565-.784.966-1.036.402-.261.892-.392 1.47-.392.43 0 .836.08 1.218.238.392.15.733.383 1.022.7.29.308.518.7.686 1.176.178.467.266 1.017.266 1.652 0 .644-.088 1.204-.266 1.68a3.335 3.335 0 0 1-.7 1.176c-.289.308-.63.541-1.022.7a3.43 3.43 0 0 1-1.232.224Zm-.392-1.358c.579 0 1.046-.196 1.4-.588.364-.401.546-1.013.546-1.834 0-.812-.182-1.419-.546-1.82-.354-.401-.816-.602-1.386-.602a2.03 2.03 0 0 0-.798.154 1.686 1.686 0 0 0-.644.448 2.263 2.263 0 0 0-.42.77 3.251 3.251 0 0 0-.154 1.05c0 .41.052.77.154 1.078.103.299.243.55.42.756.178.196.388.345.63.448.252.093.518.14.798.14Zm6.598-.98 3.36-5.068h1.596V23h-1.61v-5.04L119.032 23h-1.624v-7.266h1.61v5.068Zm13.603-3.066-2.142 4.564h-1.19l-2.016-4.606V23h-1.47v-7.266h2.226l1.988 4.508 2.1-4.508h2.128V23h-1.624v-5.264Zm9.525 4.732a8.68 8.68 0 0 1-.378.224 3.711 3.711 0 0 1-.532.21 5.384 5.384 0 0 1-1.638.238c-1.335 0-2.333-.331-2.996-.994-.653-.663-.98-1.591-.98-2.786 0-.588.089-1.115.266-1.582.177-.467.425-.859.742-1.176a3.104 3.104 0 0 1 1.134-.742 3.813 3.813 0 0 1 1.442-.266c.541 0 1.027.089 1.456.266.439.177.798.443 1.078.798.28.355.471.793.574 1.316.112.523.117 1.134.014 1.834h-5.026c.065.663.285 1.162.658 1.498.373.327.957.49 1.75.49.579 0 1.059-.07 1.442-.21.392-.15.723-.303.994-.462v1.344Zm-2.94-5.586c-.476 0-.877.145-1.204.434-.327.29-.541.719-.644 1.288h3.416c.019-.588-.112-1.022-.392-1.302s-.672-.42-1.176-.42Zm8.634 6.258c-.551 0-1.027-.121-1.428-.364a2.897 2.897 0 0 1-.952-1.008v3.71h-1.624v-9.744h1.484l.112 1.288c.242-.439.564-.784.966-1.036.401-.261.891-.392 1.47-.392.429 0 .835.08 1.218.238.392.15.732.383 1.022.7.289.308.518.7.686 1.176.177.467.266 1.017.266 1.652 0 .644-.089 1.204-.266 1.68a3.35 3.35 0 0 1-.7 1.176c-.29.308-.63.541-1.022.7-.392.15-.803.224-1.232.224Zm-.392-1.358c.578 0 1.045-.196 1.4-.588.364-.401.546-1.013.546-1.834 0-.812-.182-1.419-.546-1.82-.355-.401-.817-.602-1.386-.602-.29 0-.556.051-.798.154a1.67 1.67 0 0 0-.644.448 2.23 2.23 0 0 0-.42.77 3.224 3.224 0 0 0-.154 1.05c0 .41.051.77.154 1.078.102.299.242.55.42.756.177.196.387.345.63.448.252.093.518.14.798.14Z"/></svg>](https://ya.cc/t/sjyWXYxE3YEtWG)

{% cut "Компоненты, которые используются в примере" %}

<!-- source: ru/template-builder/_includes/reference/not-dot/view.list.md -->
* [view.list](https://yandex.ru/support/tasks-requester/ru/template-builder/reference/view.list.md)&nbsp;— отображает данные списком;
<!-- endsource: ru/template-builder/_includes/reference/not-dot/view.list.md -->

<!-- source: ru/template-builder/_includes/reference/not-dot/data.input.md -->
* [data.input](https://yandex.ru/support/tasks-requester/ru/template-builder/operations/work-with-data.md)&nbsp;— передает входные данные задания;
<!-- endsource: ru/template-builder/_includes/reference/not-dot/data.input.md -->

<!-- source: ru/template-builder/_includes/reference/not-dot/view.image.md -->
* [view.image](https://yandex.ru/support/tasks-requester/ru/template-builder/reference/view.image.md)&nbsp;— показывает картинку;
<!-- endsource: ru/template-builder/_includes/reference/not-dot/view.image.md -->

<!-- source: ru/template-builder/_includes/reference/dot/data.local.dot.md -->
* [data.local](https://yandex.ru/support/tasks-requester/ru/template-builder/operations/work-with-data.md)&nbsp;— преобразует массив в указанный формат;
<!-- endsource: ru/template-builder/_includes/reference/dot/data.local.dot.md -->

{% endcut %}

## Свойства компонента {#properties}

#|
|| **Название** | **Тип** | **Описание** ||
|| `type`<span style="color: red">\*</span> | "helper.transform" | Задает тип компонента. ||
|| `into` | _any_ | Шаблон для преобразования элементов массива. Значение массива можно подставить с помощью компонента `data.local`. Для этого используйте конструкцию `{ "type": "data.local", "path": "item"}`. [Подробнее](https://yandex.ru/support/tasks-requester/ru/template-builder/operations/work-with-data.md). ||
|| `items` | _array_ | Массив, который необходимо преобразовать. Вы можете указать массив тремя способами:

- указать сам массив, например `["one", "two", "three"]`.
- подставить ссылку на данные (входные, выходные или внутренние), например `{ "type": "data.input", "path": "path.to.data"}`.
- Использовать ссылку на другой элемент конфигурации, например `{"$ref": "vars.myarray"}`.
  ||
  || `items[]` | _any_ | Элемент массива. Это может быть любой элемент — строки, числа, JSON-объекты или другие массивы.

Если вы использовали ссылку на поле со входными данными, то дополнительно указывать элемент не надо. ||
|#
