Недокументированное использование стандартных обработок из меню "Все функции".
Разработка - Механизмы платформы 1С
В платформе 1С предприятие есть очень удобные стандартные функции:
1. Активные пользователи;
2. Журнал регистрации;
3. Поиск ссылок на объект;
4. Проведение документов;
5. Удаление помеченных объектов;
6. Управление внешними источниками данных;
7. Управление итогами;
8. Управление полнотекстовым поиском;
9. Управление расширениями конфигурации;
Однако нигде не описаны варианты их использования кроме вызова из пункта "Все функции" главного меню. Поэтому иногда встречается мнение, что эти функции являются чем-то специфичным и сложным, что они вообще написаны не на 1С, а на С++ как и сама платформа.
На самом деле технически эти функции являются самыми обычными 1С обработками, включенными в состав платформы, и ими можно пользоваться полностью аналогично любым другим привычным обработкам.
Рассмотрим несколько способов их использования на примере стандартной обработки "Поиск ссылок на объекты".
1. Вызов стандартной обработки из любого пункта меню. Обработка "Поиск ссылок на объекты" достаточно удобна и может пригодиться обычным пользователям. Однако не всегда возможно давать им доступ к меню "Все функции" из-за ограниченного уровня доступа пользователя. В этом случае можно добавить вызов обработки из стандартного меню.
Добавляем в конфигурацию новую команду и в модуле команды прописываем текст:
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
ПодключитьВнешнююОбработкуНаСервере();
ОткрытьФорму("ВнешняяОбработка.StandardFindByRef.Форма");
КонецПроцедуры
&НаСервере
Процедура ПодключитьВнешнююОбработкуНаСервере()
ВнешниеОбработки.Подключить("v8res://mngbase/StandardFindByRef.epf", "StandardFindByRef", false);
КонецПроцедуры
При выборе этой команды у пользователя запустится обработка "Поиск ссылок на объекты" из обычного меню.
2. Подмена стандартной обработки. Допустим, по какой-то причине нас не устраивает стандартная обработка. В этом случае мы можем ее подменить любой другой. Выполняем на сервере следующий код (например в "ПриЗапуске()" конфигурации) и после этого из стандартного меню "Все функции" - "Поиск ссылок на объект" будет вызываться наша собственная внешняя либо встроенная в конфигурацию обработка.
ДвоичныеДанные = Новый ДвоичныеДанные("C:\ВнешняяОбработка.epf");
АдресХранилища = ПоместитьВоВременноеХранилище(ДвоичныеДанные);
ВнешниеОбработки.Подключить(АдресХранилища, "StandardFindByRef", false);
3. Изменение стандартной обработки. Стандартные обработки очень удобны, однако иногда в них не хватает какой-то мелочи. Например, нам может понадобиться добавить в обработку "Поиск ссылок на объект" фильтр для поиска только по документам. Можно, конечно, написать такую же обработку самостоятельно, а можно просто взять встроенную и немного изменить. Чтобы получить встроенную в виде отдельно файла, выполняем код:
КопироватьФайл("v8res://mngbase/StandardFindByRef.epf","C:\ВнешняяОбработка.epf");
Теперь у нас есть стандартный 1С-ный файл "C:\ВнешняяОбработка.epf" с встроенной обработкой. Его можно открыть в конфигураторе и внести любые нужные изменения. В дальнейшем модифицированную обработку можно использовать просто как внешнюю либо подключить обратно вместо встроеной.
Ну и напоследок соответствие стандартных обработок внутренним адресам платформы.
1. Активные пользователи - "v8res://mngbase/StandardActiveUsers.epf";
2. Журнал регистрации - "v8res://mngbase/StandardEventLog.epf";
3. Поиск ссылок на объект - "v8res://mngbase/StandardFindByRef.epf";
4. Проведение документов - "v8res://mngbase/StandardDocumentsPosting.epf";
5. Удаление помеченных объектов - "v8res://mngbase/StandardDeleteMarkedObjects.epf";
6. Управление внешними источниками данных - "v8res://mngbase/StandardExternalDataSourcesManagement.epf";
7. Управление итогами - "v8res://mngbase/StandardTotalsManagement.epf";
8. Управление полнотекстовым поиском - "v8res://mngbase/StandardFullTextSearchManagement.epf";
9. Управление расширениями конфигурации - "v8res://mngbase/StandardExtensionsManagement.epf";
10. upd. с 8.3.11. Управление системой взаимодействия - "v8res://mngbase/StandardECSRegister.epf"
И еще одна обработочка. Не входит в стандартные, но тоже полезна для ознакомления.
11. Конструктор запросов на управляемых формах - "v8res://mngbase/QueryWizard.epf";
Не стоит забывать, что такое использование стандартных функций является недокументированным. Т.е. на текущий момент на платформах 8.2 - 8.3.6 такие варианты вызовов работают вполне корректно. Но могут перестать работать в любой момент, поэтому злоупотреблять ими не стоит.
Также стоит учитывать, что в официальных материалах по 1С не документирована возможность простого изменения этих обработок не случайно. Встроенные обработки разрабатываются с учетом функционала текущей платформы. Т.е. они учитывают особенности работы и ограничения той платформы, в состав которой включены. В каких-то случаях, при использовании обработки от другой платформы, могут быть ошибки. Особенно в сложных режимах, например, при удалении документов, управлении итогами или восстановлении последовательностей. Так что использовать эти обработки следует аккуратно, оценивая возможные риски.
Вступайте в нашу телеграмм-группу Инфостарт
Активные пользователи Журнал регистрации Поиск ссылок на объект Проведение документов Удаление помеченных объектов Управление внешними источниками данных Управление итогами Управление полнотекстовым поиском Управление расширениями конфигурации
Вы можете заказать платную адаптацию этой статьи под ваши задачи на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
См. также
Механизмы платформы 1С Разработчик Бесплатно (free)
Разберем 15 мифов о работе платформы «1С:Предприятие 8» – как распространенных, так и малоизвестных. Начнем с классики: «Код, написанный в одну строку, работает быстрее, чем многострочный». Так ли это на самом деле?
16.07.2025 45908 TitanLuchs 109
Работа с интерфейсом WEB-интеграция Механизмы платформы 1С Бесплатно (free)
Веб-интерфейсы повышают качество внешнего вида приложений 1С, предсказуемы с точки зрения верстки, позволяют организовать удобные и высокопроизводительные рабочие места для пользователей. Расскажем об особенностях разработки веб-интерфейсов на React внутри 1С, двустороннем взаимодействии 1С и JavaScript, а также сборке веб-приложения в одностраничный файл.
19.06.2025 18941 zeegin 15
Механизмы платформы 1С Работа с интерфейсом Разработчик Стажер 1С:Предприятие 8 Бесплатно (free)
Про ООП в 1С и о том, как сделать свой код более кратким и выразительным при помощи использования текучего интерфейса (fluent interface).
03.02.2025 26180 bayselonarrend 127
Механизмы платформы 1С Разработчик 1С:Предприятие 8 Бесплатно (free)
В этой статье подробно рассматривается работа с JSON в XDTO в 1С:Предприятие. Вы узнаете, как сериализовать и десериализовать объекты XDTO в JSON, интегрировать 1С с веб-сервисами и API, а также корректно обрабатывать данные при обмене. Разбираются особенности работы с коллекциями, использование функций восстановления и частые ошибки при работе с JSON и XDTO.
30.01.2025 33560 user2122906 10
Механизмы платформы 1С Файловый обмен (TXT, XML, DBF), FTP Разработчик 1С:Предприятие 8 Бесплатно (free)
Этот материал познакомит вас с механизмом XDTO (XML Data Transfer Objects) в 1С и научит эффективно использовать его возможности. Мы разберёмся, как работать с XML-схемами, создавать модели данных, манипулировать объектами XDTO, а также сериализовать и десериализовать их в XML. Вы узнаете, как использовать XDTO для интеграции с внешними системами, избегать типичных ошибок и оптимизировать код. К концу вы будете уверенно применять XDTO для решения сложных задач обмена данными и автоматизации процессов.
17.01.2025 56417 user2122906 13
Механизмы платформы 1С WEB-интеграция Разработчик 1С:Предприятие 8 Бесплатно (free)
В платформе 8.3.27 появилась возможность использовать WebSocket-клиент. Давайте посмотрим, как это все устроено и чем оно нам полезно.
14.01.2025 47167 dsdred 110
Механизмы платформы 1С Разработчик 1С:Предприятие 8 Бесплатно (free)
Особенности "Знач" и разбор документации к нему.
10.01.2025 26667 VAAngelov 60
Механизмы платформы 1С Разработчик Стажер 1С:Предприятие 8 1C:Бухгалтерия Бесплатно (free)
Эта небольшая статья - некоторого рода шпаргалка по файловым потокам: как и зачем с ними работать, какие преимущества это дает.
23.06.2024 40717 bayselonarrend 24
Поэтому и "недокументированное использование".
Вытянуто из ресурсных файлов .res в поставке платформы.
Случайно наткнулась при разборе ошибок платформы.
"Items.RestoreSequence.Enabled" на "True", далее изучить код для заполнения списка восстановления последовательностей.
О ресурсах v8res:// в официальной документации я ничего не находил. Единственные упоминания появляются в описаниях ошибок. Но с типовыми пунктами меню сгенерировать ошибку нереально.
Тот факт, что стандартные обработки не предоставляются в пользовательский интерфейс - это осознанное решение. Конкретное прикладное решение опирается на некоторый конкретный и прогнозируемый (прикладным разработчиком) список функциональных возможностей. Стандартные функции развиваются синхронно с платформой, а не с прикладным решением. Поэтому пользователю, кажется, будет совершенно непонятно, почему (после обновления платформы и без обновления прикладного решения) какая-то функция внезапно поменяла свой внешний вид и предоставляемые возможности.
Кроме того, переопределение системных форм ведет к тому, что теряется некоторый пользовательский опыт, когда пользователь, переходя от одного прикладного решения к другому, внезапно для него получает совершенно другую форму с (в пределе) совершенно другим поведением и возможностями.
Также стоит отметить, что любое использование недокументированных возможностей в любой момент времени может перестать работать (описываемая возможность не является исключением).
Недокументированные возможности могут появляться и исчезать хаотично, про их жизненный цикл никто не отчитывается и если они пропадут, то никакой режим совместимости уже не поможет.
Позиция 1С по поводу таких переопределений описана в (6). И в принципе я с ней согласна. Их подход правильный. Есть стандартные функции, которые зависят от релиза платформы и развиваются параллельно с ней.
Но в некоторых случаях все-таки пользоваться под свою ответственность можно.
Насколько я знаю, других обработок в платформе нет.
На самом деле в данном случае для подключения используется стандартный метод менеджера внешних обработок ВнешниеОбработки.Подключить()
Смысл этой статьи только в определении внутренних адресов, по которым можно взять стандартные обработки.
Плюс дополнительно в конфигурации может быть включена обработка, адаптированная под особенности конкретной конфигурации.
Например, в УТ11, есть отдельные обработки "Удаление помеченных объектов", "Управление итогами и агрегатами", "Управление полнотекстовым поиском".
Но это именно отдельные независимые обработки.
В общем случае при наличии обработок в конфигурации лучше использовать их, а не встроенные в платформу.
Поправила.
Хотя, как ни странно, вариант с функцией тоже работает и ошибок не выдает.
По поводу контекста, это пример для модуля команды.
В нем нет варианта директивы &НаСервереБезКонтекста.
Но при вызове из формы логичнее использовать без контекста.
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
ИмяОбработки = ПодключитьВнешнююОбработкуНаСервере();
Если ИмяОбработки = "StandardFindByRef" Тогда
ОткрытьФорму("ВнешняяОбработка.StandardFindByRef.Форма");
Иначе
Предупреждение("Не удалось подключить внешнюю обработку!");
КонецЕсли;
КонецПроцедуры
&НаСервере
Функция ПодключитьВнешнююОбработкуНаСервере()
ИмяОбработки = ВнешниеОбработки.Подключить("v8res://mngbase/StandardFindByRef.epf", "StandardFindByRef", Ложь);
Возврат ИмяОбработки;
КонецФункции
ПоказатьНу если не используется модальность, то показать через метод ПоказатьПредупреждение
Однако я также считаю что для правильной работы с платформой программист должен понимать, как она работает, из чего состоит программный продукт, как взаимосвязаны его части (платформа, конфигурация, информационная база), какой функционал выполняется на каком уровне, какие настройки на каком уровне настраиваются.
При возникновении проблем со стандартными механизмами, нужно иметь возможность разобраться, в чем именно проблема. Программист должен уметь понять как работает нужный функционал. Именно для того, чтобы понять, в чем именно проблема в данных в конкретнй базе. А для этого нужно иметь возможность взять эту же обработку из текущей версии платформы в виде файла и пройтись отладчиком по непонятным вещам.
Также я считаю полезной возможность делать свои обработки на базе стандартных встроенных, а не изобретать каждый раз велосипеды, которые работают каждый по-разному.
И на мой взгляд, Инфостарт именно тот ресурс, на котором должна быть подобная информация. Также как информация о внутреннней структуре .cf и .dt файлов, структуре хранения системных данных базы в SQL. Да, неправильное использование такой информации может навредить, но понимание этих вещей необходимо для правильной работы и возможности оперативно решать возникающие задачи.
Насколько я понимаю, тема имелась в виду эта. Ничего больше не встречала.
Там нет особо официальных разъяснений. Основная идея: использовать функции платформы можно только из основного меню.
И чуть-чуть ее можно продолжить.
Информация о файлах v8res://mngbase/StandardActiveUsers.epf и т.п. лежит в файле mngbase_root.res
"v8res://mngbase/dcssFormModuleRus.txt"
"v8res://mngbase/searchFormModuleRus.txt"
"v8res://mngbase/FileSystemExtension.zip"
"v8res://mngbase/CryptoProtectionExtension.zip"
"v8res://mngbase/html.txt"
"v8res://mngbase/model.xdto"
Если вместо предлагаемого
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
ПодключитьВнешнююОбработкуНаСервере();
ОткрытьФорму("ВнешняяОбработка.StandardFindByRef.Форма");
КонецПроцедуры
написать
&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
Параметры = Новый Структура;
Параметры.Вставить("RequiredObject", ПараметрКоманды);
ПодключитьВнешнююОбработкуНаСервере();
ОткрытьФорму("ВнешняяОбработка.StandardFindByRef.Форма", Параметры, ПараметрыВыполненияКоманды.Источник, ПараметрыВыполненияКоманды.Уникальность, ПараметрыВыполненияКоманды.Окно);
КонецПроцедуры
Показатьто не потребуется вручную выбирать объект. Сразу заработает поиск!
Моя первая публикация, набравшая 200 плюсиков.
Причем ровно за неделю.
Похоже, действительно зацепила интересную тему.
Приятно :)
Автору за кропотливое копание в потрохах 1С - респект.
ВнешниеОбработки.Подключить("v8res://mngbase/StandardFindByRef.epf", "StandardFindByRef", false);
ВнешниеОбработки.Создать("StandardFindByRef");
и так:
ВнешниеОбработки.Создать("v8res://mngbase/StandardFindByRef.epf", false);
Ругается:
"Ошибка подключения внешних метаданных
по причине:
Файл не обнаружен 'StandardFindByRef'"
Что я не так делаю? - на платформе 8.3 работает...
Зато подключается через промежуточный файл
КопироватьФайл("v8res://mngbase/StandardFindByRef.epf","c:/temp/StandardFindByRef.epf");
Обработка = ВнешниеОбработки.Создать("c:/temp/StandardFindByRef.epf", false);
Хорошо бы этот нюанс и в статью добавить...
Не могу понять, почему обычный вариант не работает.
Вроде должен работать аналогично.
Синтаксис команд работы с внешними обработками в 8.2 и 8.3 одинаковый.
А есть возможность получить под обычные формы? А то выдает обработки под управляемые.
КопироватьФайл("v8res://mngbase/StandardFindByRef.epf","C:\ВнешняяОбработка.epf");по причине:
Каталог не обнаружен 'v8res://mngbase/StandardActiveUsers.epf'
Запускал на платформе 8.3.6.2152. Заранее - спасибо!
Обработка хорошая, только сразу не запустилась.
Пришлось СтрРазделить(Стр, ";", Ложь);
заменить на
ОбщегоНазначения.РазложитьСтрокуВМассивПодстрок(Стр,";");
Также процедура КаталогВыгрузкиНачалоВыбора
не сработала. Пришлось полностью переписать
(65) Abbra, Не совсем поняла, как скопировали. Эти обработки не являются элементами конфигурации, соответственно на них не может быть внешней ссылки. При их открытии даже звездочка неактивна. Если нужно дать на них ссылку, то я вижу только вариант встраивать их в конфигурацию.
Механизм подключения внешних файлов с внутренними именами есть только для отчетов и обработок.
Формы теоретически можно вытащить, но подменить стандартные внешними нельзя.
Я смотрю в платформе 8.3.11.2867
В ПриНачалеРаботыСистемы:
ЭА_Сервер.ПереопределитьНастройкуНавигации();
В модуле ЭА_Сервер:
Процедура ПереопределитьНастройкуНавигации()Экспорт
ДвоичныеДанные = Новый ДвоичныеДанные("C:\Database\ВнешняяОбработка1.epf");
АдресХранилища = ПоместитьВоВременноеХранилище(ДвоичныеДанные);
// так
ВнешниеОбработки.Подключить(АдресХранилища, "v8res://mngbase/dcschangesettingsstructure.epf", false);
// Или так
ВнешниеОбработки.Подключить(АдресХранилища, "8res://mngbase/dcschangesettingsstructure", false);
КонецПроцедуры
Что-то не подменяется форма
КопироватьФайл("v8res://basicui/StandardFindByRef.epf","C:\ВнешняяОбработка.epf");КопироватьФайл("v8res://basicui/DocumentsPostingDlg.f","D:\Новая папка\DocumentsPosting81.epf"); и все на этом.Делаю:
КопироватьФайл("v8res://mngbase/StandardECSRegister.epf", "D:\StandardECSRegister.epf");
Результат:
{ВнешняяОбработка.КопироватьФайл_v8res_mngbase.Форма.Форма.Форма(14)}: Ошибка при вызове метода контекста (КопироватьФайл)
КопироватьФайл("v8res://mngbase/StandardECSRegister.epf", "D:\StandardECSRegister.epf");
по причине:
Ошибка копирования файлов
по причине:
Каталог не обнаружен 'v8res://mngbase/StandardECSRegister.epf'
Почему? Аналогичная ошибка с StandardFindByRef и другими.
Что на клиенте, что на сервере.
видимо обработки теперь называются по другому или вызывать их надо иначе
имя другое (Поторопился. Просто переименовали некоторые, н-р:
StandardFindByRef -> StandardFindByReference)
тут раскрыто
ВнешниеОбработки.Подключить("v8res://mngbase/StandardFindByRef.epf", "StandardFindByRef", false);
Что бы таким образом открывались "Функции для технического специалиста" (Все функции)?
&AtClient
Procedure Init(extObject)
HelpExtObj = extObject;
EndProcedure
А можно как-то получить extObject, никто не знает?
&НаКлиенте
Процедура ПриОткрытии(Отказ)
СписокСтандартныхОбработок = ПолучитьСписокСтандартныхОбработок();
Для Каждого СтандартнаяОбработка Из СписокСтандартныхОбработок Цикл
ИмяОбработки = ПодключитьВнешнююОбработкуНаСервере(СтандартнаяОбработка.Значение, СтандартнаяОбработка.Представление);
ФормаВнешнейОбработки = ПолучитьФорму("ВнешняяОбработка." + ИмяОбработки + ".Форма");
Элементы.СтандартнаяОбрабтка.СписокВыбора.Добавить(ИмяОбработки, ФормаВнешнейОбработки.Заголовок);
КонецЦикла;
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПолучитьСписокСтандартныхОбработок()
СписокСтандартныхОбработок = Новый СписокЗначений;
//
ФайлСтандартныхОбработок = НайтиФайлы(КаталогПрограммы(), "mngbase_ru.res").Получить(0);
ЧтениеТекста = Новый ЧтениеТекста(ФайлСтандартныхОбработок.ПолноеИмя,,,, Ложь);
ТекстСтандартныхОбработок = ЧтениеТекста.Прочитать();
ЧтениеТекста.Закрыть();
//
НомерВхождения = 0;
Последний_разделитель = Неопределено;
Пока Истина Цикл
НомерВхождения = НомерВхождения + 1;
Позиция_epf = СтрНайти(ТекстСтандартныхОбработок, ".epf",,, НомерВхождения);
Если Позиция_epf = 0 Тогда
Прервать;
КонецЕсли;
//
Позиция_разделитель = СтрНайти(ТекстСтандартныхОбработок, Символ(0), НаправлениеПоиска.СКонца, Позиция_epf, 1);
Позиция_слэш = СтрНайти(ТекстСтандартныхОбработок, "/",,, НомерВхождения);
Если Позиция_epf > Позиция_слэш И Позиция_слэш > Позиция_разделитель Тогда
Прервать;
КонецЕсли;
//
ИмяСтандартнойОбработки = Сред(ТекстСтандартныхОбработок, Позиция_разделитель + 1, Позиция_epf - Позиция_разделитель - 1);
Если СтрЧислоСтрок(ИмяСтандартнойОбработки) > 1 Тогда
Прервать;
КонецЕсли;
//
ПутьСтандартнойОбработки = СтрШаблон("v8res://mngbase/%1.epf", ИмяСтандартнойОбработки);
Если СтрНайти(ТекстСтандартныхОбработок, ПутьСтандартнойОбработки) = 0 Тогда
ЭтаОбработкаИмеетДругойПуть = Истина;
КонецЕсли;
//
СписокСтандартныхОбработок.Добавить(ИмяСтандартнойОбработки, ПутьСтандартнойОбработки);
КонецЦикла;
//
Возврат СписокСтандартныхОбработок;
КонецФункции // ПолучитьСписокСтандартныхОбработок()
&НаСервереБезКонтекста
Функция ПодключитьВнешнююОбработкуНаСервере(Имя, Путь)
ИмяОбработки = ВнешниеОбработки.Подключить(Путь, Имя, Ложь);
Возврат ИмяОбработки;
КонецФункции
//
&НаКлиенте
Процедура СтандартнаяОбрабткаПриИзменении(Элемент)
ОткрытьВыбраннуюФорму();
КонецПроцедуры
&НаКлиенте
Процедура СтандартнаяОбрабткаОткрытие(Элемент, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
ОткрытьВыбраннуюФорму();
КонецПроцедуры
&НаКлиенте
Процедура ОткрытьВыбраннуюФорму()
ОткрытьФорму("ВнешняяОбработка." + СтандартнаяОбрабтка + ".Форма");
КонецПроцедуры // ОткрытьВыбраннуюФорму()
ПоказатьВы можете заказать платную консультацию или разработку у автора. Будет создан приватный заказ на «Бирже заказов» для автора.
№ 369487
Создание 19.06.15 11:59
Обновление 09.02.18 11:06
Просмотры 155845
Загрузки 0
Рейтинг
1115
Комментарии 150
Код открыт Да
Рубрики Механизмы платформы 1С
Кому Разработчик
Тип файла Нет файла
Платформа 1С:Предприятие 8
Конфигурация 1C:Бухгалтерия
Операционная система Windows
Страна Не имеет значения
Отрасль Не имеет значения
Налоги Не имеет значения
Вид учета Не имеет значения
Доступ к файлу Бесплатно (free)