Работа с формами в 1С:Предприятие через ссылки — задача, с которой сталкиваются и обычные пользователи, и разработчики. Кто-то хочет быстро открыть справочник по прямой ссылке из браузера, а кому-то нужно интегрировать формы в сторонние системы через API. В этой статье разберём все актуальные способы получения форм по ссылкам: от стандартных механизмов платформы до программного управления с использованием HTTP-сервисов и OData.

Особенность работы со ссылками в 1С заключается в том, что платформа изначально не предназначена для прямого доступа к объектам через URL, как это реализовано в веб-приложениях. Однако с выходом версий 8.3.10+ появились инструменты, позволяющие гибко настраивать такие сценарии. Мы рассмотрим как базовые методы (например, через ОткрытьФорму()), так и продвинутые — с использованием REST и веб-расширений.

Важно понимать, что не все способы универсальны: некоторые требуют прав администратора, другие работают только в тонком клиенте или веб-клиенте. Чтобы не тратить время на нерабочие решения, мы сразу укажем ограничения каждого метода.

1. Стандартные ссылки в 1С: как открыть форму через URL

Самый простой способ — использовать встроенные механизмы 1С:Предприятие для генерации ссылок на объекты. Этот метод работает в веб-клиенте и тонком клиенте (при настройке HTTP-сервисов). Ссылка формируется по шаблону:

http://[адрес_сервера]/[база]/hs/[имя_объекта]/[идентификатор]

Например, чтобы открыть карточку номенклатуры с идентификатором 12345 в базе demo, ссылка будет выглядеть так:

http://localhost/demo/hs/Catalog_Номенклатура/12345
  • 🔹 Плюсы: не требует программирования, работает "из коробки" в веб-клиенте.
  • 🔸 Минусы: не работает в толстом клиенте, требует настройки HTTP-сервисов в конфигураторе.
  • 🔶 Ограничения: доступны только объекты, для которых включена публикация через HTTPСервис.

Чтобы проверить, доступен ли объект для открытия по ссылке, перейдите в конфигуратор и откройте свойства объекта (например, справочника). На вкладке Прочее должен быть установлен флаг Публиковать через HTTP-сервис.

💡

Если ссылка не открывается, проверьте права доступа пользователя в 1С. Даже при корректной настройке HTTP-сервиса недостаточные права могут блокировать доступ к объекту.

2. Программное открытие форм через ОткрытьФорму()

Для разработчиков более гибкий способ — использование метода ОткрытьФорму() в коде 1С. Этот метод позволяет открывать формы не только по идентификатору, но и по имени, с передачей параметров. Пример кода:

ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", , , Истина,, , "12345");

Где:

  • 📌 "Справочник.Номенклатура.ФормаЭлемента" — имя формы.
  • 📌 "12345" — идентификатор объекта (последний параметр).
  • 📌 Истина — открыть в новом окне.

Этот метод универсален и работает во всех режимах запуска (толстый, тонкий, веб-клиент). Однако для открытия формы по внешней ссылке (например, из браузера или другой программы) потребуется обёртка.

⚠️ Внимание: При использовании ОткрытьФорму() в веб-клиенте убедитесь, что форма не содержит модальных диалогов — они могут блокировать выполнение скрипта.

Для интеграции с внешними системами можно создать HTTP-сервис, который будет принимать параметры из URL и вызывать ОткрытьФорму(). Пример структуры такого сервиса:

Процедура ОткрытьФормуПоСсылке(Запрос) Экспорт

Идентификатор = Запрос.Параметры.Получить("id");


ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", , , Истина,, , Идентификатор);


КонецПроцедуры

3. Использование OData для доступа к формам

OData — современный протокол для работы с данными 1С через REST API. Он позволяет не только получать данные, но и открывать формы по ссылкам. Для этого:

  1. Настройте публикацию OData в конфигураторе (раздел Администрирование → Публикация на веб-сервере).
  2. Сформируйте URL по шаблону: 
    http://[сервер]/[база]/odata/standard.odata/[имя_объекта]([идентификатор])
  3. Добавьте параметр $format=html для открытия формы в браузере.

Пример ссылки для открытия документа ЗаказПокупателя с номером 1000:

http://localhost/demo/odata/standard.odata/Document_ЗаказПокупателя(guid'123e4567-e89b-12d3-a456-426614174000')?$format=html
Параметр Описание Пример
$format=html Открывает форму в браузере ?$format=html
$select Выбор полей для отображения ?$select=Наименование,Цена
$expand Развернуть связанные объекты ?$expand=Контрагент

