massovaya-pravka-moduley-vneshnih-obrabotok

KO | EN

gitlite — search

#python #ai #llm #go #golang #android #machine-learning #rust #linux #windows #awesome-list #security #ios #openai

massovaya-pravka-moduley-vneshnih-obrabotok

(★ 4)

https://infostart.ru/1c/tools/2720476/

massovaya-pravka-moduley-vneshnih-obrabotok 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Infostart](https://camo.githubusercontent.com/93792854de2eb476c2c1750232803c358d46084dc2ae5b6424cb7e0df07a2b09/68747470733a2f2f696e666f73746172742e72752f6269747269782f74656d706c617465732f73616e64626f785f656d7074792f6173736574732f74706c2f61626f2f696d672f6c6f676f2e737667)

Оригинальная публикация: https://infostart.ru/1c/tools/2720476/

# Массовая правка модулей внешних обработок через штатный Конфигуратор 1С 8.3

Обработка для массовой замены текста в модулях внешних обработок и отчётов (.epf/.erf) через штатный Конфигуратор платформы, без внешних зависимостей.

## Описание

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

Данная обработка решает эту проблему, используя штатные ключи Конфигуратора:
- `/DumpExternalDataProcessorOrReportToFiles` — выгрузка .epf/.erf в XML + .bsl
- `/LoadExternalDataProcessorOrReportFromFiles` — обратная сборка

Обработка предоставляет удобный интерфейс для автоматизации процесса: выгрузка → замена текста → инкрементная сборка.

## Возможности

- **Выгрузка** .epf/.erf в XML + .bsl через штатный ключ Конфигуратора
- **Замена текста** в .bsl файлах по таблице правил:
  - Учёт регистра (опционально)
  - Игнорирование лишних пробелов (опционально)
  - «Умная замена» — автоматическая корректировка скобок в условиях `ПО (...)` ↔ `ПО ...`
- **Инкрементная сборка** — Конфигуратор запускается только для изменённых файлов (экономия 80–90% времени)
- **Словари замен** — сохранение и загрузка правил в формате JSON для обмена между разработчиками
- **Подробное логирование** — в окно сообщений выводятся имена обработок, файлы и номера сработавших правил
- **Кроссплатформенность** — запуск Конфигуратора через `ЗапуститьПриложение` (без COM-объектов), работает на Windows и Linux
- **Интерфейс** — управляемые формы, работает в тонком и толстом клиенте

## Требования

- **Платформа:** 1С:Предприятие 8.3.15 и выше (рекомендовано 8.3.24+)
- **Режим работы:** тонкий или толстый клиент
- **ОС:** Windows, Linux
- **Права:** пользователь должен иметь право **«Администрирование»** в профиле групп доступа
- **Информационная база:** любая (файловая или клиент-серверная) — используется как «подложка» для работы Конфигуратора

## Установка

1. Скачайте файл обработки `МассоваяПравкаМодулейВнешнихОбработок.epf`
2. Откройте его в 1С:Предприятие через меню **Файл → Открыть** или двойным кликом по файлу
3. Обработка готова к работе

## Использование

Обработка разделена на три логических этапа. Каждый этап выполняется отдельной командой — это позволяет контролировать процесс и при необходимости прерваться.

### Шаг 1. Настройка подключения

Откройте вкладку **«Подключения»** и укажите параметры любой информационной базы (файловой или клиент-серверной). Эта база используется как «подложка» для запуска Конфигуратора — в неё ничего не записывается.

- **Путь к платформе** — полный путь к `1cv8.exe` нужной версии (8.3.15 и выше)
- **Тип базы** — файловая (`/F`) или клиент-серверная (`/S`)
- **Параметры подключения** — путь к файловой базе либо сервер и имя базы
- **Пользователь / пароль** — если требуется авторизация

### Шаг 2. Выбор каталогов

На вкладке **«Файлы»** укажите три пути:

- **Каталог обработок** — папка с исходными `.epf` / `.erf` файлами. Поиск рекурсивный
- **Каталог выгрузки** — временная папка, в которую Конфигуратор распакует XML и `.bsl`. Создаётся автоматически
- **Каталог результата** — сюда будут сохраняться собранные (исправленные) .epf/.erf файлы. Исходные файлы не затрагиваются

### Шаг 3. Выгрузка обработок

Нажмите кнопку **«Выгрузить»**. Обработка:

1. Рекурсивно найдёт все `.epf` и `.erf` в каталоге источников
2. Для каждого файла запустит `1cv8.exe` с ключом `/DumpExternalDataProcessorOrReportToFiles`
3. Рядом с каждым XML-файлом появится папка с `.bsl`-модулями (ObjectModule.bsl, Form.bsl и т.п.)
4. Заполнит таблицу **«Результаты»** со статусом выгрузки каждого файла

Во время работы отображается прогресс через `Состояние()`. Длительную операцию можно прервать через `Ctrl+Break`.

### Шаг 4. Настройка правил замены

Перейдите на вкладку **«Замена»** и заполните таблицу **ПараметрыЗамены**:

- **Искомый текст** — что заменяем (точная строка, включая пробелы и регистр)
- **Текст замены** — на что заменяем
- **Выполнять** — флаг активности правила. Неактивные правила пропускаются

Доступны два дополнительных режима (галочки в форме):

- **С учётом регистра** — по умолчанию замена регистронезависимая (стандартное поведение `СтрЗаменить` в 1С)
- **Игнорировать лишние пробелы** — нормализует пробелы и табуляции перед сравнением

Правила можно загрузить из JSON-файла (**Загрузить словарь из файла**) или сохранить текущие (**Сохранить словарь в файл**). Формат JSON включает версию, дату экспорта, флаги и массив правил — удобно передавать между разработчиками и версионировать в Git.

#### Пример реальных правил

Кейс с регистром `СклоненияПредставленийОбъектов` в ЗУП 3.1:

| Искомый текст | Текст замены |
|---------------|--------------|
| `ФамилияИО,ИОФамилия` | `ФамилияИО,ИОФамилия,ФИОПолные` |
| `ПО (КадровыеДанныеСотрудников.ФизическоеЛицо = СклоненияФизлиц.Объект)` | `ПО КадровыеДанныеСотрудников.ФизическоеЛицо = СклоненияФизлиц.Объект И (ПОДСТРОКА(СклоненияФизлиц.ИменительныйПадеж, 1, 256) = КадровыеДанныеСотрудников.ФИОПолные)` |
| `ПО (КадровыеДанныеСотрудников.ДолжностьПоШтатномуРасписанию = СклоненияДолжностей.Объект)` | `ПО КадровыеДанныеСотрудников.ДолжностьПоШтатномуРасписанию = СклоненияДолжностей.Объект И (ПОДСТРОКА(СклоненияДолжностей.ИменительныйПадеж, 1, 256) = ВЫРАЗИТЬ(СклоненияДолжностей.Объект КАК Справочник.ШтатноеРасписание).Наименование)` |

**Важно про «умную замену».** Конфигуратор 1С выгружает условия `ПО` непоследовательно: в одних `.epf` — `ПО (Условие)`, в других — `ПО Условие`. Оба варианта синтаксически корректны, но для `СтрЗаменить()` это разные строки. Обработка автоматически пробует оба варианта, если точное совпадение не найдено. Это избавляет от необходимости заводить в словаре два правила на одну и ту же логическую замену.

### Шаг 5. Выполнение замены

Нажмите кнопку **«Выполнить замену»**. Обработка:

1. Рекурсивно найдёт все `.bsl` в каталоге выгрузки
2. Для каждого файла применит активные правила в порядке их следования в таблице
3. Перезапишет файл **только если текст реально изменился** (сравнение до/после)
4. Зафиксирует имя изменённой обработки в таблице **ИзменённыеОбработки** (с проверкой на дубликаты)
5. Выведет в окно сообщений подробный лог: имя обработки, имя файла, номера сработавших правил

Пример сообщения в логе:
```
Изменена обработка: "ВПР_ПриказОбОплатеВыходногоДняБезПерерыва_v3",
файл: ObjectModule.bsl. Применимы правила: №1, №2, №3.
```

По итогу выводится сводка: всего `.bsl`-файлов, изменено файлов, уникальных обработок для сборки.

### Шаг 6. Сборка исправленных обработок

Нажмите кнопку **«Собрать»**. Обработка запустит Конфигуратор с ключом `/LoadExternalDataProcessorOrReportFromFiles` **только для файлов из таблицы ИзменённыеОбработки** — это и есть инкрементная сборка.

- Неизменённые `.epf`/`.erf` даже не открываются Конфигуратором
- Результат сохраняется в **Каталог результата** с тем же именем и расширением, что и исходный файл
- Исходные файлы в **Каталоге обработок** остаются нетронутыми — можно сравнивать через `diff` или любой инструмент сравнения

Если из 50 обработок изменились 3 — Конфигуратор запустится 3 раза, а не 50. На больших парках ВПФ это экономит 80–90% времени этапа сборки.

## Пример работы

**Исходная задача:** исправить задвоение в запросах 18 внешних печатных форм ЗУП 3.1.

**Время выполнения:**
- Выгрузка 18 файлов: ~2 минуты
- Замена текста: ~10 секунд
- Сборка 12 изменённых файлов (из 18): ~1.5 минуты
- **Итого: менее 5 минут**

Вручную это заняло бы 3–4 часа.

## Почему не V8Unpack?

Существующие решения используют внешнюю утилиту V8Unpack.exe для разбора .epf файлов. Это создаёт проблемы:

- **Блокировка антивирусами** — V8Unpack.exe часто определяется как подозрительный файл
- **Только Windows** — COM-объект `WScript.Shell` не работает на Linux
- **Только старые форматы** — ручной парсер ломается на новых бинарных форматах .epf (8.3.10+)
- **Обычные формы** — не работает в тонком и толстом клиенте

Данная обработка использует **штатный Конфигуратор платформы**, который:
- Работает со всеми форматами .epf/.erf (старый текстовый и новый бинарный)
- Не требует внешних утилит
- Работает на Windows и Linux
- Работает на управляемых формах

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

- **Только текстовая замена** — без поддержки регулярных выражений
- **Нет предпросмотра замен (dry-run)** — изменения применяются сразу
- **Нет прямой загрузки обратно в справочник БСП** — нужно загружать вручную через **Администрирование → Дополнительные отчеты и обработки**
- **Нет кнопки «Проверить»** собранную обработку на компиляцию
- **Пароли хранятся в открытом виде** в реквизитах формы (не сохраняются между сеансами)
- **Требует права «Администрирование»** — не подойдёт для пользователей без соответствующего профиля групп доступа

## История версий

- **v1.0** — начальная версия: выгрузка, замена, сборка
- **v1.1** — добавлена инкрементная сборка (только изменённые файлы)
- **v1.2** — добавлена «умная замена» скобок в ПО
- **v1.3** — добавлено сохранение/загрузка словаря замен в JSON
- **v1.4** — кроссплатформенность: WshShell → ЗапуститьПриложение
- **v1.5** — добавлена обработка прерывания пользователем (Ctrl+Break)

## Планы на будущее

- Галочка «Без учёта регистра»
- Кнопка «Проверить результат» через `ВнешниеОбработки.Создать()`
- Фильтр по имени файла (маска или regex)
- Прямая загрузка обратно в справочник ДополнительныеОтчетыИОбработки
- Поддержка регулярных выражений
- Предпросмотр замен (dry-run с diff)

## Проверено на конфигурациях

- Зарплата и управление персоналом, редакция 3.1, релиз 3.1.37.72
- Совместимо с ЗУП 3.1, БП 3.0, УТ 11, ERP и другими современными конфигурациями

massovaya-pravka-moduley-vneshnih-obrabotok

massovaya-pravka-moduley-vneshnih-obrabotok 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

massovaya-pravka-moduley-vneshnih-obrabotok

massovaya-pravka-moduley-vneshnih-obrabotok 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README