Навигационная ссылка в обычном приложении

Навигационная ссылка

С появлением версии платформы 1С:Предприятие 8.2 пользователям стала доступна функция передачи ссылок на объекты информационной базы. Теперь пользователь может по электронной почте переслать, например своему коллеге, ссылку на документ, и последний откроет его в пару щелчков. Нам нужно лишь получить ссылку на объект:

А пользователь по этой ссылке откроет его уже на своей стороне:

Никакого поиска в списке и прочее. Быстро и удобно! Но данный функционал доступен только в управляемом приложении. Сегодня в статье рассмотрим собственную реализацию механизма навигационных ссылок для обычного приложения.

Реализация

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

Структура метаданных обработки будет состоять из двух реквизитов и непосредственно основной формы. Реквизита будет два:

1) «ОбъектИБ» с типом «Любая ссылка»

2) «СсылкаНаОбъект» с типом «Строка» длинной 255 символов.

Выбрав ссылку на объект информационной базы пользователь нажимает на кнопку «Получить ссылку». В результате будет сформирована строка ссылки на объект, включающая в себя информацию о типе объекта и его GUID для однозначной идентификации и его последующего открытия. На следующем листинге показан программный код обработчика этой кнопки:

По сформированной ссылке другой пользователь может открыть объект через эту же обработку. Скопировав текст ссылки в поле «Ссылка на объект» ему будет необходимо нажать на кнопку «Перейти по ссылке». Если ссылка корректная, то будет открыт соответствующий объект. Программный код для этой команды представлен на следующем листинге:

Весь смысл команды заключается в парсинге текста ссылки для получения типа объекта и его уникального идентификатора. Затем объект открывается по найденной ссылке.

Как это использовать

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

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

Источник

Заметки из Зазеркалья

Данная статья является анонсом новой функциональности.
Не рекомендуется использовать содержание данной статьи для освоения новой функциональности.
Полное описание новой функциональности будет приведено в документации к соответствующей версии.
Полный список изменений в новой версии приводится в файле v8Update.htm.

Планируется в версии 8.3.21

Навигационные ссылки – это самый оптимальный способ передать коллегам указание на объект системы, гораздо более удобный, чем номер документа или код элемента справочника. Вместо поиска по номеру или коду коллеге будет достаточно вставить переданную ссылку в строку Глобального поиска (или в диалог «Переход по ссылке») или, если ссылка получена в сообщении Системы взаимодействия, просто кликнуть по ней.

В версии 8.3.21 будут расширены возможности работы с навигационными ссылками.

Копирование в буфер обмена ссылки вместе с представлением

В диалоге получения навигационной ссылки появится опция «Копировать название»:

При включенной опции в буфер обмена будет скопирована не только ссылка, но и представление объекта:

Заказ 000000019 от 01.07.2020 23:07:08: e1cib/data/Документ.Заказ?ref=bbf30050ba5c887711e1fe6190994fe7

Если мы вставляем такую ссылку в текстовый документ (или в тело письма) – для адресата будет гораздо информативнее, если рядом со ссылкой будет также описание объекта, к которому ведёт ссылка.

А если мы вставляем такую ссылку в Систему взаимодействия, то если объект по ссылке найден в текущей инфобазе – в сообщении просто появится гиперссылка на объект (как и при вставке простой ссылки), а первая часть текста (представление объекта) не будет отображена, чтобы избежать дублирования информации:

Получение навигационной ссылки на объект текущей строки в форме списка

У расширения таблицы формы для динамического списка появится булево свойство РазрешитьПолучатьНавигационнуюСсылкуТекущейСтроки. Если оно выставлено в Истина – новая опция будет доступна в диалоге получения ссылки.

Команда формы «Получить ссылку» будет показывать новую опцию получения ссылки, если текущий элемент – таблица, связанная с динамическим списком, и у этой таблицы разрешено получать навигационную ссылку текущей строки. В обработчике формы ОбработкаПолученияСпискаНавигационныхСсылок() будет доступна ссылка на текущую строку динамического списка.