Для работы с OData требуется 1С:Предприятие 8.3.10+ и корректная настройка прав доступа. В отличие от HTTP-сервисов, OData поддерживает фильтрацию, сортировку и пагинацию, что делает его более гибким инструментом.

⚠️ Внимание: При публикации OData на внешний IP-адрес убедитесь, что сервер защищён от несанкционированного доступа (например, через HTTPS и аутентификацию).
📊 Какой способ открытия форм вы используете чаще?
Стандартные ссылки
ОткрытьФорму() в коде
OData
HTTP-сервисы

4. Внешние обработки и расширения для работы со ссылками

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

  • 🔧 Принимать параметры из URL (например, ?type=catalog&id=123).
  • 🔧 Проверять права пользователя перед открытием формы.
  • 🔧 Логировать обращения к формам (полезно для аудита).

Пример кода для обработки URL-параметров:

Процедура ОбработатьСсылку(ПараметрыСтрока) Экспорт

Параметры = Новый Структура();


Для Каждого Параметр Из СтроковыеФункцииКлиентСервер.РазложитьСтрокуПоРазделителю(ПараметрыСтрока, "&") Цикл


Части = СтроковыеФункцииКлиентСервер.РазложитьСтрокуПоРазделителю(Параметр, "=");


Если Части.Количество() = 2 Тогда


Параметры.Вставить(Части[0], Части[1]);


КонецЕсли;


КонецЦикла;



ТипОбъекта = Параметры.Получить("type");


Идентификатор = Параметры.Получить("id");



Если ТипОбъекта = "catalog" Тогда


ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", , , Истина,, , Идентификатор);


КонецЕсли;


КонецПроцедуры

Такой подход позволяет гибко настраивать логику открытия форм, включая:

  • 🔹 Динамическую проверку прав.
  • 🔹 Логирование обращений.
  • 🔹 Поддержку кастомных параметров (например, ?mode=readonly).

Для интеграции с внешними системами можно опубликовать обработку как HTTP-сервис или REST-сервис, чтобы она принимала запросы по URL.

Подключить обработку к конфигурации|Настроить права доступа|Опубликовать как HTTP-сервис|Протестировать с разными параметрами-->

5. Работа со ссылками в мобильном приложении 1С

В мобильном клиенте 1С (например, 1С:Мобильная платформа) открытие форм по ссылкам имеет особенности. Здесь нельзя использовать HTTP-сервисы или OData напрямую, но можно:

  1. Использовать глубокие ссылки (deep links) для открытия приложения с передачей параметров.
  2. Настроить обработку ссылок в коде мобильного приложения.

Пример схемы глубокой ссылки для Android:

intents://open?type=catalog&id=123#Intent;package=ru.yourcompany.app;scheme=https;end;

В коде мобильного приложения нужно обработать входящий Intent:

Процедура ПриОткрытии(Параметры)

Если Параметры.СодержитКлюч("type") Тогда


Тип = Параметры.Получить("type");


Ид = Параметры.Получить("id");


ОткрытьФормуПоТипу(Тип, Ид);


КонецЕсли;


КонецПроцедуры

Для iOS используется аналогичный подход через Universal Links. Важно:

  • 📱 Настроить Associated Domains в проекте Xcode.
  • 📱 Опубликовать файл apple-app-site-association на веб-сервере.
⚠️ Внимание: В мобильных приложениях 1С не все формы поддерживают открытие по ссылкам. Например, формы с сложной логикой (модальные диалоги, многотабличные части) могут некорректно отображаться.

6. Безопасность при работе со ссылками в 1С

Открытие форм по внешним ссылкам — потенциальная уязвимость, если не настроена защита. Основные риски:

  • 🔴 Несанкционированный доступ: злоумышленник может подобрать идентификаторы объектов.
  • 🔴 Межсайтовый скриптинг (XSS): если ссылки формируются без валидации.
  • 🔴 Утечка данных: при публикации OData без ограничений.

Чтобы минимизировать риски:

  1. Настройте аутентификацию для всех HTTP-сервисов и OData.
  2. Используйте HTTPS для шифрования трафика.
  3. Ограничьте права доступа к объектам на уровне ролей.
  4. Валидируйте все входящие параметры в коде (например, проверяйте, что id — это число).

Пример безопасной обработки параметров:

Процедура БезопасноеОткрытиеФормы(Ид)

Если НЕ ЗначениеЗаполнено(Ид) ИЛИ НЕ Число(Ид) Тогда


