Доработка может правильно обнаружить проблему и всё равно поставить сотрудника в тупик. На экране появляется «Операция не выполнена», а человек не понимает, сохранился ли документ, нужно ли повторить команду и что именно исправлять. Он обращается к коллегам, пробует случайные действия или закрывает форму. В результате корректная техническая проверка не достигает своей рабочей цели.
Текст сообщения — часть поведения программы. Его нужно проектировать вместе с условием остановки и способом восстановления, а не добавлять в последний момент. Для расширений 1С это особенно важно: пользователь не обязан знать, где заканчивается типовая функция и начинается доработка. Он ожидает единого, понятного объяснения происходящего.
Начать с состояния операции
Прежде чем писать фразу, разработчик должен определить результат к моменту ошибки. Ничего не записано, часть объектов обработана или запрос передан внешней системе, но подтверждение не получено — это разные ситуации. Одинаковое «повторите попытку» подходит им далеко не всегда. Сначала описывают фактическое состояние, затем выбирают безопасное следующее действие.
Условный пример: команда создаёт пакет внутренних заявок. Если обработаны три из пяти, сообщение о полном отказе вводит в заблуждение. Пользователь может запустить создание заново и получить повторные объекты. Нужен результат по составу пакета: что создано, что не создано и как продолжить именно незавершённую часть. Формулировка должна соответствовать тому, что программа действительно умеет проверить.
Когда состояние внешней операции неизвестно, неизвестность нельзя маскировать словом «ошибка». Лучше сообщить, что подтверждение не получено, и предложить предусмотренную проверку статуса. Обещать отсутствие результата допустимо только при наличии доказательства. Это различие защищает от опасных повторов сильнее, чем эмоциональное предупреждение крупными буквами.
Отделить исправляемую ситуацию от технического сбоя
Не каждое препятствие означает неисправность программы. Пустое обязательное поле, закрытый для изменения объект и недостаточные права требуют разных объяснений. Для первого случая человек может самостоятельно заполнить значение, для второго — обратиться к владельцу процесса, для третьего — запросить разрешение по установленному порядку. Если всем показывать одинаковое техническое исключение, полезная информация теряется.
В стандарте разработки 1С рекомендуется делать сообщения понятными пользователю, объяснять событие, причину и дальнейшее действие. Для ошибки заполнения полезна связь с конкретным полем. Эти принципы задают направление, но содержание зависит от самой задачи: разработчик должен знать, какое исправление действительно допустимо, а не просто заменить технические слова бытовыми.
Непредвиденный сбой выделяют отдельно. Пользователю можно дать краткое описание недоступного действия и номер диагностического события, если такая связь реализована. Внутренние сведения остаются у сопровождения. Нельзя сообщать «исправьте реквизит», когда реальная причина неизвестна: это заставляет человека менять корректные данные и осложняет дальнейший разбор.
Назвать объект и условие без лишних подробностей
Сообщение должно помогать понять, к чему относится проблема. В форме одного документа контекст очевиден, но при массовой обработке нужны идентификатор объекта и различимый признак. При этом не стоит выводить весь документ или чувствительные значения. Достаточно того, что позволит разрешённому пользователю найти нужную запись в своей рабочей области.
Условие описывают через деловой смысл. Вместо названия переменной или внутреннего типа полезнее сказать, что для выбранного способа доставки не указан пункт выдачи. Однако точную причину можно утверждать лишь тогда, когда проверка её установила. Если система знает только о неуспешном ответе сервиса, нельзя придумывать отсутствие договора или неверный адрес клиента.
Для числовых ограничений важны единицы и границы. Фраза «слишком большое значение» требует догадки, а указание допустимого диапазона помогает исправить ввод. Диапазон должен формироваться из актуального правила, а не дублироваться отдельной константой в тексте. Иначе логика изменится, а сообщение продолжит рекомендовать уже недопустимое значение.
Предлагать действие в пределах полномочий
Хорошая подсказка не должна отправлять обычного сотрудника в технические настройки, которыми он не управляет. Если исправление доступно только администратору или ответственному за справочник, сообщение указывает эту роль и разрешённый маршрут обращения. Просьба «проверьте настройки» слишком расплывчата: неизвестно какие, где и с каким ожидаемым результатом.
Когда сотрудник может устранить проблему сам, действие делают конкретным. Например, выбрать значение в указанном поле или сохранить обязательный исходный объект перед запуском команды. Важно не требовать действий, которые уничтожат введённую работу. Если переход к исправлению закрывает текущую форму, программа должна учитывать судьбу несохранённых изменений, а сообщение — не обещать их сохранность без оснований.
Иногда безопасное действие заключается в ожидании или остановке. Тогда полезно объяснить, почему повтор не рекомендуется и как узнать о готовности продолжить. Не нужно предлагать ждать неопределённо долго без контакта или статуса. Для нестандартного сбоя оставляют короткий путь к сопровождению и минимальные сведения, которые помогут найти событие.
Не превращать сообщение в технический журнал
Список вызовов, внутренний запрос и длинный ответ стороннего сервиса могут быть полезны разработчику, но мешают рабочему решению пользователя. Эти данные лучше сохранять в предусмотренном диагностическом механизме с необходимыми ограничениями доступа. На экране остаётся понятный итог и, при наличии реализации, идентификатор для связи с подробностями.
Полный ответ внешней системы может содержать персональные сведения, служебные адреса или секреты. Его нельзя автоматически показывать любому пользователю формы. Состав диагностических данных проектируют отдельно: что собирается, кому доступно и как долго хранится. Удобство поиска ошибки не оправдывает неконтролируемое копирование чувствительной информации.
Для массовой операции нужен отдельный результат, который можно просмотреть и разобрать, а не сотня всплывающих уведомлений. Краткое сообщение сообщает итог, подробная форма показывает проблемные строки и доступные действия. Если часть результата требует ручной проверки, её выделяют явно. Успешные и неуспешные элементы не должны сливаться в один неразличимый текст.
Проверить тон и точность формулировок
Спокойный деловой язык помогает действовать быстрее, чем обвинение. Сообщения «неправильно заполнено» или «ошибка пользователя» не объясняют правило и создают ощущение, что виноват человек. Лучше назвать недостающее условие. При этом вежливость не должна размывать смысл: длинное вступление с извинениями иногда скрывает единственную важную инструкцию.
Текст должен отличать запрет от предупреждения. Если действие невозможно, не предлагают продолжить. Если допускается осознанное исключение, объясняют последствия выбора и оставляют понятный способ отказаться. Подтверждение опасной операции не должно выглядеть так же, как обычное информационное уведомление, иначе пользователи привыкают закрывать всё автоматически.
Одинаковые термины используют последовательно. Если в форме объект называется «Заявка», сообщение не должно внезапно называть его «Запросом» или «Заказом». Это особенно заметно в расширениях, которые добавляют собственные формулировки рядом с типовыми. Перед выпуском полезно сверить словарь с реальным интерфейсом и речью сотрудников, которые выполняют задачу ежедневно.
Испытать сообщение как отдельный сценарий
Проверка включает намеренное создание проблемной ситуации на безопасных данных. Человек, не читавший код, должен понять сообщение и выбрать правильный следующий шаг. Если ему приходится спрашивать автора, что означает фраза, текст или сам путь исправления ещё не готовы. Такая проверка не требует большой исследовательской программы: достаточно нескольких характерных случаев.
Отдельно проверяют длинные названия, пустые значения и несколько ошибок одновременно. Сообщение может быть грамматически верным на коротком примере и нечитаемым на реальном объекте. В массовом сценарии смотрят, сохраняется ли связь с каждой строкой. В сценарии ограниченных прав убеждаются, что подсказка не раскрывает недоступные сведения и не предлагает запрещённую команду.
После исправления проверяют повторное выполнение. Пользователь должен не только выйти из ошибки, но и завершить исходную задачу без лишних последствий. Если программа продолжает показывать старое предупреждение после устранения причины, доверие к подсказкам быстро снижается. Устаревший статус столь же вреден, как неточная первая формулировка.
Поддерживать сообщения вместе с логикой
При изменении бизнес-правила просматривают связанные тексты, ограничения и инструкции. Новая ветвь алгоритма может сделать прежнее объяснение неверным, даже если строка сообщения не вызвала технической ошибки. Поэтому ревью доработки должно затрагивать не только код, но и то, что увидит сотрудник в нестандартной ситуации.
Повторяющиеся обращения помогают находить слабые места. Если люди регулярно спрашивают, можно ли повторить команду, ответ нужно сделать частью поведения и сообщения, а не бесконечно сообщать вручную. При этом нельзя исправить текстом ненадёжную операцию: сначала обеспечивают проверяемое состояние и безопасный маршрут, затем описывают их понятными словами.
Хорошее сообщение сокращает расстояние между обнаруженной проблемой и завершённой задачей. Пользователь понимает состояние результата, знает доступное действие и не вынужден гадать о внутренних механизмах. Для команды разработки это такой же проверяемый результат, как верный расчёт или корректная запись данных.