Средство проверки потока

Оптимизируйте рабочий процесс разработки с помощью функции статического анализа в средстве проверки решений. Этот инструмент поддерживает рекомендации по роботизированной автоматизации процессов (RPA) и удовлетворяет критические требования к потокам, автоматически оценивая потоки для обеспечения оптимальной производительности. Статический анализ доступен в разделе Средство проверки потоков конструктора. Он обеспечивает соблюдение ключевых рекомендаций и предоставляет обратную связь в режиме реального времени и раннюю проверку кода. Он интегрируется непосредственно в рабочий процесс, повышает качество кода и закладывает основу для более эффективной и продуктивной разработки.

Управление правилами

Определите правила с помощью средства проверки решения в Центре администрирования Power Platform и конфигурации средства проверки потока на портале Power Automate.

Администраторы и пользователи с соответствующими разрешениями могут:

• Включите или отключите правила.
• Настройте уровни серьезности (ошибка, предупреждение, информация).
• Настройте пользовательские значения для правил, поддерживающих параметры, такие как пороговые значения и ограничения (только портал Power Automate).
• Применение правил к определенным средам или группам среды (только управляемые среды, Центр администрирования Power Platform).

Конфигурация средства проверки потока применяется на уровне среды и влияет на все потоки рабочего стола в выбранной среде.

Параметры применения средства проверки решений, настроенные в Центре администрирования Power Platform, имеют приоритет над параметрами конфигурации средства проверки потока на портале Power Automate. Нельзя изменять правила, на которые распространяются ограничения, применяемые через Solution checker на портале Power Automate.

Настройка в центре администрирования

Чтобы настроить правила статического анализа:

1. Перейдите в центр администрирования Power Platform.
2. Выберите Управление>Среды, чтобы продолжить.
3. Выберите Изменить управляемые среды.
4. В разделе Принудительное применение средства проверки решения укажите, какие правила должны быть исключены для выбранной среды.

Настройка на портале Power Automate

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

1. Перейдите на страницу Потоки рабочего стола на портале Power Automate.

2. Выберите средство проверки потока.

3. В области конфигурации средства проверки потока настройте требуемые правила. Для каждого правила можно:

   • Включите или отключите правило.
   • Выберите уровень серьезности.
   • Укажите настраиваемое значение для правил, поддерживающих параметры.

4. Нажмите Сохранить.

Изменения конфигурации применяются на уровне среды и влияют на все потоки рабочего стола в выбранной среде. Для потоков рабочего стола, которые уже открыты в конструкторе, повторно откройте поток рабочего стола, чтобы изменения конфигурации вступили в силу.

Запуск статического анализа на портале

Чтобы запустить статический анализ вручную, выполните следующие действия:

1. Перейдите на страницу Решения на портале Power Automate.

2. Откройте контекстное меню (⋯) рядом с решением.

3. Наведите указатель на Средство проверки решений.

4. Выберите один из следующих параметров:

   • Выполнить: инициирует статический анализ.
   • Просмотреть результаты: открывает последний отчет о анализе.
   • Загрузить результаты: экспортирует отчет для автономной проверки.

Статический анализ в конструкторе

Статический анализ запускается автоматически, непрерывно проверяя ваш код, не требуя ручного вмешательства. Когда вы добавляете, удаляете или изменяете действия в потоке, эта функция активируется для оценки изменений и обновления анализа. Этот процесс делает разработку плавной и эффективной. В правой части конструктора отображается отдельная кнопка "Средство проверки потоков". Число на кнопке показывает общее количество нарушений в классическом потоке. Нажмите кнопку, чтобы открыть область Средство проверки потоков и просмотреть подробные сведения о конкретных правилах, которые были нарушены.

Каждый анализ генерирует процентную оценку, которая показывает долю успешно выполненных правил. Чем выше оценка, тем меньше нарушений и лучше качество кода.

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

Если правила нарушены, отчет о статическом анализе показывает четкую сводку. В нем перечислены имена правил и количество действий или переменных в потоке, которые нарушают каждое правило. При выборе правила выделяется соответствующее действие и предоставляется подробное объяснение ошибки. В случае нарушений, связанных с переменными, система переходит на панель переменных, что упрощает исправление. Область "Средство проверки потоков" содержит функцию поиска и позволяет фильтровать по подпотокам, чтобы вы могли быстро находить конкретные проблемы.

Каждое нарушение отображается на плитке с подробными сведениями, включая характер ошибки, рекомендуемые исправления и ссылку на документацию. Используйте ползунок в заголовке правила для перехода между случаями одного и того же нарушения. Это руководство помогает разработчикам быстро и эффективно решать проблемы. Ошибки, обнаруженные средством проверки потока, отображаются с помощью встроенного индикатора и всплывающего окна с более подробными сведениями. Предупреждения, как и ошибки, также отображаются непосредственно в рабочей области конструктора. В конструкторе на вкладках подпотоков отображаются диагностические состояния, например предупреждения и ошибки, а также доступна кнопка для перехода к компоненту, требующему внимания.