ВызватьИсключение "Некорректный идентификатор";


КонецЕсли;



Если НЕ ПраваДоступа.ПроверкаДоступа("Справочник.Номенклатура", "Чтение") Тогда


ВызватьИсключение "Недостаточно прав";


КонецЕсли;



ОткрытьФорму("Справочник.Номенклатура.ФормаЭлемента", , , Истина,, , Ид);


КонецПроцедуры

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

7. Частые ошибки и их решения

При работе со ссылками в 1С пользователи и разработчики сталкиваются с типичными проблемами:

Ошибка Причина Решение
404 Not Found Неверный URL или объект не опубликован Проверьте настройки HTTP-сервиса и права доступа
403 Forbidden Недостаточно прав Настройте роль пользователя в 1С
500 Internal Server Error Ошибка в коде обработчика Проверьте логи сервера и исправьте код
Форма не открывается в новом окне Блокировщик всплывающих окон в браузере Разрешите всплывающие окна для домена 1С

Если форма открывается, но не отображает данные:

  • 🔍 Проверьте, что идентификатор объекта существует в базе.
  • 🔍 Убедитесь, что форма не содержит ошибок (откройте её в конфигураторе в режиме 1С:Предприятие).
  • 🔍 Для OData проверьте, что объект включён в опубликованную коллекцию.

При интеграции с внешними системами (например, через REST API) полезно логировать ошибки. Пример кода для логирования:

Процедура ОбработатьОшибку(Ошибка, Параметры)

ЗаписьЛога = Новый Структура();


ЗаписьЛога.Вставить("Дата", ТекущаяДата());


ЗаписьЛога.Вставить("Ошибка", Ошибка.Описание());


ЗаписьЛога.Вставить("Параметры", Параметры);



ЗаписатьВЛог(ЗаписьЛога); // Реализуйте свою функцию записи


КонецПроцедуры

💡

Всегда тестируйте ссылки на формы в разных режимах запуска 1С (тонкий клиент, веб-клиент, мобильное приложение) — поведение может отличаться.

FAQ: Ответы на частые вопросы

Можно ли открыть форму 1С по ссылке из Excel или Word?

Да, но для этого нужно:

  1. Опубликовать HTTP-сервис или OData в 1С.
  2. В Excel/Word использовать гиперссылку вида http://[сервер]/[база]/hs/[объект]/[id].
  3. Убедиться, что на компьютере установлен и настроен веб-клиент 1С.

Альтернатива — использовать COM-соединение (только для Windows).

Почему при открытии формы по ссылке появляется ошибка "Сессия не найдена"?

Эта ошибка возникает, если:

  • Истёк тайм-аут сессии в веб-клиенте.
  • Не настроена аутентификация для HTTP-сервиса.
  • Пользователь не авторизован в системе.

Решение: проверьте настройки ВремяСеанса в файле webinst.cfg (для веб-клиента) или настройте автоматический вход.

Как передать дополнительные параметры в форму через ссылку?

Для передачи параметров используйте:

  • В HTTP-сервисах: добавьте параметры в URL (?param1=value1¶m2=value2).
  • В ОткрытьФорму(): используйте последний параметр Параметры: 
    Параметры = Новый Структура("Режим,Фильтр", "Просмотр", "Активные");

    ОткрытьФорму("Справочник.Контрагенты.ФормаСписка", Параметры);

Работает ли открытие форм по ссылкам в 1С:УНФ или 1С:ERP?

Да, но с оговорками:

  • 🔹 В 1С:УНФ и 1С:ERP по умолчанию включены HTTP-сервисы для основных объектов (документы, справочники).
  • 🔹 Для кастомных объектов может потребоваться донастройка.
  • 🔹 В 1С:ERP некоторые формы (например, Задачи) имеют ограничения на открытие по ссылкам.

Перед использованием проверьте настройки публикации в разделе Администрирование → Настройки HTTP-сервисов.

Можно ли открыть форму 1С по ссылке из Telegram-бота?

Да, для этого:

  1. Настройте HTTP-сервис в 1С, который будет принимать запросы от бота.
  2. В коде бота (на Python, Node.js и т.д.) сформируйте URL с параметрами.
  3. Используйте Inline-кнопки в Telegram для отправки пользователю ссылки вида: 
    https://ваш_сервер/база/hs/Catalog_Номенклатура/12345

Важно: настройте HTTPS и аутентификацию, чтобы защитить данные от перехвата.