После обновления модуля перестало работать: что делать и как откатиться · УФ

Решение

Применимо к: управляемые формы — УТ 11, КА 2, ERP, УНФ, Розница, БП (версии модуля 3.x). На обычных формах (УТ 10.3, УПП 1.3, КА 1.1, версии 1.x) модуль ставится объединением конфигураций, а не расширением, поэтому порядок обновления и отката там другой — уточните в поддержке. 1. ПЕРВЫМ ДЕЛОМ — НЕ ОТКАТЫВАЙТЕСЬ Откат стирает улики. Если вернуться на прежнюю версию сразу, причина останется невыясненной и повторится на следующем обновлении — только уже через месяц, когда никто не вспомнит подробностей. Запишите четыре вещи, они понадобятся и вам, и поддержке: 1) с какой версии на какую обновились (как узнать — раздел 2); 2) что именно перестало работать: операция, площадка, схема работы; 3) точный текст ошибки, если она есть. Если ошибки нет, а результат неверный — так и запишите; 4) когда прошло обновление и когда в последний раз всё работало нормально. Исключение: если обмен встал полностью и работа стоит — откатывайтесь сразу, но перечисленное соберите ДО отката. 2. УЗНАТЬ СВОЮ ВЕРСИЮ И ЧТО В НЕЙ МЕНЯЛИ Всё нужное есть внутри модуля: • Текущая версия — в заголовке окна рабочего места менеджера по маркетплейсам. Если рядом с номером стоит (BETA) — у вас предрелизная сборка, см. раздел 6. • Что изменилось между версиями — команда «История версий» в рабочем месте. Сразу после обновления модуль сам открывает окно «Изменения с релиза … по релиз …». • Данные для обращения — команда «Информация для техподдержки»: собирает версию модуля, конфигурацию, версию платформы и тип базы одним готовым текстом. Учтите: окно «что нового» показывается один раз и каждому сотруднику своё. Модуль запоминает последнюю просмотренную версию отдельно по пользователю. Если тот, кто первым зашёл после обновления, закрыл окно не читая — оно больше не появится; открывайте «Историю версий» вручную. И не удивляйтесь, что у коллеги диапазон версий в этом окне другой. 3. УБЕДИТЬСЯ, ЧТО ДЕЛО ДЕЙСТВИТЕЛЬНО В ОБНОВЛЕНИИ Совпадение по времени ещё не означает причину. Четыре проверки: 1) Обновление применилось целиком? Самая частая причина — обновили не всё, см. раздел 4. 2) Не изменилось ли что-то на стороне площадки? Площадки меняют свои интерфейсы обмена без предупреждения, и со стороны это выглядит один в один как дефект модуля. Признаки внешней причины: сломалось только по одной площадке, по остальным всё в порядке; в ответах площадки появились отказы с кодом 400 или пустые поля там, где раньше были данные. 3) Что показывает сам модуль? В рабочем месте есть строка-индикатор: «Сегодня ошибок нет» либо «Сегодня есть ошибки по выбранной настройке (N)». По ней открывается то, что модуль уже зафиксировал сам — часто там прямо написана причина. 4) Есть ли ваш случай в списке изменений? Откройте «Историю версий» и посмотрите строки между вашей прежней и новой версией. Если среди них есть правка того самого участка, который сломался, — вы нашли причину. 4. ОБНОВЛЕНИЕ МОГЛО ПРИМЕНИТЬСЯ НЕ ПОЛНОСТЬЮ Модуль — это не один файл, и обновление основного файла не переносит остальные части автоматически. • Основной файл (расширение конфигурации). Признак, что не применилось: версия в заголовке рабочего места осталась прежней. • Внешние обработки из комплекта: печать стикеров, лист подбора, загрузка отчёта комиссионера, регламентные задания. Признак: ошибки «Поле объекта не обнаружено (…)», «Метод объекта не обнаружен (…)», «Команда … не обнаружена» — при том, что версия модуля новая и правильная. • Права пользователей. Признак: у администратора модуль открывается, у рядовых сотрудников нет. Новые версии добавляют новые объекты, и права на них нужно выдать. Примерно каждая третья версия требует переустановить внешние обработки из комплекта. Если после обновления «вылезла ошибка на ровном месте» — начните проверку именно с этого, а не с настроек обмена. 5. ОТКАТ НА ПРЕДЫДУЩУЮ ВЕРСИЮ Модуль поставляется расширением конфигурации, поэтому откат — это загрузка предыдущего файла вместо текущего. Операция штатная. 1) Сделайте резервную копию базы — обязательно, см. предупреждение ниже. 2) Возьмите файл предыдущей версии. Держать у себя файл последней заведомо рабочей версии — привычка, которая экономит часы. 3) Загрузите расширение предыдущей версии вместо текущего. 4) Верните внешние обработки той же версии. Иначе получите ту же ошибку «Поле объекта не обнаружено», только с обратной стороны. 5) Проверьте ровно ту операцию, которая сломалась. Откат возвращает код, но не всегда возвращает данные. Отдельные версии при первом запуске выполняют разовую обработку уже накопленных данных — например, дозаполняют склад в строках ранее созданных заказов клиента. Такие изменения остаются в базе и после отката. Версий с подобной обработкой немного, около трёх процентов, но узнать заранее, попали ли вы на такую, нельзя — отсюда и требование резервной копии. 6. КАК НЕ ПОПАДАТЬ В ЭТО РЕГУЛЯРНО • Не обновляйтесь в разгар рабочего дня. Ночь, раннее утро или выходные — и резервная копия перед установкой. • Проверяйте на копии базы, если у вас доработанная конфигурация: большая часть проблем проявляется на нетиповых сценариях. • Не ставьте бета-версии на рабочую базу. Бета помечена явно: (BETA) в заголовке рабочего места и рядом с номером в списке версий. Это предрелизные сборки, их выпускают, чтобы проверить исправление, а не для повседневной работы. • Держитесь в пределах нескольких релизов от актуального. Обновляться на каждый релиз не нужно, но и отставать на десятки версий не стоит: тогда за одно обновление приезжают изменения сразу за несколько месяцев, и понять, какое из них сломало работу, почти невозможно. • Храните файл последней рабочей версии вместе с внешними обработками того же выпуска. • После обновления потратьте десять минут на короткую проверку по своему сценарию: получить заказы, создать заказ клиента, передать остатки, напечатать стикер. 7. ЧТО ЧАЩЕ ВСЕГО ЛОМАЕТСЯ ПОСЛЕ ОБНОВЛЕНИЯ • Упаковки и единицы измерения. Заказ клиента создаётся в штуках вместо упаковок, а цена остаётся ценой за упаковку. Сопоставление товара при этом верное — проверять его бесполезно. Рабочий выход: откат на предыдущую версию и обращение с указанием двух версий. • Ставка НДС. В созданном заказе клиента ставка пустая, хотя в соглашении или договоре указана. Проверьте, что ваша редакция конфигурации поддерживается установленной версией модуля: часть таких случаев связана с переходом на новые редакции УТ, КА и ERP. • Склад в строках заказа клиента. Документ создаётся, но не проводится: «Значение поля Склад не может быть пустым». Возникает, если склад задан в шапке документа, а в строках пуст. • Загрузка заказов: «Поле объекта не обнаружено (…)». Разобрано отдельно — см. статью «Заказ не загрузился в 1С: что проверить», раздел 5. • Печать: стикеры, лист подбора. Пустой лист без ошибки либо ошибка вида «Ожидается выражение "("». Сначала переустановите внешние обработки печати из комплекта текущей версии. Для листа подбора помогает заново выбрать реквизит сортировки в настройках — ошибка возникает, когда сохранённая сортировка пустая. • Остатки перестали передаваться. Если на вкладке «Отборы» одновременно включён флажок «Исключить» и заполнен отбор номенклатуры по складу — передаются не те позиции. Снимите «Исключить». Это известный дефект, настройкой глубже он не лечится. • Доступ к рабочим местам: открывается не у всех сотрудников. Выдайте права на объекты, добавленные новой версией. 8. ЧТО ПРИЛОЖИТЬ К ОБРАЩЕНИЮ Регресс берут в работу быстрее всего, когда видны две точки: на какой версии работало и на какой перестало. Одна фраза «после обновления сломалось» без номеров версий — это ещё не обращение, по нему нечего проверять. 1) Две версии: «работало на X, перестало на Y». Самый важный пункт. 2) Текст из «Информации для техподдержки» — там уже собраны конфигурация, платформа и тип базы. 3) Что именно делали, что ожидали получить и что получили вместо этого. 4) Полный текст ошибки. Если ошибки нет, а результат неверный — напишите об этом прямо, это тоже диагноз. 5) Конкретный пример: номер заказа или товара, снимки экрана «как было» и «как стало». 6) Если откатывались — на какой версии всё снова заработало. Это половина решения. Осторожно с флажком «Добавить настройки подключения». В форме «Информация для техподдержки» он добавляет в текст токены, логины и пароли от площадок. Включайте его только если об этом попросили, и не выкладывайте такой текст в общие чаты и переписку. 9. СМЕЖНЫЕ СТАТЬИ (разбор частных случаев) • «После обновления перестали передаваться остатки — флажок "Исключить" на вкладке "Отборы"». • «После обновления неверно пересчитываются остатки по товарам с упаковками». • «После обновления модуля заказы создаются в штуках вместо упаковок, цена остаётся за упаковку». • «При печати листа подбора ошибка "Ожидается выражение" после обновления модуля». • «Заказ не загрузился в 1С: что проверить» — если после обновления перестали приходить заказы. • «Остатки: откуда берётся число, которое уходит на маркетплейс» — если после обновления разошлись остатки. К записи приложен тот же материал в PDF — с таблицами и удобнее для печати.