Условные обозначения

1. Случаи нарушения конкретного правила
2. Перейдите к действию, которое нарушает правило.
3. Ссылка на документацию

Правила статического анализа

Правила статического анализа — это предопределенные рекомендации, которые помогают обеспечить безопасность, удобство обслуживания и производительность потоков. Каждое правило нацелено на определенные аспекты проектирования потока, такие как безопасность, производительность и удобство обслуживания, и предоставляет полезную обратную связь для улучшения качества потока. Ниже приведен список правил, их описание и предлагаемые исправления.

Недостаточная безопасность паролей

• Серьезность: Предупреждение
• Тип: Безопасность
• Сведения об ошибке: Управление паролями в потоке осуществляется небезопасным образом.
• Описание: Это правило проверяет, небезопасно ли управляются пароли в настольном потоке, чтобы гарантировать, что они не будут раскрыты или обработаны ненадлежащим образом во время выполнения.
• Предлагаемое исправление: Убедитесь, что все входные данные, связанные с паролем, обрабатываются должным образом с помощью функций пароля в Power Automate для компьютеров. Используйте «Прямой зашифрованный ввод текста» для максимальной безопасности благодаря машинному шифрованию. Для потоков, используемых на разных компьютерах, выберите "Ввод пароля как переменная" и пометьте соответствующую переменную как конфиденциальную для повышения безопасности. Кроме того, используйте безопасные функции управления учетными данными, такие как действие "Получить учетные данные", которое интегрируется с учетными данными CyberArk.

Рекурсия между двумя подпотоками

• Серьезность: Предупреждение
• Тип: Разработка
• Сведения об ошибке: Обнаружены рекурсивные вызовы между подпотоками, потенциально способные вызвать бесконечный цикл.
• Описание: Это правило проверяет поток на наличие рекурсивных вызовов между двумя или более подпотоками, чтобы гарантировать, что поток не войдет в бесконечный цикл.
• Предлагаемое исправление: Устраните рекурсивные вызовы между подпотоками.

Превышение лимита длины имен переменных

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: Длина имени переменной превышает 40-символьный лимит.
• Описание: Это правило проверяет, не превышает ли длина имени определенных в потоке переменных заданный лимит. По умолчанию он составляет 40 символов.
• Предлагаемое исправление: Переименуйте все переменные, длина имен которых превышает лимит, так, чтобы она не превышала 40 символов.

Значения по умолчанию входных переменных

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: У входных/выходных переменных нет значений по умолчанию.
• Описание: Это правило проверяет, есть ли у входных/выходных переменных потока значения по умолчанию, чтобы гарантировать, что они настроены надлежащим образом.
• Предлагаемое исправление: Назначьте всем входным и выходным переменным в потоке значения по умолчанию.

Лимит количества входных и выходных переменных

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: Общее количество входных/выходных переменных превышает лимит в 25 переменных.
• Описание: Это правило проверяет, не превышает ли общее количество входных/выходных переменных в потоке заданный лимит. По умолчанию он составляет 25 переменных.
• Предлагаемое исправление: Убедитесь, что количество входных и выходных переменных в потоке не превышает 25.

Пустое действие "Ошибка в блоке"

• Серьезность по умолчанию: Предупреждение
• Тип: Разработка
• Сведения об ошибке: действие "Ошибка в блоке" пусто и не обрабатывает ошибки.
• Описание: это правило проверяет, правильно ли настроены действия "Ошибка в блоке" в потоке для обработки ошибок, чтобы убедиться, что ошибки создаются и обрабатываются должным образом.
• Предлагаемое исправление: для обработки потенциальных ошибок настройте в потоке действия Ошибка в блоке.

Вложенные инструкции if

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: Уровень вложенности инструкций If превышает пять уровней.
• Описание: Это правило проверяет, есть ли вложенные инструкции if с уровнем вложенности более пяти, чтобы ход выполнения оставался управляемым и читаемым.
• Предлагаемое исправление: Выполните рефакторинг потока и уменьшите глубину вложенности операторов if так, чтобы она не превышала пяти уровней.

Неполное, если

• Серьезность: Предупреждение
• Тип: Разработка
• Сведения об ошибке: Обнаружено неполное действие if (без содержимого или содержащее действия только в ветви else).
• Описание: это правило обнаруживает наличие действий if, в которых отсутствует содержимое или которые содержат действия только в ветви else, чтобы гарантировать эффективную реализацию условных выражений.
• Предлагаемое исправление: просмотрите поток и проверьте каждое условие if, чтобы убедиться, что оно содержит значимые действия в ветвях if, else if и else.

