Средство проверки потоков (предварительная версия)

[Данная статья посвящена предварительному выпуску и может быть изменена.]

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

Внимание!

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

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

Правила определяются и контролируются с помощью средства проверки решений в центре администрирования Power Platform. Администраторы могут:

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

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

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

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

Примечание.

• Если среда входит в группу сред с определенной конфигурацией, параметры правила наследуются и не могут быть изменены по отдельности. Дополнительные сведения о средстве проверки решений см. в разделах Средство проверки решений и Принудительное применение средства проверки решений в управляемых средах.
• Администраторы Power Platform должны назначить следующие привилегии всем ролям, которым требуется доступ к этой функции: prvReadmsdyn_analysisoverride (понятное имя — «Переопределение анализа (чтение)»).

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Неполное действие if

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

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

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

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

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

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

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

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

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

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

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

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

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