> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Часто задаваемые вопросы о рабочих процессах

> Часто задаваемые вопросы о рабочих процессах в Twenty.

<AccordionGroup>
  <Accordion title="Почему я не могу активировать рабочий процесс?">
    Скорее всего, это проблема с правами доступа. Вам нужен доступ к рабочим процессам, чтобы создавать и активировать их.

    **Решение**: Свяжитесь с администратором рабочего пространства, чтобы он предоставил вам доступ к рабочим процессам в разделе **Настройки → Участники → Роли**.

    Если вы совсем не видите раздел "Рабочие процессы" в боковой панели, это подтверждает, что проблема в правах доступа.
  </Accordion>

  <Accordion title="Почему я не вижу кнопку ручного рабочего процесса в верхней панели навигации?">
    Ручные рабочие процессы отображаются в панели навигации только при правильной настройке:

    1. Рабочий процесс должен быть **активирован** (не в режиме черновика)
    2. Размещение в панели навигации должно быть установлено в значение **Pinned**
    3. Для триггеров Single/Bulk вы должны находиться на правильной странице объекта

    **Как проверить**: Откройте рабочий процесс → нажмите на триггер → убедитесь, что "Navbar placement" установлено в значение "Pinned".

    Вы всегда можете получить доступ к ручным рабочим процессам через **Cmd + K** (или **Ctrl + K**) независимо от настроек панели навигации.
  </Accordion>

  <Accordion title="В чем разница между ручными триггерами Single, Global и Bulk?">
    | Тип           | Требуемые записи             | Запуски рабочего процесса                  |
    | ------------- | ---------------------------- | ------------------------------------------ |
    | \| **Global** | Нет                          | Один раз, без входной записи               |
    | \| **Single** | Одна или несколько выбранных | По одному разу для каждой выбранной записи |
    | \| **Bulk**   | Одна или несколько выбранных | Один раз, со всеми записями в виде массива |

    * **Global**: Используйте, когда рабочему процессу не нужен контекст записи (например, для создания отчета)
    * **Single**: Используйте, когда нужно обрабатывать каждую выбранную запись независимо (например, отправлять отдельные письма)
    * **Bulk**: Используйте, когда нужно обрабатывать записи вместе или оптимизировать использование кредитов (требуется действие Iterator)

    См. [Триггеры рабочего процесса](/l/ru/user-guide/workflows/capabilities/workflow-triggers) для подробностей.
  </Accordion>

  <Accordion title="Я не вижу узла If/Else. Что мне делать?">
    Явный узел If/Else пока недоступен, но находится в нашем плане развития.

    **Текущее решение**: Создайте несколько веток от вашего шага, каждая начинается с действия **Filter**:

    ```
    Step 1
       │
       ├── Branch A: Filter (condition = true) → Actions...
       │
       └── Branch B: Filter (condition = false) → Actions...
    ```

    Только ветка, в которой условие фильтра выполняется, будет выполнять последующие действия.

    См. пошаговое руководство [Как использовать ветки](/l/ru/user-guide/workflows/capabilities/workflow-branches).
  </Accordion>

  <Accordion title="Ветки рабочего процесса выполняются параллельно?">
    **Да**, ветки по умолчанию выполняются параллельно.

    Если вы хотите, чтобы выполнялась только одна ветка:

    * Добавьте действие **Filter** в начало каждой ветки
    * Задайте противоположные условия (например, Ветка A: status = "Open", Ветка B: status ≠ "Open")

    Ветки, не прошедшие свое условие фильтра, прекращают выполнение, остальные продолжают.
  </Accordion>

  <Accordion title="Можно ли объединить ветки обратно?">
    **Да**. После завершения параллельных веток вы можете добавить шаг, к которому будут подключены обе ветки.

    В редакторе рабочего процесса:

    1. Завершите действия в ветках
    2. Добавьте новый шаг после веток
    3. Перетащите соединения с конца каждой ветки к этому новому шагу

    Объединенный шаг выполнится после завершения всех подключенных веток.
  </Accordion>

  <Accordion title="Каково ограничение на результаты Search Records?">
    **Search Records возвращает максимум 200 записей.**

    Если нужно обработать больше:

    * Добавьте более точные фильтры, чтобы сократить результаты
    * Используйте запланированные рабочие процессы для пакетной обработки
    * Рассмотрите использование API для массовых операций

    Для большинства рабочих процессов 200 записей достаточно. Если вы регулярно упираетесь в этот предел, подумайте о переработке вашей автоматизации.
  </Accordion>

  <Accordion title="Можно ли добавлять получателей в копию (CC) в письмах рабочего процесса?">
    **Пока нет.** Поля CC и BCC для действия Send Email в нашем плане развития.

    **Текущее решение**: Добавьте несколько действий Send Email, чтобы отправить дополнительным получателям, или используйте HTTP Request для отправки через внешний почтовый сервис, поддерживающий CC.
  </Accordion>

  <Accordion title="Как использовать выходные данные из предыдущих шагов?">
    Каждое действие формирует выходные данные, которые можно использовать в последующих шагах.

    **Как ссылаться на данные предыдущих шагов**:

    * Используйте выбор переменных при настройке поля
    * Или введите `{{stepName.fieldName}}` напрямую

    **Примеры**:

    * Данные триггера: `{{trigger.object.email}}`
    * Результаты поиска: `{{searchRecords[0].name}}`
    * Вывод кода: `{{code.calculatedValue}}`

    Наведите курсор на любое поле в настройках действия, чтобы увидеть доступные переменные из предыдущих шагов.
  </Accordion>

  <Accordion title="Почему Iterator завершается с ошибкой?">
    **Iterator требует массив на входе.** Частые проблемы:

    1. **Входные данные не являются массивом**: Убедитесь, что вы передаете результаты из Search Records или другого действия, возвращающего массив
    2. **Массив пуст**: Добавьте фильтр перед Iterator, чтобы проверить `{{searchRecords.length}} > 0`
    3. **Выбрана неверная переменная**: Убедитесь, что вы выбираете сам массив, а не одну запись

    **Правильная настройка**:

    1. Search Records (возвращает массив)
    2. Filter: length > 0
    3. Iterator: выберите `{{searchRecords}}`
    4. Действия внутри Iterator используют `{{iterator.currentItem.fieldName}}`
  </Accordion>

  <Accordion title="Каково максимальное время выполнения для действий Code?">
    Действия Code (функции бизнес-логики) имеют **тайм-аут по умолчанию в 5 минут** (300 секунд).

    Максимально настраиваемый тайм-аут — **15 минут** (900 секунд).

    Если ваш код превышает этот предел, действие завершится ошибкой тайм-аута.

    **Советы по предотвращению тайм-аутов**:

    * Разбейте большие операции на небольшие части с помощью Iterator
    * Избегайте тяжелых вычислений; используйте внешние сервисы через HTTP Request для ресурсоемкой обработки
    * Оптимизируйте ваш код, чтобы сократить время выполнения
    * Если требуется более длительная обработка, рассмотрите использование запланированных рабочих процессов, которые обрабатывают данные пакетами
  </Accordion>

  <Accordion title="Как понимать запуски рабочего процесса?">
    Запуски рабочего процесса показывают историю выполнения и помогают диагностировать проблемы.

    **Доступ к запускам**:

    * В редакторе рабочего процесса → панель **Запуски** справа
    * Или перейдите в **Запуски рабочего процесса** в боковой панели

    **Понимание запуска**:

    * **Статус**: Running, Completed, Failed, Waiting
    * **Шаги**: Просматривайте, какие шаги выполнились и их вывод
    * **Ошибки**: Нажмите на шаги с ошибкой, чтобы увидеть сообщения об ошибках
    * **Данные**: Просматривайте входные/выходные данные на каждом шаге

    См. [Запуски рабочего процесса](/l/ru/user-guide/workflows/capabilities/workflow-runs) для подробностей.
  </Accordion>

  <Accordion title="Почему я не вижу свои запуски рабочего процесса?">
    Запуски рабочего процесса могут сразу завершаться с ошибкой из-за ограничений скорости.

    **Жесткий лимит: 5 000 запусков в час на рабочее пространство.**

    Если вы превышаете этот лимит, рабочие процессы сразу помечаются как завершившиеся с ошибкой и не появляются в списке запусков, как можно было бы ожидать.

    **Распространенные сценарии, при которых достигается этот лимит**:

    * Выбор более 5 000 записей с ручным триггером Single
    * Одновременная работа нескольких рабочих процессов в вашем рабочем пространстве
    * Высокочастотные автоматические триггеры (например, Record Updated на загруженном объекте)

    **Решения**:

    * Используйте триггеры **Bulk** вместо Single, чтобы обработать много записей за один запуск
    * Разнесите во времени крупные пакетные операции
    * Используйте фильтры, чтобы снизить частоту срабатываний
    * Запускайте «тяжелые» рабочие процессы в часы низкой нагрузки
  </Accordion>

  <Accordion title="Каковы ограничения скорости для рабочих процессов?">
    В Twenty есть два лимита скорости для обеспечения стабильности системы:

    | Лимит                | Значение           | Поведение                                                                       |
    | -------------------- | ------------------ | ------------------------------------------------------------------------------- |
    | \| **Мягкий лимит**  | 100 запусков/мин   | Запуски ставятся в очередь со статусом "Not Started", обрабатываются постепенно |
    | \| **Жесткий лимит** | 5 000 запусков/час | Запуски сразу завершаются с ошибкой                                             |

    **Мягкий лимит (100/мин)**: Ваши рабочие процессы не будут завершаться с ошибкой — они просто ждут в очереди и обрабатываются со временем. Вы можете запускать более 100 записей; выполнение будет медленнее.

    **Жесткий лимит (5 000/ч)**: Он применяется ко всему вашему рабочему пространству. Если суммарно все ваши рабочие процессы превышают 5 000 запусков за час, дополнительные запуски сразу завершатся с ошибкой.

    **Советы, чтобы не выходить за пределы лимитов**:

    * Используйте триггеры Bulk с Iterator вместо Single для больших пакетов
    * Объединяйте связанные автоматизации в меньшее количество рабочих процессов
    * Используйте запланированные рабочие процессы, чтобы распределить нагрузку во времени
  </Accordion>

  <Accordion title="Можно ли повторно запустить неудавшийся запуск рабочего процесса?">
    **Нет, в настоящий момент нет функции автоматического повтора.**

    Если запуск рабочего процесса завершился с ошибкой, вам нужно:

    1. Просмотрите ошибку в **Настройки → Рабочие процессы → \[Ваш рабочий процесс] → Запуски**
    2. Исправьте проблему (данные, конфигурация или внешний сервис)
    3. Повторно запустите рабочий процесс вручную для затронутой записи (записей)

    **Советы по снижению количества ошибок**:

    * Добавьте узлы **Filter** для проверки данных перед действиями
    * Используйте **Search Records**, чтобы проверить, существуют ли связанные записи
    * Тщательно протестируйте на нескольких записях перед массовыми операциями

    Функция автоматического повтора находится в нашем плане развития для будущего релиза.
  </Accordion>

  <Accordion title="Нужно ли деактивировать рабочие процессы перед импортом CSV?">
    **Да, если ваши рабочие процессы запускаются при создании или обновлении записей.**

    При импорте данных через CSV каждая созданная или обновленная запись может запускать рабочие процессы. Крупный импорт (тысячи записей) может:

    * Достигнуть лимита 5 000 запусков/час
    * Потреблять значительное количество кредитов рабочего процесса
    * Отправить неожиданные письма или уведомления
    * Создать дублирующиеся задачи или записи

    **Перед массовым импортом**:

    1. Перейдите в **Настройки → Рабочие процессы**
    2. Определите рабочие процессы, запускаемые объектом, который вы импортируете
    3. **Деактивируйте** их временно
    4. Выполните импорт CSV
    5. **Повторно активируйте** рабочие процессы по завершении

    **Альтернатива**: Если вам нужно, чтобы рабочие процессы запускались на импортируемых данных, импортируйте небольшими партиями, чтобы укладываться в лимиты скорости.
  </Accordion>

  <Accordion title="Как привести в порядок схему моего рабочего процесса?">
    Если ваше полотно рабочего процесса выглядит беспорядочно, с разбросанными узлами, вы можете автоматически упорядочить его:

    1. Щелкните правой кнопкой мыши в любом месте полотна рабочего процесса
    2. Нажмите **Упорядочить рабочий процесс**

    Это автоматически переупорядочит все узлы в чистое, упорядоченное расположение.
  </Accordion>
</AccordionGroup>