У таблицы будет добавлена команда «Получить ссылку…». Команда доступна, если у таблицы разрешено получать навигационную ссылку текущей строки.

В системное перечисление ВариантСтандартнойНавигационнойСсылкиФормы добавятся новые значения:

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

Источник

Как в 1с открыть ссылку на документ

В статье будет описано, как в 1с открыть ссылку на документ, справочник и т.д. В данном случае имеется в виду открытие формы объекта, используя ссылку на него. Рассмотрим три способа решения поставленной задачи.

Открыть ссылку используя ПоказатьЗначение

Самый простой способ, использовать метод глобального контекста ПоказатьЗначение. Который показывает в диалоге значение переданное в параметре.

В параметр Значение передадим ссылку, которую необходимо открыть. Данный метод является ассинхронным, т.е. не ожидает закрытие указанного значения. Для целей ожидания и обработки закрытого значения, в процедуре существует первый параметр. Но для нашей задачи он не нужен и указывать его не следует.

Таким образом открытие ссылки будет выглядеть следующим образом:

Открытие формы по ссылке

Также в 1с открыть ссылку можно при помощи метода ОткрытьФорму. Этот способ более сложен в реализации, но зато универсален. У него довольно много параметров, но для данной задачи нас интересуют первые два.

ИмяФормы — в параметре следует указать полный путь к форме, которую вы собираетесь открыть.

Пример 1. Можно указать форму, которая является формой объекта по умолчанию:

Пример 2. Либо указать имя конкретной формы, которую вы хотите открыть. Если, например, форм объекта несколько.

Параметры — структура параметров, которая передается в форму. Набор параметров разработчик выбирает сам, исходя их своих целей. Но некоторые параметры являются стандартными и используются для конкретных целей. Например, параметр Ключ, используется для указания платформе, форму какого объекта следует открыть (если Ключ, не указан, то будет открыта форма нового объекта). Таким образом в данный параметр необходимо передать ссылку на открываемый объект.

Пример 3. Открыть форму объекта для документа Поступление товаров.

Получить более подробную информацию по методу ОткрытьФорму можно в статье Как в 1с открыть форму программно

Открытие формы по навигационной ссылке

Если у вас есть навигационная ссылка на документ или справочник, перейти по ней и открыть форму объекта можно, используя метод ПерейтиПоНавигационнойСсылке.

Также навигационную ссылку можно получить из обычной ссылки. Для этого используется метод ПолучитьНавигационнуюСсылку.

В параметр Объект, в том числе, можно передать ссылку на документ или справочник.

Пример 5. Получить навигационную ссылку, используя обычную ссылку и открыть форму объекта.

Источник

Навигационная ссылка в 1С

1. Что такое навигационная ссылка?

Приветствую, коллеги! В данной статье будет рассмотрено понятие навигационной ссылки в 1С. Я расскажу, как работать с данным типом ссылок программно, и какие существуют форматы данных ссылок.

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

Рис. 1 Как получить навигационную ссылку?

По данной навигационной ссылке можно открыть передаваемый объект у себя:

Рис. 2 Открытие объекта по навигационной ссылке

Данной функцией можно пользоваться лишь в управляемом приложении.

2. Использование навигационных ссылок

Рассмотрим, как происходит реализация навигационных ссылок в 1С 8.3. Для этого необходимо создать обработку: она будет рабочая и для обычного приложения, и будет делать подобие основной навигационной ссылки. В таком случае форма её обработки будет выглядеть следующим образом:

Рис. 3 Обработка для создания навигационных ссылок

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

· «ОбъектИБ» – у данного реквизита будет тип «Любая ссылка»;

· «СсылкаНаОбъект» – у данного реквизита будет тип «Строка», у которой будет длина 255 символов.

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

Рис. 4 Обработка для создания кнопки навигационной ссылки