Бесконечный цикл

• Серьезность: Предупреждение
• Тип: Разработка
• Сведения об ошибке: В потоке обнаружен бесконечный цикл, из-за которого он может выполняться бесконечно.
• Описание: Это правило проверяет поток на наличие бесконечных циклов, что позволяет выявить и предотвратить сценарии, в которых поток будет выполняться бесконечно.
• Предлагаемое исправление: Убедитесь, что каждый цикл имеет четко определенное и достижимое условие завершения. Условие может быть основано на счетчике, конкретном значении или выполнении задачи. Добавьте проверки или отказоустойчивые условия, чтобы прервать цикл, если он выполняется дольше, чем ожидалось. Например, задайте максимальное количество итераций или включите время ожидания.

Злоупотребление действиями ожидания

• Серьезность: Предупреждение
• Тип: Производительность
• Подробности ошибки: Обнаружено некорректное использование действий ожидания: более 10 действий ожидания могут вызывать потенциальные узкие места.
• Описание: это правило проверяет, не содержит ли поток чрезмерное количество действий ожидания (более 10), чтобы выявить и свести к минимуму потенциальные узкие места, вызванные длительными задержками.
• Предлагаемое решение: проверьте поток, чтобы определить все действия ожидания и проверить, важны ли они для логики потока. Устраните ненужные ожидания или объедините их там, где это возможно.

Чрезмерное время ожидания

• Серьезность: Предупреждение
• Тип: Производительность
• Сведения об ошибке: Обнаружено чрезмерное время ожидания, превышающее 600-секундный лимит для жестко закодированных действий ожидания.
• Описание: Это правило проверяет, не превышают ли жестко запрограммированные действия ожидания в потоке определенное время. Лимит времени составляет 600 секунд.
• Предлагаемое исправление: просмотрите поток, чтобы найти действия ожидания, превышающие ограничение в 600 секунд. Проверьте, необходимы ли эти длительные периоды ожидания, и установите их продолжительность на минимальное время, необходимое для правильной работы потока. Если требуется длительное ожидание, разбейте его на более короткие интервалы и добавьте между ними проверки или условия. По возможности заменяйте действия длительного ожидания триггерами, управляемыми событиями.

Недостигнутые действия

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: одно или несколько действий в потоке недостижимы и не будут выполнены ни при каких обстоятельствах.
• Описание: это правило проверяет действия в потоке, которые логически недостижимы. Недостижимые действия могут быть результатом неправильного ветвления, неправильных условий или несвязанных сегментов, а также могут указывать на недостатки в логике или структуре потока.
• Предлагаемое исправление: просмотрите поток, чтобы найти действия, которые не связаны с путем выполнения. Убедитесь, что каждое действие достижимо через допустимую логическую ветвь или цикл. Удалите или переместите недоступные действия, чтобы рабочий процесс оставался понятным и эффективным.

Не требуется подпоток

• Серьезность: Предупреждение
• Тип: удобство поддержки
• Сведения об ошибке: правило обнаружило подпоток, который либо не содержит действий, содержит только отключённые действия или содержит слишком мало действий, чтобы оправдать его выделение. Такие подпотоки могут не вносить существенного вклада в выполнение потока и снижать понятность.
• Описание: это правило проверяет подпотоки, которые либо пусты, либо слишком коротки, как правило, содержат менее 5 действий. Хотя подпотоки полезны для обеспечения модульности и повторного использования, те из них, которые не содержат осмысленного наполнения или не обеспечивают нужного уровня абстракции, могут указывать на незавершённую разработку, ненужную фрагментацию или неправильную настройку. Эти шаблоны могут привести к путанице и препятствовать поддержанию.
• Предлагаемое исправление: Просмотрите указанный подпоток, чтобы определить, имеет ли он ясное и практическое назначение. Если это не так, попробуйте удалить его или объединить его в связанный блок логики. Если подпоток предназначен для использования в будущем, добавьте действие-заполнитель, чтобы уточнить его назначение и предотвратить неправильное понимание.

Известные ограничения

• Доступно только в управляемых средах.
• Настройка правил ограничивается включением или отключением правил и настройкой уровня серьезности.

Известные проблемы

• Удаление скопированных действий после просмотра сведений о нарушении правил может привести к возникновению необработанных ошибок.
• Использование неконфиденциальной переменной пароля в следующих действиях приводит к сбою статического анализа при оценке правила.
  • Показать диалог ввода
  • Отобразить диалог выбора папки
  • Отобразить настраиваемую форму