По данной навигационной ссылке пользователь, которому она будет отправлена, имеет возможность открыть объект при помощи этой обработки. Если скопировать ссылку в поле «Ссылка на объект», то нужно будет подтвердить данное действие кликнув на «Перейти по ссылке». В случае, если ссылка правильная, откроется объект. Далее представлен код, который осуществляет вышеуказанную команду:

Рис. 5 Код для работы навигационной ссылки

Смысл данной команды состоит в том, что текст ссылки парсится, чтобы получить тип объекта, а также уникальный идентификатор для данного объекта, после чего объект будет открыт.

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

3. Форматы навигационных ссылок

Навигационные ссылки делятся на внешние и внутренние ссылки, соответственно – для использования вне платформы «1С:Предприятие» и внутри данной системы. У ссылки есть две части:

1. сетевой адрес хоста информационной базы, в котором описывается расположение базы данных в клиентском приложении. Чтобы получить данную часть ссылки, необходимо использовать метод «ПолучитьНавигационнуюСсылкуИнформационнойБазы()»;

2. внутренняя ссылка, где описывается местонахождение объекта внутри информационной системы.

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

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

Рис. 6 Внешняя навигационная ссылка на форму

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

Рис. 7 Внешняя навигационная ссылка с ресурсом

Источник

Заметки из Зазеркалья

Данная статья является анонсом новой функциональности.
Не рекомендуется использовать содержание данной статьи для освоения новой функциональности.
Полное описание новой функциональности будет приведено в документации к соответствующей версии.
Полный список изменений в новой версии приводится в файле v8Update.htm.

Планируется в версии 8.3.19 Пробовать

Как известно, практически на любой объект информационной базы можно получить навигационную ссылку, которую, например, можно переслать коллеге, чтобы однозначно сослаться на документ, отчёт и т.д. В версии платформы 8.3.19 мы расширим функциональность навигационных ссылок – в них можно будет передавать дополнительные параметры.

С помощью этой функциональности можно будет не просто передать ссылку на отчёт, а передать ссылку на отчёт с конкретными параметрами (например, с заранее указанным периодом). Или передать ссылку на форму с динамическим списком с выбранной текущей строкой. Или передать ссылку на команду с параметрами.

Изменится диалог получения навигационной ссылки (который открывается по системной кнопке «Получить ссылку» или по сочетанию клавиш Ctrl + F11). Теперь его внешний вид зависит от типа объекта, на котором его вызвали. Вот как он выглядит для формы с динамическим списком:

А вот как – для отчёта:

При получении «расширенной» ссылки можно задать ее имя:

Под этим именем ссылка будет сохранена в специальном хранилище навигационных ссылок, и если пользователь, например, получит эту ссылку в сообщении Системы взаимодействия – она будет отображена как гиперссылка с текстом этого «дружественного» имени. Это же имя будет использовано при добавлении ссылки в Избранное.

Платформа поддерживает автоматическое формирование и обработку навигационных ссылок с дополнительными параметрами для следующих объектов:

Отчеты. Поддерживаются варианты отчетов и настройки.

Формы с динамическими списками. Поддерживаются текущие настройки и текущая строка динамического списка.

У форм появилось два новых обработчика – ОбработкаПолученияСпискаНавигационныхСсылок и ОбработкаПолученияНавигационнойСсылки.

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

СписокНавигационыхСсылок.Добавить(«СегодняшниеПисьма», «Сегодняшние письма»);

СписокНавигационыхСсылок.Добавить(«ПисьмаОтКлиентов», «Письма от клиентов»);

Результат работы:

В обработчике ОбработкаПолученияНавигационнойСсылки можно сформировать значение возвращаемой навигационной ссылки:

Процедура ОбработкаПолученияНавигационнойСсылки(Ключ, Представление,

Источник

• ← перейти на форму определения статуса осаго
• перейти с военной пенсии на гражданскую плюсы и минусы →